blog/BLOG.md

How to blog

To start a post, copy the file template.html to content/<year>/<month>/name-of-post.html. Make sure that if the year is new, that meta.yaml from another year is copied to make the post visible and set a few other default parameters.

If a code block is in a list item like:

1. This is a list item with source:

source

Do not use the above, but instead, use:

1. This is a list item with source:
   <pre class="fullwidth"><code>
   source
   </code></pre>

If you want a code block w/ line numbers, it can only be done at the parent level via:

  ``` { .shell .showlines }
  some lines

If you want to check twitter cards, use the url: https://cards-dev.twitter.com/validator

The following additional meta data maybe added:
twittertitle: Use this instead of title
image: URL of an image to show along with the post
imagealt: Alt text for the image

[twitter card reference](https://developer.twitter.com/en/docs/twitter-for-websites/cards/overview/markup)