add sorting/search to server list

Author: ewdurbin

docs/conf.py

@@ -22,7 +22,7 @@
 # Add any Sphinx extension module names here, as strings. They can be
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
-extensions = ['myst_parser', "sphinx_copybutton"]
+extensions = ['myst_parser', "sphinx_copybutton", 'sphinxcontrib.jquery', 'sphinx_datatables']
 
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ["_templates"]
@@ -188,3 +188,6 @@
 
 # Enable MyST heading anchors
 myst_heading_anchors = 2
+
+# sphinx-datatables
+datatables_options = {"paging": False}

docs/requirements.txt

@@ -2,3 +2,4 @@ furo
 sphinx
 myst-parser
 sphinx-copybutton
+sphinx-datatables

docs/salt-server-list.rst

@@ -5,6 +5,7 @@
 
 .. csv-table::
    :header: "Name", "Purpose", "Contact", "Distro", "Datacener"
+   :class: sphinx-datatable display compact
 
 
    "backup.sfo1.psf.io", "Automated backup of infrastructure", "Infrastructure staff", "Ubuntu-24.04", "sfo1"

salt/base/config/salt-server-list.rst.jinja

@@ -7,14 +7,15 @@
 {% endfor %}
 
 .. csv-table::
-   :header: "Name", "Purpose", "Contact", "Distro", "Datacener", "Category"
+   :header: "Name", "Purpose", "Contact", "Distro", "Datacenter", "Category"
+   :class: sphinx-datatable display compact
 
 {% for server in salt['minion.list']()['minions']|sort -%}
 {% set role = salt['match.filter_by'](role_mapping, minion_id=server) -%}
 {% set datacenter = salt['mine.get']("*", "psf_dc").get(server, "") -%}
 {% set distro = salt['mine.get']("*", "osfinger").get(server, "") -%}
 {% set roleconfig = salt["pillar.get"]("roles", {}).get(role, {}) %}
-   "{{ server }}", "{{ roleconfig.get("purpose", "") }}", "{{ roleconfig.get("contact", "") }}", "{{ distro }}", "{{ datacenter }}","{{ roleconfig.get("category", "") }}"
+   "{{ server }}", "{{ roleconfig.get("purpose", "") }}", "{{ roleconfig.get("contact", "") }}", "{{ distro }}", "{{ datacenter }}", "{{ roleconfig.get("category", "") }}"
 {%- endfor %}
 
 ..