gnunet-handbook

The GNUnet Handbook
Log | Files | Refs

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:
Mconf.py | 18++++++++++--------
Minstalling.rst | 5+++--
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.