A command-line tool for building documentation from repositories into HTML files. Initially based on https://github.com/juju/docs/blob/master/tools/mdbuild.py.
Project description
A tool for building a set of documentation files in HTML format, from a remote git repository containing markdown files.
Installation
pip3 install ubuntudesign.documentation-builder
Usage
The basic usage will build the markdown files from a remote repository in the standard format into the local directory:
$ documentation-builder # Build markdown documentation from the current directory
# or
$ documentation-builder --repository git@github.com:juju/docs.git # Build documentation from remote repository
Optional arguments:
$ documentation-builder \
--repository {repository-url} `# A source repository. If provided, all source paths will be relative to this repository root`
--branch {branch-name} `# Pull from an alternative branch to the default (only valid with --repository)`
--source-path {dirpath} `# Path to the folder containing markdown files (default: .)`
--source-media-dir {dirpath} `# Path to the folder containing media files (default: ./media)`
--source-context-file {filepath} `# A file containing the context object for building the templates (default: ./context.yaml)`
--output-path {dirpath} `# Destination path for the built HTML files (default: .)`
--output-media-dir {dirpath} `# Where to put media files (default: ./media)`
--template-path {filepath} `# Path to an alternate wrapping template for the built HTML files`
--media-url {prefix} `# Prefix for linking to media inside the built HTML files (default: Relative path to built media location, e.g.: ../media)`
--no-link-extensions `# Don't include '.html' extension in internal links`
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Close
Hashes for ubuntudesign.documentation-builder-0.3.5.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | af24aab4b1ced0712c88fdda6ec83635919c224580f1edbf1531a532dd8d4695 |
|
MD5 | 0a8f3db96146669f782950b17ef441ae |
|
BLAKE2b-256 | 2c9c892b525330bffebb58191693afa5aecb08a4a11018956f86eff880fb91b6 |