Documentation/README.md
2021-05-22 22:57:50 +02:00

2.1 KiB

Documentation

User-made documentation for GooseMod.

View the documentation.

Adding content

To add content to this documentation, first fork it to have your own copy of the repo. Clone your fork and make your edits there.

To add a page, add a MarkDown .md file to one of the categories (eg: module-development/).

You can also add your own category by adding a directory with a README.md file inside, that describes what your category is about and lists the category's files by adding this line:

{% include list.liquid all=true %}

By default Jekyll will pull the first title as the page's title, but that can be overwritten with front matter at the top of your page:

---
title: Your title
# other front matter definitions
---

To sort a category's pages, add a sort property to the pages' front matter section:

---
# other front matter definitions
sort: <number>
---

Updating the documentation website

Before pushing your edits to the documentation, you may want to see what they look like. To do so, you need to:

  • have a local Ruby 2.7 environment
  • install the bundler and jekyll gems gem install bundler jekyll
  • install this project's specific requirements: bundle install (or bundle update if you already built it before)
  • run Jekyll: bundle exec jekyll serve
  • open the address that is returned on the terminal in your browser (usually http://127.0.0.1:4000/)

To push your modifications to the documentation, push your modifications to your fork and submit a pull request to this one.

No particular operation is needed, Github Pages will update the documentation's website whenever commits are pushed to this repo.

Additional resources