Una introducción a Jekyll, una gema de ruby y generador de sitios estáticos para crear blogs y otros sitios estáticos

1. Blogging for Hackers
Una introducción a Jekyll

2. “Simple, blog-aware, static site generator”
Simple: No hay base de datos solo archivos de texto
Blog-aware: Funciona para otras cosas pero es optimizado
para un blog (a diferencia de un cms tradicional)
Sitios estáticos: no hay backend, ni cms solo html, css, js
¿Que es Jekyll?

3. ¿Por que Jekyll?
● Simplicidad
● hosting gratis con github pages
● Markdown es chevere
● Bloguea sin internet--y sin distración
● Ser dueño de todas tus cosas
● Escribe en vim (o emacs o sublime o lo que sea)

4. ● Fácil de leer
● Rápido de escribir
● Puedes sacar apuntes y transferirlas
directamente en posts para tu blog
● grep...vim (o emacs)...
Nota de pie: Markdown es bacán

5. Inicio - Rápido!
gem install jekyll
jekyll new blog
cd blog
jekyll serve
done
demo:
https://gist.github.com/5601a105a7ea645663dc

6. Inicio...haciéndolo más bonito!
Customizar el diseño por defacto
(un ejemplo):
https://gist.github.com/7a33b25e6cd705d64289
O usa una plantilla (theme).

7. Themes!
Que plantillas usar
● ¡El diseño por defecto ahora es muy bonito!
● jekyllthemes.org tiene un catálogo de plantillas gratis
● Hyde es un diseño bien adaptado para proyectos
Two options
● fork(¿forkear?) un theme existente: Suelen tener instrucciones
o El que yo uso es muy bien documentada
o mmistakes.github.io/minimal-mistakes/theme-setup/
● Github hosting tiene plantillas para elegir también si quieres que te
generen el sitio: https://pages.github.com/

8. Github Hosting
Gratis por un usuario y para todos los proyectos que
quieres
Para el usuario
● Un repo con el nombre usuario.github.io
● Haz push a master y ya está
Para proyectos
● Mismo repo que el proyecto
(www.github.com/blasfem/fabricas)
● Un branch especial: gh-pages...haz push a este branch
(en vez de master) y ya está

9. Un poquito de vim...
Un demo de mi workflow con jekyll en vim:
https://gist.github.com/63e64ecd406ad777ecfb
Mis dotfiles estan en github:
www.github.com/smcabrera/castillo-cabrera

10. Recursos
• Buena introducción aqui:
http://www.smashingmagazine.com/2014/08/01/build-blog-jekyll-github-pages
• github pages--una guía muy fácil para empezar con github hosting. Puedes
crear un blog--con temas--sin tocar la línear de comando:
https://pages.github.com/
• Jekyll bootstrap: http://jekyllbootstrap.com/usage/blog-configuration.html trata
de hacer lo más fácil configurar tu blog.
• ruhoh project: http://ruhoh.com/docs/2/ Otro intento a simplificar el proceso de
customización de tu blog.
• Jekyll Now: Crear un blog con jekyll en minutos sin tocar la línea de comando:
https://github.com/barryclark/jekyll-now

11. Resources (contd)...
• Google analytics con jekyll: https://developmentseed.org/blog/google-
analytics-jekyll-plugin/
• Un plugin de vim para mejorar como se ve el sintaxis de markdown, pero
particularmente bueno para jekyll. Entiende el formateo de markdown que usa
jekyll y tiene muy buen soporte para bloques de código. Aqui:
https://github.com/gabrielelana/vim-markdown
• Este post discute como hacer multilingúe tu blog:
https://developmentseed.org/blog/multilingual-jekyll-sites/