Typo is a theme backed by simplicity, as you can see in the screenshots below. The goal was to have a website centered around content and nothing more.
Homepage
Article
Table of content
To receive updates, add the theme as a submodule:
git submodule add git@github.com:tomfran/typo.git themes/typo
Otherwise, you can clone the repo and copy it manually to your theme folder.
You can find a repo using this theme here.
You can add auto-numbering to the pages by setting the following parameter in the header of your MD files. The numbering is currently supported by level 3 subheadings.
autonumber: true
Note that autonumbering starts from h2 tags, hence you need to start sections with ## headings.
## First -> 1 First
### Second -> 1.1 Second
#### Third -> 1.1.1 Third
In your hugo.toml file you can specify the preferred theme:
theme = "light | dark | auto"
If nothing is set, the default setting is auto.
You can tags to decide if images are displayed in dark or light mode, as GitHub is doing for readmes.
Let's say you have two different versions of an image, setting #dark or #light does the trick.
You can of course remove the final tag to always show the same image in light and dark mode.
The fonts in use are Literata and Monaspace Argon.
Various miscellaneous features:
- Latex blocks overflows on mobile to prevent having strange alignments;
- Code blocks are displayed with ligatures.
---
title: "Search Engine in Rust"
date: "2024-02-01"
summary: "A search engine overview and Rust implementation."
toc: true
readTime: true
autonumber: true
math: true
---
Your content...
baseURL = 'https://example.org/'
languageCode = 'en-us'
title = 'Title'
theme = 'Typo'
# Disable tags, actually, they are rendered as a list, but the idea is to disable them.
disableKinds = ['taxonomy']
# Google analytics code
googleAnalytics = "G-xxxxxxxxxx"
[params]
# Appearance
theme = 'auto'
# Intro on main page, content in markdown, if you omit title or content the other can be displayed
homeIntroTitle = 'Hello traveler!'
homeIntroContent = """
Join me on this journey as I explore the ever-evolving landscape of software engineering,
fueled by curiosity and a relentless drive to innovate.
Together, let's push the boundaries of what's possible and craft solutions that shape the future.
"""
# Collection to display on home page:
# in this case we would display content/posts pages
homeCollectionTitle = 'Posts'
homeCollection = 'posts'
# Pagination size across all website, this is the same for homepage and single list page
paginationSize = 100
# Display summaries under post list entries
listSummaries = true
# List entries date format
listDateFormat = '2 Jan 2006'
# Social icons
[[params.social]]
name = "linkedin"
url = "https://www.linkedin.com/in/your-name"
[[params.social]]
name = "medium"
url = "https://medium.com/@your-name"
[[params.social]]
name = "github"
url = "https://github.com/your-name"
# Main menu pages
[[params.menu]]
name = "home"
url = "/"
[[params.menu]]
name = "posts"
url = "/posts"
[[params.menu]]
name = "resume"
url = "/resume"
# Syntax highlight on code blocks, all styles:
# https://xyproto.github.io/splash/docs/all.html
# I suggest algol
[markup]
[markup.highlight]
style = 'algol'The SVGs for social icons are taken from Hugo PaperMod.
Feel free to write proposals or stuff you'd like to see. If you feel like contributing, PRs are welcome!
Leave a star if you are using the theme, I would really appreciate! ⭐
- Bring SEO and performance metrics to 100% both on mobile and desktop;
- Add additional options on posts list view;
- Add color palettes;
- Add a proper Tags page;
- Cleanup SVGs with coherent icon styles.