manual fixes

Manual fixes after the conversion tool. Mostly based on sphinx warnings.

Author: marmarek

developer/building/development-workflow.rst

@@ -145,7 +145,7 @@ To actually build RPMs, in qubes-builder:
 RPMs will appear in ``artifacts/repository/destination_name/package_name`` (for example ``artifacts/repository/host-fc37/linux-kernel-6.6.31-1.1/``
 
 Useful :doc:`QubesBuilder </developer/building/qubes-builder-v2>` commands
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 
 1. ``./qb package diff`` - show uncommitted changes

developer/general/gsoc.rst

@@ -90,7 +90,7 @@ Project Ideas
 
 These project ideas were contributed by our developers and may be incomplete. If you are interested in submitting a proposal based on these ideas, you should contact the :ref:`qubes-devel mailing list <introduction/support:qubes-devel>` and associated GitHub issue to learn more about the idea.
 
-.. code:: bash
+.. code::
 
       ### Adding a Proposal
       

developer/services/admin-api.rst

@@ -762,7 +762,7 @@ Example backup profile:
    include:
      - work
      - personal
-     - ``vault``
+     - vault
      - banking
 
    # Store the backup on external disk

introduction/intro.rst

@@ -3,7 +3,7 @@ Introduction
 ============
 
 What is Qubes OS?
-----------------
+-----------------
 
 Qubes OS is a free and open-source, security-oriented operating system for
 single-user desktop computing. Qubes OS `leverages Xen-based virtualization <https://wiki.xen.org/wiki/Xen_Project_Software_Overview>`__ to allow for the creation and management of isolated compartments called :ref:`qubes <user/reference/glossary:qube>`.
@@ -67,7 +67,7 @@ Features
 
 
 Why Qubes OS?
-------------
+-------------
 
 
 Physical isolation is a given safeguard that the digital world lacks
@@ -127,7 +127,7 @@ fact, Qubes has `distinct advantages over physical air gaps <https://invisibleth
 
 
 Made to support vulnerable users and power users alike
------------------------------------------------------
+------------------------------------------------------
 
 
 Qubes provides practical, usable security to vulnerable and

introduction/video-tours.rst

@@ -17,13 +17,15 @@ Watch all the talks from Qubes OS Summit 2022, which took place September 9-11,
              :height: 315
              :width: 560
              :align: left
+
 ----
 
 
 .. youtube:: A9GrlQsQc7Q
              :height: 315
              :width: 560
              :align: left
+
 ----
 
 
@@ -35,7 +37,6 @@ Watch all the talks from Qubes OS Summit 2022, which took place September 9-11,
 
 
 
-
 Micah Lee presents "Qubes OS: The Operating System That Can Protect You Even If You Get Hacked"
 -----------------------------------------------------------------------------------------------
 
@@ -55,10 +56,6 @@ Explaining Computers presents "Qubes OS: Security Oriented Operating System"
 ----------------------------------------------------------------------------
 
 
-
-----
-
-
 .. youtube:: hWDvS_Mp6gc
              :height: 315
              :width: 560

project-security/security-pack.rst

@@ -31,7 +31,7 @@ The following example demonstrates one method of obtaining the qubes-secpack and
 
 1. Use Git to clone the qubes-secpack repo.
 
-   .. code:: bash
+   .. code::
 
          $ git clone https://github.com/QubesOS/qubes-secpack.git
          Cloning into 'qubes-secpack'...
@@ -44,7 +44,7 @@ The following example demonstrates one method of obtaining the qubes-secpack and
 
 2. Import the included PGP keys. See our `PGP key policies <#pgp-key-policies>`__ for important information about these keys.
 
-   .. code:: bash
+   .. code::
 
          $ gpg --import qubes-secpack/keys/*/*
          gpg: directory `/home/user/.gnupg' created

project-security/verifying-signatures.rst

@@ -167,7 +167,7 @@ Once you’ve observed enough matching fingerprints from enough independent sour
 
 Now that you’ve imported the authentic QMSK, set its trust level to “ultimate” so that it can be used to automatically verify all the keys signed by the QMSK (in particular, RSKs).
 
-.. code:: bash
+.. code::
 
       $ gpg2 --edit-key 0x427F11FD0FAA4B080123F01CDDFA1A3E36879494
       gpg (GnuPG) 1.4.18; Copyright (C) 2014 Free Software Foundation, Inc.
@@ -647,7 +647,7 @@ Why am I getting "CRC error; […] no signature found […]"?
 You’re not verifying against the correct `detached PGP signature file <#how-to-verify-detached-pgp-signatures-on-qubes-isos>`__, or the signature file has been modified. Try downloading it again or from a different source.
 
 Do I have to verify both the `detached PGP signature file <#how-to-verify-detached-pgp-signatures-on-qubes-isos>`__ and the `cryptographic hash values <#how-to-verify-the-cryptographic-hash-values-of-qubes-isos>`__?
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 
 No, either method is sufficient by itself, but you can do both if you like.

user/downloading-installing-upgrading/download-mirrors.rst

@@ -9,7 +9,7 @@ List of Download Mirrors
 ------------------------
 
 
-The full list of known Qubes download mirrors is available `here <https://www.qubes-os.org/downloads/#mirrors>__.
+The full list of known Qubes download mirrors is available `here <https://www.qubes-os.org/downloads/#mirrors>`__.
 
 Instructions for Mirror Operators
 ---------------------------------

user/downloading-installing-upgrading/upgrade/3_0.rst

@@ -161,7 +161,7 @@ Because of above limitations, you will need to configure some of those manually.
 
 2. Start the VM from command line:
 
-   .. code:: bash
+   .. code::
 
          [user@dom0 ~]$ qvm-start custom-template
          --> Loading the VM (type = template)...
@@ -177,7 +177,7 @@ Because of above limitations, you will need to configure some of those manually.
 
 3. Access VM console:
 
-   .. code:: bash
+   .. code::
 
          [user@dom0 ~]$ virsh -c xen:/// console custom-template
 

user/templates/windows/windows-qubes-4-0.rst

@@ -238,7 +238,7 @@ Set the debug flag in order to have a graphical console:
 
 The second part of the installation process will crash with the standard VGA video adapter and the VM will stay in “transient” mode with the following error in ``guest-win7new-dm.log``:
 
-.. code:: bash
+.. code::
 
       qemu: /home/user/qubes-src/vmm-xen-stubdom-linux/build/qemu/exec.c:1187: cpu_physical_memory_snapshot_get_dirty: Assertion `start + length <= snap->end' failed.