The mnml Settings Explained

This post helps to explain the different options mnml has to customize your blog.

The Settings

The mnml settings.

Site Language

Setting a value in this field will localize output pages in the preferred language. For example, setting “fr” in this field will localize to French strings. Localization strings available are:

  • en: English
  • de: German
  • es: Spanish
  • fi: Finnish
  • fr: French
  • it: Italian
  • pt: Portuguese
  • ru: Russian
  • sv: Swedish
  • uk: Ukrainian
  • zh-TW: Simplified Chinese

Fediverse creator

Mastodon 4.3 adds support for a newly proposed OpenGraph tag to identify the creator of a link shared on Mastodon.

For more information about what it means and how to set this up for your own Mastodon username, check out this post on the Mastodon blog.

Use a Short Date

This will output a shorter date on site pages.

Use a Narrow Site Header

This will render the site header the same width as the main page.

Hide header avatar

This will prevent the site header avatar from being rendered.

Custom avatar

You can select a custom header icon to display if you’d rather not use your Micro.blog user profile image.

Simply select any image that can be browsed on the internet and insert the link in the field. I recommend using square images no bigger than 512 pixels on each side.

Does not work if “Hide header avatar” is enabled.

Home page categories

If you’d like to show posts from a specific category on your home page instead of all posts, enter the category name here. Leaving it blank will show all posts.

Show full posts on homepage

By default, mnml will display summary posts on the home page. Enabling this option will output full length posts on the home page.

Show read time on titled posts

This setting adds a localized string for how many minutes it will take to read the post. Only works on posts with a title.

Show full posts on category pages

Just like the “Show full posts on homepage” setting, this will show full posts on category related pages.

Show categories on archive pages

Enabling this option will include button links to each category at the top of your Archive page, allowing users to easily view posts from a specific category. Disabling the setting hides the buttons.

Show post count for archive page categories

This will show the number of posts within the archive page categories. “Show categories on archive pages” must be enabled.

Photos category

If you’d like to show your photos from just a specific category on the photos page, enter the name of that category here, as in the example above.

If you’d like for all images to be displayed regardless of category, simply leave the setting blank.

Display all image formats

Enabling this setting will display png, webp, and other image formats in addition to jpg on the photos page.

Use photos masonry layout

mnml comes with two different photo layout options: grid and masonry. Grid will display images in square sizing regardless of size, and masonry will fit images together, maintaining their full size in the layout.

Experiment with this setting. Personally, I like the masonry layout myself.

Use a wider photos page

Some people may not like the more narrow layout of the blog default for their photos page, so an option was added to show the page just a little wider.

Experiment with this setting too. I like the wider page myself.

Show first post image only

This setting will limit the photos page to only display the first image in a post that would show up on the photos page.

Number of search results

Sets the number of search results returned once you’ve added a search page. The default is five.

Finally, if showing footer credits for other people’s work on your blog is not your thing, you can hide them by enabling this setting.

This choice is entirely up to you.

Questions and Comments

If you have questions or comments, please do get in touch with me.

Long Posts