commit df1082e8f4f69b377c3d1b8963036d13e97bb432
parent 2600551f4246a3ef7402013ba285adcff61b92bc
Author: Martin Schanzenbach <schanzen@gnunet.org>
Date: Fri, 16 Feb 2024 18:41:00 +0100
move to pydata theme with better availability
Diffstat:
2 files changed, 13 insertions(+), 10 deletions(-)
diff --git a/conf.py b/conf.py
@@ -58,21 +58,21 @@ exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']
# The theme to use for HTML and HTML Help pages. See the documentation for
# a list of builtin themes.
#
-html_theme = 'sphinx_book_theme'
+html_theme = 'pydata_sphinx_theme'
html_sidebars = {
- "**": ["navbar-logo.html", "sbt-sidebar-nav.html", "search-field.html"]
+ "**": ["search-field.html", "sidebar-nav-bs"]
}
html_theme_options = {
#'logo_only': True,
#'display_version': False,
#'prev_next_buttons_location': 'bottom',
- #'style_external_links': False,
+ 'style_external_links': False,
#'vcs_pageview_mode': '',
#'style_nav_header_background': 'transparent', # Possibly problematic with our CSP
# Toc options
- #'collapse_navigation': True,
+ 'collapse_navigation': True,
#'sticky_navigation': True,
#'navigation_depth': 4,
#'includehidden': True,
@@ -80,7 +80,8 @@ html_theme_options = {
#"navbar_start": ["navbar-logo"],
"header_links_before_dropdown": 8,
"article_header_start": ["breadcrumbs.html"],
- "show_toc_level": 0,
+ "show_toc_level": 3,
+ "show_nav_level": 2,
#"navbar_center": ["navbar-nav"],
"navbar_end": [],
"navbar_persistent": [],
@@ -139,7 +140,8 @@ rst_prolog = f"""
:class: bolditalic
"""
-rst_epilog = """
-"""
-
+if os.environ.get("GNUNET_VERSION"):
+ rst_prolog = ".. |gnunet_version| replace:: " + os.environ["GNUNET_VERSION"]
+else:
+ rst_prolog = ".. |gnunet_version| replace:: latest"
diff --git a/installing.rst b/installing.rst
@@ -127,12 +127,13 @@ Using git type
$ git clone https://git.gnunet.org/gnunet.git
-The archive can be found at https://ftpmirror.gnu.org/gnu/gnunet/.
+The release archive can be found at https://ftpmirror.gnu.org/gnu/gnunet/.
+You can find nightly builds at https://buildbot.gnunet.org/artifacts/.
Extract it using a graphical archive tool or tar:
::
- tar xf gnunet-0.17.1-26-g233ec6111.tar.gz
+ tar xf gnunet-<VERSION> .tar.gz
In the next chapter we will assume that the source code is available in
the home directory at ~/gnunet.