Revert "Remove all instances of permalink: in YAML frontmatter"

This reverts commit c815e4c54c. https://github.com/QubesOS/qubes-issues/issues/6701#issuecomment-862822827
2025-08-02 19:46:40 -04:00 · 2021-06-16 19:56:25 -07:00 · 2021-06-16 19:56:25 -07:00 · 2c473241a8
commit 2c473241a8
parent 8f2efb70cb
168 changed files with 167 additions and 212 deletions
--- a/user/advanced-configuration/awesome.md
+++ b/user/advanced-configuration/awesome.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/awesome/
 redirect_from:
- /doc/awesome/
 - /en/doc/awesome/
 ref: 179
 title: awesome
--- a/user/advanced-configuration/bind-dirs.md
+++ b/user/advanced-configuration/bind-dirs.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/bind-dirs/
 redirect_from:
- /doc/bind-dirs/
 - /en/doc/bind-dirs/
 ref: 186
 title: How to make any file in a TemplateBasedVM persistent using bind-dirs
--- a/user/advanced-configuration/config-files.md
+++ b/user/advanced-configuration/config-files.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/config-files/
 redirect_from:
- /doc/config-files/
 - /en/doc/config-files/
 - /doc/ConfigFiles/
 - /doc/UserDoc/ConfigFiles/
--- a/user/advanced-configuration/disposablevm-customization.md
+++ b/user/advanced-configuration/disposablevm-customization.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/disposablevm-customization/
 redirect_from:
- /doc/disposablevm-customization/
 - /doc/dispvm-customization/
 - /en/doc/dispvm-customization/
 - /doc/DispVMCustomization/
--- a/user/advanced-configuration/gui-configuration.md
+++ b/user/advanced-configuration/gui-configuration.md
@ -1,8 +1,7 @@
 ---
 lang: en
 layout: doc
-redirect_from:
- /doc/gui-configuration/
+permalink: /doc/gui-configuration/
 ref: 184
 title: GUI Configuration
 ---
--- a/user/advanced-configuration/i3.md
+++ b/user/advanced-configuration/i3.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/i3/
 redirect_from:
- /doc/i3/
 - /en/doc/i3/
 - /doc/UserDoc/i3/
 - /wiki/UserDoc/i3/
--- a/user/advanced-configuration/installing-contributed-packages.md
+++ b/user/advanced-configuration/installing-contributed-packages.md
@ -1,8 +1,7 @@
 ---
 lang: en
 layout: doc
-redirect_from:
- /doc/installing-contributed-packages/
+permalink: /doc/installing-contributed-packages/
 ref: 225
 title: Installing contributed packages
 ---
--- a/user/advanced-configuration/kde.md
+++ b/user/advanced-configuration/kde.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/kde/
 redirect_from:
- /doc/kde/
 - /en/doc/kde/
 ref: 176
 title: KDE
--- a/user/advanced-configuration/managing-vm-kernel.md
+++ b/user/advanced-configuration/managing-vm-kernel.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/managing-vm-kernel/
 redirect_from:
- /doc/managing-vm-kernel/
 - /en/doc/managing-vm-kernel/
 ref: 173
 title: Managing VM kernel
--- a/user/advanced-configuration/mount-from-other-os.md
+++ b/user/advanced-configuration/mount-from-other-os.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/mount-from-other-os/
 redirect_from:
- /doc/mount-from-other-os/
 - /en/doc/mount-from-other-os/
 - /doc/MountFromOtherOs/
 - /wiki/MountFromOtherOs/
--- a/user/advanced-configuration/resize-disk-image.md
+++ b/user/advanced-configuration/resize-disk-image.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/resize-disk-image/
 redirect_from:
- /doc/resize-disk-image/
 - /en/doc/resize-disk-image/
 - /en/doc/resize-root-disk-image/
 - /doc/ResizeDiskImage/
--- a/user/advanced-configuration/rpc-policy.md
+++ b/user/advanced-configuration/rpc-policy.md
@ -1,8 +1,7 @@
 ---
 lang: en
 layout: doc
-redirect_from:
- /doc/rpc-policy/
+permalink: /doc/rpc-policy/
 ref: 178
 title: RPC Policies
 ---
--- a/user/advanced-configuration/salt.md
+++ b/user/advanced-configuration/salt.md
@ -1,8 +1,7 @@
 ---
 lang: en
 layout: doc
