init
This commit is contained in:
parent
b96d554b05
commit
9e39217423
35 changed files with 1465 additions and 0 deletions
79
src/sphinx_victorykit_theme/__init__.py
Normal file
79
src/sphinx_victorykit_theme/__init__.py
Normal file
|
|
@ -0,0 +1,79 @@
|
|||
"""
|
||||
Sphinx victory-k.it theme.
|
||||
|
||||
From https://bitbucket.org/victorykit/sphinx-victorykit-theme.
|
||||
"""
|
||||
|
||||
from os import path
|
||||
from sys import version_info as python_version
|
||||
|
||||
from sphinx import version_info as sphinx_version
|
||||
from sphinx.locale import _
|
||||
from sphinx.util.logging import getLogger
|
||||
|
||||
|
||||
__version__ = '2.0.1alpha1'
|
||||
__version_full__ = __version__
|
||||
|
||||
logger = getLogger(__name__)
|
||||
|
||||
|
||||
def get_html_theme_path():
|
||||
"""Return list of HTML theme paths."""
|
||||
cur_dir = path.abspath(path.dirname(path.dirname(__file__)))
|
||||
return cur_dir
|
||||
|
||||
|
||||
def config_initiated(app, config):
|
||||
theme_options = config.html_theme_options or {}
|
||||
if theme_options.get('canonical_url'):
|
||||
logger.warning(
|
||||
_('The canonical_url option is deprecated, use the html_baseurl option from Sphinx instead.')
|
||||
)
|
||||
|
||||
|
||||
def extend_html_context(app, pagename, templatename, context, doctree):
|
||||
# Add ``sphinx_version_info`` tuple for use in Jinja templates
|
||||
context['sphinx_version_info'] = sphinx_version
|
||||
|
||||
|
||||
# See http://www.sphinx-doc.org/en/stable/theming.html#distribute-your-theme-as-a-python-package
|
||||
def setup(app):
|
||||
if python_version[0] < 3:
|
||||
logger.error("Python 2 is not supported with tiararodneycom_theme, update to Python 3.")
|
||||
|
||||
app.require_sphinx('5.0')
|
||||
if app.config.html4_writer:
|
||||
logger.error("'html4_writer' is not supported with victorykit_theme.")
|
||||
|
||||
# Since Sphinx 6, jquery isn't bundled anymore and we need to ensure that
|
||||
# the sphinxcontrib-jquery extension is enabled.
|
||||
# See: https://dev.readthedocs.io/en/latest/design/sphinx-jquery.html
|
||||
# if sphinx_version >= (6, 0, 0):
|
||||
# # Documentation of Sphinx guarantees that an extension is added and
|
||||
# # enabled at most once.
|
||||
# # See: https://www.sphinx-doc.org/en/master/extdev/appapi.html#sphinx.application.Sphinx.setup_extension
|
||||
# app.setup_extension("sphinxcontrib.jquery")
|
||||
# # However, we need to call the extension's callback since setup_extension doesn't do it
|
||||
# # See: https://github.com/sphinx-contrib/jquery/issues/23
|
||||
# from sphinxcontrib.jquery import add_js_files as jquery_add_js_files
|
||||
# jquery_add_js_files(app, app.config)
|
||||
|
||||
# Register the theme that can be referenced without adding a theme path
|
||||
app.add_html_theme('victorykit', path.abspath(path.dirname(__file__)))
|
||||
|
||||
# Add Sphinx message catalog for newer versions of Sphinx
|
||||
# See http://www.sphinx-doc.org/en/master/extdev/appapi.html#sphinx.application.Sphinx.add_message_catalog
|
||||
rtd_locale_path = path.join(path.abspath(path.dirname(__file__)), 'locale')
|
||||
app.add_message_catalog('sphinx', rtd_locale_path)
|
||||
app.connect('config-inited', config_initiated)
|
||||
|
||||
app.add_js_file('main.js')
|
||||
|
||||
# sphinx emits the permalink icon for headers, so choose one more in keeping with our theme
|
||||
app.config.html_permalinks_icon = "\uf0c1"
|
||||
|
||||
# Extend the default context when rendering the templates.
|
||||
app.connect("html-page-context", extend_html_context)
|
||||
|
||||
return {'parallel_read_safe': True, 'parallel_write_safe': True}
|
||||
11
src/sphinx_victorykit_theme/changes/frameset.html
Normal file
11
src/sphinx_victorykit_theme/changes/frameset.html
Normal file
|
|
@ -0,0 +1,11 @@
|
|||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Frameset//EN"
|
||||
"http://www.w3.org/TR/html4/frameset.dtd">
|
||||
<html{% if language is not none %} lang="{{ language }}"{% endif %}>
|
||||
<head>
|
||||
<title>{% trans version=version|e, docstitle=docstitle|e %}Changes in Version {{ version }} — {{ docstitle }}{% endtrans %}</title>
|
||||
</head>
|
||||
<frameset cols="45%,*">
|
||||
<frame name="main" src="changes.html">
|
||||
<frame name="src" src="about:blank">
|
||||
</frameset>
|
||||
</html>
|
||||
15
src/sphinx_victorykit_theme/changes/rstsource.html
Normal file
15
src/sphinx_victorykit_theme/changes/rstsource.html
Normal file
|
|
@ -0,0 +1,15 @@
|
|||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
|
||||
"http://www.w3.org/TR/html4/loose.dtd">
|
||||
<html{% if language is not none %} lang="{{ language }}"{% endif %}>
|
||||
<head>
|
||||
<title>{% trans filename=filename, docstitle=docstitle|e %}{{ filename }} — {{ docstitle }}{% endtrans %}</title>
|
||||
<style type="text/css">
|
||||
.hl { background-color: yellow }
|
||||
</style>
|
||||
</head>
|
||||
<body style="font-size: 90%">
|
||||
<pre>
|
||||
{{ text }}
|
||||
</pre>
|
||||
</body>
|
||||
</html>
|
||||
33
src/sphinx_victorykit_theme/changes/versionchanges.html
Normal file
33
src/sphinx_victorykit_theme/changes/versionchanges.html
Normal file
|
|
@ -0,0 +1,33 @@
|
|||
{% macro entries(changes) %}
|
||||
<ul>{% for entry, docname, lineno in changes %}
|
||||
<li><a href="rst/{{ docname }}.html#L{{ lineno-10 }}" target="src">{{ entry }}</a></li>
|
||||
{% endfor %}</ul>
|
||||
{% endmacro -%}
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
|
||||
"http://www.w3.org/TR/html4/loose.dtd">
|
||||
<html{% if language is not none %} lang="{{ language }}"{% endif %}>
|
||||
<head>
|
||||
<link rel="stylesheet" href="default.css">
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
|
||||
<title>{% trans version=version|e, docstitle=docstitle|e %}Changes in Version {{ version }} — {{ docstitle }}{% endtrans %}</title>
|
||||
</head>
|
||||
<body>
|
||||
<div class="document">
|
||||
<div class="body">
|
||||
<h1>{% trans version=version|e %}Automatically generated list of changes in version {{ version }}{% endtrans %}</h1>
|
||||
<h2>{{ _('Library changes') }}</h2>
|
||||
{% for modname, changes in libchanges %}
|
||||
<h4>{{ modname }}</h4>
|
||||
{{ entries(changes) }}
|
||||
{% endfor %}
|
||||
<h2>{{ _('C API changes') }}</h2>
|
||||
{{ entries(apichanges) }}
|
||||
<h2>{{ _('Other changes') }}</h2>
|
||||
{% for (fn, title), changes in otherchanges %}
|
||||
<h4>{{ title }} <span style="font-size: 50%">({{ fn }})</span></h4>
|
||||
{{ entries(changes) }}
|
||||
{% endfor %}
|
||||
</div>
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
35
src/sphinx_victorykit_theme/defindex.html
Normal file
35
src/sphinx_victorykit_theme/defindex.html
Normal file
|
|
@ -0,0 +1,35 @@
|
|||
{#
|
||||
basic/defindex.html
|
||||
~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
Default template for the "index" page.
|
||||
|
||||
:copyright: Copyright 2007-2023 by the Sphinx team, see AUTHORS.
|
||||
:license: BSD, see LICENSE for details.
|
||||
#}{{ warn('Now base template defindex.html is deprecated.') }}
|
||||
{%- extends "layout.html" %}
|
||||
{% set title = _('Overview') %}
|
||||
{% block body %}
|
||||
<h1>{{ docstitle|e }}</h1>
|
||||
<p>
|
||||
{{ _('Welcome! This is') }}
|
||||
{% block description %}{{ _('the documentation for') }} {{ project|e }}
|
||||
{{ release|e }}{% if last_updated %}, {{ _('last updated') }} {{ last_updated|e }}{% endif %}{% endblock %}.
|
||||
</p>
|
||||
{% block tables %}
|
||||
<p><strong>{{ _('Indices and tables:') }}</strong></p>
|
||||
<table class="contentstable"><tr>
|
||||
<td style="width: 50%">
|
||||
<p class="biglink"><a class="biglink" href="{{ pathto("contents") }}">{{ _('Complete Table of Contents') }}</a><br>
|
||||
<span class="linkdescr">{{ _('lists all sections and subsections') }}</span></p>
|
||||
<p class="biglink"><a class="biglink" href="{{ pathto("search") }}">{{ _('Search Page') }}</a><br>
|
||||
<span class="linkdescr">{{ _('search this documentation') }}</span></p>
|
||||
</td><td style="width: 50%">
|
||||
<p class="biglink"><a class="biglink" href="{{ pathto("modindex") }}">{{ _('Global Module Index') }}</a><br>
|
||||
<span class="linkdescr">{{ _('quick access to all modules') }}</span></p>
|
||||
<p class="biglink"><a class="biglink" href="{{ pathto("genindex") }}">{{ _('General Index') }}</a><br>
|
||||
<span class="linkdescr">{{ _('all functions, classes, terms') }}</span></p>
|
||||
</td></tr>
|
||||
</table>
|
||||
{% endblock %}
|
||||
{% endblock %}
|
||||
56
src/sphinx_victorykit_theme/domainindex.html
Normal file
56
src/sphinx_victorykit_theme/domainindex.html
Normal file
|
|
@ -0,0 +1,56 @@
|
|||
{#
|
||||
basic/domainindex.html
|
||||
~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
Template for domain indices (module index, ...).
|
||||
|
||||
:copyright: Copyright 2007-2023 by the Sphinx team, see AUTHORS.
|
||||
:license: BSD, see LICENSE for details.
|
||||
#}
|
||||
{%- extends "layout.html" %}
|
||||
{% set title = indextitle %}
|
||||
{% block extrahead %}
|
||||
{{ super() }}
|
||||
{% if not embedded and collapse_index %}
|
||||
<script>
|
||||
DOCUMENTATION_OPTIONS.COLLAPSE_INDEX = true;
|
||||
</script>
|
||||
{% endif %}
|
||||
{% endblock %}
|
||||
{% block body %}
|
||||
|
||||
{%- set groupid = idgen() %}
|
||||
|
||||
<h1>{{ indextitle }}</h1>
|
||||
|
||||
<div class="modindex-jumpbox">
|
||||
{%- for (letter, entries) in content %}
|
||||
<a href="#cap-{{ letter }}"><strong>{{ letter }}</strong></a>
|
||||
{%- if not loop.last %} | {% endif %}
|
||||
{%- endfor %}
|
||||
</div>
|
||||
|
||||
<table class="indextable modindextable">
|
||||
{%- for letter, entries in content %}
|
||||
<tr class="pcap"><td></td><td> </td><td></td></tr>
|
||||
<tr class="cap" id="cap-{{ letter }}"><td></td><td>
|
||||
<strong>{{ letter }}</strong></td><td></td></tr>
|
||||
{%- for (name, grouptype, page, anchor, extra, qualifier, description)
|
||||
in entries %}
|
||||
<tr{% if grouptype == 2 %} class="cg-{{ groupid.current() }}"{% endif %}>
|
||||
<td>{% if grouptype == 1 -%}
|
||||
<img src="{{ pathto('_static/minus.png', 1) }}" class="toggler"
|
||||
id="toggle-{{ groupid.next() }}" style="display: none" alt="-" />
|
||||
{%- endif %}</td>
|
||||
<td>{% if grouptype == 2 %}   {% endif %}
|
||||
{% if page %}<a href="{{ pathto(page)|e }}#{{ anchor }}">{% endif -%}
|
||||
<code class="xref">{{ name|e }}</code>
|
||||
{%- if page %}</a>{% endif %}
|
||||
{%- if extra %} <em>({{ extra|e }})</em>{% endif -%}
|
||||
</td><td>{% if qualifier %}<strong>{{ qualifier|e }}:</strong>{% endif %}
|
||||
<em>{{ description|e }}</em></td></tr>
|
||||
{%- endfor %}
|
||||
{%- endfor %}
|
||||
</table>
|
||||
|
||||
{% endblock %}
|
||||
63
src/sphinx_victorykit_theme/genindex-single.html
Normal file
63
src/sphinx_victorykit_theme/genindex-single.html
Normal file
|
|
@ -0,0 +1,63 @@
|
|||
{#
|
||||
basic/genindex-single.html
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
Template for a "single" page of a split index.
|
||||
|
||||
:copyright: Copyright 2007-2023 by the Sphinx team, see AUTHORS.
|
||||
:license: BSD, see LICENSE for details.
|
||||
#}
|
||||
{% macro indexentries(firstname, links) %}
|
||||
{%- if links -%}
|
||||
<a href="{{ links[0][1] }}">
|
||||
{%- if links[0][0] %}<strong>{% endif -%}
|
||||
{{ firstname|e }}
|
||||
{%- if links[0][0] %}</strong>{% endif -%}
|
||||
</a>
|
||||
|
||||
{%- for ismain, link in links[1:] -%}
|
||||
, <a href="{{ link }}">{% if ismain %}<strong>{% endif -%}
|
||||
[{{ loop.index }}]
|
||||
{%- if ismain %}</strong>{% endif -%}
|
||||
</a>
|
||||
{%- endfor %}
|
||||
{%- else %}
|
||||
{{ firstname|e }}
|
||||
{%- endif %}
|
||||
{% endmacro %}
|
||||
|
||||
{%- extends "layout.html" %}
|
||||
{% set title = _('Index') %}
|
||||
{% block body %}
|
||||
|
||||
<h1 id="index">{% trans key=key %}Index – {{ key }}{% endtrans %}</h1>
|
||||
|
||||
<table style="width: 100%" class="indextable"><tr>
|
||||
{%- for column in entries|slice(2) if column %}
|
||||
<td style="width: 33%; vertical-align: top;"><ul>
|
||||
{%- for entryname, (links, subitems, _) in column %}
|
||||
<li>{{ indexentries(entryname, links) }}
|
||||
{%- if subitems %}
|
||||
<ul>
|
||||
{%- for subentryname, subentrylinks in subitems %}
|
||||
<li>{{ indexentries(subentryname, subentrylinks) }}</li>
|
||||
{%- endfor %}
|
||||
</ul>
|
||||
{%- endif -%}</li>
|
||||
{%- endfor %}
|
||||
</ul></td>
|
||||
{%- endfor %}
|
||||
</tr></table>
|
||||
|
||||
{% endblock %}
|
||||
|
||||
{% block sidebarrel %}
|
||||
<h4>{{ _('Index') }}</h4>
|
||||
<p>{% for key, dummy in genindexentries -%}
|
||||
<a href="{{ pathto('genindex-' + key) }}"><strong>{{ key }}</strong></a>
|
||||
{% if not loop.last %}| {% endif %}
|
||||
{%- endfor %}</p>
|
||||
|
||||
<p><a href="{{ pathto('genindex-all') }}"><strong>{{ _('Full index on one page') }}</strong></a></p>
|
||||
{{ super() }}
|
||||
{% endblock %}
|
||||
41
src/sphinx_victorykit_theme/genindex-split.html
Normal file
41
src/sphinx_victorykit_theme/genindex-split.html
Normal file
|
|
@ -0,0 +1,41 @@
|
|||
{#
|
||||
basic/genindex-split.html
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
Template for a "split" index overview page.
|
||||
|
||||
:copyright: Copyright 2007-2023 by the Sphinx team, see AUTHORS.
|
||||
:license: BSD, see LICENSE for details.
|
||||
#}
|
||||
{%- extends "layout.html" %}
|
||||
{% set title = _('Index') %}
|
||||
{% block body %}
|
||||
|
||||
<h1 id="index">{{ _('Index') }}</h1>
|
||||
|
||||
<p>{{ _('Index pages by letter') }}:</p>
|
||||
|
||||
<div class="genindex-jumpbox">
|
||||
<p>{% for key, dummy in genindexentries -%}
|
||||
<a href="{{ pathto('genindex-' + key) }}"><strong>{{ key }}</strong></a>
|
||||
{% if not loop.last %}| {% endif %}
|
||||
{%- endfor %}</p>
|
||||
|
||||
<p><a href="{{ pathto('genindex-all') }}"><strong>{{ _('Full index on one page') }}</strong>
|
||||
({{ _('can be huge') }})</a></p>
|
||||
</div>
|
||||
|
||||
{% endblock %}
|
||||
|
||||
{% block sidebarrel %}
|
||||
{% if split_index %}
|
||||
<h4>Index</h4>
|
||||
<p>{% for key, dummy in genindexentries -%}
|
||||
<a href="{{ pathto('genindex-' + key) }}"><strong>{{ key }}</strong></a>
|
||||
{% if not loop.last %}| {% endif %}
|
||||
{%- endfor %}</p>
|
||||
|
||||
<p><a href="{{ pathto('genindex-all') }}"><strong>{{ _('Full index on one page') }}</strong></a></p>
|
||||
{% endif %}
|
||||
{{ super() }}
|
||||
{% endblock %}
|
||||
76
src/sphinx_victorykit_theme/genindex.html
Normal file
76
src/sphinx_victorykit_theme/genindex.html
Normal file
|
|
@ -0,0 +1,76 @@
|
|||
{#
|
||||
basic/genindex.html
|
||||
~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
Template for an "all-in-one" index.
|
||||
|
||||
:copyright: Copyright 2007-2023 by the Sphinx team, see AUTHORS.
|
||||
:license: BSD, see LICENSE for details.
|
||||
#}
|
||||
{%- extends "layout.html" %}
|
||||
{% set title = _('Index') %}
|
||||
|
||||
{% macro indexentries(firstname, links) %}
|
||||
{%- if links -%}
|
||||
<a href="{{ links[0][1] }}">
|
||||
{%- if links[0][0] %}<strong>{% endif -%}
|
||||
{{ firstname|e }}
|
||||
{%- if links[0][0] %}</strong>{% endif -%}
|
||||
</a>
|
||||
|
||||
{%- for ismain, link in links[1:] -%}
|
||||
, <a href="{{ link }}">{% if ismain %}<strong>{% endif -%}
|
||||
[{{ loop.index }}]
|
||||
{%- if ismain %}</strong>{% endif -%}
|
||||
</a>
|
||||
{%- endfor %}
|
||||
{%- else %}
|
||||
{{ firstname|e }}
|
||||
{%- endif %}
|
||||
{% endmacro %}
|
||||
|
||||
{% block body %}
|
||||
|
||||
<h1 id="index">{{ _('Index') }}</h1>
|
||||
|
||||
<div class="genindex-jumpbox">
|
||||
{% for key, dummy in genindexentries -%}
|
||||
<a href="#{{ key }}"><strong>{{ key }}</strong></a>
|
||||
{% if not loop.last %}| {% endif %}
|
||||
{%- endfor %}
|
||||
</div>
|
||||
|
||||
{%- for key, entries in genindexentries %}
|
||||
<h2 id="{{ key }}">{{ key }}</h2>
|
||||
<table style="width: 100%" class="indextable genindextable"><tr>
|
||||
{%- for column in entries|slice_index(2) if column %}
|
||||
<td style="width: 33%; vertical-align: top;"><ul>
|
||||
{%- for entryname, (links, subitems, _) in column %}
|
||||
<li>{{ indexentries(entryname, links) }}
|
||||
{%- if subitems %}
|
||||
<ul>
|
||||
{%- for subentryname, subentrylinks in subitems %}
|
||||
<li>{{ indexentries(subentryname, subentrylinks) }}</li>
|
||||
{%- endfor %}
|
||||
</ul>
|
||||
{%- endif -%}</li>
|
||||
{%- endfor %}
|
||||
</ul></td>
|
||||
{%- endfor %}
|
||||
</tr></table>
|
||||
{% endfor %}
|
||||
|
||||
{% endblock %}
|
||||
|
||||
{% block sidebarrel %}
|
||||
{% if split_index %}
|
||||
<h4>{{ _('Index') }}</h4>
|
||||
<p>{% for key, dummy in genindexentries -%}
|
||||
<a href="{{ pathto('genindex-' + key) }}"><strong>{{ key }}</strong></a>
|
||||
{% if not loop.last %}| {% endif %}
|
||||
{%- endfor %}</p>
|
||||
|
||||
<p><a href="{{ pathto('genindex-all') }}"><strong>{{ _('Full index on one page') }}</strong></a></p>
|
||||
{% endif %}
|
||||
{{ super() }}
|
||||
{% endblock %}
|
||||
11
src/sphinx_victorykit_theme/globaltoc.html
Normal file
11
src/sphinx_victorykit_theme/globaltoc.html
Normal file
|
|
@ -0,0 +1,11 @@
|
|||
{#
|
||||
basic/globaltoc.html
|
||||
~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
Sphinx sidebar template: global table of contents.
|
||||
|
||||
:copyright: Copyright 2007-2023 by the Sphinx team, see AUTHORS.
|
||||
:license: BSD, see LICENSE for details.
|
||||
#}
|
||||
<h3><a href="{{ pathto(root_doc)|e }}">{{ _('Table of Contents') }}</a></h3>
|
||||
{{ toctree(includehidden=theme_globaltoc_includehidden, collapse=theme_globaltoc_collapse, maxdepth=theme_globaltoc_maxdepth) }}
|
||||
219
src/sphinx_victorykit_theme/layout.html
Normal file
219
src/sphinx_victorykit_theme/layout.html
Normal file
|
|
@ -0,0 +1,219 @@
|
|||
{#
|
||||
basic/layout.html
|
||||
~~~~~~~~~~~~~~~~~
|
||||
|
||||
Master layout template for Sphinx themes.
|
||||
|
||||
:copyright: Copyright 2007-2023 by the Sphinx team, see AUTHORS.
|
||||
:license: BSD, see LICENSE for details.
|
||||
#}
|
||||
{%- block doctype -%}
|
||||
<!DOCTYPE html>
|
||||
{%- endblock %}
|
||||
{%- set reldelim1 = reldelim1 is not defined and ' »' or reldelim1 %}
|
||||
{%- set reldelim2 = reldelim2 is not defined and ' |' or reldelim2 %}
|
||||
{%- set render_sidebar = (not embedded) and (not theme_nosidebar|tobool) and
|
||||
(sidebars != []) %}
|
||||
{# URL root should never be #, then all links are fragments #}
|
||||
{%- if not embedded and docstitle %}
|
||||
{%- set titlesuffix = " — "|safe + docstitle|e %}
|
||||
{%- else %}
|
||||
{%- set titlesuffix = "" %}
|
||||
{%- endif %}
|
||||
|
||||
{%- macro relbar() %}
|
||||
<div class="related" role="navigation" aria-label="related navigation">
|
||||
<h3>{{ _('Navigation') }}</h3>
|
||||
<ul>
|
||||
{%- for rellink in rellinks %}
|
||||
<li class="right" {% if loop.first %}style="margin-right: 10px"{% endif %}>
|
||||
<a href="{{ pathto(rellink[0])|e }}" title="{{ rellink[1]|striptags|e }}"
|
||||
{{ accesskey(rellink[2]) }}>{{ rellink[3] }}</a>
|
||||
{%- if not loop.first %}{{ reldelim2 }}{% endif %}</li>
|
||||
{%- endfor %}
|
||||
{%- block rootrellink %}
|
||||
<li class="nav-item nav-item-0"><a href="{{ pathto(root_doc)|e }}">{{ shorttitle|e }}</a>{{ reldelim1 }}</li>
|
||||
{%- endblock %}
|
||||
{%- for parent in parents %}
|
||||
<li class="nav-item nav-item-{{ loop.index }}"><a href="{{ parent.link|e }}" {% if loop.last %}{{ accesskey("U") }}{% endif %}>{{ parent.title }}</a>{{ reldelim1 }}</li>
|
||||
{%- endfor %}
|
||||
<li class="nav-item nav-item-this"><a href="{{ link|e }}">{{ title }}</a></li>
|
||||
{%- block relbaritems %} {% endblock %}
|
||||
</ul>
|
||||
</div>
|
||||
{%- endmacro %}
|
||||
|
||||
{%- macro sidebar() %}
|
||||
{%- if render_sidebar %}
|
||||
<div class="sphinxsidebar" role="navigation" aria-label="main navigation">
|
||||
<div class="sphinxsidebarwrapper">
|
||||
{%- block sidebarlogo %}
|
||||
{%- if logo_url %}
|
||||
<p class="logo"><a href="{{ pathto(root_doc)|e }}">
|
||||
<img class="logo" src="{{ logo_url|e }}" alt="Logo"/>
|
||||
</a></p>
|
||||
{%- endif %}
|
||||
{%- endblock %}
|
||||
{%- if sidebars != None %}
|
||||
{#- new style sidebar: explicitly include/exclude templates #}
|
||||
{%- for sidebartemplate in sidebars %}
|
||||
{%- include sidebartemplate %}
|
||||
{%- endfor %}
|
||||
{%- else %}
|
||||
{#- old style sidebars: using blocks -- should be deprecated #}
|
||||
{%- block sidebartoc %}
|
||||
{%- include "localtoc.html" %}
|
||||
{%- endblock %}
|
||||
{%- block sidebarrel %}
|
||||
{%- include "relations.html" %}
|
||||
{%- endblock %}
|
||||
{%- block sidebarsourcelink %}
|
||||
{%- include "sourcelink.html" %}
|
||||
{%- endblock %}
|
||||
{%- if customsidebar %}
|
||||
{%- include customsidebar %}
|
||||
{%- endif %}
|
||||
{%- block sidebarsearch %}
|
||||
{%- include "searchbox.html" %}
|
||||
{%- endblock %}
|
||||
{%- endif %}
|
||||
</div>
|
||||
{%- block sidebarextra %}{%- endblock %}
|
||||
</div>
|
||||
{%- endif %}
|
||||
{%- endmacro %}
|
||||
|
||||
{%- macro script() %}
|
||||
{%- for js in script_files %}
|
||||
{{ js_tag(js) }}
|
||||
{%- endfor %}
|
||||
{%- endmacro %}
|
||||
|
||||
{%- macro css() %}
|
||||
{%- for css in css_files %}
|
||||
{%- if css|attr("filename") %}
|
||||
{{ css_tag(css) }}
|
||||
{%- else %}
|
||||
<link rel="stylesheet" href="{{ pathto(css, 1)|e }}" type="text/css" />
|
||||
{%- endif %}
|
||||
{%- endfor %}
|
||||
{%- endmacro %}
|
||||
|
||||
{%- if html_tag %}
|
||||
{{ html_tag }}
|
||||
{%- else %}
|
||||
<html{% if language is not none %} lang="{{ language }}"{% endif %} data-content_root="{{ content_root }}">
|
||||
{%- endif %}
|
||||
<head>
|
||||
<meta charset="{{ encoding }}" />
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
||||
{{- metatags }}
|
||||
{%- block htmltitle %}
|
||||
<title>{{ title|striptags|e }}{{ titlesuffix }}</title>
|
||||
{%- endblock %}
|
||||
{%- block css %}
|
||||
{{- css() }}
|
||||
{%- endblock %}
|
||||
{%- if not embedded %}
|
||||
{%- block scripts %}
|
||||
{{- script() }}
|
||||
{%- endblock %}
|
||||
{%- if pageurl %}
|
||||
<link rel="canonical" href="{{ pageurl|e }}" />
|
||||
{%- endif %}
|
||||
{%- if use_opensearch %}
|
||||
<link rel="search" type="application/opensearchdescription+xml"
|
||||
title="{% trans docstitle=docstitle|e %}Search within {{ docstitle }}{% endtrans %}"
|
||||
href="{{ pathto('_static/opensearch.xml', 1) }}"/>
|
||||
{%- endif %}
|
||||
{%- if favicon_url %}
|
||||
<link rel="icon" href="{{ favicon_url|e }}"/>
|
||||
{%- endif %}
|
||||
{%- endif %}
|
||||
{%- block linktags %}
|
||||
{%- if hasdoc('about') %}
|
||||
<link rel="author" title="{{ _('About these documents') }}" href="{{ pathto('about') }}" />
|
||||
{%- endif %}
|
||||
{%- if hasdoc('genindex') %}
|
||||
<link rel="index" title="{{ _('Index') }}" href="{{ pathto('genindex') }}" />
|
||||
{%- endif %}
|
||||
{%- if hasdoc('search') %}
|
||||
<link rel="search" title="{{ _('Search') }}" href="{{ pathto('search') }}" />
|
||||
{%- endif %}
|
||||
{%- if hasdoc('copyright') %}
|
||||
<link rel="copyright" title="{{ _('Copyright') }}" href="{{ pathto('copyright') }}" />
|
||||
{%- endif %}
|
||||
{%- if next %}
|
||||
<link rel="next" title="{{ next.title|striptags|e }}" href="{{ next.link|e }}" />
|
||||
{%- endif %}
|
||||
{%- if prev %}
|
||||
<link rel="prev" title="{{ prev.title|striptags|e }}" href="{{ prev.link|e }}" />
|
||||
{%- endif %}
|
||||
{%- endblock %}
|
||||
{%- block extrahead %} {% endblock %}
|
||||
</head>
|
||||
{%- block body_tag %}<body>{% endblock %}
|
||||
<div class="flex-master-container">
|
||||
{%- block header %}{% endblock %}
|
||||
|
||||
{%- block relbar1 %}{{ relbar() }}{% endblock %}
|
||||
|
||||
{%- block content %}
|
||||
{%- block sidebar1 %} {# possible location for sidebar #} {% endblock %}
|
||||
|
||||
<div class="document">
|
||||
{%- block document %}
|
||||
<div class="documentwrapper">
|
||||
{%- if render_sidebar %}
|
||||
<div class="bodywrapper">
|
||||
{%- endif %}
|
||||
<div class="body" role="main">
|
||||
{% block body %} {% endblock %}
|
||||
<div class="clearer"></div>
|
||||
</div>
|
||||
{%- if render_sidebar %}
|
||||
</div>
|
||||
{%- endif %}
|
||||
</div>
|
||||
{%- endblock %}
|
||||
|
||||
{%- block sidebar2 %}{{ sidebar() }}{% endblock %}
|
||||
<div class="clearer"></div>
|
||||
</div>
|
||||
{%- endblock %}
|
||||
|
||||
|
||||
{%- macro copyright_block() %}
|
||||
{%- if hasdoc('copyright') %}
|
||||
{%- set copyright_prefix = '<a href="' + pathto('copyright') + '">' + _('Copyright') + '</a>' -%}
|
||||
{%- else %}
|
||||
{%- set copyright_prefix = _('Copyright') %}
|
||||
{%- endif %}
|
||||
{%- if copyright is iterable and copyright is not string %}
|
||||
{% for copyright_line in copyright %}
|
||||
{% trans trimmed copyright_prefix=copyright_prefix, copyright=copyright_line|e %}
|
||||
© {{ copyright_prefix }} {{ copyright }}.
|
||||
{% endtrans %}
|
||||
{%- if not loop.last %}<br/>{%- endif %}
|
||||
{% endfor %}
|
||||
{%- else %}
|
||||
{% trans trimmed copyright_prefix=copyright_prefix, copyright=copyright|e %}
|
||||
© {{ copyright_prefix }} {{ copyright }}.
|
||||
{% endtrans %}
|
||||
{%- endif %}
|
||||
{%- endmacro %}
|
||||
</div>
|
||||
|
||||
{%- block footer %}
|
||||
<div class="footer" role="contentinfo">
|
||||
{%- block relbar2 %}{{ relbar() }}{% endblock %}
|
||||
{%- if show_copyright %}
|
||||
{{- copyright_block() -}}
|
||||
{%- endif %}
|
||||
{%- if last_updated %}
|
||||
{% trans last_updated=last_updated|e %}Last updated on {{ last_updated }}.{% endtrans %}
|
||||
{%- endif %}
|
||||
</div>
|
||||
{%- endblock %}
|
||||
</body>
|
||||
</html>
|
||||
15
src/sphinx_victorykit_theme/localtoc.html
Normal file
15
src/sphinx_victorykit_theme/localtoc.html
Normal file
|
|
@ -0,0 +1,15 @@
|
|||
{#
|
||||
basic/localtoc.html
|
||||
~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
Sphinx sidebar template: local table of contents.
|
||||
|
||||
:copyright: Copyright 2007-2023 by the Sphinx team, see AUTHORS.
|
||||
:license: BSD, see LICENSE for details.
|
||||
#}
|
||||
{%- if display_toc %}
|
||||
<div>
|
||||
<h3><a href="{{ pathto(root_doc)|e }}">{{ _('Table of Contents') }}</a></h3>
|
||||
{{ toc }}
|
||||
</div>
|
||||
{%- endif %}
|
||||
1
src/sphinx_victorykit_theme/main.js
Normal file
1
src/sphinx_victorykit_theme/main.js
Normal file
|
|
@ -0,0 +1 @@
|
|||
(()=>{"use strict";console.log("Hello World! 222")})();
|
||||
13
src/sphinx_victorykit_theme/opensearch.xml
Normal file
13
src/sphinx_victorykit_theme/opensearch.xml
Normal file
|
|
@ -0,0 +1,13 @@
|
|||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<OpenSearchDescription xmlns="http://a9.com/-/spec/opensearch/1.1/">
|
||||
<ShortName>{{ project|e }}</ShortName>
|
||||
<Description>{% trans docstitle=docstitle|e %}Search {{ docstitle }}{% endtrans %}</Description>
|
||||
<InputEncoding>utf-8</InputEncoding>
|
||||
<Url type="text/html" method="get"
|
||||
template="{{ use_opensearch }}/{{ pathto('search') }}?q={searchTerms}"/>
|
||||
<LongName>{{ docstitle|e }}</LongName>
|
||||
{%- if favicon_url %}
|
||||
<Image height="16" width="16" type="image/x-icon">{{ use_opensearch }}/{{ favicon_url|e }}</Image>
|
||||
{%- endif %}
|
||||
{% block extra %} {# Put e.g. an <Image> element here. #} {% endblock %}
|
||||
</OpenSearchDescription>
|
||||
13
src/sphinx_victorykit_theme/page.html
Normal file
13
src/sphinx_victorykit_theme/page.html
Normal file
|
|
@ -0,0 +1,13 @@
|
|||
{#
|
||||
basic/page.html
|
||||
~~~~~~~~~~~~~~~
|
||||
|
||||
Master template for simple pages.
|
||||
|
||||
:copyright: Copyright 2007-2023 by the Sphinx team, see AUTHORS.
|
||||
:license: BSD, see LICENSE for details.
|
||||
#}
|
||||
{%- extends "layout.html" %}
|
||||
{% block body %}
|
||||
{{ body }}
|
||||
{% endblock %}
|
||||
23
src/sphinx_victorykit_theme/relations.html
Normal file
23
src/sphinx_victorykit_theme/relations.html
Normal file
|
|
@ -0,0 +1,23 @@
|
|||
{#
|
||||
basic/relations.html
|
||||
~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
Sphinx sidebar template: relation links.
|
||||
|
||||
:copyright: Copyright 2007-2023 by the Sphinx team, see AUTHORS.
|
||||
:license: BSD, see LICENSE for details.
|
||||
#}
|
||||
{%- if prev %}
|
||||
<div>
|
||||
<h4>{{ _('Previous topic') }}</h4>
|
||||
<p class="topless"><a href="{{ prev.link|e }}"
|
||||
title="{{ _('previous chapter') }}">{{ prev.title }}</a></p>
|
||||
</div>
|
||||
{%- endif %}
|
||||
{%- if next %}
|
||||
<div>
|
||||
<h4>{{ _('Next topic') }}</h4>
|
||||
<p class="topless"><a href="{{ next.link|e }}"
|
||||
title="{{ _('next chapter') }}">{{ next.title }}</a></p>
|
||||
</div>
|
||||
{%- endif %}
|
||||
65
src/sphinx_victorykit_theme/search.html
Normal file
65
src/sphinx_victorykit_theme/search.html
Normal file
|
|
@ -0,0 +1,65 @@
|
|||
{#
|
||||
basic/search.html
|
||||
~~~~~~~~~~~~~~~~~
|
||||
|
||||
Template for the search page.
|
||||
|
||||
:copyright: Copyright 2007-2023 by the Sphinx team, see AUTHORS.
|
||||
:license: BSD, see LICENSE for details.
|
||||
#}
|
||||
{%- extends "layout.html" %}
|
||||
{% set title = _('Search') %}
|
||||
{%- block scripts %}
|
||||
{{ super() }}
|
||||
<script src="{{ pathto('_static/searchtools.js', 1) }}"></script>
|
||||
<script src="{{ pathto('_static/language_data.js', 1) }}"></script>
|
||||
{%- endblock %}
|
||||
{% block extrahead %}
|
||||
<script src="{{ pathto('searchindex.js', 1) }}" defer></script>
|
||||
{{ super() }}
|
||||
{% endblock %}
|
||||
{% block body %}
|
||||
<h1 id="search-documentation">{{ _('Search') }}</h1>
|
||||
{% block scriptwarning %}
|
||||
<noscript>
|
||||
<div class="admonition warning">
|
||||
<p>
|
||||
{% trans %}Please activate JavaScript to enable the search
|
||||
functionality.{% endtrans %}
|
||||
</p>
|
||||
</div>
|
||||
</noscript>
|
||||
{% endblock %}
|
||||
{% block searchtext %}
|
||||
<p>
|
||||
{% trans %}Searching for multiple words only shows matches that contain
|
||||
all words.{% endtrans %}
|
||||
</p>
|
||||
{% endblock %}
|
||||
{% block searchbox %}
|
||||
<form action="" method="get">
|
||||
<input type="text" name="q" aria-labelledby="search-documentation" value="" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
|
||||
<input type="submit" value="{{ _('search') }}" />
|
||||
<span id="search-progress" style="padding-left: 10px"></span>
|
||||
</form>
|
||||
{% endblock %}
|
||||
{% block searchresults %}
|
||||
{% if search_performed %}
|
||||
<h2>{{ _('Search Results') }}</h2>
|
||||
{% if not search_results %}
|
||||
<p>{{ _('Your search did not match any documents. Please make sure that all words are spelled correctly and that you\'ve selected enough categories.') }}</p>
|
||||
{% endif %}
|
||||
{% endif %}
|
||||
<div id="search-results">
|
||||
{% if search_results %}
|
||||
<ul>
|
||||
{% for href, caption, context in search_results %}
|
||||
<li><a href="{{ pathto(item.href) }}">{{ caption }}</a>
|
||||
<div class="context">{{ context|e }}</div>
|
||||
</li>
|
||||
{% endfor %}
|
||||
</ul>
|
||||
{% endif %}
|
||||
</div>
|
||||
{% endblock %}
|
||||
{% endblock %}
|
||||
21
src/sphinx_victorykit_theme/searchbox.html
Normal file
21
src/sphinx_victorykit_theme/searchbox.html
Normal file
|
|
@ -0,0 +1,21 @@
|
|||
{#
|
||||
basic/searchbox.html
|
||||
~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
Sphinx sidebar template: quick search box.
|
||||
|
||||
:copyright: Copyright 2007-2023 by the Sphinx team, see AUTHORS.
|
||||
:license: BSD, see LICENSE for details.
|
||||
#}
|
||||
{%- if pagename != "search" and builder != "singlehtml" %}
|
||||
<div id="searchbox" style="display: none" role="search">
|
||||
<h3 id="searchlabel">{{ _('Quick search') }}</h3>
|
||||
<div class="searchformwrapper">
|
||||
<form class="search" action="{{ pathto('search') }}" method="get">
|
||||
<input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
|
||||
<input type="submit" value="{{ _('Go') }}" />
|
||||
</form>
|
||||
</div>
|
||||
</div>
|
||||
<script>document.getElementById('searchbox').style.display = "block"</script>
|
||||
{%- endif %}
|
||||
23
src/sphinx_victorykit_theme/searchfield.html
Normal file
23
src/sphinx_victorykit_theme/searchfield.html
Normal file
|
|
@ -0,0 +1,23 @@
|
|||
{#
|
||||
basic/searchfield.html
|
||||
~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
Sphinx sidebar template: search field.
|
||||
This component is similar to searchbox.html but does not include an
|
||||
extra heading ("Quick search"). Instead, it uses a placeholder text
|
||||
in the search field.
|
||||
|
||||
:copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
|
||||
:license: BSD, see LICENSE for details.
|
||||
#}
|
||||
{%- if pagename != "search" and builder != "singlehtml" %}
|
||||
<div id="searchbox" style="display: none" role="search">
|
||||
<div class="searchformwrapper">
|
||||
<form class="search" action="{{ pathto('search') }}" method="get">
|
||||
<input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false" placeholder="Search"/>
|
||||
<input type="submit" value="{{ _('Go') }}" />
|
||||
</form>
|
||||
</div>
|
||||
</div>
|
||||
<script>document.getElementById('searchbox').style.display = "block"</script>
|
||||
{%- endif %}
|
||||
18
src/sphinx_victorykit_theme/sourcelink.html
Normal file
18
src/sphinx_victorykit_theme/sourcelink.html
Normal file
|
|
@ -0,0 +1,18 @@
|
|||
{#
|
||||
basic/sourcelink.html
|
||||
~~~~~~~~~~~~~~~~~~~~~
|
||||
|
||||
Sphinx sidebar template: "show source" link.
|
||||
|
||||
:copyright: Copyright 2007-2023 by the Sphinx team, see AUTHORS.
|
||||
:license: BSD, see LICENSE for details.
|
||||
#}
|
||||
{%- if show_source and has_source and sourcename %}
|
||||
<div role="note" aria-label="source link">
|
||||
<h3>{{ _('This Page') }}</h3>
|
||||
<ul class="this-page-menu">
|
||||
<li><a href="{{ pathto('_sources/' + sourcename, true)|e }}"
|
||||
rel="nofollow">{{ _('Show Source') }}</a></li>
|
||||
</ul>
|
||||
</div>
|
||||
{%- endif %}
|
||||
16
src/sphinx_victorykit_theme/theme.conf
Normal file
16
src/sphinx_victorykit_theme/theme.conf
Normal file
|
|
@ -0,0 +1,16 @@
|
|||
[theme]
|
||||
inherit = none
|
||||
stylesheet = main.css
|
||||
pygments_style = none
|
||||
sidebars = localtoc.html, relations.html, sourcelink.html, searchbox.html
|
||||
|
||||
[options]
|
||||
nosidebar = false
|
||||
sidebarwidth = 230
|
||||
body_min_width = 360
|
||||
body_max_width = 800
|
||||
navigation_with_keys = False
|
||||
enable_search_shortcuts = True
|
||||
globaltoc_collapse = true
|
||||
globaltoc_includehidden = false
|
||||
globaltoc_maxdepth =
|
||||
Loading…
Add table
Add a link
Reference in a new issue