labarum — Hugo 博客模板

SHA-256: 17a274fccd0990593c1b3c451539ae6e3373038904e6682bbf1ecc8a613e0238

2026-10-02T17:17:33.334Z

# Labarum
A Hugo/Micro.blog theme based on html and schema tags.

![Basic Header of Labarum](media/labarum-icon.png)

I created this to learn more about Micro.blog and hugo and I'm pretty proud of it. It handles all of the basic Goldmark syntax and has both a light and dark mode. 

## Labarum has a light and dark mode.
![Theme in light mode](media/labarum-part6-light-mode.png "Using Local copy")
![Theme in dark mode](media/labarum-part6-dark-mode.png "Same theme but in dark mode")

## Basic syntax

![Labarum theme with sample text moving from light to dark mode](media/labarum-basic-syntax.gif)

## Block quotes

![Block quotes going from light to dark mode](media/labarum-block-quote.gif)

## Lists

![Lists going from light to dark mode](media/labarum-lists.gif)

## Task lists

![Task list going from light to dark mode](media/labarum-tasklist.gif)


## Table of Contents

The first one is activated by adding <code>{{< toc >}}</code> to your text and will float in the center of the article.

![Labarum table of contents changing from light mode to dark](media/labarum-table-of-contents-center.gif)

The second one is activated by adding <code>{{< floating-toc >}}</code> to your text and will float in the right of the article. 


![Labarum table of contents turning from light to dark mode](media/labarum-table-of-contents-float-right.gif)

## Release notes
### v1.3.31
  * Add `margin-right` and `margin-left` for `bluesky-embed` css class

### v1.3.30
  * Change `font-style` for `<address>`
  
### v1.3.29
  * Add `interpolate-size: allow-keywords` to root of css
  * Adjust `line-height`
  
### v1.3.28
  * Attempt to fix broken css
  
### v1.3.27
  * Fixed typo in `aria-label` for `plugin-container`
  * Changed author information from `<aside>` to `<address>`
  * Add `<nav>` to `<header>` to prepare for grid layout
  * Add `overflow-y: auto` to `<blockquote>` to allow for expansion of element when floating images are larger than expected
  * Add value for `accent-color` in css
  * Remove `--max-width-value` from css as not used
  
### v1.3.26
  * Move table of contents from `<section>` to `<nav>` because I was thinking it through
  * Adjust the colors for `<figure>`, `[popover]`, `.style-box-alt`, and `.aside-info`
  * Adjust colors and size for `audio`
  * Adjust spacing in `rsvp.html`
  * Add more text to `aria-label` for table of contents

### v1.3.25
  * Move author image from containing `<div>`
  * Move hidden author information from `<div>` to `<address>` tag (unseen by users.)
  * Move table of contents from `<aside>` to `<section>`
  * Add `aria-label` to table of contents
  * Adjust padding and margin to `blockquote`
  * Add `border-radius` to `.microblog_reply_textarea > textarea`
  * Change behavior of `a:hover` to no longer have a background come up but change the color of the link itself
  
### v1.3.24
  * Change the `--accent-opposite-alt` to improve contrast
  * Add `text-wrap: balance` to `h#` tags
  * Remove margin between first paragraph and top of the `article div`
  * Adjust margins and paddings for `TableOfContents`
  * Adjust sizes for `FloatRight` and `FloatLeft`
  * Modify padding for code examples
  * Add `@view-transition` and `text-wrap`. This only shows up in blink based browsers

### v1.3.23
  * Make some space adjustments for `<details>`
  * Minor changes to `[popover]`
  
### v1.3.22
  * Invert background colors for dark mode
  * Increase `margin-top` for table of contents header
  
