Jekyll Presentation Slides

jekyllBlogging for HackersCurtis Miller / Flatterline

Static Site Generator

Ruby + Liquid + YAML = Awesome!

How Does It Work?• Gathers content from _posts, _includes and other ﬁles• Applies a template• Converts Markdown and Textile to HTML• Runs Liquid converters• Outputs static HTML pages

Conﬁgurable _conﬁg.yml

YAML Configuration• Global configuration options• Per page / post configuration options (YAML Front Matter)• Add your own key / value pairs and use them as you see fit

What’s Built In?• Pagination• Custom permalink structure• Related post extraction (use with GSL for faster generation)• Syntax highlighting• Markdown / Textile conversion

Plugin Architecture (easily extensible) _plugins/*.rb

Need a Custom Generator?

No Problem.module Jekyll class CategoryGenerator < Generator def generate(site) ... end endend

Need a Custom Liquid Tag?

No Problem.module Jekyll class RenderTimeTag < Liquid::Tag def render(context) ... end endendLiquid::Template.register_tag( ‘render_time’, Jekyll::RenderTimeTag)

Deployment• Heroku free instance• GitHub Pages• Directly to Amazon S3• Anywhere that can serve static pages!

What If I Want Blog Comments?Extend with Disqus, Intense Debate or Facebook comments

What If I NeedSomething Dynamic? Extend with Sinatra

Typical Workflow$ cd <my blog dir>$ foreman start[Runs whatever you specified - e.g., Jekyll, Compass, Sinatra, etc.]$ mate _posts/2011-12-20-jekyll-blogging-presentation-at-rubyaz.md[Add content to file...]$ git add _posts/2011-12-20-jekyll-blogging-presentation-at-rubyaz.md$ git commit -m “New post about Ruby AZ presentation”$ git push && git push heroku

Any Gotchas?• YAML Front Matter means it’s a special ﬁle; No YAML, no special processing• Pagination only works with HTML ﬁles (i.e., no Markdown or Textile pagination)• No generator for initial directory structure

A Few Stats (as of 2011-12-20)• Over 400 documented sites using Jekyll• ~50 plugins• >4,500 watchers• >700 forks

How Do I Get Started?!

gem install jekyll

Thanks! Any questions?Curtis Miller / Flatterline / curtis@flatterline.com https://github.com/flatterline/flatterline.com

http://flatterline.com	61
http://millarian.com	56
http://www.rubyaz.org	43
http://lvh.me	23
http://rubyaz.org	20
http://feeds.feedburner.com	4
http://localhost	4
http://rubyaz.heroku.com	1
http://www.hanrss.com	1
https://millarian.com	1

Jekyll Presentation Slides

by Curtis Miller on Dec 21, 2011

Accessibility

Categories

Tags

Upload Details

Usage Rights

10 Embeds 214

Statistics

Jekyll Presentation Slides — Presentation Transcript