Documentation/source/conf.py
author Patrick PIERRE <patrick.pierre@prismallia.fr>
mar., 19 juil. 2011 13:25:35 +0200
changeset 36 d23cfb7be79e
parent 5 69310bc35b63
permissions -rw-r--r--
<cover> + lien sur médias
patrick@5
     1
# -*- coding: utf-8 -*-
patrick@5
     2
#
patrick@5
     3
# Publidoc documentation build configuration file, created by
patrick@5
     4
# sphinx-quickstart on Mon Jun  6 08:40:53 2011.
patrick@5
     5
#
patrick@5
     6
# This file is execfile()d with the current directory set to its containing dir.
patrick@5
     7
#
patrick@5
     8
# Note that not all possible configuration values are present in this
patrick@5
     9
# autogenerated file.
patrick@5
    10
#
patrick@5
    11
# All configuration values have a default; values that are commented out
patrick@5
    12
# serve to show the default.
patrick@5
    13
patrick@5
    14
import sys, os
patrick@5
    15
patrick@5
    16
# If extensions (or modules to document with autodoc) are in another directory,
patrick@5
    17
# add these directories to sys.path here. If the directory is relative to the
patrick@5
    18
# documentation root, use os.path.abspath to make it absolute, like shown here.
patrick@5
    19
#sys.path.insert(0, os.path.abspath('.'))
patrick@5
    20
patrick@5
    21
# -- General configuration -----------------------------------------------------
patrick@5
    22
patrick@5
    23
# If your documentation needs a minimal Sphinx version, state it here.
patrick@5
    24
#needs_sphinx = '1.0'
patrick@5
    25
patrick@5
    26
# Add any Sphinx extension module names here, as strings. They can be extensions
patrick@5
    27
# coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
patrick@5
    28
#extensions = ['sphinx.ext.pngmath']
patrick@5
    29
patrick@5
    30
# Add any paths that contain templates here, relative to this directory.
patrick@5
    31
#templates_path = ['_templates']
patrick@5
    32
patrick@5
    33
# The suffix of source filenames.
patrick@5
    34
source_suffix = '.rst'
patrick@5
    35
patrick@5
    36
# The encoding of source files.
patrick@5
    37
#source_encoding = 'utf-8-sig'
patrick@5
    38
patrick@5
    39
# The master toctree document.
patrick@5
    40
master_doc = 'index'
patrick@5
    41
patrick@5
    42
# General information about the project.
patrick@5
    43
project = u'Publidoc'
patrick@5
    44
copyright = u'2011, Prismallia'
patrick@5
    45
patrick@5
    46
# The version info for the project you're documenting, acts as replacement for
patrick@5
    47
# |version| and |release|, also used in various other places throughout the
patrick@5
    48
# built documents.
patrick@5
    49
#
patrick@5
    50
# The short X.Y version.
patrick@5
    51
version = '1.0'
patrick@5
    52
# The full version, including alpha/beta/rc tags.
patrick@5
    53
release = '1.0'
patrick@5
    54
patrick@5
    55
# The language for content autogenerated by Sphinx. Refer to documentation
patrick@5
    56
# for a list of supported languages.
patrick@5
    57
#language = None
patrick@5
    58
language = 'fr'
patrick@5
    59
patrick@5
    60
# There are two options for replacing |today|: either, you set today to some
patrick@5
    61
# non-false value, then it is used:
patrick@5
    62
#today = ''
patrick@5
    63
# Else, today_fmt is used as the format for a strftime call.
patrick@5
    64
#today_fmt = '%B %d, %Y'
patrick@5
    65
patrick@5
    66
# List of patterns, relative to source directory, that match files and
patrick@5
    67
# directories to ignore when looking for source files.
patrick@5
    68
exclude_patterns = []
patrick@5
    69
patrick@5
    70
# The reST default role (used for this markup: `text`) to use for all documents.
patrick@5
    71
#default_role = None
patrick@5
    72
patrick@5
    73
# If true, '()' will be appended to :func: etc. cross-reference text.
patrick@5
    74
#add_function_parentheses = True
patrick@5
    75
patrick@5
    76
# If true, the current module name will be prepended to all description
patrick@5
    77
# unit titles (such as .. function::).
patrick@5
    78
#add_module_names = True
patrick@5
    79
patrick@5
    80
# If true, sectionauthor and moduleauthor directives will be shown in the
patrick@5
    81
# output. They are ignored by default.
patrick@5
    82
#show_authors = False
patrick@5
    83
patrick@5
    84
