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 contenidos sencillo y fácil de usar que sirve para crear un sitio web en minutos. Toma el texto escrito en tu lenguaje de marcado favorito y utiliza diseños para crear un sitio web estático. Puedes utilizar las funciones integradas de Jekyll para modificar el aspecto del sitio, las URL, los datos que se muestran en la página y mucho más. Ofrece un montón de funciones como enlaces permanentes, categorías, páginas, entradas, 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 con Ubuntu 22.04.
  • Una contraseña de root configurada en tu servidor.

Cómo empezar

Antes de empezar, 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 necesarias ejecutando el siguiente comando:

apt install make build-essential curl git tree -y

Una vez instaladas todas las dependencias, puedes pasar al siguiente paso.

Instalar Ruby

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

Ejecuta el siguiente comando para instalar Ruby:

apt install ruby ruby-dev -y

Una vez completada la instalación, tendrás que decirle al gestor de paquetes de gemas de Ruby que coloque las gemas en la carpeta de inicio de nuestro usuario.

Puedes hacerlo editando el archivo ~/.bashrc:

nano ~/.bashrc

Añade las siguientes líneas al final del archivo:

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

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

source ~/.bashrc

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

gem install jekyll bundler

Una vez completada la instalación, puedes pasar 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 creado 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.
New jekyll site installed in /root/jekyll.example.com. 

A continuación, lista 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 directory, 7 files

Iniciar el servidor Jekyll

Primero, navega al directorio del sitio web y añade la dependencia de webrick con 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 con éxito, 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.

Accede al sitio web de Jekyll

En este punto, Jekyll se ha iniciado y está 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 por defecto de Jekyll:

Jekyll

Conclusión

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

Scroll al inicio