-redirect_from:
- /doc/salt/
+permalink: /doc/salt/
 ref: 185
 title: Management stack
 ---
--- a/user/advanced-configuration/secondary-storage.md
+++ b/user/advanced-configuration/secondary-storage.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/secondary-storage/
 redirect_from:
- /doc/secondary-storage/
 - /en/doc/secondary-storage/
 - /doc/SecondaryStorage/
 - /wiki/SecondaryStorage/
--- a/user/advanced-configuration/usb-qubes.md
+++ b/user/advanced-configuration/usb-qubes.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/usb-qubes/
 redirect_from:
- /doc/usb-qubes/
 - /doc/usbvm/
 - /en/doc/usbvm/
 - /doc/USBVM/
--- a/user/common-tasks/backup-emergency-restore-v2.md
+++ b/user/common-tasks/backup-emergency-restore-v2.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/backup-emergency-restore-v2/
 redirect_from:
- /doc/backup-emergency-restore-v2/
 - /en/doc/backup-emergency-restore-v2/
 - /doc/BackupEmergencyRestoreV2/
 ref: 207
--- a/user/common-tasks/backup-emergency-restore-v3.md
+++ b/user/common-tasks/backup-emergency-restore-v3.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/backup-emergency-restore-v3/
 redirect_from:
- /doc/backup-emergency-restore-v3/
 - /en/doc/backup-emergency-restore-v3/
 - /doc/BackupEmergencyRestoreV3/
 ref: 201
--- a/user/common-tasks/backup-emergency-restore-v4.md
+++ b/user/common-tasks/backup-emergency-restore-v4.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/backup-emergency-restore-v4/
 redirect_from:
- /doc/backup-emergency-restore-v4/
 - /en/doc/backup-emergency-restore-v4/
 - /doc/BackupEmergencyRestoreV4/
 ref: 192
--- a/user/common-tasks/backup-restore.md
+++ b/user/common-tasks/backup-restore.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/backup-restore/
 redirect_from:
- /doc/backup-restore/
 - /en/doc/backup-restore/
 - /doc/BackupRestore/
 - /wiki/BackupRestore/
--- a/user/common-tasks/block-devices.md
+++ b/user/common-tasks/block-devices.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/block-devices/
 redirect_from:
- /doc/block-devices/
 - /doc/stick-mounting/
 - /en/doc/stick-mounting/
 - /doc/StickMounting/
--- a/user/common-tasks/copy-from-dom0.md
+++ b/user/common-tasks/copy-from-dom0.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/copy-from-dom0/
 redirect_from:
- /doc/copy-from-dom0/
 - /doc/copy-to-dom0/
 - /en/doc/copy-to-dom0/
 - /doc/CopyToDomZero/
--- a/user/common-tasks/copy-paste.md
+++ b/user/common-tasks/copy-paste.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/copy-paste/
 redirect_from:
- /doc/copy-paste/
 - /en/doc/copy-paste/
 - /doc/CopyPaste/
 - /wiki/CopyPaste/
--- a/user/common-tasks/copying-files.md
+++ b/user/common-tasks/copying-files.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/copying-files/
 redirect_from:
- /doc/copying-files/
 - /en/doc/copying-files/
 - /doc/CopyingFiles/
 - /wiki/CopyingFiles/
--- a/user/common-tasks/device-handling.md
+++ b/user/common-tasks/device-handling.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/device-handling/
 redirect_from:
- /doc/device-handling/
 - /doc/external-device-mount-point/
 - /en/doc/external-device-mount-point/
 - /doc/ExternalDeviceMountPoint/
--- a/user/common-tasks/disposablevm.md
+++ b/user/common-tasks/disposablevm.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/disposablevm/
 redirect_from:
- /doc/disposablevm/
 - /doc/dispvm/
 - /en/doc/dispvm/
 - /doc/DisposableVms/
--- a/user/common-tasks/full-screen-mode.md
+++ b/user/common-tasks/full-screen-mode.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/full-screen-mode/
 redirect_from:
- /doc/full-screen-mode/
 - /en/doc/full-screen-mode/
 - /doc/FullScreenMode/
 - /wiki/FullScreenMode/
--- a/user/common-tasks/getting-started.md
+++ b/user/common-tasks/getting-started.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/getting-started/
 redirect_from:
- /doc/getting-started/
 - /getting-started/
 - /en/doc/getting-started/
 - /doc/GettingStarted/
