jekyll instalacion

inicio / programacion / jekyll / {{page.title}}

{% include logo-jekyll.html %}

{% include toc.html %}

propósito

  • Ver como se usa jekyll y que utilidades puedo usar
  • Empiezo con este post

instalación en windows

instalar chocolatey

  • desde una consola con privilegios de administrador
  • para instalar Chocolatey
@powershell -NoProfile -ExecutionPolicy Bypass -Command "iex ((new-object net.webclient).DownloadString('https://chocolatey.org/install.ps1'))" && SET PATH=%PATH%;%ALLUSERSPROFILE%\chocolatey\bin

Ensuring chocolatey commands are on the path
Ensuing chocolatey.nupkg is in the lib folder
  • para que chocolatey funcione es necesario reabrir la consola
  • para ver que versión se ha instalado se teclea simplemente
choco
Chocolatey v0.9.10.3

instalar Ruby

choco install ruby -y
ruby has been installed.
Adding 'C:\tools\ruby23\bin' to the local path

ruby -v
ruby 2.3.0p0 (2015-12-25 revision 53290) [x64-mingw32]

instalar Jekyll

gem install jekyll
jekyll -v
jekyll 3.2.1

correr varios sitios en local

  • en cada directorio lanzar

jekyll serve --port 4001 --watch

  • por defecto corre en el 4000

usar jekyll

jekyll new pruebas
cd pruebas
jekyll serve --watch
  • pero da este error
C:/tools/ruby23/lib/ruby/2.3.0/rubygems/core_ext/kernel_require.rb:55:in
`require': cannot load such file -- bundler (LoadError)
from C:/tools/ruby23/lib/ruby/2.3.0/rubygems/core_ext/kernel_require.rb:55:in `require'
from C:/tools/ruby23/lib/ruby/gems/2.3.0/gems/jekyll-3.2.1/lib/jekyll/plugin_manager.rb:34:in `require_from_bundler'
from C:/tools/ruby23/lib/ruby/gems/2.3.0/gems/jekyll-3.2.1/exe/jekyll:9:in `<top (required)>'
from C:/tools/ruby23/bin/jekyll:23:in `load'
from C:/tools/ruby23/bin/jekyll:23:in `<main>'
  • intento instalar bundler
gem install bundler
bundle install
  • Ahora si que funciona el servidor

http://127.0.0.1:4000/

  • y veo la web generada

inicio rápido

  • desde un usuario de github distinto del propietario de este repositorio hacer un fork del repositorio https://github.com/javieriranzo3/plantillajekyll
  • renombrarlo si se desea en settings
  • luego lo clono en el directorio que quieras y ya se puede modificar

prueba rápida

  1. creo el repositorio vacio pruebajekyll
  2. lo clono en C:\nube\MEGA\programacion\HtmlCssEstatico\jekyll\
git clone https://github.com/pelos6/pruebajekyll.git
cd pruebajekyll
git checkout --orphan gh-pages
  1. luego desde C:\nube\MEGA\programacion\HtmlCssEstatico\jekyll\
jekyll new pruebajekyll  
cd pruebajekyll     
jekyll serve --watch

  1. cambio en _config.yml

    name: javier iranzo
markdown: redcarpet
pygments: true
baseurl: /christmas-recipes

  2. el problema viene porque jekyll usa unos includes que gitHub pages aún no sieve por eso incluso la plantilla mínima da problemas

  3. con redcarpet y con pygments que no son esenciales para lo que quiero así que lo quito

    http://127.0.0.1:4000/pruebajekyll/

  4. y veo la web

  5. lo subo a git pero da un error que manda un correo a mi cuenta.

  6. sobre about.md. sobre unos include que no puede resolver

  7. luego otro en main.css con un include que comento con un import minima

https://pelos6.github.io/pruebajekyll/

  • ya lo veo pero sin los css
  • los archivos md tienen que tener un encabezado especial al inicio para que se conviertan a html
---
layout: page
date: 2016-11-05
menuInclude: yes
menuTopTitle: programación
menuSubTitle: "Jekyll"
menuSubIndex: 4
excerpt: "Pequeño resumen del contenido......"
title: Inicio  
permalink: /inicio/  
---
  • nada mas ponerlo con el serve en marcha se genera un directorio inicio donde esta el archivo convertido a html

otro inteno con jekyl nueva

  • lo que pasa es que no resuelve minima

  • sigo este post c:\nube\MEGA\programacion\HtmlCssEstatico\jekyll\nueva>bundle show minima
    C:/tools/ruby23/lib/ruby/gems/2.3.0/gems/minima-1.0.1

  • se genera bien pero falta main.css pues el que esta es main.scss

  • lo copio del directorio _site pues en local funciona.

  • pero no recupera el css nuevo

  • puede ser un problema de directorios

  • modifico en _config.yml

baseurl: "/nueva"
  • era eso pruebo a editar about.md desde el editor de git hub y en un minuto lo veo reflejado

  • nota esto obligará a hacer un git pull para sincronicar esos cambios

  • los archivos *.md que pongo en el directorio C:\nube\MEGA\programacion\HtmlCssEstatico\jekyll\nueva

  • luego los abro y añado

---
layout: default
layout: page
date: 2016-11-05
menuInclude: yes
menuTopTitle: programación
menuSubTitle: "Jekyll"
menuSubIndex: 4
excerpt: "Pequeño resumen del contenido......"
title: programación
---
  • jekyll genera el correspondiente html con la plantilla default y pone en el menu la opción programación