From 06c6503932f6cf478a8e37fc8e8891c7b00acc93 Mon Sep 17 00:00:00 2001 From: parulin <161326115+parulin@users.noreply.github.com> Date: Sat, 26 Jul 2025 15:13:37 -0400 Subject: [PATCH] Fixing various warnings from sphinx-build * missing theme options in conf.py * orphaned pages are tagged as such * a markup mistake * duplicate labels * a code-block marked as python code --- developer/building/qubes-builder.rst | 2 ++ developer/general/gsod.rst | 18 ++++++------------ developer/releases/3_0/release-notes.rst | 5 ----- developer/system/vm-sudo.rst | 2 ++ user/advanced-topics/resize-disk-image.rst | 4 ---- .../download-mirrors.rst | 2 ++ .../installation-guide-4.1.rst | 2 ++ .../installation-guide.rst | 5 ++--- .../dasharo-fidelisguard-z690.rst | 2 ++ .../insurgo-privacybeast-x230.rst | 2 ++ .../certified-hardware/nitropad-t430.rst | 2 ++ .../certified-hardware/nitropad-v56.rst | 2 ++ .../certified-hardware/nitropad-x230.rst | 2 ++ .../certified-hardware/nitropc-pro-2.rst | 2 ++ .../certified-hardware/nitropc-pro.rst | 2 ++ .../novacustom-nv41-series.rst | 2 ++ .../novacustom-v54-series.rst | 2 ++ .../novacustom-v56-series.rst | 2 ++ .../certified-hardware/starlabs-starbook.rst | 2 ++ user/how-to-guides/how-to-use-devices.rst | 4 ++-- user/security-in-qubes/firewall_4.1.rst | 2 ++ user/security-in-qubes/split-gpg-2.rst | 2 ++ user/templates/templates.rst | 2 +- user/templates/windows/migrate-to-4-1.rst | 5 ++++- .../windows/qubes-windows-tools-4-0.rst | 4 +++- .../windows/qubes-windows-tools-4-1.rst | 2 ++ user/templates/windows/windows-qubes-4-0.rst | 2 ++ user/templates/windows/windows-qubes-4-1.rst | 2 ++ 28 files changed, 58 insertions(+), 29 deletions(-) diff --git a/developer/building/qubes-builder.rst b/developer/building/qubes-builder.rst index e193e46b..870e25c6 100644 --- a/developer/building/qubes-builder.rst +++ b/developer/building/qubes-builder.rst @@ -1,3 +1,5 @@ +:orphan: + ============= Qubes builder ============= diff --git a/developer/general/gsod.rst b/developer/general/gsod.rst index 7230be65..e76387a4 100644 --- a/developer/general/gsod.rst +++ b/developer/general/gsod.rst @@ -113,22 +113,17 @@ Instructional video series ^^^^^^^^^^^^^^^^^^^^^^^^^^ -.. _the-projects-problem-1: - - -The project's problem -^^^^^^^^^^^^^^^^^^^^^ +Instructional video series: The project's problem +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ There is user demand for high-quality, up-to-date video guides that take users from zero Linux knowledge to using Qubes as a daily driver and performing specific tasks inside of Qubes, but almost no such videos exist. Although most of the required knowledge is documented, many users report that they would prefer to watch videos rather than read text or that they would find videos easier to understand and follow along with. -.. _the-projects-scope-1: - -The project's scope -^^^^^^^^^^^^^^^^^^^ +Instructional video series: The project's scope +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ @@ -219,11 +214,10 @@ Below is an example of the content (which is already :doc:`documented `) The project is estimated to need around six months to complete (see the timeline below). Qubes team members, including Michael Carbone, Andrew Wong, and Marek Marczykowski-Górecki, will supervise and support the creator. -.. _measuring-the-projects-success-1: -Measuring the project's success -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +Instructional video series: Measuring the project's success +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ diff --git a/developer/releases/3_0/release-notes.rst b/developer/releases/3_0/release-notes.rst index f8aaed7f..9c96ceaf 100644 --- a/developer/releases/3_0/release-notes.rst +++ b/developer/releases/3_0/release-notes.rst @@ -3,11 +3,6 @@ Qubes R3.0 release notes ======================== -Qubes R3.0 Release Notes ------------------------- - - - This Qubes OS release is dedicated to the memory of Caspar Bowden. diff --git a/developer/system/vm-sudo.rst b/developer/system/vm-sudo.rst index e8a41289..ef25369b 100644 --- a/developer/system/vm-sudo.rst +++ b/developer/system/vm-sudo.rst @@ -1,3 +1,5 @@ +:orphan: + ================================= Passwordless root access in qubes ================================= diff --git a/user/advanced-topics/resize-disk-image.rst b/user/advanced-topics/resize-disk-image.rst index cd622e42..f657bc09 100644 --- a/user/advanced-topics/resize-disk-image.rst +++ b/user/advanced-topics/resize-disk-image.rst @@ -6,10 +6,6 @@ Resize disk image This page is intended for advanced users. -Resizing Disk Images --------------------- - - By default Qubes uses thin volumes for the disk images. This means that space is not actually allocated for the volume until it is used. So a 2GB private volume with 100M of files will only use 100M. This explains how you can have *many* qubes with large private volumes on quite a small disk. This is called over provisioning. You should keep an eye on the disk-space widget to see how much free space you actually have. It is easy to increase the size of disk images. There are risks attached to reducing the size of an image, and in general you should not need to do this. diff --git a/user/downloading-installing-upgrading/download-mirrors.rst b/user/downloading-installing-upgrading/download-mirrors.rst index 3dff23f6..7fe970b6 100644 --- a/user/downloading-installing-upgrading/download-mirrors.rst +++ b/user/downloading-installing-upgrading/download-mirrors.rst @@ -1,3 +1,5 @@ +:orphan: + ================ Download mirrors ================ diff --git a/user/downloading-installing-upgrading/installation-guide-4.1.rst b/user/downloading-installing-upgrading/installation-guide-4.1.rst index 6bf9d1ee..2a497feb 100644 --- a/user/downloading-installing-upgrading/installation-guide-4.1.rst +++ b/user/downloading-installing-upgrading/installation-guide-4.1.rst @@ -1,3 +1,5 @@ +:orphan: + ============================ Qubes 4.1 Installation guide ============================ diff --git a/user/downloading-installing-upgrading/installation-guide.rst b/user/downloading-installing-upgrading/installation-guide.rst index 97a2e148..1d236fa7 100644 --- a/user/downloading-installing-upgrading/installation-guide.rst +++ b/user/downloading-installing-upgrading/installation-guide.rst @@ -219,11 +219,10 @@ The new user you create has full administrator privileges and is protected by a |Account name and password creation window.| -.. _installation-1: -Installation -^^^^^^^^^^^^ +Begin Installation +^^^^^^^^^^^^^^^^^^ diff --git a/user/hardware/certified-hardware/dasharo-fidelisguard-z690.rst b/user/hardware/certified-hardware/dasharo-fidelisguard-z690.rst index d4600a11..1cde2791 100644 --- a/user/hardware/certified-hardware/dasharo-fidelisguard-z690.rst +++ b/user/hardware/certified-hardware/dasharo-fidelisguard-z690.rst @@ -1,3 +1,5 @@ +:orphan: + ========================= Dasharo FidelisGuard Z690 ========================= diff --git a/user/hardware/certified-hardware/insurgo-privacybeast-x230.rst b/user/hardware/certified-hardware/insurgo-privacybeast-x230.rst index eea7b97f..6b78a973 100644 --- a/user/hardware/certified-hardware/insurgo-privacybeast-x230.rst +++ b/user/hardware/certified-hardware/insurgo-privacybeast-x230.rst @@ -1,3 +1,5 @@ +:orphan: + ========================= Insurgo PrivacyBeast X230 ========================= diff --git a/user/hardware/certified-hardware/nitropad-t430.rst b/user/hardware/certified-hardware/nitropad-t430.rst index 8c9ca7a4..57c7b0e6 100644 --- a/user/hardware/certified-hardware/nitropad-t430.rst +++ b/user/hardware/certified-hardware/nitropad-t430.rst @@ -1,3 +1,5 @@ +:orphan: + ============= NitroPad T430 ============= diff --git a/user/hardware/certified-hardware/nitropad-v56.rst b/user/hardware/certified-hardware/nitropad-v56.rst index 467808df..72a4e0a4 100644 --- a/user/hardware/certified-hardware/nitropad-v56.rst +++ b/user/hardware/certified-hardware/nitropad-v56.rst @@ -1,3 +1,5 @@ +:orphan: + ============ NitroPad V56 ============ diff --git a/user/hardware/certified-hardware/nitropad-x230.rst b/user/hardware/certified-hardware/nitropad-x230.rst index ea5e6be9..472e00fc 100644 --- a/user/hardware/certified-hardware/nitropad-x230.rst +++ b/user/hardware/certified-hardware/nitropad-x230.rst @@ -1,3 +1,5 @@ +:orphan: + ============= NitroPad X230 ============= diff --git a/user/hardware/certified-hardware/nitropc-pro-2.rst b/user/hardware/certified-hardware/nitropc-pro-2.rst index 20efd9a6..79f76d84 100644 --- a/user/hardware/certified-hardware/nitropc-pro-2.rst +++ b/user/hardware/certified-hardware/nitropc-pro-2.rst @@ -1,3 +1,5 @@ +:orphan: + ============= NitroPC Pro 2 ============= diff --git a/user/hardware/certified-hardware/nitropc-pro.rst b/user/hardware/certified-hardware/nitropc-pro.rst index ef5b5fa0..33514d02 100644 --- a/user/hardware/certified-hardware/nitropc-pro.rst +++ b/user/hardware/certified-hardware/nitropc-pro.rst @@ -1,3 +1,5 @@ +:orphan: + =========== NitroPC Pro =========== diff --git a/user/hardware/certified-hardware/novacustom-nv41-series.rst b/user/hardware/certified-hardware/novacustom-nv41-series.rst index 9ddb7e3f..d90f5279 100644 --- a/user/hardware/certified-hardware/novacustom-nv41-series.rst +++ b/user/hardware/certified-hardware/novacustom-nv41-series.rst @@ -1,3 +1,5 @@ +:orphan: + ====================== NovaCustom NV41 Series ====================== diff --git a/user/hardware/certified-hardware/novacustom-v54-series.rst b/user/hardware/certified-hardware/novacustom-v54-series.rst index ea96fc9d..1f4bf35b 100644 --- a/user/hardware/certified-hardware/novacustom-v54-series.rst +++ b/user/hardware/certified-hardware/novacustom-v54-series.rst @@ -1,3 +1,5 @@ +:orphan: + ===================== NovaCustom V54 Series ===================== diff --git a/user/hardware/certified-hardware/novacustom-v56-series.rst b/user/hardware/certified-hardware/novacustom-v56-series.rst index 69692eed..a1799077 100644 --- a/user/hardware/certified-hardware/novacustom-v56-series.rst +++ b/user/hardware/certified-hardware/novacustom-v56-series.rst @@ -1,3 +1,5 @@ +:orphan: + ===================== NovaCustom V56 Series ===================== diff --git a/user/hardware/certified-hardware/starlabs-starbook.rst b/user/hardware/certified-hardware/starlabs-starbook.rst index 78275f2f..d11e4745 100644 --- a/user/hardware/certified-hardware/starlabs-starbook.rst +++ b/user/hardware/certified-hardware/starlabs-starbook.rst @@ -1,3 +1,5 @@ +:orphan: + ================== Star Labs StarBook ================== diff --git a/user/how-to-guides/how-to-use-devices.rst b/user/how-to-guides/how-to-use-devices.rst index 8e94a24d..d247a6bb 100644 --- a/user/how-to-guides/how-to-use-devices.rst +++ b/user/how-to-guides/how-to-use-devices.rst @@ -77,8 +77,8 @@ Device Classes -Actions -^^^^^^^ +``qvm-device`` Actions +^^^^^^^^^^^^^^^^^^^^^^ ``qvm-device`` supports three actions: diff --git a/user/security-in-qubes/firewall_4.1.rst b/user/security-in-qubes/firewall_4.1.rst index fa5ef8a3..0b28ba66 100644 --- a/user/security-in-qubes/firewall_4.1.rst +++ b/user/security-in-qubes/firewall_4.1.rst @@ -1,3 +1,5 @@ +:orphan: + ============ Firewall 4.1 ============ diff --git a/user/security-in-qubes/split-gpg-2.rst b/user/security-in-qubes/split-gpg-2.rst index 772537ea..2913f668 100644 --- a/user/security-in-qubes/split-gpg-2.rst +++ b/user/security-in-qubes/split-gpg-2.rst @@ -1,3 +1,5 @@ +:orphan: + =========== Split GPG-2 =========== diff --git a/user/templates/templates.rst b/user/templates/templates.rst index 15403d98..e08c032f 100644 --- a/user/templates/templates.rst +++ b/user/templates/templates.rst @@ -71,7 +71,7 @@ By installing these templates, you are trusting not only the Qubes developers an - :doc:`Gentoo Minimal ` -- :doc:`CentOS* ` +- `CentOS* `__ diff --git a/user/templates/windows/migrate-to-4-1.rst b/user/templates/windows/migrate-to-4-1.rst index 59bcff9d..7452f1c0 100644 --- a/user/templates/windows/migrate-to-4-1.rst +++ b/user/templates/windows/migrate-to-4-1.rst @@ -1,3 +1,5 @@ +:orphan: + ======================================= Migrating Windows qubes to Qubes OS 4.1 ======================================= @@ -82,6 +84,7 @@ The PV disk drivers used for migration can be removed after successful installat After successful uninstallation of the PV disk drivers, the disks will appear as QEMU ATA disks. .. warning:: - This change may lead Windows to declare that the hardware has changed and that in consequence, the activation is no longer valid, possibly complaining that the use of the software is no longer lawful. It should be possible to reactivate the software if a valid product key is provided. + + This change may lead Windows to declare that the hardware has changed and that in consequence, the activation is no longer valid, possibly complaining that the use of the software is no longer lawful. It should be possible to reactivate the software if a valid product key is provided. diff --git a/user/templates/windows/qubes-windows-tools-4-0.rst b/user/templates/windows/qubes-windows-tools-4-0.rst index 707b8884..15cd8cf7 100644 --- a/user/templates/windows/qubes-windows-tools-4-0.rst +++ b/user/templates/windows/qubes-windows-tools-4-0.rst @@ -1,3 +1,5 @@ +:orphan: + ========================================= Qubes Windows Tools (QWT) in Qubes OS 4.0 ========================================= @@ -100,7 +102,7 @@ This will allow you to install the Qubes Windows Tools on Windows 10 both as a S 5. Download the Qubes Windows Tools (``qubes-tools-4.0.1.3.exe``) from `the qubes FTP server `__ and move it to ``C:\``. -6. Check the integrity of the file ``qubes-tools-4.0.1.3.exe``by comparing its hash checksum. This can be done using the Windows command ``certutil`` on the windows command prompt (``cmd.exe``) and specifying an appropriate hash algorithm like: +6. Check the integrity of the file ``qubes-tools-4.0.1.3.exe`` by comparing its hash checksum. This can be done using the Windows command ``certutil`` on the windows command prompt (``cmd.exe``) and specifying an appropriate hash algorithm like: .. code:: doscon diff --git a/user/templates/windows/qubes-windows-tools-4-1.rst b/user/templates/windows/qubes-windows-tools-4-1.rst index 6ffae77c..631d7fb4 100644 --- a/user/templates/windows/qubes-windows-tools-4-1.rst +++ b/user/templates/windows/qubes-windows-tools-4-1.rst @@ -1,3 +1,5 @@ +:orphan: + ========================= Qubes Windows Tools (QWT) ========================= diff --git a/user/templates/windows/windows-qubes-4-0.rst b/user/templates/windows/windows-qubes-4-0.rst index 03186858..6db253fb 100644 --- a/user/templates/windows/windows-qubes-4-0.rst +++ b/user/templates/windows/windows-qubes-4-0.rst @@ -1,3 +1,5 @@ +:orphan: + ============================================ How to install Windows qubes in Qubes OS 4.0 ============================================ diff --git a/user/templates/windows/windows-qubes-4-1.rst b/user/templates/windows/windows-qubes-4-1.rst index 5514a05d..430f935a 100644 --- a/user/templates/windows/windows-qubes-4-1.rst +++ b/user/templates/windows/windows-qubes-4-1.rst @@ -1,3 +1,5 @@ +:orphan: + ======================================== How to install Windows qubes in Qubes OS ========================================