1212# All configuration values have a default; values that are commented out
1313# serve to show the default.
1414
15- import sys ,os
16-
17- # If extensions (or modules to document with autodoc) are in another directory,
18- # add these directories to sys.path here. If the directory is relative to the
19- # documentation root, use os.path.abspath to make it absolute, like shown here.
20- #sys.path.insert(0, os.path.abspath('.'))
15+ import sys
16+ import os
2117
2218# -- General configuration -----------------------------------------------------
2319
24- # If your documentation needs a minimal Sphinx version, state it here.
25- #needs_sphinx = '1.0'
26-
2720# Add any Sphinx extension module names here, as strings. They can be extensions
2821# coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
2922extensions = ['sphinx.ext.autodoc' ,'sphinx.ext.doctest' ,'sphinx.ext.viewcode' ]
3427# The suffix of source filenames.
3528source_suffix = '.rst'
3629
37- # The encoding of source files.
38- #source_encoding = 'utf-8-sig'
39-
4030# The master toctree document.
4131master_doc = 'index'
4232
5242version = '1.0'
5343# The full version, including alpha/beta/rc tags.
5444sys .path .append (os .path .abspath ('..' ))
55- from html5lib import __version__
45+ from html5lib import __version__ # noqa
5646release = __version__
5747
58- # The language for content autogenerated by Sphinx. Refer to documentation
59- # for a list of supported languages.
60- #language = 'en'
61-
62- # There are two options for replacing |today|: either, you set today to some
63- # non-false value, then it is used:
64- #today = ''
65- # Else, today_fmt is used as the format for a strftime call.
66- #today_fmt = '%B %d, %Y'
67-
6848# List of patterns, relative to source directory, that match files and
6949# directories to ignore when looking for source files.
7050exclude_patterns = ['_build' ,'theme' ]
7151
72- # The reST default role (used for this markup: `text`) to use for all documents.
73- #default_role = None
74-
75- # If true, '()' will be appended to :func: etc. cross-reference text.
76- #add_function_parentheses = True
77-
78- # If true, the current module name will be prepended to all description
79- # unit titles (such as .. function::).
80- #add_module_names = True
81-
82- # If true, sectionauthor and moduleauthor directives will be shown in the
83- # output. They are ignored by default.
84- #show_authors = False
85-
8652# The name of the Pygments (syntax highlighting) style to use.
8753pygments_style = 'sphinx'
8854
89- # A list of ignored prefixes for module index sorting.
90- #modindex_common_prefix = []
91-
92- # If true, keep warnings as "system message" paragraphs in the built documents.
93- #keep_warnings = False
94-
95-
9655# -- Options for HTML output ---------------------------------------------------
9756
9857# The theme to use for HTML and HTML Help pages. See the documentation for
9958# a list of builtin themes.
10059html_theme = 'default'
10160
102- # Theme options are theme-specific and customize the look and feel of a theme
103- # further. For a list of options available for each theme, see the
104- # documentation.
105- #html_theme_options = {}
106-
107- # Add any paths that contain custom themes here, relative to this directory.
108- #html_theme_path = []
109-
110- # The name for this set of Sphinx documents. If None, it defaults to
111- # "<project> v<release> documentation".
112- #html_title = None
113-
114- # A shorter title for the navigation bar. Default is the same as html_title.
115- #html_short_title = None
116-
117- # The name of an image file (relative to this directory) to place at the top
118- # of the sidebar.
119- #html_logo = None
120-
121- # The name of an image file (within the static path) to use as favicon of the
122- # docs. This file should be a Windows icon file (.ico) being 16x16 or 32x32
123- # pixels large.
124- #html_favicon = None
125-
126- # Add any paths that contain custom static files (such as style sheets) here,
127- # relative to this directory. They are copied after the builtin static files,
128- # so a file named "default.css" will overwrite the builtin "default.css".
129- #html_static_path = ['_static']
130-
131- # If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
132- # using the given strftime format.
133- #html_last_updated_fmt = '%b %d, %Y'
134-
135- # If true, SmartyPants will be used to convert quotes and dashes to
136- # typographically correct entities.
137- #html_use_smartypants = True
138-
139- # Custom sidebar templates, maps document names to template names.
140- #html_sidebars = {}
141-
142- # Additional templates that should be rendered to pages, maps page names to
143- # template names.
144- #html_additional_pages = {}
145-
146- # If false, no module index is generated.
147- #html_domain_indices = True
148-
149- # If false, no index is generated.
150- #html_use_index = True
151-
152- # If true, the index is split into individual pages for each letter.
153- #html_split_index = False
154-
155- # If true, links to the reST sources are added to the pages.
156- #html_show_sourcelink = True
157-
158- # If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
159- #html_show_sphinx = True
160-
161- # If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
162- #html_show_copyright = True
163-
164- # If true, an OpenSearch description file will be output, and all pages will
165- # contain a <link> tag referring to it. The value of this option must be the
166- # base URL from which the finished HTML is served.
167- #html_use_opensearch = ''
168-
169- # This is the file name suffix for HTML files (e.g. ".xhtml").
170- #html_file_suffix = None
171-
17261# Output file base name for HTML help builder.
17362htmlhelp_basename = 'html5libdoc'
17463
17564
17665# -- Options for LaTeX output --------------------------------------------------
17766
178- latex_elements = {
179- # The paper size ('letterpaper' or 'a4paper').
180- #'papersize': 'letterpaper',
181-
182- # The font size ('10pt', '11pt' or '12pt').
183- #'pointsize': '10pt',
184-
185- # Additional stuff for the LaTeX preamble.
186- #'preamble': '',
187- }
188-
18967# Grouping the document tree into LaTeX files. List of tuples
19068# (source start file, target name, title, author, documentclass [howto/manual]).
19169latex_documents = [
192- ('index' ,'html5lib.tex' ,'html5lib Documentation' ,
193- 'James Graham, Geoffrey Sneddon, and contributors' ,'manual' ),
70+ ('index' ,'html5lib.tex' ,'html5lib Documentation' ,
71+ 'James Graham, Geoffrey Sneddon, and contributors' ,'manual' ),
19472]
19573
196- # The name of an image file (relative to this directory) to place at the top of
197- # the title page.
198- #latex_logo = None
199-
200- # For "manual" documents, if this is true, then toplevel headings are parts,
201- # not chapters.
202- #latex_use_parts = False
203-
204- # If true, show page references after internal links.
205- #latex_show_pagerefs = False
206-
207- # If true, show URL addresses after external links.
208- #latex_show_urls = False
209-
210- # Documents to append as an appendix to all manuals.
211- #latex_appendices = []
212-
213- # If false, no module index is generated.
214- #latex_domain_indices = True
215-
216-
21774# -- Options for manual page output --------------------------------------------
21875
21976# One entry per manual page. List of tuples
22380 ['James Graham, Geoffrey Sneddon, and contributors' ],1 )
22481]
22582
226- # If true, show URL addresses after external links.
227- #man_show_urls = False
228-
229-
23083# -- Options for Texinfo output ------------------------------------------------
23184
23285# Grouping the document tree into Texinfo files. List of tuples
23386# (source start file, target name, title, author,
23487# dir menu entry, description, category)
23588texinfo_documents = [
236- ('index' ,'html5lib' ,'html5lib Documentation' ,
237- 'James Graham, Geoffrey Sneddon, and contributors' ,'html5lib' ,'One line description of project.' ,
238- 'Miscellaneous' ),
89+ ('index' ,'html5lib' ,'html5lib Documentation' ,
90+ 'James Graham, Geoffrey Sneddon, and contributors' ,'html5lib' ,'One line description of project.' ,
91+ 'Miscellaneous' ),
23992]
24093
241- # Documents to append as an appendix to all manuals.
242- #texinfo_appendices = []
243-
244- # If false, no module index is generated.
245- #texinfo_domain_indices = True
246-
247- # How to display URL addresses: 'footnote', 'no', or 'inline'.
248- #texinfo_show_urls = 'footnote'
249-
250- # If true, do not generate a @detailmenu in the "Top" node's menu.
251- #texinfo_no_detailmenu = False
25294
25395class CExtMock (object ):
25496"""Required for autodoc on readthedocs.org where you cannot build C extensions."""
@@ -265,15 +107,16 @@ def __getattr__(cls, name):
265107else :
266108return CExtMock ()
267109
110+
268111try :
269- import lxml #flake8: noqa
112+ import lxml # noqa
270113except ImportError :
271114sys .modules ['lxml' ]= CExtMock ()
272115sys .modules ['lxml.etree' ]= CExtMock ()
273116print ("warning: lxml modules mocked." )
274117
275118try :
276- import genshi # flake8: noqa
119+ import genshi # noqa
277120except ImportError :
278121sys .modules ['genshi' ]= CExtMock ()
279122sys .modules ['genshi.core' ]= CExtMock ()