update sphinx and dependencies

(cherry picked from commit bcef0f7)

.gitignore

@@ -1,18 +1,23 @@
 # Sphinx
 _build/
+localazy_private.json
 
 # python virtualenv
 venv/
 ENV/
 .venv
 Pipfile.lock
+Pipfile
 
 # put various editor ignores here
 .vscode/
 *.vpj
 *.vpw
 *.vpwhist
 *.vtg
+.idea/
+.idea
+.idea/*
 
 # python cache files
 *.pyc
@@ -23,4 +28,4 @@ __pycache__
 .envrc
 
 # os specific
-.DS_Store
+.DS_Store

docs/conf.py

@@ -46,7 +46,7 @@
               'sphinx.ext.graphviz',
               'notfound.extension',
               'myst_parser',
-              'sphinx_panels',
+              'sphinx_design',
               'vyos'
 ]
 

docs/index.rst

@@ -4,49 +4,50 @@
 VyOS User Guide
 ###############
 
-.. panels::
-   :container: container-lg pb-3
-   :column: col-lg-4 col-md-4 col-sm-6 col-xs-12 p-2
-
-   Get / Build VyOS
-   ^^^^^^^^^^^^^^^^
-   Quickly :ref:`Build<build>` your own Image or take a look at how to :ref:`download<download>` a free or supported version.
-   ---
-
-   Install VyOS
-   ^^^^^^^^^^^^
-   Read about how to install VyOS on :ref:`Bare Metall<installation>` or in a
-   :ref:`Virtual Environment<virtual_env>` and
-   how to use an image with the usual :ref:`cloud<cloud_env>` providers
-   ---
-
-   Configuration and Operation
-   ^^^^^^^^^^^^^^^^^^^^^^^^^^^
-   Use the :ref:`Quickstart Guide<quick-start>`, to have a fast overview. Or go deeper and
-   set up :ref:`advanced routing<protocols>`,
-   :ref:`VRFs<vrf>`, or
-   :ref:`VPNs<vpn>` for example.
-   ---
-
-   Automate
-   ^^^^^^^^
-   Integrate VyOS in your automation Workflow with
-   :ref:`Ansible<vyos-ansible>`,
-   have your own :ref:`local scripts<command-scripting>`, or configure VyOS with the :ref:`HTTPS-API<vyosapi>`.
-   ---
-
-   Examples
-   ^^^^^^^^
-   Get some inspiration from the :ref:`Configuration Blueprints<examples>`
-   to build your infrastructure.
-   ---
-
-   Contribute and Community
-   ^^^^^^^^^^^^^^^^^^^^^^^^
-   | There are many ways to contribute to the project.
-   | Add missing parts or improve the :ref:`Documentation<documentation>`.
-   | Discuss in `Slack <https://slack.vyos.io/>`_ or the `Forum <https://forum.vyos.io>`_.
-   | Or you can pick up a `Task <https://vyos.dev/>`_ and fix the :ref:`code<development>`.
+.. grid:: 3
+   :gutter: 2
+
+   .. grid-item-card:: Get / Build VyOS
+
+
+      Quickly :ref:`Build<contributing/build-vyos:build vyos>` your own Image or take a look at how to :ref:`download<installation/install:download>` a free or supported version.
+
+
+   .. grid-item-card:: Install VyOS
+
+      Read about how to install VyOS on :ref:`Bare Metal<installation/install:installation>` or in a
+      :ref:`Virtual Environment<installation/virtual/index:running vyos in virtual environments>` and
+      how to use an image with the usual :ref:`cloud<installation/cloud/index:running VyOS in Cloud Environments>` providers 
+
+
+   .. grid-item-card:: Configuration and Operation
+
+      Use the :ref:`Quickstart Guide<quick-start:Quick Start>`, to have a fast overview. Or go deeper and
+      set up :ref:`advanced routing<configuration/protocols/index:protocols>`,
+      :ref:`VRFs<configuration/vrf/index:vrf>`, or
+      :ref:`VPNs<configuration/vpn/index:vpn>` for example.
+
+
+   .. grid-item-card:: Automate
+
+      Integrate VyOS in your automation Workflow with 
+      :ref:`Ansible<vyos-ansible>`,
+      have your own :ref:`local scripts<command-scripting>`, or configure VyOS with the :ref:`HTTPS-API<vyosapi>`.
+
+
+   .. grid-item-card::  Examples
+
+      Get some inspiration from the :ref:`Configuration Blueprints<configexamples/index:Configuration Blueprints>`
+      to build your infrastructure.
+
+
+   .. grid-item-card:: Contribute and Community
+
+      | There are many ways to contribute to the project.
+      | Add missing parts or improve the :ref:`Documentation<documentation:Write Documentation>`.
+      | Discuss in `Slack <https://slack.vyos.io/>`_ or the `Forum <https://forum.vyos.io>`_.
+      | Or you can pick up a `Task <https://vyos.dev/>`_ and fix the :ref:`code<contributing/development:development>`.
+
 
 .. toctree::
    :hidden:

requirements.txt

@@ -1,8 +1,8 @@
-urllib3==1.26.15
-Sphinx==4.5.0
-sphinx-rtd-theme==1.0.0
+urllib3==2.1.0
+Sphinx==7.2.6
+sphinx-rtd-theme==2.0.0
 sphinx-autobuild==2021.3.14
-sphinx-notfound-page==0.8
-lxml==4.9.1
-myst-parser==0.17.1
-sphinx-panels==0.6.0
+sphinx-notfound-page==1.0.0
+lxml==5.1.0
+myst-parser==2.0.0
+sphinx_design==0.5.0