DCgov Guides Template

Add a New Page

To add new pages, create a Markdown file in the _pages/ directory of the repository. For example, the Markdown text for this page is _pages/add-a-new-page.md.

The Markdown document begins with this YAML front matter:

layout: page
title: Add a New Page

The page will be accessible at _pages/add-a-new-page.md.

Every link to another page must be prefixed with {{ site.baseurl }}. For example, this link to Update the config file appears in the Markdown source as:

[Update the config file]({{ site.baseurl }}/update-the-config-file/)

Next steps

Click the Update the config file entry in the table of contents to learn how to configure your guide.

Close

Glossary of Terms

  • A glossary term

    To add glossary terms, edit the glossary.yaml file in the _data folder.

  • Another term

    Glossary terms need a term, slug, and definition attribute. The term attribute will appear above the definition. The slug is a unique identifier for the term. It should be lowercase, with no special characters or punctuation, and any spaces replaced with a dash.

  • Yet another term

    Want to link to a specific glossary term in your text, like this one here? You will need to edit your markdown like so:

    [this one here](#glossary){:define="yet-another-term"}

    Just place the text you want linked in the brackets and the correct slug within the quotes.