I wrote about [my reasoning](http://www.juanpatten.com/first-post.html
Start your blog
- Fork unn-skeleton
- Clone your new repository to your computer (optionally, run
mkvirtualenv myblog
) - Run
pip install -r requirements.txt
- Edit config.py to set up your deployment settings (default is S3)
- Think of something good to write (this step is harder than the others)
Use it day-to-day
unn idea my-idea
to start a new draft. Use markdown for formatting.
unn publish my-idea
to converta draft to a post.
unn build
to build your site's pages.
unn local
to serve it locally.
unn deploy
to push it live. (this will build first, as a convenience)
Customize it
Check the _template
folder for the basic file structure. unn
uses Jinja2 for templating.
The index.html
template gets the following context:
{
"posts": [{
"Slug": "the-file-name-without-.md"
... all headers included in this post ...
}, ...]
}
The single.html
template gets the following context:
{
"post_html": "<p>The rendered HTML of the post</p>",
... all headers included in this post ...
}
base.html
defines the box that index.html
and single.html
live inside (ie. header/footer).
error.html
is a generic error display page.