Skip to content

Commit f05587c

Browse files
author
Roland Hedberg
committed
Messed up the documentation. Now trying to fix it.
1 parent a714765 commit f05587c

File tree

6 files changed

+128
-673
lines changed

6 files changed

+128
-673
lines changed

doc/conf.py

Lines changed: 29 additions & 96 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
# -*- coding: utf-8 -*-
22
#
3-
# SAML2test documentation build configuration file, created by
4-
# sphinx-quickstart on Sat Jan 19 11:38:19 2013.
3+
# pysaml2 documentation build configuration file, created by
4+
# sphinx-quickstart on Mon Aug 24 08:13:41 2009.
55
#
66
# This file is execfile()d with the current directory set to its containing dir.
77
#
@@ -12,21 +12,17 @@
1212
# serve to show the default.
1313

1414
import sys, os
15-
import alabaster
1615

1716
# If extensions (or modules to document with autodoc) are in another directory,
1817
# add these directories to sys.path here. If the directory is relative to the
1918
# documentation root, use os.path.abspath to make it absolute, like shown here.
20-
#sys.path.insert(0, os.path.abspath('.'))
19+
#sys.path.append(os.path.abspath('.'))
2120

2221
# -- General configuration -----------------------------------------------------
2322

24-
# If your documentation needs a minimal Sphinx version, state it here.
25-
#needs_sphinx = '1.0'
26-
2723
# Add any Sphinx extension module names here, as strings. They can be extensions
2824
# coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
29-
extensions = ['alabaster', 'sphinx.ext.autodoc', 'sphinx.ext.viewcode']
25+
extensions = ['sphinx.ext.autodoc', 'sphinx.ext.doctest', 'sphinx.ext.coverage']
3026

3127
# Add any paths that contain templates here, relative to this directory.
3228
templates_path = ['_templates']
@@ -35,23 +31,23 @@
3531
source_suffix = '.rst'
3632

3733
# The encoding of source files.
38-
#source_encoding = 'utf-8-sig'
34+
#source_encoding = 'utf-8'
3935

4036
# The master toctree document.
4137
master_doc = 'index'
4238

4339
# General information about the project.
44-
project = u'SAML2test'
45-
copyright = u'2013, Roland Hedberg'
40+
project = u'pysaml2'
41+
copyright = u'2010-2011, Roland Hedberg'
4642

4743
# The version info for the project you're documenting, acts as replacement for
4844
# |version| and |release|, also used in various other places throughout the
4945
# built documents.
5046
#
5147
# The short X.Y version.
52-
version = '0.3.0'
48+
version = '1.2'
5349
# The full version, including alpha/beta/rc tags.
54-
release = '0.3.0'
50+
release = '1.2.0beta'
5551

5652
# The language for content autogenerated by Sphinx. Refer to documentation
5753
# for a list of supported languages.
@@ -63,9 +59,12 @@
6359
# Else, today_fmt is used as the format for a strftime call.
6460
#today_fmt = '%B %d, %Y'
6561

66-
# List of patterns, relative to source directory, that match files and
67-
# directories to ignore when looking for source files.
68-
exclude_patterns = ['_build']
62+
# List of documents that shouldn't be included in the build.
63+
#unused_docs = []
64+
65+
# List of directories, relative to source directory, that shouldn't be searched
66+
# for source files.
67+
exclude_trees = ['_build']
6968

7069
# The reST default role (used for this markup: `text`) to use for all documents.
7170
#default_role = None
@@ -90,27 +89,9 @@
9089

9190
# -- Options for HTML output ---------------------------------------------------
9291

93-
# The theme to use for HTML and HTML Help pages. See the documentation for
94-
# a list of builtin themes.
95-
html_theme_path = [alabaster.get_path()]
96-
html_theme = 'alabaster'
97-
html_sidebars = {
98-
'**': [
99-
'about.html',
100-
'navigation.html',
101-
'searchbox.html',
102-
'donate.html',
103-
]
104-
}
105-
106-
html_theme_options = {
107-
'description': '',
108-
'github_button': False,
109-
'github_user': 'its-dirg',
110-
'github_repo': 'IdProxy',
111-
'github_banner': False,
112-
113-
}
92+
# The theme to use for HTML and HTML Help pages. Major themes that come with
93+
# Sphinx are currently 'default' and 'sphinxdoc'.
94+
html_theme = 'default'
11495

