Cómo crear un sitio web con Jekyll - ES

¿Eres propietario de un sitio web? buscando una manera fácil de construir sitios rápidos? Si bien la mayoría de los sistemas de administración de contenido populares como WordPress son comúnmente para tales tareas, no son rápidos. Confían en bases de datos, scripts pesados ​​y complementos para finalmente entregar en la página. Pero que pasa si hay una mejor manera? Jekyll es mucho mejor que otras opciones similares! Es un generador de sitio estático: todo lo que necesita hacer es tomar sus publicaciones, formatearlo en consecuencia y ejecutarlo a través del motor. Esto dará como resultado la creación de archivos compatibles con HTML que se puede cargar fácilmente a cualquier host.

Jekyll 4.1.0 Actualizaciones

Jekyll fue actualizado a finales de mayo 2020 con una nueva actualización con el número v4.1.0 en el que el componente del servidor ahora admite certificados ECC, entre otras cosas. Esta es una característica importante cuando se usa un tipo de clave que no sea RSA. Otra cosa importante que es la optimización del motor Markdown — El formato que se utiliza en los borradores y dirige la salida de las páginas.. Con jekyll 4.1.0 los bloggers pueden optar por deshabilitar el almacenamiento en caché de disco que puede ser beneficioso en algunos casos, especialmente cuando se realizan pruebas más complejas de proyectos.

Otras mejoras importantes desde el punto de vista del propietario del sitio incluyen las siguientes:

• Configuración del idioma predeterminado para incluir resaltado de sintaxis. Anteriormente esto tenía que hacerse manualmente.
• Los administradores ahora pueden deshabilitar la importación de la configuración del tema
• El módulo PageDrop se puede usar con las plantillas Liquid.

Como siempre, la nueva versión de Jekyll incluye importantes correcciones de errores que los usuarios han informado..

Por qué Jekyll para sitios estáticos

Los generadores de sitios estáticos son una de las herramientas más populares utilizadas para generar sitios de alta calidad y fáciles de usar y administrar que no dependen de un sistema de gestión de contenido dinámico como WordPress. Los sitios estáticos son pequeños y se producen como salida del proyecto después de que los propietarios del sitio hayan ejecutado el contenido a través de la aplicación Jekyll. Por diseño Jekyll es un Aplicación ejecutable Ruby que es muy fácil de usar y es multiplataforma. Una característica muy conveniente es que Jekyll incluye un servidor web local incorporado que permite a los propietarios del sitio ver en vivo los cambios realizados antes de que el sitio se publique en línea.. Hay algunos ventajas distintivas de confiar en un sitio estático a diferencia de las dinámicas que tienen a Jekyll en mente como generador de sitios:

• Actuación - Los sitios creados por Jekyll son mucho más rápidos que algunos de sus contrapartes.. Se producen en código HTML limpio que los navegadores web pueden leer fácilmente y son mucho más rápidos de cargar. No hay elementos dependientes de la base de datos y consultas complejas que son comunes en otros tipos de sitios..
• Proceso de creación - En comparación con los sistemas dinámicos de gestión de contenido, los generados por Jekyll se construyen de manera diferente. Los desarrolladores deben formatear el contenido de acuerdo con el motor de plantillas utilizado por Jekyll y correspondiente al archivo de configuración principal. Jekyll transformará los borradores de archivos en sitios HTML que luego deberán cargarse en los servidores web.
• Requerimientos del servidor - Los sitios de Jekyll necesitan soporte de scripts especiales o bases de datos que faciliten la búsqueda de un alojamiento barato.

Jekyll Setup: Los basicos

Jekyll 4.0.0 es esencialmente lo que se llama una gema Ruby: este es un tipo especial de código que se instala en el entorno Ruby. Ruby es un lenguaje de programación moderno que generalmente se usa para crear sitios web y aplicaciones.. Una gema es un tipo de programa que se puede descargar del repositorio de Ruby y funcionará de una manera determinada. La posible funcionalidad incluye herramientas de empaque, acciones repetidas, marcos y etc.. Como resultado, Jekyll tomará los archivos de contenido., procesarlos y generar archivos HTML que estén listos para cargarse en los servidores web.

Para ponerse en marcha con Jekyll, los posibles propietarios de sitios deben tener instalado el siguiente software: El ambiente principal de Ruby (incluyendo todos los encabezados de desarrollo), Soporte de paquetes Ruby Gems y herramientas gcc y make. Una descripción detallada de cómo instalar y preparar el entorno está disponible en Página de instalación de Jekyll.

