Crear un Site Estático con Jekyll en Ubuntu

Crear un Site Estático con Jekyll en Ubuntu

Jekyll es un más que interesante generador de Sites estáticos en HTML. A la vez, dispone de importantes plugins que nos pueden hacer muy fácil la vida, como por ejemplo: Jekyll Admin, que sobre la base estándard de Jekyll nos montará un entorno de edición online al más puro estilo CMS de Wordpress. La gran diferencia vs Wordpress, por ejemplo, es que no necesita de Base de Datos pero si bien es cierto, necesita de unos conocimientos avanzados técnicos.

Jekyll Admin

Paso 1 — Instalar Jekyll

Para poder instalarlo en nuestro local o por ejemplo en un Docker, símplemente tenemos que disponer de una base Ubuntu, por ejemplo la 17.04 y realizar los siguientes pasos:

sudo apt-get update

Una vez actualizada nuestra librería apt, deberemos instalar los módulos: “make” y “gcc”, como también Ruby, ya que Jekyll está desarrollado en éste lenguaje:

sudo apt-get install ruby ruby-dev make gcc

Cuando termine, utilizaremos el gestor de paquetes “Gem” de Ruby para instalar Jekyll en sí y el Bundler para administrar las dependencias de Gem:

sudo gem install jekyll bundler

Paso 2 — Configurar nuestro Site

Nos vamos a dirigir allá donde quedamos tener nuestro código, por ejemplo “/var/www” y haremos:

jekyll new [nombre site]

Es recomendable no hacerlo en “root” o “sudo” para que el propietario de los ficheros que se generen sea nuestro própio usuario con el que estamos accediendo a la instancia.

Seguidamente, accedemos a nuestro nuevo Site, por ejemplo “blog” (cd blog) y lanzamos:

bundle install

Esto nos generará una estructura de directorios y ficheros que debería ser similar a:

├── about.md
├── _config.yml
├── css
│   └── main.scss
├── feed.xml
├── Gemfile
├── Gemfile.lock
├── index.html
└── _posts
   └── 2016-09-03-welcome-to-jekyll.markdow

Paso 3 — Personalizando nuestro Site

Tenemos muchas posibilidades de personalización, por ejemplo a partir del fichero “config.yml” que encontraremos localizado en la misma raíz del proyecto, podremos configurar tanto el Title del Site, la Description, los Tags o hasta el puerto con el que se lanzaré el HTTP Server que Jekyll pone en marcha para que podamos ver el resultado en nuestro misma instancia.

Para poner en marcha nuestro Site y poder testearlo, sólo tenemos que lanzar el comando:

bundle exec jekyll serve

Automáticamente nos lanzará un prompt donde aparecerá algo parecido a:

~/blog$ bundle exec jekyll serve
Configuration file: /var/www/blog/_config.yml
           Source: /var/www/blog
      Destination: /var/www/blog/_site
Incremental build: disabled. Enable with --incremental
     Generating...
                   done in 0.32 seconds.
Auto-regeneration: enabled for '/var/www/blog'
Configuration file: /var/www/blog/_config.yml
   Server address: http://127.0.0.1:4000/
 Server running... press ctrl-c to stop.

De forma automática, nuestra raíz tendrá más directorios, en éste caso dentro del directorio “Site” donde se habrá generado automáticamente, en html, nuestros post, por ejemplo:

└── _site
    ├── about
    │   └── index.html
    ├── css
    │   └── main.css
    ├── feed.xml
    ├── Gemfile
    ├── Gemfile.lock
    ├── index.html
    └── jekyll
        └── update
           └── 2016
                └── 09
                    └── 08
                        └── welcome-to-jekyll.html

ELK Filebeat configuration

Jekyll es una magnífica opción para tener un Site, a muy bajo coste, preparado para multitud de visitas y si lo desplegamos por ejemplo en S3 de AWS tendremos un Site con Alta Disponibilidad.

Podéis obtener mucha más información a partir de su própia web: http://jekyllrb.com/

Autor: Joakim Vivas

comments powered by Disqus