--- a/user/common-tasks/optical-discs.md
+++ b/user/common-tasks/optical-discs.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/optical-discs/
 redirect_from:
- /doc/optical-discs/
 - /doc/recording-optical-discs/
 - /en/doc/recording-optical-discs/
 ref: 204
--- a/user/common-tasks/pci-devices.md
+++ b/user/common-tasks/pci-devices.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/pci-devices/
 redirect_from:
- /doc/pci-devices/
 - /doc/assigning-devices/
 - /en/doc/assigning-devices/
 - /doc/AssigningDevices/
--- a/user/common-tasks/software-update-dom0.md
+++ b/user/common-tasks/software-update-dom0.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/software-update-dom0/
 redirect_from:
- /doc/software-update-dom0/
 - /en/doc/software-update-dom0/
 - /doc/SoftwareUpdateDom0/
 - /wiki/SoftwareUpdateDom0/
--- a/user/common-tasks/software-update-domu.md
+++ b/user/common-tasks/software-update-domu.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/software-update-domu/
 redirect_from:
- /doc/software-update-domu/
 - /doc/software-update-vm/
 - /en/doc/software-update-vm/
 - /doc/SoftwareUpdateVM/
--- a/user/common-tasks/updating-qubes-os.md
+++ b/user/common-tasks/updating-qubes-os.md
@ -1,8 +1,7 @@
 ---
 lang: en
 layout: doc
-redirect_from:
- /doc/updating-qubes-os/
+permalink: /doc/updating-qubes-os/
 ref: 200
 title: Updating Qubes OS
 ---
--- a/user/common-tasks/usb-devices.md
+++ b/user/common-tasks/usb-devices.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/usb-devices/
 redirect_from:
- /doc/usb-devices/
 - /doc/usb/
 ref: 195
 title: USB Devices
--- a/user/common-tasks/volume-backup-revert.md
+++ b/user/common-tasks/volume-backup-revert.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/volume-backup-revert/
 redirect_from:
- /doc/volume-backup-revert/
 - /en/doc/volume-backup-revert/
 - /doc/VolumeBackupRevert/
 - /wiki/VolumeBackupRevert/
--- a/user/downloading-installing-upgrading/custom-install.md
+++ b/user/downloading-installing-upgrading/custom-install.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/custom-install/
 redirect_from:
- /doc/custom-install/
 - /doc/encryption-config/
 ref: 152
 title: Custom Installation
--- a/user/downloading-installing-upgrading/download-mirrors.md
+++ b/user/downloading-installing-upgrading/download-mirrors.md
@ -1,8 +1,7 @@
 ---
 lang: en
 layout: sidebar
-redirect_from:
- /downloads/mirrors/
+permalink: /downloads/mirrors/
 ref: 148
 title: Download Mirrors
 ---
--- a/user/downloading-installing-upgrading/install-security.md
+++ b/user/downloading-installing-upgrading/install-security.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/install-security/
 redirect_from:
- /doc/install-security/
 - /en/doc/install-security/
 - /doc/InstallSecurity/
 - /wiki/InstallSecurity/
--- a/user/downloading-installing-upgrading/installation-guide.md
+++ b/user/downloading-installing-upgrading/installation-guide.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/installation-guide/
 redirect_from:
- /doc/installation-guide/
 - /en/doc/installation-guide/
 - /doc/InstallationGuide/
 - /wiki/InstallationGuide/
--- a/user/downloading-installing-upgrading/supported-versions.md
+++ b/user/downloading-installing-upgrading/supported-versions.md
@ -1,8 +1,7 @@
 ---
 lang: en
 layout: doc
-redirect_from:
- /doc/supported-versions/
+permalink: /doc/supported-versions/
 ref: 154
 title: Supported Versions
 ---
--- a/user/downloading-installing-upgrading/testing.md
+++ b/user/downloading-installing-upgrading/testing.md
@ -1,8 +1,7 @@
 ---
 lang: en
 layout: doc
-redirect_from:
- /doc/testing/
+permalink: /doc/testing/
 ref: 147
 title: Testing new releases and updates
 ---
--- a/user/downloading-installing-upgrading/upgrade/upgrade-to-r2.md
+++ b/user/downloading-installing-upgrading/upgrade/upgrade-to-r2.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/upgrade-to-r2/
 redirect_from:
