A post file is the file which contains the actual text of your post.
Make sure the file post is in follows the following format:
<post-title>.md All post files MUST have the
*.mdfile extension. This is case-sensitive, and mandatory. Spaces are allowed in the name. Also, the actual name of the post file must be the same as the name of your post. For example: The title of this post is "Writing Posts for this Wiki". So, the name of this post's post file is: Writing Posts for this Wiki.md
Post files must be formatted in Markdown. HTML is allowed, except for the following tags:
Also, custom CSS is not allowed. Furthermore, the first line of the file must contain the title of the post, prepended with a hashtag (#). Like so:
# <post-title> The title of this post is "Writing Posts for this Wiki". So, the first line of this post's post file is: # Writing Posts for this Wiki Beyond this, feel free to format your Wiki post how you see fit.
All post files must be stored in posts/wiki
Every post must have a metadata file. If submitting your post on GitHub, you MUST have this file in your Pull Request, along with your post. If submitting it to another contributor, while strongly advised, it is not necessary to include a metadata file as one will be created for you.
All metadata files must have the same name as the post they belong to. Spaces are allowed. For example: The title of this post is "Writing Posts for this Wiki". So, the name of this post's metadata file is the same.
Metadata files support a very basic format. There are 4 mandatory fields, and 1 optional field. There is also support for a very basic comment syntax.
Every metadata file MUST have the following fields:
All fields are 1 line. The values for each tag are separated by a colon (:) and a single space.
Your synopsis should be a short (140 character max) description of what your post is about. Longer synopses tend to do better with Search Engine Optimization (SEO). So if that is important to you, keep it in mind.
This should be a comma-delimited (separated) list of tags that apply to your post. This list is case insensitive. More tags help users find your post easier. There is no limit to the number of tags you may have.
Put your name, or the author's name, in this field. If multiple people wrote this post, it should be a comma-delimited (separated) list.
When you wrote your post. If it took you several days to write it, then opt for the day you finished it. The required date format is YYYY - MM - DD. That is, the full 4 digit year, the 2 digit month, and the 2 digit day.
These fields are not necessary, but can provide more context to users.
This field works exactly like the AUTHOR field. However, it denotes who edited the post.
Comments start with a hashtag (#) and take up the entire line. For example:
# These are comments in a metadata file. It looks the same as the title line on markdown files # But, because they are in a metadata file, they have a different meaning.
# Metadata file for test wiki post # shell-script style comments are supported. But, only for entire lines # all keys and values MUST be seperated by a colon (:) and a SINGLE space. # SYNOPSIS: the text to show to the user as a synopsis of a post. If this is not set, the first sentence of the post will be used. SYNOPSIS: This is a test wiki post to ensure everything is showing up, working, and rendering correctly. # TAGS: comma-delimited list of tags that apply to this post TAGS: test # AUTHOR: comma-delimited list of authors of the post AUTHOR: Thomas Castleman # EDITOR: comma-delimited list of editors of this post. This entry is optional. EDITOR: Thomas Castleman # WRITTEN: when the post was written, must be in the format YYYY - MM - DD # e.g.: # June 28th, 2022 -> 2022 - 06 - 28 # October 19th, 1978 -> 1978 - 10 - 19 # January 9th, 2145 -> 2145 - 01 - 09 # December 2nd, 2010 -> 2010 - 12 - 02 WRITTEN: 2022 - 06 - 28
All metadata files must be stored in posts-meta/wiki.