generate documentation from docstrings using Sphinx/epydoc about easybuild-framework HOT 4 CLOSED

Eventjes uit mijn bash-history gereconstrueerd:

Mappenconstructie:

easybuild:
 |-- easybuild
 |   |-- build.py
 |   |-- apps
 |   \-- ...
 \-- doc
     |-- conf.py
     |-- Makefile
     \-- index.rst

(Ik weet niet of die laatste 3 in de repo zitten, zie bijlage).

Ik heb een scriptje vanop https://bitbucket.org/etienned/sphinx-autopackage-script gebruikt, maar blijkbaar zit dat tegenwoordig ingebouwd

    sphinx-autopackage-script/generate_modules.py -d doc easybuild -s rst
    cd doc
    PYTHONPATH=.. make html

Hopende u hiermee voldoende geïnformeerd te hebben.

Met vriendelijke groeten,
Pieter De Baets

index.rst

.. EasyBuild documentation master file, created by
   sphinx-quickstart on Tue Aug 30 16:34:10 2011.
   You can adapt this file completely to your liking, but it should at least
   contain the root `toctree` directive.

Welcome to EasyBuild's documentation!
=====================================

Contents:

.. toctree::
  :maxdepth: 4

  easybuild

Indices and tables
==================

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`