Because "I just blogged about it" is too difficult to say
Blug currently requires no installation, though running
python setup.py install
will create 'install' the blug.py script. You can also get it from pip using
pip install blug.
config.yaml file with values appropriate for your site. They should be pretty self-explanatory.
Once done, place your posts in a directory called
content (this is the default location Blug checks for
posts). Each post follows the Octopress/Jekyll naming convention for posts: year-month-day-title-of-post-as-slug.
Once you've got everything set up, there are three components to the
Creating a New Post
content directory with the appropriate filename and yaml front matter.
Generating the Site
python blug.py generate This deletes and regenerates the current generated content. Run this whenever you
make a change to a post or after finishing a new one. The output in the
generated directory is the complete site.
Viewing Your Site Locally
python blug.py serve <port> <host> <path> This starts a webserver locally to allow you to preview your site. Use
generated as the
path argument to serve files using your generated site as the root.
A number of features have either been committed or are in the process of being committed
Live Mardown Post Editing- Start up the included webserver and navigate to host:port/create to create a new post with live Markdown translation. In the left pane you enter normal Markdown test. The right pane is updated with the translated HTML in real time. No more regenerating your entire site just to see if you remembered how to do a nested list in Markdown.
Git(hub)/Dropbox Integration- Automatically deploy new posts and changes to your blog on the back of commits to your local git repository, commit to Github, or Dropbox file uploads
The Blug Server- The real reason I created Blug. Stay tuned.