* #11 moved to adoc from md * #11 fabfile to publish docs to gh-pages * #11 sidebar menu docs added
76 lines
No EOL
2.1 KiB
Python
76 lines
No EOL
2.1 KiB
Python
from fabric.api import *
|
|
import fabric.contrib.project as project
|
|
import os
|
|
import shutil
|
|
import sys
|
|
import SocketServer
|
|
|
|
from pelican.server import ComplexHTTPRequestHandler
|
|
|
|
# Local path configuration (can be absolute or relative to fabfile)
|
|
env.deploy_path = 'output'
|
|
DEPLOY_PATH = env.deploy_path
|
|
|
|
# Remote server configuration
|
|
production = 'root@localhost:22'
|
|
dest_path = '/var/www'
|
|
|
|
# Rackspace Cloud Files configuration settings
|
|
env.cloudfiles_username = 'my_rackspace_username'
|
|
env.cloudfiles_api_key = 'my_rackspace_api_key'
|
|
env.cloudfiles_container = 'my_cloudfiles_container'
|
|
|
|
# Github Pages configuration
|
|
env.github_pages_branch = "gh-pages"
|
|
|
|
# Port for `serve`
|
|
PORT = 8000
|
|
|
|
def clean():
|
|
"""Remove generated files"""
|
|
if os.path.isdir(DEPLOY_PATH):
|
|
shutil.rmtree(DEPLOY_PATH)
|
|
os.makedirs(DEPLOY_PATH)
|
|
|
|
def build():
|
|
"""Build local version of site"""
|
|
local('asciidoctor -D {deploy_path} *.adoc'.format(**env))
|
|
local('cp *.png {deploy_path}'.format(**env))
|
|
local('mv {deploy_path}/README.html {deploy_path}/index.html'.format(**env))
|
|
|
|
def rebuild():
|
|
"""`clean` then `build`"""
|
|
clean()
|
|
build()
|
|
|
|
def serve():
|
|
"""Serve site at http://localhost:8000/"""
|
|
os.chdir(env.deploy_path)
|
|
|
|
class AddressReuseTCPServer(SocketServer.TCPServer):
|
|
allow_reuse_address = True
|
|
|
|
server = AddressReuseTCPServer(('', PORT), ComplexHTTPRequestHandler)
|
|
|
|
sys.stderr.write('Serving on port {0} ...\n'.format(PORT))
|
|
server.serve_forever()
|
|
|
|
def reserve():
|
|
"""`build`, then `serve`"""
|
|
build()
|
|
serve()
|
|
|
|
def cf_upload():
|
|
"""Publish to Rackspace Cloud Files"""
|
|
rebuild()
|
|
with lcd(DEPLOY_PATH):
|
|
local('swift -v -A https://auth.api.rackspacecloud.com/v1.0 '
|
|
'-U {cloudfiles_username} '
|
|
'-K {cloudfiles_api_key} '
|
|
'upload -c {cloudfiles_container} .'.format(**env))
|
|
|
|
def gh_pages():
|
|
"""Publish to GitHub Pages"""
|
|
rebuild()
|
|
local("ghp-import -b {github_pages_branch} {deploy_path}".format(**env))
|
|
local("git push origin {github_pages_branch}".format(**env)) |