grav

Tutorial básico

Comenzando con Grav

Suponiendo que ha instalado Grav con éxito siguiendo las instrucciones enumeradas en el capítulo anterior, podemos continuar y jugar un poco con Grav para que se sienta más cómodo.

Debido a que Grav no requiere una base de datos, es bastante fácil trabajar con él, sin tener que preocuparse por causar problemas entre la instalación de Grav y cualquier otra fuente de datos significativa. Si algo sale mal, generalmente puede recuperarse muy fácilmente.

Conceptos básicos de contenido

Primero, familiaricémonos con dónde almacena Grav el contenido. Podrás encontrar más detalles en este artículo, pero por el momento, debes saber que todo el contenido de usuario se almacena en la carpeta user/pages/ de tu instalación de Grav.

Actualmente, hay dos carpetas en la carpeta de páginas, la primera se llama 01.home y la segunda es 02.typography. La parte 01. de la carpeta es opcional pero proporciona un par de cosas que pueden ser útiles.

En primer lugar, te permite definir expresamente el orden de tus páginas. Por ejemplo, 01 vendrá antes de 02, pero 00 vendrá antes de 01.

La otra cosa que hace la parte numérica del nombre de la carpeta es informar explícitamente a Grav que esta página debe ser visible en el menú. Es importante tener en cuenta que la parte numérica hasta e incluyendo el . será eliminada de las URL.

Configuración de la página de inicio

Hay una opción en el archivo user/config/system.yaml que establece la ubicación de la página de inicio, en otras palabras, a dónde apunta Grav cuando haces referencia a la raíz de tu sitio: http://tusitio.com.

Si examinas este archivo de configuración en tu instalación, verás que ya apunta al alias para /home. Podemos dejarlo así en este ejemplo.

Edición de páginas

Las páginas en Grav están compuestas en sintaxis Markdown. Markdown es una sintaxis de formato de texto plano que una computadora puede analizar fácilmente y convertir en HTML. Utiliza símbolos de texto básicos para indicar la presentación (por ejemplo, negrita, cursiva, encabezados, listas, etc.), lo que facilita escribir sin necesidad de conocer las complejidades de HTML. Los beneficios de Markdown incluyen una tasa de error más baja, legibilidad, facilidad de aprendizaje y uso, etc.

Puedes leer una explicación extensa de la sintaxis disponible con ejemplos en la documentación, pero por ahora, sigue leyendo.

Abre la página de inicio en tu editor de texto. El archivo que controla la página de inicio se encuentra en la carpeta user/pages/01.home/ y se llama default.md. Todo el contenido que crees se creará en la carpeta user/pages/ de tu instalación de Grav.

Cuando edites la página en un editor de texto, el contenido se verá algo así:

---
title: Inicio
body_classes: title-center title-h1h2
---
# ¡Dale la bienvenida a Grav!
## instalación exitosa...

¡Felicidades! Has instalado el **Paquete Base de Grav** que proporciona una **página simple** y el tema predeterminado **Quark** para empezar.

!! Si ves un **Error 404** cuando haces clic en `Tipografía` en el menú, por favor consulta la [guía de solución de problemas](https://learn.getgrav.org/troubleshooting/page-not-found).

Veamos esto un poco más detenidamente para que puedas ver lo fácil que es escribir en Markdown. Las cosas entre los indicadores --- son los Encabezados de página, y estos se escriben en un formato sencillo llamado YAML. Este bloque de configuración que se encuentra en el archivo .md se conoce comúnmente como YAML Front Matter.

title: Inicio
body_classes: title-center title-h1h2

Este bloque establece la etiqueta de título HTML para la página (el texto que ves en la pestaña del navegador). También puedes acceder a esto desde tus temas a través del atributo page.title. Hay algunos encabezados estándar que te permiten configurar una variedad de opciones para esta página. Otro ejemplo es menu: Algo que te permite reemplazar el texto utilizado para mostrar el nombre de la página en un menú. Por defecto, Grav usará el título para el valor del menú.

# ¡Dale la bienvenida a Grav!
## instalación exitosa...

La sintaxis # o almohadillas en Markdown indica un título. Un solo # con un espacio y luego texto se convierte en un encabezado <h1> en HTML. ## o doble almohadilla se convertiría en una etiqueta <h2>. Por supuesto, esto va hasta la etiqueta HTML válida <h6>, que, por supuesto, serían seis almohadillas: ###### Mi encabezado de nivel H6.

¡Felicidades! Has instalado el **Paquete Base de Grav** que proporciona una **página simple** y el tema predeterminado **Quark** para empezar.

Este es un párrafo simple que habría sido envuelto en etiquetas <p> regulares al convertirse en HTML. Los marcadores ** indican texto en negrita o <strong>, anteriormente <b>, en HTML. El texto en cursiva se indica envolviendo el texto en marcadores _.

!! Si ves un **Error 404** cuando haces clic en `Tipografía` en el menú, por favor consulta la [guía de solución de problemas](https://learn.getgrav.org/troubleshooting/page-not-found).

Esta sección utiliza una característica de markdown personalizada que proporciona el complemento incluido markdown-notices. Esto te permite crear avisos simples prefijando un párrafo de texto con un número de símbolos ! (signo de exclamación), desde ! hasta !!!!.

Esta descripción general debería proporcionarte algunos puntos clave para escribir en Markdown, pero deberías consultar nuestra explicación más detallada para obtener una comprensión completa.

Asegúrate de guardar tus archivos .md como archivos UTF8. Esto asegurará que funcionen con caracteres especiales específicos del idioma.

Agregar una nueva página

Crear una nueva página es algo sencillo en Grav. Solo sigue estos simples pasos:

  1. Navega hasta tu carpeta de páginas: user/pages/ y crea una nueva carpeta. En este ejemplo, usaremos ordenación predeterminada explícita y llamaremos a la carpeta 03.mypage.
  2. Abre tu editor de texto, crea un nuevo archivo y pega el siguiente código de ejemplo:
---
title: Mi Nueva Página
---
# ¡Mi Nueva Página!

Este es el cuerpo de **mi nueva página** y puedo usar fácilmente la sintaxis _Markdown_ aquí.
  1. Guarda este archivo en la carpeta user/pages/03.mypage/ como default.md. Esto le dirá a Grav que renderice la página utilizando la plantilla predeterminada en el tema actual: user/themes/quark/templates/default.html.twig.
  2. ¡Eso es todo! Actualiza tu navegador para ver tu nueva página en el menú en la parte superior.

La página aparecerá automáticamente en el menú después del elemento de menú "Tipografía". Si deseas cambiar el nombre que se muestra en el menú, agrega: menu: Mi Página entre los guiones en el encabezado de la página.

¡Felicidades, has creado correctamente una nueva página en Grav. Hay mucho más que puedes hacer con Grav, así que sigue leyendo para conocer más capacidades avanzadas y características detalladas.

Si tienes algún problema para acceder a esta nueva página, o bien te falta un archivo .htaccess (solo servidor web Apache) o puede que necesites editar el comando RewriteBase en el archivo .htaccess. Consulta el capítulo de solución de problemas para obtener más información.