- /doc/upgrade-to-r2/
 - /en/doc/upgrade-to-r2/
 - /doc/UpgradeToR2/
 - /doc/UpgradeToR2rc1/
--- a/user/downloading-installing-upgrading/upgrade/upgrade-to-r2b1.md
+++ b/user/downloading-installing-upgrading/upgrade/upgrade-to-r2b1.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/upgrade-to-r2b1/
 redirect_from:
- /doc/upgrade-to-r2b1/
 - /en/doc/upgrade-to-r2b1/
 - /doc/UpgradeToR2B1/
 - /wiki/UpgradeToR2B1/
--- a/user/downloading-installing-upgrading/upgrade/upgrade-to-r2b2.md
+++ b/user/downloading-installing-upgrading/upgrade/upgrade-to-r2b2.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/upgrade-to-r2b2/
 redirect_from:
- /doc/upgrade-to-r2b2/
 - /en/doc/upgrade-to-r2b2/
 - /doc/UpgradeToR2B2/
 - /wiki/UpgradeToR2B2/
--- a/user/downloading-installing-upgrading/upgrade/upgrade-to-r2b3.md
+++ b/user/downloading-installing-upgrading/upgrade/upgrade-to-r2b3.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/upgrade-to-r2b3/
 redirect_from:
- /doc/upgrade-to-r2b3/
 - /en/doc/upgrade-to-r2b3/
 - /doc/UpgradeToR2B3/
 - /wiki/UpgradeToR2B3/
--- a/user/downloading-installing-upgrading/upgrade/upgrade-to-r3_0.md
+++ b/user/downloading-installing-upgrading/upgrade/upgrade-to-r3_0.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/upgrade-to-r3.0/
 redirect_from:
- /doc/upgrade-to-r3.0/
 - /en/doc/upgrade-to-r3.0/
 - /doc/UpgradeToR3.0/
 - /doc/UpgradeToR3.0rc1/
--- a/user/downloading-installing-upgrading/upgrade/upgrade-to-r3_1.md
+++ b/user/downloading-installing-upgrading/upgrade/upgrade-to-r3_1.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/upgrade-to-r3.1/
 redirect_from:
- /doc/upgrade-to-r3.1/
 - /en/doc/upgrade-to-r3.1/
 - /doc/UpgradeToR3.1/
 - /doc/UpgradeToR3.1rc1/
--- a/user/downloading-installing-upgrading/upgrade/upgrade-to-r3_2.md
+++ b/user/downloading-installing-upgrading/upgrade/upgrade-to-r3_2.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/upgrade-to-r3.2/
 redirect_from:
- /doc/upgrade-to-r3.2/
 - /en/doc/upgrade-to-r3.2/
 - /doc/UpgradeToR3.2/
 - /doc/UpgradeToR3.2rc1/
--- a/user/downloading-installing-upgrading/upgrade/upgrade-to-r4_0.md
+++ b/user/downloading-installing-upgrading/upgrade/upgrade-to-r4_0.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/upgrade-to-r4.0/
 redirect_from:
- /doc/upgrade-to-r4.0/
 - /en/doc/upgrade-to-r4.0/
 - /doc/UpgradeToR4.0/
 - /doc/UpgradeToR4.0rc1/
--- a/user/downloading-installing-upgrading/upgrade/upgrade.md
+++ b/user/downloading-installing-upgrading/upgrade/upgrade.md
@ -1,8 +1,7 @@
 ---
 lang: en
 layout: doc
-redirect_from:
- /doc/upgrade/
+permalink: /doc/upgrade/
 ref: 158
 title: Upgrade Guides
 ---
--- a/user/downloading-installing-upgrading/version-scheme.md
+++ b/user/downloading-installing-upgrading/version-scheme.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/version-scheme/
 redirect_from:
- /doc/version-scheme/
 - /en/doc/version-scheme/
 - /doc/VersionScheme/
 - /wiki/VersionScheme/
--- a/user/hardware/certified-hardware.md
+++ b/user/hardware/certified-hardware.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/certified-hardware/
 redirect_from:
- /doc/certified-hardware/
 - /doc/hardware/
 - /doc/certified-laptops/
 - /hardware-certification/
--- a/user/hardware/hardware-testing.md
+++ b/user/hardware/hardware-testing.md
@ -1,8 +1,7 @@
 ---
 lang: en
 layout: doc
-redirect_from:
- /doc/hardware-testing/
+permalink: /doc/hardware-testing/
 ref: 145
 title: Hardware Testing
 ---
