mkinx

Manage sphinx documentations with mkdocs

Project description

About

mkinx allows you to integrate several sphinx documentation projects into one Home Documentation listing them and allowing you to have cross projects documentation with mkdocs.

Any sphinx module can be used as long as make html works and the built code is in your_project/build.

Install

pip install mkinx

Getting Started

Start you Home Documentation with

mkinx init your_project

Start the server with

mkinx serve

Optionnaly you can specify a port with mkinx serve -s your_port

Build the documentation with

mkinx build [FLAGS]

Flags being:

-v, --verbose                             verbose flag (Sphinx will stay verbose)
-A, --all                                 Build doc for all projects
-F, --force                               force the build, no verification asked
-o, --only_index                          only build projects listed in the Documentation's Home
-p, --projects [PROJECTS [PROJECTS ...]]  list of projects to build

Usage

The package comes with a thorough documentation by default, which you’ll see by running mkinx serve after a proper init. A Read The Docs-hosted version may arrive at some point.

The built in documentation is there to help you but is in no way necessary, you can overwrite or delete everything. There are however 2 mandatory things:

You have to keep this structure:

your_home_documentation/
    mkdocs.yml
    docs/
        index.md # mandatory file -> mkdocs's index
    site/
    your_project_1/
        build/ # sphinx's build directory
        source/ # sphinx's documentation source directory
        your_package_1_1/
        your_package_1_2/
        ...
    your_project_2/
        build/
        source/
        your_package_2_1/
        your_package_2_2/
        ...
    ...

mkdocs’s index.md file must have a # Projects section listing them as in the example

Also, remember to run commands from your Home Documenation’s root folder (in your_home_documentation/ in the example above) otherwise you may get errors saying mkinx can’t find a file.

Project details

Release history Release notifications | RSS feed

0.3.1.2

Jul 17, 2018

0.3.1

Jul 17, 2018

0.3

Jul 16, 2018

0.2.0.1

Jul 5, 2018

0.2.0

Jul 5, 2018

0.1.8

Jul 3, 2018

0.1.7.2

Mar 20, 2018

0.1.7.1

Mar 20, 2018

0.1.7

Mar 20, 2018

0.1.6.3

Mar 20, 2018

0.1.6.2

Mar 20, 2018

0.1.6.0.6

Mar 20, 2018

0.1.6.0.5

Mar 20, 2018

0.1.6.0.4

Mar 20, 2018

0.1.6.0.3

Mar 20, 2018

0.1.6.0.2

Mar 20, 2018

0.1.6.0.1

Mar 20, 2018

0.1.6

Feb 27, 2018

0.1.5.2

Feb 27, 2018

0.1.5

Feb 27, 2018

0.1.4.2

Feb 22, 2018

This version

0.1.4

Feb 22, 2018

0.1.3

Feb 22, 2018

0.1.1

Feb 22, 2018

Download files

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

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

mkinx-0.1.4-py3-none-any.whl (28.2 kB view details)

Uploaded Feb 22, 2018 Python 3

File details

Details for the file mkinx-0.1.4-py3-none-any.whl.

File metadata

Download URL: mkinx-0.1.4-py3-none-any.whl
Upload date: Feb 22, 2018
Size: 28.2 kB
Tags: Python 3
Uploaded using Trusted Publishing? No

File hashes

Hashes for mkinx-0.1.4-py3-none-any.whl
Algorithm	Hash digest
SHA256	`284fa562e34b0c47054ee2a4ce038562daa0404655cc81cbda27009ca57e9108`
MD5	`7befa7eb4353e6cbc50030774716668a`
BLAKE2b-256	`7de95d5161e1207d5999190ce57628cb545d50a7d2e1938e31872f3a0f8c2857`