# The name of the Pygments (syntax highlighting) style to use.
patrick@5
    85
pygments_style = 'sphinx'
patrick@5
    86
patrick@5
    87
# A list of ignored prefixes for module index sorting.
patrick@5
    88
#modindex_common_prefix = []
patrick@5
    89
patrick@5
    90
patrick@5
    91
# -- Options for HTML output ---------------------------------------------------
patrick@5
    92
patrick@5
    93
# The theme to use for HTML and HTML Help pages.  See the documentation for
patrick@5
    94
# a list of builtin themes.
patrick@5
    95
html_theme = 'default'
patrick@5
    96
patrick@5
    97
# Theme options are theme-specific and customize the look and feel of a theme
patrick@5
    98
# further.  For a list of options available for each theme, see the
patrick@5
    99
# documentation.
patrick@5
   100
#html_theme_options = {}
patrick@5
   101
html_theme_options = {
patrick@5
   102
    'footerbgcolor': '#4C4C4C',
patrick@5
   103
    'sidebarbgcolor': '#DDDDCC',
patrick@5
   104
    'sidebartextcolor': '#4F4F4F',
patrick@5
   105
    'sidebarlinkcolor': '#333399',
patrick@5
   106
    'relbarbgcolor': '#993333',
patrick@5
   107
}
patrick@5
   108
patrick@5
   109
# Add any paths that contain custom themes here, relative to this directory.
patrick@5
   110
#html_theme_path = []
patrick@5
   111
patrick@5
   112
# The name for this set of Sphinx documents.  If None, it defaults to
patrick@5
   113
# "<project> v<release> documentation".
patrick@5
   114
#html_title = None
patrick@5
   115
patrick@5
   116
# A shorter title for the navigation bar.  Default is the same as html_title.
patrick@5
   117
#html_short_title = None
patrick@5
   118
patrick@5
   119
# The name of an image file (relative to this directory) to place at the top
patrick@5
   120
# of the sidebar.
patrick@5
   121
#html_logo = None
patrick@5
   122
patrick@5
   123
# The name of an image file (within the static path) to use as favicon of the
patrick@5
   124
# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
patrick@5
   125
# pixels large.
patrick@5
   126
#html_favicon = None
patrick@5
   127
patrick@5
   128
# Add any paths that contain custom static files (such as style sheets) here,
patrick@5
   129
# relative to this directory. They are copied after the builtin static files,
patrick@5
   130
# so a file named "default.css" will overwrite the builtin "default.css".
patrick@5
   131
#html_static_path = ['_static']
patrick@5
   132
patrick@5
   133
# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
patrick@5
   134
# using the given strftime format.
patrick@5
   135
#html_last_updated_fmt = '%b %d, %Y'
patrick@5
   136
patrick@5
   137
# If true, SmartyPants will be used to convert quotes and dashes to
patrick@5
   138
# typographically correct entities.
patrick@5
   139
#html_use_smartypants = True
patrick@5
   140
patrick@5
   141
# Custom sidebar templates, maps document names to template names.
patrick@5
   142
#html_sidebars = {}
patrick@5
   143
patrick@5
   144
# Additional templates that should be rendered to pages, maps page names to
patrick@5
   145
# template names.
patrick@5
   146
#html_additional_pages = {}
patrick@5
   147
patrick@5
   148
# If false, no module index is generated.
patrick@5
   149
#html_domain_indices = True
patrick@5
   150
patrick@5
   151
# If false, no index is generated.
patrick@5
   152
#html_use_index = True
patrick@5
   153
patrick@5
   154
# If true, the index is split into individual pages for each letter.
patrick@5
   155
#html_split_index = False
patrick@5
   156
patrick@5
   157
# If true, links to the reST sources are added to the pages.
patrick@5
   158
#html_show_sourcelink = True
patrick@5
   159
patrick@5
   160
# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
patrick@5
   161
#html_show_sphinx = True
patrick@5
   162
patrick@5
   163
# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
patrick@5
   164
#html_show_copyright = True
patrick@5
   165
patrick@5
   166
# If true, an OpenSearch description file will be output, and all pages will
patrick@5
   167
# contain a <link> tag referring to it.  The value of this option must be the
patrick@5
   168
# base URL from which the finished HTML is served.
patrick@5
   169
#html_use_opensearch = ''
patrick@5
   170
patrick@5
   171
# This is the file name suffix for HTML files (e.g. ".xhtml").
patrick@5
   172
#html_file_suffix = None
patrick@5
   173
patrick@5
   174
