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-builderUsage
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 repositoryOptional 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: ./build)`
--output-media-path {dirpath} `# Where to put media files (default: ./build/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`
--no-cleanup `# Don't clean up temporary directory after cloning repository`
--ignore-file `# Filename of a markdown files to ignore and not parse into HTML. Can be declared multiple times. (default: README.md)`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
File details
Details for the file ubuntudesign.documentation-builder-0.4.0.tar.gz.
File metadata
- Download URL: ubuntudesign.documentation-builder-0.4.0.tar.gz
- Upload date:
- Size: 19.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | c33025cf8c78d00c348295afa62184474b3418e6b99967d63de6bdddd9ddd121 |
|
| MD5 | de8cae2f6615ce1736cc71a5fedcfb52 |
|
| BLAKE2b-256 | 8cfc94a5228dc425ad51d3d09cbf11cf3ac43e49783a98f636cda084f314d725 |
