The link and date of each post are generated from the contents of the ﬁle and the date it was created. You can override this and other metadata as needed.
Setting your own metadata is optional. If you want to set your own metadata, you must do so at the very start of the ﬁle. For example, consider this post:
Date: September 20th, 2021 Link: introduction Metadata must be separated from the rest of the post by at least one blank line. You must leave a space after the colon between the metadata property (e.g. Date) and its value.
The publish date for a post is copied from the ﬁle’s creation date. You can set your own publish date using your folder or in the ﬁle’s metadata, like this:
Date: September 20th, 2021 Blot supports a variety of date formats. These all produce a post with the same date: 09/20/2021 September 20, 2021 9.20.2021 2021-09-20 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 of these ﬁles become posts with the same publish date and time:
Please note that a date speciﬁed inside a ﬁle overrides a date speciﬁed in its path.
If you specify a date in the future, your post will be scheduled for publication at that future date. You can verify the date of publication if you click on the ﬁle on your dashboard.
Use tags to connect posts by similar subject. Specify tags in the ﬁle’s metadata or in its path. Here’s an example 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.
|Title||Defaults to the text of the ﬁrst heading in the post or the ﬁle’s name.|
|Date||Defaults to the ﬁle’s creation date. Specify a different date in the ﬁle’s metadata with one of the supported formats. You can also change a post’s publish date using the ﬁle’s path.|
|Link||Defaults to a URL-friendly version of the post’s title. Specify a different link in the ﬁle’s metadata, or adjust the default link format.|
|Comments||Determines whether comments are enabled on the post or the page. Can be ’Yes’ or ’No’. Defaults to ’Yes’ for posts and ’No’ for pages. Has no effect if comments are disabled in the blog settings.|
|Summary||Defaults to the text of the ﬁrst sentence of the ﬁrst paragraph in the ﬁle.|
|Teaser||Defaults to the ﬁrst few paragraphs of the post. You can specify a teaser in the ﬁle’s metadata or insert the breakpoint |
|Tags||You can tag a post in the ﬁle’s metadata or using the ﬁle’s path.|
|Thumbnail||Defaults to the largest image in the post. You can specify a URL, or a path to an image in your blog’s folder.|
|Draft||Determines whether a ﬁle becomes a draft. Can be ’Yes’ or ’No’. Defaults to ’No’ unless the ﬁle is inside a folder called ’Drafts’.|
|Page||Determines whether a ﬁle becomes a page or a post. Can be ’Yes’ or ’No’. Defaults to ’No’ unless the ﬁle is inside a folder called ’Pages’.|
|Menu||Determines whether a ﬁle appears on your blog’s menu. Can be ’Yes’ or ’No’. Defaults to ’Yes’ for pages and ’No’ for posts.|
You can also deﬁne your own metadata for use in your template.
You can use a comment at the start of an HTML ﬁle to specify metadata.
<!-- Date: September 20th, 2021 Link: /metadata --> The comment containing metadata in an HTML file <b>must</b> start on the file's first line.
You can also use YAML front matter to declare the metadata for your post. For example:
--- Date: September 20th, 2021 Link: Apple --- Blot is able to extract the metadata from this post too.