blob: 29137e20028a055ab812e905e88117bd2820018c [file] [log] [blame]
Georg Brandl116aa622007-08-15 14:28:22 +00001# -*- coding: utf-8 -*-
2#
3# Python documentation build configuration file
4#
5# The contents of this file are pickled, so don't put values in the namespace
6# that aren't pickleable (module imports are okay, they're removed automatically).
Christian Heimes2c181612007-12-17 20:04:13 +00007
8# General configuration
9# ---------------------
Georg Brandl116aa622007-08-15 14:28:22 +000010
11# The default replacements for |version| and |release|.
12# If 'auto', Sphinx looks for the Include/patchlevel.h file in the current Python
13# source tree and replaces the values accordingly.
14#
15# The short X.Y version.
16# version = '2.6'
17version = 'auto'
18# The full version, including alpha/beta/rc tags.
19# release = '2.6a0'
20release = 'auto'
21
22# There are two options for replacing |today|: either, you set today to some
23# non-false value, then it is used:
24today = ''
25# Else, today_fmt is used as the format for a strftime call.
26today_fmt = '%B %d, %Y'
27
Georg Brandl116aa622007-08-15 14:28:22 +000028# List of files that shouldn't be included in the build.
29unused_files = [
30 'whatsnew/2.0.rst',
31 'whatsnew/2.1.rst',
32 'whatsnew/2.2.rst',
33 'whatsnew/2.3.rst',
34 'whatsnew/2.4.rst',
35 'whatsnew/2.5.rst',
36 'whatsnew/2.6.rst',
37 'maclib/scrap.rst',
38 'library/xmllib.rst',
39 'library/xml.etree.rst',
40]
41
Georg Brandl116aa622007-08-15 14:28:22 +000042# If true, '()' will be appended to :func: etc. cross-reference text.
43add_function_parentheses = True
44
45# If true, the current module name will be prepended to all description
46# unit titles (such as .. function::).
47add_module_names = True
Christian Heimes2c181612007-12-17 20:04:13 +000048
49
50# Options for HTML output
51# -----------------------
52
53# The base URL for download links.
54html_download_base_url = 'http://docs.python.org/ftp/python/doc/'
55
56# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
57# using the given strftime format.
58html_last_updated_fmt = '%b %d, %Y'
59
60# If true, SmartyPants will be used to convert quotes and dashes to
61# typographically correct entities.
62html_use_smartypants = True
63
64
65# Options for LaTeX output
66# ------------------------
67
68# The paper size ("letter" or "a4").
69latex_paper_size = "a4"
70
71# The font size ("10pt", "11pt" or "12pt").
72latex_font_size = "10pt"