From a2a089c65ef1a5684d431918e2d37ac2db708b4b Mon Sep 17 00:00:00 2001 From: Peter Krempa Date: Mon, 4 Apr 2022 16:14:31 +0200 Subject: [PATCH] docs: Convert 'docs' index page to rst Along with the conversion we need to adapt the stylesheets to apply to the new document similarly to how we do that in the knowledge base. Note that one visible difference is that now a 'Documentation' heading is visible on top of the page. Signed-off-by: Peter Krempa Reviewed-by: Michal Privoznik --- docs/css/libvirt.css | 17 ++-- docs/docs.html.in | 188 ------------------------------------------- docs/docs.rst | 175 ++++++++++++++++++++++++++++++++++++++++ docs/meson.build | 2 +- 4 files changed, 188 insertions(+), 194 deletions(-) delete mode 100644 docs/docs.html.in create mode 100644 docs/docs.rst diff --git a/docs/css/libvirt.css b/docs/css/libvirt.css index b08271ea4d..2ae80f8595 100644 --- a/docs/css/libvirt.css +++ b/docs/css/libvirt.css @@ -105,8 +105,8 @@ } #index.document, -#docs.document, #hvsupport.document, +#documentation.document, #knowledge-base.document { width: inherit; @@ -397,6 +397,7 @@ h6:hover > a.headerlink { } div.panel, +#documentation .section, #knowledge-base .section { width: 24%; @@ -406,6 +407,7 @@ div.panel, } div.panel h2, +#documentation .section h1, #knowledge-base .section h1 { margin-top: 0px; padding: 0.5em; @@ -423,15 +425,12 @@ div.panel h2, height: 300px; } +#documentation.document > h1, #knowledge-base.document > h1 { text-align: center; padding: 1em; } -#docs.document h1 { - visibility: hidden; -} - br.clear { clear: both; border: 0px; @@ -485,11 +484,13 @@ br.clear { } div.panel dd, +#documentation dd, #knowledge-base dd { font-size: smaller; } div.panel a, +#documentation a, #knowledge-base a { text-decoration: none; } @@ -497,6 +498,9 @@ div.panel a, div.panel ul, div.panel p, div.panel dl, +#documentation ul, +#documentation p, +#documentation dl, #knowledge-base ul, #knowledge-base p, #knowledge-base dl { @@ -505,16 +509,19 @@ div.panel dl, } div.panel ul, +#documentation ul, #knowledge-base ul { margin-left: 1em; } div.panel dt, +#documentation dt, #knowledge-base dt { margin: 0px; } div.panel dd, +#documentation dd, #knowledge-base dd { margin: 0px; margin-bottom: 1em; diff --git a/docs/docs.html.in b/docs/docs.html.in deleted file mode 100644 index ff7a95fae7..0000000000 --- a/docs/docs.html.in +++ /dev/null @@ -1,188 +0,0 @@ - - - - -

Documentation

-
-

Deployment / operation

- -
-
Applications
-
Applications known to use libvirt
- -
Manual pages
-
Manual pages for libvirt tools / daemons
- -
Windows
-
Downloads for Windows
- -
macOS
-
Working with libvirt on macOS
- -
Migration
-
Migrating guests between machines
- -
Daemons
-
Overview of the daemons provided by libvirt
- -
Remote access
-
Enable remote access over TCP
- -
Authentication
-
Configure authentication for the libvirt daemon
- -
Access control
-
Configure access control libvirt APIs with polkit
- -
Logging
-
The library and the daemon logging support
- -
Audit log
-
Audit trail logs for host operations
- -
Firewall
-
Firewall and network filter configuration
- -
Hooks
-
Hooks for system specific management
- -
NSS module
-
Enable domain host name translation to IP addresses
- -
FAQ
-
Frequently asked questions
-
- -
- -
-

Application development

-
-
API reference
-
Reference manual for the C public API, split in - common, - domain, - domain checkpoint, - domain snapshot, - error, - event, - host, - interface, - network, - node device, - network filter, - secret, - storage, - stream - and - admin, - QEMU, - LXC libs -
- -
Language bindings and API modules
-
Bindings of the libvirt API for - c#, - go, - java, - ocaml, - perl, - python, - php, - ruby - and integration API modules for - D-Bus
- - -
XML schemas
-
Description of the XML schemas for - domains, - networks, - network ports, - network filtering, - storage, - storage encryption, - capabilities, - domain capabilities, - storage pool capabilities, - node devices, - secrets, - snapshots, - checkpoints, - backup jobs
- -
URI format
-
The URI formats used for connecting to libvirt
- -
CGroups
-
Control groups integration
- -
Drivers
-
Hypervisor specific driver information
- -
Support guarantees
-
Details of support status for various interfaces
- -
Driver support
-
matrix of API support per hypervisor per release
- -
Knowledge Base
-
Task oriented guides to key features
-
-
- -
-

Project development

