searxng/.git/docs/_themes, branch master

[dev-env] upgrade Sphinx-doc 7.2.3 and unpin at v7.1.2 on py3.8

2023-08-27T15:22:45+00:00

- Sphinx-doc 7.2.0 drops py3.8 support [1][2]
- last version with py3.8 support is 7.1.2

Many LTS distributions still have py3.8 which EOL is in 2024-10 [3].

To continue to support a development environment on py3.8 the rigid dependency
in the development environment is unpinned in py3.8 / environment markers [4].

To get 7.2.3. work, a fix in sphinx-notfound-page is needed [5][6].

[1] https://github.com/searxng/searxng/pull/2658#issuecomment-1684867270
[2] https://github.com/sphinx-doc/sphinx/issues/11621
[3] https://devguide.python.org/versions/#supported-versions
[4] https://peps.python.org/pep-0508/#environment-markers
[5] https://github.com/readthedocs/sphinx-notfound-page/issues/219
[6] https://github.com/readthedocs/sphinx-notfound-page/issues/219#issuecomment-1694691135

Signed-off-by: Markus Heiser

[fix] sphinx 5.x: add `nav.contents` everywhere that `div.topic` is used

2022-07-05T15:05:06+00:00

Previously, docutils produced `div.topic` for the contents directive, the latest
version produces `nav.contents`.  This means that those tables of contents
change appearance when switching to docutils 0.18 [1][2].

[1] https://github.com/sphinx-doc/sphinx/pull/10535/commits/5806f0a
[2] https://github.com/sphinx-doc/sphinx/issues/10534

Signed-off-by: Markus Heiser

[interim fix] of sphinx-tabs and sphinx-jinja

2022-03-12T13:25:34+00:00

The myst-parser requires >= docutils v.0.17 what ends in a dependency hell where
plugins sphinx-tabs and sphinx-jinja we use are involved.

This patch can be reverted when [2], [3], [4]  are solved and new release is
available / see [1].

[1] https://github.com/searxng/searxng/pull/954
[2] https://github.com/executablebooks/sphinx-tabs/issues/152
[3] https://github.com/executablebooks/sphinx-tabs/pull/153
[4] https://github.com/executablebooks/sphinx-tabs/pull/154

Signed-off-by: Markus Heiser

[doc] highlight the current page in the sidebar

2022-01-10T09:48:13+00:00

[doc] add global TOC to sidebar

2021-12-24T06:05:33+00:00

Signed-off-by: Markus Heiser

[brand] SearXNG - docs html_theme = "searxng"

2021-11-18T16:33:48+00:00

Signed-off-by: Markus Heiser

[fix] sphinx-tabs should not overlap sidebar

2021-05-14T15:19:49+00:00

Signed-off-by: Markus Heiser

Revert "[fix] sphinx 3.1 CSS issues"

2020-12-27T10:27:42+00:00

This reverts commit 0616684baa58b86cac5df6546432d4372f965fe2.

Since PR https://github.com/sphinx-doc/sphinx/pull/7878 has been merged into
Spinx-doc (v3.1.2), this patch is no longer needed:

  See sphinx-doc project, PR 7838 & 7484 with elementary patch to the basic CSS:

  - https://github.com/sphinx-doc/sphinx/issues/7838#issuecomment-646009605
  - https://github.com/sphinx-doc/sphinx/pull/7484#issuecomment-646058972

Signed-off-by: Markus Heiser

[fix] sphinx 3.1 CSS issues

2020-06-18T17:02:22+00:00

See sphinx-doc project, PR 7838 & 7484 with elementary patch to the basic CSS:

- https://github.com/sphinx-doc/sphinx/issues/7838#issuecomment-646009605
- https://github.com/sphinx-doc/sphinx/pull/7484#issuecomment-646058972

Signed-off-by: Markus Heiser

docs(css): render ..content and ..toctree directive same

2020-02-04T15:43:07+00:00

Signed-off-by: Markus Heiser