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")