123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321 |
- # -*- coding: utf-8 -*-
- #
- # pythonguide documentation build configuration file, created by
- # sphinx-quickstart on Wed Aug 4 22:51:11 2010.
- #
- # This file is execfile()d with the current directory set to its containing dir.
- #
- # Note that not all possible configuration values are present in this
- # autogenerated file.
- #
- # All configuration values have a default; values that are commented out
- # serve to show the default.
- import datetime
- import os
- import sys
- from pathlib import Path
- import json
- import dataladhandbook_support
- # pull out author list from all-contributors spec
- authors = [
- c['name'] for c in json.load(
- (Path(__file__).parent.parent / '.all-contributorsrc').open()).get(
- 'contributors', [])
- ]
- # If extensions (or modules to document with autodoc) are in another directory,
- # add these directories to sys.path here. If the directory is relative to the
- # documentation root, use os.path.abspath to make it absolute, like shown here.
- sys.path.append(os.path.abspath('_themes'))
- # -- General configuration -----------------------------------------------------
- # If your documentation needs a minimal Sphinx version, state it here.
- #needs_sphinx = '1.0'
- # Add any Sphinx extension module names here, as strings. They can be extensions
- # coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
- extensions = [
- 'sphinx.ext.ifconfig',
- 'sphinx.ext.todo',
- 'sphinx.ext.intersphinx',
- 'sphinx.ext.doctest',
- 'sphinxcontrib.autorunrecord',
- 'sphinxcontrib.rsvgconverter',
- 'sphinxcontrib.plantuml',
- 'dataladhandbook_support',
- ]
- # Add any paths that contain templates here, relative to this directory.
- templates_path = ['_templates']
- # The suffix of source filenames.
- source_suffix = '.rst'
- # The encoding of source files.
- #source_encoding = 'utf-8-sig'
- # The master toctree document.
- master_doc = 'index'
- # General information about the project.
- current_year = datetime.datetime.now().year
- project = u'datalad-handbook'
- copyright = (u'2019-{} CC-BY-SA').format(current_year)
- # The version info for the project you're documenting, acts as replacement for
- # |version| and |release|, also used in various other places throughout the
- # built documents.
- #
- # The short X.Y version.
- version = dataladhandbook_support.__version__
- # The full version, including alpha/beta/rc tags.
- release = version
- # The language for content autogenerated by Sphinx. Refer to documentation
- # for a list of supported languages.
- #language = None
- # 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 patterns, relative to source directory, that match files and
- # directories to ignore when looking for source files.
- exclude_patterns = [
- '_build',
- '_themes/*.rst', # Excluded due to README.rst in _themes/
- ]
- # The reST default role (used for this markup: `text`) to use for all documents.
- #default_role = None
- # 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
- # If true, sectionauthor and moduleauthor directives will be shown in the
- # output. They are ignored by default.
- #show_authors = False
- # The name of the Pygments (syntax highlighting) style to use.
- pygments_style = 'tango'
- # A list of ignored prefixes for module index sorting.
- #modindex_common_prefix = []
- manpages_url = 'http://docs.datalad.org/generated/man/{page}.html'
- # numbered figures for better referencing
- numfig = True
- numfig_secnum_depth = 1
- # convert quotes and dashes into to proper symbols
- smartquotes = True
- # Trim spaces before footnote references that are necessary for the reST parser
- # to recognize the footnote, but do not look too nice in the output.
- trim_footnote_reference_space = True
- # -- Options for HTML output ---------------------------------------------------
- html_baseurl = 'http://handbook.datalad.org/'
- # The theme to use for HTML and HTML Help pages. See the documentation for
- # a list of builtin themes.
- html_theme = 'alabaster'
- # Theme options are theme-specific and customize the look and feel of a theme
- # further. For a list of options available for each theme, see the
- # documentation.
- # more options: https://alabaster.readthedocs.io/en/latest/customization.html
- html_theme_options = {
- 'show_powered_by': False,
- 'github_user': 'datalad-handbook',
- 'github_repo': 'book',
- 'github_banner': True,
- 'show_related': True,
- # colors
- # "DataLad gray"
- 'body_text': '#333',
- # this is a lighter variant of the "DataLad yellow"
- 'note_bg': '#e2eacdff',
- # the real "DataLad dark gray"
- 'note_border': '#333333ff',
- 'fixed_sidebar': True,
- 'show_relbar_bottom': True,
- }
- # Add any paths that contain custom themes here, relative to this directory.
- html_theme_path = ['_themes']
- # The name for this set of Sphinx documents. If None, it defaults to
- # "<project> v<release> documentation".
- html_title = 'The DataLad Handbook'
- # A shorter title for the navigation bar. Default is the same as html_title.
- #html_short_title = None
- # The name of an image file (relative to this directory) to place at the top
- # of the sidebar.
- #html_logo = None
- # The name of an image file (within the static path) to use as favicon of the
- # docs. This file should be a Windows icon file (.ico) being 16x16 or 32x32
- # pixels large.
- #html_favicon = None
- # Add any paths that contain custom static files (such as style sheets) here,
- # relative to this directory. They are copied after the builtin static files,
- # so a file named "default.css" will overwrite the builtin "default.css".
- html_static_path = ['_static']
- # If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
- # using the given strftime format.
- #html_last_updated_fmt = '%b %d, %Y'
- # Custom sidebar templates, maps document names to template names.
- html_sidebars = {
- 'index': ['sidebarintro.html', 'sourcelink.html', 'searchbox.html', 'hacks.html'],
- '**': ['sidebarlogo.html', 'localtoc.html', 'relations.html',
- 'sourcelink.html', 'searchbox.html', 'hacks.html']
- }
- # Additional templates that should be rendered to pages, maps page names to
- # template names.
- #html_additional_pages = {}
- # If false, no module index is generated.
- #html_domain_indices = True
- # If false, no index is generated.
- #html_use_index = True
- # If true, the index is split into individual pages for each letter.
- #html_split_index = False
- # If true, links to the reST sources are added to the pages.
- html_show_sourcelink = False
- # If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
- html_show_sphinx = False
- # If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
- #html_show_copyright = True
- # If true, an OpenSearch description file will be output, and all pages will
- # contain a <link> tag referring to it. The value of this option must be the
- # base URL from which the finished HTML is served.
- #html_use_opensearch = ''
- # This is the file name suffix for HTML files (e.g. ".xhtml").
- #html_file_suffix = None
- # Output file base name for HTML help builder.
- htmlhelp_basename = 'dataladhandbookdoc'
- # -- Options for LaTeX output --------------------------------------------------
- # Grouping the document tree into LaTeX files. List of tuples
- # (source start file, target name, title, author, documentclass [howto/manual]).
- latex_documents = [
- (
- 'index',
- 'dataladhandbook.tex',
- u'The DataLad Handbook',
- u' \\and '.join(a.replace(' ', '~') for a in authors),
- 'manual'),
- ]
- # The name of an image file (relative to this directory) to place at the top of
- # the title page.
- latex_logo = None
- latex_toplevel_sectioning = 'part'
- latex_show_pagerefs = True
- latex_show_urls = 'footnote'
- latex_elements = {
- 'papersize': 'a4',
- 'pointsize': '11pt',
- 'figure_align': 'tbp',
- 'preamble': """\
- \setcounter{tocdepth}{0}
- """,
- }
- # Documents to append as an appendix to all manuals.
- #latex_appendices = []
- # If false, no module index is generated.
- #latex_domain_indices = True
- # -- Options for manual page output --------------------------------------------
- # One entry per manual page. List of tuples
- # (source start file, name, description, authors, manual section).
- man_pages = [
- ('index', 'dataladhandbook', u'The DataLad Handbook',
- [u'all'], 1)
- ]
- # -- Options for Epub output ---------------------------------------------------
- # Bibliographic Dublin Core info.
- epub_title = u'dataladhandbook'
- epub_author = u'all'
- epub_publisher = u'all'
- epub_copyright = u'2019–{}, all'.format(current_year)
- # The language of the text. It defaults to the language option
- # or en if the language is not set.
- #epub_language = ''
- # The scheme of the identifier. Typical schemes are ISBN or URL.
- #epub_scheme = ''
- # The unique identifier of the text. This can be a ISBN number
- # or the project homepage.
- #epub_identifier = ''
- # A unique identification for the text.
- #epub_uid = ''
- # HTML files that should be inserted before the pages created by sphinx.
- # The format is a list of tuples containing the path and title.
- #epub_pre_files = []
- # HTML files that should be inserted after the pages created by sphinx.
- # The format is a list of tuples containing the path and title.
- #epub_post_files = []
- # A list of files that should not be packed into the epub file.
- epub_exclude_files = [
- ('search.html', 'Search'),
- ]
- # The depth of the table of contents in toc.ncx.
- #epub_tocdepth = 3
- # Allow duplicate toc entries.
- #epub_tocdup = True
- todo_include_todos = True
- intersphinx_mapping = {
- 'python': ('https://docs.python.org/3', None),
- }
- plantuml_output_format = 'svg'
- plantuml_latex_output_format = 'pdf'
- def setup(app):
- app.add_stylesheet('custom.css')
|