conf.py 1.95 KB
Newer Older
1 2 3 4 5 6
# -*- coding: utf-8 -*-
#
# Python documentation build configuration file
#
# The contents of this file are pickled, so don't put values in the namespace
# that aren't pickleable (module imports are okay, they're removed automatically).
7 8 9

# General configuration
# ---------------------
10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40

# The default replacements for |version| and |release|.
# If 'auto', Sphinx looks for the Include/patchlevel.h file in the current Python
# source tree and replaces the values accordingly.
#
# The short X.Y version.
# version = '2.6'
version = 'auto'
# The full version, including alpha/beta/rc tags.
# release = '2.6a0'
release = 'auto'

# There are two options for replacing |today|: either, you set today to some
# non-false value, then it is used:
today = ''
# Else, today_fmt is used as the format for a strftime call.
today_fmt = '%B %d, %Y'

# List of files that shouldn't be included in the build.
unused_files = [
    'whatsnew/2.0.rst',
    'whatsnew/2.1.rst',
    'whatsnew/2.2.rst',
    'whatsnew/2.3.rst',
    'whatsnew/2.4.rst',
    'whatsnew/2.5.rst',
    'maclib/scrap.rst',
    'library/xmllib.rst',
    'library/xml.etree.rst',
]

41 42 43 44 45 46 47 48 49 50 51 52 53 54
# If true, '()' will be appended to :func: etc. cross-reference text.
add_function_parentheses = True

# If true, the current module name will be prepended to all description
# unit titles (such as .. function::).
add_module_names = True


# Options for HTML output
# -----------------------

# The base URL for download links.
html_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,
# using the given strftime format.
57
html_last_updated_fmt = '%b %d, %Y'
58 59 60

# If true, SmartyPants will be used to convert quotes and dashes to
# typographically correct entities.
61
html_use_smartypants = True
62 63


64 65 66 67 68 69 70 71
# Options for LaTeX output
# ------------------------

# The paper size ("letter" or "a4").
latex_paper_size = "a4"

# The font size ("10pt", "11pt" or "12pt").
latex_font_size = "10pt"