sphinx-contrib / actdiag /

Filename Size Date modified Message
37 B
1.4 KB
65 B
2.1 KB
83 B
1.5 KB
868 B
actdiag extension README
This is a sphinx extension which render block diagrams by using
`actdiag <http://bitbucket.org/tk0miya/actdiag/>`_ .


.. actdiag::

   diagram {
     A -> B -> C -> D;

     lane {
       A; B;
     lane {
       C; D;


.. code-block:: text

   .. actdiag::

      diagram {
        A -> B -> C -> D;

        lane {
          A; B;
        lane {
          C; D;

.. You can see available package at `PyPI <http://pypi.python.org/pypi/sphinxcontrib-actdiag>`_.

You can get archive file at http://bitbucket.org/birkenfeld/sphinx-contrib/

Required components
* `actdiag <http://bitbucket.org/tk0miya/actdiag>`_ .


.. code-block:: bash

   > easy_install sphinxcontrib-actdiag

Configure Sphinx
To enable this extension, add ``sphinxcontrib.actdiag`` module to extensions 
option at :file:`conf.py`. 

.. code-block:: python

   import os, sys

   # Path to the folder where actdiag.py is
   # NOTE: not needed if the package is installed in traditional way
   # using setup.py or easy_install

   # Enabled extensions
   extensions = ['sphinxcontrib.actdiag']


.. describe:: .. actdiag:: [filename]

   This directive insert a block diagram into the generated document.
   If filename is specified, sphinx reads external file as source script of blockfile.
   In another case, actdiag directive takes code block as source script.


      .. actdiag:: foobar.diag

      .. actdiag::

         diagram {
            // some diagrams are here.

Configuration File Options

.. confval:: actdiag_fontpath

   This is a path for renderring fonts. You can use truetype font (.ttf) file path.

.. confval:: actdiag_antialias

   If :confval:`actdiag_antialias: is True, actdiag generates images
   with anti-alias filter.

This code is hosted by Bitbucket.

Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.