# Fieldnotes

> Documentation for Fieldnotes, a Hugo theme for personal sites: notes, trips with maps and photo galleries, maths, six presets and fourteen colour schemes.

A Hugo theme for a personal site. Posts and notes, trips with maps and photo galleries, maths and code, drawn in six presets with fourteen colour schemes.

## Docs

- [Docs](https://fieldnotes.maxfettinger.com/docs/guide/index.md): Everything about Fieldnotes: setting up a site, writing, trips with maps and photos, the look, and making it your own.
- [Getting started](https://fieldnotes.maxfettinger.com/docs/guide/getting-started/index.md): From an empty folder to your site online, in four steps.
- [Install the tools](https://fieldnotes.maxfettinger.com/docs/guide/getting-started/install-the-tools/index.md): Hugo builds the site, Git keeps its history and publishes it, Go lets Hugo download the theme.
- [Create your site](https://fieldnotes.maxfettinger.com/docs/guide/getting-started/create-your-site/index.md): A new Hugo project, Fieldnotes added to it, and the settings to make it run.
- [Your first post](https://fieldnotes.maxfettinger.com/docs/guide/getting-started/your-first-post/index.md): A Markdown file in content/posts/, and it's on the home page.
- [Publish](https://fieldnotes.maxfettinger.com/docs/guide/getting-started/publish/index.md): Your site on GitHub Pages, rebuilt by itself on every change.
- [Writing](https://fieldnotes.maxfettinger.com/docs/guide/writing/index.md): The home page, posts and pages, and everything Markdown can do in Fieldnotes.
- [The home page](https://fieldnotes.maxfettinger.com/docs/guide/writing/home-page/index.md): A photo, a greeting, a few sentences about you, your profiles, an optional card of your own, and your latest posts.
- [Posts and pages](https://fieldnotes.maxfettinger.com/docs/guide/writing/posts-and-pages/index.md): Sections, front matter, drafts, the menu, and pages like About.
- [Markdown](https://fieldnotes.maxfettinger.com/docs/guide/writing/markdown/index.md): Every Markdown element, and what Fieldnotes does with it.
- [Maths and code](https://fieldnotes.maxfettinger.com/docs/guide/writing/maths-and-code/index.md): Formulas with MathJax, and code in your colour scheme's colours.
- [Link cards](https://fieldnotes.maxfettinger.com/docs/guide/writing/link-cards/index.md): A project that lives elsewhere, as a card that links there.
- [Trips](https://fieldnotes.maxfettinger.com/docs/guide/trips/index.md): A map of the route and galleries of photos and videos, in a post of their own.
- [A trip, start to finish](https://fieldnotes.maxfettinger.com/docs/guide/trips/a-trip-start-to-finish/index.md): From a new folder to a post with a map and galleries, using the theme's trip template.
- [Photo galleries](https://fieldnotes.maxfettinger.com/docs/guide/trips/photo-galleries/index.md): A folder of photos becomes a row that scrolls sideways and opens in a full-screen viewer.
- [Trip maps](https://fieldnotes.maxfettinger.com/docs/guide/trips/trip-maps/index.md): Your route on a topographic map, in the colours you choose, with a free key from MapTiler.
- [Look and feel](https://fieldnotes.maxfettinger.com/docs/guide/look/index.md): Six presets, fourteen colour schemes, light and dark, fonts, backgrounds and single colours.
- [Presets](https://fieldnotes.maxfettinger.com/docs/guide/look/presets/index.md): How the site is drawn. Pick one in hugo.toml; it brings its fonts and a colour scheme.
- [Colour schemes](https://fieldnotes.maxfettinger.com/docs/guide/look/colour-schemes/index.md): Fourteen sets of colours, each with a light and a dark version.
- [Light and dark](https://fieldnotes.maxfettinger.com/docs/guide/look/light-and-dark/index.md): Both with a switch, following the visitor's system, or only one of them.
- [Fonts](https://fieldnotes.maxfettinger.com/docs/guide/look/fonts/index.md): Any family from Google Fonts by its name, or fonts you host yourself.
- [Backgrounds and colours](https://fieldnotes.maxfettinger.com/docs/guide/look/backgrounds-and-colours/index.md): Graph paper, dots, nothing or your own tile behind the page, and any single colour changed per mode.
- [Customizing](https://fieldnotes.maxfettinger.com/docs/guide/customizing/index.md): Changing anything the settings don't cover, without touching the theme's files.
- [Your own CSS](https://fieldnotes.maxfettinger.com/docs/guide/customizing/your-own-css/index.md): One file in your site, added after the theme's CSS, that wins over it.
- [Hooks](https://fieldnotes.maxfettinger.com/docs/guide/customizing/hooks/index.md): Empty templates in the theme that you fill with HTML of your own, on every page.
- [Your own presets and schemes](https://fieldnotes.maxfettinger.com/docs/guide/customizing/presets-and-schemes/index.md): A look of your own as a plugin, a CSS file and a small data file, in your site's folders.
- [Templates, shortcodes and archetypes](https://fieldnotes.maxfettinger.com/docs/guide/customizing/templates-and-archetypes/index.md): Changing what a part of the page contains, adding your own Markdown tags, and templates for new posts.
- [Reference](https://fieldnotes.maxfettinger.com/docs/guide/reference/index.md): Every setting, front matter key and shortcode, in one place.
- [Configuration](https://fieldnotes.maxfettinger.com/docs/guide/reference/configuration/index.md): Every setting Fieldnotes reads from hugo.toml, with its default.
- [Front matter](https://fieldnotes.maxfettinger.com/docs/guide/reference/front-matter/index.md): The keys Fieldnotes reads at the top of a page.
- [Shortcodes](https://fieldnotes.maxfettinger.com/docs/guide/reference/shortcodes/index.md): The two shortcodes Fieldnotes adds, and their options.
- [Search engines](https://fieldnotes.maxfettinger.com/docs/guide/reference/search-engines/index.md): What Fieldnotes tells search engines and link previews about your site and you, without anything visible.
- [Help](https://fieldnotes.maxfettinger.com/docs/guide/help/index.md): Common problems, working with an AI assistant, and what's planned.
- [Troubleshooting](https://fieldnotes.maxfettinger.com/docs/guide/help/troubleshooting/index.md): Symptoms, their usual causes, and the fix.
- [Working with an AI assistant](https://fieldnotes.maxfettinger.com/docs/guide/help/ai-assistants/index.md): Giving an assistant like ChatGPT, Claude or Copilot the context to change your site well.
- [Roadmap](https://fieldnotes.maxfettinger.com/docs/guide/help/roadmap/index.md): What Fieldnotes doesn't do yet, and may, if people need it.