blob: 8e1c39d93d7950486ee04990d5b8ff5b01a02c1e [file] [log] [blame]
Georg Brandl8ec7f652007-08-15 14:28:01 +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).
Georg Brandleee1fc52007-12-16 19:36:51 +00007
8# General configuration
9# ---------------------
Georg Brandl8ec7f652007-08-15 14:28:01 +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 Brandl8ec7f652007-08-15 14:28:01 +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 'maclib/scrap.rst',
37 'library/xmllib.rst',
38 'library/xml.etree.rst',
39]
40
Georg Brandl8ec7f652007-08-15 14:28:01 +000041# If true, '()' will be appended to :func: etc. cross-reference text.
42add_function_parentheses = True
43
44# If true, the current module name will be prepended to all description
45# unit titles (such as .. function::).
46add_module_names = True
Georg Brandleee1fc52007-12-16 19:36:51 +000047
48
49# Options for HTML output
50# -----------------------
51
52# The base URL for download links.
53html_download_base_url = 'http://docs.python.org/ftp/python/doc/'
54
55# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
56# using the given strftime format.
57html_last_updated_fmt = '%b %d, %Y'
58
59# If true, SmartyPants will be used to convert quotes and dashes to
60# typographically correct entities.
61html_use_smartypants = True
62
63
64# Options for LaTeX output
65# ------------------------
66
67# The paper size ("letter" or "a4").
68latex_paper_size = "a4"
69
70# The font size ("10pt", "11pt" or "12pt").
71latex_font_size = "10pt"