### v1.3.21
  * Add stylying for responding textbox on blogs. See [this post by Manton](https://www.manton.org/2024/05/18/i-took-the.html) for more information.
  * Add very basic styling for popovers so that they match the style for the rest of the theme.
  * Make adjustments to color contrast for dark mode
  * Move text styling within `<figure>` to `<figcation>`
  
### v1.3.20
  * Add css class `no-box-shadow` for instances where it's not needed
  * Make `::selection` have the same color	 as `mark`
  
### v1.3.19
  * Change the `!important` to only be on `lite-youtube` class in css
  
### v1.3.18
  * Created `category.terms.html` and `categories-with-count.html` to better handle navigation of the archive and autogenerated category pages
  * Style changes to `list.html` and removed text
  * Added information to `theme.toml` to include some of the capability that the theme is able to do
  
### v1.3.17
  * Minor changes to aria-labels for footers
  * Change certain `<div>` to `<aside>` and `<footer>` to denote respective roles
  
### v1.3.16
  * Add id to plugin-container
  * Change `line-height` for `h#` tags
  
### v1.3.15
  * Change `overflow-x` on `<detail>` element
  * Make `<section>` use the same padding as article
  * Make `<a>` tags in the custom footer inline-block to that they flow easier in design
  * Add id to custom footer
  * Move the catagory paragraphs in the archive page into a `<div>`
  * Correct date format on archive page
  
### v1.3.14
  * Fix styling issues with archive page
  
### v1.3.13
  * Create archive page to use `<section>` and classes
  * Change class of link in article footer to use `u-uid`
  * Remove `article-hidden` for links that have `role="presentation"`
  * Rearrange classes applied to `<article>`
  * Add `u-url` to `article` title anchor
  
### v1.3.12
  * Remove duplicate description from `site-head.html`
  * Change `keywords` to use `tags` instead of categories. The reason I did this is that although Micro.blog does not support `tags`, it could in the future and `categories` are already denoted for the `article:section`
  * Added `twitter:domain` for those who are still using the tag to parse things
  * Remove styling for `p-name`, this class is for meta-data
  * Adjusted `max-width` for `img, video, iframe,lite-youtube`. The plugin that I use is loaded later and causes the `lite-youtube` object to not render expectedly
  
### v1.3.11
  * Add `headline` to notes that contain a generic title
  
### v1.3.10
  * Changes to `samp`. This is catch the edge case where `samp` is being used as a block element
  * Format `code` in list item. Might have to refactor if there are other edge cases
  
### v1.3.09
  * Typo on `dt-published`
  
### v1.3.08
  * Adjust fonts
  * Make the `a.no-decoration` more accessible by changing contrast
  * Add `FloatLeft` css class
  * Add `::selection` background color to match up with theme
  * Add scrolling for debug output
  * Change the `title` and `aria-label` for microposts to include the date and time. In the local copy of Hugo, an empty string  `title` is automatically added. 
  * Add styling to the top of the `list.html` to make it stand out.
  * Change the date format for the `time` used for published times.
  * Rearrange reply order options to be Micro.blog, Mastodon, and then email
  * Add `articleSection` to list of classes for category tags on a post
  
### v1.3.07
  * Add partials for [upcoming mathematics support in Hugo](https://gohugo.io/content-management/mathematics/ "Mathematics in Markdown"). This can be seen when you toggle the `math` parameter. This has been defaulted to false until v0.122 is available. Demos can be seen on the [MathJax demo page](https://www.mathjax.org/#demo).
  * Use [Modern Font Stacks](https://modernfontstacks.com). [Matt Langford](https://www.mattlangford.com/) discussed this on the [Tiny Theme page on fonts](https://tiny.micro.blog/2024/03/01/changing-fonts.html). I really liked his implementation and you should check it out!

### v1.3.06
  * Change the `li` marker color to `--text-alt` in order to match header color
  * Change padding of `body` to utilize more space on smaller screens
  * add `text-shadow` to `a.no-decoration` 
  * Change logic for the debug flags
  * Create stub for theme `example` folder
  * Temporarily add the `rsvp` shortcode to theme to remove extra whitespace when post is cross posted to mastodon
  
### v1.3.05
  * Improve `h*` tags by changing color to `--text-alt`
  * Make changes to `text-decoration` inspired by [12 Modern CSS One-Line Upgrades](https://moderncss.dev/12-modern-css-one-line-upgrades/#text-underline-offset) to various elements
  * Turn on debugging by default temporarily
  * Modify cursor on `<abbr>`
  * Adjust `line-height` to make `sub`, `sup`, and `ruby` elements less obtrusive to the flow of the document
  * Add `accent-color` to `root` of CSS

### v1.3.04
  * Move the 404 page to proper location according to [documentation](https://help.micro.blog/t/custom-404-page/73)

### v1.3.03
  * Use `article.html` in `list.html`

### v1.3.02
  * Add masonry to `photos-grid-container`
  
### v1.3.01
  * Add style to `<abbr>`
  * Remove some whitespace around optional components
  
### v1.3.00
  * Add styling to .archive_category class from baseline
  * Adjust `text-decoration-color` and `text-decoration-thickness` on `ins`, `del`, and `s` elements
  * Add `a.no-decoration` to style and pagination
  * Hide empty optional and custom `<div>`s if they are empty
  * Toggle the generation of debug output based on a parameter
  
### v1.2.20
  * Shrink and float avatars
  * Make white space in css more consistent
  * Fix for warning about isset
  
### v1.2.19
  * Center contents of custom footer
  * Add padding to top and bottom of optional boxes
  
### v1.2.18
  * Revert change of mastodon logic
  
### v1.2.17
  * Copied code from [Tiny Theme]() to implement optional plugins for micro.blog
  * Changed tabs to spaces in project
  * Added additional schema tags to headers and urls
  * Added styling for custom footer
  
### v1.2.16
  * Update link to mastodon account
  
### v1.2.15
  * Move link to outside of headers
  * Add `u-url` class and `rel="me"` to link found in author footer
  * Make changes for mastodon account conditional of username
  * Make categories conditional
  
### v1.2.14
  * Revert to use `{{ .Site.Author.avatar }}` for OpenGraph images
  
### v1.2.13
  * Adjust margin on avatar images
  * Add mastodon username and server to head
  
### v1.2.12
  * Adjust margins on for smaller viewports
  * Adjust lines and colors for `<del>`, `<ins>`, and `<s>`
  * Remove normalize.css
  * Move styling from elements to classes
  * Configure Goldmark parser to not wrap `<img>` in `<p>` tags
  * Part one of CSS rewrite
  
### v1.2.11
  * Add styling to comments
  
### v1.2.10
  * Add css for `<hr>`
  * Change default image for `og:image` and `itemprop="image"`
  * Move meta `wordCount` to article
  * Become displeased with how version numbers work
  
### v1.2.9
  * Remove bottom border in photos page
  * Adjust spacing in books page
  * Make author information more responsive
  * Remove border radius on blockquote
  
### v1.2.8
  * Accessibility improvements using [WAVE](https://wave.webaim.org "WAVE Web Accessibility Evaluation Tools") to test 
  * Validation improvements to schema tags. Using https://validator.w3.org/nu/ as the tool to validate
  
### v1.2.7
  * Enable [Mermaid.js](https://mermaid.js.org/)
  * Set the version in the `config.json` file
  * Reformat README.md
  * Remove `role="contentinfo"` from author `<aside>`
  * Minor accessibility and validation changes

### v1.2.5

  * Adjustments to the README
  * Turn on Profile information at the bottom of the site

### v1.2.0
  * Rewritten Code blocks  
    * Wrote about the change on [my blog](https://mandarismoore.com/2023/09/22/labarum-code-blocks.html). Incorporated a significant amount of work to understand the Hugo system
  * Table of Contents short codes
  * Moved to Micro.blog standard head

### v1.1.4

  * Create parameters `showDebugInfo` & `showAuthorInfo`
  * Defaults to `false`
  * The information is rendered into the page but is hidden using `display:none` in inline style.
  * Can be toggled on or off in plugin settings.
  * Adjustments in different aspect of the theme to prepare to moving to [CUBE CSS](https://cube.fyi)
  * Modifications to tables
  * Using `min-width` and `margin: auto` for centering the table to the container and making use of the space that is available.
  * Modifications to code blocks
  * An update in rendering added more styling.
  * Removed increased padding on links as part of a:hover
  * Added styling for `<s>`
  * This was previously overlooked as it was thought to be the same as `<del>`
  * Update the README.md