docs(dnsdist): Make the docs consistent with commercial docs

diff --git a/pdns/dnsdistdist/docs/_static/extra.css b/pdns/dnsdistdist/docs/_static/extra.css
new file mode 100644 (file)
index 0000000..c18a332
--- /dev/null
+++ b/pdns/dnsdistdist/docs/_static/extra.css
@@ -0,0 +1,21 @@
+:root {
+    --md-primary-fg-color:        #e66e00;
+    --md-primary-fg-color--light: #e66e00;
+    --md-primary-fg-color--dark:  #e66e00;
+}
+
+.md-header {
+    background-color: #666666;
+}
+
+.md-tabs {
+    background-color: #e66e00;
+}
+
+.md-nav .md-nav__item--section {
+    font-size: 125%;
+}
+
+td > code {
+    white-space: nowrap;
+}

diff --git a/pdns/dnsdistdist/docs/_static/favicon.ico b/pdns/dnsdistdist/docs/_static/favicon.ico
index 4b0eae3a4ccb5a5afdc3b424a06a1a1400fabd46..70dd4c2255f4bb45dd6fe106ca8de384d82178d3 100644 (file)
Binary files a/pdns/dnsdistdist/docs/_static/favicon.ico and b/pdns/dnsdistdist/docs/_static/favicon.ico differ

diff --git a/pdns/dnsdistdist/docs/_static/powerdns_logo_white_orange_rgb.png b/pdns/dnsdistdist/docs/_static/powerdns_logo_white_orange_rgb.png
new file mode 100644 (file)
index 0000000..838a414
Binary files /dev/null and b/pdns/dnsdistdist/docs/_static/powerdns_logo_white_orange_rgb.png differ

diff --git a/pdns/dnsdistdist/docs/conf.py b/pdns/dnsdistdist/docs/conf.py
index 139a7843d1673884075e3548cc22e171d118dea6..a5dfac4f8e927efa43921e1bd18ee8308b0fe234 100644 (file)
--- a/pdns/dnsdistdist/docs/conf.py
+++ b/pdns/dnsdistdist/docs/conf.py
@@ -138,30 +138,39 @@ html_theme = "sphinx_immaterial"
 # documentation.
 #
 html_theme_options = {
-    "font": {
-        "text": "Roboto",  # used for all the pages' text
-        "code": "Roboto Mono",  # used for literal code blocks
-    },
+    "site_url": "https://dnsdist.org",
+    # "palette": {
+    #     "primary": "custom",
+    # },
+    "features": [
+        "navigation.tabs",
+        "navigation.tabs.sticky",
+        "navigation.top",
+        "navigation.tracking",
+        "navigation.sections",
+        "navigation.footer",
+        "toc.integrate",
+        "toc.follow",
+        "search.highlight",
+        "search.share",
+        "search.suggest",
+    ],
 }
+
+html_css_files = ["extra.css"]
+
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
 # so a file named "default.css" will overwrite the builtin "default.css".
 html_static_path = ["_static"]
 
 html_favicon = "_static/favicon.ico"
-
-# html_sidebars = {
-#     "**": ["searchbox.html", "relations.html", "localtoc.html", "sourcelink.html"]
-# }
+html_logo = "_static/powerdns_logo_white_orange_rgb.png"
 
 # -- Options for HTMLHelp output ------------------------------------------
 
 # Output file base name for HTML help builder.
-# htmlhelp_basename = "dnsdistdoc"
-
-# object_description_options = [
-#     (".*", dict(generate_synopses=None, include_in_toc=False)),
-# ]
+htmlhelp_basename = "dnsdistdoc"
 
 # -- Options for LaTeX output ---------------------------------------------
 

diff --git a/pdns/dnsdistdist/docs/index_TOC.rst b/pdns/dnsdistdist/docs/index_TOC.rst
index 757990d314f0a5d294229793bbd37cfa04b9321d..c2cb5e3ad490b5f0ef855d813c4ecddeabf3dca4 100644 (file)
--- a/pdns/dnsdistdist/docs/index_TOC.rst
+++ b/pdns/dnsdistdist/docs/index_TOC.rst
@@ -2,7 +2,7 @@ Table of Contents
 =================
 
 .. toctree::
-   :maxdepth: 3
+   :maxdepth: 1
    :glob:
 
    index
@@ -11,7 +11,7 @@ Table of Contents
    running
    rules-actions
    statistics
-   guides/*
+   guides/index
    advanced/index
    reference/index
    manpages/index