-
-
Contributor guidelines
-
General hacking guidelines for contributors
- -
Docs style guide
-
Style guidelines for reStructuredText docs
- -
Project strategy
-
Sets a vision for future direction & technical choices
- -
CI Testing
-
Details of the Continuous Integration testing strategy
- -
Bug reports
-
How and where to report bugs and request features
- -
Compiling
-
How to compile libvirt
- -
Goals
-
Terminology and goals of libvirt API
- -
API concepts
-
The libvirt API concepts
- -
API extensions
-
Adding new public libvirt APIs
- -
Event loop and worker pool
-
Libvirt's event loop and worker pool mode
- -
Spawning commands
-
Spawning commands from libvirt driver code
- -
RPC protocol & APIs
-
RPC protocol information and API / dispatch guide
- -
Lock managers
-
Use lock managers to protect disk content
- -
Functional testing
-
Testing libvirt with TCK test suite and - Libvirt-test-API
- -
New repo setup
-
Procedure for configuring new git repositories for libvirt
-
-
- -
- - - diff --git a/docs/docs.rst b/docs/docs.rst new file mode 100644 index 0000000000..299c26d09b --- /dev/null +++ b/docs/docs.rst @@ -0,0 +1,175 @@ +============= +Documentation +============= + +Deployment / operation +---------------------- + +`Applications `__ + Applications known to use libvirt + +`Manual pages `__ + Manual pages for libvirt tools / daemons + +`Windows `__ + Downloads for Windows + +`macOS `__ + Working with libvirt on macOS + +`Migration `__ + Migrating guests between machines + +`Daemons `__ + Overview of the daemons provided by libvirt + +`Remote access `__ + Enable remote access over TCP + +`TLS certs `__ + Generate and deploy x509 certificates for TLS + +`Authentication `__ + Configure authentication for the libvirt daemon + +`Access control `__ + Configure access control libvirt APIs with `polkit `__ + +`Logging `__ + The library and the daemon logging support + +`Audit log `__ + Audit trail logs for host operations + +`Firewall `__ + Firewall and network filter configuration + +`Hooks `__ + Hooks for system specific management + +`NSS module `__ + Enable domain host name translation to IP addresses + +`FAQ `__ + Frequently asked questions + +Application development +----------------------- + +`API reference `__ + Reference manual for the C public API, split in + `common `__, + `domain `__, + `domain checkpoint `__, + `domain snapshot `__, + `error `__, + `event `__, + `host `__, + `interface `__, + `network `__, + `node device `__, + `network filter `__, + `secret `__, + `storage `__, + `stream `__ and + `admin `__, + `QEMU `__, + `LXC `__ libs + +`Language bindings and API modules `__ + Bindings of the libvirt API for + `c# `__, + `go `__, + `java `__, + `ocaml `__, + `perl `__, + `python `__, + `php `__, + `ruby `__ + and integration API modules for + `D-Bus `__ + +`XML schemas `__ + Description of the XML schemas for + `domains `__, + `networks `__, + `network ports `__, + `network filtering `__, + `storage `__, + `storage encryption `__, + `capabilities `__, + `domain capabilities `__, + `storage pool capabilities `__, + `node devices `__, + `secrets `__, + `snapshots `__, + `checkpoints `__, + `backup jobs `__ + +`URI format `__ + The URI formats used for connecting to libvirt + +`CGroups `__ + Control groups integration + +`Drivers `__ + Hypervisor specific driver information + +`Support guarantees `__ + Details of support status for various interfaces + +`Driver support `__ + matrix of API support per hypervisor per release + +`Knowledge Base `__ + Task oriented guides to key features + +Project development +------------------- + +`Contributor guidelines `__ + General hacking guidelines for contributors + +`Docs style guide `__ + Style guidelines for reStructuredText docs + +`Project strategy `__ + Sets a vision for future direction & technical choices + +`CI Testing `__ + Details of the Continuous Integration testing strategy + +`Bug reports `__ + How and where to report bugs and request features + +`Compiling `__ + How to compile libvirt + +`Goals `__ + Terminology and goals of libvirt API + +`API concepts `__ + The libvirt API concepts + +`API extensions `__ + Adding new public libvirt APIs + +`Event loop and worker pool `__ + Libvirt's event loop and worker pool mode + +`Spawning commands `__ + Spawning commands from libvirt driver code + +`RPC protocol & APIs `__ + RPC protocol information and API / dispatch guide + +`Lock managers `__ + Use lock managers to protect disk content + +`Functional testing `__ + Testing libvirt with + `TCK test suite `__ and + `Libvirt-test-API `__ + +`New repo setup `__ + Procedure for configuring new git repositories for libvirt diff --git a/docs/meson.build b/docs/meson.build index 91c6fbe844..3b7afd5baa 100644 --- a/docs/meson.build +++ b/docs/meson.build @@ -18,7 +18,6 @@ docs_assets = [ ] docs_html_in_files = [ - 'docs', 'formatcaps', 'formatnetwork', 'formatnode', @@ -51,6 +50,7 @@ docs_rst_files = [ 'csharp', 'daemons', 'dbus', + 'docs', 'downloads', 'drivers', 'drvbhyve',