ovis-hpc / readthedocs

This is the repository that backs the OVIS-HPC documentation on readthedocs.io
GNU General Public License v3.0
0 stars 4 forks source link

OVIS-HPC Documentation ########################

This repository hosts all Ovis/LDMS related documentation such as how-to tutorials, getting started with LDMS, docker-hub links, LDMS API and much more. Documentation webpage can be found here: ovis-hpc/readthedocs <https://ovis-hpc.readthedocs.io/en/latest/>_

Contributing to ReadTheDocs ############################ Instructions and documentation on how to use ReadTheDocs can be found here: readthedocs Help Guide <https://sublime-and-sphinx-guide.readthedocs.io/en/latest/images.html>_

.. code-block:: RST

git clone git@github.com:/ovis-docs.git

.. code-block:: RST

vi paper.lock <add Name | Date | File(s)>

| mm/dd |

.. code-block:: RST

vi paper.lock <add Name | Date | File(s)>

remove line

git add git commit -m "add message" git push

Adding A New File


For any new RST files created, please include them in docs/src/index.rst under their corresponding sections. All RST files not included in index.rst will not populate on the offical webpage (e.g. readthedocs).

Documentation Generation For Man Pages


Rst files for man pages are generated using the pandoc_man_2_rst.py python file. It requires python3 and pandoc installations. It points at an installation (defined by OVIS_ROOT variable in the file, currently at /opt/ovis/build/ovis) and grabs .man files. There are source/dest arrays that define where to pull data from in OVIS_ROOT and where to put it in the readthedocs dir. Pandoc single file usage:

.. code-block:: RST

/usr/local/bin/pandoc -f man -s -t rst --toc {input.man} -o {output.rst}

IF YOU WANT TO CHANGE THE CONTENTS OF A GENERATED RST FILE, CHANGE THE MAN PAGE INSTEAD AND THEN REGENERATE.

Paper Lock


This is for claiming any sections you are working on so there is no overlap. Please USE paper.lock to indicate if you are editing an existing RST file.