comparison polly/docs/conf.py @ 252:1f2b6ac9f198 llvm-original

LLVM16-1
author Shinji KONO <kono@ie.u-ryukyu.ac.jp>
date Fri, 18 Aug 2023 09:04:13 +0900
parents c4bab56944e8
children
comparison
equal deleted inserted replaced
237:c80f45b162ad 252:1f2b6ac9f198
15 from datetime import date 15 from datetime import date
16 16
17 # If extensions (or modules to document with autodoc) are in another directory, 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 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. 19 # documentation root, use os.path.abspath to make it absolute, like shown here.
20 #sys.path.insert(0, os.path.abspath('.')) 20 # sys.path.insert(0, os.path.abspath('.'))
21 21
22 # -- General configuration ----------------------------------------------------- 22 # -- General configuration -----------------------------------------------------
23 23
24 # If your documentation needs a minimal Sphinx version, state it here. 24 # If your documentation needs a minimal Sphinx version, state it here.
25 #needs_sphinx = '1.0' 25 # needs_sphinx = '1.0'
26 26
27 # Add any Sphinx extension module names here, as strings. They can be extensions 27 # Add any Sphinx extension module names here, as strings. They can be extensions
28 # coming with Sphinx (named 'sphinx.ext.*') or your custom ones. 28 # coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
29 extensions = ['sphinx.ext.todo', 'sphinx.ext.mathjax'] 29 extensions = ["sphinx.ext.todo", "sphinx.ext.mathjax"]
30 30
31 # Add any paths that contain templates here, relative to this directory. 31 # Add any paths that contain templates here, relative to this directory.
32 templates_path = ['_templates'] 32 templates_path = ["_templates"]
33 33
34 # The suffix of source filenames. 34 # The suffix of source filenames.
35 source_suffix = '.rst' 35 source_suffix = ".rst"
36 36
37 # The encoding of source files. 37 # The encoding of source files.
38 #source_encoding = 'utf-8-sig' 38 # source_encoding = 'utf-8-sig'
39 39
40 # The master toctree document. 40 # The master toctree document.
41 master_doc = 'index' 41 master_doc = "index"
42 42
43 # General information about the project. 43 # General information about the project.
44 project = u'Polly' 44 project = "Polly"
45 copyright = u'2010-%d, The Polly Team' % date.today().year 45 copyright = "2010-%d, The Polly Team" % date.today().year
46 46
47 # The language for content autogenerated by Sphinx. Refer to documentation 47 # The language for content autogenerated by Sphinx. Refer to documentation
48 # for a list of supported languages. 48 # for a list of supported languages.
49 #language = None 49 # language = None
50 50
51 # There are two options for replacing |today|: either, you set today to some 51 # There are two options for replacing |today|: either, you set today to some
52 # non-false value, then it is used: 52 # non-false value, then it is used:
53 #today = '' 53 # today = ''
54 # Else, today_fmt is used as the format for a strftime call. 54 # Else, today_fmt is used as the format for a strftime call.
55 #today_fmt = '%B %d, %Y' 55 # today_fmt = '%B %d, %Y'
56 56
57 # List of patterns, relative to source directory, that match files and 57 # List of patterns, relative to source directory, that match files and
58 # directories to ignore when looking for source files. 58 # directories to ignore when looking for source files.
59 exclude_patterns = ['_build', 'analyzer'] 59 exclude_patterns = ["_build", "analyzer"]
60 60
61 # The reST default role (used for this markup: `text`) to use for all documents. 61 # The reST default role (used for this markup: `text`) to use for all documents.
62 #default_role = None 62 # default_role = None
63 63
64 # If true, '()' will be appended to :func: etc. cross-reference text. 64 # If true, '()' will be appended to :func: etc. cross-reference text.
65 #add_function_parentheses = True 65 # add_function_parentheses = True
66 66
67 # If true, the current module name will be prepended to all description 67 # If true, the current module name will be prepended to all description
68 # unit titles (such as .. function::). 68 # unit titles (such as .. function::).
69 #add_module_names = True 69 # add_module_names = True
70 70
71 # If true, sectionauthor and moduleauthor directives will be shown in the 71 # If true, sectionauthor and moduleauthor directives will be shown in the
72 # output. They are ignored by default. 72 # output. They are ignored by default.
73 #show_authors = False 73 # show_authors = False
74 74
75 # The name of the Pygments (syntax highlighting) style to use. 75 # The name of the Pygments (syntax highlighting) style to use.
76 pygments_style = 'friendly' 76 pygments_style = "friendly"
77 77
78 # A list of ignored prefixes for module index sorting. 78 # A list of ignored prefixes for module index sorting.
79 #modindex_common_prefix = [] 79 # modindex_common_prefix = []
80 80
81 in_progress_title = "(In-Progress) " if tags.has("PreRelease") else "" 81 in_progress_title = "(In-Progress) " if tags.has("PreRelease") else ""
82 82
83 rst_epilog = f""" 83 rst_epilog = f"""
84 .. |ReleaseNotesTitle| replace:: {in_progress_title} Release Notes 84 .. |ReleaseNotesTitle| replace:: {in_progress_title} Release Notes
88 88
89 # The theme to use for HTML and HTML Help pages. See the documentation for 89 # The theme to use for HTML and HTML Help pages. See the documentation for
90 # a list of builtin themes. 90 # a list of builtin themes.
91 try: 91 try:
92 import sphinx_rtd_theme 92 import sphinx_rtd_theme
93
93 html_theme = "sphinx_rtd_theme" 94 html_theme = "sphinx_rtd_theme"
94 html_theme_path = [sphinx_rtd_theme.get_html_theme_path()] 95 html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
95 except ImportError: 96 except ImportError:
96 html_theme = 'haiku' 97 html_theme = "haiku"
97 98
98 99
99 # Theme options are theme-specific and customize the look and feel of a theme 100 # Theme options are theme-specific and customize the look and feel of a theme
100 # further. For a list of options available for each theme, see the 101 # further. For a list of options available for each theme, see the
101 # documentation. 102 # documentation.
102 #html_theme_options = {} 103 # html_theme_options = {}
103 104
104 # Add any paths that contain custom themes here, relative to this directory. 105 # Add any paths that contain custom themes here, relative to this directory.
105 #html_theme_path = [] 106 # html_theme_path = []
106 107
107 # The name for this set of Sphinx documents. If None, it defaults to 108 # The name for this set of Sphinx documents. If None, it defaults to
108 # "<project> v<release> documentation". 109 # "<project> v<release> documentation".
109 #html_title = None 110 # html_title = None
110 111
111 # A shorter title for the navigation bar. Default is the same as html_title. 112 # A shorter title for the navigation bar. Default is the same as html_title.
112 #html_short_title = None 113 # html_short_title = None
113 114
114 # The name of an image file (relative to this directory) to place at the top 115 # The name of an image file (relative to this directory) to place at the top
115 # of the sidebar. 116 # of the sidebar.
116 #html_logo = None 117 # html_logo = None
117 118
118 # The name of an image file (within the static path) to use as favicon of the 119 # The name of an image file (within the static path) to use as favicon of the
119 # docs. This file should be a Windows icon file (.ico) being 16x16 or 32x32 120 # docs. This file should be a Windows icon file (.ico) being 16x16 or 32x32
120 # pixels large. 121 # pixels large.
121 #html_favicon = None 122 # html_favicon = None
122 123
123 # Add any paths that contain custom static files (such as style sheets) here, 124 # Add any paths that contain custom static files (such as style sheets) here,
124 # relative to this directory. They are copied after the builtin static files, 125 # relative to this directory. They are copied after the builtin static files,
125 # so a file named "default.css" will overwrite the builtin "default.css". 126 # so a file named "default.css" will overwrite the builtin "default.css".
126 html_static_path = [] 127 html_static_path = []
127 128
128 # If not '', a 'Last updated on:' timestamp is inserted at every page bottom, 129 # If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
129 # using the given strftime format. 130 # using the given strftime format.
130 #html_last_updated_fmt = '%b %d, %Y' 131 # html_last_updated_fmt = '%b %d, %Y'
131 132
132 # If true, SmartyPants will be used to convert quotes and dashes to 133 # If true, SmartyPants will be used to convert quotes and dashes to
133 # typographically correct entities. 134 # typographically correct entities.
134 #html_use_smartypants = True 135 # html_use_smartypants = True
135 136
136 # Custom sidebar templates, maps document names to template names. 137 # Custom sidebar templates, maps document names to template names.
137 #html_sidebars = {} 138 # html_sidebars = {}
138 139
139 # Additional templates that should be rendered to pages, maps page names to 140 # Additional templates that should be rendered to pages, maps page names to
140 # template names. 141 # template names.
141 #html_additional_pages = {} 142 # html_additional_pages = {}
142 143
143 # If false, no module index is generated. 144 # If false, no module index is generated.
144 #html_domain_indices = True 145 # html_domain_indices = True
145 146
146 # If false, no index is generated. 147 # If false, no index is generated.
147 #html_use_index = True 148 # html_use_index = True
148 149
149 # If true, the index is split into individual pages for each letter. 150 # If true, the index is split into individual pages for each letter.
150 #html_split_index = False 151 # html_split_index = False
151 152
152 # If true, links to the reST sources are added to the pages. 153 # If true, links to the reST sources are added to the pages.
153 #html_show_sourcelink = True 154 # html_show_sourcelink = True
154 155
155 # If true, "Created using Sphinx" is shown in the HTML footer. Default is True. 156 # If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
156 #html_show_sphinx = True 157 # html_show_sphinx = True
157 158
158 # If true, "(C) Copyright ..." is shown in the HTML footer. Default is True. 159 # If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
159 #html_show_copyright = True 160 # html_show_copyright = True
160 161
161 # If true, an OpenSearch description file will be output, and all pages will 162 # If true, an OpenSearch description file will be output, and all pages will
162 # contain a <link> tag referring to it. The value of this option must be the 163 # contain a <link> tag referring to it. The value of this option must be the
163 # base URL from which the finished HTML is served. 164 # base URL from which the finished HTML is served.
164 #html_use_opensearch = '' 165 # html_use_opensearch = ''
165 166
166 # This is the file name suffix for HTML files (e.g. ".xhtml"). 167 # This is the file name suffix for HTML files (e.g. ".xhtml").
167 #html_file_suffix = None 168 # html_file_suffix = None
168 169
169 # Output file base name for HTML help builder. 170 # Output file base name for HTML help builder.
170 htmlhelp_basename = 'Pollydoc' 171 htmlhelp_basename = "Pollydoc"
171 172
172 173
173 # -- Options for LaTeX output -------------------------------------------------- 174 # -- Options for LaTeX output --------------------------------------------------
174 175
175 latex_elements = { 176 latex_elements = {
176 # The paper size ('letterpaper' or 'a4paper'). 177 # The paper size ('letterpaper' or 'a4paper').
177 #'papersize': 'letterpaper', 178 #'papersize': 'letterpaper',
178 179 # The font size ('10pt', '11pt' or '12pt').
179 # The font size ('10pt', '11pt' or '12pt'). 180 #'pointsize': '10pt',
180 #'pointsize': '10pt', 181 # Additional stuff for the LaTeX preamble.
181 182 #'preamble': '',
182 # Additional stuff for the LaTeX preamble.
183 #'preamble': '',
184 } 183 }
185 184
186 # Grouping the document tree into LaTeX files. List of tuples 185 # Grouping the document tree into LaTeX files. List of tuples
187 # (source start file, target name, title, author, documentclass [howto/manual]). 186 # (source start file, target name, title, author, documentclass [howto/manual]).
188 latex_documents = [ 187 latex_documents = [
189 ('index', 'Polly.tex', u'Polly Documentation', 188 ("index", "Polly.tex", "Polly Documentation", "The Polly Team", "manual"),
190 u'The Polly Team', 'manual'),
191 ] 189 ]
192 190
193 # The name of an image file (relative to this directory) to place at the top of 191 # The name of an image file (relative to this directory) to place at the top of
194 # the title page. 192 # the title page.
195 #latex_logo = None 193 # latex_logo = None
196 194
197 # For "manual" documents, if this is true, then toplevel headings are parts, 195 # For "manual" documents, if this is true, then toplevel headings are parts,
198 # not chapters. 196 # not chapters.
199 #latex_use_parts = False 197 # latex_use_parts = False
200 198
201 # If true, show page references after internal links. 199 # If true, show page references after internal links.
202 #latex_show_pagerefs = False 200 # latex_show_pagerefs = False
203 201
204 # If true, show URL addresses after external links. 202 # If true, show URL addresses after external links.
205 #latex_show_urls = False 203 # latex_show_urls = False
206 204
207 # Documents to append as an appendix to all manuals. 205 # Documents to append as an appendix to all manuals.
208 #latex_appendices = [] 206 # latex_appendices = []
209 207
210 # If false, no module index is generated. 208 # If false, no module index is generated.
211 #latex_domain_indices = True 209 # latex_domain_indices = True
212 210
213 211
214 # If true, show URL addresses after external links. 212 # If true, show URL addresses after external links.
215 #man_show_urls = False 213 # man_show_urls = False
216 214
217 215
218 # -- Options for Texinfo output ------------------------------------------------ 216 # -- Options for Texinfo output ------------------------------------------------
219 217
220 # Grouping the document tree into Texinfo files. List of tuples 218 # Grouping the document tree into Texinfo files. List of tuples
221 # (source start file, target name, title, author, 219 # (source start file, target name, title, author,
222 # dir menu entry, description, category) 220 # dir menu entry, description, category)
223 texinfo_documents = [ 221 texinfo_documents = [
224 ('index', 'Polly', u'Polly Documentation', 222 (
225 u'The Polly Team', 'Polly', 'One line description of project.', 223 "index",
226 'Miscellaneous'), 224 "Polly",
225 "Polly Documentation",
226 "The Polly Team",
227 "Polly",
228 "One line description of project.",
229 "Miscellaneous",
230 ),
227 ] 231 ]
228 232
229 # Documents to append as an appendix to all manuals. 233 # Documents to append as an appendix to all manuals.
230 #texinfo_appendices = [] 234 # texinfo_appendices = []
231 235
232 # If false, no module index is generated. 236 # If false, no module index is generated.
233 #texinfo_domain_indices = True 237 # texinfo_domain_indices = True
234 238
235 # How to display URL addresses: 'footnote', 'no', or 'inline'. 239 # How to display URL addresses: 'footnote', 'no', or 'inline'.
236 #texinfo_show_urls = 'footnote' 240 # texinfo_show_urls = 'footnote'