diff --git a/developer/system/qubes-template-configs.md b/developer/building/qubes-template-configs.md similarity index 81% rename from developer/system/qubes-template-configs.md rename to developer/building/qubes-template-configs.md index be1c973f..7c97b775 100644 --- a/developer/system/qubes-template-configs.md +++ b/developer/building/qubes-template-configs.md @@ -3,5 +3,5 @@ lang: en layout: doc permalink: /doc/qubes-template-configs/ redirect_to: https://github.com/QubesOS/qubes-template-configs -title: Qubes template configs +title: Qubes Template Configs --- diff --git a/developer/code/license.md b/developer/code/license.md index 39b0f653..91325bf4 100644 --- a/developer/code/license.md +++ b/developer/code/license.md @@ -7,7 +7,7 @@ redirect_from: - /doc/QubesLicensing/ - /wiki/QubesLicensing/ ref: 52 -title: License +title: Software License --- diff --git a/developer/debugging/mount-lvm-image.md b/developer/debugging/mount-lvm-image.md index 8a5111b9..74597578 100644 --- a/developer/debugging/mount-lvm-image.md +++ b/developer/debugging/mount-lvm-image.md @@ -3,7 +3,7 @@ lang: en layout: doc permalink: /doc/mount-lvm-image/ ref: 46 -title: Mount LVM image +title: How to Mount LVM Images --- diff --git a/developer/debugging/profiling.md b/developer/debugging/profiling.md index 5b927af8..0724f4b9 100644 --- a/developer/debugging/profiling.md +++ b/developer/debugging/profiling.md @@ -7,7 +7,7 @@ redirect_from: - /doc/Profiling/ - /wiki/Profiling/ ref: 48 -title: Profiling +title: Python Profiling --- diff --git a/developer/debugging/test-bench.md b/developer/debugging/test-bench.md index 317d1d7f..bc21ea3f 100644 --- a/developer/debugging/test-bench.md +++ b/developer/debugging/test-bench.md @@ -7,7 +7,7 @@ redirect_from: - /doc/TestBench/ - /wiki/TestBench/ ref: 44 -title: Test Bench +title: How to Set Up a Test Bench --- diff --git a/user/reference/research.md b/developer/general/research.md similarity index 100% rename from user/reference/research.md rename to developer/general/research.md diff --git a/developer/services/disposablevm-implementation.md b/developer/services/disposablevm-implementation.md index e7d68e88..2aee1bfd 100644 --- a/developer/services/disposablevm-implementation.md +++ b/developer/services/disposablevm-implementation.md @@ -8,7 +8,7 @@ redirect_from: - /doc/DVMimpl/ - /wiki/DVMimpl/ ref: 34 -title: DisposableVM implementation +title: DisposableVM Implementation --- **Note: The content below applies to Qubes R3.2.** diff --git a/developer/services/qfilecopy.md b/developer/services/qfilecopy.md index b7dc007a..e1eb8814 100644 --- a/developer/services/qfilecopy.md +++ b/developer/services/qfilecopy.md @@ -7,10 +7,9 @@ redirect_from: - /doc/Qfilecopy/ - /wiki/Qfilecopy/ ref: 35 -title: Qfilecopy +title: Inter-VM File Copying (qfilecopy) --- - There are two cases when we need a mechanism to copy files between VMs: - "regular" file copy - when user instructs file manager to copy a given files/directories to a different VM diff --git a/developer/services/qfileexchgd.md b/developer/services/qfileexchgd.md index b61b988d..3523f88c 100644 --- a/developer/services/qfileexchgd.md +++ b/developer/services/qfileexchgd.md @@ -7,7 +7,7 @@ redirect_from: - /doc/Qfileexchgd/ - /wiki/Qfileexchgd/ ref: 40 -title: Qfileexchgd +title: qfileexchgd (deprecated) --- **This mechanism is obsolete as of Qubes Beta 1!** diff --git a/developer/services/qmemman.md b/developer/services/qmemman.md index 9f08f866..d9f191a8 100644 --- a/developer/services/qmemman.md +++ b/developer/services/qmemman.md @@ -7,10 +7,9 @@ redirect_from: - /doc/Qmemman/ - /wiki/Qmemman/ ref: 41 -title: Qmemman +title: Qubes Memory Manager (qmemman) --- - Rationale --------- diff --git a/developer/services/qrexec-internals.md b/developer/services/qrexec-internals.md index 017e70cc..9537c7f5 100644 --- a/developer/services/qrexec-internals.md +++ b/developer/services/qrexec-internals.md @@ -8,7 +8,7 @@ redirect_from: - /doc/Qrexec3Implementation/ - /wiki/Qrexec3Implementation/ ref: 39 -title: 'Qrexec: Qubes RPC internals' +title: 'Qrexec: Qubes RPC Internals' --- diff --git a/developer/services/qrexec-socket-services.md b/developer/services/qrexec-socket-services.md index f7cecd99..fcef05a9 100644 --- a/developer/services/qrexec-socket-services.md +++ b/developer/services/qrexec-socket-services.md @@ -3,7 +3,7 @@ lang: en layout: doc permalink: /doc/qrexec-socket-services/ ref: 42 -title: 'Qrexec: Socket-based services' +title: 'Qrexec: Socket-based Services' --- diff --git a/developer/services/qrexec.md b/developer/services/qrexec.md index 1d56de86..1ffe4257 100644 --- a/developer/services/qrexec.md +++ b/developer/services/qrexec.md @@ -11,7 +11,7 @@ redirect_from: - /doc/Qrexec/ - /wiki/Qrexec/ ref: 37 -title: 'Qrexec: secure communication across domains' +title: 'Qrexec: Secure Communication Across Domains' --- (*This page is about qrexec v3. For qrexec v2, see [here](/doc/qrexec2/).*) diff --git a/developer/services/qrexec2.md b/developer/services/qrexec2.md index bbbfd482..3b521253 100644 --- a/developer/services/qrexec2.md +++ b/developer/services/qrexec2.md @@ -8,11 +8,10 @@ redirect_from: - /doc/Qrexec2Implementation/ - /wiki/Qrexec2Implementation/ ref: 38 -title: Qrexec2 +title: qrexec v2 (deprecated) --- - -(*This page is about qrexec v2. For qrexec v3, see [here](/doc/qrexec3/).*) +(*This page is about qrexec v2. For qrexec v3, see [here](/doc/qrexec/).*) Qubes **qrexec** is a framework for implementing inter-VM (incl. Dom0-VM) services. It offers a mechanism to start programs in VMs, redirect their diff --git a/developer/system/gui.md b/developer/system/gui.md index f57bc1cb..9ef2e207 100644 --- a/developer/system/gui.md +++ b/developer/system/gui.md @@ -8,10 +8,9 @@ redirect_from: - /doc/GUIdocs/ - /wiki/GUIdocs/ ref: 61 -title: GUI +title: GUI Virtualization --- - qubes_gui and qubes_guid processes ------------------------------------ diff --git a/developer/system/security-design-goals.md b/developer/system/security-design-goals.md index 0951e06b..8806723c 100644 --- a/developer/system/security-design-goals.md +++ b/developer/system/security-design-goals.md @@ -9,7 +9,7 @@ redirect_from: - /doc/SecurityGoals/ - /wiki/SecurityGoals/ ref: 210 -title: Security design goals +title: Security Design Goals --- diff --git a/introduction/contributing.md b/introduction/contributing.md index 1eac5fd5..59422284 100644 --- a/introduction/contributing.md +++ b/introduction/contributing.md @@ -7,10 +7,9 @@ redirect_from: - /doc/ContributingHowto/ - /wiki/ContributingHowto/ ref: 125 -title: Contributing to the Qubes OS Project +title: How to Contribute --- - Thank you for your interest in contributing to Qubes! Here are some of the many ways in which you can help: diff --git a/introduction/reporting-bugs.md b/introduction/reporting-bugs.md index cc0e876f..7716246d 100644 --- a/introduction/reporting-bugs.md +++ b/introduction/reporting-bugs.md @@ -12,7 +12,7 @@ redirect_from: - /bug-report/ - /bug-reports/ ref: 121 -title: Reporting bugs and other issues +title: Reporting Bugs and Other Issues --- All issues pertaining to the Qubes OS Project (including auxiliary infrastructure such as the [website](/)) are tracked in [qubes-issues](https://github.com/QubesOS/qubes-issues/issues), our GitHub issue tracker. diff --git a/introduction/support.md b/introduction/support.md index c5806ce3..8300ac39 100644 --- a/introduction/support.md +++ b/introduction/support.md @@ -15,8 +15,6 @@ ref: 122 title: Help, Support, Mailing Lists, and Forum --- -# Help, Support, Mailing Lists, and Forum - Help and support for Qubes OS is available from the [documentation](/doc/), the [mailing lists](#mailing-lists), and our [forum](#forum) which are explained below. The Qubes OS Project does not offer paid support services. diff --git a/project-security/security.md b/project-security/security.md index 079e9d8e..cde20737 100644 --- a/project-security/security.md +++ b/project-security/security.md @@ -13,11 +13,9 @@ redirect_from: - /wiki/SecurityPage/ - /trac/wiki/SecurityPage/ ref: 217 -title: Security Center +title: Qubes OS Project Security Center --- -# Qubes OS Project Security Center - This page provides a central hub for topics pertaining to the security of the Qubes OS Project. For topics pertaining to software security *within* Qubes OS, see [Security in Qubes](/doc/#security-in-qubes). The following is a list of important project security pages: diff --git a/user/advanced-configuration/awesome.md b/user/advanced-topics/awesome.md similarity index 100% rename from user/advanced-configuration/awesome.md rename to user/advanced-topics/awesome.md diff --git a/user/advanced-configuration/bind-dirs.md b/user/advanced-topics/bind-dirs.md similarity index 98% rename from user/advanced-configuration/bind-dirs.md rename to user/advanced-topics/bind-dirs.md index 3e771f35..15380f24 100644 --- a/user/advanced-configuration/bind-dirs.md +++ b/user/advanced-topics/bind-dirs.md @@ -5,7 +5,7 @@ permalink: /doc/bind-dirs/ redirect_from: - /en/doc/bind-dirs/ ref: 186 -title: How to make any file in a TemplateBasedVM persistent using bind-dirs +title: How to Make Any File Persistent (bind-dirs) --- diff --git a/user/advanced-configuration/config-files.md b/user/advanced-topics/config-files.md similarity index 100% rename from user/advanced-configuration/config-files.md rename to user/advanced-topics/config-files.md diff --git a/user/advanced-configuration/disposablevm-customization.md b/user/advanced-topics/disposablevm-customization.md similarity index 100% rename from user/advanced-configuration/disposablevm-customization.md rename to user/advanced-topics/disposablevm-customization.md diff --git a/user/advanced-configuration/gui-configuration.md b/user/advanced-topics/gui-configuration.md similarity index 100% rename from user/advanced-configuration/gui-configuration.md rename to user/advanced-topics/gui-configuration.md diff --git a/user/common-tasks/software-update-dom0.md b/user/advanced-topics/how-to-install-software-in-dom0.md similarity index 93% rename from user/common-tasks/software-update-dom0.md rename to user/advanced-topics/how-to-install-software-in-dom0.md index c2193d01..ce260645 100644 --- a/user/common-tasks/software-update-dom0.md +++ b/user/advanced-topics/how-to-install-software-in-dom0.md @@ -1,20 +1,20 @@ --- lang: en layout: doc -permalink: /doc/software-update-dom0/ +permalink: /doc/how-to-install-software-in-dom0/ redirect_from: +- /doc/software-update-dom0/ - /en/doc/software-update-dom0/ - /doc/SoftwareUpdateDom0/ - /wiki/SoftwareUpdateDom0/ ref: 194 -title: Installing and updating software in dom0 +title: How to Install Software in Dom0 --- - -Updating [dom0](/doc/glossary/#dom0) is one of the main steps in [Updating Qubes OS](/doc/updating-qubes-os/). -It is very important to keep dom0 up-to-date with the latest [security](/security/) updates. -We also publish dom0 updates for various non-security bug fixes and enhancements to Qubes components. -In addition, you may wish to update the kernel, drivers, or libraries in dom0 when [troubleshooting newer hardware](/doc/newer-hardware-troubleshooting/). + ## Security diff --git a/user/advanced-configuration/i3.md b/user/advanced-topics/i3.md similarity index 100% rename from user/advanced-configuration/i3.md rename to user/advanced-topics/i3.md diff --git a/user/advanced-configuration/installing-contributed-packages.md b/user/advanced-topics/installing-contributed-packages.md similarity index 98% rename from user/advanced-configuration/installing-contributed-packages.md rename to user/advanced-topics/installing-contributed-packages.md index 83b487f1..e2abf82d 100644 --- a/user/advanced-configuration/installing-contributed-packages.md +++ b/user/advanced-topics/installing-contributed-packages.md @@ -3,7 +3,7 @@ lang: en layout: doc permalink: /doc/installing-contributed-packages/ ref: 225 -title: Installing contributed packages +title: Installing Contributed Packages --- diff --git a/user/advanced-configuration/kde.md b/user/advanced-topics/kde.md similarity index 100% rename from user/advanced-configuration/kde.md rename to user/advanced-topics/kde.md diff --git a/user/advanced-configuration/managing-vm-kernels.md b/user/advanced-topics/managing-vm-kernels.md similarity index 99% rename from user/advanced-configuration/managing-vm-kernels.md rename to user/advanced-topics/managing-vm-kernels.md index f3160c61..346eefe8 100644 --- a/user/advanced-configuration/managing-vm-kernels.md +++ b/user/advanced-topics/managing-vm-kernels.md @@ -6,7 +6,7 @@ redirect_from: - /doc/managing-vm-kernel/ - /en/doc/managing-vm-kernel/ ref: 173 -title: Managing VM kernels +title: Managing VM Kernels --- diff --git a/user/advanced-configuration/mount-from-other-os.md b/user/advanced-topics/mount-from-other-os.md similarity index 98% rename from user/advanced-configuration/mount-from-other-os.md rename to user/advanced-topics/mount-from-other-os.md index e2eb121f..29ed3d8d 100644 --- a/user/advanced-configuration/mount-from-other-os.md +++ b/user/advanced-topics/mount-from-other-os.md @@ -7,7 +7,7 @@ redirect_from: - /doc/MountFromOtherOs/ - /wiki/MountFromOtherOs/ ref: 175 -title: Mounting and Decrypting Qubes Partitions from Outside Qubes +title: How to Mount a Qubes Partition from Another OS --- diff --git a/user/reference/qubes-service.md b/user/advanced-topics/qubes-service.md similarity index 100% rename from user/reference/qubes-service.md rename to user/advanced-topics/qubes-service.md diff --git a/user/advanced-configuration/resize-disk-image.md b/user/advanced-topics/resize-disk-image.md similarity index 100% rename from user/advanced-configuration/resize-disk-image.md rename to user/advanced-topics/resize-disk-image.md diff --git a/user/advanced-configuration/rpc-policy.md b/user/advanced-topics/rpc-policy.md similarity index 100% rename from user/advanced-configuration/rpc-policy.md rename to user/advanced-topics/rpc-policy.md diff --git a/user/advanced-configuration/salt.md b/user/advanced-topics/salt.md similarity index 99% rename from user/advanced-configuration/salt.md rename to user/advanced-topics/salt.md index 95efa441..3ee82da2 100644 --- a/user/advanced-configuration/salt.md +++ b/user/advanced-topics/salt.md @@ -3,7 +3,7 @@ lang: en layout: doc permalink: /doc/salt/ ref: 185 -title: Salt management stack +title: Salt (management stack) --- diff --git a/user/advanced-configuration/secondary-storage.md b/user/advanced-topics/secondary-storage.md similarity index 100% rename from user/advanced-configuration/secondary-storage.md rename to user/advanced-topics/secondary-storage.md diff --git a/user/managing-os/standalone-and-hvm.md b/user/advanced-topics/standalone-and-hvm.md similarity index 100% rename from user/managing-os/standalone-and-hvm.md rename to user/advanced-topics/standalone-and-hvm.md diff --git a/user/advanced-configuration/usb-qubes.md b/user/advanced-topics/usb-qubes.md similarity index 100% rename from user/advanced-configuration/usb-qubes.md rename to user/advanced-topics/usb-qubes.md diff --git a/user/common-tasks/volume-backup-revert.md b/user/advanced-topics/volume-backup-revert.md similarity index 100% rename from user/common-tasks/volume-backup-revert.md rename to user/advanced-topics/volume-backup-revert.md diff --git a/user/managing-os/windows.md b/user/advanced-topics/windows.md similarity index 100% rename from user/managing-os/windows.md rename to user/advanced-topics/windows.md diff --git a/user/downloading-installing-upgrading/installation-guide.md b/user/downloading-installing-upgrading/installation-guide.md index 9ea84138..e496c30c 100644 --- a/user/downloading-installing-upgrading/installation-guide.md +++ b/user/downloading-installing-upgrading/installation-guide.md @@ -16,11 +16,9 @@ redirect_from: - /doc/InstallationGuideR3.0rc2/ - /doc/live-usb/ ref: 153 -title: Installation guide +title: Installation Guide --- -# Installation guide - Welcome to the Qubes OS installation guide! This guide will walk you through the process of installing Qubes. Please read it carefully and thoroughly, as it contains important information for ensuring that your Qubes OS installation is functional and secure. diff --git a/user/downloading-installing-upgrading/testing.md b/user/downloading-installing-upgrading/testing.md index d8b32c8e..b0fa2f58 100644 --- a/user/downloading-installing-upgrading/testing.md +++ b/user/downloading-installing-upgrading/testing.md @@ -3,7 +3,7 @@ lang: en layout: doc permalink: /doc/testing/ ref: 147 -title: Testing new releases and updates +title: Testing New Releases and Updates --- diff --git a/user/common-tasks/backup-emergency-restore-v2.md b/user/how-to-guides/backup-emergency-restore-v2.md similarity index 100% rename from user/common-tasks/backup-emergency-restore-v2.md rename to user/how-to-guides/backup-emergency-restore-v2.md diff --git a/user/common-tasks/backup-emergency-restore-v3.md b/user/how-to-guides/backup-emergency-restore-v3.md similarity index 100% rename from user/common-tasks/backup-emergency-restore-v3.md rename to user/how-to-guides/backup-emergency-restore-v3.md diff --git a/user/common-tasks/backup-emergency-restore-v4.md b/user/how-to-guides/backup-emergency-restore-v4.md similarity index 100% rename from user/common-tasks/backup-emergency-restore-v4.md rename to user/how-to-guides/backup-emergency-restore-v4.md diff --git a/user/common-tasks/backup-restore.md b/user/how-to-guides/how-to-back-up-restore-and-migrate.md similarity index 98% rename from user/common-tasks/backup-restore.md rename to user/how-to-guides/how-to-back-up-restore-and-migrate.md index 250bbd26..e6e6f434 100644 --- a/user/common-tasks/backup-restore.md +++ b/user/how-to-guides/how-to-back-up-restore-and-migrate.md @@ -1,13 +1,14 @@ --- lang: en layout: doc -permalink: /doc/backup-restore/ +permalink: /doc/how-to-back-up-restore-and-migrate/ redirect_from: +- /doc/backup-restore/ - /en/doc/backup-restore/ - /doc/BackupRestore/ - /wiki/BackupRestore/ ref: 199 -title: Backup, restoration, and migration +title: How to Back Up, Restore, and Migrate --- diff --git a/user/common-tasks/copying-files.md b/user/how-to-guides/how-to-copy-and-move-files.md similarity index 97% rename from user/common-tasks/copying-files.md rename to user/how-to-guides/how-to-copy-and-move-files.md index 19c28382..eba82e4e 100644 --- a/user/common-tasks/copying-files.md +++ b/user/how-to-guides/how-to-copy-and-move-files.md @@ -1,13 +1,14 @@ --- lang: en layout: doc -permalink: /doc/copying-files/ +permalink: /doc/how-to-copy-and-move-files/ redirect_from: +- /doc/copying-files/ - /en/doc/copying-files/ - /doc/CopyingFiles/ - /wiki/CopyingFiles/ ref: 191 -title: Copying and moving files between qubes +title: How to Copy and Move Files --- diff --git a/user/common-tasks/copy-paste.md b/user/how-to-guides/how-to-copy-and-paste-text.md similarity index 98% rename from user/common-tasks/copy-paste.md rename to user/how-to-guides/how-to-copy-and-paste-text.md index a1eb55c7..24e4eaa4 100644 --- a/user/common-tasks/copy-paste.md +++ b/user/how-to-guides/how-to-copy-and-paste-text.md @@ -1,13 +1,14 @@ --- lang: en layout: doc -permalink: /doc/copy-paste/ +permalink: /doc/how-to-copy-and-paste-text/ redirect_from: +- /doc/copy-paste/ - /en/doc/copy-paste/ - /doc/CopyPaste/ - /wiki/CopyPaste/ ref: 196 -title: Copying and pasting text between qubes +title: How to Copy and Paste Text --- diff --git a/user/common-tasks/copy-from-dom0.md b/user/how-to-guides/how-to-copy-from-dom0.md similarity index 97% rename from user/common-tasks/copy-from-dom0.md rename to user/how-to-guides/how-to-copy-from-dom0.md index 15be4742..514fc674 100644 --- a/user/common-tasks/copy-from-dom0.md +++ b/user/how-to-guides/how-to-copy-from-dom0.md @@ -1,14 +1,15 @@ --- lang: en layout: doc -permalink: /doc/copy-from-dom0/ +permalink: /doc/how-to-copy-from-dom0/ redirect_from: +- /doc/copy-from-dom0/ - /doc/copy-to-dom0/ - /en/doc/copy-to-dom0/ - /doc/CopyToDomZero/ - /wiki/CopyToDomZero/ ref: 198 -title: Copying from (and to) dom0 +title: How to Copy from Dom0 --- diff --git a/user/common-tasks/full-screen-mode.md b/user/how-to-guides/how-to-enter-fullscreen-mode.md similarity index 84% rename from user/common-tasks/full-screen-mode.md rename to user/how-to-guides/how-to-enter-fullscreen-mode.md index d6e1c2dd..84d832d9 100644 --- a/user/common-tasks/full-screen-mode.md +++ b/user/how-to-guides/how-to-enter-fullscreen-mode.md @@ -1,39 +1,40 @@ --- lang: en layout: doc -permalink: /doc/full-screen-mode/ +permalink: /doc/how-to-enter-fullscreen-mode/ redirect_from: +- /doc/full-screen-mode/ - /en/doc/full-screen-mode/ - /doc/FullScreenMode/ - /wiki/FullScreenMode/ ref: 205 -title: Full Screen Mode +title: How to Enter Fullscreen Mode --- -What is full screen mode? +What is fullscreen mode? ------------------------- Normally, the Qubes GUI virtualization daemon restricts the VM from "owning" the full screen, ensuring that there are always clearly marked decorations drawn by the trusted Window Manager around each of the VMs window. This allows the user to easily realize to which domain a specific window belongs. See the [screenshots](/doc/QubesScreenshots/) page for examples. -Why is full screen mode potentially dangerous? +Why is fullscreen mode potentially dangerous? ---------------------------------------------- If one allowed one of the VMs to "own" the full screen, e.g. to show a movie on a full screen, it might not be possible for the user to know if the applications/VM really "released" the full screen, or if it has started emulating the whole desktop and is pretending to be the trusted Window Manager, drawing shapes on the screen that look e.g. like other windows, belonging to other domains (e.g. to trick the user into entering a secret passphrase into a window that looks like belonging to some trusted domain). -Secure use of full screen mode +Secure use of fullscreen mode ------------------------------ -However, it is possible to deal with full screen mode in a secure way assuming there are mechanisms that can be used at any time to switch between windows or show the full desktop and that cannot be intercepted by the VM. +However, it is possible to deal with fullscreen mode in a secure way assuming there are mechanisms that can be used at any time to switch between windows or show the full desktop and that cannot be intercepted by the VM. The simplest example is the use of Alt+Tab for switching between windows, which is a shortcut handled by dom0. Other examples such mechanisms are the KDE "Present Windows" and "Desktop Grid" effects, which are similar to Mac's "Expose" effect, and which can be used to immediately detect potential "GUI forgery", as they cannot be intercepted by any of the VM (as the GUID never passes down the key combinations that got consumed by KDE Window Manager), and so the VM cannot emulate those. Those effects are enabled by default in KDE once Compositing gets enabled in KDE (System Settings -\> Desktop -\> Enable Desktop Effects), which is recommended anyway. By default, they are triggered by Ctrl-F8 and Ctrl-F9 key combinations, but can also be reassigned to other shortcuts. -Enabling full screen mode for select VMs +Enabling fullscreen mode for select VMs ---------------------------------------- You can always put a window into fullscreen mode in Xfce4 using the trusted window manager by right-clicking on a window's title bar and selecting "Fullscreen" or pressing `alt` + `f11`. @@ -42,7 +43,7 @@ The user must select this option from the trusted window manager in dom0. To exit fullscreen mode from here, press `alt` + `space` to bring up the title bar menu again, then select "Leave Fullscreen" or simply press `alt` + `f11`. For StandaloneHVMs, you should set the screen resolution in the qube to that of the host, (or larger), *before* setting fullscreen mode in Xfce4. -As an alternative to the Xfce4 method, you can enable full screen mode for select VMs by creating the following entry in the `/etc/qubes/guid.conf` file in dom0: +As an alternative to the Xfce4 method, you can enable fullscreen mode for select VMs by creating the following entry in the `/etc/qubes/guid.conf` file in dom0: ~~~ VM: { diff --git a/user/common-tasks/getting-started.md b/user/how-to-guides/how-to-get-started.md similarity index 99% rename from user/common-tasks/getting-started.md rename to user/how-to-guides/how-to-get-started.md index bbfebf1d..57c77e2c 100644 --- a/user/common-tasks/getting-started.md +++ b/user/how-to-guides/how-to-get-started.md @@ -1,16 +1,17 @@ --- lang: en layout: doc -permalink: /doc/getting-started/ +permalink: /doc/how-to-get-started/ redirect_from: +- /doc/getting-started/ - /getting-started/ - /en/doc/getting-started/ - /doc/GettingStarted/ - /wiki/GettingStarted/ ref: 190 +title: How to Get Started --- - After [downloading](/downloads/) and [installing](/doc/installation-guide/) Qubes OS, let's cover some basic concepts. Introduction diff --git a/user/common-tasks/software-update-domu.md b/user/how-to-guides/how-to-install-software.md similarity index 96% rename from user/common-tasks/software-update-domu.md rename to user/how-to-guides/how-to-install-software.md index f3d69f63..e25c0784 100644 --- a/user/common-tasks/software-update-domu.md +++ b/user/how-to-guides/how-to-install-software.md @@ -1,20 +1,19 @@ --- lang: en layout: doc -permalink: /doc/software-update-domu/ +permalink: /doc/how-to-install-software/ redirect_from: +- /doc/software-update-domu/ - /doc/software-update-vm/ - /en/doc/software-update-vm/ - /doc/SoftwareUpdateVM/ - /wiki/SoftwareUpdateVM/ ref: 189 -title: Installing and updating software in domUs +title: How to Install Software --- - -Updating [domUs](/doc/glossary/#domu), especially [TemplateVMs](/doc/templates/) and [StandaloneVMs](/doc/standalone-and-hvm/) are important steps in [Updating Qubes OS](/doc/updating-qubes-os/). -It is very import to keep domUs up-to-date with the latest [security](/security/) updates. -Updating these VMs also allows you to receive various non-security bug fixes and enhancements both from the Qubes OS Project and from your upstream distro maintainer. +This page explains how to install software in TemplateVMs and StandaloneVMs. +Advanced users may also be interested in learning [how to install software in dom0](/doc/how-to-install-software-in-dom0). ## Installing software in TemplateVMs diff --git a/user/common-tasks/updating-qubes-os.md b/user/how-to-guides/how-to-update.md similarity index 98% rename from user/common-tasks/updating-qubes-os.md rename to user/how-to-guides/how-to-update.md index 435800fe..c619ffed 100644 --- a/user/common-tasks/updating-qubes-os.md +++ b/user/how-to-guides/how-to-update.md @@ -1,12 +1,13 @@ --- lang: en layout: doc -permalink: /doc/updating-qubes-os/ +permalink: /doc/how-to-update/ +redirect_from: + - /doc/updating-qubes-os/ ref: 200 -title: Updating Qubes OS +title: How to Update --- - *This page is about updating your system while staying on the same [supported version of Qubes OS](/doc/supported-versions/#qubes-os). If you're instead looking to upgrade from your current version of Qubes OS to a newer version, see the [Upgrade Guides](/doc/upgrade/).* diff --git a/user/common-tasks/block-devices.md b/user/how-to-guides/how-to-use-block-storage-devices.md similarity index 98% rename from user/common-tasks/block-devices.md rename to user/how-to-guides/how-to-use-block-storage-devices.md index da8282ff..6261f8c8 100644 --- a/user/common-tasks/block-devices.md +++ b/user/how-to-guides/how-to-use-block-storage-devices.md @@ -1,14 +1,15 @@ --- lang: en layout: doc -permalink: /doc/block-devices/ +permalink: /doc/how-to-use-block-storage-devices/ redirect_from: +- /doc/block-devices/ - /doc/stick-mounting/ - /en/doc/stick-mounting/ - /doc/StickMounting/ - /wiki/StickMounting/ ref: 193 -title: Block (Storage) Devices +title: How to Use Block Storage Devices --- diff --git a/user/common-tasks/device-handling.md b/user/how-to-guides/how-to-use-devices.md similarity index 98% rename from user/common-tasks/device-handling.md rename to user/how-to-guides/how-to-use-devices.md index dac446d0..41d51d3a 100644 --- a/user/common-tasks/device-handling.md +++ b/user/how-to-guides/how-to-use-devices.md @@ -1,14 +1,15 @@ --- lang: en layout: doc -permalink: /doc/device-handling/ +permalink: /doc/how-to-use-devices/ redirect_from: +- /doc/device-handling/ - /doc/external-device-mount-point/ - /en/doc/external-device-mount-point/ - /doc/ExternalDeviceMountPoint/ - /wiki/ExternalDeviceMountPoint/ ref: 188 -title: Device Handling +title: How to Use Devices --- diff --git a/user/common-tasks/disposablevm.md b/user/how-to-guides/how-to-use-disposablevms.md similarity index 99% rename from user/common-tasks/disposablevm.md rename to user/how-to-guides/how-to-use-disposablevms.md index 44a72b01..91fcb57e 100644 --- a/user/common-tasks/disposablevm.md +++ b/user/how-to-guides/how-to-use-disposablevms.md @@ -1,14 +1,15 @@ --- lang: en layout: doc -permalink: /doc/disposablevm/ +permalink: /doc/how-to-use-disposablevms/ redirect_from: +- /doc/disposablevm/ - /doc/dispvm/ - /en/doc/dispvm/ - /doc/DisposableVms/ - /wiki/DisposableVMs/ ref: 203 -title: DisposableVMs +title: How to Use DisposableVMs --- diff --git a/user/common-tasks/optical-discs.md b/user/how-to-guides/how-to-use-optical-discs.md similarity index 92% rename from user/common-tasks/optical-discs.md rename to user/how-to-guides/how-to-use-optical-discs.md index 88d6aaed..ac250054 100644 --- a/user/common-tasks/optical-discs.md +++ b/user/how-to-guides/how-to-use-optical-discs.md @@ -1,12 +1,13 @@ --- lang: en layout: doc -permalink: /doc/optical-discs/ +permalink: /doc/how-to-use-optical-discs/ redirect_from: +- /doc/optical-discs/ - /doc/recording-optical-discs/ - /en/doc/recording-optical-discs/ ref: 204 -title: Optical Discs +title: How to Use Optical Discs --- diff --git a/user/common-tasks/pci-devices.md b/user/how-to-guides/how-to-use-pci-devices.md similarity index 98% rename from user/common-tasks/pci-devices.md rename to user/how-to-guides/how-to-use-pci-devices.md index c47b540f..58a3fb44 100644 --- a/user/common-tasks/pci-devices.md +++ b/user/how-to-guides/how-to-use-pci-devices.md @@ -1,14 +1,15 @@ --- lang: en layout: doc -permalink: /doc/pci-devices/ +permalink: /doc/how-to-use-pci-devices/ redirect_from: +- /doc/pci-devices/ - /doc/assigning-devices/ - /en/doc/assigning-devices/ - /doc/AssigningDevices/ - /wiki/AssigningDevices/ ref: 197 -title: PCI Devices +title: How to Use PCI Devices --- diff --git a/user/common-tasks/usb-devices.md b/user/how-to-guides/how-to-use-usb-devices.md similarity index 98% rename from user/common-tasks/usb-devices.md rename to user/how-to-guides/how-to-use-usb-devices.md index c330f030..964973d6 100644 --- a/user/common-tasks/usb-devices.md +++ b/user/how-to-guides/how-to-use-usb-devices.md @@ -1,11 +1,12 @@ --- lang: en layout: doc -permalink: /doc/usb-devices/ +permalink: /doc/how-to-use-usb-devices/ redirect_from: +- /doc/usb-devices/ - /doc/usb/ ref: 195 -title: USB Devices +title: How to Use USB Devices --- diff --git a/user/reference/tools.md b/user/reference/tools.md index f85868b3..4f1a2bed 100644 --- a/user/reference/tools.md +++ b/user/reference/tools.md @@ -10,7 +10,7 @@ redirect_from: - /doc/tools/3.2/dom0/ - /doc/tools/3.2/domU/ ref: 141 -title: Command-Line Tools +title: Command-line Tools --- diff --git a/user/security-in-qubes/firewall.md b/user/security-in-qubes/firewall.md index a3479ecc..45c6e18c 100644 --- a/user/security-in-qubes/firewall.md +++ b/user/security-in-qubes/firewall.md @@ -8,10 +8,9 @@ redirect_from: - /doc/QubesFirewall/ - /wiki/QubesFirewall/ ref: 166 -title: The Qubes Firewall +title: Firewall --- - Understanding firewalling in Qubes ---------------------------------- diff --git a/user/security-in-qubes/split-gpg.md b/user/security-in-qubes/split-gpg.md index 97187bea..3f887c3a 100644 --- a/user/security-in-qubes/split-gpg.md +++ b/user/security-in-qubes/split-gpg.md @@ -16,8 +16,6 @@ ref: 168 title: Split GPG --- -# Qubes Split GPG - Split GPG implements a concept similar to having a smart card with your private GPG keys, except that the role of the "smart card" is played by another Qubes AppVM. This way one not-so-trusted domain, e.g. the one where Thunderbird is running, can delegate all crypto operations -- such as encryption/decryption and signing -- to another, more trusted, network-isolated domain. This way the compromise of your domain where Thunderbird or another client app is running -- arguably a not-so-unthinkable scenario -- does not allow the attacker to automatically also steal all your keys. diff --git a/user/security-in-qubes/u2f-proxy.md b/user/security-in-qubes/u2f-proxy.md index d0b65c68..ca7dd7b4 100644 --- a/user/security-in-qubes/u2f-proxy.md +++ b/user/security-in-qubes/u2f-proxy.md @@ -3,7 +3,7 @@ lang: en layout: doc permalink: /doc/u2f-proxy/ ref: 167 -title: The Qubes U2F Proxy +title: U2F Proxy --- diff --git a/user/security-in-qubes/yubi-key.md b/user/security-in-qubes/yubi-key.md index cc775618..ed26130f 100644 --- a/user/security-in-qubes/yubi-key.md +++ b/user/security-in-qubes/yubi-key.md @@ -1,12 +1,13 @@ --- lang: en layout: doc -permalink: /doc/yubi-key/ +permalink: /doc/yubikey/ redirect_from: +- /doc/yubi-key/ - /en/doc/yubi-key/ - /doc/YubiKey/ ref: 169 -title: YubiKey in Qubes +title: YubiKey --- diff --git a/user/managing-os/debian/debian-upgrade.md b/user/templates/debian/debian-upgrade.md similarity index 99% rename from user/managing-os/debian/debian-upgrade.md rename to user/templates/debian/debian-upgrade.md index c8358dc6..b0551920 100644 --- a/user/managing-os/debian/debian-upgrade.md +++ b/user/templates/debian/debian-upgrade.md @@ -9,10 +9,9 @@ redirect_from: - /doc/DebianTemplateUpgrade8/ - /wiki/DebianTemplateUpgrade8/ ref: 133 -title: In-place upgrade of Debian TemplateVMs +title: How to Upgrade a Debian Template In-place --- -