Metadata-Version: 1.1
Name: danube-delta
Version: 0.0.17
Summary: Honza Javorek's Pelican setup
Home-page: http://github.com/honzajavorek/danube-delta
Author: Honza Javorek
Author-email: mail@honzajavorek.cz
License: MIT
Description: 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
        
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
