Crea tu blog gratis con Jekyll y Github Pages
Voy al grano.
Primero lo primero: Instalar Jekyll
- Instala los requisitos, en Debian 9:
- Ruby 2.X.X.
- Instalar:
sudo apt install ruby
- Version actual:
ruby --version
- Instalar:
- Bundler
- Instalar:
sudo gem install bundler
- Instalar:
- Ruby 2.X.X.
- Crea el proyecto inicial
bundle exec jekyll _3.3.0_ new <nombre_del_proyecto>
- Navega hacia la carpeta creada
cd <nombre_del_proyecto>
- En el archivo Gemfile, elimina el # al inicio de la linea:
gem "github-pages", group: :jekyll_plugins
- Instala las dependencias:
bundle install
Puedes hacer pruebas localmente, iniciando el servidor con el comando bundle exec jekyll serve
. Iniciara por default en http://localhost:4000
Segundo lo segundo: Subirlo a GitHub
- Crea un repositorio en GitHub.
Nota: Para que funcione con GitHub Pages, el nombre del repo debe ser “<nombre_de_perfil>.github.io” Mas información
- En tu carpeta de proyecto, inicia git:
git init
- Añade el repositorio remoto:
git remote add origin https://github.com/<usuario>/<usuario>.github.io
- Añade los cambios y crea un commit:
git add . git commit -m "First commit"
- Actualiza el repositorio remoto:
git push origin master
Listo. Ya con eso puedes acceder al blog básico de Jekyll en https://<username>.github.io
Posibles errores
Error: Failed to build gem
Gem::Ext::BuildError: ERROR: Failed to build gem native extension.
mkmf.rb can't find header files for ruby at /usr/lib/ruby/include/ruby.h
Solución: Instala los paquetes de desarrollo de ruby sudo apt install ruby-dev
Error instalando nokogiri
zlib is missing; necessary for building libxml2
Solución: Instala el paquete de zlib sudo apt install zlib1g-dev
Error: No GitHub API authentication
GitHub Metadata: No GitHub API authentication could be found.
Solución: Añade github: [metadata]
en el archivo _config.yml - fuente
¿Dudas?
Contáctame, revisa mi sección de contacto :)