Metadata-Version: 2.0
Name: danube-delta
Version: 0.0.13
Summary: Honza Javorek's Pelican setup
Home-page: http://github.com/honzajavorek/danube-delta
Author: Honza Javorek
Author-email: mail@honzajavorek.cz
License: MIT
Keywords: pelican blog
Platform: UNKNOWN
Classifier: Environment :: Console
Classifier: Operating System :: OS Independent
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Requires-Dist: click
Requires-Dist: colorama
Requires-Dist: flake8
Requires-Dist: ghp-import
Requires-Dist: lxml
Requires-Dist: markdown
Requires-Dist: pelican
Requires-Dist: pillow
Requires-Dist: python-slugify
Requires-Dist: requests
Requires-Dist: sh

Danube Delta
============

`Honza Javorek <https://github.com/honzajavorek/>`__'s `Pelican <http://www.getpelican.com/>`__ setup.

.. image:: https://travis-ci.org/honzajavorek/danube-delta.svg?branch=master
    :target: https://travis-ci.org/honzajavorek/danube-delta


Installation
------------

.. code:: shell

    $ pip install danube-delta


**Warning:** The library is only for Python 3.


Setup
-----

#.  Create basic scaffolding of your `Pelican <http://www.getpelican.com/>`__ blog:

    .. code:: shell

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


#.  Create ``./settings.py``:

    .. code:: python

        from danube_delta.settings import *

        AUTHOR = 'Zuzka & Honza'
        SITENAME = 'Pražení'

        if PRODUCTION:
            SITEURL = 'http://example.com'


#.  Install ``danube_delta``, globally:

    .. code:: shell

        $ sudo -H pip install danube_delta


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

    .. code:: shell

        $ blog write


Usage
-----

.. code:: shell

    $ 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 <https://docs.travis-ci.com/user/deployment/>`__ can do ``blog deploy`` for you every time you perform ``blog publish``:

.. code:: yaml

    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


Developing Danube Delta
-----------------------

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


Name
----

In 2012 I've seen some `pelicans <https://en.wikipedia.org/wiki/Pelican>`__ in the `Danube Delta <https://en.wikipedia.org/wiki/Danube_Delta>`__:

.. figure:: danube-delta.jpg
   :alt: Pelicans in the Danube Delta

   Photo: © 2012 Honza Javorek