El proceso de creación del sitio Jekyll

Para tener un sitio listo creado por un Jekyll 4.0.0 aplicación instalada en el sistema local utilizada por los propietarios del sitio. En primer lugar, deberán configurar Jekyll configurando los entornos globales para el proyecto.. Cuando Jekyll se instala y trabaja en un sistema determinado, los propietarios del sitio deberán crear un directorio que albergará todos los archivos de proyecto del sitio, que se designará como el “raíz del sitio” . En ella un Jekyll index.htm debe crearse un archivo que albergue el contenido de la página de inicio y los archivos importantes. Una plantilla vacía incluirá el siguiente código:

doctype html>
<html>
<cabeza>
<meta charset = & quot; utf-8 & quot;>
<título>Casa</título>
</cabeza>
<cuerpo>
<h1>Hola Mundo!</h1>
</cuerpo>
</html></pags>

Este es el general “Hola Mundo!” sitio de saludo desde el cual los desarrolladores web pueden comenzar a construir sus creaciones. En el directorio raíz, los desarrolladores pueden ejecutar dos comandos:

• construcción jekyll - Esto construirá el sitio y generará el código final en un subdirectorio separado llamado “_sitio”.
• Jekyll servir - Esto supervisará los cambios del sitio y reconstruirá el sitio automáticamente mientras se está ejecutando la aplicación jekyll. Esto también activará el servidor del sitio web incorporado, que permitirá a los desarrolladores previsualizar en vivo su proyecto. Por defecto es accesible desde la siguiente URL: http://localhost:4000

Todo lo que los usuarios deben hacer es decidir un diseño de sitio adecuado y generar el contenido.. Esto se puede hacer de dos maneras principales:

• Archivos HTML - Estos son archivos HTML estándar creados por los propietarios del sitio. Se enfrentarán a la configuración definida por Jekyll.
• Markdown Template Files - Los propietarios del sitio también pueden aplicar archivos escritos con descuento que se generarán de acuerdo con una plantilla determinada. Esto significa que los usuarios pueden formatear texto y código de acuerdo con un formato Markdown fácil de seguir. Se procesará de acuerdo con las reglas definidas y al final devolverá un archivo HTML compatible con el estándar.

Markdown es un lenguaje de marcado fácil de usar que es popular entre los desarrolladores y usuarios avanzados de desarrolladores web. Es muy conveniente ya que varios programas de procesamiento de texto y editores especiales pueden generarlos desde formatos estándar. Jekyll tomará los archivos de Markdown (con la extensión .md adecuada) y el uso de los archivos de plantilla definidos genera un archivo HTML optimizado.

El motor Jekyll diferenciará las páginas normales creadas en HTML y los llamados archivos especiales. Esto se hace escribiendo lo necesario YAML asunto frontal- esto debe colocarse al principio de cada página. YAML es un lenguaje de marcado práctico y amigable para los humanos que es leído por Jekyll. Un ejemplo típico de tal archivo es el siguiente:

—
diseño: enviar
título: Blogging 101 Página
—

