Skip to main content

Collect and parse all your divio-style documentation with just one line of code!

Project description

Divio Docs Parser

Collect and parse all your divio-style documentation with just one line of code! This script will scan any files/directories/strings you pass. For example:

  • If you have a how-to section in your README, that'll get extracted and put in the right spot
  • Or, if you have an how-to.md file, it'll get added in its entirety!

How-To

Install from pip

python3 -m pip install divio_docs_parser

Clone & run scripts locally

git clone https://github.com/Denperidge-Redpencil/divio-docs-parser.git
cd divio-docs-gen/
python3 -m src.divio_docs_parser

Run tests

git clone https://github.com/Denperidge-Redpencil/divio-docs-parser.git
cd divio-docs-gen/
python3 -m unittest

Build & install package locally

git clone https://github.com/Denperidge-Redpencil/divio-docs-parser.git
cd divio-docs-gen/
python3 -m pip install --upgrade build setuptools  # If no setuptools dist can be found, try using a higher python version
python3 -m build && python3 -m pip install --force-reinstall ./dist/*.whl

Note: other Python versions can be used!

Explanation

The Divio structure is built upon splitting your documentation into 4 types of documentations. The overview of the divio documentation on their website. In this repository they're referred to as sections.

If you want to know more about the design principles of this project, feel free to check out my writeup here!

Reference

Synonyms

For ease of use and freedom of implementation, every section has synonyms.

Section Synonyms
Tutorials Getting started
How-to Guides How-To, Guide, Usage
Explanation Discussion, background material
Reference Technical

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

divio_docs_parser-0.1.2.tar.gz (12.5 kB view hashes)

Uploaded Source

Built Distribution

divio_docs_parser-0.1.2-py3-none-any.whl (15.5 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page