--- a/user/hardware/hcl.md
+++ b/user/hardware/hcl.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/hcl/
 redirect_from:
- /doc/hcl/
 - /en/doc/hcl/
 - /doc/HCL/
 - /wiki/HCL/
--- a/user/hardware/hcl_listing.md
+++ b/user/hardware/hcl_listing.md
@ -2,8 +2,8 @@
 lang: en
 layout: hcl
 model: all
+permalink: /hcl/
 redirect_from:
- /hcl/
 - /compatible-hardware/
 ref: 143
 title: Hardware Compatibility List (HCL)
--- a/user/hardware/system-requirements.md
+++ b/user/hardware/system-requirements.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/system-requirements/
 redirect_from:
- /doc/system-requirements/
 - /system-requirements/
 - /en/doc/system-requirements/
 - /doc/SystemRequirements/
--- a/user/managing-os/debian/debian-upgrade.md
+++ b/user/managing-os/debian/debian-upgrade.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/template/debian/upgrade/
 redirect_from:
- /doc/template/debian/upgrade/
 - /doc/template/debian/upgrade-8-to-9/
 - /doc/debian-template-upgrade-8/
 - /en/doc/debian-template-upgrade-8/
--- a/user/managing-os/debian/debian.md
+++ b/user/managing-os/debian/debian.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/templates/debian/
 redirect_from:
- /doc/templates/debian/
 - /doc/debian/
 - /en/doc/templates/debian/
 - /doc/Templates/Debian/
--- a/user/managing-os/fedora/fedora-upgrade.md
+++ b/user/managing-os/fedora/fedora-upgrade.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/template/fedora/upgrade/
 redirect_from:
- /doc/template/fedora/upgrade/
 - /doc/template/fedora/upgrade-26-to-27/
 - /doc/fedora-template-upgrade-26/
 - /en/doc/fedora-template-upgrade-26/
--- a/user/managing-os/fedora/fedora.md
+++ b/user/managing-os/fedora/fedora.md
@ -1,8 +1,7 @@
 ---
 lang: en
 layout: doc
-redirect_from:
- /doc/templates/fedora/
+permalink: /doc/templates/fedora/
 ref: 136
 title: The Fedora TemplateVM
 ---
--- a/user/managing-os/minimal-templates.md
+++ b/user/managing-os/minimal-templates.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/templates/minimal/
 redirect_from:
- /doc/templates/minimal/
 - /doc/templates/fedora-minimal/
 - /doc/fedora-minimal/
 - /en/doc/templates/fedora-minimal/
--- a/user/managing-os/reinstall-template.md
+++ b/user/managing-os/reinstall-template.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/reinstall-template/
 redirect_from:
- /doc/reinstall-template/
 - /doc/whonix/reinstall/
 ref: 128
 title: How to Reinstall a TemplateVM
--- a/user/managing-os/standalone-and-hvm.md
+++ b/user/managing-os/standalone-and-hvm.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/standalone-and-hvm/
 redirect_from:
- /doc/standalone-and-hvm/
 - /doc/hvm/
 - /doc/hvm-create/
 - /en/doc/hvm-create/
--- a/user/managing-os/templates.md
+++ b/user/managing-os/templates.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/templates/
 redirect_from:
- /doc/templates/
 - /doc/template/
 - /en/doc/templates/
 - /doc/Templates/
--- a/user/managing-os/windows.md
+++ b/user/managing-os/windows.md
@ -1,8 +1,7 @@
 ---
 lang: en
 layout: doc
-redirect_from:
- /doc/windows/
+permalink: /doc/windows/
 ref: 129
 title: Windows VMs
 ---
--- a/user/managing-os/xfce-templates.md
+++ b/user/managing-os/xfce-templates.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/templates/xfce/
 redirect_from:
- /doc/templates/xfce/
 - /doc/xfce/
 - /en/doc/templates/xfce/
 - /doc/Templates/Xfce/
--- a/user/reference/glossary.md
+++ b/user/reference/glossary.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/glossary/
 redirect_from:
- /doc/glossary/
 - /en/doc/glossary/
 - /doc/Glossary/
 - /wiki/Glossary/
--- a/user/reference/qubes-service.md
+++ b/user/reference/qubes-service.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/qubes-service/
 redirect_from:
- /doc/qubes-service/
 - /en/doc/qubes-service/
 - /doc/QubesService/
 - /wiki/QubesService/
