smcleod.net

Source repository for my personal website.

Usage

Visit https://smcleod.net

Contributing

Feel free to raise a PR or create an issue if you find any problems or have a suggestion.

After cloning, point git at the tracked hooks directory:

git config core.hooksPath .githooks

This activates a pre-commit hook that replaces smart quotes (‘ ’ “ ”), em-dashes (—) and en-dashes (–) with their plain ASCII equivalents in any staged markdown file. If a flagged file also has unstaged changes, the commit aborts so unstaged edits aren't pulled in.

Hugo Shortcodes

See SHORTCODES.md.

Wide Images

To display images at 80% of the browser width (breaking out of the normal content width), use the wide-image shortcode:

{{< wide-image src="image.png" alt="Description" caption="Optional caption" >}}

Parameters:

• src (required): Path to the image file
• alt (optional): Alt text for accessibility
• caption (optional): Caption text displayed below the image

Legacy support: Images with ?c=wide or #wide URL parameters will still work for backwards compatibility.

Mastodon

License

• Copyright © 2024 Sam McLeod
• This project is open source and licensed under CC BY-SA 4.0