En este ejemplo, la materia frontal especificará el uso diseño tipo (en este ejemplo, esta será una publicación de blog estándar) y el título de la página. Hay otras dos variables globales que se pueden colocar en primer plano: enlace permanente (que permitirá al usuario configurar su propio enlace permanente para la publicación dada y publicado (se pueden colocar valores verdaderos o falsos) que puede evitar que una determinada publicación se publique en línea. Esto es particularmente útil cuando se planifican borradores.

Usando el motor de plantillas Jekyll y los archivos de configuración los usuarios pueden crear sus propias variables también. Cuando se trata del tipo de publicación, hay varias opciones que se pueden usar:

• fecha - Esto anulará la fecha de publicación como se muestra en la salida del sitio.
• categoría / categorías - Esto mejorará la organización de las publicaciones cuando las vean los visitantes.. Al especificar este valor, las publicaciones se organizarán en las categorías respectivas.. Las "categorías" plurales se pueden especificar en una lista YAML o se pueden separar en espacios como en la mayoría de los sistemas de gestión de contenido dinámico.
• etiquetas - Esta es una opción popular para permitir que los usuarios etiqueten las publicaciones. Esta es una comodidad adicional que está separada de las categorías mencionadas anteriormente..

Jekyll Site Structure and Layout Engine

Tan pronto como el motor Jekyll se inicia por primera vez para un sitio determinado (proyecto) Básicamente, todo lo que los propietarios de sitios deben hacer es invocar jekyll new $ sitename (dónde $nombre del sitio es el directorio del proyecto). Todas las versiones modernas de Jekyll crearán un diseño de directorio estructurado. Por defecto, el archivo de configuración principal usará una plantilla predeterminada llamada mínimos que puede modificarse o modificarse según las preferencias de los usuarios. El directorio contendrá los siguientes archivos y carpetas.:

• _posts folder - Esto contendrá las publicaciones individuales. En el caso típico, tendrán el siguiente formato: XXXX-XX-XX- $ postname.markdown (o .md). Las primeras tres cadenas serán el año-mes-día, seguidas de guiones con el nombre de la publicación en la estructura de enlaces permanentes.. Un ejemplo de nombre de publicación será 2020-01-03-hello.markdown que generará una publicación llamada "Hola" y publicada en enero 3 2020.
• _config.yml - Este es el archivo de configuración principal que utiliza Jekyll.
• 404.html - Esto contendrá la página de error estándar de Página no encontrada que también se conoce como 404 error.
• about.markdown - Esta es la página "Acerca de" que normalmente se encuentra en la mayoría de los blogs.
• Gemfile - Este es un archivo creado automáticamente por el entorno Gemfile.
• index.markdown - Esta es la página de inicio estándar que, de forma predeterminada, comenzará a indexar todas las publicaciones de tipo de blog en función de la fecha en orden descendente.

Para más información sobre las opciones de diseño, estructura del directorio y más información puede consultar las páginas relevantes en el Documentación de Jekyll.

Desata todo el poder de Jekyll

Hay muchas características que los propietarios de sitios de Jekyll pueden usar para proporcionarles la posibilidad de personalizar realmente sus sitios hasta el más mínimo detalle.. Como mencionamos anteriormente, todas las instalaciones predeterminadas del sitio usan un tema predeterminado llamado mínimos. Existen muchos repositorios de temas Jekyll de terceros que aprovechan las muchas opciones de personalización. Lo único del sistema de plantillas Jekyll es que se basa en Gemas - bibliotecas que pueden incluir una rica funcionalidad. Las instalaciones de Jekyll usan una utilidad llamada Bundler que realiza un seguimiento de las diversas dependencias. Una función alternativa es usar plantillas regulares: usarán los archivos tradicionales que se presentan en el directorio del sitio de Jekyll.

El sistema de complementos es uno de los más avanzados que se encuentran en generadores de sitios estáticos similares e incluso en algunos de los famosos sistemas de gestión de contenido dinámico.. Los complementos pueden proporcionar una funcionalidad mejorada que no se encuentra dentro de la instalación base de Jekyll. Usando ganchos personalizados y el núcleo flexible, se pueden agregar muchas otras opciones. Hay varias categorías principales de complementos que se pueden clasificar:

• Generadores - Esta es una función que se utilizará para permitir que Jekyll cree contenidos adicionales. Se pueden usar reglas personalizadas para dirigir al motor a implementar la nueva funcionalidad.
• Convertidores - Estos complementos permiten a los usuarios usar otros lenguajes de marcado y opciones de temas para implementar el diseño.
• Comandos - Esto ampliará la funcionalidad del motor principal mediante la implementación de nuevos comandos.
• Etiquetas- Esto creará etiquetas personalizadas a base de líquido.
• Filtros - Complementos que amplían la funcionalidad de los filtros..
• Manos - Permiten extensiones durante el proceso de construcción.

Opciones de implementación del sitio de Jekyll

Hay varias opciones compatibles que se pueden usar para cargar los sitios a los servidores.. Es una buena práctica crear un archivo de gemas para cada sitio. Esto permitirá que los complementos y extensiones se empaqueten como un todo. También se pueden establecer varios valores de entorno durante el proceso de construcción: al final de la fase de producción hay parámetros establecidos que se pueden usar para crear la salida del sitio. Hay dos formas principales de cargar los sitios.:

• Carga simple - La salida de la carpeta del sitio se puede cargar usando el panel administrativo o una utilidad de carga de archivos usando las opciones de arrastrar y soltar y / o comandos especiales.
• Publicación de control de versiones - Los propietarios del sitio también pueden usar sistemas de control de versiones como git o svn para mantener las revisiones del sitio. Esta es una función avanzada que se utiliza para almacenar ediciones y comunicarse con los servidores de una manera que facilitará la documentación de los cambios..