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.

```
<label for="sn-demo" class="margin-toggle sidenote-number"></label>
<input type="checkbox" id="sn-demo" class="margin-toggle"/>
<span class="sidenote"></span>
```

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

&#x2011;