UEFI.md

-[[!tag archived]]
+
 
 We want at least basic UEFI boot including Mac.
 
-* [[Design documentation|contribute/design/UEFI]]
-* Ticket: [[!tails_ticket 5739]]
-* Branch: [[!tails_gitweb_branch feature/uefi]]
+* [Design documentation](https://tails.boum.org/contribute/design/UEFI)
+* Ticket: tails/tails#5739
+* Branch: [feature/uefi](https://gitlab.tails.boum.org/tails/tails/-/commits/feature/uefi/)
+
+
+[[_TOC_]]
 
-[[!toc levels=2]]
 
 <a id="testing-results"></a>
 
 Testing results
 ===============
 
-* [[blueprint/UEFI/syslinux]]
-* [[blueprint/UEFI/GRUB]]
+* [syslinux](UEFI/syslinux)
+* [GRUB](UEFI/GRUB)
 
 <a id="future-work"></a>
 
@@ -25,15 +27,15 @@ Other ideas
 -----------
 
 Most of the possible candidate goals that were
-[[rejected|contribute/design/UEFI#non-goals]] for this initial iteration are not
+[rejected](https://tails.boum.org/contribute/design/UEFI) for this initial iteration are not
 critical. Pursuing these would require substantial effort, that is
 better put into other Tails improvements. Therefore, they have not
-made their way into our [[!tails_roadmap]]. Some have low-priority
-tickets on [[!tails_gitlab desc="GitLab"]], meaning that patches are
+made their way into our [roadmap](https://tails.boum.org/contribute/roadmap). Some have low-priority
+tickets on [GitLab](https://gitlab.tails.boum.org/), meaning that patches are
 welcome, but we do not feel committed, as a project, to make
 it happen.
 
-On the other hand, it appears that adding support for [[blueprint/UEFI_Secure_boot]] will be necessary at some point. More and more
+On the other hand, it appears that adding support for [UEFI Secure boot](UEFI_Secure_boot) will be necessary at some point. More and more
 off-the-shelf PC hardware is shipped with this functionality enabled.
 Also, having to constantly disable and re-enable Secure boot in the
 firmware configuration is not the best dual-boot user experience we
@@ -42,7 +44,7 @@ with Secure boot enabled).
 
 To end with, another task that we would be very happy to tackle would
 be to upstream our work and make it available to all Debian Live users
-and downstreams. However, as explained on [[!tails_ticket 5691]] and
+and downstreams. However, as explained on tails/tails#5691 and
 <https://lists.debian.org/debian-live/2013/11/msg00017.html>:
 
 1. we are still using an old version of live-build;
@@ -85,7 +87,7 @@ Resources
   to upstream. Upstream is working on fixing this. That would allow
   starting Tails on Mac UEFI.
 * Steve McIntyre's EFI installation progress:
-  - [[!debpkg debian-cd]] 3.1.11 has x86 EFI support, see the
+  - [debian-cd](http://packages.debian.org/debian%2Dcd) 3.1.11 has x86 EFI support, see the
     `debian/changelog` for details
   - [fourth](http://blog.einval.com/2012/09/03#Debian_EFI_4) (2012-09-03)
   - [third](http://blog.einval.com/2012/08/24#Debian_EFI_3)
@@ -93,7 +95,7 @@ Resources
   - [first](http://blog.einval.com/2012/08/12#Debian_EFI) (2012-08-12)
 * <https://lists.debian.org/debian-devel/2012/01/msg00168.html>
 * [Debian: switch to UEFI boot](http://tanguy.ortolo.eu/blog/article51/debian-efi)
-* [[!debbug 658352]] about adding UEFI support to Debian CDs
+* [Debian bug #658352](https://bugs.debian.org/658352) about adding UEFI support to Debian CDs
 * Liberte Linux supports UEFI (with GRUB, and syslinux for BIOS boot)
 * the [SprezzOS](http://www.sprezzatech.com/sprezzos.html)
   Debian derivative is [working on this](https://github.com/dankamongmen/SprezzOS/wiki/Installer) too:
@@ -126,7 +128,7 @@ Resources
   `ovmf` package): `qemu-system-x86_64 -bios /usr/share/ovmf/OVMF.fd`
 * Ubuntu's Firmware Test Suite
   - [homepage](https://wiki.ubuntu.com/FirmwareTestSuite)
-  - [[!debbug 748783 desc="Debian ITP"]]
+  - [Debian ITP](https://bugs.debian.org/748783)
   - [live version](https://wiki.ubuntu.com/HardwareEnablementTeam/Documentation/FirmwareTestSuiteLive)
   - [reference guide](https://wiki.ubuntu.com/Kernel/Reference/fwts)
 * Peter Jones' [The EFI System Partition and the Default Boot
@@ -149,7 +151,7 @@ OVMF
 
 ### Getting OVMF
 
-The [[!debpts ed2k]] source package (from which [[!debpkg ovmf]] is
+The [ed2k](https://tracker.debian.org/pkg/ed2k) source package (from which [ovmf](http://packages.debian.org/ovmf) is
 built) is a bit outdated in Debian, but it will hopefully be enough
 for our needs.
 
@@ -164,7 +166,7 @@ Else:
 
 ### Usage in VM
 
-* [[!debbug 714496]] documents how to use OVMF with libvirt. The [OVMF
+* [Debian bug #714496](https://bugs.debian.org/714496) documents how to use OVMF with libvirt. The [OVMF
   page](http://www.linux-kvm.org/page/OVMF) on the Linux KVM website
   documents this too. In short, add this line to the `<os>`
   section:
@@ -175,3 +177,4 @@ Else:
   OVMF on QEMU can be found in the *OvmfPkg/README: Update information
   about running OVMF*
   [thread](http://permalink.gmane.org/gmane.comp.bios.tianocore.devel/5716).
+