docs: kbase: Move index page to docs/kbase

Move docs/kbase.rst to docs/kbase/index.rst so that the directory itself
shows our index page rather than the autogenerated list of files by the
webserver.

Signed-off-by: Peter Krempa <pkrempa@redhat.com>
Reviewed-by: Michal Privoznik <mprivozn@redhat.com>

diff --git a/docs/docs.html.in b/docs/docs.html.in
index 920a773d793d71236818573795657c277bd45b66..77d5c78b3022a33f1bf45a1c6e66760f978ca28c 100644 (file)
--- a/docs/docs.html.in
+++ b/docs/docs.html.in
@@ -126,7 +126,7 @@
         <dt><a href="hvsupport.html">Driver support</a></dt>
         <dd>matrix of API support per hypervisor per release</dd>
 
-        <dt><a href="kbase.html">Knowledge Base</a></dt>
+        <dt><a href="kbase/index.html">Knowledge Base</a></dt>
         <dd>Task oriented guides to key features</dd>
       </dl>
     </div>

diff --git a/docs/index.html.in b/docs/index.html.in
index 97421c5e7b7b78de7edf7ff5249ab13999cb0e56..3057a052dd8daea926c5e34419ecd741cab4916c 100644 (file)
--- a/docs/index.html.in
+++ b/docs/index.html.in
@@ -64,7 +64,7 @@
         <dt><a href="https://wiki.libvirt.org">Wiki</a></dt>
         <dd>Read further community contributed content</dd>
 
-        <dt><a href="https://libvirt.org/kbase.html">Knowledge base</a></dt>
+        <dt><a href="https://libvirt.org/kbase/index.html">Knowledge base</a></dt>
         <dd>Learn more about libvirt through knowledge base</dd>
       </dl>
     </div>

diff --git a/docs/kbase.rst b/docs/kbase/index.rst
similarity index 57%
rename from docs/kbase.rst
rename to docs/kbase/index.rst
index a6de4b1a1a448f71835a397af834a37db545d334..cf424bd099620c6d84deb5945e8105356388f3b0 100644 (file)
--- a/docs/kbase.rst
+++ b/docs/kbase/index.rst
@@ -4,50 +4,50 @@ Knowledge base
 
 .. container:: panel widepanel
 
-   `Debug logs <kbase/debuglogs.html>`__
+   `Debug logs <debuglogs.html>`__
      Configuration of logging and tips on how to file a good bug report.
 
-   `Disk locking <kbase/locking.html>`__
+   `Disk locking <locking.html>`__
       Ensuring exclusive guest access to disks with
-      `virtlockd <kbase/locking-lockd.html>`__ or
-      `Sanlock <kbase/locking-sanlock.html>`__
+      `virtlockd <locking-lockd.html>`__ or
+      `Sanlock <locking-sanlock.html>`__
 
-   `Secure usage <kbase/secureusage.html>`__
+   `Secure usage <secureusage.html>`__
       Secure usage of the libvirt APIs
 
-   `Protected virtualization on s390 <kbase/s390_protected_virt.html>`__
+   `Protected virtualization on s390 <s390_protected_virt.html>`__
       Running secure s390 guests with IBM Secure Execution
 
-   `Launch security <kbase/launch_security_sev.html>`__
+   `Launch security <launch_security_sev.html>`__
       Securely launching VMs with AMD SEV
 
-   `Domain state capture <kbase/domainstatecapture.html>`__
+   `Domain state capture <domainstatecapture.html>`__
       Comparison between different methods of capturing domain state
 
-   `RPM deployment <kbase/rpm-deployment.html>`__
+   `RPM deployment <rpm-deployment.html>`__
       Explanation of the different RPM packages and illustration of which to
       pick for installation
 
-   `Backing chain management <kbase/backing_chains.html>`__
+   `Backing chain management <backing_chains.html>`__
       Explanation of how disk backing chain specification impacts libvirt's
       behaviour and basic troubleshooting steps of disk problems.
 
-   `Security with QEMU passthrough <kbase/qemu-passthrough-security.html>`__
+   `Security with QEMU passthrough <qemu-passthrough-security.html>`__
       Examination of the security protections used for QEMU and how they need
       configuring to allow use of QEMU passthrough with host files/devices.
 
-   `Systemtap <kbase/systemtap.html>`__
+   `Systemtap <systemtap.html>`__
       Explanation of how to use systemtap for libvirt tracing.
 
-   `Virtio-FS <kbase/virtiofs.html>`__
+   `Virtio-FS <virtiofs.html>`__
       Share a filesystem between the guest and the host
 
-   `KVM real time <kbase/kvm-realtime.html>`__
+   `KVM real time <kvm-realtime.html>`__
       Run real time workloads in guests on a KVM hypervisor
 
-   `Incremental backup internals <kbase/incrementalbackupinternals.html>`__
+   `Incremental backup internals <incrementalbackupinternals.html>`__
       Incremental backup implementation details relevant for users
 
-   `VM migration internals <kbase/migrationinternals.html>`__
+   `VM migration internals <migrationinternals.html>`__
       VM migration implementation details, complementing the info in
       `migration <migration.html>`__

diff --git a/docs/kbase/meson.build b/docs/kbase/meson.build
index c0fa72ff350193b4eeda759ca4324c8bea2c83b6..7b4e7abbd30dc546bf17a70f91a7eb43a5c2d7a1 100644 (file)
--- a/docs/kbase/meson.build
+++ b/docs/kbase/meson.build
@@ -3,6 +3,7 @@ docs_kbase_files = [
   'debuglogs',
   'domainstatecapture',
   'incrementalbackupinternals',
+  'index',
   'kvm-realtime',
   'launch_security_sev',
   'locking-lockd',

diff --git a/docs/meson.build b/docs/meson.build
index 28914f76f982fd6eec818d9cb03872ada4d2686c..5536005125106cbe961bc1fc80cfe345ec1f2924 100644 (file)
--- a/docs/meson.build
+++ b/docs/meson.build
@@ -118,7 +118,6 @@ docs_rst_files = [
   'formatdomain',
   'glib-adoption',
   'hacking',
-  'kbase',
   'libvirt-go',
   'libvirt-go-xml',
   'newreposetup',