Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
My Sphinx Extensions
branch: master

bug #25 show "Best Practice" title only once (xabbuh)

This PR was merged into the 1.0-dev branch.


show "Best Practice" title only once


be2ce04 show "Best Practice" title only once
latest commit 52f7bd2216
Fabien Potencier authored

Sphinx Extensions for PHP and Symfony

You can install the extension by:

  • running sudo pip install git+;

  • cloning the project and add sensio to your path (with something like sys.path.insert(0, os.path.abspath('./path/to/sensio'))).

You can use the following extensions in your file:

  • sensio.sphinx.refinclude
  • sensio.sphinx.configurationblock
  • sensio.sphinx.phpcode
  • sensio.sphinx.bestpractice

To enable highlighting for PHP code not between <?php ... ?> by default:

# loading PhpLexer
from sphinx.highlighting import lexers
from pygments.lexers.web import PhpLexer

# enable highlighting for PHP code not between ``<?php ... ?>`` by default
lexers['php'] = PhpLexer(startinline=True)
lexers['php-annotations'] = PhpLexer(startinline=True)

And here is how to use PHP as the primary domain:

primary_domain = 'php'

Configure the api_url for links to the API:

api_url = ''
Something went wrong with that request. Please try again.