Metadata includes the title of the entry and the date it was published. Pelican supports a large number of metadata fields, some of which support searching and filtering when you are looking for specific information.
Required metadata: For each blog entry, make sure you provide the following metadata at the top of the file:
event
, general
, infra
, policy
, projects
, security
, service
, tools
. note: filtering is not enabled yet.These metadata fields are available, but are currently optional for the Infra blog:
draft
, hidden
, or published
Pelican supports these tags, which the Infra blog does not use:
The first line of the file should have this metadata, at a minimum:
layout: post title: THE ENTRY'S TITLE date: 2010-01-01 permalink: KEY WORDS FROM THE TITLE category CATEGORY
Note that the title does not need a period at its end.
For better readability as you are editing, you can lay out the metadata using multiple lines:
layout: post title: THE ENTRY'S TITLE date: 2010-01-01 permalink: KEY WORDS FROM THE TITLE category CATEGORY
To create an entry, create an .md file in this folder. The file's name should probably be like the permalink for the entry.
give the file a meaningful title that does not duplicate one we have used already.
Starting at the first line of the file, add metadata for the entry, as described above.
Write your entry using Markdown.
If you do not want to publish the blog post as soon as you commit it to the repository, set the metadata status: draft
. When you are ready to publish the post, change the status to published
or remove the status
metadata altogether. Then commit the file.
You can edit the entry at any time. Updating an older entry does not move it to the top of the blog's display.
The search feature is not currently enabled for the ASF blog. As soon as it available, information on preparing your blog post to be searchable will appear here.