Mercurial > repos > padge > clipkit
comparison clipkit_repo/docs/conf.py @ 0:49b058e85902 draft
"planemo upload for repository https://github.com/jlsteenwyk/clipkit commit cbe1e8577ecb1a46709034a40dff36052e876e7a-dirty"
| author | padge |
|---|---|
| date | Fri, 25 Mar 2022 13:04:31 +0000 |
| parents | |
| children |
comparison
equal
deleted
inserted
replaced
| -1:000000000000 | 0:49b058e85902 |
|---|---|
| 1 # -*- coding: utf-8 -*- | |
| 2 # | |
| 3 # Configuration file for the Sphinx documentation builder. | |
| 4 # | |
| 5 # This file does only contain a selection of the most common options. For a | |
| 6 # full list see the documentation: | |
| 7 # http://www.sphinx-doc.org/en/master/config | |
| 8 | |
| 9 import os | |
| 10 import sys | |
| 11 | |
| 12 from collections import OrderedDict | |
| 13 | |
| 14 # -- Path setup -------------------------------------------------------------- | |
| 15 | |
| 16 # If extensions (or modules to document with autodoc) are in another directory, | |
| 17 # add these directories to sys.path here. If the directory is relative to the | |
| 18 # documentation root, use os.path.abspath to make it absolute, like shown here. | |
| 19 # | |
| 20 # sys.path.append(os.path.abspath('_themes')) | |
| 21 sys.path.append(os.path.abspath("./_ext")) | |
| 22 | |
| 23 # -- Project information ----------------------------------------------------- | |
| 24 | |
| 25 project = "clipkit" | |
| 26 copyright = "2020 Jacob L. Steenwyk" | |
| 27 author = "Jacob L. Steenwyk <jlsteenwyk@gmail.com>" | |
| 28 | |
| 29 # The short X.Y version | |
| 30 # version = "0.0.1" | |
| 31 # The full version, including alpha/beta/rc tags | |
| 32 # release = "0.0.1-alpha" | |
| 33 | |
| 34 | |
| 35 # -- General configuration --------------------------------------------------- | |
| 36 | |
| 37 # If your documentation needs a minimal Sphinx version, state it here. | |
| 38 # | |
| 39 # needs_sphinx = '1.0' | |
| 40 | |
| 41 # Add any Sphinx extension module names here, as strings. They can be | |
| 42 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom | |
| 43 # ones. | |
| 44 extensions = ["sphinx.ext.githubpages"] | |
| 45 | |
| 46 # Add any paths that contain templates here, relative to this directory. | |
| 47 templates_path = ["_templates"] | |
| 48 | |
| 49 # The suffix(es) of source filenames. | |
| 50 # You can specify multiple suffix as a list of string: | |
| 51 # | |
| 52 # source_suffix = ['.rst', '.md'] | |
| 53 source_suffix = ".rst" | |
| 54 | |
| 55 # The master toctree document. | |
| 56 master_doc = "index" | |
| 57 | |
| 58 # The language for content autogenerated by Sphinx. Refer to documentation | |
| 59 # for a list of supported languages. | |
| 60 # | |
| 61 # This is also used if you do content translation via gettext catalogs. | |
| 62 # Usually you set "language" from the command line for these cases. | |
| 63 language = None | |
| 64 | |
| 65 # List of patterns, relative to source directory, that match files and | |
| 66 # directories to ignore when looking for source files. | |
| 67 # This pattern also affects html_static_path and html_extra_path. | |
| 68 exclude_patterns = ["_build", "Thumbs.db", ".DS_Store", "_ext"] | |
| 69 | |
| 70 # The name of the Pygments (syntax highlighting) style to use. | |
| 71 pygments_style = None | |
| 72 | |
| 73 | |
| 74 # -- Options for HTML output ------------------------------------------------- | |
| 75 # Favicon | |
| 76 html_favicon = "_static/img/flavicon.png" | |
| 77 | |
| 78 # The theme to use for HTML and HTML Help pages. See the documentation for | |
| 79 # a list of builtin themes. | |
| 80 # | |
| 81 html_theme = "sphinx_rtd_theme" | |
| 82 | |
| 83 # Theme options are theme-specific and customize the look and feel of a theme | |
| 84 # further. For a list of options available for each theme, see the | |
| 85 # documentation. | |
| 86 # | |
| 87 html_theme_options = { | |
| 88 "body_max_width": "900px", | |
| 89 'logo_only': True, | |
| 90 'analytics_id': 'UA-104875636-1' | |
| 91 } | |
| 92 html_logo = '_static/img/ClipKIT_logo_top_only_v1.png' | |
| 93 html_show_sourcelink = False | |
| 94 | |
| 95 # Add any paths that contain custom static files (such as style sheets) here, | |
| 96 # relative to this directory. They are copied after the builtin static files, | |
| 97 # so a file named "default.css" will overwrite the builtin "default.css". | |
| 98 html_static_path = ["_static"] | |
| 99 | |
| 100 # Custom sidebar templates, must be a dictionary that maps document names | |
| 101 # to template names. | |
| 102 # | |
| 103 # The default sidebars (for documents that don't match any pattern) are | |
| 104 # defined by theme itself. Builtin themes are using these templates by | |
| 105 # default: ``['localtoc.html', 'relations.html', 'sourcelink.html', | |
| 106 # 'searchbox.html']``. | |
| 107 # | |
| 108 html_sidebars = { | |
| 109 "**": [ | |
| 110 "sidebar-top.html", | |
| 111 "navigation.html", | |
| 112 "relations.html", # needs 'show_related': True theme option to display | |
| 113 "searchbox.html", | |
| 114 ] | |
| 115 } | |
| 116 | |
| 117 | |
| 118 # -- Options for HTMLHelp output --------------------------------------------- | |
| 119 | |
| 120 # Output file base name for HTML help builder. | |
| 121 htmlhelp_basename = "clipkitdoc" | |
| 122 | |
| 123 | |
| 124 # -- Options for LaTeX output ------------------------------------------------ | |
| 125 | |
| 126 latex_elements = { | |
| 127 # The paper size ('letterpaper' or 'a4paper'). | |
| 128 # | |
| 129 # 'papersize': 'letterpaper', | |
| 130 # The font size ('10pt', '11pt' or '12pt'). | |
| 131 # | |
| 132 # 'pointsize': '10pt', | |
| 133 # Additional stuff for the LaTeX preamble. | |
| 134 # | |
| 135 # 'preamble': '', | |
| 136 # Latex figure (float) alignment | |
| 137 # | |
| 138 # 'figure_align': 'htbp', | |
| 139 } | |
| 140 | |
| 141 # Grouping the document tree into LaTeX files. List of tuples | |
| 142 # (source start file, target name, title, | |
| 143 # author, documentclass [howto, manual, or own class]). | |
| 144 latex_documents = [ | |
| 145 ( | |
| 146 master_doc, | |
| 147 "clipkit.tex", | |
| 148 "clipkit Documentation", | |
| 149 "Jacob L. Steenwyk \\textless{}jlsteenwyk@gmail.com\\textgreater{}", | |
| 150 "manual", | |
| 151 ), | |
| 152 ] | |
| 153 | |
| 154 | |
| 155 # -- Options for manual page output ------------------------------------------ | |
| 156 | |
| 157 # One entry per manual page. List of tuples | |
| 158 # (source start file, name, description, authors, manual section). | |
| 159 man_pages = [(master_doc, "clipkit", "clipkit Documentation", [author], 1)] | |
| 160 | |
| 161 | |
| 162 # -- Options for Texinfo output ---------------------------------------------- | |
| 163 | |
| 164 # Grouping the document tree into Texinfo files. List of tuples | |
| 165 # (source start file, target name, title, author, | |
| 166 # dir menu entry, description, category) | |
| 167 texinfo_documents = [ | |
| 168 ( | |
| 169 master_doc, | |
| 170 "clipkit", | |
| 171 "clipkit Documentation", | |
| 172 author, | |
| 173 "clipkit", | |
| 174 "A data transformation engine.", | |
| 175 "Miscellaneous", | |
| 176 ), | |
| 177 ] | |
| 178 | |
| 179 | |
| 180 # -- Options for Epub output ------------------------------------------------- | |
| 181 | |
| 182 # Bibliographic Dublin Core info. | |
| 183 epub_title = project | |
| 184 | |
| 185 # The unique identifier of the text. This can be a ISBN number | |
| 186 # or the project homepage. | |
| 187 # | |
| 188 # epub_identifier = '' | |
| 189 | |
| 190 # A unique identification for the text. | |
| 191 # | |
| 192 # epub_uid = '' | |
| 193 | |
| 194 # A list of files that should not be packed into the epub file. | |
| 195 epub_exclude_files = ["search.html"] | |
| 196 | |
| 197 | |
| 198 # -- Setup ------------------------------------------------- | |
| 199 def setup(app): | |
| 200 app.add_css_file("custom.css") |
