conf.py: drop '.h' docs rendering (nothing to build); fix deprecated 'source_parsers' usage

This commit is contained in:
sommersoft 2020-04-09 08:49:32 -05:00
parent cb818ca832
commit ae07ced795
1 changed files with 8 additions and 4 deletions

12
conf.py
View File

@ -17,7 +17,7 @@ import json
import sys import sys
import os import os
from recommonmark.parser import CommonMarkParser import recommonmark
# If extensions (or modules to document with autodoc) are in another directory, # 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 # add these directories to sys.path here. If the directory is relative to the
@ -55,16 +55,20 @@ extensions = [
'sphinx.ext.todo', 'sphinx.ext.todo',
'sphinx.ext.coverage', 'sphinx.ext.coverage',
'rstjinja', 'rstjinja',
'c2rst' 'c2rst',
'recommonmark',
] ]
# Add any paths that contain templates here, relative to this directory. # Add any paths that contain templates here, relative to this directory.
templates_path = ['templates'] templates_path = ['templates']
# The suffix of source filenames. # The suffix of source filenames.
source_suffix = ['.rst', '.md', '.c', '.h'] source_suffix = {
'.rst': 'restructuredtext',
'.md': 'markdown',
'.c': ''
}
source_parsers = {'.md': CommonMarkParser}
# The encoding of source files. # The encoding of source files.
#source_encoding = 'utf-8-sig' #source_encoding = 'utf-8-sig'