Commits

Doug Hellmann committed 36be4ab

remove other projects and rearrange repository

  • Participants
  • Parent commits 95a277d

Comments (0)

Files changed (555)

AUTHORS

-This file lists all extensions in this package and their authors.
-
-aafig:
-   Leandro Lucarella <llucax@gmail.com>
-
-autorun:
-   Vadim Gubergrits <vadim.gubergrits@gmail.com>
-
-context:
-   Wei-Wei Guo <wwguocn@gmail.com>
-
-feed:
-   Dan MacKinlay <sphinx@email.possumpalace.org>
-
-gnuplot:
-   Vadim Gubergrits <vadim.gubergrits@gmail.com>
-
-httpdomain:
-   Hong Minhee <minhee@dahlia.kr>
-
-lilypond:
-   Wei-Wei Guo <wwguocn@gmail.com>
-
-mscgen:
-   Leandro Lucarella <llucax@gmail.com>
-
-paverutils:
-   Doug Hellmann <doug.hellmann@gmail.com>
-
-rubydomain:
-   SHIBUKAWA Yoshiki <yoshiki@shibu.jp>
-
-sword:
-   Wei-Wei Guo <wwguocn@gmail.com>
-
-sdedit:
-   SHIBUKAWA Yoshiki <yoshiki@shibu.jp>
-
-traclinks:
-   Kevin Horn <kevin.horn@gmail.com>
-
-zopeext:
-   Michael McNeil Forbes <mforbes@alum.mit.edu>
-
-googleanalytics:
-   Domen Kožar <domen@dev.si>
-
-doxylink
-   Matt Williams <matt@milliams.com>
-
-ansi:
-   Sebastian Wiesner <lunaryorn@googlemail.com>
-
-cheeseshop:
-   Richard Jones <r1chardj0n3s@gmail.com>
-   Georg Brandl <georg@python.org>
-
-plantuml:
-   Yuya Nishihara <yuya@tcha.org>
-
-spelling:
-   Doug Hellmann <doug.hellmann@gmail.com>
-
-sadisplay:
-   Evgeniy Tatarkin <tatarkin.evg@gmail.com>
-
-blockdiag:
-   Takeshi KOMIYA <i.tkomiya@gmail.com>
-
-seqdiag:
-   Takeshi KOMIYA <i.tkomiya@gmail.com>
-
-actdiag:
-   Takeshi KOMIYA <i.tkomiya@gmail.com>
-
-nwdiag:
-   Takeshi KOMIYA <i.tkomiya@gmail.com>
-
-googlechart:
-   Takeshi KOMIYA <i.tkomiya@gmail.com>
-
-nicovideo:
-   Takeshi KOMIYA <i.tkomiya@gmail.com>
-
-requirements:
-   Andrey Mikhaylenko <neithere@gmail.com>
-
-hyphenator:
-   Björn Müller <diehose@freenet.de>
-
-youtube:
-   Chris Pickel <sfiera@gmail.com>
-
-clearquest:
-   Robin Jarry <robin.jarry@gmail.com>
-
-sqltable:
-   Doug Hellmann <doug.hellmann@gmail.com>
-
-rawfiles:
-   Takumi IINO <trot.thunder@gmail.com>
-If not otherwise noted, the extensions in this package are licensed
-under the following license.
-
-Copyright (c) 2009 by the contributors (see AUTHORS file).
+Copyright (c) 2010 by Doug Hellmann.
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without
+include README
+include LICENSE
+include CHANGES.*
-.. -*- restructuredtext -*-
+########################
+sphinxcontrib.bitbucket
+########################
 
-=========================
-README for sphinx-contrib
-=========================
+This module adds custom roles for linking to resources on BitBucket
+projects.
 
-This repository contains a collection of Sphinx_ extensions maintained by
-their respective authors.  It is not an official part of Sphinx.
+Basic Usage
+===========
 
-.. _Sphinx: http://bitbucket.org/birkenfeld/sphinx
+To use this extension, add it to the ``extensions`` list in your
+Sphinx configuration file and set the variable
+``bitbucket_project_url`` to the base URL for the project.  
 
+For example::
 
-Installing
-==========
+    extensions = [ 'sphinxcontrib.bitbucket' ]
 
-Use ``setup.py`` in the subdirectory for the individual extension::
+    bitbucket_project_url = 'http://bitbucket.org/birkenfeld/sphinx-contrib'
 
-   cd dir
-   python setup.py build
-   sudo python setup.py install
+Then in your rst documents, use the roles ``bbissue`` and
+``bbchangeset`` to create links to tickets and changesets.
 
+This::
 
-Contributing
-============
+    :bbissue:`3`
 
-If you want to add your own extension, please write an e-mail to
-georg@python.org and give your bitbucket user name; you will then
-get write access to the public repo at
-http://bitbucket.org/birkenfeld/sphinx-contrib.
+is equivalent to::
 
-Send wishes, comments, patches, etc. for individual extensions
-to their author as given in the module.
+    `issue 3 <http://bitbucket.org/birkenfeld/sphinx-contrib/issue/3/>`__
 
+and::
 
-List of extensions
-==================
-.. Note that this will be viewed using the bitbucket web interface ..
-.. which does not support the full sphinx markup like. ..
+    :bbchangeset:`some-long-hash-value`
 
