docs: add the print page (#407)

**Issue number:** ADDON-75611

## Summary

### Changes

> Please provide a summary of what's being changed

Documentation changes: added print button that shows the whole
documentation on one page.

In order to enable this feature, first level headings needed to be added
to files.

### User experience

> Please describe what the user experience looks like before and after
this change

None

## Checklist

If your change doesn't seem to apply, please leave them unchecked.

* [x] I have performed a self-review of this change
* [ ] Changes have been tested
* [ ] Changes are documented
* [x] PR title follows [conventional commit
semantics](https://www.conventionalcommits.org/en/v1.0.0/)

docs/acl.md

@@ -1 +1,3 @@
+# acl.py
+
 ::: solnlib.acl

docs/bulletin_rest_client.md

@@ -1 +1,3 @@
+# bulletin_rest_client.py
+
 ::: solnlib.bulletin_rest_client

docs/conf_manager.md

@@ -1 +1,3 @@
+# conf_manager.py
+
 ::: solnlib.conf_manager

docs/credentials.md

@@ -1 +1,3 @@
+# credentials.py
+
 ::: solnlib.credentials

docs/file_monitor.md

@@ -1 +1,3 @@
+# file_monitor.py
+
 ::: solnlib.file_monitor

docs/hec_config.md

@@ -1 +1,3 @@
+# hec_config.py
+
 ::: solnlib.hec_config

docs/log.md

@@ -1 +1,3 @@
+# log.py
+
 ::: solnlib.log

docs/modular_input/checkpointer.md

@@ -1 +1,3 @@
+# checkpointer.py
+
 ::: solnlib.modular_input.checkpointer

docs/modular_input/event.md

@@ -1 +1,3 @@
+# event.py
+
 ::: solnlib.modular_input.event

docs/modular_input/event_writer.md

@@ -1 +1,3 @@
+# event_writer.py
+
 ::: solnlib.modular_input.event_writer

docs/modular_input/modular_input.md

@@ -1 +1,3 @@
+# modular_input.py
+
 ::: solnlib.modular_input.modular_input

docs/net_utils.md

@@ -1 +1,3 @@
+# net_utils.py
+
 ::: solnlib.net_utils

docs/orphan_process_monitor.md

@@ -1 +1,3 @@
+# orphan_process_monitor.py
+
 ::: solnlib.orphan_process_monitor

docs/pattern.md

@@ -1 +1,3 @@
+# pattern.py
+
 ::: solnlib.pattern

docs/server_info.md

@@ -1 +1,3 @@
+# server_info.py
+
 ::: solnlib.server_info

docs/splunk_rest_client.md

@@ -1 +1,3 @@
+# splunk_rest_client.py
+
 ::: solnlib.splunk_rest_client

docs/splunkenv.md

@@ -1 +1,3 @@
+# splunkenv.py
+
 ::: solnlib.splunkenv

docs/theme_overrides/partials/header.html

@@ -0,0 +1,104 @@
+<!-- Source:
+https://github.com/squidfunk/mkdocs-material/blob/master/src/templates/partials/header.html
+-->
+
+{% set class = "md-header" %}
+{% if "navigation.tabs.sticky" in features %}
+  {% set class = class ~ " md-header--shadow md-header--lifted" %}
+{% elif "navigation.tabs" not in features %}
+  {% set class = class ~ " md-header--shadow" %}
+{% endif %}
+
+<!-- Header -->
+<header class="{{ class }}" data-md-component="header">
+  <nav
+    class="md-header__inner md-grid"
+    aria-label="{{ lang.t('header') }}"
+  >
+
+    <!-- Link to home -->
+    <a
+      href="{{ config.extra.homepage | d(nav.homepage.url, true) | url }}"
+      title="{{ config.site_name | e }}"
+      class="md-header__button md-logo"
+      aria-label="{{ config.site_name }}"
+      data-md-component="logo"
+    >
+      {% include "partials/logo.html" %}
+    </a>
+
+    <!-- Button to open drawer -->
+    <label class="md-header__button md-icon" for="__drawer">
+      {% set icon = config.theme.icon.menu or "material/menu" %}
+      {% include ".icons/" ~ icon ~ ".svg" %}
+    </label>
+
+    <!-- Header title -->
+    <div class="md-header__title" data-md-component="header-title">
+      <div class="md-header__ellipsis">
+        <div class="md-header__topic">
+          <span class="md-ellipsis">
+            {{ config.site_name }}
+          </span>
+        </div>
+        <div class="md-header__topic" data-md-component="header-topic">
+          <span class="md-ellipsis">
+            {% if page.meta and page.meta.title %}
+              {{ page.meta.title }}
+            {% else %}
+              {{ page.title }}
+            {% endif %}
+          </span>
+        </div>
+      </div>
+    </div>
+
+    {% if page.url_to_print_page %}
+      <a href="{{ page.url_to_print_page }}" title="Print Site" class="md-header__button md-icon">
+          {% include ".icons/material/printer.svg" %}
+      </a>
+    {% endif %}
+
+    <!-- Color palette toggle -->
+    {% if config.theme.palette %}
+      {% if not config.theme.palette is mapping %}
+        {% include "partials/palette.html" %}
+      {% endif %}
+    {% endif %}
+
+    <!-- User preference: color palette -->
+    {% if not config.theme.palette is mapping %}
+      {% include "partials/javascripts/palette.html" %}
+    {% endif %}
+
+    <!-- Site language selector -->
+    {% if config.extra.alternate %}
+      {% include "partials/alternate.html" %}
+    {% endif %}
+
+    <!-- Button to open search modal -->
+    {% if "material/search" in config.plugins %}
+      <label class="md-header__button md-icon" for="__search">
+        {% set icon = config.theme.icon.search or "material/magnify" %}
+        {% include ".icons/" ~ icon ~ ".svg" %}
+      </label>
+
+      <!-- Search interface -->
+      {% include "partials/search.html" %}
+    {% endif %}
+
+    <!-- Repository information -->
+    {% if config.repo_url %}
+      <div class="md-header__source">
+        {% include "partials/source.html" %}
+      </div>
+    {% endif %}
+  </nav>
+
+  <!-- Navigation tabs (sticky) -->
+  {% if "navigation.tabs.sticky" in features %}
+    {% if "navigation.tabs" in features %}
+      {% include "partials/tabs.html" %}
+    {% endif %}
+  {% endif %}
+</header>

docs/time_parser.md

@@ -1 +1,3 @@
+# time_parser.py
+
 ::: solnlib.time_parser

docs/timer_queue.md

@@ -1 +1,3 @@
+# timer_queue.py
+
 ::: solnlib.timer_queue

docs/user_access.md

@@ -1 +1,3 @@
+# user_access.py
+
 ::: solnlib.user_access

docs/utils.md

@@ -1 +1,3 @@
+# utils.py
+
 ::: solnlib.utils

mkdocs.yml

@@ -2,9 +2,13 @@ site_name: Splunk Solutions SDK
 
 theme:
   name: "material"
+  custom_dir: docs/theme_overrides
   palette:
     primary: "black"
     accent: "orange"
+  features:
+    - content.code.copy
+    - navigation.indexes
 
 markdown_extensions:
   - toc:
@@ -15,12 +19,14 @@ markdown_extensions:
   - codehilite
 
 plugins:
-  - search
   - mkdocstrings:
       handlers:
         python:
           options:
             show_if_no_docstring: true
+  - autorefs
+  - search
+  - print-site  # should be at the end
 
 nav:
   - Home: index.md