My Pelican Publishing Process

.
├── build
│   ├── .git (Back up repo)
│   ├── cache
│   ├── configs
│   │   ├── __init__.py
│   │   ├── deploy_settings.py
│   │   └── local_settings.py
│   │
│   └── content
│       ├── extras
│       ├── pages
│       └── [...]
├── deploy
│   ├── .git (user.io repo)
│   ├── [...]
│   └── theme
│       ├── css
│       ├── fonts
│       └── js
└── local
    ├── [...]
    └── theme
        ├── css
        ├── fonts
        └── js

import time

from fabric.api import local, settings, env, cd
import fabric.contrib.project as project
import os

# There must be at least a local_settings.py file in the configs directory.
import configs.local_settings as conf

# Local path configuration (can be absolute or relative to fabfile) - they are
# all added to env for convenience & abuse.

# Repo settings - from local_settings.py
env.git_url = conf.URL1
env.git_backup_url = conf.URL2
env.host_repo = conf.PUBLISH_REPO
env.build_repo = conf.BUILD_REPO
env.host_backup_repo = conf.PUBLISH_BACKUP_REPO

# Local file paths
env.config_path = './configs'
env.local_settings_file = 'local_settings.py'
env.deploy_settings_file = 'deploy_settings.py'
env.project_path = '../build'
env.deploy_path = '../deploy'
env.local_path = '../local'
env.content_path = './content'

def clean():
    """
    Cleans and recreates local copy directory
    """
    if os.path.isdir(DEPLOY_PATH):
        local('rm -rf {local_path}'.format(**env))
        local('mkdir {local_path}'.format(**env))

def kill():
    """
    Kills errant SimpleHTTPServer processes - always outputs an error but works nevertheless
    """
    with settings(warn_only=True):
        local('ps aux | grep SimpleHTTPServer | awk \'{print $2}\' | xargs kill -9')

def build():
    """
    Runs local build with debug output - pushes out content to local copy directory, using local settings
    """
    local('pelican -D {content_path} -o {local_path} -s {config_path}/{local_settings_file}'.format(**env))

def backup(commit_msg=False):
    """
    Backs up this local copy to bitbucket with an optional " delimited commit message.
    """
    with lcd(env.project_path):
        if commit_msg is False:
            command = 'git commit -S -m "Back up {0}"'
        else:
            command = 'git commit -S -m "Back up {0} - {1}"'

        local('git add -A .'.format(**env))
        local(command.format(
            time.strftime("%d %b %Y %H:%M:%S", time.localtime()), commit_msg, **env
            )
        )
        local('git push {git_backup_url}/{build_repo} master'.format(**env))

def rebuild():
    """
    Cleans and pushes content to local copy directory, running clean() and build()
    """
    clean()
    build()

def remove_drafts():
    """
    Removes drafts from deploy_path/drafts as we don't want publicly accessible
    """
    with lcd(env.deploy_path):
        local('rm -fr drafts'.format(**env))

def regenerate():
    """
    Regenerates site content
    """
    local('pelican -r -s {local_settings_file}'.format(**env))

def serve():
    """
    Serves content from local copy directory, calling clean() and build() beforehand
    """
    rebuild()
    with lcd(env.local_path):
        local('python -m SimpleHTTPServer'.format(**env))

def pub_deploy():
    """
    Prepares for publishing - runs non debug build to deployment path output
    """
    with lcd(env.deploy_path):
        local('rm -fr *'.format(**env));
    local('pelican {content_path} -o {deploy_path} -s {config_path}/{deploy_settings_file}'.format(**env))

def publish(commit_msg=False):
    """
    Makes a build over to the deploy path, using deployment settings, cleaning up beforehand with pub_deploy() with an optional " delimited commit message.
    """
    with lcd(env.deploy_path):
        if commit_msg is False:
            command = 'git commit -S -m "Publication {0}"'
        else:
            command = 'git commit -S -m "Publication {0} - {1}"'

    # Publish to deployment directory
    pub_deploy()
    # Remove draft htmls - don't want them in a public repo
    remove_drafts()
    # Git add and commit
    with lcd(env.deploy_path):
        local('git add -A .'.format(**env))
        local(command.format(
            time.strftime("%d %b %Y %H:%M:%S", time.localtime()), commit_msg, **env
            )
        )
        local('git push {git_url}/{host_repo} master'.format(**env))
        local('git push {git_backup_url}/{host_backup_repo} master'.format(**env))