mirror of
https://github.com/jekyll/jekyll.git
synced 2026-01-30 09:18:11 -05:00
845580a258
I added a documentation page on how to build navigation for your site. This topic is primarily intended for users who have a lot of pages on their site (such as for documentation websites), and want to build a more robust sidebar navigation. Jekyll combines Liquid with YAML in interesting ways that aren't really documented clearly in the existing docs, except for a brief reference [here](http://jekyllrb.com/docs/datafiles/#the-data-folder). You can read about Liquid on Shopify and YAML in YAML's docs, but exactly how you store YAML files in a Jekyll project and iterate through them using Liquid loops and filters to generate lists of pages is something that isn't clear to a lot of people. (You can see origins of these questions in [previous help issues](https://github.com/jekyll/jekyll-help/issues/266).) The documentation on navigation would fit well into the Jekyll docs.
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:
bundle install --without test test_legacy benchmarkbundle exec rake site:preview
It's just a jekyll site, afterall! 😉
Updating Font Awesome
- Go to https://icomoon.io/app/
- Choose Import Icons and load
icomoon-selection.json - Choose Generate Font → Download
- Copy the font files and adapt the CSS to the paths we use in Jekyll