This will add a commit to your repo with everything ready to go. You’ll probably want to modify parts of this theme for your own usage! Subtree makes that easy, because you’ve just copied the code into your repo ✨
Add / Modify the theme field in your config.toml for your hugo site:
theme = "paperesque"
You’ve got a bunch of options for the homepage:
1. A custom list of links.
This was the only thing supported until recently (Dec 2022-ish).
Add something like this to your site’s config.toml:
name = "blog"url = "posts/"[[params.menu]]
name = "tags"url = "tags/"[[params.menu]]
name = "about"url = "about/"[[params.menu]]
name = "contact"url = "contact/"
2. Markdown content
You can create a /content/_index.md and the content of that page will render as the homepage.
3. A section
You can create a /content/_index.md and in the frontmatter add a display_section key. The name of that section will be used to render a list of content.
4. A section + custom content in a sidebar.
Do the same as for option 3 (‘a section’), but also include markdown content in that file. The markdown content will render on the left as a sidebar, and the list of section items will render in the main panel.
Links in the top-right corner
These are config driven! Add this to your config.toml (for example):
name = "about"url = "about/"[[params.topmenu]]
name = "contact"url = "contact/"[[params.topmenu]]
name = "rss"url = "posts/index.xml"
Removing original images after resizing
The fitfigure shortcode is exactly the same as the figure shortcode, but it automatically resizes your images to fit the container, and provides different resolutions for different DPIs (1x, 2x).
Whenever you use this shortcode, the theme makes a mental note of the resource you specified.
Now, you need to do some configuration if you want the originals to be removed from the output.