11596
# Theme options are theme-specific and customize the look and feel of a theme
11697
# further. For a list of options available for each theme, see the
@@ -157,7 +138,7 @@
157138
#html_additional_pages = {}
158139

159140
# If false, no module index is generated.
160-
#html_domain_indices = True
141+
#html_use_modindex = True
161142

162143
# If false, no index is generated.
163144
#html_use_index = True
@@ -168,41 +149,30 @@
168149
# If true, links to the reST sources are added to the pages.
169150
#html_show_sourcelink = True
170151

171-
# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
172-
#html_show_sphinx = True
173-
174-
# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
175-
#html_show_copyright = True
176-
177152
# If true, an OpenSearch description file will be output, and all pages will
178153
# contain a <link> tag referring to it. The value of this option must be the
179154
# base URL from which the finished HTML is served.
180155
#html_use_opensearch = ''
181156

182-
# This is the file name suffix for HTML files (e.g. ".xhtml").
183-
#html_file_suffix = None
157+
# If nonempty, this is the file name suffix for HTML files (e.g. ".xhtml").
158+
#html_file_suffix = ''
184159

185160
# Output file base name for HTML help builder.
186-
htmlhelp_basename = 'SAML2testdoc'
161+
htmlhelp_basename = 'pysaml2doc'
187162

188163

189164
# -- Options for LaTeX output --------------------------------------------------
190165

191-
latex_elements = {
192-
# The paper size ('letterpaper' or 'a4paper').
193-
#'papersize': 'letterpaper',
166+
# The paper size ('letter' or 'a4').
167+
#latex_paper_size = 'letter'
194168

195169
# The font size ('10pt', '11pt' or '12pt').
196-
#'pointsize': '10pt',
197-
198-
# Additional stuff for the LaTeX preamble.
199-
#'preamble': '',
200-
}
170+
#latex_font_size = '10pt'
201171

202172
# Grouping the document tree into LaTeX files. List of tuples
203173
# (source start file, target name, title, author, documentclass [howto/manual]).
204174
latex_documents = [
205-
('index', 'SAML2test.tex', u'SAML2test Documentation',
175+
('index', 'pysaml2.tex', u'pysaml2 Documentation',
206176
u'Roland Hedberg', 'manual'),
207177
]
208178

@@ -214,48 +184,11 @@
214184
# not chapters.
215185
#latex_use_parts = False
216186

217-
# If true, show page references after internal links.
218-
#latex_show_pagerefs = False
219-
220-
# If true, show URL addresses after external links.
221-
#latex_show_urls = False
187+
# Additional stuff for the LaTeX preamble.
188+
#latex_preamble = ''
222189

223190
# Documents to append as an appendix to all manuals.
224191
#latex_appendices = []
225192

226193
# If false, no module index is generated.
227-
#latex_domain_indices = True
228-
229-
230-
# -- Options for manual page output --------------------------------------------
231-
232-
# One entry per manual page. List of tuples
233-
# (source start file, name, description, authors, manual section).
234-
man_pages = [
235-
('index', 'saml2test', u'SAML2test Documentation',
236-
[u'Roland Hedberg'], 1)
237-
]
238-
239-
# If true, show URL addresses after external links.
240-
#man_show_urls = False
241-
242-
243-
# -- Options for Texinfo output ------------------------------------------------
244-
245-
# Grouping the document tree into Texinfo files. List of tuples
246-
# (source start file, target name, title, author,
247-
# dir menu entry, description, category)
248-
texinfo_documents = [
249-
('index', 'SAML2test', u'SAML2test Documentation',
250-
u'Roland Hedberg', 'SAML2test', 'One line description of project.',
251-
'Miscellaneous'),
252-
]
253-
254-
# Documents to append as an appendix to all manuals.
255-
#texinfo_appendices = []
256-
257-
# If false, no module index is generated.
258-
#texinfo_domain_indices = True
259-
260-
# How to display URL addresses: 'footnote', 'no', or 'inline'.
261-
#texinfo_show_urls = 'footnote'
194+
#latex_use_modindex = True

0 commit comments

Comments
 (0)