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.

While drafting a blog, it can be excluded from the listings by adding

listable: false

in the meta data block at the head of the post.

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)

Metadata info
-------------

Posted is when it was posted, and where it will appear in the time
line for the front page, and the side bar.  It's just a convention
that the file name happens to match the posted date, and should be
kept that way.

Side notes
----------

Use the following, replace `sn-demo` w/ unique id.

Non-breaking hyphen
-------------------

‑