Georg Brandl | 116aa62 | 2007-08-15 14:28:22 +0000 | [diff] [blame] | 1 | # -*- 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 Heimes | 2c18161 | 2007-12-17 20:04:13 +0000 | [diff] [blame^] | 7 | |
| 8 | # General configuration |
| 9 | # --------------------- |
Georg Brandl | 116aa62 | 2007-08-15 14:28:22 +0000 | [diff] [blame] | 10 | |
| 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' |
| 17 | version = 'auto' |
| 18 | # The full version, including alpha/beta/rc tags. |
| 19 | # release = '2.6a0' |
| 20 | release = 'auto' |
| 21 | |
| 22 | # There are two options for replacing |today|: either, you set today to some |
| 23 | # non-false value, then it is used: |
| 24 | today = '' |
| 25 | # Else, today_fmt is used as the format for a strftime call. |
| 26 | today_fmt = '%B %d, %Y' |
| 27 | |
Georg Brandl | 116aa62 | 2007-08-15 14:28:22 +0000 | [diff] [blame] | 28 | # List of files that shouldn't be included in the build. |
| 29 | unused_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 Brandl | 116aa62 | 2007-08-15 14:28:22 +0000 | [diff] [blame] | 42 | # If true, '()' will be appended to :func: etc. cross-reference text. |
| 43 | add_function_parentheses = True |
| 44 | |
| 45 | # If true, the current module name will be prepended to all description |
| 46 | # unit titles (such as .. function::). |
| 47 | add_module_names = True |
Christian Heimes | 2c18161 | 2007-12-17 20:04:13 +0000 | [diff] [blame^] | 48 | |
| 49 | |
| 50 | # Options for HTML output |
| 51 | # ----------------------- |
| 52 | |
| 53 | # The base URL for download links. |
| 54 | 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, |
| 57 | # using the given strftime format. |
| 58 | html_last_updated_fmt = '%b %d, %Y' |
| 59 | |
| 60 | # If true, SmartyPants will be used to convert quotes and dashes to |
| 61 | # typographically correct entities. |
| 62 | html_use_smartypants = True |
| 63 | |
| 64 | |
| 65 | # Options for LaTeX output |
| 66 | # ------------------------ |
| 67 | |
| 68 | # The paper size ("letter" or "a4"). |
| 69 | latex_paper_size = "a4" |
| 70 | |
| 71 | # The font size ("10pt", "11pt" or "12pt"). |
| 72 | latex_font_size = "10pt" |