aboutsummaryrefslogtreecommitdiff
path: root/docs/distros
diff options
context:
space:
mode:
authorAlyssa Rosenzweig <alyssa@rosenzweig.io>2017-03-17 22:24:25 -0700
committerAlyssa Rosenzweig <alyssa@rosenzweig.io>2017-03-17 22:24:25 -0700
commitdbc480fb28a694ad5a587be025eabfded7c7784b (patch)
tree16b4251dcbdede274781f7bb8b1f23570853f3bb /docs/distros
parent85ec6862e8af0747420ca15fef7100edb5885302 (diff)
downloadlibrebootfr-dbc480fb28a694ad5a587be025eabfded7c7784b.tar.gz
librebootfr-dbc480fb28a694ad5a587be025eabfded7c7784b.zip
Convert documentation to markdown
Diffstat (limited to 'docs/distros')
-rw-r--r--docs/distros/index.html181
-rw-r--r--docs/distros/index.md143
2 files changed, 143 insertions, 181 deletions
diff --git a/docs/distros/index.html b/docs/distros/index.html
deleted file mode 100644
index d698a90a..00000000
--- a/docs/distros/index.html
+++ /dev/null
@@ -1,181 +0,0 @@
-<!DOCTYPE html>
-<html>
-<head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width, initial-scale=1">
-
- <style type="text/css">
- @import url('../css/main.css');
- </style>
-
- <title>List of recommended GNU+Linux distributions for libreboot</title>
-</head>
-
-<body>
-
- <div class="section">
- <h1 id="pagetop">List of recommended GNU+Linux distributions for libreboot</h1>
- <p>
- Any distribution should work, so long as it uses kernel mode setting for graphics.
- We recommend using distributions that are entirely free software; most distros
- out there have proprietary software in them, but the ones that we recommend
- do not have proprietary software by default.
- </p>
- <p>
- Note: we are not the Free Software Foundation. The recommendations here
- consist of both FSF-endorsed and non-FSF-endorsed distros. Some of these
- distributions wrongly call the whole system <em>Linux</em>. Despite libreboot's
- <a href="../../gnu/">stance against the GNU project</a>, we still agree
- with the free software philosophy and we still want you to call the
- whole system <em>GNU+Linux</em>, since this is the technically correct
- name for the system.
- </p>
- <h2>FSF-endorsed distros</h2>
- <p>
- Many FSF-endorsed GNU+Linux distributions are considered unfit
- for general use by the libreboot project.
- You can read about their problems here:<br/>
- <a href="../fsf-distros/">Why we can't endorse many FSF-endorsed distributions</a>.
- </p>
- <p>
- <a href="../gnulinux/grub_boot_installer.html">How to install GNU+Linux on a libreboot system</a>
- </p>
- <p>
- <a href="../">Back to main index</a>
- </p>
- </div>
-
- <div class="section">
-
- <h2>Debian</h2>
- <p>
- Most of the developers use it (Leah Rowe always uses testing
- releases of Debian). We recommend Debian stable releases for
- most users. If you want to do development, e.g. libreboot
- development, then you should use the testing release of Debian.
- </p>
- <p>
- Debian by default comes without non-free software in the default
- installation or repos. There is a non-free repo that's not added
- by default. Just avoid adding this, and you should have a fully
- free system.
- </p>
- <p>
- <a href="https://www.debian.org/">Visit the Debian website</a>
- </p>
- <p>
- We recommend using the <em>MATE</em> desktop.
- </p>
- <h2>Devuan</h2>
- <p>
- Devuan is a fork of Debian that does not use the controversial
- <em>systemd</em> init system.
- </p>
- <p>
- See: <a href="https://www.devuan.org/os/init-freedom/">https://www.devuan.org/os/init-freedom/</a>.
- </p>
- <p>
- <a href="https://www.devuan.org/">Visit the Devuan website</a>
- </p>
- <p>
- We recommend using the <em>MATE</em> desktop.
- </p>
- <h2>Qubes</h2>
- <p>
- Security-focussed distribution. It makes heavy use of IOMMU and
- hardware virtualization to separate running
- applications, along with other security features. Provides
- a full hypervisor for running applications.
- </p>
- <p>
- Also heavily in favour of adoption of both Libreboot and Coreboot.
- </p>
- <p>
- <strong>
- Of all available Libreboot systems, Qubes is currently only known
- to be compatible with the ASUS KGPE-D16 and KCMA-D8, due to the
- hardware virtualization requirement (and even on those boards,
- only certain CPUs have fully functional virtualization in
- Libreboot).
- </strong>
- </p>
- <p>
- <a href="https://www.qubes-os.org/">Visit the Qubes website</a>
- </p>
- <h2>Dragora</h2>
- <p>
- Fully free distribution, with a focus on simple package management
- and configuration. Experienced users might like this distro. It also
- has native support for multiple languages.
- </p>
- <p>
- <a href="https://dragora.org/">Visit the Dragora website</a>
- </p>
- <h2>Parabola</h2>
- <p>
- Fully free bleeding edge distribution, based on the <em>Arch</em> distribution.
- Good for saavy users and developers in general (some libreboot developers
- use this).
- </p>
- <p>
- Arch users, refer to the <a href="https://wiki.parabola.nu/Migration_from_the_GNU+Linux_distribution_of_Arch">Parabola migration guide</a>.
- </p>
- <p>
- <a href="https://www.parabola.nu/">Visit the Parabola website</a>
- </p>
- <p>
- We recommend using the <em>MATE</em> desktop.
- </p>
-
- </div>
-
- <div class="section">
-
- <p>
- Copyright &copy; 2016 Leah Rowe &lt;info@minifree.org&gt;<br/>
- Permission is granted to copy, distribute and/or modify this document
- under the terms of the Creative Commons Attribution-ShareAlike 4.0 International license
- or any later version published by Creative Commons;
-
- A copy of the license can be found at <a href="../cc-by-sa-4.0.txt">../cc-by-sa-4.0.txt</a>
- </p>
-
- <p>
- Updated versions of the license (when available) can be found at
- <a href="https://creativecommons.org/licenses/by-sa/4.0/legalcode">https://creativecommons.org/licenses/by-sa/4.0/legalcode</a>
- </p>
-
- <p>
- UNLESS OTHERWISE SEPARATELY UNDERTAKEN BY THE LICENSOR, TO THE
- EXTENT POSSIBLE, THE LICENSOR OFFERS THE LICENSED MATERIAL AS-IS
- AND AS-AVAILABLE, AND MAKES NO REPRESENTATIONS OR WARRANTIES OF
- ANY KIND CONCERNING THE LICENSED MATERIAL, WHETHER EXPRESS,
- IMPLIED, STATUTORY, OR OTHER. THIS INCLUDES, WITHOUT LIMITATION,
- WARRANTIES OF TITLE, MERCHANTABILITY, FITNESS FOR A PARTICULAR
- PURPOSE, NON-INFRINGEMENT, ABSENCE OF LATENT OR OTHER DEFECTS,
- ACCURACY, OR THE PRESENCE OR ABSENCE OF ERRORS, WHETHER OR NOT
- KNOWN OR DISCOVERABLE. WHERE DISCLAIMERS OF WARRANTIES ARE NOT
- ALLOWED IN FULL OR IN PART, THIS DISCLAIMER MAY NOT APPLY TO YOU.
- </p>
- <p>
- TO THE EXTENT POSSIBLE, IN NO EVENT WILL THE LICENSOR BE LIABLE
- TO YOU ON ANY LEGAL THEORY (INCLUDING, WITHOUT LIMITATION,
- NEGLIGENCE) OR OTHERWISE FOR ANY DIRECT, SPECIAL, INDIRECT,
- INCIDENTAL, CONSEQUENTIAL, PUNITIVE, EXEMPLARY, OR OTHER LOSSES,
- COSTS, EXPENSES, OR DAMAGES ARISING OUT OF THIS PUBLIC LICENSE OR
- USE OF THE LICENSED MATERIAL, EVEN IF THE LICENSOR HAS BEEN
- ADVISED OF THE POSSIBILITY OF SUCH LOSSES, COSTS, EXPENSES, OR
- DAMAGES. WHERE A LIMITATION OF LIABILITY IS NOT ALLOWED IN FULL OR
- IN PART, THIS LIMITATION MAY NOT APPLY TO YOU.
- </p>
- <p>
- The disclaimer of warranties and limitation of liability provided
- above shall be interpreted in a manner that, to the extent
- possible, most closely approximates an absolute disclaimer and
- waiver of all liability.
- </p>
-
- </div>
-
-</body>
-</html>
diff --git a/docs/distros/index.md b/docs/distros/index.md
new file mode 100644
index 00000000..e456e9f0
--- /dev/null
+++ b/docs/distros/index.md
@@ -0,0 +1,143 @@
+<div class="section">
+
+List of recommended GNU+Linux distributions for libreboot {#pagetop}
+=========================================================
+
+Any distribution should work, so long as it uses kernel mode setting for
+graphics. We recommend using distributions that are entirely free
+software; most distros out there have proprietary software in them, but
+the ones that we recommend do not have proprietary software by default.
+
+Note: we are not the Free Software Foundation. The recommendations here
+consist of both FSF-endorsed and non-FSF-endorsed distros. Some of these
+distributions wrongly call the whole system *Linux*. Despite
+libreboot\'s [stance against the GNU project](../../gnu/), we still
+agree with the free software philosophy and we still want you to call
+the whole system *GNU+Linux*, since this is the technically correct name
+for the system.
+
+FSF-endorsed distros
+--------------------
+
+Many FSF-endorsed GNU+Linux distributions are considered unfit for
+general use by the libreboot project. You can read about their problems
+here:\
+[Why we can\'t endorse many FSF-endorsed
+distributions](../fsf-distros/).
+
+[How to install GNU+Linux on a libreboot
+system](../gnulinux/grub_boot_installer.html)
+
+[Back to main index](../)
+
+</div>
+
+<div class="section">
+
+Debian
+------
+
+Most of the developers use it (Leah Rowe always uses testing releases of
+Debian). We recommend Debian stable releases for most users. If you want
+to do development, e.g. libreboot development, then you should use the
+testing release of Debian.
+
+Debian by default comes without non-free software in the default
+installation or repos. There is a non-free repo that\'s not added by
+default. Just avoid adding this, and you should have a fully free
+system.
+
+[Visit the Debian website](https://www.debian.org/)
+
+We recommend using the *MATE* desktop.
+
+Devuan
+------
+
+Devuan is a fork of Debian that does not use the controversial *systemd*
+init system.
+
+See: <https://www.devuan.org/os/init-freedom/>.
+
+[Visit the Devuan website](https://www.devuan.org/)
+
+We recommend using the *MATE* desktop.
+
+Qubes
+-----
+
+Security-focussed distribution. It makes heavy use of IOMMU and hardware
+virtualization to separate running applications, along with other
+security features. Provides a full hypervisor for running applications.
+
+Also heavily in favour of adoption of both Libreboot and Coreboot.
+
+**Of all available Libreboot systems, Qubes is currently only known to
+be compatible with the ASUS KGPE-D16 and KCMA-D8, due to the hardware
+virtualization requirement (and even on those boards, only certain CPUs
+have fully functional virtualization in Libreboot).**
+
+[Visit the Qubes website](https://www.qubes-os.org/)
+
+Dragora
+-------
+
+Fully free distribution, with a focus on simple package management and
+configuration. Experienced users might like this distro. It also has
+native support for multiple languages.
+
+[Visit the Dragora website](https://dragora.org/)
+
+Parabola
+--------
+
+Fully free bleeding edge distribution, based on the *Arch* distribution.
+Good for saavy users and developers in general (some libreboot
+developers use this).
+
+Arch users, refer to the [Parabola migration
+guide](https://wiki.parabola.nu/Migration_from_the_GNU+Linux_distribution_of_Arch).
+
+[Visit the Parabola website](https://www.parabola.nu/)
+
+We recommend using the *MATE* desktop.
+
+</div>
+
+<div class="section">
+
+Copyright © 2016 Leah Rowe &lt;info@minifree.org&gt;\
+Permission is granted to copy, distribute and/or modify this document
+under the terms of the Creative Commons Attribution-ShareAlike 4.0
+International license or any later version published by Creative
+Commons; A copy of the license can be found at
+[../cc-by-sa-4.0.txt](../cc-by-sa-4.0.txt)
+
+Updated versions of the license (when available) can be found at
+<https://creativecommons.org/licenses/by-sa/4.0/legalcode>
+
+UNLESS OTHERWISE SEPARATELY UNDERTAKEN BY THE LICENSOR, TO THE EXTENT
+POSSIBLE, THE LICENSOR OFFERS THE LICENSED MATERIAL AS-IS AND
+AS-AVAILABLE, AND MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND
+CONCERNING THE LICENSED MATERIAL, WHETHER EXPRESS, IMPLIED, STATUTORY,
+OR OTHER. THIS INCLUDES, WITHOUT LIMITATION, WARRANTIES OF TITLE,
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT,
+ABSENCE OF LATENT OR OTHER DEFECTS, ACCURACY, OR THE PRESENCE OR ABSENCE
+OF ERRORS, WHETHER OR NOT KNOWN OR DISCOVERABLE. WHERE DISCLAIMERS OF
+WARRANTIES ARE NOT ALLOWED IN FULL OR IN PART, THIS DISCLAIMER MAY NOT
+APPLY TO YOU.
+
+TO THE EXTENT POSSIBLE, IN NO EVENT WILL THE LICENSOR BE LIABLE TO YOU
+ON ANY LEGAL THEORY (INCLUDING, WITHOUT LIMITATION, NEGLIGENCE) OR
+OTHERWISE FOR ANY DIRECT, SPECIAL, INDIRECT, INCIDENTAL, CONSEQUENTIAL,
+PUNITIVE, EXEMPLARY, OR OTHER LOSSES, COSTS, EXPENSES, OR DAMAGES
+ARISING OUT OF THIS PUBLIC LICENSE OR USE OF THE LICENSED MATERIAL, EVEN
+IF THE LICENSOR HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH LOSSES,
+COSTS, EXPENSES, OR DAMAGES. WHERE A LIMITATION OF LIABILITY IS NOT
+ALLOWED IN FULL OR IN PART, THIS LIMITATION MAY NOT APPLY TO YOU.
+
+The disclaimer of warranties and limitation of liability provided above
+shall be interpreted in a manner that, to the extent possible, most
+closely approximates an absolute disclaimer and waiver of all liability.
+
+</div>