# Output file base name for HTML help builder.
patrick@5
   175
htmlhelp_basename = 'PublidocDoc'
patrick@5
   176
patrick@5
   177
patrick@5
   178
# -- Options for LaTeX output --------------------------------------------------
patrick@5
   179
patrick@5
   180
# The paper size ('letter' or 'a4').
patrick@5
   181
#latex_paper_size = 'letter'
patrick@5
   182
patrick@5
   183
# The font size ('10pt', '11pt' or '12pt').
patrick@5
   184
#latex_font_size = '10pt'
patrick@5
   185
patrick@5
   186
# Grouping the document tree into LaTeX files. List of tuples
patrick@5
   187
# (source start file, target name, title, author, documentclass [howto/manual]).
patrick@5
   188
latex_documents = [
patrick@5
   189
  ('index', 'publidoc.tex', u'Publidoc Documentation',
patrick@5
   190
   u'Prismallia', 'manual'),
patrick@5
   191
]
patrick@5
   192
patrick@5
   193
# The name of an image file (relative to this directory) to place at the top of
patrick@5
   194
# the title page.
patrick@5
   195
#latex_logo = None
patrick@5
   196
patrick@5
   197
# For "manual" documents, if this is true, then toplevel headings are parts,
patrick@5
   198
# not chapters.
patrick@5
   199
#latex_use_parts = False
patrick@5
   200
patrick@5
   201
# If true, show page references after internal links.
patrick@5
   202
#latex_show_pagerefs = False
patrick@5
   203
patrick@5
   204
# If true, show URL addresses after external links.
patrick@5
   205
#latex_show_urls = False
patrick@5
   206
patrick@5
   207
# Additional stuff for the LaTeX preamble.
patrick@5
   208
#latex_preamble = ''
patrick@5
   209
patrick@5
   210
# Documents to append as an appendix to all manuals.
patrick@5
   211
#latex_appendices = []
patrick@5
   212
patrick@5
   213
# If false, no module index is generated.
patrick@5
   214
#latex_domain_indices = True
patrick@5
   215
patrick@5
   216
patrick@5
   217
# -- Options for manual page output --------------------------------------------
patrick@5
   218
patrick@5
   219
# One entry per manual page. List of tuples
patrick@5
   220
# (source start file, name, description, authors, manual section).
patrick@5
   221
man_pages = [
patrick@5
   222
    ('index', 'publidoc', u'Publidoc Documentation',
patrick@5
   223
     [u'Prismallia'], 1)
patrick@5
   224
]
patrick@5
   225
patrick@5
   226
patrick@5
   227
# -- Options for Epub output ---------------------------------------------------
patrick@5
   228
patrick@5
   229
# Bibliographic Dublin Core info.
patrick@5
   230
epub_title = u'Publidoc'
patrick@5
   231
epub_author = u'Patrick PIERRE'
patrick@5
   232
epub_publisher = u'Prismallia'
patrick@5
   233
epub_copyright = u'2011, Prismallia'
patrick@5
   234
patrick@5
   235
# The language of the text. It defaults to the language option
patrick@5
   236
# or en if the language is not set.
patrick@5
   237
#epub_language = ''
patrick@5
   238
patrick@5
   239
# The scheme of the identifier. Typical schemes are ISBN or URL.
patrick@5
   240
#epub_scheme = ''
patrick@5
   241
patrick@5
   242
# The unique identifier of the text. This can be a ISBN number
patrick@5
   243
# or the project homepage.
patrick@5
   244
#epub_identifier = ''
patrick@5
   245
patrick@5
   246
# A unique identification for the text.
patrick@5
   247
#epub_uid = ''
patrick@5
   248
patrick@5
   249
# HTML files that should be inserted before the pages created by sphinx.
patrick@5
   250
# The format is a list of tuples containing the path and title.
patrick@5
   251
#epub_pre_files = []
patrick@5
   252
patrick@5
   253
# HTML files shat should be inserted after the pages created by sphinx.
patrick@5
   254
# The format is a list of tuples containing the path and title.
patrick@5
   255
#epub_post_files = []
patrick@5
   256
patrick@5
   257
# A list of files that should not be packed into the epub file.
patrick@5
   258
#epub_exclude_files = []
patrick@5
   259
patrick@5
   260
# The depth of the table of contents in toc.ncx.
patrick@5
   261
#epub_tocdepth = 3
patrick@5
   262
patrick@5
   263
# Allow duplicate toc entries.
patrick@5
   264
#epub_tocdup = True