on master help sign in
Deploying to gh-pages from @ 925bb561a2797b6d3cc5be748c2361721b8e1f08 πŸš€
commit193c1491409ba13ba4a1332765a0debd8bd783ee authordalf <alex@al-f.net> dateSun 6 Dec 2020, 09:21 (6 years ago) parent30c62e6
15 files changed+84βˆ’84
_downloads/ad0ebe55d6b53b1559e0ca8dee6f30b9/reST.rst+12βˆ’12 _sources/admin/buildhosts.rst.txt+1βˆ’1 _sources/admin/installation-nginx.rst.txt+1βˆ’1 _sources/admin/settings.rst.txt+1βˆ’1 _sources/dev/contribution_guide.rst.txt+2βˆ’2 _sources/dev/engine_overview.rst.txt+1βˆ’1 _sources/dev/quickstart.rst.txt+1βˆ’1 _sources/dev/reST.rst.txt+12βˆ’12 admin/buildhosts.html+1βˆ’1 admin/installation-nginx.html+2βˆ’2 admin/settings.html+1βˆ’1 dev/contribution_guide.html+1βˆ’1 dev/engine_overview.html+1βˆ’1 dev/quickstart.html+1βˆ’1 dev/reST.html+46βˆ’46
_downloads/ad0ebe55d6b53b1559e0ca8dee6f30b9/reST.rst+12βˆ’12
@@ -1391,27 +1391,27 @@ The next example shows the difference of ``\tfrac`` (*textstyle*) and ``\dfrac``
13911391
13921392.. _readability: https://docs.python-guide.org/writing/style/
13931393.. _Sphinx-Primer:
1394βˆ’ http://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html
1394+ https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html
13951395.. _reST: https://docutils.sourceforge.io/rst.html
13961396.. _Sphinx Roles:
13971397 https://www.sphinx-doc.org/en/master/usage/restructuredtext/roles.html
1398βˆ’.. _Sphinx: http://www.sphinx-doc.org
1399βˆ’.. _`sphinx-doc FAQ`: http://www.sphinx-doc.org/en/stable/faq.html
1398+.. _Sphinx: https://www.sphinx-doc.org
1399+.. _`sphinx-doc FAQ`: https://www.sphinx-doc.org/en/stable/faq.html
14001400.. _Sphinx markup constructs:
1401βˆ’ http://www.sphinx-doc.org/en/stable/markup/index.html
1401+ https://www.sphinx-doc.org/en/stable/markup/index.html
14021402.. _`sphinx cross references`:
1403βˆ’ http://www.sphinx-doc.org/en/stable/markup/inline.html#cross-referencing-arbitrary-locations
1403+ https://www.sphinx-doc.org/en/stable/markup/inline.html#cross-referencing-arbitrary-locations
14041404.. _sphinx.ext.extlinks:
14051405 https://www.sphinx-doc.org/en/master/usage/extensions/extlinks.html
1406βˆ’.. _intersphinx: http://www.sphinx-doc.org/en/stable/ext/intersphinx.html
1407βˆ’.. _sphinx config: http://www.sphinx-doc.org/en/stable/config.html
1408βˆ’.. _Sphinx's autodoc: http://www.sphinx-doc.org/en/stable/ext/autodoc.html
1406+.. _intersphinx: https://www.sphinx-doc.org/en/stable/ext/intersphinx.html
1407+.. _sphinx config: https://www.sphinx-doc.org/en/stable/config.html
1408+.. _Sphinx's autodoc: https://www.sphinx-doc.org/en/stable/ext/autodoc.html
14091409.. _Sphinx's Python domain:
1410βˆ’ http://www.sphinx-doc.org/en/stable/domains.html#the-python-domain
1410+ https://www.sphinx-doc.org/en/stable/domains.html#the-python-domain
14111411.. _Sphinx's C domain:
1412βˆ’ http://www.sphinx-doc.org/en/stable/domains.html#cross-referencing-c-constructs
1412+ https://www.sphinx-doc.org/en/stable/domains.html#cross-referencing-c-constructs
14131413.. _doctree:
1414βˆ’ http://www.sphinx-doc.org/en/master/extdev/tutorial.html?highlight=doctree#build-phases
1414+ https://www.sphinx-doc.org/en/master/extdev/tutorial.html?highlight=doctree#build-phases
14151415.. _docutils: http://docutils.sourceforge.net/docs/index.html
14161416.. _docutils FAQ: http://docutils.sourceforge.net/FAQ.html
14171417.. _linuxdoc: https://return42.github.io/linuxdoc
@@ -1424,5 +1424,5 @@ The next example shows the difference of ``\tfrac`` (*textstyle*) and ``\dfrac``
14241424.. _ImageMagick: https://www.imagemagick.org
14251425
14261426.. _`Emacs Table Mode`: https://www.emacswiki.org/emacs/TableMode
1427βˆ’.. _`Online Tables Generator`: http://www.tablesgenerator.com/text_tables
1427+.. _`Online Tables Generator`: https://www.tablesgenerator.com/text_tables
14281428.. _`OASIS XML Exchange Table Model`: https://www.oasis-open.org/specs/tm9901.html
_sources/admin/buildhosts.rst.txt+1βˆ’1
@@ -67,7 +67,7 @@ to ``imgmath``:
6767If your docs build (``make docs``) shows warnings like this::
6868
6969 WARNING: dot(1) not found, for better output quality install \
70βˆ’ graphviz from http://www.graphviz.org
70+ graphviz from https://www.graphviz.org
7171 ..
7272 WARNING: LaTeX command 'latex' cannot be run (needed for math \
7373 display), check the imgmath_latex setting
_sources/admin/installation-nginx.rst.txt+1βˆ’1
@@ -9,7 +9,7 @@ Install with nginx
99.. _nginx server configuration:
1010 https://docs.nginx.com/nginx/admin-guide/web-server/web-server/#setting-up-virtual-servers
1111.. _nginx beginners guide:
12βˆ’ http://nginx.org/en/docs/beginners_guide.html
12+ https://nginx.org/en/docs/beginners_guide.html
1313.. _Getting Started wiki:
1414 https://www.nginx.com/resources/wiki/start/
1515.. _uWSGI support from nginx:
_sources/admin/settings.rst.txt+1βˆ’1
@@ -112,7 +112,7 @@ Global Settings
112112 specific instance of searx, a locale can be defined using an ISO language
113113 code, like ``fr``, ``en``, ``de``.
114114
115βˆ’.. _requests proxies: http://requests.readthedocs.io/en/latest/user/advanced/#proxies
115+.. _requests proxies: https://requests.readthedocs.io/en/latest/user/advanced/#proxies
116116.. _PySocks: https://pypi.org/project/PySocks/
117117
118118``proxies`` :
_sources/dev/contribution_guide.rst.txt+2βˆ’2
@@ -117,8 +117,8 @@ Translation currently takes place on :ref:`transifex <translation>`.
117117Documentation
118118=============
119119
120βˆ’.. _Sphinx: http://www.sphinx-doc.org
121βˆ’.. _reST: http://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html
120+.. _Sphinx: https://www.sphinx-doc.org
121+.. _reST: https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html
122122
123123.. sidebar:: The reST sources
124124
_sources/dev/engine_overview.rst.txt+1βˆ’1
@@ -265,7 +265,7 @@ latitude latitude of result (in decimal format)
265265longitude longitude of result (in decimal format)
266266boundingbox boundingbox of result (array of 4. values
267267 ``[lat-min, lat-max, lon-min, lon-max]``)
268βˆ’geojson geojson of result (http://geojson.org)
268+geojson geojson of result (https://geojson.org/)
269269osm.type type of osm-object (if OSM-Result)
270270osm.id id of osm-object (if OSM-Result)
271271address.name name of object
_sources/dev/quickstart.rst.txt+1βˆ’1
@@ -60,7 +60,7 @@ read :ref:`make test`.
6060How to compile styles and javascript
6161====================================
6262
63βˆ’.. _less: http://lesscss.org/
63+.. _less: https://lesscss.org/
6464.. _NodeJS: https://nodejs.org
6565
6666How to build styles
_sources/dev/reST.rst.txt+12βˆ’12
@@ -1391,27 +1391,27 @@ The next example shows the difference of ``\tfrac`` (*textstyle*) and ``\dfrac``
13911391
13921392.. _readability: https://docs.python-guide.org/writing/style/
13931393.. _Sphinx-Primer:
1394βˆ’ http://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html
1394+ https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html
13951395.. _reST: https://docutils.sourceforge.io/rst.html
13961396.. _Sphinx Roles:
13971397 https://www.sphinx-doc.org/en/master/usage/restructuredtext/roles.html
1398βˆ’.. _Sphinx: http://www.sphinx-doc.org
1399βˆ’.. _`sphinx-doc FAQ`: http://www.sphinx-doc.org/en/stable/faq.html
1398+.. _Sphinx: https://www.sphinx-doc.org
1399+.. _`sphinx-doc FAQ`: https://www.sphinx-doc.org/en/stable/faq.html
14001400.. _Sphinx markup constructs:
1401βˆ’ http://www.sphinx-doc.org/en/stable/markup/index.html
1401+ https://www.sphinx-doc.org/en/stable/markup/index.html
14021402.. _`sphinx cross references`:
1403βˆ’ http://www.sphinx-doc.org/en/stable/markup/inline.html#cross-referencing-arbitrary-locations
1403+ https://www.sphinx-doc.org/en/stable/markup/inline.html#cross-referencing-arbitrary-locations
14041404.. _sphinx.ext.extlinks:
14051405 https://www.sphinx-doc.org/en/master/usage/extensions/extlinks.html
1406βˆ’.. _intersphinx: http://www.sphinx-doc.org/en/stable/ext/intersphinx.html
1407βˆ’.. _sphinx config: http://www.sphinx-doc.org/en/stable/config.html
1408βˆ’.. _Sphinx's autodoc: http://www.sphinx-doc.org/en/stable/ext/autodoc.html
1406+.. _intersphinx: https://www.sphinx-doc.org/en/stable/ext/intersphinx.html
1407+.. _sphinx config: https://www.sphinx-doc.org/en/stable/config.html
1408+.. _Sphinx's autodoc: https://www.sphinx-doc.org/en/stable/ext/autodoc.html
14091409.. _Sphinx's Python domain:
1410βˆ’ http://www.sphinx-doc.org/en/stable/domains.html#the-python-domain
1410+ https://www.sphinx-doc.org/en/stable/domains.html#the-python-domain
14111411.. _Sphinx's C domain:
1412βˆ’ http://www.sphinx-doc.org/en/stable/domains.html#cross-referencing-c-constructs
1412+ https://www.sphinx-doc.org/en/stable/domains.html#cross-referencing-c-constructs
14131413.. _doctree:
1414βˆ’ http://www.sphinx-doc.org/en/master/extdev/tutorial.html?highlight=doctree#build-phases
1414+ https://www.sphinx-doc.org/en/master/extdev/tutorial.html?highlight=doctree#build-phases
14151415.. _docutils: http://docutils.sourceforge.net/docs/index.html
14161416.. _docutils FAQ: http://docutils.sourceforge.net/FAQ.html
14171417.. _linuxdoc: https://return42.github.io/linuxdoc
@@ -1424,5 +1424,5 @@ The next example shows the difference of ``\tfrac`` (*textstyle*) and ``\dfrac``
14241424.. _ImageMagick: https://www.imagemagick.org
14251425
14261426.. _`Emacs Table Mode`: https://www.emacswiki.org/emacs/TableMode
1427βˆ’.. _`Online Tables Generator`: http://www.tablesgenerator.com/text_tables
1427+.. _`Online Tables Generator`: https://www.tablesgenerator.com/text_tables
14281428.. _`OASIS XML Exchange Table Model`: https://www.oasis-open.org/specs/tm9901.html
admin/buildhosts.html+1βˆ’1
@@ -189,7 +189,7 @@ to <code class="docutils literal notranslate"><span class="pre">imgmath</span></
189189</div>
190190<p>If your docs build (<code class="docutils literal notranslate"><span class="pre">make</span> <span class="pre">docs</span></code>) shows warnings like this:</p>
191191<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>WARNING: dot(1) not found, for better output quality install \
192βˆ’ graphviz from http://www.graphviz.org
192+ graphviz from https://www.graphviz.org
193193..
194194WARNING: LaTeX command &#39;latex&#39; cannot be run (needed for math \
195195 display), check the imgmath_latex setting
admin/installation-nginx.html+2βˆ’2
@@ -59,7 +59,7 @@
5959<p class="sidebar-title">further reading</p>
6060<ul class="simple">
6161<li><p><a class="reference external" href="https://docs.nginx.com/nginx/admin-guide/">nginx</a></p></li>
62βˆ’<li><p><a class="reference external" href="http://nginx.org/en/docs/beginners_guide.html">nginx beginners guide</a></p></li>
62+<li><p><a class="reference external" href="https://nginx.org/en/docs/beginners_guide.html">nginx beginners guide</a></p></li>
6363<li><p><a class="reference external" href="https://docs.nginx.com/nginx/admin-guide/web-server/web-server/#setting-up-virtual-servers">nginx server configuration</a></p></li>
6464<li><p><a class="reference external" href="https://www.nginx.com/resources/wiki/start/">Getting Started wiki</a></p></li>
6565<li><p><a class="reference external" href="https://uwsgi-docs.readthedocs.io/en/latest/Nginx.html">uWSGI support from nginx</a></p></li>
@@ -190,7 +190,7 @@ reverse proxy</span></a> and <a class="reference internal" href="../utils/morty.
190190filtron plus morty</em>.</p>
191191</div>
192192<p>Now you have to create a configuration for the searx site. If <a class="reference external" href="https://docs.nginx.com/nginx/admin-guide/">nginx</a> is new to
193βˆ’you, the <a class="reference external" href="http://nginx.org/en/docs/beginners_guide.html">nginx beginners guide</a> is a good starting point and the <a class="reference external" href="https://www.nginx.com/resources/wiki/start/">Getting
193+you, the <a class="reference external" href="https://nginx.org/en/docs/beginners_guide.html">nginx beginners guide</a> is a good starting point and the <a class="reference external" href="https://www.nginx.com/resources/wiki/start/">Getting
194194Started wiki</a> is always a good resource <em>to keep in the pocket</em>.</p>
195195<div class="sphinx-tabs docutils container">
196196<div class="ui top attached tabular menu sphinx-menu docutils container">
admin/settings.html+1βˆ’1
@@ -154,7 +154,7 @@ code, like <code class="docutils literal notranslate"><span class="pre">fr</span
154154</dd>
155155</dl>
156156<dl class="simple">
157βˆ’<dt><code class="docutils literal notranslate"><span class="pre">proxies</span></code> :</dt><dd><p>Define one or more proxies you wish to use, see <a class="reference external" href="http://requests.readthedocs.io/en/latest/user/advanced/#proxies">requests proxies</a>.
157+<dt><code class="docutils literal notranslate"><span class="pre">proxies</span></code> :</dt><dd><p>Define one or more proxies you wish to use, see <a class="reference external" href="https://requests.readthedocs.io/en/latest/user/advanced/#proxies">requests proxies</a>.
158158If there are more than one proxy for one protocol (http, https),
159159requests to the engines are distributed in a round-robin fashion.</p>
160160</dd>
dev/contribution_guide.html+1βˆ’1
@@ -161,7 +161,7 @@ code.</p></li>
161161<p class="sidebar-title">The reST sources</p>
162162<p>has been moved from <code class="docutils literal notranslate"><span class="pre">gh-branch</span></code> into <code class="docutils literal notranslate"><span class="pre">master</span></code> (<a class="reference external" href="https://github.com/searx/searx/blob/master/docs">git://docs</a>).</p>
163163</div>
164βˆ’<p>The documentation is built using <a class="reference external" href="http://www.sphinx-doc.org">Sphinx</a>. So in order to be able to generate
164+<p>The documentation is built using <a class="reference external" href="https://www.sphinx-doc.org">Sphinx</a>. So in order to be able to generate
165165the required files, you have to install it on your system. Much easier, use
166166our <a class="reference internal" href="makefile.html#makefile"><span class="std std-ref">Makefile Targets</span></a>.</p>
167167<p>Here is an example which makes a complete rebuild:</p>
dev/engine_overview.html+1βˆ’1
@@ -577,7 +577,7 @@ time of publish <em>(not implemented yet)</em></p></td>
577577<code class="docutils literal notranslate"><span class="pre">[lat-min,</span> <span class="pre">lat-max,</span> <span class="pre">lon-min,</span> <span class="pre">lon-max]</span></code>)</p></td>
578578</tr>
579579<tr class="row-odd"><td><p>geojson</p></td>
580βˆ’<td><p>geojson of result (<a class="reference external" href="http://geojson.org">http://geojson.org</a>)</p></td>
580+<td><p>geojson of result (<a class="reference external" href="https://geojson.org/">https://geojson.org/</a>)</p></td>
581581</tr>
582582<tr class="row-even"><td><p>osm.type</p></td>
583583<td><p>type of osm-object (if OSM-Result)</p></td>
dev/quickstart.html+1βˆ’1
@@ -102,7 +102,7 @@ read <a class="reference internal" href="makefile.html#make-test"><span class="s
102102<h2>How to compile styles and javascript<a class="headerlink" href="#how-to-compile-styles-and-javascript" title="Permalink to this headline">ΒΆ</a></h2>
103103<div class="section" id="how-to-build-styles">
104104<h3>How to build styles<a class="headerlink" href="#how-to-build-styles" title="Permalink to this headline">ΒΆ</a></h3>
105βˆ’<p><a class="reference external" href="http://lesscss.org/">Less</a> is required to build the styles of searx. <a class="reference external" href="http://lesscss.org/">Less</a> can be installed using
105+<p><a class="reference external" href="https://lesscss.org/">Less</a> is required to build the styles of searx. <a class="reference external" href="https://lesscss.org/">Less</a> can be installed using
106106either <a class="reference external" href="https://nodejs.org">NodeJS</a> or Apt.</p>
107107<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>sudo -H apt-get install nodejs
108108sudo -H npm install -g less
dev/reST.html+46βˆ’46
@@ -59,7 +59,7 @@
5959contributors to follow principles like <a class="reference external" href="https://en.wikipedia.org/wiki/KISS_principle">KISS</a> and <a class="reference external" href="https://docs.python-guide.org/writing/style/">readability</a>.</p>
6060</div>
6161<p>We at searx are using reStructuredText (aka <a class="reference external" href="https://docutils.sourceforge.io/rst.html">reST</a>) markup for all kind of
62βˆ’documentation, with the builders from the <a class="reference external" href="http://www.sphinx-doc.org">Sphinx</a> project a HTML output is
62+documentation, with the builders from the <a class="reference external" href="https://www.sphinx-doc.org">Sphinx</a> project a HTML output is
6363generated and deployed at <a class="reference external" href="https://searx.github.io/searx/.">github.io</a>. For build prerequisites read
6464<a class="reference internal" href="../admin/buildhosts.html#docs-build"><span class="std std-ref">Build docs</span></a>.</p>
6565<p>The source files of Searx’s documentation are located at <a class="reference external" href="https://github.com/searx/searx/blob/master/docs">git://docs</a>. Sphinx
@@ -67,17 +67,17 @@ assumes source files to be encoded in UTF-8 by defaul. Run <a class="reference
6767<div class="sidebar">
6868<p class="sidebar-title">Further reading</p>
6969<ul class="simple">
70βˆ’<li><p><a class="reference external" href="http://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html">Sphinx-Primer</a></p></li>
71βˆ’<li><p><a class="reference external" href="http://www.sphinx-doc.org/en/stable/markup/index.html">Sphinx markup constructs</a></p></li>
70+<li><p><a class="reference external" href="https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html">Sphinx-Primer</a></p></li>
71+<li><p><a class="reference external" href="https://www.sphinx-doc.org/en/stable/markup/index.html">Sphinx markup constructs</a></p></li>
7272<li><p><a class="reference external" href="https://docutils.sourceforge.io/rst.html">reST</a>, <a class="reference external" href="http://docutils.sourceforge.net/docs/index.html">docutils</a>, <a class="reference external" href="http://docutils.sourceforge.net/FAQ.html">docutils FAQ</a></p></li>
73βˆ’<li><p><a class="reference external" href="http://www.sphinx-doc.org">Sphinx</a>, <a class="reference external" href="http://www.sphinx-doc.org/en/stable/faq.html">sphinx-doc FAQ</a></p></li>
74βˆ’<li><p><a class="reference external" href="http://www.sphinx-doc.org/en/stable/config.html">sphinx config</a>, <a class="reference external" href="http://www.sphinx-doc.org/en/master/extdev/tutorial.html?highlight=doctree#build-phases">doctree</a></p></li>
75βˆ’<li><p><a class="reference external" href="http://www.sphinx-doc.org/en/stable/markup/inline.html#cross-referencing-arbitrary-locations">sphinx cross references</a></p></li>
73+<li><p><a class="reference external" href="https://www.sphinx-doc.org">Sphinx</a>, <a class="reference external" href="https://www.sphinx-doc.org/en/stable/faq.html">sphinx-doc FAQ</a></p></li>
74+<li><p><a class="reference external" href="https://www.sphinx-doc.org/en/stable/config.html">sphinx config</a>, <a class="reference external" href="https://www.sphinx-doc.org/en/master/extdev/tutorial.html?highlight=doctree#build-phases">doctree</a></p></li>
75+<li><p><a class="reference external" href="https://www.sphinx-doc.org/en/stable/markup/inline.html#cross-referencing-arbitrary-locations">sphinx cross references</a></p></li>
7676<li><p><a class="reference external" href="https://return42.github.io/linuxdoc">linuxdoc</a></p></li>
77βˆ’<li><p><a class="reference external" href="http://www.sphinx-doc.org/en/stable/ext/intersphinx.html">intersphinx</a></p></li>
77+<li><p><a class="reference external" href="https://www.sphinx-doc.org/en/stable/ext/intersphinx.html">intersphinx</a></p></li>
7878<li><p><a class="reference external" href="https://github.com/tardyp/sphinx-jinja">sphinx-jinja</a></p></li>
79βˆ’<li><p><a class="reference external" href="http://www.sphinx-doc.org/en/stable/ext/autodoc.html">Sphinx’s autodoc</a></p></li>
80βˆ’<li><p><a class="reference external" href="http://www.sphinx-doc.org/en/stable/domains.html#the-python-domain">Sphinx’s Python domain</a>, <a class="reference external" href="http://www.sphinx-doc.org/en/stable/domains.html#cross-referencing-c-constructs">Sphinx’s C domain</a></p></li>
79+<li><p><a class="reference external" href="https://www.sphinx-doc.org/en/stable/ext/autodoc.html">Sphinx’s autodoc</a></p></li>
80+<li><p><a class="reference external" href="https://www.sphinx-doc.org/en/stable/domains.html#the-python-domain">Sphinx’s Python domain</a>, <a class="reference external" href="https://www.sphinx-doc.org/en/stable/domains.html#cross-referencing-c-constructs">Sphinx’s C domain</a></p></li>
8181<li><p><a class="reference external" href="https://www.w3.org/TR/SVG11/expanded-toc.html">SVG</a>, <a class="reference external" href="https://www.imagemagick.org">ImageMagick</a></p></li>
8282<li><p><a class="reference external" href="https://graphviz.gitlab.io/_pages/doc/info/lang.html">DOT</a>, <a class="reference external" href="https://graphviz.gitlab.io/_pages/pdf/dotguide.pdf">Graphviz’s dot</a>, <a class="reference external" href="https://graphviz.gitlab.io">Graphviz</a></p></li>
8383</ul>
@@ -145,7 +145,7 @@ assumes source files to be encoded in UTF-8 by defaul. Run <a class="reference
145145<li><p><a class="reference internal" href="#math-equations" id="id51">Math equations</a></p></li>
146146</ul>
147147</div>
148βˆ’<p><a class="reference external" href="http://www.sphinx-doc.org">Sphinx</a> and <a class="reference external" href="https://docutils.sourceforge.io/rst.html">reST</a> have their place in the python ecosystem. Over that reST is
148+<p><a class="reference external" href="https://www.sphinx-doc.org">Sphinx</a> and <a class="reference external" href="https://docutils.sourceforge.io/rst.html">reST</a> have their place in the python ecosystem. Over that reST is
149149used in popular projects, e.g the Linux kernel documentation <a class="reference external" href="https://www.kernel.org/doc/html/latest/doc-guide/sphinx.html">[kernel doc]</a>.</p>
150150<div class="sidebar">
151151<p class="sidebar-title">Content matters</p>
@@ -358,10 +358,10 @@ Lists</a>.</p>
358358</div>
359359<div class="section" id="smart-refs">
360360<span id="rest-smart-ref"></span><h3><a class="toc-backref" href="#id23">Smart refs</a><a class="headerlink" href="#smart-refs" title="Permalink to this headline">ΒΆ</a></h3>
361βˆ’<p>With the power of <a class="reference external" href="https://www.sphinx-doc.org/en/master/usage/extensions/extlinks.html">sphinx.ext.extlinks</a> and <a class="reference external" href="http://www.sphinx-doc.org/en/stable/ext/intersphinx.html">intersphinx</a> referencing external
361+<p>With the power of <a class="reference external" href="https://www.sphinx-doc.org/en/master/usage/extensions/extlinks.html">sphinx.ext.extlinks</a> and <a class="reference external" href="https://www.sphinx-doc.org/en/stable/ext/intersphinx.html">intersphinx</a> referencing external
362362content becomes smart.</p>
363363<table class="colwidths-given docutils align-default" id="id5">
364βˆ’<caption><span class="caption-number">Table 4 </span><span class="caption-text">smart refs with <a class="reference external" href="https://www.sphinx-doc.org/en/master/usage/extensions/extlinks.html">sphinx.ext.extlinks</a> and <a class="reference external" href="http://www.sphinx-doc.org/en/stable/ext/intersphinx.html">intersphinx</a></span><a class="headerlink" href="#id5" title="Permalink to this table">ΒΆ</a></caption>
364+<caption><span class="caption-number">Table 4 </span><span class="caption-text">smart refs with <a class="reference external" href="https://www.sphinx-doc.org/en/master/usage/extensions/extlinks.html">sphinx.ext.extlinks</a> and <a class="reference external" href="https://www.sphinx-doc.org/en/stable/ext/intersphinx.html">intersphinx</a></span><a class="headerlink" href="#id5" title="Permalink to this table">ΒΆ</a></caption>
365365<colgroup>
366366<col style="width: 29%" />
367367<col style="width: 21%" />
@@ -412,7 +412,7 @@ content becomes smart.</p>
412412<td><p><a class="reference external" href="https://manpages.debian.org/jump?q=bash">bash</a></p></td>
413413<td><p><code class="docutils literal notranslate"><span class="pre">:man:`bash`</span></code></p></td>
414414</tr>
415βˆ’<tr class="row-even"><td colspan="3"><p><a class="reference external" href="http://www.sphinx-doc.org/en/stable/ext/intersphinx.html">intersphinx</a></p></td>
415+<tr class="row-even"><td colspan="3"><p><a class="reference external" href="https://www.sphinx-doc.org/en/stable/ext/intersphinx.html">intersphinx</a></p></td>
416416</tr>
417417<tr class="row-odd"><td><p>external anchor</p></td>
418418<td><p><a class="reference external" href="https://docs.python.org/3/reference/expressions.html#and" title="(in Python v3.9)"><span>Boolean operations</span></a></p></td>
@@ -450,8 +450,8 @@ content becomes smart.</p>
450450</div>
451451<div class="section" id="literal-blocks">
452452<h2><a class="toc-backref" href="#id24">Literal blocks</a><a class="headerlink" href="#literal-blocks" title="Permalink to this headline">ΒΆ</a></h2>
453βˆ’<p>The simplest form of <a class="reference external" href="http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#literal-blocks">literal-blocks</a> is a indented block introduced by
454βˆ’two colons (<code class="docutils literal notranslate"><span class="pre">::</span></code>). For highlighting use <a class="reference external" href="http://docutils.sourceforge.net/docs/ref/rst/directives.html#highlight">highlight</a> or <a class="reference internal" href="#rest-code"><span class="std std-ref">code-block</span></a> directive. To include literals from external files use
453+<p>The simplest form of <a class="reference external" href="https://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#literal-blocks">literal-blocks</a> is a indented block introduced by
454+two colons (<code class="docutils literal notranslate"><span class="pre">::</span></code>). For highlighting use <a class="reference external" href="https://docutils.sourceforge.net/docs/ref/rst/directives.html#highlight">highlight</a> or <a class="reference internal" href="#rest-code"><span class="std std-ref">code-block</span></a> directive. To include literals from external files use
455455<a class="reference external" href="https://www.sphinx-doc.org/en/master/usage/restructuredtext/directives.html#directive-literalinclude" title="(in Sphinx v4.0.0+)"><code class="xref rst rst-dir docutils literal notranslate"><span class="pre">literalinclude</span></code></a> or <a class="reference external" href="https://return42.github.io/linuxdoc/linuxdoc-howto/kernel-include-directive.html#kernel-include-directive" title="(in LinuxDoc v20200812)"><span class="xref std std-ref">kernel-include</span></a>
456456directive (latter one expands environment variables in the path name).</p>
457457<div class="section" id="rest-literal">
@@ -492,7 +492,7 @@ eirmod tempor invidunt ut labore</p>
492492<p class="sidebar-title">Syntax highlighting</p>
493493<p>is handled by <a class="reference external" href="https://pygments.org/languages/">pygments</a>.</p>
494494</div>
495βˆ’<p>The <a class="reference external" href="https://www.sphinx-doc.org/en/master/usage/restructuredtext/directives.html#directive-code-block" title="(in Sphinx v4.0.0+)"><code class="xref rst rst-dir docutils literal notranslate"><span class="pre">code-block</span></code></a> directive is a variant of the <a class="reference external" href="http://docutils.sourceforge.net/docs/ref/rst/directives.html#code">code</a> directive
495+<p>The <a class="reference external" href="https://www.sphinx-doc.org/en/master/usage/restructuredtext/directives.html#directive-code-block" title="(in Sphinx v4.0.0+)"><code class="xref rst rst-dir docutils literal notranslate"><span class="pre">code-block</span></code></a> directive is a variant of the <a class="reference external" href="https://docutils.sourceforge.net/docs/ref/rst/directives.html#code">code</a> directive
496496with additional options. To learn more about code literals visit
497497<a class="reference external" href="https://www.sphinx-doc.org/en/master/usage/restructuredtext/directives.html#code-examples" title="(in Sphinx v4.0.0+)"><span>Showing code examples</span></a>.</p>
498498<div class="highlight-reST notranslate"><div class="highlight"><pre><span></span>The URL <span class="s">``/stats``</span> handle is shown in <span class="na">:ref:</span><span class="nv">`stats-handle`</span>
@@ -533,7 +533,7 @@ with additional options. To learn more about code literals visit
533533</div>
534534<div class="section" id="unicode-substitution">
535535<h2><a class="toc-backref" href="#id27">Unicode substitution</a><a class="headerlink" href="#unicode-substitution" title="Permalink to this headline">ΒΆ</a></h2>
536βˆ’<p>The <a class="reference external" href="http://docutils.sourceforge.net/docs/ref/rst/directives.html#unicode-character-codes">unicode directive</a> converts Unicode
536+<p>The <a class="reference external" href="https://docutils.sourceforge.net/docs/ref/rst/directives.html#unicode-character-codes">unicode directive</a> converts Unicode
537537character codes (numerical values) to characters. This directive can only be
538538used within a substitution definition.</p>
539539<div class="highlight-reST notranslate"><div class="highlight"><pre><span></span><span class="p">..</span> <span class="nt">|copy|</span> <span class="ow">unicode</span><span class="p">::</span> 0xA9 .. copyright sign
@@ -556,7 +556,7 @@ Trademark |(TM)| and copyright |copy| glyphs.
556556<li><p><a class="reference external" href="https://www.sphinx-doc.org/en/master/usage/restructuredtext/domains.html" title="(in Sphinx v4.0.0+)"><span>Domains</span></a></p></li>
557557</ul>
558558</div>
559βˆ’<p>A <em>custom interpreted text role</em> (<a class="reference external" href="http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#roles">ref</a>) is an inline piece of
559+<p>A <em>custom interpreted text role</em> (<a class="reference external" href="https://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#roles">ref</a>) is an inline piece of
560560explicit markup. It signifies that that the enclosed text should be interpreted
561561in a specific way.</p>
562562<p>The general markup is one of:</p>
@@ -565,7 +565,7 @@ in a specific way.</p>
565565</pre></div>
566566</div>
567567<table class="colwidths-given docutils align-default" id="id6">
568βˆ’<caption><span class="caption-number">Table 5 </span><span class="caption-text">smart refs with <a class="reference external" href="https://www.sphinx-doc.org/en/master/usage/extensions/extlinks.html">sphinx.ext.extlinks</a> and <a class="reference external" href="http://www.sphinx-doc.org/en/stable/ext/intersphinx.html">intersphinx</a></span><a class="headerlink" href="#id6" title="Permalink to this table">ΒΆ</a></caption>
568+<caption><span class="caption-number">Table 5 </span><span class="caption-text">smart refs with <a class="reference external" href="https://www.sphinx-doc.org/en/master/usage/extensions/extlinks.html">sphinx.ext.extlinks</a> and <a class="reference external" href="https://www.sphinx-doc.org/en/stable/ext/intersphinx.html">intersphinx</a></span><a class="headerlink" href="#id6" title="Permalink to this table">ΒΆ</a></caption>
569569<colgroup>
570570<col style="width: 29%" />
571571<col style="width: 21%" />
@@ -606,27 +606,27 @@ in a specific way.</p>
606606<td><p><strong class="command">ls -la</strong></p></td>
607607<td><p><code class="docutils literal notranslate"><span class="pre">:command:`ls</span> <span class="pre">-la`</span></code></p></td>
608608</tr>
609βˆ’<tr class="row-odd"><td><p><a class="reference external" href="http://docutils.sourceforge.net/docs/ref/rst/roles.html#emphasis">emphasis</a></p></td>
609+<tr class="row-odd"><td><p><a class="reference external" href="https://docutils.sourceforge.net/docs/ref/rst/roles.html#emphasis">emphasis</a></p></td>
610610<td><p><em>italic</em></p></td>
611611<td><p><code class="docutils literal notranslate"><span class="pre">:emphasis:`italic`</span></code></p></td>
612612</tr>
613βˆ’<tr class="row-even"><td><p><a class="reference external" href="http://docutils.sourceforge.net/docs/ref/rst/roles.html#strong">strong</a></p></td>
613+<tr class="row-even"><td><p><a class="reference external" href="https://docutils.sourceforge.net/docs/ref/rst/roles.html#strong">strong</a></p></td>
614614<td><p><strong>bold</strong></p></td>
615615<td><p><code class="docutils literal notranslate"><span class="pre">:strong:`bold`</span></code></p></td>
616616</tr>
617βˆ’<tr class="row-odd"><td><p><a class="reference external" href="http://docutils.sourceforge.net/docs/ref/rst/roles.html#literal">literal</a></p></td>
617+<tr class="row-odd"><td><p><a class="reference external" href="https://docutils.sourceforge.net/docs/ref/rst/roles.html#literal">literal</a></p></td>
618618<td><p><code class="docutils literal notranslate"><span class="pre">foo()</span></code></p></td>
619619<td><p><code class="docutils literal notranslate"><span class="pre">:literal:`foo()`</span></code></p></td>
620620</tr>
621βˆ’<tr class="row-even"><td><p><a class="reference external" href="http://docutils.sourceforge.net/docs/ref/rst/roles.html#subscript">subscript</a></p></td>
621+<tr class="row-even"><td><p><a class="reference external" href="https://docutils.sourceforge.net/docs/ref/rst/roles.html#subscript">subscript</a></p></td>
622622<td><p>H<sub>2</sub>O</p></td>
623623<td><p><code class="docutils literal notranslate"><span class="pre">H\</span> <span class="pre">:sub:`2`\</span> <span class="pre">O</span></code></p></td>
624624</tr>
625βˆ’<tr class="row-odd"><td><p><a class="reference external" href="http://docutils.sourceforge.net/docs/ref/rst/roles.html#superscript">superscript</a></p></td>
625+<tr class="row-odd"><td><p><a class="reference external" href="https://docutils.sourceforge.net/docs/ref/rst/roles.html#superscript">superscript</a></p></td>
626626<td><p>E = mc<sup>2</sup></p></td>
627627<td><p><code class="docutils literal notranslate"><span class="pre">E</span> <span class="pre">=</span> <span class="pre">mc\</span> <span class="pre">:sup:`2`</span></code></p></td>
628628</tr>
629βˆ’<tr class="row-even"><td><p><a class="reference external" href="http://docutils.sourceforge.net/docs/ref/rst/roles.html#title-reference">title-reference</a></p></td>
629+<tr class="row-even"><td><p><a class="reference external" href="https://docutils.sourceforge.net/docs/ref/rst/roles.html#title-reference">title-reference</a></p></td>
630630<td><p><cite>Time</cite></p></td>
631631<td><p><code class="docutils literal notranslate"><span class="pre">:title:`Time`</span></code></p></td>
632632</tr>
@@ -648,7 +648,7 @@ about the build process when handling with images, especially since he has no
648648access to the build process. With <a class="reference external" href="https://return42.github.io/linuxdoc/linuxdoc-howto/kfigure.html#kfigure" title="(in LinuxDoc v20200812)"><span>Scalable figure and image handling</span></a> the build process
649649continues and scales output quality in dependence of installed image processors.</p>
650650<p>If you want to add an image, you should use the <code class="docutils literal notranslate"><span class="pre">kernel-figure</span></code> (inheritance
651βˆ’of <a class="reference external" href="http://docutils.sourceforge.net/docs/ref/rst/directives.html#figure">figure</a>) and <code class="docutils literal notranslate"><span class="pre">kernel-image</span></code> (inheritance of <a class="reference external" href="http://docutils.sourceforge.net/docs/ref/rst/directives.html#image">image</a>)
651+of <a class="reference external" href="https://docutils.sourceforge.net/docs/ref/rst/directives.html#figure">figure</a>) and <code class="docutils literal notranslate"><span class="pre">kernel-image</span></code> (inheritance of <a class="reference external" href="https://docutils.sourceforge.net/docs/ref/rst/directives.html#image">image</a>)
652652directives. E.g. to insert a figure with a scaleable image format use SVG
653653(<a class="reference internal" href="#svg-image-example"><span class="std std-ref">Simple SVG image.</span></a>):</p>
654654<div class="highlight-reST notranslate"><div class="highlight"><pre><span></span><span class="p">..</span> <span class="nt">_svg image example:</span>
@@ -759,7 +759,7 @@ installed, you will see an vector image. If not, the raw markup is inserted as
759759<span id="rest-lists"></span><h2><a class="toc-backref" href="#id33">List markups</a><a class="headerlink" href="#list-markups" title="Permalink to this headline">ΒΆ</a></h2>
760760<div class="section" id="bullet-list">
761761<h3><a class="toc-backref" href="#id34">Bullet list</a><a class="headerlink" href="#bullet-list" title="Permalink to this headline">ΒΆ</a></h3>
762βˆ’<p>List markup (<a class="reference external" href="http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#bullet-lists">ref</a>) is simple:</p>
762+<p>List markup (<a class="reference external" href="https://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#bullet-lists">ref</a>) is simple:</p>
763763<div class="highlight-reST notranslate"><div class="highlight"><pre><span></span><span class="m">-</span> This is a bulleted list.
764764
765765 <span class="m">1.</span> Nested lists are possible, but be aware that they must be separated from
@@ -827,11 +827,11 @@ list.</p>
827827<ul class="simple">
828828<li><p>the term cannot have more than one line of text</p></li>
829829<li><p>there is <strong>no blank line between term and definition block</strong> // this
830βˆ’distinguishes definition lists (<a class="reference external" href="http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#definition-lists">ref</a>) from block
831βˆ’quotes (<a class="reference external" href="http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#block-quotes">ref</a>).</p></li>
830+distinguishes definition lists (<a class="reference external" href="https://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#definition-lists">ref</a>) from block
831+quotes (<a class="reference external" href="https://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#block-quotes">ref</a>).</p></li>
832832</ul>
833833</div>
834βˆ’<p>Each definition list (<a class="reference external" href="http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#definition-lists">ref</a>) item contains a term,
834+<p>Each definition list (<a class="reference external" href="https://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#definition-lists">ref</a>) item contains a term,
835835optional classifiers and a definition. A term is a simple one-line word or
836836phrase. Optional classifiers may follow the term on the same line, each after
837837an inline β€˜ : β€˜ (<strong>space, colon, space</strong>). A definition is a block indented
@@ -872,7 +872,7 @@ term 4 : classifier one : classifier two
872872<blockquote>
873873<div><p>And this is not term’s definition. <strong>There is a blank line</strong> in between
874874the line above and this paragraph. That’s why this paragraph is taken as
875βˆ’<strong>block quote</strong> (<a class="reference external" href="http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#block-quotes">ref</a>) and not as term’s definition!</p>
875+<strong>block quote</strong> (<a class="reference external" href="https://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#block-quotes">ref</a>) and not as term’s definition!</p>
876876</div></blockquote>
877877<dl>
878878<dt>term 2</dt><dd><p>Definition 2, paragraph 1.</p>
@@ -886,8 +886,8 @@ the line above and this paragraph. That’s why this paragraph is taken as
886886</div>
887887<div class="section" id="quoted-paragraphs">
888888<h3><a class="toc-backref" href="#id37">Quoted paragraphs</a><a class="headerlink" href="#quoted-paragraphs" title="Permalink to this headline">ΒΆ</a></h3>
889βˆ’<p>Quoted paragraphs (<a class="reference external" href="http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#block-quotes">ref</a>) are created by just indenting
890βˆ’them more than the surrounding paragraphs. Line blocks (<a class="reference external" href="http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#line-blocks">ref</a>) are a way of preserving line breaks:</p>
889+<p>Quoted paragraphs (<a class="reference external" href="https://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#block-quotes">ref</a>) are created by just indenting
890+them more than the surrounding paragraphs. Line blocks (<a class="reference external" href="https://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#line-blocks">ref</a>) are a way of preserving line breaks:</p>
891891<div class="highlight-reST notranslate"><div class="highlight"><pre><span></span>normal paragraph ...
892892lorem ipsum.
893893
@@ -961,11 +961,11 @@ are mappings from field names to field bodies. They marked up like this:</p>
961961<div class="section" id="further-list-blocks">
962962<h3><a class="toc-backref" href="#id39">Further list blocks</a><a class="headerlink" href="#further-list-blocks" title="Permalink to this headline">ΒΆ</a></h3>
963963<ul class="simple">
964βˆ’<li><p>field lists (<a class="reference external" href="http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#field-lists">ref</a>, with caveats noted in
964+<li><p>field lists (<a class="reference external" href="https://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#field-lists">ref</a>, with caveats noted in
965965<a class="reference internal" href="#rest-field-list"><span class="std std-ref">Field Lists</span></a>)</p></li>
966βˆ’<li><p>option lists (<a class="reference external" href="http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#option-lists">ref</a>)</p></li>
967βˆ’<li><p>quoted literal blocks (<a class="reference external" href="http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#quoted-literal-blocks">ref</a>)</p></li>
968βˆ’<li><p>doctest blocks (<a class="reference external" href="http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#doctest-blocks">ref</a>)</p></li>
966+<li><p>option lists (<a class="reference external" href="https://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#option-lists">ref</a>)</p></li>
967+<li><p>quoted literal blocks (<a class="reference external" href="https://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#quoted-literal-blocks">ref</a>)</p></li>
968+<li><p>doctest blocks (<a class="reference external" href="https://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#doctest-blocks">ref</a>)</p></li>
969969</ul>
970970</div>
971971</div>
@@ -984,7 +984,7 @@ site effects. Here is the source of the sidebar <a class="reference internal" h
984984</div>
985985<div class="section" id="generic-admonition">
986986<h3><a class="toc-backref" href="#id42">Generic admonition</a><a class="headerlink" href="#generic-admonition" title="Permalink to this headline">ΒΆ</a></h3>
987βˆ’<p>The generic <a class="reference external" href="http://docutils.sourceforge.net/docs/ref/rst/directives.html#admonitions">admonition</a> needs a title:</p>
987+<p>The generic <a class="reference external" href="https://docutils.sourceforge.net/docs/ref/rst/directives.html#admonitions">admonition</a> needs a title:</p>
988988<div class="highlight-reST notranslate"><div class="highlight"><pre><span></span><span class="p">..</span> <span class="ow">admonition</span><span class="p">::</span> generic admonition title
989989
990990 lorem ipsum ..
@@ -997,9 +997,9 @@ site effects. Here is the source of the sidebar <a class="reference internal" h
997997</div>
998998<div class="section" id="specific-admonitions">
999999<h3><a class="toc-backref" href="#id43">Specific admonitions</a><a class="headerlink" href="#specific-admonitions" title="Permalink to this headline">ΒΆ</a></h3>
1000βˆ’<p>Specific admonitions: <a class="reference external" href="http://docutils.sourceforge.net/docs/ref/rst/directives.html#hint">hint</a>, <a class="reference external" href="http://docutils.sourceforge.net/docs/ref/rst/directives.html#note">note</a>, <a class="reference external" href="http://docutils.sourceforge.net/docs/ref/rst/directives.html#tip">tip</a> <a class="reference external" href="http://docutils.sourceforge.net/docs/ref/rst/directives.html#attention">attention</a>,
1001βˆ’<a class="reference external" href="http://docutils.sourceforge.net/docs/ref/rst/directives.html#caution">caution</a>, <a class="reference external" href="http://docutils.sourceforge.net/docs/ref/rst/directives.html#danger">danger</a>, <a class="reference external" href="http://docutils.sourceforge.net/docs/ref/rst/directives.html#error">error</a>, , <a class="reference external" href="http://docutils.sourceforge.net/docs/ref/rst/directives.html#important">important</a>, and
1002βˆ’<a class="reference external" href="http://docutils.sourceforge.net/docs/ref/rst/directives.html#warning">warning</a> .</p>
1000+<p>Specific admonitions: <a class="reference external" href="https://docutils.sourceforge.net/docs/ref/rst/directives.html#hint">hint</a>, <a class="reference external" href="https://docutils.sourceforge.net/docs/ref/rst/directives.html#note">note</a>, <a class="reference external" href="https://docutils.sourceforge.net/docs/ref/rst/directives.html#tip">tip</a> <a class="reference external" href="https://docutils.sourceforge.net/docs/ref/rst/directives.html#attention">attention</a>,
1001+<a class="reference external" href="https://docutils.sourceforge.net/docs/ref/rst/directives.html#caution">caution</a>, <a class="reference external" href="https://docutils.sourceforge.net/docs/ref/rst/directives.html#danger">danger</a>, <a class="reference external" href="https://docutils.sourceforge.net/docs/ref/rst/directives.html#error">error</a>, , <a class="reference external" href="https://docutils.sourceforge.net/docs/ref/rst/directives.html#important">important</a>, and
1002+<a class="reference external" href="https://docutils.sourceforge.net/docs/ref/rst/directives.html#warning">warning</a> .</p>
10031003<div class="highlight-reST notranslate"><div class="highlight"><pre><span></span><span class="p">..</span> <span class="ow">hint</span><span class="p">::</span>
10041004
10051005 lorem ipsum ..
@@ -1073,13 +1073,13 @@ ascribable to the ASCII-art. Anyway, if you prefer ASCII-art for any reason,
10731073here are some helpers:</p>
10741074<ul class="simple">
10751075<li><p><a class="reference external" href="https://www.emacswiki.org/emacs/TableMode">Emacs Table Mode</a></p></li>
1076βˆ’<li><p><a class="reference external" href="http://www.tablesgenerator.com/text_tables">Online Tables Generator</a></p></li>
1076+<li><p><a class="reference external" href="https://www.tablesgenerator.com/text_tables">Online Tables Generator</a></p></li>
10771077</ul>
10781078<div class="section" id="simple-tables">
10791079<span id="rest-simple-table"></span><h3><a class="toc-backref" href="#id45">Simple tables</a><a class="headerlink" href="#simple-tables" title="Permalink to this headline">ΒΆ</a></h3>
1080βˆ’<p><a class="reference external" href="http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#simple-tables">Simple tables</a> allow <em>colspan</em> but not <em>rowspan</em>. If
1080+<p><a class="reference external" href="https://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#simple-tables">Simple tables</a> allow <em>colspan</em> but not <em>rowspan</em>. If
10811081your table need some metadata (e.g. a title) you need to add the <code class="docutils literal notranslate"><span class="pre">..</span> <span class="pre">table::</span>
1082βˆ’<span class="pre">directive</span></code> <a class="reference external" href="http://docutils.sourceforge.net/docs/ref/rst/directives.html#table">(ref)</a> in front and place the table in its body:</p>
1082+<span class="pre">directive</span></code> <a class="reference external" href="https://docutils.sourceforge.net/docs/ref/rst/directives.html#table">(ref)</a> in front and place the table in its body:</p>
10831083<div class="highlight-reST notranslate"><div class="highlight"><pre><span></span><span class="p">..</span> <span class="ow">table</span><span class="p">::</span> foo gate truth table
10841084 <span class="nc">:widths:</span> <span class="nf">grid</span>
10851085 <span class="nc">:align:</span> <span class="nf">left</span>
@@ -1139,7 +1139,7 @@ your table need some metadata (e.g. a title) you need to add the <code class="do
11391139</div>
11401140<div class="section" id="grid-tables">
11411141<span id="rest-grid-table"></span><h3><a class="toc-backref" href="#id46">Grid tables</a><a class="headerlink" href="#grid-tables" title="Permalink to this headline">ΒΆ</a></h3>
1142βˆ’<p><a class="reference external" href="http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#grid-tables">Grid tables</a> allow colspan <em>colspan</em> and <em>rowspan</em>:</p>
1142+<p><a class="reference external" href="https://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#grid-tables">Grid tables</a> allow colspan <em>colspan</em> and <em>rowspan</em>:</p>
11431143<div class="highlight-reST notranslate"><div class="highlight"><pre><span></span><span class="p">..</span> <span class="ow">table</span><span class="p">::</span> grid table example
11441144 <span class="nc">:widths:</span> <span class="nf">1 1 5</span>
11451145
@@ -1198,7 +1198,7 @@ span rows.</p></td>
11981198<div class="section" id="flat-table">
11991199<span id="rest-flat-table"></span><h3><a class="toc-backref" href="#id47">flat-table</a><a class="headerlink" href="#flat-table" title="Permalink to this headline">ΒΆ</a></h3>
12001200<p>The <code class="docutils literal notranslate"><span class="pre">flat-table</span></code> is a further developed variant of the <a class="reference external" href="https://return42.github.io/linuxdoc/linuxdoc-howto/table-markup.html#list-table-directives" title="(in LinuxDoc v20200812)"><span class="xref std std-ref">list tables</span></a>. It is a double-stage list similar to the
1201βˆ’<a class="reference external" href="http://docutils.sourceforge.net/docs/ref/rst/directives.html#list-table">list-table</a> with some additional features:</p>
1201+<a class="reference external" href="https://docutils.sourceforge.net/docs/ref/rst/directives.html#list-table">list-table</a> with some additional features:</p>
12021202<dl class="simple">
12031203<dt>column-span: <code class="docutils literal notranslate"><span class="pre">cspan</span></code></dt><dd><p>with the role <code class="docutils literal notranslate"><span class="pre">cspan</span></code> a cell can be extended through additional columns</p>
12041204</dd>