Skip to content
This repository has been archived by the owner on Feb 27, 2022. It is now read-only.

DebianBrasil/debianbrasil.github.io

Repository files navigation

Develop

Base was built with Jekyll version 3.4.3, but should support newer versions as well.

Install the dependencies with Bundler:

$ bundle install

Run jekyll commands through Bundler to ensure you're using the right versions:

$ bundle exec jekyll serve

Editing

The sticky sidebar in tutorials in populated by pulling out <h2> elements from the content.

Posts

  • Add, update or remove a post in the Posts collection.
  • The tutorials page is organised by categories.
  • Change the defaults when new posts are created in _posts/_defaults.md.

Post Series

To create a new series:

  • Add a new document to the sets collection.
  • Set the title and description.

To add a tutorial/post to a series:

  • Add a set field to the tutorial front matter which points to the file name of the desired set without the .md extention. e.g. If I have a set at _sets/getting-started.md I would use this in my tutorial front matter: set: getting-started.
  • Add a set_order field to the tutorial front matter and specify a number. This is the tutorials order in the set.