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.

 Post.txt 
Date: MMMM Do, YYYY
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:

 Post.txt 
Date: MMMM Do, YYYY

Blot supports a variety of date formats. These all produce a post with the same date:

MM/DD/YYYY   MMMM D, YYYY
M.D.YYYY     YYYY-MM-DD 00:00

You can use underscores, dashes, slashes and dots to seperate 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:

YYYY MM DD Post.txt
YYYY MM DD-[Post.txt]
YYYY MM-DD-[Post.txt]
YYYY-MM-DD-00-00[-Post.txt]

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:

 Post.txt 
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.




  

You can add tags to a post in the file’s name or path. Include the tag, wrapped in brackets. Here’s a few examples:

PathTagged
[Pictures] [Holiday] Picture.jpgPictures, Holiday
[Reviews] Thief.txtReviews
[Notes] Pnin.txtNotes

Metadata reference

TitleDefaults to the text of the first heading in the blog post or the file’s name.
DateDefaults 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.
PermalinkDefaults 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.
SummaryDefaults to the text of the first sentence of the first paragraph in the file.
TeaserDefaults 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.
TagsYou can tag a blog post in the file’s metadata or using the file’s path.
ThumbnailDefaults to the largest image in the blog post. You can specify a URL, or a path to an image in your blog’s folder.
DraftDetermines whether a file becomes a draft. Can be Yes’ or No’. Defaults to No’ unless the file is inside a folder called Drafts’.
PageDetermines 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’.
MenuDetermines 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. Blot uses

Metadata in HTML files

You can use a comment at the start of an HTML file to specify metadata.

1
2
3
4
5
6
7
8
9
10
<!--
Date: MMMM Do, YYYY
Permalink: /metadata
-->

The comment containing metadata in an HTML file
<b>must</b> start on the file's first line.