ontodoc 0.0.0

Generate easily your markdown documentation for any ontology

ontodoc

A python module to generate markdown documentation for ontologies.

Based on rdflib and jinja2.

Getting Started 🚀

Installation

pip install ontodoc

Command line usage

python -m ontodoc

By default, the file named ontology.ttl will be used to generate your documentation in the build destination folder.

You can easily change settings as you need. Available arguments :

Argument name	Default	Description
-i, --input INPUT	ontology.ttl	Input ontology file
-o, --output OUTPUT	build/	Output directory for the generated documentation
-t, --templates TEMPLATES	templates/	Custom templates folder
-f, --footer, --no-footer	true	Add footer for each page
-c, --concatenate, --no-concatenate	false	Concatenate documentation into an unique file
-s, --schema, --no-schema	true	Display schemas
-m, --model MODEL	markdown	Model type for the documentation. markdown, gh_wiki

Automatically generate your documentation

You can explore github actions to automatically generate and publish your documentation.

Example 👀

Look at the example for foaf to see what type of documentation you can easily build in 2 lines!

How does it work ? 🔧

flowchart LR
 subgraph s1["Ontodoc"]
        n5["Markdown human readable documentation"]
        n8["Markdown templates"]
        n4["Structured ontology description"]
        n9["Command Line Interface"]
  end
    n4 --> n5
    n8 --> n5
    n7(("Ontology")) --> n9
    n9 --> n4
    n9 -.-> n8

    n4@{ shape: braces}
    n9@{ shape: text}

Contributing </>

Feel free to contribute to this open source project!

We need help to implement new features, fix bugs listed in issues.

If you have any idea, create your own issue.

License 🔓

Apache License 2.0

They already have integrated Ontodoc ♥️

Comming soon...