|
19 | 19 | # |
20 | 20 | import os |
21 | 21 | import sys |
| 22 | + |
22 | 23 | import sphinx_rtd_theme |
23 | 24 |
|
24 | | -sys.path.insert(0, os.path.abspath('..')) |
| 25 | +sys.path.insert(0, os.path.abspath("..")) |
25 | 26 |
|
26 | 27 |
|
27 | 28 | # -- General configuration ------------------------------------------------ |
|
34 | 35 | # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom |
35 | 36 | # ones. |
36 | 37 | extensions = [ |
37 | | - 'sphinx.ext.autodoc', |
38 | | - 'sphinx.ext.coverage', |
39 | | - 'sphinx.ext.intersphinx', |
| 38 | + "sphinx.ext.autodoc", |
| 39 | + "sphinx.ext.coverage", |
| 40 | + "sphinx.ext.intersphinx", |
40 | 41 | ] |
41 | 42 |
|
42 | | -autodoc_member_order = 'bysource' |
| 43 | +autodoc_member_order = "bysource" |
43 | 44 |
|
44 | | -intersphinx_mapping = {'python': ('https://docs.python.org/3', None)} |
| 45 | +intersphinx_mapping = {"python": ("https://docs.python.org/3", None)} |
45 | 46 |
|
46 | 47 | # Add any paths that contain templates here, relative to this directory. |
47 | | -templates_path = ['_templates'] |
| 48 | +templates_path = ["_templates"] |
48 | 49 |
|
49 | 50 | # The suffix(es) of source filenames. |
50 | 51 | # You can specify multiple suffix as a list of string: |
51 | 52 | # |
52 | 53 | # source_suffix = ['.rst', '.md'] |
53 | | -source_suffix = '.rst' |
| 54 | +source_suffix = ".rst" |
54 | 55 |
|
55 | 56 | # The master toctree document. |
56 | | -master_doc = 'index' |
| 57 | +master_doc = "index" |
57 | 58 |
|
58 | 59 | # General information about the project. |
59 | | -project = 'Python PKCS#11' |
60 | | -copyright = '2017, Danielle Madeley' |
61 | | -author = 'Danielle Madeley' |
| 60 | +project = "Python PKCS#11" |
| 61 | +copyright = "2017, Danielle Madeley" |
| 62 | +author = "Danielle Madeley" |
62 | 63 |
|
63 | 64 | # The version info for the project you're documenting, acts as replacement for |
64 | 65 | # |version| and |release|, also used in various other places throughout the |
65 | 66 | # built documents. |
66 | 67 | # |
67 | 68 | # The short X.Y version. |
68 | | -version = '' |
| 69 | +version = "" |
69 | 70 | # The full version, including alpha/beta/rc tags. |
70 | | -release = '' |
| 71 | +release = "" |
71 | 72 |
|
72 | 73 | # The language for content autogenerated by Sphinx. Refer to documentation |
73 | 74 | # for a list of supported languages. |
|
79 | 80 | # List of patterns, relative to source directory, that match files and |
80 | 81 | # directories to ignore when looking for source files. |
81 | 82 | # This patterns also effect to html_static_path and html_extra_path |
82 | | -exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store'] |
| 83 | +exclude_patterns = ["_build", "Thumbs.db", ".DS_Store"] |
83 | 84 |
|
84 | 85 | # The name of the Pygments (syntax highlighting) style to use. |
85 | | -pygments_style = 'sphinx' |
| 86 | +pygments_style = "sphinx" |
86 | 87 |
|
87 | 88 | # If true, `todo` and `todoList` produce output, else they produce nothing. |
88 | 89 | todo_include_todos = False |
|
93 | 94 | # The theme to use for HTML and HTML Help pages. See the documentation for |
94 | 95 | # a list of builtin themes. |
95 | 96 | # |
96 | | -html_theme = 'sphinx_rtd_theme' |
| 97 | +html_theme = "sphinx_rtd_theme" |
97 | 98 | html_theme_path = [sphinx_rtd_theme.get_html_theme_path()] |
98 | 99 |
|
99 | 100 | # Theme options are theme-specific and customize the look and feel of a theme |
|
105 | 106 | # Add any paths that contain custom static files (such as style sheets) here, |
106 | 107 | # relative to this directory. They are copied after the builtin static files, |
107 | 108 | # so a file named "default.css" will overwrite the builtin "default.css". |
108 | | -html_static_path = ['_static'] |
| 109 | +html_static_path = ["_static"] |
109 | 110 |
|
110 | 111 |
|
111 | 112 | # -- Options for HTMLHelp output ------------------------------------------ |
112 | 113 |
|
113 | 114 | # Output file base name for HTML help builder. |
114 | | -htmlhelp_basename = 'PythonPKCS11doc' |
| 115 | +htmlhelp_basename = "PythonPKCS11doc" |
115 | 116 |
|
116 | 117 |
|
117 | 118 | # -- Options for LaTeX output --------------------------------------------- |
|
120 | 121 | # The paper size ('letterpaper' or 'a4paper'). |
121 | 122 | # |
122 | 123 | # 'papersize': 'letterpaper', |
123 | | - |
124 | 124 | # The font size ('10pt', '11pt' or '12pt'). |
125 | 125 | # |
126 | 126 | # 'pointsize': '10pt', |
127 | | - |
128 | 127 | # Additional stuff for the LaTeX preamble. |
129 | 128 | # |
130 | 129 | # 'preamble': '', |
131 | | - |
132 | 130 | # Latex figure (float) alignment |
133 | 131 | # |
134 | 132 | # 'figure_align': 'htbp', |
|
138 | 136 | # (source start file, target name, title, |
139 | 137 | # author, documentclass [howto, manual, or own class]). |
140 | 138 | latex_documents = [ |
141 | | - (master_doc, 'PythonPKCS11.tex', 'Python PKCS\\#11 Documentation', |
142 | | - 'Danielle Madeley', 'manual'), |
| 139 | + ( |
| 140 | + master_doc, |
| 141 | + "PythonPKCS11.tex", |
| 142 | + "Python PKCS\\#11 Documentation", |
| 143 | + "Danielle Madeley", |
| 144 | + "manual", |
| 145 | + ), |
143 | 146 | ] |
144 | 147 |
|
145 | 148 |
|
146 | 149 | # -- Options for manual page output --------------------------------------- |
147 | 150 |
|
148 | 151 | # One entry per manual page. List of tuples |
149 | 152 | # (source start file, name, description, authors, manual section). |
150 | | -man_pages = [ |
151 | | - (master_doc, 'pythonpkcs11', 'Python PKCS#11 Documentation', |
152 | | - [author], 1) |
153 | | -] |
| 153 | +man_pages = [(master_doc, "pythonpkcs11", "Python PKCS#11 Documentation", [author], 1)] |
154 | 154 |
|
155 | 155 |
|
156 | 156 | # -- Options for Texinfo output ------------------------------------------- |
|
159 | 159 | # (source start file, target name, title, author, |
160 | 160 | # dir menu entry, description, category) |
161 | 161 | texinfo_documents = [ |
162 | | - (master_doc, 'PythonPKCS11', 'Python PKCS#11 Documentation', |
163 | | - author, 'PythonPKCS11', 'One line description of project.', |
164 | | - 'Miscellaneous'), |
| 162 | + ( |
| 163 | + master_doc, |
| 164 | + "PythonPKCS11", |
| 165 | + "Python PKCS#11 Documentation", |
| 166 | + author, |
| 167 | + "PythonPKCS11", |
| 168 | + "One line description of project.", |
| 169 | + "Miscellaneous", |
| 170 | + ), |
165 | 171 | ] |
166 | | - |
167 | | - |
168 | | - |
|
0 commit comments