Cómo instalar el generador de sitios web estáticos Jekyll en Ubuntu 22.04

Jekyll es un generador de archivos estáticos gratuito y de código abierto escrito en Ruby. Es un sistema de gestión de contenido simple y fácil de usar que se utiliza para crear un sitio web en minutos. Toma texto escrito en tu lenguaje de marcado favorito y utiliza diseños para crear un sitio web estático. Puedes usar las características integradas de Jekyll para ajustar la apariencia del sitio, las URL, los datos mostrados en la página y más. Ofrece una gran cantidad de características como enlaces permanentes, categorías, páginas, publicaciones, diseños personalizados y muchas más.

En este tutorial, te mostraremos cómo instalar Jekyll CMS en Ubuntu 22.04.

Requisitos previos

Un servidor que ejecute Ubuntu 22.04.
Una contraseña de root configurada en tu servidor.

Comenzando

Antes de comenzar, se recomienda actualizar tu sistema con la última versión estable. Puedes actualizarlo con el siguiente comando:

apt update -y  
apt upgrade -y

Una vez que tu sistema esté actualizado, instala otras dependencias requeridas ejecutando el siguiente comando:

apt install make build-essential curl git tree -y

Una vez que todas las dependencias estén instaladas, puedes proceder al siguiente paso.

Instalar Ruby

Jekyll está escrito en Ruby, por lo que necesitarás instalarlo en tu sistema. Por defecto, el paquete Ruby está incluido en el repositorio predeterminado de Ubuntu.

Ejecuta el siguiente comando para instalar Ruby:

apt install ruby ruby-dev -y

Una vez que la instalación esté completa, necesitarás indicarle al administrador de paquetes gem de Ruby que coloque los gemas en la carpeta de inicio de nuestro usuario.

Puedes hacerlo editando el archivo ~/.bashrc:

nano ~/.bashrc

Agrega las siguientes líneas al final del archivo:

export GEM_HOME=$HOME/gems
export PATH=$HOME/gems/bin:$PATH

Guarda y cierra el archivo, luego activa la variable de entorno con el siguiente comando:

source ~/.bashrc

A continuación, puedes instalar Jekyll y bundler usando el comando gem como se muestra a continuación:

gem install jekyll bundler

Una vez que la instalación esté completa, puedes proceder al siguiente paso.

Crear un nuevo sitio web con Jekyll

En este punto, Jekyll está instalado en tu sistema. Ahora, ejecuta el siguiente comando para crear un nuevo sitio web llamado jekyll.example.com:

jekyll new jekyll.example.com

Una vez que se crea el sitio web, deberías obtener la siguiente salida:

  Bundler: Using jekyll 4.2.2
  Bundler: Fetching jekyll-seo-tag 2.8.0
  Bundler: Fetching jekyll-feed 0.16.0
  Bundler: Installing jekyll-feed 0.16.0
  Bundler: Installing jekyll-seo-tag 2.8.0
  Bundler: Fetching minima 2.5.1
  Bundler: Installing minima 2.5.1
  Bundler: Bundle complete! 7 Gemfile dependencies, 31 gems now installed.
  Bundler: Use `bundle info [gemname]` to see where a bundled gem is installed.Don't run Bundler as root. Bundler can ask for sudo if it is needed, and
  Bundler: installing your bundle as root will break this application for all non-root
  Bundler: users on this machine.
Nuevo sitio jekyll instalado en /root/jekyll.example.com.

A continuación, puedes listar todos los archivos y directorios creados por Jekyll con el siguiente comando:

tree jekyll.example.com

Deberías obtener la siguiente salida:

jekyll.example.com
??? 404.html
??? about.markdown
??? _config.yml
??? Gemfile
??? Gemfile.lock
??? index.markdown
??? _posts
    ??? 2022-09-25-welcome-to-jekyll.markdown

1 directorio, 7 archivos

Iniciar el servidor Jekyll

Primero, navega al directorio del sitio web y agrega la dependencia webrick usando el siguiente comando:

cd jekyll.example.com  
bundle add webrick

A continuación, inicia el servidor web Jekyll ejecutando el siguiente comando:

jekyll serve --host=0.0.0.0

Una vez que el servidor se inicie correctamente, deberías obtener la siguiente salida:

Configuration file: /root/jekyll.example.com/_config.yml
            Source: /root/jekyll.example.com
       Destination: /root/jekyll.example.com/_site
 Incremental build: disabled. Enable with --incremental
      Generating... 
       Jekyll Feed: Generating feed for posts
                    done in 0.375 seconds.
 Auto-regeneration: enabled for '/root/jekyll.example.com'
    Server address: http://0.0.0.0:4000/
  Server running... press ctrl-c to stop.

Acceder al sitio web Jekyll

En este punto, Jekyll está iniciado y escuchando en el puerto 4000. Ahora, abre tu navegador web y escribe la URL http://your-server-ip:4000. Serás redirigido a la página predeterminada de Jekyll:

Jekyll

Conclusión

En la guía anterior, aprendiste cómo instalar Jekyll en Ubuntu 22.04. Ahora puedes explorar Jekyll y crear tu propio sitio web utilizando el contenido generado automáticamente.