root / doc / sphinx_doc / conf.py @ 729c934e
Historique | Voir | Annoter | Télécharger (7,94 ko)
1 | 935a568c | Florent Chuffart | # -*- coding: utf-8 -*-
|
---|---|---|---|
2 | 935a568c | Florent Chuffart | #
|
3 | 935a568c | Florent Chuffart | # NucleoMiner2 documentation build configuration file, created by
|
4 | 935a568c | Florent Chuffart | # sphinx-quickstart on Thu Dec 13 16:44:18 2012.
|
5 | 935a568c | Florent Chuffart | #
|
6 | 935a568c | Florent Chuffart | # This file is execfile()d with the current directory set to its containing dir.
|
7 | 935a568c | Florent Chuffart | #
|
8 | 935a568c | Florent Chuffart | # Note that not all possible configuration values are present in this
|
9 | 935a568c | Florent Chuffart | # autogenerated file.
|
10 | 935a568c | Florent Chuffart | #
|
11 | 935a568c | Florent Chuffart | # All configuration values have a default; values that are commented out
|
12 | 935a568c | Florent Chuffart | # serve to show the default.
|
13 | 935a568c | Florent Chuffart | |
14 | 935a568c | Florent Chuffart | import sys, os |
15 | 935a568c | Florent Chuffart | |
16 | 935a568c | Florent Chuffart | # If extensions (or modules to document with autodoc) are in another directory,
|
17 | 935a568c | Florent Chuffart | # add these directories to sys.path here. If the directory is relative to the
|
18 | 935a568c | Florent Chuffart | # documentation root, use os.path.abspath to make it absolute, like shown here.
|
19 | 935a568c | Florent Chuffart | #sys.path.insert(0, os.path.abspath('.'))
|
20 | 8e9facd8 | Florent Chuffart | sys.path.insert(0, os.path.abspath('../../../snep/src/current')) |
21 | 935a568c | Florent Chuffart | |
22 | 935a568c | Florent Chuffart | # -- General configuration -----------------------------------------------------
|
23 | 935a568c | Florent Chuffart | |
24 | 935a568c | Florent Chuffart | # If your documentation needs a minimal Sphinx version, state it here.
|
25 | 935a568c | Florent Chuffart | #needs_sphinx = '1.0'
|
26 | 935a568c | Florent Chuffart | |
27 | 935a568c | Florent Chuffart | # Add any Sphinx extension module names here, as strings. They can be extensions
|
28 | 935a568c | Florent Chuffart | # coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
|
29 | 935a568c | Florent Chuffart | # extensions = []
|
30 | 935a568c | Florent Chuffart | extensions = ['sphinx.ext.autodoc']#, 'sphinx.ext.doctest']# , 'sphinx.ext.coverage', 'sphinx.ext.inheritance_diagram'] |
31 | 935a568c | Florent Chuffart | |
32 | 935a568c | Florent Chuffart | # Add any paths that contain templates here, relative to this directory.
|
33 | 935a568c | Florent Chuffart | templates_path = ['_templates']
|
34 | 935a568c | Florent Chuffart | |
35 | 935a568c | Florent Chuffart | # The suffix of source filenames.
|
36 | 935a568c | Florent Chuffart | source_suffix = '.rst'
|
37 | 935a568c | Florent Chuffart | |
38 | 935a568c | Florent Chuffart | # The encoding of source files.
|
39 | 935a568c | Florent Chuffart | #source_encoding = 'utf-8-sig'
|
40 | 935a568c | Florent Chuffart | |
41 | 935a568c | Florent Chuffart | # The master toctree document.
|
42 | 935a568c | Florent Chuffart | master_doc = 'index'
|
43 | 935a568c | Florent Chuffart | |
44 | 935a568c | Florent Chuffart | # General information about the project.
|
45 | 935a568c | Florent Chuffart | project = u'NucleoMiner2'
|
46 | 935a568c | Florent Chuffart | copyright = u'2012, Florent CHUFFART, Jean-Baptiste VEYRIERAS, Gael YVERT'
|
47 | 935a568c | Florent Chuffart | |
48 | 935a568c | Florent Chuffart | # The version info for the project you're documenting, acts as replacement for
|
49 | 935a568c | Florent Chuffart | # |version| and |release|, also used in various other places throughout the
|
50 | 935a568c | Florent Chuffart | # built documents.
|
51 | 935a568c | Florent Chuffart | #
|
52 | 935a568c | Florent Chuffart | # The short X.Y version.
|
53 | 729c934e | Florent Chuffart | version = '2.3.24'
|
54 | 935a568c | Florent Chuffart | # The full version, including alpha/beta/rc tags.
|
55 | 729c934e | Florent Chuffart | release = '2.3.24'
|
56 | 935a568c | Florent Chuffart | |
57 | 935a568c | Florent Chuffart | # The language for content autogenerated by Sphinx. Refer to documentation
|
58 | 935a568c | Florent Chuffart | # for a list of supported languages.
|
59 | 935a568c | Florent Chuffart | #language = None
|
60 | 935a568c | Florent Chuffart | |
61 | 935a568c | Florent Chuffart | # There are two options for replacing |today|: either, you set today to some
|
62 | 935a568c | Florent Chuffart | # non-false value, then it is used:
|
63 | 935a568c | Florent Chuffart | #today = ''
|
64 | 935a568c | Florent Chuffart | # Else, today_fmt is used as the format for a strftime call.
|
65 | 935a568c | Florent Chuffart | #today_fmt = '%B %d, %Y'
|
66 | 935a568c | Florent Chuffart | |
67 | 935a568c | Florent Chuffart | # List of patterns, relative to source directory, that match files and
|
68 | 935a568c | Florent Chuffart | # directories to ignore when looking for source files.
|
69 | 935a568c | Florent Chuffart | exclude_patterns = ["rref.rst"]
|
70 | 935a568c | Florent Chuffart | |
71 | 935a568c | Florent Chuffart | # The reST default role (used for this markup: `text`) to use for all documents.
|
72 | 935a568c | Florent Chuffart | #default_role = None
|
73 | 935a568c | Florent Chuffart | |
74 | 935a568c | Florent Chuffart | # If true, '()' will be appended to :func: etc. cross-reference text.
|
75 | 935a568c | Florent Chuffart | #add_function_parentheses = True
|
76 | 935a568c | Florent Chuffart | |
77 | 935a568c | Florent Chuffart | # If true, the current module name will be prepended to all description
|
78 | 935a568c | Florent Chuffart | # unit titles (such as .. function::).
|
79 | 935a568c | Florent Chuffart | #add_module_names = True
|
80 | 935a568c | Florent Chuffart | |
81 | 935a568c | Florent Chuffart | # If true, sectionauthor and moduleauthor directives will be shown in the
|
82 | 935a568c | Florent Chuffart | # output. They are ignored by default.
|
83 | 935a568c | Florent Chuffart | #show_authors = False
|
84 | 935a568c | Florent Chuffart | |
85 | 935a568c | Florent Chuffart | # The name of the Pygments (syntax highlighting) style to use.
|
86 | 935a568c | Florent Chuffart | pygments_style = 'sphinx'
|
87 | 935a568c | Florent Chuffart | |
88 | 935a568c | Florent Chuffart | # A list of ignored prefixes for module index sorting.
|
89 | 935a568c | Florent Chuffart | #modindex_common_prefix = []
|
90 | 935a568c | Florent Chuffart | |
91 | 935a568c | Florent Chuffart | |
92 | 935a568c | Florent Chuffart | # -- Options for HTML output ---------------------------------------------------
|
93 | 935a568c | Florent Chuffart | |
94 | 935a568c | Florent Chuffart | # The theme to use for HTML and HTML Help pages. See the documentation for
|
95 | 935a568c | Florent Chuffart | # a list of builtin themes.
|
96 | 935a568c | Florent Chuffart | html_theme = 'default'
|
97 | 935a568c | Florent Chuffart | |
98 | 935a568c | Florent Chuffart | # Theme options are theme-specific and customize the look and feel of a theme
|
99 | 935a568c | Florent Chuffart | # further. For a list of options available for each theme, see the
|
100 | 935a568c | Florent Chuffart | # documentation.
|
101 | 935a568c | Florent Chuffart | #html_theme_options = {}
|
102 | 935a568c | Florent Chuffart | |
103 | 935a568c | Florent Chuffart | # Add any paths that contain custom themes here, relative to this directory.
|
104 | 935a568c | Florent Chuffart | #html_theme_path = []
|
105 | 935a568c | Florent Chuffart | |
106 | 935a568c | Florent Chuffart | # The name for this set of Sphinx documents. If None, it defaults to
|
107 | 935a568c | Florent Chuffart | # "<project> v<release> documentation".
|
108 | 935a568c | Florent Chuffart | #html_title = None
|
109 | 935a568c | Florent Chuffart | |
110 | 935a568c | Florent Chuffart | # A shorter title for the navigation bar. Default is the same as html_title.
|
111 | 935a568c | Florent Chuffart | #html_short_title = None
|
112 | 935a568c | Florent Chuffart | |
113 | 935a568c | Florent Chuffart | # The name of an image file (relative to this directory) to place at the top
|
114 | 935a568c | Florent Chuffart | # of the sidebar.
|
115 | 935a568c | Florent Chuffart | #html_logo = None
|
116 | 935a568c | Florent Chuffart | |
117 | 935a568c | Florent Chuffart | # The name of an image file (within the static path) to use as favicon of the
|
118 | 935a568c | Florent Chuffart | # docs. This file should be a Windows icon file (.ico) being 16x16 or 32x32
|
119 | 935a568c | Florent Chuffart | # pixels large.
|
120 | 935a568c | Florent Chuffart | #html_favicon = None
|
121 | 935a568c | Florent Chuffart | |
122 | 935a568c | Florent Chuffart | # Add any paths that contain custom static files (such as style sheets) here,
|
123 | 935a568c | Florent Chuffart | # relative to this directory. They are copied after the builtin static files,
|
124 | 935a568c | Florent Chuffart | # so a file named "default.css" will overwrite the builtin "default.css".
|
125 | 935a568c | Florent Chuffart | html_static_path = ['_static']
|
126 | 935a568c | Florent Chuffart | |
127 | 935a568c | Florent Chuffart | # If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
|
128 | 935a568c | Florent Chuffart | # using the given strftime format.
|
129 | 935a568c | Florent Chuffart | #html_last_updated_fmt = '%b %d, %Y'
|
130 | 935a568c | Florent Chuffart | |
131 | 935a568c | Florent Chuffart | # If true, SmartyPants will be used to convert quotes and dashes to
|
132 | 935a568c | Florent Chuffart | # typographically correct entities.
|
133 | 935a568c | Florent Chuffart | #html_use_smartypants = True
|
134 | 935a568c | Florent Chuffart | |
135 | 935a568c | Florent Chuffart | # Custom sidebar templates, maps document names to template names.
|
136 | 935a568c | Florent Chuffart | #html_sidebars = {}
|
137 | 935a568c | Florent Chuffart | |
138 | 935a568c | Florent Chuffart | # Additional templates that should be rendered to pages, maps page names to
|
139 | 935a568c | Florent Chuffart | # template names.
|
140 | 935a568c | Florent Chuffart | #html_additional_pages = {}
|
141 | 935a568c | Florent Chuffart | |
142 | 935a568c | Florent Chuffart | # If false, no module index is generated.
|
143 | 935a568c | Florent Chuffart | #html_domain_indices = True
|
144 | 935a568c | Florent Chuffart | |
145 | 935a568c | Florent Chuffart | # If false, no index is generated.
|
146 | 935a568c | Florent Chuffart | #html_use_index = True
|
147 | 935a568c | Florent Chuffart | |
148 | 935a568c | Florent Chuffart | # If true, the index is split into individual pages for each letter.
|
149 | 935a568c | Florent Chuffart | #html_split_index = False
|
150 | 935a568c | Florent Chuffart | |
151 | 935a568c | Florent Chuffart | # If true, links to the reST sources are added to the pages.
|
152 | 935a568c | Florent Chuffart | #html_show_sourcelink = True
|
153 | 935a568c | Florent Chuffart | |
154 | 935a568c | Florent Chuffart | # If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
|
155 | 935a568c | Florent Chuffart | #html_show_sphinx = True
|
156 | 935a568c | Florent Chuffart | |
157 | 935a568c | Florent Chuffart | # If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
|
158 | 935a568c | Florent Chuffart | #html_show_copyright = True
|
159 | 935a568c | Florent Chuffart | |
160 | 935a568c | Florent Chuffart | # If true, an OpenSearch description file will be output, and all pages will
|
161 | 935a568c | Florent Chuffart | # contain a <link> tag referring to it. The value of this option must be the
|
162 | 935a568c | Florent Chuffart | # base URL from which the finished HTML is served.
|
163 | 935a568c | Florent Chuffart | #html_use_opensearch = ''
|
164 | 935a568c | Florent Chuffart | |
165 | 935a568c | Florent Chuffart | # This is the file name suffix for HTML files (e.g. ".xhtml").
|
166 | 935a568c | Florent Chuffart | #html_file_suffix = None
|
167 | 935a568c | Florent Chuffart | |
168 | 935a568c | Florent Chuffart | # Output file base name for HTML help builder.
|
169 | 935a568c | Florent Chuffart | htmlhelp_basename = 'NucleoMiner2doc'
|
170 | 935a568c | Florent Chuffart | |
171 | 935a568c | Florent Chuffart | |
172 | 935a568c | Florent Chuffart | # -- Options for LaTeX output --------------------------------------------------
|
173 | 935a568c | Florent Chuffart | |
174 | 935a568c | Florent Chuffart | latex_elements = { |
175 | 935a568c | Florent Chuffart | # The paper size ('letterpaper' or 'a4paper').
|
176 | 935a568c | Florent Chuffart | #'papersize': 'letterpaper',
|
177 | 935a568c | Florent Chuffart | |
178 | 935a568c | Florent Chuffart | # The font size ('10pt', '11pt' or '12pt').
|
179 | 935a568c | Florent Chuffart | #'pointsize': '10pt',
|
180 | 935a568c | Florent Chuffart | |
181 | 935a568c | Florent Chuffart | # Additional stuff for the LaTeX preamble.
|
182 | 935a568c | Florent Chuffart | #'preamble': '',
|
183 | 935a568c | Florent Chuffart | } |
184 | 935a568c | Florent Chuffart | |
185 | 935a568c | Florent Chuffart | # Grouping the document tree into LaTeX files. List of tuples
|
186 | 935a568c | Florent Chuffart | # (source start file, target name, title, author, documentclass [howto/manual]).
|
187 | 935a568c | Florent Chuffart | latex_documents = [ |
188 | 935a568c | Florent Chuffart | ('index', 'NucleoMiner2.tex', u'nucleo\\_miner Documentation', |
189 | 935a568c | Florent Chuffart | u'Florent CHUFFART, Jean-Baptiste VEYRIERAS, Gael YVERT', 'manual'), |
190 | 935a568c | Florent Chuffart | ] |
191 | 935a568c | Florent Chuffart | |
192 | 935a568c | Florent Chuffart | # The name of an image file (relative to this directory) to place at the top of
|
193 | 935a568c | Florent Chuffart | # the title page.
|
194 | 935a568c | Florent Chuffart | #latex_logo = None
|
195 | 935a568c | Florent Chuffart | |
196 | 935a568c | Florent Chuffart | # For "manual" documents, if this is true, then toplevel headings are parts,
|
197 | 935a568c | Florent Chuffart | # not chapters.
|
198 | 935a568c | Florent Chuffart | #latex_use_parts = False
|
199 | 935a568c | Florent Chuffart | |
200 | 935a568c | Florent Chuffart | # If true, show page references after internal links.
|
201 | 935a568c | Florent Chuffart | #latex_show_pagerefs = False
|
202 | 935a568c | Florent Chuffart | |
203 | 935a568c | Florent Chuffart | # If true, show URL addresses after external links.
|
204 | 935a568c | Florent Chuffart | #latex_show_urls = False
|
205 | 935a568c | Florent Chuffart | |
206 | 935a568c | Florent Chuffart | # Documents to append as an appendix to all manuals.
|
207 | 935a568c | Florent Chuffart | #latex_appendices = []
|
208 | 935a568c | Florent Chuffart | |
209 | 935a568c | Florent Chuffart | # If false, no module index is generated.
|
210 | 935a568c | Florent Chuffart | #latex_domain_indices = True
|
211 | 935a568c | Florent Chuffart | |
212 | 935a568c | Florent Chuffart | |
213 | 935a568c | Florent Chuffart | # -- Options for manual page output --------------------------------------------
|
214 | 935a568c | Florent Chuffart | |
215 | 935a568c | Florent Chuffart | # One entry per manual page. List of tuples
|
216 | 935a568c | Florent Chuffart | # (source start file, name, description, authors, manual section).
|
217 | 935a568c | Florent Chuffart | man_pages = [ |
218 | 935a568c | Florent Chuffart | ('index', 'NucleoMiner2', u'NucleoMiner2 Documentation', |
219 | 935a568c | Florent Chuffart | [u'Florent CHUFFART, Jean-Baptiste VEYRIERAS, Gael YVERT'], 1) |
220 | 935a568c | Florent Chuffart | ] |
221 | 935a568c | Florent Chuffart | |
222 | 935a568c | Florent Chuffart | # If true, show URL addresses after external links.
|
223 | 935a568c | Florent Chuffart | #man_show_urls = False
|
224 | 935a568c | Florent Chuffart | |
225 | 935a568c | Florent Chuffart | |
226 | 935a568c | Florent Chuffart | # -- Options for Texinfo output ------------------------------------------------
|
227 | 935a568c | Florent Chuffart | |
228 | 935a568c | Florent Chuffart | # Grouping the document tree into Texinfo files. List of tuples
|
229 | 935a568c | Florent Chuffart | # (source start file, target name, title, author,
|
230 | 935a568c | Florent Chuffart | # dir menu entry, description, category)
|
231 | 935a568c | Florent Chuffart | texinfo_documents = [ |
232 | 935a568c | Florent Chuffart | ('index', 'NucleoMiner2', u'NucleoMiner2 Documentation', |
233 | 935a568c | Florent Chuffart | u'Florent CHUFFART, Jean-Baptiste VEYRIERAS, Gael YVERT', 'NucleoMiner2', 'One line description of project.', |
234 | 935a568c | Florent Chuffart | 'Miscellaneous'),
|
235 | 935a568c | Florent Chuffart | ] |
236 | 935a568c | Florent Chuffart | |
237 | 935a568c | Florent Chuffart | # Documents to append as an appendix to all manuals.
|
238 | 935a568c | Florent Chuffart | #texinfo_appendices = []
|
239 | 935a568c | Florent Chuffart | |
240 | 935a568c | Florent Chuffart | # If false, no module index is generated.
|
241 | 935a568c | Florent Chuffart | #texinfo_domain_indices = True
|
242 | 935a568c | Florent Chuffart | |
243 | 935a568c | Florent Chuffart | # How to display URL addresses: 'footnote', 'no', or 'inline'.
|
244 | 935a568c | Florent Chuffart | #texinfo_show_urls = 'footnote' |