Register a parser class using new Sphinx API; add_source_suffix

This commit is contained in:
Takeshi KOMIYA 2018-07-28 18:07:15 +09:00
parent 956bf18b24
commit 029c649065
2 changed files with 12 additions and 1 deletions

View file

@ -24,6 +24,10 @@ pip install recommonmark
Then add this to your Sphinx conf.py:
```
# for Sphinx-1.4 or newer
extensions = ['recommonmark']
# for Sphinx-1.3
from recommonmark.parser import CommonMarkParser
source_parsers = {

View file

@ -5,6 +5,13 @@ __version__ = '0.4.0'
def setup(app):
"""Initialize Sphinx extension."""
import sphinx
from .parser import CommonMarkParser
app.add_source_parser('.md', CommonMarkParser) # needs Sphinx >= 1.4
if sphinx.version_info >= (1, 8):
app.add_source_suffix('.md', 'markdown')
app.add_source_parser(CommonMarkParser)
elif sphinx.version_info >= (1, 4):
app.add_source_parser('.md', CommonMarkParser)
return {'version': __version__, 'parallel_read_safe': True}