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.