Markdown

This site is build with Hugo and Docsy.

Any file you put under /site/ that has the extension .md will be processed as Markdown. All other files will be served directly. For example, images can be added and they will be served correctly and referenced from within Markdown files.

When preparing for a code review of site docs you can get a preview of how the page will render by visiting the Gerrit issue and clicking the eye icon to the left of the file:

See the Docsy documentation for more details on how to configure and use docsy. For example the Navigation section explains what frontmatter needs to be added to a page to get it to appear in the top navigation bar.

Frontmatter

Each page needs a frontmatter section that provides information on that page. For example:

---
title: 'Markdown'
linkTitle: 'Markdown'
---

This is true for both Markdown and HTML pages. See the Docsy documentation on frontmatter for more details.

Styling And Icons

Docsy supports both Bootstrap and Font-Awesome. Check out their documentation for what they offer.

Bootstrap contains many classes that allow you to avoid setting styles via CSS. For example, just using classes, we can change the font, the padding, and the color:

<p class="font-monospace p-2 text-danger">This is in monospace</p>

Which renders as:

This is in monospace

Diagrams

Mermaid diagrams are enabled, so this:

```mermaid
graph TD;
    A-->B;
    A-->C;
    B-->D;
    C-->D;
```

Gets rendered as:

graph TD;
    A-->B;
    A-->C;
    B-->D;
    C-->D;

Code Snippets

To get syntax highlighting in code snippets you need to specify the language, which is specified after the first code fence, for example this is how you would show HTML markup:

```html
<p class="font-monospace p-2 text-danger">This is in monospace</p>
```

Configuration

The Hugo configuration file is config.toml located in the site directory.