3. Header Setup
16 June 2025
Your header.md will traditionally serve as the navigation bar for the site. It should contain links to all the pages you'd like people to visit.
This is what this site's header looks like:
<zone>
<rss-title>Zonest</rss-title>
<rss-description>This is where I write about blogging with Zonest!</rss-description>
<rss-link>https://zonest.neocities.org/</rss-link>
</zone>
+ [Home](./index.html)
+ [Archive](./archive.html)
+ [About](./about.html)
+ [RSS](./feed.xml)
Zonest adds the .html at the end of links automatically, so you don't have to worry about them when writing a link. Any other file extensions, like .xml or an image, have to be explicit though.
Known Bug: - Zonest will not! add .html at the end of your links if the post filename contains a dot. For posts where you have a dot in the title, you have to put .html at the end of your links manually! I'm working on a fix for this in Zonest 1.1, but it's something to keep in mind!
A quick Markdown overview:
+is for writing unordered lists.- A link is written with the text inside of brackets and the url inside of parentheses following it
[Text](Link). -
- If you want to link to Zonest site files, use the syntax above, it always starts in the root directory; so linking to a post would be
./posts/date-post-name.
- If you want to link to Zonest site files, use the syntax above, it always starts in the root directory; so linking to a post would be
- You can use html inside of your Markdown files for specialized formatting!
The <zone> tag is where your metadata will exist for generating an RSS feed and for appending a Disqus to your posts.
The available tags are:
<rss-title>: Title of your feed. (Required for RSS)<rss-description>: Description of your entire blog. (To set a description for individual posts, use the<rss>tag at the beginning of your post! (Not here though. This is the<zone>zone -w-)) (Required for RSS)<rss-link>: The link to your site. (Required for RSS)<rss-language>: Defaults to 'en'.<rss-ttl>: Defaults to '1440'.<rss-desc-paragraphs>: If you don't specify a custom RSS description, Zonest will put however many paragraphs you specify here. Defaults to '1'.
If you wanna output the whole blog content so that people can read your posts straight from their RSS reader (Excellent for any Thunderbird users out there!), you can set this to '-1'.
If you don't want Zonest to autogenerate a description at all, set this to '0', and voilà! No more automatic descriptions for your posts! (unless you explicitly put them with the <rss> </rss> tags)
<disqus>: Put your Disqus-snippet in here. (Required for Disqus)
A <zone> is not necessary if you don't want an RSS or Disqus.