--- a/user/reference/research.md
+++ b/user/reference/research.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: default
+permalink: /research/
 redirect_from:
- /research/
 - /doc/qubes-research/
 - /en/doc/qubes-research/
 - /doc/QubesResearch/
--- a/user/reference/tools.md
+++ b/user/reference/tools.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/tools/
 redirect_from:
- /doc/tools/
 - /doc/tools/4.0/
 - /doc/tools/4.0/dom0/
 - /doc/tools/4.0/domU/
--- a/user/security-in-qubes/anti-evil-maid.md
+++ b/user/security-in-qubes/anti-evil-maid.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/anti-evil-maid/
 redirect_from:
- /doc/anti-evil-maid/
 - /en/doc/anti-evil-maid/
 - /doc/AntiEvilMaid/
 - /wiki/AntiEvilMaid/
--- a/user/security-in-qubes/data-leaks.md
+++ b/user/security-in-qubes/data-leaks.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/data-leaks/
 redirect_from:
- /doc/data-leaks/
 - /en/doc/data-leaks/
 - /doc/DataLeaks/
 - /wiki/DataLeaks/
--- a/user/security-in-qubes/device-handling-security.md
+++ b/user/security-in-qubes/device-handling-security.md
@ -1,8 +1,7 @@
 ---
 lang: en
 layout: doc
-redirect_from:
- /doc/device-handling-security/
+permalink: /doc/device-handling-security/
 ref: 170
 title: Device Handling Security
 ---
--- a/user/security-in-qubes/firewall.md
+++ b/user/security-in-qubes/firewall.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/firewall/
 redirect_from:
- /doc/firewall/
 - /doc/qubes-firewall/
 - /en/doc/qubes-firewall/
 - /doc/QubesFirewall/
--- a/user/security-in-qubes/split-gpg.md
+++ b/user/security-in-qubes/split-gpg.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/split-gpg/
 redirect_from:
- /doc/split-gpg/
 - /en/doc/split-gpg/
 - /doc/SplitGpg/
 - /doc/UserDoc/SplitGpg/
--- a/user/security-in-qubes/u2f-proxy.md
+++ b/user/security-in-qubes/u2f-proxy.md
@ -1,8 +1,7 @@
 ---
 lang: en
 layout: doc
-redirect_from:
- /doc/u2f-proxy/
+permalink: /doc/u2f-proxy/
 ref: 167
 title: The Qubes U2F Proxy
 ---
--- a/user/security-in-qubes/vm-sudo.md
+++ b/user/security-in-qubes/vm-sudo.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/vm-sudo/
 redirect_from:
- /doc/vm-sudo/
 - /en/doc/vm-sudo/
 - /doc/VMSudo/
 - /wiki/VMSudo/
--- a/user/security-in-qubes/yubi-key.md
+++ b/user/security-in-qubes/yubi-key.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/yubi-key/
 redirect_from:
- /doc/yubi-key/
 - /en/doc/yubi-key/
 - /doc/YubiKey/
 ref: 169
--- a/user/troubleshooting/disk-troubleshooting.md
+++ b/user/troubleshooting/disk-troubleshooting.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/disk-troubleshooting/
 redirect_from:
- /doc/disk-troubleshooting/
 - /en/doc/out-of-memory/
 - /doc/OutOfmemory/
 - /wiki/OutOfmemory/
--- a/user/troubleshooting/gui-troubleshooting.md
+++ b/user/troubleshooting/gui-troubleshooting.md
@ -1,8 +1,7 @@
 ---
 lang: en
 layout: doc
-redirect_from:
- /doc/gui-troubleshooting/
+permalink: /doc/gui-troubleshooting/
 ref: 233
 title: GUI Troubleshooting
 ---
--- a/user/troubleshooting/hardware-troubleshooting.md
+++ b/user/troubleshooting/hardware-troubleshooting.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/hardware-troubleshooting/
 redirect_from:
- /doc/hardware-troubleshooting/
 - /doc/newer-hardware-troubleshooting/
 ref: 97
 title: Hardware Troubleshooting
--- a/user/troubleshooting/hvm-troubleshooting.md
+++ b/user/troubleshooting/hvm-troubleshooting.md
@ -1,8 +1,7 @@
 ---
 lang: en
 layout: doc
-redirect_from:
- /doc/hvm-troubleshooting/
+permalink: /doc/hvm-troubleshooting/
 ref: 232
 title: HVM Troubleshooting
 ---
