<!DOCTYPE html> <html lang="en" > <!-- Mirrored from geohelm.docs.acugis.com/en/latest/configuring.html by HTTrack Website Copier/3.x [XR&CO'2014], Thu, 13 Jul 2023 23:23:26 GMT --> <!-- Added by HTTrack --><meta http-equiv="content-type" content="text/html;charset=utf-8" /><!-- /Added by HTTrack --> <head> <meta charset="utf-8"> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <title>Configuration — AcuGIS GeoHelm 0.4.3 documentation</title> <!-- AcuGIS 1 --> <!--[if lt IE 9]> <script src="_static/js/html5shiv.min.js"></script> <![endif]--> <script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script> <script type="text/javascript" src="_static/jquery.js"></script> <script type="text/javascript" src="_static/underscore.js"></script> <script type="text/javascript" src="_static/doctools.js"></script> <script type="text/javascript" src="_static/language_data.js"></script> <script async="async" type="text/javascript" src="../../_/static/javascript/readthedocs-doc-embed.js"></script> <script type="text/javascript" src="_static/js/theme.js"></script> <link rel="stylesheet" href="_static/css/theme.css" type="text/css" /> <link rel="stylesheet" href="_static/pygments.css" type="text/css" /> <link rel="stylesheet" href="_static/custom.css" type="text/css" /> <link rel="index" title="Index" href="genindex.html" /> <link rel="search" title="Search" href="search.html" /> <!-- RTD Extra Head --> <link rel="stylesheet" href="../../_/static/css/readthedocs-doc-embed.css" type="text/css" /> <script type="application/json" id="READTHEDOCS_DATA">{"ad_free": false, "api_host": "https://readthedocs.org", "builder": "sphinx", "canonical_url": null, "docroot": "/docs/", "features": {"docsearch_disabled": false}, "global_analytics_code": "UA-17997319-1", "language": "en", "page": "configuring", "programming_language": "perl", "project": "geohelm", "proxied_api_host": "/_", "source_suffix": ".rst", "subprojects": {}, "theme": "sphinx_rtd_theme", "user_analytics_code": "", "version": "latest"}</script> <!-- Using this variable directly instead of using `JSON.parse` is deprecated. The READTHEDOCS_DATA global variable will be removed in the future. --> <script type="text/javascript"> READTHEDOCS_DATA = JSON.parse(document.getElementById('READTHEDOCS_DATA').innerHTML); </script> <script type="text/javascript" src="../../_/static/javascript/readthedocs-analytics.js" async="async"></script> <!-- end RTD <extrahead> --> </head> <div id="header" style="position: fixed; height: 70px; padding-bottom: 20px; overflow: hidden; background-color: #28728d; display: block; z-index: 1000; width: 100%;"> <div class="acugis_geosuite" style="color:#fff!important; padding-left:30px; font-size:26px; padding-top: 20px;"><a href="https://geohelm.docs.acugis.com/" style="color:#fff!important; text-decoration:none!important">AcuGIS GeoHelm</a></div> </div> </div> <body class="wy-body-for-nav"> <div class="wy-grid-for-nav"> <nav data-toggle="wy-nav-shift" class="wy-nav-side"> <div class="wy-side-scroll"> <div id="header2"> </div> <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation" style="padding-top: 45px;"> <p class="caption"><span class="caption-text">Getting Started</span></p> <ul> <li class="toctree-l1"><a class="reference internal" href="intro.html">Intro</a></li> <li class="toctree-l1"><a class="reference internal" href="installing.html">Installation</a></li> <li class="toctree-l1"><a class="reference internal" href="layout.html">Layout</a></li> <li class="toctree-l1"><a class="reference internal" href="webmin.html">Control Panel</a></li> <li class="toctree-l1"><a class="reference internal" href="webmin.html#removing-the-control-panel">Removing the Control Panel</a></li> </ul> <p class="caption"><span class="caption-text">PostGIS</span></p> <ul> <li class="toctree-l1"><a class="reference internal" href="components/createdb/index.html">Create Database</a></li> <li class="toctree-l1"><a class="reference internal" href="components/postgresql/index.html">PostgreSQL</a></li> <li class="toctree-l1"><a class="reference internal" href="components/postgis/index.html">PostGIS</a></li> <li class="toctree-l1"><a class="reference internal" href="components/pgrouting/index.html">PgRouting</a></li> <li class="toctree-l1"><a class="reference internal" href="components/shp2pgsql/index.html">shp2pgsql</a></li> <li class="toctree-l1"><a class="reference internal" href="components/osm2pgsql/index.html">osm2pgsql</a></li> <li class="toctree-l1"><a class="reference internal" href="components/raster2pgsql/index.html">raster2pgsql</a></li> </ul> <p class="caption"><span class="caption-text">GeoServer</span></p> <ul> <li class="toctree-l1"><a class="reference internal" href="geoserver/admin/index.html">Access</a></li> <li class="toctree-l1"><a class="reference internal" href="geoserver/geoservers/index.html">Overview</a></li> <li class="toctree-l1"><a class="reference internal" href="geoserver/tomcat/index.html">Apache Tomcat</a></li> <li class="toctree-l1"><a class="reference internal" href="geoserver/workspace/index.html">Create a Workspace</a></li> <li class="toctree-l1"><a class="reference internal" href="geoserver/store/index.html">Create Store</a></li> <li class="toctree-l1"><a class="reference internal" href="geoserver/layer/index.html">Add Layer</a></li> <li class="toctree-l1"><a class="reference internal" href="geoserver/shp/index.html">Load ESRI Shapefile</a></li> <li class="toctree-l1"><a class="reference internal" href="geoserver/styles/index.html">Styles</a></li> </ul> <p class="caption"><span class="caption-text">pg_tileserv</span></p> <ul> <li class="toctree-l1"><a class="reference internal" href="components/pgtileserv/index.html">pg_tileserv</a></li> <li class="toctree-l1"><a class="reference internal" href="components/pgfeatureserv/index.html">pg_featureserv</a></li> </ul> <p class="caption"><span class="caption-text">Database Operations</span></p> <ul> <li class="toctree-l1"><a class="reference internal" href="database/snapshot/index.html">Database Snapshots</a></li> <li class="toctree-l1"><a class="reference internal" href="database/clone/index.html">Clone Database</a></li> <li class="toctree-l1"><a class="reference internal" href="database/restore/index.html">Restore Database</a></li> </ul> <p class="caption"><span class="caption-text">QGIS</span></p> <ul> <li class="toctree-l1"><a class="reference internal" href="qgis/home.html">Introduction</a></li> <li class="toctree-l1"><a class="reference internal" href="qgis/pgservice.html">pg_service.conf</a></li> <li class="toctree-l1"><a class="reference internal" href="qgis/qgis.html">Create a QGIS Project</a></li> <li class="toctree-l1"><a class="reference internal" href="qgis/publish.html">Publish Layers</a></li> <li class="toctree-l1"><a class="reference internal" href="qgis/style-only.html">Publish Styles Only</a></li> </ul> <p class="caption"><span class="caption-text">LeafletJS</span></p> <ul> <li class="toctree-l1"><a class="reference internal" href="apps/choropleth.html">Leaflet Choropleth App</a></li> <li class="toctree-l1"><a class="reference internal" href="apps/geojson.html">Leaflet GeoJson</a></li> <li class="toctree-l1"><a class="reference internal" href="apps/php.html">Leaflet and PHP</a></li> </ul> <p class="caption"><span class="caption-text">Resources</span></p> <ul> <li class="toctree-l1"><a class="reference internal" href="resources/documents.html">Documentation</a></li> <li class="toctree-l1"><a class="reference internal" href="resources/css.html">CSS</a></li> <li class="toctree-l1"><a class="reference internal" href="resources/security.html">Security</a></li> <li class="toctree-l1"><a class="reference internal" href="resources/nagios.html">Nagios</a></li> <li class="toctree-l1"><a class="reference internal" href="resources/support.html">Project Support</a></li> <li class="toctree-l1"><a class="reference internal" href="resources/commercial.html">Commercial Support</a></li> <li class="toctree-l1"><a class="reference internal" href="resources/license.html">License</a></li> </ul> </div> </div> </nav> <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"> <nav class="wy-nav-top" aria-label="top navigation"> <i data-toggle="wy-nav-top" class="fa fa-bars"></i> <a href="index-2.html">AcuGIS GeoHelm</a> </nav> <div class="wy-nav-content"> <div class="rst-content"> <div role="navigation" aria-label="breadcrumbs navigation"> <ul class="wy-breadcrumbs"> <li><a href="index-2.html" class="icon icon-home"></a> »</li> <li>Configuration</li> <li class="wy-breadcrumbs-aside"> <a href="https://github.com/AcuGIS/GeoHelm/blob/master/docs/configuring.rst" class="fa fa-github"> Edit on GitHub</a> </li> </ul> <hr/> </div> <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article"> <div itemprop="articleBody"> <div class="section" id="configuration"> <h1>Configuration<a class="headerlink" href="#configuration" title="Permalink to this headline">¶</a></h1> <div class="section" id="theme-options"> <h2>Theme options<a class="headerlink" href="#theme-options" title="Permalink to this headline">¶</a></h2> <p>The following options can be defined in your project’s <code class="docutils literal notranslate"><span class="pre">conf.py</span></code> file, using the <a class="reference external" href="https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-html_theme_options" title="(in Sphinx v7.1.0)"><code class="xref std std-confval docutils literal notranslate"><span class="pre">html_theme_options</span></code></a> configuration option.</p> <p>For example:</p> <div class="code python highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">html_theme_options</span> <span class="o">=</span> <span class="p">{</span> <span class="s1">'canonical_url'</span><span class="p">:</span> <span class="s1">''</span><span class="p">,</span> <span class="s1">'analytics_id'</span><span class="p">:</span> <span class="s1">'UA-XXXXXXX-1'</span><span class="p">,</span> <span class="c1"># Provided by Google in your dashboard</span> <span class="s1">'logo_only'</span><span class="p">:</span> <span class="kc">False</span><span class="p">,</span> <span class="s1">'display_version'</span><span class="p">:</span> <span class="kc">True</span><span class="p">,</span> <span class="s1">'prev_next_buttons_location'</span><span class="p">:</span> <span class="s1">'bottom'</span><span class="p">,</span> <span class="s1">'style_external_links'</span><span class="p">:</span> <span class="kc">False</span><span class="p">,</span> <span class="s1">'vcs_pageview_mode'</span><span class="p">:</span> <span class="s1">''</span><span class="p">,</span> <span class="s1">'style_nav_header_background'</span><span class="p">:</span> <span class="s1">'white'</span><span class="p">,</span> <span class="c1"># Toc options</span> <span class="s1">'collapse_navigation'</span><span class="p">:</span> <span class="kc">True</span><span class="p">,</span> <span class="s1">'sticky_navigation'</span><span class="p">:</span> <span class="kc">True</span><span class="p">,</span> <span class="s1">'navigation_depth'</span><span class="p">:</span> <span class="mi">4</span><span class="p">,</span> <span class="s1">'includehidden'</span><span class="p">:</span> <span class="kc">True</span><span class="p">,</span> <span class="s1">'titles_only'</span><span class="p">:</span> <span class="kc">False</span> <span class="p">}</span> </pre></div> </div> <div class="section" id="table-of-contents-options"> <h3>Table of contents options<a class="headerlink" href="#table-of-contents-options" title="Permalink to this headline">¶</a></h3> <p>The following options change how <a class="reference external" href="https://www.sphinx-doc.org/en/master/usage/restructuredtext/directives.html#directive-toctree" title="(in Sphinx v7.1.0)"><code class="docutils literal notranslate"><span class="pre">toctree</span></code></a> directives generate documentation navigation.</p> <dl class="confval"> <dt id="confval-collapse_navigation"> <code class="descname">collapse_navigation</code><a class="headerlink" href="#confval-collapse_navigation" title="Permalink to this definition">¶</a></dt> <dd><table class="docutils field-list" frame="void" rules="none"> <col class="field-name" /> <col class="field-body" /> <tbody valign="top"> <tr class="field-odd field"><th class="field-name">Type:</th><td class="field-body">boolean</td> </tr> <tr class="field-even field"><th class="field-name">Default:</th><td class="field-body"><code class="docutils literal notranslate"><span class="pre">True</span></code></td> </tr> </tbody> </table> <p>With this enabled, navigation entries are not expandable – the <code class="docutils literal notranslate"><span class="pre">[+]</span></code> icons next to each entry are removed.</p> </dd></dl> <dl class="confval"> <dt id="confval-sticky_navigation"> <code class="descname">sticky_navigation</code><a class="headerlink" href="#confval-sticky_navigation" title="Permalink to this definition">¶</a></dt> <dd><table class="docutils field-list" frame="void" rules="none"> <col class="field-name" /> <col class="field-body" /> <tbody valign="top"> <tr class="field-odd field"><th class="field-name">Type:</th><td class="field-body">boolean</td> </tr> <tr class="field-even field"><th class="field-name">Default:</th><td class="field-body"><code class="docutils literal notranslate"><span class="pre">True</span></code></td> </tr> </tbody> </table> <p>Scroll the navigation with the main page content as you scroll the page.</p> </dd></dl> <dl class="confval"> <dt id="confval-navigation_depth"> <code class="descname">navigation_depth</code><a class="headerlink" href="#confval-navigation_depth" title="Permalink to this definition">¶</a></dt> <dd><table class="docutils field-list" frame="void" rules="none"> <col class="field-name" /> <col class="field-body" /> <tbody valign="top"> <tr class="field-odd field"><th class="field-name">Type:</th><td class="field-body">integer</td> </tr> <tr class="field-even field"><th class="field-name">Default:</th><td class="field-body"><code class="docutils literal notranslate"><span class="pre">4</span></code></td> </tr> </tbody> </table> <p>The maximum depth of the table of contents tree. Set this to <code class="docutils literal notranslate"><span class="pre">-1</span></code> to allow unlimited depth.</p> </dd></dl> <dl class="confval"> <dt id="confval-includehidden"> <code class="descname">includehidden</code><a class="headerlink" href="#confval-includehidden" title="Permalink to this definition">¶</a></dt> <dd><table class="docutils field-list" frame="void" rules="none"> <col class="field-name" /> <col class="field-body" /> <tbody valign="top"> <tr class="field-odd field"><th class="field-name">Type:</th><td class="field-body">boolean</td> </tr> <tr class="field-even field"><th class="field-name">Default:</th><td class="field-body"><code class="docutils literal notranslate"><span class="pre">True</span></code></td> </tr> </tbody> </table> <p>Specifies if the navigation includes hidden table(s) of contents – that is, any <a class="reference external" href="https://www.sphinx-doc.org/en/master/usage/restructuredtext/directives.html#directive-toctree" title="(in Sphinx v7.1.0)"><code class="docutils literal notranslate"><span class="pre">toctree</span></code></a> directive that is marked with the <code class="docutils literal notranslate"><span class="pre">:hidden:</span></code> option.</p> </dd></dl> <dl class="confval"> <dt id="confval-titles_only"> <code class="descname">titles_only</code><a class="headerlink" href="#confval-titles_only" title="Permalink to this definition">¶</a></dt> <dd><table class="docutils field-list" frame="void" rules="none"> <col class="field-name" /> <col class="field-body" /> <tbody valign="top"> <tr class="field-odd field"><th class="field-name">Type:</th><td class="field-body">boolean</td> </tr> <tr class="field-even field"><th class="field-name">Default:</th><td class="field-body">False</td> </tr> </tbody> </table> <p>When enabled, page subheadings are not included in the navigation.</p> </dd></dl> <div class="admonition note"> <p class="first admonition-title">Note</p> <p class="last">Setting <a class="reference internal" href="#confval-collapse_navigation"><code class="xref std std-confval docutils literal notranslate"><span class="pre">collapse_navigation</span></code></a> to <code class="docutils literal notranslate"><span class="pre">False</span></code> and using a high value for <a class="reference internal" href="#confval-navigation_depth"><code class="xref std std-confval docutils literal notranslate"><span class="pre">navigation_depth</span></code></a> on projects with many files and a deep file structure can cause long compilation times and can result in HTML files that are significantly larger in file size.</p> </div> </div> <div class="section" id="miscellaneous-options"> <h3>Miscellaneous options<a class="headerlink" href="#miscellaneous-options" title="Permalink to this headline">¶</a></h3> <dl class="confval"> <dt id="confval-analytics_id"> <code class="descname">analytics_id</code><a class="headerlink" href="#confval-analytics_id" title="Permalink to this definition">¶</a></dt> <dd><table class="docutils field-list" frame="void" rules="none"> <col class="field-name" /> <col class="field-body" /> <tbody valign="top"> <tr class="field-odd field"><th class="field-name">Type:</th><td class="field-body">string</td> </tr> </tbody> </table> <p>If specified, Google Analytics’ javascript is included in your pages. Set the value to the ID provided to you by google (like <code class="docutils literal notranslate"><span class="pre">UA-XXXXXXX</span></code>).</p> </dd></dl> <dl class="confval"> <dt id="confval-canonical_url"> <code class="descname">canonical_url</code><a class="headerlink" href="#confval-canonical_url" title="Permalink to this definition">¶</a></dt> <dd><table class="docutils field-list" frame="void" rules="none"> <col class="field-name" /> <col class="field-body" /> <tbody valign="top"> <tr class="field-odd field"><th class="field-name">Type:</th><td class="field-body">URL</td> </tr> </tbody> </table> <p>This will specify a <a class="reference external" href="https://en.wikipedia.org/wiki/Canonical_link_element">canonical URL</a> meta link element to tell search engines which URL should be ranked as the primary URL for your documentation. This is important if you have multiple URLs that your documentation is available through. The URL points to the root path of the documentation and requires a trailing slash.</p> </dd></dl> <dl class="confval"> <dt id="confval-display_version"> <code class="descname">display_version</code><a class="headerlink" href="#confval-display_version" title="Permalink to this definition">¶</a></dt> <dd><table class="docutils field-list" frame="void" rules="none"> <col class="field-name" /> <col class="field-body" /> <tbody valign="top"> <tr class="field-odd field"><th class="field-name">Type:</th><td class="field-body">boolean</td> </tr> <tr class="field-even field"><th class="field-name">Default:</th><td class="field-body"><code class="docutils literal notranslate"><span class="pre">True</span></code></td> </tr> </tbody> </table> <p>If <code class="docutils literal notranslate"><span class="pre">True</span></code>, the version number is shown at the top of the sidebar.</p> </dd></dl> <dl class="confval"> <dt id="confval-logo_only"> <code class="descname">logo_only</code><a class="headerlink" href="#confval-logo_only" title="Permalink to this definition">¶</a></dt> <dd><table class="docutils field-list" frame="void" rules="none"> <col class="field-name" /> <col class="field-body" /> <tbody valign="top"> <tr class="field-odd field"><th class="field-name">Type:</th><td class="field-body">boolean</td> </tr> <tr class="field-even field"><th class="field-name">Default:</th><td class="field-body"><code class="docutils literal notranslate"><span class="pre">False</span></code></td> </tr> </tbody> </table> <p>Only display the logo image, do not display the project name at the top of the sidebar</p> </dd></dl> <dl class="confval"> <dt id="confval-prev_next_buttons_location"> <code class="descname">prev_next_buttons_location</code><a class="headerlink" href="#confval-prev_next_buttons_location" title="Permalink to this definition">¶</a></dt> <dd><table class="docutils field-list" frame="void" rules="none"> <col class="field-name" /> <col class="field-body" /> <tbody valign="top"> <tr class="field-odd field"><th class="field-name">Type:</th><td class="field-body">string</td> </tr> <tr class="field-even field"><th class="field-name">Default:</th><td class="field-body"><code class="docutils literal notranslate"><span class="pre">bottom</span></code></td> </tr> </tbody> </table> <p>Location to display <span class="guilabel">Next</span> and <span class="guilabel">Previous</span> buttons. This can be either <code class="docutils literal notranslate"><span class="pre">bottom</span></code>, <code class="docutils literal notranslate"><span class="pre">top</span></code>, <code class="docutils literal notranslate"><span class="pre">both</span></code> , or <code class="docutils literal notranslate"><span class="pre">None</span></code>.</p> </dd></dl> <dl class="confval"> <dt id="confval-style_external_links"> <code class="descname">style_external_links</code><a class="headerlink" href="#confval-style_external_links" title="Permalink to this definition">¶</a></dt> <dd><table class="docutils field-list" frame="void" rules="none"> <col class="field-name" /> <col class="field-body" /> <tbody valign="top"> <tr class="field-odd field"><th class="field-name">Type:</th><td class="field-body">boolean</td> </tr> <tr class="field-even field"><th class="field-name">Default:</th><td class="field-body"><code class="docutils literal notranslate"><span class="pre">False</span></code></td> </tr> </tbody> </table> <p>Add an icon next to external links.</p> </dd></dl> <dl class="confval"> <dt id="confval-vcs_pageview_mode"> <code class="descname">vcs_pageview_mode</code><a class="headerlink" href="#confval-vcs_pageview_mode" title="Permalink to this definition">¶</a></dt> <dd><table class="docutils field-list" frame="void" rules="none"> <col class="field-name" /> <col class="field-body" /> <tbody valign="top"> <tr class="field-odd field"><th class="field-name">Type:</th><td class="field-body">string</td> </tr> <tr class="field-even field"><th class="field-name">Default:</th><td class="field-body"><code class="docutils literal notranslate"><span class="pre">blob</span></code> or <code class="docutils literal notranslate"><span class="pre">view</span></code></td> </tr> </tbody> </table> <p>Changes how to view files when using <code class="docutils literal notranslate"><span class="pre">display_github</span></code>, <code class="docutils literal notranslate"><span class="pre">display_gitlab</span></code>, etc. When using GitHub or GitLab this can be: <code class="docutils literal notranslate"><span class="pre">blob</span></code> (default), <code class="docutils literal notranslate"><span class="pre">edit</span></code>, or <code class="docutils literal notranslate"><span class="pre">raw</span></code>. On Bitbucket, this can be either: <code class="docutils literal notranslate"><span class="pre">view</span></code> (default) or <code class="docutils literal notranslate"><span class="pre">edit</span></code>.</p> </dd></dl> <dl class="confval"> <dt id="confval-style_nav_header_background"> <code class="descname">style_nav_header_background</code><a class="headerlink" href="#confval-style_nav_header_background" title="Permalink to this definition">¶</a></dt> <dd><table class="docutils field-list" frame="void" rules="none"> <col class="field-name" /> <col class="field-body" /> <tbody valign="top"> <tr class="field-odd field"><th class="field-name">Type:</th><td class="field-body">string</td> </tr> <tr class="field-even field"><th class="field-name">Default:</th><td class="field-body"><code class="docutils literal notranslate"><span class="pre">#2980B9</span></code></td> </tr> </tbody> </table> <p>Changes the background of the search area in the navigation bar. The value can be anything valid in a CSS <cite>background</cite> property.</p> </dd></dl> </div> </div> <div class="section" id="file-wide-metadata"> <h2>File-wide metadata<a class="headerlink" href="#file-wide-metadata" title="Permalink to this headline">¶</a></h2> <p>The following options can be used as <a class="reference external" href="https://www.sphinx-doc.org/en/master/usage/restructuredtext/field-lists.html#metadata" title="(in Sphinx v7.1.0)"><span class="xref std std-ref">file-wide metadata</span></a>:</p> <dl class="confval"> <dt id="confval-github_url"> <code class="descname">github_url</code><a class="headerlink" href="#confval-github_url" title="Permalink to this definition">¶</a></dt> <dd><p>Force the <span class="guilabel">Edit on GitHub</span> button to use the configured URL.</p> </dd></dl> <dl class="confval"> <dt id="confval-bitbucket_url"> <code class="descname">bitbucket_url</code><a class="headerlink" href="#confval-bitbucket_url" title="Permalink to this definition">¶</a></dt> <dd><p>Force the <span class="guilabel">Edit on Bitbucket</span> button to use the configured URL.</p> </dd></dl> <dl class="confval"> <dt id="confval-gitlab_url"> <code class="descname">gitlab_url</code><a class="headerlink" href="#confval-gitlab_url" title="Permalink to this definition">¶</a></dt> <dd><p>Force the <span class="guilabel">Edit on GitLab</span> button to use the configured URL.</p> </dd></dl> </div> <div class="section" id="other-configuration"> <h2>Other configuration<a class="headerlink" href="#other-configuration" title="Permalink to this headline">¶</a></h2> <div class="section" id="adding-a-logo"> <h3>Adding a logo<a class="headerlink" href="#adding-a-logo" title="Permalink to this headline">¶</a></h3> <p>Using the Sphinx standard option <a class="reference external" href="https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-html_logo" title="(in Sphinx v7.1.0)"><code class="xref std std-confval docutils literal notranslate"><span class="pre">html_logo</span></code></a>, you can set an image file to be used as a logo at the top of the sidebar. The theme option <a class="reference internal" href="#confval-logo_only"><code class="xref std std-confval docutils literal notranslate"><span class="pre">logo_only</span></code></a> also allows for <em>only</em> the logo to be shown at the top of the sidebar.</p> </div> <div class="section" id="adding-custom-css-or-javascript"> <h3>Adding custom CSS or Javascript<a class="headerlink" href="#adding-custom-css-or-javascript" title="Permalink to this headline">¶</a></h3> <p>Adding custom CSS or Javascript can help you alter the look and feel of this theme without forking the theme for local use.</p> <p>In order to add custom CSS or Javascript without disrupting the existing theme files, you can <a class="reference external" href="https://docs.readthedocs.io/en/latest/guides/adding-custom-css.html" title="(in Read the Docs user documentation v9.16.0)"><span class="xref std std-doc">add files to be included in your documentation output</span></a>.</p> </div> </div> <div class="section" id="how-the-table-of-contents-displays"> <h2>How the table of contents displays<a class="headerlink" href="#how-the-table-of-contents-displays" title="Permalink to this headline">¶</a></h2> <p>Currently the left menu will build based upon any <code class="docutils literal notranslate"><span class="pre">toctree</span></code> directives defined in your source files. It outputs 4 levels of depth by default, to allow for quick navigation through topics. If no TOC trees are defined, Sphinx’s default behavior is to use the page headings instead.</p> <p>It’s important to note that if you don’t follow the same styling for your reST headings across your documents, the TOC tree will build incorrectly, and the resulting menu might not show the correct depth when it renders.</p> <p>Also note that by default the table of contents is set with <code class="docutils literal notranslate"><span class="pre">includehidden=True</span></code>. This allows you to set a hidden TOC in your index file with the <a class="reference external" href="https://www.sphinx-doc.org/en/master/usage/restructuredtext/directives.html#toctree-directive" title="(in Sphinx v7.1.0)"><span class="xref std std-ref">:hidden:</span></a> property that will allow you to build a TOC without it rendering in your index.</p> <p>By default, the navigation will “stick” to the screen as you scroll. However if your TOC is not tall enough, it will revert to static positioning. To disable the sticky navigation altogether, change the <a class="reference internal" href="#confval-sticky_navigation"><code class="xref std std-confval docutils literal notranslate"><span class="pre">sticky_navigation</span></code></a> theme option.</p> </div> </div> </div> </div> <footer> <hr/> <div role="contentinfo"> <p> © Copyright acugis <span class="commit"> Revision <code>db2a027e</code>. </span> </p> </div> Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/rtfd/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org/">Read the Docs</a>. </footer> </div> </div> </section> </div> <div class="rst-versions" data-toggle="rst-versions" role="note" aria-label="versions"> <span class="rst-current-version" data-toggle="rst-current-version"> <span class="fa fa-book"> Read the Docs</span> v: latest <span class="fa fa-caret-down"></span> </span> <div class="rst-other-versions"> <dl> <dt>Versions</dt> <dd><a href="index.html">latest</a></dd> </dl> <dl> <dt>Downloads</dt> <dd><a href="http://geohelm.docs.acugis.com/_/downloads/en/latest/pdf/">pdf</a></dd> <dd><a href="http://geohelm.docs.acugis.com/_/downloads/en/latest/htmlzip/">html</a></dd> <dd><a href="http://geohelm.docs.acugis.com/_/downloads/en/latest/epub/">epub</a></dd> </dl> <dl> <dt>On Read the Docs</dt> <dd> <a href="http://readthedocs.org/projects/geohelm/?fromdocs=geohelm">Project Home</a> </dd> <dd> <a href="http://readthedocs.org/builds/geohelm/?fromdocs=geohelm">Builds</a> </dd> </dl> </div> </div> <script type="text/javascript"> jQuery(function () { SphinxRtdTheme.Navigation.enable(true); }); </script> </body> <!-- Mirrored from geohelm.docs.acugis.com/en/latest/configuring.html by HTTrack Website Copier/3.x [XR&CO'2014], Thu, 13 Jul 2023 23:23:26 GMT --> </html>