jekyll/docs
Tom Johnson 8bacf01c1b Add documentation about order of interpretation
This tutorial defines Jekyll's "order of interpretation," as @swizca called it in [#5808](https://github.com/jekyll/jekyll/pull/5698). This tutorial makes it clear how Jekyll processes files as it renders the static HTML output.

This order-of-interpretation info is important for troubleshooting and generally understanding Jekyll. It's important to know how Jekyll generates out the files, what rules it uses, what order it processes things, and so forth.

(Note: Please process 5698 before this request, because 5698 includes the tutorial collection/navigation that this tutorial fits into. I also need to update this commit to add a link in the Tutorials nav to this topic, but I'm waiting for 5698 to be merged so that menu becomes available.)

@jekyll/documentation
@dirtyf
2017-01-29 21:45:03 -08:00
..
_data moved includes to appear after templates 2016-12-26 18:36:39 -08:00
_docs Merge pull request #5817 from DirtyF/pull/installation 2017-01-27 11:37:03 -05:00
_includes Switch to `https` when possible. 2016-11-29 23:39:23 +02:00
_layouts Fix 'Improve this page' link. 2016-11-02 15:09:46 -07:00
_posts fix broken links in release post 2017-01-27 20:51:56 +01:00
_sass Update _font-awesome.scss 2016-12-01 11:57:10 +02:00
_tutorials Add documentation about order of interpretation 2017-01-29 21:45:03 -08:00
community move site to docs folder 2016-11-02 13:51:14 -07:00
css move site to docs folder 2016-11-02 13:51:14 -07:00
fonts Use only the used Font Awesome icons. 2016-11-29 10:41:49 +02:00
help move site to docs folder 2016-11-02 13:51:14 -07:00
img Review CI pages 2017-01-24 01:42:53 +01:00
js move site to docs folder 2016-11-02 13:51:14 -07:00
news move site to docs folder 2016-11-02 13:51:14 -07:00
redirects move site to docs folder 2016-11-02 13:51:14 -07:00
.gitignore move site to docs folder 2016-11-02 13:51:14 -07:00
404.html move site to docs folder 2016-11-02 13:51:14 -07:00
CNAME move site to docs folder 2016-11-02 13:51:14 -07:00
_config.yml Merge pull request #5744 from DirtyF/pull/docs-use-defaults 2017-01-11 09:13:38 -08:00
favicon.ico move site to docs folder 2016-11-02 13:51:14 -07:00
icomoon-selection.json Use only the used Font Awesome icons. 2016-11-29 10:41:49 +02:00
index.html move site to docs folder 2016-11-02 13:51:14 -07:00
latest_version.txt Queue up a 3.4 deploy with unfinished release post. 2017-01-18 16:54:36 -05:00
readme.md Merge pull request #5611 from XhmikosR/https 2016-11-29 15:50:29 -08:00

readme.md

Jekyll docs site

This directory contains the code for the Jekyll docs site, jekyllrb.com.

Contributing

For information about contributing, see the Contributing page.

Running locally

You can preview your contributions before opening a pull request by running from within the directory:

  1. bundle install --without test test_legacy benchmark
  2. bundle exec rake site:preview

It's just a jekyll site, afterall! 😉

Updating Font Awesome

  1. Go to https://icomoon.io/app/
  2. Choose Import Icons and load icomoon-selection.json
  3. Choose Generate Font → Download
  4. Copy the font files and adapt the CSS to the paths we use in Jekyll