-- aafig: render embeded ASCII art as nice images using aafigure_.
-- actdiag: embed activity diagrams by using actdiag_
-- adadomain: an extension for Ada support (Sphinx 1.0 needed)
-- ansi: parse ANSI color sequences inside documents
-- autorun: Execute code in a runblock directive.
-- blockdiag: embed block diagrams by using blockdiag_
-- cheeseshop: easily link to PyPI packages
-- coffeedomain: a domain for (auto)documenting CoffeeScript source code.
-- context: a builder for ConTeXt.
-- doxylink: Link to external Doxygen-generated HTML documentation
-- erlangdomain: an extension for Erlang support (Sphinx 1.0 needed)
-- exceltable: embed Excel spreadsheets into documents using exceltable_
-- feed: an extension for creating syndication feeds and time-based overviews
-  from your site content
-- gnuplot: produces images using gnuplot_ language.
-- googleanalytics: track html visitors statistics
-- googlechart: embed charts by using Google Chart_
-- httpdomain: a domain for documenting RESTful HTTP APIs.
-- hyphenator: client-side hyphenation of HTML using hyphenator_
-- lilypond: an extension inserting music scripts from Lilypond_ in PNG format.
-- mscgen: embed mscgen-formatted MSC (Message Sequence Chart)s.
-- nicoviceo: embed videos from nicovideo
-- nwdiag: embed network diagrams by using nwdiag_
-- omegat: support tools to collaborate with OmegaT_ (Sphinx 1.1 needed)
-- osaka: convert standard Japanese doc to Osaka dialect (it is joke extension)
-- paverutils: an alternate integration of Sphinx with Paver_.
-- plantuml: embed UML diagram by using PlantUML_
-- rawfiles: copy raw files, like a CNAME.
-- requirements: declare requirements wherever you need (e.g. in test
-  docstrings), mark statuses and collect them in a single list
-- rubydomain: an extension for Ruby support (Sphinx 1.0 needed)
-- sadisplay: display SqlAlchemy model sadisplay_
-- sdedit: an extension inserting sequence diagram by using Quick Sequence.
-  Diagram Editor (sdedit_)
-- seqdiag: embed sequence diagrams by using seqdiag_
-- spelling: Spelling checker using PyEnchant_
-- sword: an extension inserting Bible verses from Sword_.
-- traclinks: create TracLinks_ to a Trac_ instance from within Sphinx
-- youtube: embed videos from YouTube_
-- zopeext: provide an ``autointerface`` directive for using Zope interfaces.
-- clearquest: create tables from ClearQuest_ queries.
+is equivalent to::
 
-.. _aafigure: https://launchpad.net/aafigure
+    `changeset some-long-hash-value <http://bitbucket.org/birkenfeld/sphinx-contrib/changeset/some-long-hash-value/>`__
 
-.. _gnuplot: http://www.gnuplot.info/
+Configuration Parameters
+========================
 
-.. _paver: http://www.blueskyonmars.com/projects/paver/
+bitbucket_project_url
+  The base URL for the project on BitBucket.org.
 
-.. _Sword: http://www.crosswire.org/sword/
 
-.. _Lilypond: http://lilypond.org/web/
+History
+=======
 
-.. _sdedit: http://sdedit.sourceforge.net/
+1.0
+---
 
-.. _Trac: http://trac.edgewall.org
-
-.. _TracLinks: http://trac.edgewall.org/wiki/TracLinks
-
-.. _OmegaT: http://www.omegat.org/
-
-.. _PlantUML: http://plantuml.sourceforge.net/
-
-.. _PyEnchant: http://www.rfk.id.au/software/pyenchant/
-
-.. _sadisplay: http://bitbucket.org/estin/sadisplay/wiki/Home
-
-.. _blockdiag: http://blockdiag.com/
-
-.. _seqdiag: http://blockdiag.com/
-
-.. _actdiag: http://blockdiag.com/
-
-.. _nwdiag: http://blockdiag.com/
-
-.. _Google Chart: http://code.google.com/intl/ja/apis/chart/
-
-.. _hyphenator: http://code.google.com/p/hyphenator/
-
-.. _exceltable: http://packages.python.org/sphinxcontrib-exceltable/
-
-.. _YouTube: http://www.youtube.com/
-
-.. _ClearQuest: http://www-01.ibm.com/software/awdtools/clearquest/
-
-For contributors
-================
-
-When adding or updating your extension, please adhere to these guidelines:
-
-* Use ``make-ext.py`` to set up your extension subdirectory.
-* Each extension must be either a submodule or subpackage of the
-  ``sphinxcontrib`` package.  The ``sphinxcontrib/__init__.py`` file in your
-  package must not be changed.
-* Each extension must be listed in this file under "List of extensions" above.
-* Each author should be listed in ``AUTHORS`` along with the extension name.
-* It would be good to have all extensions BSD licensed; otherwise make a note in
-  an ``ext/LICENSE`` file.
-* Each extension can maintain a changelog and readme file; these files should
-  be called ``ext/CHANGES`` and ``ext/README``, respectively.
-
+First public release.

_template/MANIFEST.in

-include README
-include LICENSE
-include CHANGES.*

_template/README

Empty file removed.

_template/setup.cfg

-[egg_info]
-tag_build = dev
-tag_date = true
-
-[aliases]
-release = egg_info -RDb ''

_template/setup.py

