##// END OF EJS Templates
fix rtfd by removing sphinxext import
Matthias BUSSONNIER -
Show More
@@ -1,228 +1,225
1 # -*- coding: utf-8 -*-
1 # -*- coding: utf-8 -*-
2 #
2 #
3 # IPython documentation build configuration file.
3 # IPython documentation build configuration file.
4
4
5 # NOTE: This file has been edited manually from the auto-generated one from
5 # NOTE: This file has been edited manually from the auto-generated one from
6 # sphinx. Do NOT delete and re-generate. If any changes from sphinx are
6 # sphinx. Do NOT delete and re-generate. If any changes from sphinx are
7 # needed, generate a scratch one and merge by hand any new fields needed.
7 # needed, generate a scratch one and merge by hand any new fields needed.
8
8
9 #
9 #
10 # This file is execfile()d with the current directory set to its containing dir.
10 # This file is execfile()d with the current directory set to its containing dir.
11 #
11 #
12 # The contents of this file are pickled, so don't put values in the namespace
12 # The contents of this file are pickled, so don't put values in the namespace
13 # that aren't pickleable (module imports are okay, they're removed automatically).
13 # that aren't pickleable (module imports are okay, they're removed automatically).
14 #
14 #
15 # All configuration values have a default value; values that are commented out
15 # All configuration values have a default value; values that are commented out
16 # serve to show the default value.
16 # serve to show the default value.
17
17
18 import sys, os
18 import sys, os
19
19
20 ON_RTD = os.environ.get('READTHEDOCS', None) == 'True'
20 ON_RTD = os.environ.get('READTHEDOCS', None) == 'True'
21
21
22 if ON_RTD:
22 if ON_RTD:
23 # Mock the presence of matplotlib, which we don't have on RTD
23 # Mock the presence of matplotlib, which we don't have on RTD
24 # see
24 # see
25 # http://read-the-docs.readthedocs.org/en/latest/faq.html
25 # http://read-the-docs.readthedocs.org/en/latest/faq.html
26 tags.add('rtd')
26 tags.add('rtd')
27
27
28 # If your extensions are in another directory, add it here. If the directory
28 # If your extensions are in another directory, add it here. If the directory
29 # is relative to the documentation root, use os.path.abspath to make it
29 # is relative to the documentation root, use os.path.abspath to make it
30 # absolute, like shown here.
30 # absolute, like shown here.
31 sys.path.insert(0, os.path.abspath('../sphinxext'))
31 sys.path.insert(0, os.path.abspath('../sphinxext'))
32
32
33 # Import support for ipython console session syntax highlighting
34 # (lives IPython's sphinxext subpackage)
35 from IPython.sphinxext import ipython_console_highlighting
36
37 # We load the ipython release info into a dict by explicit execution
33 # We load the ipython release info into a dict by explicit execution
38 iprelease = {}
34 iprelease = {}
39 execfile('../../IPython/core/release.py',iprelease)
35 execfile('../../IPython/core/release.py',iprelease)
40
36
41 # General configuration
37 # General configuration
42 # ---------------------
38 # ---------------------
43
39
44 # Add any Sphinx extension module names here, as strings. They can be extensions
40 # Add any Sphinx extension module names here, as strings. They can be extensions
45 # coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
41 # coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
46 extensions = [
42 extensions = [
47 'matplotlib.sphinxext.mathmpl',
43 'matplotlib.sphinxext.mathmpl',
48 'matplotlib.sphinxext.only_directives',
44 'matplotlib.sphinxext.only_directives',
49 'matplotlib.sphinxext.plot_directive',
45 'matplotlib.sphinxext.plot_directive',
50 'sphinx.ext.autodoc',
46 'sphinx.ext.autodoc',
51 'sphinx.ext.doctest',
47 'sphinx.ext.doctest',
52 'sphinx.ext.inheritance_diagram',
48 'sphinx.ext.inheritance_diagram',
53 'IPython.sphinxext.ipython_console_highlighting',
49 'IPython.sphinxext.ipython_console_highlighting',
54 'IPython.sphinxext.ipython_directive',
50 'IPython.sphinxext.ipython_directive',
55 'numpydoc', # to preprocess docstrings
51 'numpydoc', # to preprocess docstrings
56 'github', # for easy GitHub links
52 'github', # for easy GitHub links
57 ]
53 ]
58
54
59 if ON_RTD:
55 if ON_RTD:
60 # Remove extensions not currently supported on RTD
56 # Remove extensions not currently supported on RTD
61 extensions.remove('matplotlib.sphinxext.only_directives')
57 extensions.remove('matplotlib.sphinxext.only_directives')
62 extensions.remove('matplotlib.sphinxext.mathmpl')
58 extensions.remove('matplotlib.sphinxext.mathmpl')
63 extensions.remove('matplotlib.sphinxext.plot_directive')
59 extensions.remove('matplotlib.sphinxext.plot_directive')
64 extensions.remove('IPython.sphinxext.ipython_directive')
60 extensions.remove('IPython.sphinxext.ipython_directive')
61 extensions.remove('IPython.sphinxext.ipython_console_highlighting')
65
62
66 # Add any paths that contain templates here, relative to this directory.
63 # Add any paths that contain templates here, relative to this directory.
67 templates_path = ['_templates']
64 templates_path = ['_templates']
68
65
69 # The suffix of source filenames.
66 # The suffix of source filenames.
70 source_suffix = '.rst'
67 source_suffix = '.rst'
71
68
72 # The master toctree document.
69 # The master toctree document.
73 master_doc = 'index'
70 master_doc = 'index'
74
71
75 # General substitutions.
72 # General substitutions.
76 project = 'IPython'
73 project = 'IPython'
77 copyright = '2008, The IPython Development Team'
74 copyright = '2008, The IPython Development Team'
78
75
79 # ghissue config
76 # ghissue config
80 github_project_url = "https://github.com/ipython/ipython"
77 github_project_url = "https://github.com/ipython/ipython"
81
78
82 # The default replacements for |version| and |release|, also used in various
79 # The default replacements for |version| and |release|, also used in various
83 # other places throughout the built documents.
80 # other places throughout the built documents.
84 #
81 #
85 # The full version, including alpha/beta/rc tags.
82 # The full version, including alpha/beta/rc tags.
86 release = iprelease['version']
83 release = iprelease['version']
87 # The short X.Y version.
84 # The short X.Y version.
88 version = '.'.join(release.split('.',2)[:2])
85 version = '.'.join(release.split('.',2)[:2])
89
86
90
87
91 # There are two options for replacing |today|: either, you set today to some
88 # There are two options for replacing |today|: either, you set today to some
92 # non-false value, then it is used:
89 # non-false value, then it is used:
93 #today = ''
90 #today = ''
94 # Else, today_fmt is used as the format for a strftime call.
91 # Else, today_fmt is used as the format for a strftime call.
95 today_fmt = '%B %d, %Y'
92 today_fmt = '%B %d, %Y'
96
93
97 # List of documents that shouldn't be included in the build.
94 # List of documents that shouldn't be included in the build.
98 #unused_docs = []
95 #unused_docs = []
99
96
100 # List of directories, relative to source directories, that shouldn't be searched
97 # List of directories, relative to source directories, that shouldn't be searched
101 # for source files.
98 # for source files.
102 exclude_dirs = ['attic']
99 exclude_dirs = ['attic']
103
100
104 # If true, '()' will be appended to :func: etc. cross-reference text.
101 # If true, '()' will be appended to :func: etc. cross-reference text.
105 #add_function_parentheses = True
102 #add_function_parentheses = True
106
103
107 # If true, the current module name will be prepended to all description
104 # If true, the current module name will be prepended to all description
108 # unit titles (such as .. function::).
105 # unit titles (such as .. function::).
109 #add_module_names = True
106 #add_module_names = True
110
107
111 # If true, sectionauthor and moduleauthor directives will be shown in the
108 # If true, sectionauthor and moduleauthor directives will be shown in the
112 # output. They are ignored by default.
109 # output. They are ignored by default.
113 #show_authors = False
110 #show_authors = False
114
111
115 # The name of the Pygments (syntax highlighting) style to use.
112 # The name of the Pygments (syntax highlighting) style to use.
116 pygments_style = 'sphinx'
113 pygments_style = 'sphinx'
117
114
118
115
119 # Options for HTML output
116 # Options for HTML output
120 # -----------------------
117 # -----------------------
121
118
122 # The style sheet to use for HTML and HTML Help pages. A file of that name
119 # The style sheet to use for HTML and HTML Help pages. A file of that name
123 # must exist either in Sphinx' static/ path, or in one of the custom paths
120 # must exist either in Sphinx' static/ path, or in one of the custom paths
124 # given in html_static_path.
121 # given in html_static_path.
125 html_style = 'default.css'
122 html_style = 'default.css'
126
123
127 # The name for this set of Sphinx documents. If None, it defaults to
124 # The name for this set of Sphinx documents. If None, it defaults to
128 # "<project> v<release> documentation".
125 # "<project> v<release> documentation".
129 #html_title = None
126 #html_title = None
130
127
131 # The name of an image file (within the static path) to place at the top of
128 # The name of an image file (within the static path) to place at the top of
132 # the sidebar.
129 # the sidebar.
133 #html_logo = None
130 #html_logo = None
134
131
135 # Add any paths that contain custom static files (such as style sheets) here,
132 # Add any paths that contain custom static files (such as style sheets) here,
136 # relative to this directory. They are copied after the builtin static files,
133 # relative to this directory. They are copied after the builtin static files,
137 # so a file named "default.css" will overwrite the builtin "default.css".
134 # so a file named "default.css" will overwrite the builtin "default.css".
138 html_static_path = ['_static']
135 html_static_path = ['_static']
139
136
140 # If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
137 # If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
141 # using the given strftime format.
138 # using the given strftime format.
142 html_last_updated_fmt = '%b %d, %Y'
139 html_last_updated_fmt = '%b %d, %Y'
143
140
144 # If true, SmartyPants will be used to convert quotes and dashes to
141 # If true, SmartyPants will be used to convert quotes and dashes to
145 # typographically correct entities.
142 # typographically correct entities.
146 #html_use_smartypants = True
143 #html_use_smartypants = True
147
144
148 # Custom sidebar templates, maps document names to template names.
145 # Custom sidebar templates, maps document names to template names.
149 #html_sidebars = {}
146 #html_sidebars = {}
150
147
151 # Additional templates that should be rendered to pages, maps page names to
148 # Additional templates that should be rendered to pages, maps page names to
152 # template names.
149 # template names.
153 #html_additional_pages = {}
150 #html_additional_pages = {}
154
151
155 # If false, no module index is generated.
152 # If false, no module index is generated.
156 #html_use_modindex = True
153 #html_use_modindex = True
157
154
158 # If true, the reST sources are included in the HTML build as _sources/<name>.
155 # If true, the reST sources are included in the HTML build as _sources/<name>.
159 #html_copy_source = True
156 #html_copy_source = True
160
157
161 # If true, an OpenSearch description file will be output, and all pages will
158 # 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
159 # 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.
160 # base URL from which the finished HTML is served.
164 #html_use_opensearch = ''
161 #html_use_opensearch = ''
165
162
166 # If nonempty, this is the file name suffix for HTML files (e.g. ".xhtml").
163 # If nonempty, this is the file name suffix for HTML files (e.g. ".xhtml").
167 #html_file_suffix = ''
164 #html_file_suffix = ''
168
165
169 # Output file base name for HTML help builder.
166 # Output file base name for HTML help builder.
170 htmlhelp_basename = 'ipythondoc'
167 htmlhelp_basename = 'ipythondoc'
171
168
172
169
173 # Options for LaTeX output
170 # Options for LaTeX output
174 # ------------------------
171 # ------------------------
175
172
176 # The paper size ('letter' or 'a4').
173 # The paper size ('letter' or 'a4').
177 latex_paper_size = 'letter'
174 latex_paper_size = 'letter'
178
175
179 # The font size ('10pt', '11pt' or '12pt').
176 # The font size ('10pt', '11pt' or '12pt').
180 latex_font_size = '11pt'
177 latex_font_size = '11pt'
181
178
182 # Grouping the document tree into LaTeX files. List of tuples
179 # Grouping the document tree into LaTeX files. List of tuples
183 # (source start file, target name, title, author, document class [howto/manual]).
180 # (source start file, target name, title, author, document class [howto/manual]).
184
181
185 latex_documents = [
182 latex_documents = [
186 ('index', 'ipython.tex', 'IPython Documentation',
183 ('index', 'ipython.tex', 'IPython Documentation',
187 ur"""The IPython Development Team""", 'manual', True),
184 ur"""The IPython Development Team""", 'manual', True),
188 ('parallel/winhpc_index', 'winhpc_whitepaper.tex',
185 ('parallel/winhpc_index', 'winhpc_whitepaper.tex',
189 'Using IPython on Windows HPC Server 2008',
186 'Using IPython on Windows HPC Server 2008',
190 ur"Brian E. Granger", 'manual', True)
187 ur"Brian E. Granger", 'manual', True)
191 ]
188 ]
192
189
193 # The name of an image file (relative to this directory) to place at the top of
190 # The name of an image file (relative to this directory) to place at the top of
194 # the title page.
191 # the title page.
195 #latex_logo = None
192 #latex_logo = None
196
193
197 # For "manual" documents, if this is true, then toplevel headings are parts,
194 # For "manual" documents, if this is true, then toplevel headings are parts,
198 # not chapters.
195 # not chapters.
199 #latex_use_parts = False
196 #latex_use_parts = False
200
197
201 # Additional stuff for the LaTeX preamble.
198 # Additional stuff for the LaTeX preamble.
202 #latex_preamble = ''
199 #latex_preamble = ''
203
200
204 # Documents to append as an appendix to all manuals.
201 # Documents to append as an appendix to all manuals.
205 #latex_appendices = []
202 #latex_appendices = []
206
203
207 # If false, no module index is generated.
204 # If false, no module index is generated.
208 latex_use_modindex = True
205 latex_use_modindex = True
209
206
210
207
211 # Options for texinfo output
208 # Options for texinfo output
212 # --------------------------
209 # --------------------------
213
210
214 texinfo_documents = [
211 texinfo_documents = [
215 (master_doc, 'ipython', 'IPython Documentation',
212 (master_doc, 'ipython', 'IPython Documentation',
216 'The IPython Development Team',
213 'The IPython Development Team',
217 'IPython',
214 'IPython',
218 'IPython Documentation',
215 'IPython Documentation',
219 'Programming',
216 'Programming',
220 1),
217 1),
221 ]
218 ]
222
219
223
220
224 # Cleanup
221 # Cleanup
225 # -------
222 # -------
226 # delete release info to avoid pickling errors from sphinx
223 # delete release info to avoid pickling errors from sphinx
227
224
228 del iprelease
225 del iprelease
General Comments 0
You need to be logged in to leave comments. Login now