Skip to content

honzajavorek/danube-delta

Repository files navigation

Danube Delta

Honza Javorek's Pelican setup.

PyPI version Build Status

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:

Pelicans in the Danube Delta

Photo: © 2012 Honza Javorek