Example sphinx configuration for rendering the symfony docs

conf.py

import sys, os

sys.path.insert(0, os.path.abspath('./sphinx-php'))
needs_sphinx = '1.0'

extensions = ['sphinx.ext.autodoc', 'sphinx.ext.doctest',
              'sphinx.ext.todo', 'sphinx.ext.coverage', 'sphinx.ext.ifconfig',
              'sphinx.ext.viewcode', 'sphinx.ext.extlinks', 'configurationblock']

templates_path = ['_templates']

# The suffix of source filenames.
source_suffix = '.rst'
master_doc = 'index'
project = u'Symfony2'
copyright = u'2011, The Symfony2 Documentation Team'

version = os.environ.get("SYMFONY_VERSION");
if not version:
    version = "master"
release = '2.0.0'

language = 'en'
exclude_patterns = []
intersphinx_mapping = {}

highlight_language = 'php'

api_url = 'http://api.symfony-reloaded.org/' + version + '/%s'

Makefile

# You can set these variables from the command line.
SPHINXOPTS    =
SPHINXBUILD   = sphinx-build -c .
PAPER         =
BUILDDIR      = build
SOURCE        = source