/docs

Documentation minisite for Pop!_OS and related projects

Primary LanguageHTMLOtherNOASSERTION

Pop!_Docs

Minisite for Pop!_OS and related projects.

Listing of all docs

Jekyll & GitHub Pages

This site relies on recent updates to GitHub Pages or the relevant Ruby Gems for local development as well as the "v2" styling of System76.com.

Other Notes

File names

Docs are .md files in the docs/ folder. Please dash-separate words in filenames like-this.md.

Front Matter

Docs use Front Matter to set some attributes. They'll fall back to something sane if omitted, but to prevent duplicate titles, set the title at the top of the file:

---
title: Foo
description: Bar baz bin qux
---

And then don't start the doc with a heading, as it will show up automatically.

You should also set a description; this will show up on the docs index page.

Local Development

To run a local copy of the site to see changes without pushing, install Ruby, Nodejs, and Bundler (for more info, see this GitHub Documentation):

curl -sL https://deb.nodesource.com/setup_6.x | sudo -E bash - # Add stable NodeJS repo
sudo apt install -y build-essential nodejs ruby ruby-dev       # Install dev tools, NodeJS, and Ruby
sudo gem install bundler                                       # Install Bundler to manage site dependencies

Then run jekyll:

bundle exec jekyll serve # Run Jekyll with Bundler