Project timeline planner plugin for sphinx

This plugin creates a project timeline out of a Sphinx document consisting of several sections of project tasks. It computes the requested time for this project and defined milestones or deadlines. This allows the user to stay on top of the development tasks, and it requires far less maintenance than other project management tools -- once it is set up :).

Installation

1. Clone this repository in a local directory with

   git clone [email protected]:mdrohmann/sphinxplugin-project-timeline.git

2. Install the plugin (This should install all dependencies in your python installation automatically)

   python setup.py install

Configuration

1. Create a new directory, say 'myprojectdir'.

2. Change into this directory and run

   sphinx-quickstart

   and answer all the questions. You can select the defaults if you are unsure.

3. Make one change in the generated file conf.py: Change the line

   extensions = []

   to

   extensions = [
     'sphinxcontrib.blockdiag',
     'sphinxplugin.projecttimeline',
   ]

Usage

4. Overwrite the index.rst file with my template for the project timeline.

   cp /path/to/plugin_repository/tests/docs/complete/index.rst .

5. Create the website with

   make html

   and open it in your webbrowser

   firefox _build/html/index.html

Now you can edit the index.rst and add your own tasks and update the document as you work on them to give you a feel for the timeline of your project. To update, the website you have to re-do step 5 and update your browser.

Tip

If you do not want to remake the website manually, you can add a watchdog script, that watches the files in your project directory for changes and automatically re-builds the website.