Personal blog powered by Hugo with the nuno theme (pinned to v0.3.0).
-
Install mise — it will pick up the Hugo version from
mise.toml:mise install
-
Clone with submodules:
git clone --recurse-submodules https://github.com/bosmak/blog.git
If you already cloned without
--recurse-submodules:git submodule update --init --recursive
To upgrade to a newer nuno release:
git -C themes/nuno checkout vX.Y.Z git add themes/nuno git commit
-
Start the dev server:
hugo server -D
The site will be available at http://localhost:1313.
content/posts/— Markdown posts. The single post ships with two Mermaid flowcharts; Mermaid is wired in via a site override ofpartials/head.html, so any post withmermaid: truein its front matter renders<pre class="mermaid">andmermaidfenced blocks.assets/— images and CSS that nuno's image/CSS pipeline ingests. The profile photo (profile.jpg) and favicon live here so nuno can process them.layouts/partials/head.html— site override that inlines nuno's CSS together withassets/css/custom.cssand boots Mermaid. It tracks nuno's upstreamhead.html; when bumping nuno, port any new lines from the theme.layouts/partials/mermaid.html,layouts/shortcodes/mermaid.html,layouts/_default/_markup/render-codeblock-mermaid.html— Mermaid support that nuno doesn't ship.
hugo new posts/my-post-slug.mdThen edit content/posts/my-post-slug.md and add front matter. Useful keys:
mermaid: true— render any```mermaidcode blocks and{{< mermaid >}}shortcode blocks in this post.cover: { image: "images/foo.png", alt: "..." }— sets the social-share preview image. nuno does not display cover images in the page body; the design is cover-free on purpose.
Pushes to main automatically build and deploy to GitHub Pages via the deploy workflow.