diff --git a/docs/pylib/auto_link_remapper.py b/docs/pylib/auto_link_remapper.py index 665f0f04c5..3ab48719a3 100644 --- a/docs/pylib/auto_link_remapper.py +++ b/docs/pylib/auto_link_remapper.py @@ -61,7 +61,7 @@ _USED_REFS = {} _CURRFILE = None -def auto_link_remapper(): +def auto_link_remapper(no_autodoc=False): """ - Auto-Remaps links to fit with the actual document file structure. Requires all doc files to have a unique name. @@ -224,7 +224,8 @@ def auto_link_remapper(): with open(_TOC_FILE, "w") as fil: fil.write("# Toc\n") - fil.write("- [API root](api/evennia-api.rst)") + if not no_autodoc: + fil.write("- [API root](api/evennia-api.rst)") for ref in sorted(toc_map.values()): diff --git a/docs/source/_templates/layout.html b/docs/source/_templates/layout.html index efe58c7c39..36474e308d 100644 --- a/docs/source/_templates/layout.html +++ b/docs/source/_templates/layout.html @@ -1 +1,218 @@ -{%- extends "!layout.html" %} +{# + basic/layout.html + ~~~~~~~~~~~~~~~~~ + + Master layout template for Sphinx themes. + + :copyright: Copyright 2007-2020 by the Sphinx team, see AUTHORS. + :license: BSD, see LICENSE for details. +#} +{%- block doctype -%}{%- if html5_doctype %} + +{%- else %} + +{%- endif %}{%- 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 != []) %} +{%- set url_root = pathto('', 1) %} +{# XXX necessary? #} +{%- if url_root == '#' %}{% set url_root = '' %}{% endif %} +{%- if not embedded and docstitle %} + {%- set titlesuffix = " — "|safe + docstitle|e %} +{%- else %} + {%- set titlesuffix = "" %} +{%- endif %} + +{%- macro relbar() %} +
+{%- endmacro %} + +{%- macro sidebar() %} + {%- if render_sidebar %} + + {%- 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 %} + + {%- endif %} + {%- endfor %} +{%- endmacro %} + +{%- if html_tag %} +{{ html_tag }} +{%- else %} + +{%- endif %} + + {%- if not html5_doctype and not skip_ua_compatible %} + + {%- endif %} + {%- if use_meta_charset or html5_doctype %} + + {%- else %} + + {%- endif %} + + {{- metatags }} + {%- block htmltitle %} +