My Sphinx Extensions
Python
Latest commit f1b69df Jul 18, 2016 @fabpot minor #34 Removed importing of unused symbol (sstok)
This PR was merged into the 1.0-dev branch.

Discussion
----------

Removed importing of unused symbol

I'm getting the following error with Python 3.5:
`Could not import extension sensio.sphinx.bestpractice (exception: cannot import name 'upper')`

It seems this package/symbol was removed in Python 3.5 or something, but this symbol is actually not used at all in this file.

Commits
-------

7d1af7c Removed importing of unused symbol

README.md

Sphinx Extensions for PHP and Symfony

You can install the extension by:

  • running sudo pip install git+https://github.com/fabpot/sphinx-php.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 conf.py 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 = 'http://api.symfony.com/master/%s'