--- a/user/troubleshooting/installation-troubleshooting.md
+++ b/user/troubleshooting/installation-troubleshooting.md
@ -1,8 +1,7 @@
 ---
 lang: en
 layout: doc
-redirect_from:
- /doc/installation-troubleshooting/
+permalink: /doc/installation-troubleshooting/
 ref: 224
 title: Installation Troubleshooting
 ---
--- a/user/troubleshooting/managing-appvm-shortcuts.md
+++ b/user/troubleshooting/managing-appvm-shortcuts.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/managing-appvm-shortcuts/
 redirect_from:
- /doc/managing-appvm-shortcuts/
 - /en/doc/managing-appvm-shortcuts/
 - /doc/ManagingAppVmShortcuts/
 - /wiki/ManagingAppVmShortcuts/
--- a/user/troubleshooting/media-troubleshooting.md
+++ b/user/troubleshooting/media-troubleshooting.md
@ -1,8 +1,7 @@
 ---
 lang: en
 layout: doc
-redirect_from:
- /doc/media-troubleshooting/
+permalink: /doc/media-troubleshooting/
 ref: 235
 title: Media Troubleshooting
 ---
--- a/user/troubleshooting/pci-troubleshooting.md
+++ b/user/troubleshooting/pci-troubleshooting.md
@ -1,8 +1,7 @@
 ---
 lang: en
 layout: doc
-redirect_from:
- /doc/pci-troubleshooting/
+permalink: /doc/pci-troubleshooting/
 ref: 230
 title: PCI Troubleshooting
 ---
--- a/user/troubleshooting/resume-suspend-troubleshooting.md
+++ b/user/troubleshooting/resume-suspend-troubleshooting.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/suspend-resume-troubleshooting/
 redirect_from:
- /doc/suspend-resume-troubleshooting/
 - /en/doc/wireless-troubleshooting/
 - /doc/wireless-troubleshooting/
 ref: 94
--- a/user/troubleshooting/uefi-troubleshooting.md
+++ b/user/troubleshooting/uefi-troubleshooting.md
@ -1,8 +1,7 @@
 ---
 lang: en
 layout: doc
-redirect_from:
- /doc/uefi-troubleshooting/
+permalink: /doc/uefi-troubleshooting/
 ref: 177
 title: UEFI Troubleshooting
 ---
--- a/user/troubleshooting/update-troubleshooting.md
+++ b/user/troubleshooting/update-troubleshooting.md
@ -1,8 +1,7 @@
 ---
 lang: en
 layout: doc
-redirect_from:
- /doc/update-troubleshooting/
+permalink: /doc/update-troubleshooting/
 ref: 239
 title: Update Troubleshooting
 ---
--- a/user/troubleshooting/updating-debian-and-whonix.md
+++ b/user/troubleshooting/updating-debian-and-whonix.md
@ -1,8 +1,7 @@
 ---
 lang: en
 layout: doc
-redirect_from:
- /doc/troubleshooting/updating-debian-and-whonix/
+permalink: /doc/troubleshooting/updating-debian-and-whonix/
 ref: 98
 title: Updating Debian and Whonix
 ---
--- a/user/troubleshooting/usb-troubleshooting.md
+++ b/user/troubleshooting/usb-troubleshooting.md
@ -1,8 +1,7 @@
 ---
 lang: en
 layout: doc
-redirect_from:
- /doc/usb-troubleshooting/
+permalink: /doc/usb-troubleshooting/
 ref: 234
 title: USB Troubleshooting
 ---
--- a/user/troubleshooting/vm-troubleshooting.md
+++ b/user/troubleshooting/vm-troubleshooting.md
@ -1,8 +1,8 @@
 ---
 lang: en
 layout: doc
+permalink: /doc/vm-troubleshooting/
 redirect_from:
- /doc/vm-troubleshooting/
 - /doc/remove-vm-manually/
 ref: 223
 title: VM Troubleshooting
--- a/user/troubleshooting/vpn-troubleshooting.md
+++ b/user/troubleshooting/vpn-troubleshooting.md
@ -1,8 +1,7 @@
 ---
 lang: en
 layout: doc
-redirect_from:
- /doc/vpn-troubleshooting/
+permalink: /doc/vpn-troubleshooting/
 ref: 240
 title: VPN Troubleshooting
 ---