-# -*- coding: utf-8 -*-
-
-from setuptools import setup, find_packages
-
-long_desc = '''
-This package contains the ${name} Sphinx extension.
-
-.. add description here ..
-'''
-
-requires = ['Sphinx>=0.6']
-
-setup(
-    name='sphinxcontrib-${name}',
-    version='0.1',
-    url='http://bitbucket.org/birkenfeld/sphinx-contrib',
-    download_url='http://pypi.python.org/pypi/sphinxcontrib-${name}',
-    license='BSD',
-    author='${author}',
-    author_email='${author_email}',
-    description='Sphinx "${name}" extension',
-    long_description=long_desc,
-    zip_safe=False,
-    classifiers=[
-        'Development Status :: 4 - Beta',
-        'Environment :: Console',
-        'Environment :: Web Environment',
-        'Intended Audience :: Developers',
-        'License :: OSI Approved :: BSD License',
-        'Operating System :: OS Independent',
-        'Programming Language :: Python',
-        'Topic :: Documentation',
-        'Topic :: Utilities',
-    ],
-    platforms='any',
-    packages=find_packages(),
-    include_package_data=True,
-    install_requires=requires,
-    namespace_packages=['sphinxcontrib'],
-)

_template/sphinxcontrib/__init__.py

-# -*- coding: utf-8 -*-
-"""
-    sphinxcontrib
-    ~~~~~~~~~~~~~
-
-    This package is a namespace package that contains all extensions
-    distributed in the ``sphinx-contrib`` distribution.
-
-    :copyright: Copyright 2007-2009 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-
-__import__('pkg_resources').declare_namespace(__name__)
-

_template/tox.ini

-## configuration for tox <http://codespeak.net/tox/>
-
-## tox automates running certain tasks within virtualenvs.  The following
-## tox configuration outlines a basic setup for running unit tests and
-## building sphinx docs in separate virtual environments.  Give it a try!
-
-[tox]
-envlist=python,doc
-
-# test running
-[testenv:python]
-deps=
-    ## if you use nose for test running
-    # nose
-    ## if you use py.test for test running
-    # pytest
-commands=
-    ## run tests with py.test
-    # py.test []
-    ## run tests with nose
-    # nose
-
-[testenv:doc]
-deps=
-    sphinx
-    # add all Sphinx extensions and other dependencies required to build your docs
-commands=
-    ## test links
-    # sphinx-build -W -b linkcheck -d {envtmpdir}/doctrees doc {envtmpdir}/linkcheck
-    ## test html output
-    # sphinx-build -W -b html -d {envtmpdir}/doctrees doc {envtmpdir}/html
-

aafig/CHANGES

-.. -*- restructuredtext -*-
-
-This file describes user-visible changes between the extension versions.
-
-
-Version 1.0 (2009-11-15)
-------------------------
-
-* Fix HTML builder rendering.
-* Improve error reporting when aafigure package is missing.
-
-
-Version 0.3 (2009-07-13)
-------------------------
-
-* Add website__.
-* Change license to BOLA__.
-* Add partial format redefinition via the config option ``aafig_format``.
-* Add support for the text builder (using the ``None`` format).
-* Add a special format ``None`` meaning not to render the figure using aafigure
-  at all (just include the raw ASCII art as a literal block).
-* Fix SVG support for HTML builders.
-* Make aspect and scale options take a percentage instead of a float (this is
-  more consistent with the image directive).
-* Add support for image directive options: alt, align, width, height, class,
-  target.
-* Add dependency against aafigure package to ease installation.
-* Improve error handling in many ways. For example, if the format is not
-  supported, or if aafigure is not installed, the raw ASCII art is inserted
-  into the document as a literal block.
-* Fix a couple of bugs.
-
-__ http://packages.python.org/sphinxcontrib-aafig/
-__ http://blitiri.com.ar/p/bola/
-
-
-Version 0.2 (2009-06-07)
-------------------------
-
-* Add ``aafig_default_options`` configuration option.
-* Fix SVG output for HTML writer (this need aafigure r5978 or later).
-
-
-Version 0.1 (2009-06-05)
-------------------------
-
-* Initial version.
-

aafig/LICENSE

-I don't like licenses, because I don't like having to worry about all this
-legal stuff just for a simple piece of software I don't really mind anyone
-using. But I also believe that it's important that people share and give back;
-so I'm placing this work under the following license.
-
-
-BOLA - Buena Onda License Agreement (v1.0)
-------------------------------------------
-
-This work is provided 'as-is', without any express or implied warranty. In no
-event will the authors be held liable for any damages arising from the use of
-this work.
-
-To all effects and purposes, this work is to be considered Public Domain.
-
-
-However, if you want to be "buena onda", you should:
-
-1. Not take credit for it, and give proper recognition to the authors.
-2. Share your modifications, so everybody benefits from them.
-3. Do something nice for the authors.
-4. Help someone who needs it.
-5. Don't waste. Anything, but specially energy that comes from natural
-   non-renewable resources.
-6. Be tolerant. Everything that's good in nature comes from cooperation.

aafig/MANIFEST.in

-include README
-include LICENSE
-include CHANGES

aafig/README

-.. -*- restructuredtext -*-
-
-=============================
-aafigure extension for Sphinx
-=============================
-
-:author: Leandro Lucarella <llucax@gmail.com>
-
-
-About
-=====
-
-This extension allows embedded ASCII art to be rendered as nice looking images
-using aafigure_.
-
-aafigure_ is a program and a reStructuredText_ directive to allow embedded
-ASCII art figures to be rendered as nice images in various image formats. The
-aafigure_ directive needs a *hardcoded* image format, so it doesn't goes well
-with Sphinx_ multi-format support.
-
-This extension adds the ``aafig`` directive that automatically selects the
-image format to use acording to the Sphinx_ writer used to generate the
-documentation.
-
-You can see the latest documentation at the `sphinxcontrib-aafig website`__
-or `download it in PDF format`__.
-
-__ http://packages.python.org/sphinxcontrib-aafig/
-__ http://packages.python.org/sphinxcontrib-aafig/sphinxcontrib-aafig.pdf
-
-
-Quick Example
--------------
-
-This source::
-
-    .. aafig::
-        :aspect: 60
-        :scale: 150
-        :proportional:
-        :textual:
-
-        +-------+         +-----------+
-        | Hello +-------->+ aafigure! |
-        +-------+         +-----------+
-
-is rendered as:
-
-.. aafig::
-    :aspect: 60
-    :scale: 150
-    :proportional:
-    :textual:
-
-    +-------+         +-----------+
-    | Hello +-------->+ aafigure! |
-    +-------+         +-----------+
-
-
-Download
-========
-
-You can see all the `available versions`__ at PyPI_.
-
-__ http://pypi.python.org/pypi/sphinxcontrib-aafig
-
-
-Requirements
-------------
-
-* aafigure_ (0.3 or later).
-* reportlab_ (for LaTeX/PDF output)
-* PIL_ (for any image format other than SVG or PDF)
-
-aafigure_ should be installed in the system for this extension to work.
-Alternatively you can download it to any folder and add that folder to the
-Python's path through the Sphinx_ ``conf.py`` file, for example::
-
-    import sys, os
-
-    sys.path.extend(os.path.abspath('path/to/aafigure')])
-
-
-From source (tar.gz or checkout)
---------------------------------
-
-Unpack the archive, enter the sphinxcontrib-aafig-x.y directory and run::
-
-    python setup.py install
-
-
-Setuptools/PyPI_
-----------------
-
-Alternatively it can be installed from PyPI_, either manually downloading the
-files and installing as described above or using:
-
-easy_install -U sphinxcontrib-aafig
-
-
-Enabling the extension in Sphinx_
----------------------------------
-
-Just add ``sphinxcontrib.aafig`` to the list of extensions in the ``conf.py``
-file. For example::
-
-    extensions = ['sphinxcontrib.aafig']
-
-
-Usage
-=====
-
-You can always use the original reStructuredText_ aafigure_ extension, but
-choosing a hardcoded format can be a bad idea when using Sphinx, because PDF
-might not be suitable for HTML and PNG can look ugly in a PDF document.
-
-This extension uses the same aafigure_ code to add a more *Sphinxy* directive
-called ``aafig``. This directive accepts the same options as the original
-aafigure_ directive (please, see aafigure_ documentation for more information).
-There are some differences though:
-
-* The ``:format:`` option is not available, the format is selected
-  automatically depending on the Sphinx_ builder you are using.
-* ``:scale:`` and ``:aspect:`` options are specified using percentages
-  (without the *%* sign), to match the reStructuredText_ image directive.
-
-For an example on using the ``aafig`` directive see the `Quick Example`_.
-
-
-Configuration
--------------
-
-A few configuration options are added (all optional, of course ;) to Sphinx_
-so you can set them in the ``conf.py`` file:
-
-``aafig_format`` <dict>:
-   image format used for the different builders. All ``latex``, ``html`` and
-   ``text`` builder are supported, and it should be trivial to add support for
-   other builders if they correctly handle images (and if aafigure_ can render
-   an image format suitable for that builder) by just adding the correct format
-   mapping here.
-
-   A special format ``None`` is supported, which means not to use aafigure_ to
-   render the image, just show the raw ASCII art as is in the resulting
-   document (using a literal block). This is almost only useful for the text
-   builder.
-
-   You can specify the format - builder mapping using a dict. For example::
-
-      aafig_format = dict(latex='pdf', html='svg', text=None)
-
-   These are the actual defaults.
-
-``aafig_default_options`` <dict>:
-    default aafigure_ options. These options are used by default unless they
-    are overridden explicitly in the ``aafig`` directive. The default aafigure_
-    options are used if this is not specified. You can provide partial
-    defaults, for example::
-
-        aafig_default_options = dict(scale=1.5, aspect=0.5, proportional=True)
-
-    Note that in this case the ``aspec`` and ``scale`` options are specified
-    as floats, as originally done by aafigure_. See aafigure_ documentation
-    for a complete list of options and their defaults.
-
-
-TODO
-====
-
-* Add color validation for ``fill``, ``background`` and ``foreground`` options.
-* Add ``aa`` role for easily embed small images (like arrows).
-
-
-.. Links:
-.. _aafigure: http://launchpad.net/aafigure
-.. _reStructuredText: http://docutils.sourceforge.net/rst.html
-.. _Sphinx: http://sphinx.pocoo.org/
-.. _reportlab: http://www.reportlab.org/
-.. _PIL: http://www.pythonware.com/products/pil/
-.. _PyPI: http://pypi.python.org/pypi
-

aafig/README.MAINTAINER

-
-========================
-Maintainer documentation
-========================
-
-This document contains notes for developers and packagers. End users probably
-want to read ``README`` and the files in the ``doc`` directory instead.
-
-
-PyPi Release
-============
-
-1. Make sure the repository is up-to date.
-2. Ensure the version is incremented:
-   - ``setup.py``  must be updated
-   - ``doc/config.py``  must be updated
-   - ``CHANGES.txt``  must contain a summary of the changes
-3. Make sure all changes are committed, including the version number changes.
-4. Tag the sources with ``hg tag -m 'Tag aafig-X.Y' aafig-X.Y``.
-5. Don't forget to ``hg push``.
-6. Temporarily modify the ``setup.cfg`` file to comment out the variables
-   ``tag_build = dev`` and ``tag_date = true`` (do **not** commit this
-   changes).
-7. Register and upload the new release ``python setup.py register sdist
-   upload``.
-8. Generate the documentation with ``make -C doc zip``.
-9. Upload the new documentation (``doc/_build/sphinxcontrib-aafig-doc.zip``) to
-   PyPi: http://pypi.python.org/pypi?%3Aaction=pkg_edit&name=sphinxcontrib-aafig
-
-.. vim: set filetype=rst :

aafig/doc/Makefile

-# Makefile for Sphinx documentation
-#
-
-# You can set these variables from the command line.
-SPHINXOPTS    =
-SPHINXBUILD   = sphinx-build
-PAPER         =
-
-# Internal variables.
-PAPEROPT_a4     = -D latex_paper_size=a4
-PAPEROPT_letter = -D latex_paper_size=letter
-ALLSPHINXOPTS   = -d _build/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
-
-.PHONY: all zip help clean html dirhtml pickle json htmlhelp qthelp \
-	latex latex-pdf changes linkcheck doctest
-
-all: html latex-pdf
-
-zip: all
-	@cp _build/latex/sphinxcontrib-aafig.pdf _build/html/
-	@cd _build/html && zip -r -9 ../sphinxcontrib-aafig-doc.zip *
-
-help:
-	@echo "Please use \`make <target>' where <target> is one of"
-	@echo "  html      to make standalone HTML files"
-	@echo "  dirhtml   to make HTML files named index.html in directories"
-	@echo "  pickle    to make pickle files"
-	@echo "  json      to make JSON files"
-	@echo "  htmlhelp  to make HTML files and a HTML help project"
-	@echo "  qthelp    to make HTML files and a qthelp project"
-	@echo "  latex     to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
-	@echo "  changes   to make an overview of all changed/added/deprecated items"
-	@echo "  linkcheck to check all external links for integrity"
-	@echo "  doctest   to run all doctests embedded in the documentation (if enabled)"
-
-clean:
-	-rm -rf _build/*
-
-html:
-	$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) _build/html
-	@echo
-	@echo "Build finished. The HTML pages are in _build/html."
-
-dirhtml:
-	$(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) _build/dirhtml
-	@echo
-	@echo "Build finished. The HTML pages are in _build/dirhtml."
-
-pickle:
-	$(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) _build/pickle
-	@echo
-	@echo "Build finished; now you can process the pickle files."
-
-json:
-	$(SPHINXBUILD) -b json $(ALLSPHINXOPTS) _build/json
-	@echo
-	@echo "Build finished; now you can process the JSON files."
-
-htmlhelp:
-	$(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) _build/htmlhelp
-	@echo
-	@echo "Build finished; now you can run HTML Help Workshop with the" \
-	      ".hhp project file in _build/htmlhelp."
-
-qthelp:
-	$(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) _build/qthelp
-	@echo
-	@echo "Build finished; now you can run "qcollectiongenerator" with the" \
-	      ".qhcp project file in _build/qthelp, like this:"
-	@echo "# qcollectiongenerator _build/qthelp/sphinxcontrib-aafig.qhcp"
-	@echo "To view the help file:"
-	@echo "# assistant -collectionFile _build/qthelp/sphinxcontrib-aafig.qhc"
-
-latex:
-	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) _build/latex
-	@echo
-	@echo "Build finished; the LaTeX files are in _build/latex."
-	@echo "Run \`make all-pdf' or \`make all-ps' in that directory to" \
-	      "run these through (pdf)latex."
-
-latex-pdf: latex
-	$(MAKE) -C _build/latex all-pdf
-
-changes:
-	$(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) _build/changes
-	@echo
-	@echo "The overview file is in _build/changes."
-
-linkcheck:
-	$(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) _build/linkcheck
-	@echo
-	@echo "Link check complete; look for any errors in the above output " \
-	      "or in _build/linkcheck/output.txt."
-
-doctest:
-	$(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) _build/doctest
-	@echo "Testing of doctests in the sources finished, look at the " \
-	      "results in _build/doctest/output.txt."

aafig/doc/_static/.placeholder

-just a placeholder

aafig/doc/_templates/.placeholder

-just a placeholder

aafig/doc/conf.py

-# -*- coding: utf-8 -*-
-#
-# sphinxcontrib-aafig documentation build configuration file, created by
-# sphinx-quickstart on Thu Jul  2 22:51:25 2009.
-#
-# This file is execfile()d with the current directory set to its containing dir.
-#
-# Note that not all possible configuration values are present in this
-# autogenerated file.
-#
-# All configuration values have a default; values that are commented out
-# serve to show the default.
-
-import sys, os
-
-# If extensions (or modules to document with autodoc) are in another directory,
-# add these directories to sys.path here. If the directory is relative to the
-# documentation root, use os.path.abspath to make it absolute, like shown here.
-sys.path.append(os.path.abspath('..'))
-
-# -- General configuration -----------------------------------------------------
-
-# Add any Sphinx extension module names here, as strings. They can be extensions
-# coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
-extensions = ['sphinxcontrib.aafig']
-
-# Add any paths that contain templates here, relative to this directory.
-templates_path = ['_templates']
-
-# The suffix of source filenames.
-source_suffix = '.rst'
-
-# The encoding of source files.
-#source_encoding = 'utf-8'
-
-# The master toctree document.
-master_doc = 'index'
-
-# General information about the project.
-project = u'sphinxcontrib-aafig'
-copyright = u'2009, Leandro Lucarella'
-
-# The version info for the project you're documenting, acts as replacement for
-# |version| and |release|, also used in various other places throughout the
-# built documents.
-#
-# The short X.Y version.
-version = '1.0'
-# The full version, including alpha/beta/rc tags.
-release = version
-
-# The language for content autogenerated by Sphinx. Refer to documentation
-# for a list of supported languages.
-#language = None
-
-# There are two options for replacing |today|: either, you set today to some
-# non-false value, then it is used:
-#today = ''
-# Else, today_fmt is used as the format for a strftime call.
-#today_fmt = '%B %d, %Y'
-
-# List of documents that shouldn't be included in the build.
-#unused_docs = []
-
-# List of directories, relative to source directory, that shouldn't be searched
-# for source files.
-exclude_trees = []
-
-# The reST default role (used for this markup: `text`) to use for all documents.
-#default_role = None
-
-# If true, '()' will be appended to :func: etc. cross-reference text.
-#add_function_parentheses = True
-
-# If true, the current module name will be prepended to all description
-# unit titles (such as .. function::).
-#add_module_names = True
-
-# If true, sectionauthor and moduleauthor directives will be shown in the
-# output. They are ignored by default.
-#show_authors = False
-
-# The name of the Pygments (syntax highlighting) style to use.
-pygments_style = 'sphinx'
-
-# A list of ignored prefixes for module index sorting.
-#modindex_common_prefix = []
-
-
-# -- Options for HTML output ---------------------------------------------------
-
-# The theme to use for HTML and HTML Help pages.  Major themes that come with
-# Sphinx are currently 'default' and 'sphinxdoc'.
-html_theme = 'default'
-
-# Theme options are theme-specific and customize the look and feel of a theme
-# further.  For a list of options available for each theme, see the
-# documentation.
-#html_theme_options = {}
-
-# Add any paths that contain custom themes here, relative to this directory.
-#html_theme_path = []
-
-# The name for this set of Sphinx documents.  If None, it defaults to
-# "<project> v<release> documentation".
-#html_title = None
-
-# A shorter title for the navigation bar.  Default is the same as html_title.
-#html_short_title = None
-
-# The name of an image file (relative to this directory) to place at the top
-# of the sidebar.
-#html_logo = None
-
-# The name of an image file (within the static path) to use as favicon of the
-# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
-# pixels large.
-#html_favicon = None
-
-# Add any paths that contain custom static files (such as style sheets) here,
-# relative to this directory. They are copied after the builtin static files,
-# so a file named "default.css" will overwrite the builtin "default.css".
-html_static_path = ['_static']
-
-# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
-# using the given strftime format.
-#html_last_updated_fmt = '%b %d, %Y'
-
-# If true, SmartyPants will be used to convert quotes and dashes to
-# typographically correct entities.
-#html_use_smartypants = True
-
-# Custom sidebar templates, maps document names to template names.
-#html_sidebars = {}
-
-# Additional templates that should be rendered to pages, maps page names to
-# template names.
-#html_additional_pages = {}
-
-# If false, no module index is generated.
-#html_use_modindex = True
-
-# If false, no index is generated.
-#html_use_index = True
-
-# If true, the index is split into individual pages for each letter.
-#html_split_index = False
-
-# If true, links to the reST sources are added to the pages.
-#html_show_sourcelink = True
-
-# If true, an OpenSearch description file will be output, and all pages will
-# contain a <link> tag referring to it.  The value of this option must be the
-# base URL from which the finished HTML is served.
-#html_use_opensearch = ''
-
-# If nonempty, this is the file name suffix for HTML files (e.g. ".xhtml").
-#html_file_suffix = ''
-
-# Output file base name for HTML help builder.
-htmlhelp_basename = 'sphinxcontrib-aafigdoc'
-
-
-# -- Options for LaTeX output --------------------------------------------------
-
-# The paper size ('letter' or 'a4').
-#latex_paper_size = 'letter'
-
-# The font size ('10pt', '11pt' or '12pt').
-#latex_font_size = '10pt'
-
-# Grouping the document tree into LaTeX files. List of tuples
-# (source start file, target name, title, author, documentclass [howto/manual]).
-latex_documents = [
-  ('index', 'sphinxcontrib-aafig.tex', u'sphinxcontrib-aafig Documentation',
-   u'Leandro Lucarella', 'howto'),
-]
-
-# The name of an image file (relative to this directory) to place at the top of
-# the title page.
-#latex_logo = None
-
-# For "manual" documents, if this is true, then toplevel headings are parts,
-# not chapters.
-#latex_use_parts = False
-
-# Additional stuff for the LaTeX preamble.
-#latex_preamble = ''
-
-# Documents to append as an appendix to all manuals.
-#latex_appendices = []
-
-# If false, no module index is generated.
-#latex_use_modindex = True

aafig/doc/index.rst

-.. This is the main documentation to use as a simple website.
-
-.. include:: ../README
-
-
-ChangeLog
-=========
-
-.. include:: ../CHANGES
-
-
-License
-=======
-
-.. include:: ../LICENSE
-    :literal:
-

aafig/setup.cfg

-[egg_info]
-tag_build = dev
-tag_date = true
-
-[aliases]
-release = egg_info -RDb ''

aafig/setup.py

-# -*- coding: utf-8 -*-
-
-from setuptools import setup, find_packages
-
-long_desc = '''
-This package contains the aafigure_ Sphinx_ extension.
-
-.. _aafigure: https://launchpad.net/aafigure
-.. _Sphinx: http://sphinx.pocoo.org/
-
-aafigure_ is a program and a reStructuredText_ directive to allow embeded ASCII
-art figures to be rendered as nice images in various image formats. The
-aafigure_ directive needs a *hardcoded* image format, so it doesn't goes well
-with Sphinx_ multi-format support.
-
-.. _reStructuredText: http://docutils.sourceforge.net/rst.html
-
-This extension adds the ``aafig`` directive that automatically selects the
-image format to use acording to the Sphinx_ writer used to generate the
-documentation.
-
-Usage example::
-
-    .. aafig::
-        :aspect: 60
-        :scale: 150
-        :proportional:
-        :textual:
-
-        +-------+         +-----------+
-        | Hello +-------->+ aafigure! |
-        +-------+         +-----------+
-
-'''
-
-requires = ['Sphinx>=0.6', 'aafigure>=0.3']
-
-setup(
-    name='sphinxcontrib-aafig',
-    version='1.0',
-    url='http://packages.python.org/sphinxcontrib-aafig/',
-    download_url='http://pypi.python.org/pypi/sphinxcontrib-aafig',
-    license='BOLA',
-    author='Leandro Lucarella',
-    author_email='llucax@gmail.com',
-    description='aafig Sphinx extension',
-    long_description=long_desc,
-    zip_safe=False,
-    classifiers=[
-        'Development Status :: 5 - Production/Stable',
-        'Environment :: Console',
-        'Environment :: Web Environment',
-        'Intended Audience :: Developers',
-        'License :: Public Domain',
-        'Operating System :: OS Independent',
-        'Programming Language :: Python',
-        'Topic :: Documentation',
-        'Topic :: Utilities',
-    ],
-    platforms='any',
-    packages=find_packages(),
-    include_package_data=True,
-    install_requires=requires,
-    namespace_packages=['sphinxcontrib'],
-)

aafig/sphinxcontrib/__init__.py

-# -*- coding: utf-8 -*-
-"""
-    sphinxcontrib
-    ~~~~~~~~~~~~~
-
-    This package is a namespace package that contains all extensions
-    distributed in the ``sphinx-contrib`` distribution.
-
-    :copyright: Copyright 2007-2009 by the Sphinx team, see AUTHORS.
-    :license: BSD, see LICENSE for details.
-"""
-
-__import__('pkg_resources').declare_namespace(__name__)
-

aafig/sphinxcontrib/aafig.py

-# -*- coding: utf-8 -*-
-"""
-    sphinxcontrib.aafig
-    ~~~~~~~~~~~~~~~~~~~
-
-    Allow embeded ASCII art to be rendered as nice looking images
-    using the aafigure reStructuredText extension.
-
-    See the README file for details.
-
-    :author: Leandro Lucarella <llucax@gmail.com>
-    :license: BOLA, see LICENSE for details
-"""
-
-import posixpath
-from os import path
-try:
-    from hashlib import sha1 as sha
-except ImportError:
-    from sha import sha
-
-from docutils import nodes
-from docutils.parsers.rst import directives
-
-from sphinx.errors import SphinxError
-from sphinx.util import ensuredir, relative_uri
-from sphinx.util.compat import Directive
-
-try:
-    import aafigure
-except ImportError:
-    aafigure = None
-
-
-DEFAULT_FORMATS = dict(html='svg', latex='pdf', text=None)
-
-
-def merge_dict(dst, src):
-    for (k, v) in src.items():
-        if k not in dst:
-            dst[k] = v
-    return dst
-
-
-def get_basename(text, options, prefix='aafig'):
-    options = options.copy()
-    if 'format' in options:
-        del options['format']
-    hashkey = text.encode('utf-8') + str(options)
-    id = sha(hashkey).hexdigest()
-    return '%s-%s' % (prefix, id)
-
-
-class AafigError(SphinxError):
-    category = 'aafig error'
-
-
-class AafigDirective(directives.images.Image):
-    """
-    Directive to insert an ASCII art figure to be rendered by aafigure.
-    """
-    has_content = True
-    required_arguments = 0
-    own_option_spec = dict(
-        line_width   = float,
-        background   = str,
-        foreground   = str,
-        fill         = str,
-        aspect       = directives.nonnegative_int,
-        textual      = directives.flag,
-        proportional = directives.flag,
-    )
-    option_spec = directives.images.Image.option_spec.copy()
-    option_spec.update(own_option_spec)
-
-    def run(self):
-        aafig_options = dict()
-        image_attrs = dict()
-        own_options_keys = self.own_option_spec.keys() + ['scale']
-        for (k, v) in self.options.items():
-            if k in own_options_keys:
-                # convert flags to booleans
-                if v is None:
-                    v = True
-                # convert percentage to float
-                if k == 'scale' or k == 'aspect':
-                    v = float(v) / 100.0
-                aafig_options[k] = v
-                del self.options[k]
-        self.arguments = ['']
-        (image_node,) = directives.images.Image.run(self)
-        if isinstance(image_node, nodes.system_message):
-            return [image_node]
-        text = '\n'.join(self.content)
-	image_node.aafig = dict(options = aafig_options, text = text)
-        return [image_node]
-
-
-def render_aafig_images(app, doctree):
-    format_map = app.builder.config.aafig_format
-    merge_dict(format_map, DEFAULT_FORMATS)
-    if aafigure is None:
-        app.builder.warn('aafigure module not installed, ASCII art images '
-                'will be redered as literal text')
-    for img in doctree.traverse(nodes.image):
-        if not hasattr(img, 'aafig'):
-            continue
-        if aafigure is None:
-            img.replace_self(nodes.literal_block(text, text))
-            continue
-        options = img.aafig['options']
-        text = img.aafig['text']
-        format = app.builder.format
-        merge_dict(options, app.builder.config.aafig_default_options)
-        if format in format_map:
-            options['format'] = format_map[format]
-        else:
-            app.builder.warn('unsupported builder format "%s", please '
-                    'add a custom entry in aafig_format config option '
-                    'for this builder' % format)
-            img.replace_self(nodes.literal_block(text, text))
-            continue
-        if options['format'] is None:
-            img.replace_self(nodes.literal_block(text, text))
-            continue
-        try:
-            fname, outfn, id, extra = render_aafigure(app, text, options)
-        except AafigError, exc:
-            app.builder.warn('aafigure error: ' + str(exc))
-            img.replace_self(nodes.literal_block(text, text))
-            continue
-        img['uri'] = fname
-        # FIXME: find some way to avoid this hack in aafigure
-        if extra:
-            (width, height) = [x.split('"')[1] for x in extra.split()]
-            if not img.has_key('width'):
-                img['width'] = width
-            if not img.has_key('height'):
-                img['height'] = height
-
-
-def render_aafigure(app, text, options):
-    """
-    Render an ASCII art figure into the requested format output file.
-    """
-
-    if aafigure is None:
-        raise AafigError('aafigure module not installed')
-
-    fname = get_basename(text, options)
-    fname = '%s.%s' % (get_basename(text, options), options['format'])
-    if app.builder.format == 'html':
-        # HTML
-        imgpath = relative_uri(app.builder.env.docname, '_images')
-        relfn = posixpath.join(imgpath, fname)
-        outfn = path.join(app.builder.outdir, '_images', fname)
-    else:
-        # Non-HTML
-        if app.builder.format != 'latex':
-            app.builder.warn('aafig: the builder format %s is not officially '
-                    'supported, aafigure images could not work. Please report '
-                    'problems and working builder to avoid this warning in '
-                    'the future' % app.builder.format)
-        relfn = fname
-        outfn = path.join(app.builder.outdir, fname)
-    metadata_fname = '%s.aafig' % outfn
-
-    try:
-        if path.isfile(outfn):
-            extra = None
-            if options['format'].lower() == 'svg':
-                f = None
-                try:
-                    try:
-                        f = file(metadata_fname, 'r')
-                        extra = f.read()
-                    except:
-                        raise AafigError()
-                finally:
-                    if f is not None:
-                        f.close()
-            return relfn, outfn, id, extra
-    except AafigError:
-        pass
-
-    ensuredir(path.dirname(outfn))
-
-    try:
-        (visitor, output) = aafigure.render(text, outfn, options)
-	output.close()
-    except aafigure.UnsupportedFormatError, e:
-        raise AafigError(str(e))
-
-    extra = None
-    if options['format'].lower() == 'svg':
-        extra = visitor.get_size_attrs()
-        f = file(metadata_fname, 'w')
-        f.write(extra)
-        f.close()
-
-    return relfn, outfn, id, extra
-
-
-def setup(app):
-    app.add_directive('aafig', AafigDirective)
-    app.connect('doctree-read', render_aafig_images)
-    app.add_config_value('aafig_format', DEFAULT_FORMATS, 'html')
-    app.add_config_value('aafig_default_options', dict(), 'html')
-
-
-# vim: set expandtab shiftwidth=4 softtabstop=4 :

actdiag/AUTHORS

-Takeshi KOMIYA <i.tkomiya@gmail.com>

actdiag/LICENSE

-If not otherwise noted, the extensions in this package are licensed
-under the following license.
-
-Copyright (c) 2009 by the contributors (see AUTHORS file).
-All rights reserved.
-
-Redistribution and use in source and binary forms, with or without
-modification, are permitted provided that the following conditions are
-met:
-
-* Redistributions of source code must retain the above copyright
-  notice, this list of conditions and the following disclaimer.
-
-* Redistributions in binary form must reproduce the above copyright
-  notice, this list of conditions and the following disclaimer in the
-  documentation and/or other materials provided with the distribution.
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
-"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
-LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
-A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
-OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
-SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
-LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
-DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
-THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
-OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

actdiag/MANIFEST.in

-include AUTHORS
-include LICENSE
-include README
-include CHANGES.*

actdiag/README

-actdiag extension README
-========================
-This is a sphinx extension which render block diagrams by using
-`actdiag <http://bitbucket.org/tk0miya/actdiag/>`_ .
-
-rendered:
-
-.. actdiag::
-
-   diagram {
-     A -> B -> C -> D;
-
-     lane {
-       A; B;
-     }
-     lane {
-       C; D;
-     }
-   }
-
-source:
-
-.. code-block:: text
-
-   .. actdiag::
-
-      diagram {
-        A -> B -> C -> D;
-
-        lane {
-          A; B;
-        }
-        lane {
-          C; D;
-        }
-      }
-
-Setting
-=======
-.. 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>`_ .
-
-Install
--------
-
-.. 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
-   sys.path.append(os.path.abspath('/path/to/sphinxcontrib.actdiag'))
-
-   # Enabled extensions
-   extensions = ['sphinxcontrib.actdiag']
-
-
-Directive
-=========
-
-.. 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.