Metadata
Each blog post’s permalink, title and publish date is generated automatically. You can override some or all of this metadata on the file’s first line.
Date: July 5th, 2020 Permalink: /metadata You must leave a space after the colon between the metadata property (e.g. Date) and its value. Metadata must be separated from the rest of the post by at least one blank line.
Dates
A blog post’s publish date is the same as the file’s creation date by default. You can specify a different date in the file’s path or in its metadata:
Date: July 5th, 2020 Blot supports a variety of date formats. These all produce a post with the same date: 07/05/2020 July 5, 2020 7.5.2020 2020-07-05 00:00 You can use underscores, dashes, slashes and dots to separate the numbers in the date.
You can specify a post’s publish date in its path. For example, all four of these posts share the same publish date:
Please note that a date specified inside a file overrides a date specified in its path. If you specify a date in the future, your post will be published then.
Tags
Use tags to connect posts by similar subject. Specify tags in the file’s metadata or in its path. Here’s an example blog post with two tags in its metadata:
Tags: Getting started, Documentation Tags are case-insensitive and may contain whitespace. Blot picks the case you used last when displaying the tag on your blog.
| Path | Tagged |
|---|---|
| Pictures, Holiday | |
| Reviews | |
| Notes |
Metadata reference
| Title | Defaults to the text of the first heading in the blog post or the file’s name. |
| Date | Defaults to the file’s creation date. Specify a different date in the file’s metadata with one of the supported formats. You can also change a post’s publish date using the file’s path. |
| Permalink | Defaults to a URL-friendly version of the post’s title. Specify a different permalink in the file’s metadata, or adjust the default permalink format. |
| Summary | Defaults to the text of the first sentence of the first paragraph in the file. |
| Teaser | Defaults to the first few paragraphs of the blog post. You can specify a teaser in the file’s metadata or insert the breakpoint {{more}} yourself.You can specify the end of the teaser using the {{more}} tag somewhere in the file.Everything above the {{more}} tag, including this line, will be in the post’s teaser. |
| Tags | You can tag a blog post in the file’s metadata or using the file’s path. |
| Thumbnail | Defaults to the largest image in the blog post. You can specify a URL, or a path to an image in your blog’s folder. |
| Draft | Determines whether a file becomes a draft. Can be ’Yes’ or ’No’. Defaults to ’No’ unless the file is inside a folder called ’Drafts’. |
| Page | Determines whether a file becomes a page or a blog post. Can be ’Yes’ or ’No’. Defaults to ’No’ unless the file is inside a folder called ’Pages’. |
| Menu | Determines whether a file appears on your blog’s menu. Can be ’Yes’ or ’No’. Defaults to ’Yes’ for pages and ’No’ for blog posts. |
Custom metadata
You can also define your own metadata for use in your template.
Metadata in HTML files
You can use a comment at the start of an HTML file to specify metadata.
2
3
4
5
6
7
8
9
10
<!--
Date: July 5th, 2020
Permalink: /metadata
-->
The comment containing metadata in an HTML file
<b>must</b> start on the file's first line.