Parakeet Blogs

To create a blog just start adding content under the blog directory, by default this is /blog. Each blog post should have its own directory.

A blog of two posts could look like:

src/content/blog/my-first-post/index.page
src/content/blog/a-trip-to-the-zoo/index.page

Within the post directory you can have subdirectories for images or other resources as normal.

Differences to normal pages

  • Output directory determined by publication date
  • Generation of index page with post summaries
  • Previous and next navigation links on each page
  • ATOM feed of all blog posts

Output location

When the site is generated the blog posts will be output to a directory based on their publication time, e.g.

output/(mode)/blog/2014/01/my-first-post/index.html
output/(mode)/blog/2015/07/a-trip-to-the-zoo/index.html

Until the first publication (i.e. use of the publish build mode) the dates part of the path will just be draft.

Referencing blogs

Blog posts can be referenced like any other content, e.g. <a href="/blog/my-first-post/index.page">, but you can also use the blog pseudo-protocol, e.g. <a href="blog:my-first-post">

Config

The follow entries apply to the main site config file.

[blog]
  # Directory for blog posts
  dir = /blog
  
  # Options for the post list
  [list]
    
    # Number of posts per list page
    # -1 is unlimited, i.e. all posts on one page
    per page = 10
    
    # Number of posts to show summary for
    # -1 is all posts
    summary = 10
  [/list]
[/blog]