README_dev.md

Install and test locally

Following Hugo installation instructions (Linux):

sudo snap install hugo
hugo mod get -u
hugo server -D

New content

From terminal:

hugo new content content/path/filename.md

This will use the (default) archetype, populating the new file with typical frrontmatter.

Images

If an image appears only on one page, bundle it with that page. See Hugo, Hextra guides.

If an image is clear to read in light or dark mode, rather than creating a new one for the other mode consider applying a color inversion filter. For example, rather than

![circuit](/images/Hadgate.png)

use

<img class="light-invertible" src="../images/Hadgate.png" alt="Hadamard gate circuit"/>

If the image was created with dark mode in mind, use class="dark-invertible" instead.

Bonus points: make the background transparent, rather than white (or other solid color).

Bibliography

To add bibliographic references with a uniform style throughout, use pandoc and CSL to generate footnote markdown.

Create or modify .bib files in assets/bib/. Check the readme in that folder for more details. By way of example, use

pandoc -t markdown_strict --citeproc nocite.md -o bib-out.md --bibliography standards.bib --csl=apa-no-ampersand.csl