ReadTheDocs for VIVO ontologies

Video in TIB AV-Portal: ReadTheDocs for VIVO ontologies

Formal Metadata

Title
ReadTheDocs for VIVO ontologies
Title of Series
Author
Contributors
License
CC Attribution 4.0 International:
You are free to use, adapt and copy, distribute and transmit the work or content in adapted or unchanged form for any legal purpose as long as the work is attributed to the author in the manner specified by the author or licensor.
Identifiers
Publisher
Release Date
2021
Language
English

Content Metadata

Subject Area
Abstract
ReadTheDocs (RTD) is a system of creating documentation that is common in the python community. RTD uses RestructuredText as a mark-up language and Sphinx as a processor. Each component is open source, readily available, and well-documented. In creating the Organization Ontology, a small python script was created to generate pages for each term in the ontology, as well as tables of terms for inclusion in hand-written pages. Hand-written pages contain overviews, figures, and tables. This hybrid approach has several advantages over the current VIVO documentation method: 1) All documentation text is version-controlled in GitHub; 2) A simple mark-up language (ReStructuredText) makes writing good-looking documentation straightforward; 3) Documentation is searchable and indexed; 4) Documentation always agrees with the ontology; 5) style is completely separated from content. In this talk, we will describe the general setup of an RTD environment, the python script used to create pages, and the resulting documentation for an ontology. The python script is distributed with the Organization Ontology.
Feedback