Danube Delta

Honza Javorek's Pelican setup.

Installation

$ pip install danube-delta

Warning: The library is only for Python 3.

Setup

1. Create basic scaffolding of your Pelican blog:

   $ mkdir ./my-awesome-blog
   $ cd ./my-awesome-blog
   $ git init
   $ mkdir ./content ./output
   $ echo '/output' > .gitignore

2. Create ./settings.py:

   from danube_delta.settings import *
   
   AUTHOR = 'Zuzka & Honza'
   SITENAME = 'Pražení'
   
   if PRODUCTION:
       SITEURL = 'http://example.com'

3. Install danube_delta, globally:

   $ sudo -H pip install danube_delta

4. In the root of your blog directory you can now use the blog CLI:

   $ blog write

Usage

$ blog update   # Gets other people's changes from GitHub
$ blog write    # Starts a new article
$ blog photos   # Adds images to the last article
$ blog preview  # Opens local preview of your blog website
$ blog publish  # Saves changes and sends them to GitHub
$ blog lint     # Looks for errors in source code of your blog
$ blog deploy   # Uploads new version of the blog website

Travis CI can do blog deploy for you every time you perform blog publish:

language: "python"
python:
    - "3.5"
cache: "pip"
script:
    - "blog lint"
env:
  global:
    - secure: "..."  # gem install travis && travis encrypt GITHUB_TOKEN=...
deploy:
    provider: "script"
    script: "blog deploy"
    on:
        branch: "master"
        repo: "honzajavorek/my-awesome-blog"
sudo: false

Head to the user guide for more information on how to use a blog based on Danube Delta.

Developing Danube Delta

1. Clone Danube Delta to a directory of your choice, e.g. ~/danube-delta.
2. Install Danube Delta from your local clone: pip install -e ~/danube-delta.

Name

In 2012 I've seen some pelicans in the Danube Delta:

Photo: © 2012 Honza Javorek