We're sorry but this page doesn't work properly without JavaScript enabled. Please enable it to continue.
Feedback

ReadTheDocs for VIVO ontologies

Formale Metadaten

Titel
ReadTheDocs for VIVO ontologies
Serientitel
Anzahl der Teile
18
Autor
Mitwirkende
Lizenz
CC-Namensnennung 4.0 International:
Sie dürfen das Werk bzw. den Inhalt zu jedem legalen Zweck nutzen, verändern und in unveränderter oder veränderter Form vervielfältigen, verbreiten und öffentlich zugänglich machen, sofern Sie den Namen des Autors/Rechteinhabers in der von ihm festgelegten Weise nennen.
Identifikatoren
Herausgeber
Erscheinungsjahr
Sprache

Inhaltliche Metadaten

Fachgebiet
Genre
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.