From df8d8a95f7a9574b11d8ab3645f29e3f53e051d9 Mon Sep 17 00:00:00 2001 From: Aditya Garg Date: Sun, 2 Jun 2024 18:50:52 +0530 Subject: [PATCH] Add icons to the wiki --- docs/contribute.md | 16 ++++---- docs/distributions/arch/faq.md | 4 ++ docs/distributions/arch/installation.md | 4 ++ docs/distributions/debian/installation.md | 4 ++ .../distributions/endeavouros/installation.md | 4 ++ docs/distributions/fedora/faq.md | 4 ++ docs/distributions/fedora/home.md | 6 ++- docs/distributions/fedora/installation.md | 4 ++ docs/distributions/gentoo/installation.md | 4 ++ docs/distributions/manjaro/deprecation.md | 8 +++- docs/distributions/manjaro/faq.md | 6 ++- docs/distributions/manjaro/home.md | 8 +++- docs/distributions/manjaro/installation.md | 6 ++- docs/distributions/nixos/faq.md | 4 ++ docs/distributions/nixos/home.md | 8 +++- docs/distributions/nixos/installation.md | 4 ++ docs/distributions/overview.md | 20 ++++++---- docs/distributions/ubuntu/faq.md | 4 ++ docs/distributions/ubuntu/home.md | 6 ++- docs/distributions/ubuntu/installation.md | 8 +++- docs/guides/audio-config.md | 4 ++ docs/guides/fan.md | 4 ++ docs/guides/hybrid-graphics.md | 8 +++- docs/guides/kernel.md | 4 ++ docs/guides/postinstall.md | 27 ++++++++------ docs/guides/preinstall.md | 28 ++++++++------ docs/guides/refind.md | 4 ++ docs/guides/startup-manager.md | 4 ++ docs/guides/uninstall.md | 4 ++ docs/guides/wifi-bluetooth.md | 37 ++++++++----------- docs/guides/windows.md | 16 +++++--- mkdocs.yml | 6 +++ 32 files changed, 198 insertions(+), 80 deletions(-) diff --git a/docs/contribute.md b/docs/contribute.md index 8514559a..4fd8df2a 100644 --- a/docs/contribute.md +++ b/docs/contribute.md @@ -8,14 +8,14 @@ The best way of donation which we believe is in the form of skill. If you think See "partially working" features at [State](https://wiki.t2linux.org/state/) to get an idea of what's being worked on, and what should be worked on. -## Support our maintainers +## Support our maintainers :material-heart: Here is the list and links to donate some of our maintainers. -- [MCMrARM](https://github.com/MCMrARM) - Author of the [apple-bce driver](https://github.com/t2linux/apple-bce-drv). Donate via [Paypal](https://paypal.me/mcmrarm). -- [JPyke3](https://github.com/JPyke3) - Played major role in getting Manjaro working on T2 Macs. Donate via [Patreon](https://patreon.com/pykee) or [On Chain](https://github.com/JPyke3/mbp-manjaro#donations). -- [marcosfad](https://github.com/marcosfad) - Played major role in getting Ubuntu working on T2 Macs. Donate via [Paypal](https://paypal.me/marcosfad) or [GitHub Sponsors](https://github.com/sponsors/marcosfad). -- [NoaHimesaka1873](https://github.com/NoaHimesaka1873) - Currently maintains boot images and kernels for Arch and EndeavourOS. Donate via [GitHub Sponsors](https://github.com/sponsors/NoaHimesaka1873) or [Toss (South Korea residents only)](https://toss.me/yuruverse). -- [Redecorating](https://github.com/Redecorating) - Played a major role in adding support for T2 Macs in the apple-gmux driver, required for hybrid graphics. Also has written T2 related kernel patches and worked on T2 related kernel regressions. Donate via [PayPal](https://paypal.me/redecorating). -- [AdityaGarg8](https://github.com/AdityaGarg8) - Current maintainer of Ubuntu. Has also helped in writing T2 kernel patches and upstreaming various patches. Donate via **Amazon Gift Cards India** ([Link for Indians](https://www.amazon.in/s?k=amazon+e-gift+voucher&adgrpid=60620499282&ext_vrnc=hi&gclid=Cj0KCQjw8O-VBhCpARIsACMvVLMW9KEhsWO9xHEvOh7VLo3lCimvvJJqaKdqwj-OlN_ZAMp3ZIztQ0AaAtGAEALw_wcB&hvadid=294106443315&hvdev=m&hvlocphy=9075215&hvnetw=g&hvqmt=b&hvrand=11733182626932158840&hvtargid=kwd-314681002020&hydadcr=15237_1791630&tag=googinhydrmob-21&ref=pd_sl_3qs6ai50tg_b), [Link for other countries](https://www.g2a.com/search?query=Amazon%20India)), **GitHub sponsors** ([Link](https://github.com/sponsors/AdityaGarg8)) or **Buy Me a Coffee** ([Link](https://www.buymeacoffee.com/gargadityav)). The cards can be emailed to **gargaditya08@live.com** or via the discord. -- [networkException](https://github.com/networkException) - Wiki creator and maintainer. Donate via [GitHub Sponsors](https://github.com/sponsors/networkException). +- [MCMrARM](https://github.com/MCMrARM) - Author of the [apple-bce driver](https://github.com/t2linux/apple-bce-drv). Donate via [Paypal :simple-paypal:](https://paypal.me/mcmrarm). +- [JPyke3](https://github.com/JPyke3) - Played major role in getting Manjaro working on T2 Macs. Donate via [Patreon :simple-patreon:](https://patreon.com/pykee) or [On Chain](https://github.com/JPyke3/mbp-manjaro#donations). +- [marcosfad](https://github.com/marcosfad) - Played major role in getting Ubuntu working on T2 Macs. Donate via [Paypal :simple-paypal:](https://paypal.me/marcosfad) or [GitHub Sponsors :octicons-heart-16:](https://github.com/sponsors/marcosfad). +- [NoaHimesaka1873](https://github.com/NoaHimesaka1873) - Currently maintains boot images and kernels for Arch and EndeavourOS. Donate via [GitHub Sponsors :octicons-heart-16:](https://github.com/sponsors/NoaHimesaka1873) or [Toss (South Korea residents only)](https://toss.me/yuruverse). +- [Redecorating](https://github.com/Redecorating) - Played a major role in adding support for T2 Macs in the apple-gmux driver, required for hybrid graphics. Also has written T2 related kernel patches and worked on T2 related kernel regressions. Donate via [PayPal :simple-paypal:](https://paypal.me/redecorating). +- [AdityaGarg8](https://github.com/AdityaGarg8) - Current maintainer of Ubuntu. Has also helped in writing T2 kernel patches and upstreaming various patches. Donate via **Amazon Gift Cards India :simple-amazon:** ([Link for Indians](https://www.amazon.in/s?k=amazon+e-gift+voucher&adgrpid=60620499282&ext_vrnc=hi&gclid=Cj0KCQjw8O-VBhCpARIsACMvVLMW9KEhsWO9xHEvOh7VLo3lCimvvJJqaKdqwj-OlN_ZAMp3ZIztQ0AaAtGAEALw_wcB&hvadid=294106443315&hvdev=m&hvlocphy=9075215&hvnetw=g&hvqmt=b&hvrand=11733182626932158840&hvtargid=kwd-314681002020&hydadcr=15237_1791630&tag=googinhydrmob-21&ref=pd_sl_3qs6ai50tg_b), [Link for other countries](https://www.g2a.com/search?query=Amazon%20India)), **GitHub sponsors :octicons-heart-16:** ([Link](https://github.com/sponsors/AdityaGarg8)) or **Buy Me a Coffee :simple-buymeacoffee:** ([Link](https://www.buymeacoffee.com/gargadityav)). The cards can be emailed to **gargaditya08@live.com** or via the discord. +- [networkException](https://github.com/networkException) - Wiki creator and maintainer. Donate via [GitHub Sponsors :octicons-heart-16:](https://github.com/sponsors/networkException). diff --git a/docs/distributions/arch/faq.md b/docs/distributions/arch/faq.md index a6f9e2b6..7121a92f 100644 --- a/docs/distributions/arch/faq.md +++ b/docs/distributions/arch/faq.md @@ -1,3 +1,7 @@ +--- +icon: simple/archlinux +--- + # Updating Kernel `linux-mbp` is abandoned. Switch to `linux-t2` or `linux-xanmod-edge-t2` now if you're still using `linux-mbp`. diff --git a/docs/distributions/arch/installation.md b/docs/distributions/arch/installation.md index 87574ff9..216ce2d7 100644 --- a/docs/distributions/arch/installation.md +++ b/docs/distributions/arch/installation.md @@ -1,3 +1,7 @@ +--- +icon: simple/archlinux +--- + # Installing Arch Linux on a Mac with the T2 Chip You will need: diff --git a/docs/distributions/debian/installation.md b/docs/distributions/debian/installation.md index 65b3f7e7..d257fe24 100644 --- a/docs/distributions/debian/installation.md +++ b/docs/distributions/debian/installation.md @@ -1,3 +1,7 @@ +--- +icon: simple/debian +--- + # Introduction This guide shall help you in installing a Debian or Ubuntu based Linux distro, which is not available as a modified ISO with T2 support. diff --git a/docs/distributions/endeavouros/installation.md b/docs/distributions/endeavouros/installation.md index c7b0c5bf..27fc8018 100644 --- a/docs/distributions/endeavouros/installation.md +++ b/docs/distributions/endeavouros/installation.md @@ -1,3 +1,7 @@ +--- +icon: simple/endeavouros +--- + # Installing EndeavourOS on a Mac with the T2 Chip You will need: diff --git a/docs/distributions/fedora/faq.md b/docs/distributions/fedora/faq.md index 399abd67..81f7bc14 100644 --- a/docs/distributions/fedora/faq.md +++ b/docs/distributions/fedora/faq.md @@ -1,3 +1,7 @@ +--- +icon: simple/fedora +--- + # Installing alongside Windows If you already have Bootcamp installed, you might notice that the boot option for Bootcamp instead boots you into Fedora. This is because GRUB automatically shares with a Windows installation. Follow [this guide on triple booting](https://wiki.t2linux.org/guides/windows/#if-windows-is-installed-first) to get Windows working again. diff --git a/docs/distributions/fedora/home.md b/docs/distributions/fedora/home.md index bb05a73c..a23a511e 100644 --- a/docs/distributions/fedora/home.md +++ b/docs/distributions/fedora/home.md @@ -1,3 +1,7 @@ -Welcome to the T2 Fedora wiki! +--- +icon: simple/fedora +--- + +Welcome to the T2 Fedora wiki! :simple-fedora: Follow [the installation guide](https://wiki.t2linux.org/distributions/fedora/installation/) to get started. If you need help, join the t2linux discord [server](https://discord.com/invite/68MRhQu) server and ask in `#fedora` over there. Alternately, you can open an issue in the github [issue tracker](https://github.com/t2linux/wiki/issues). You can also refer to the [FAQ](https://wiki.t2linux.org/distributions/fedora/faq/) to fix common problems. diff --git a/docs/distributions/fedora/installation.md b/docs/distributions/fedora/installation.md index c836a2b6..ca2780c5 100644 --- a/docs/distributions/fedora/installation.md +++ b/docs/distributions/fedora/installation.md @@ -1,3 +1,7 @@ +--- +icon: simple/fedora +--- + # Download the latest safe release Many thanks to Mike for building. You can download a live iso from Mikeeq [here](https://github.com/mikeeq/mbp-fedora). diff --git a/docs/distributions/gentoo/installation.md b/docs/distributions/gentoo/installation.md index b292df90..a29ef17f 100644 --- a/docs/distributions/gentoo/installation.md +++ b/docs/distributions/gentoo/installation.md @@ -1,3 +1,7 @@ +--- +icon: material/gentoo +--- + # Installing Gentoo Linux on a T2 Mac ## Install Procedure diff --git a/docs/distributions/manjaro/deprecation.md b/docs/distributions/manjaro/deprecation.md index 62c61e24..58dfa505 100644 --- a/docs/distributions/manjaro/deprecation.md +++ b/docs/distributions/manjaro/deprecation.md @@ -1,11 +1,15 @@ -# Why is Manjaro T2 deprecated? +--- +icon: simple/manjaro +--- + +# Why is Manjaro T2 deprecated? :octicons-stop-16: Due to [concerns](https://github.com/arindas/manjarno), Manjaro T2 is deprecated. If you want to maintain it yourself, come to our Discord and we will help. # What distro should I use instead? -We recommend [EndeavourOS.](https://wiki.t2linux.org/distributions/endeavouros/installation/) +We recommend [EndeavourOS :simple-endeavouros:](https://wiki.t2linux.org/distributions/endeavouros/installation/) # What do I do after Manjaro is deprecated? diff --git a/docs/distributions/manjaro/faq.md b/docs/distributions/manjaro/faq.md index 8903c6bf..b0f846e8 100644 --- a/docs/distributions/manjaro/faq.md +++ b/docs/distributions/manjaro/faq.md @@ -1,4 +1,8 @@ -# Deprecation Notice +--- +icon: simple/manjaro +--- + +# Deprecation Notice :octicons-stop-16: Manjaro T2 support is deprecated. See [Deprecation Plan](https://wiki.t2linux.org/distributions/manjaro/deprecation) for more information. diff --git a/docs/distributions/manjaro/home.md b/docs/distributions/manjaro/home.md index 0cf2ce9a..f950fb6b 100644 --- a/docs/distributions/manjaro/home.md +++ b/docs/distributions/manjaro/home.md @@ -1,7 +1,11 @@ -# Deprecation Notice +--- +icon: simple/manjaro +--- + +# Deprecation Notice :octicons-stop-16: Manjaro T2 support is deprecated. See [Deprecation Plan](https://wiki.t2linux.org/distributions/manjaro/deprecation) for more information. -# Welcome to the Manjaro T2 wiki! +# Welcome to the Manjaro T2 wiki! :simple-manjaro: Click [here](https://wiki.t2linux.org/distributions/manjaro/installation/) to get started. diff --git a/docs/distributions/manjaro/installation.md b/docs/distributions/manjaro/installation.md index 8786644f..a5272369 100644 --- a/docs/distributions/manjaro/installation.md +++ b/docs/distributions/manjaro/installation.md @@ -1,4 +1,8 @@ -# Deprecation Notice +--- +icon: simple/manjaro +--- + +# Deprecation Notice :octicons-stop-16: Manjaro T2 support is deprecated. See [Deprecation Plan](https://wiki.t2linux.org/distributions/manjaro/deprecation) for more information. diff --git a/docs/distributions/nixos/faq.md b/docs/distributions/nixos/faq.md index 75f0a747..9a5825d4 100644 --- a/docs/distributions/nixos/faq.md +++ b/docs/distributions/nixos/faq.md @@ -1,3 +1,7 @@ +--- +icon: simple/nixos +--- + # The LiveCD does not boot/only shows a blank screen This situation occurred due to regressions in the bootloader, which the wider NixOS community was also affected. diff --git a/docs/distributions/nixos/home.md b/docs/distributions/nixos/home.md index 7c31835e..f7752fc5 100644 --- a/docs/distributions/nixos/home.md +++ b/docs/distributions/nixos/home.md @@ -1,6 +1,12 @@ +--- +icon: simple/nixos +--- + # Home -Welcome to the NixOS on T2 Linux wiki! To get started, head over to [the installation guide](./installation.md). +Welcome to the NixOS on T2 Linux wiki! :simple-nixos: + +To get started, head over to [the installation guide](./installation.md). If you have any questions, consult the [FAQ](./faq.md) to see if anything there helps. [Our discord server](https://discord.com/invite/68MRhQu) is also open; feel free to ask questions in the `#nixos` channel there. diff --git a/docs/distributions/nixos/installation.md b/docs/distributions/nixos/installation.md index e7337895..0fbc89a3 100644 --- a/docs/distributions/nixos/installation.md +++ b/docs/distributions/nixos/installation.md @@ -1,3 +1,7 @@ +--- +icon: simple/nixos +--- + diff --git a/docs/distributions/overview.md b/docs/distributions/overview.md index 4b93cbd7..afa8f265 100644 --- a/docs/distributions/overview.md +++ b/docs/distributions/overview.md @@ -1,12 +1,16 @@ +--- +icon: fontawesome/brands/linux +--- + # Introduction This is a landing page for the distribution specific guides contained in this wiki. -- [Arch Linux](https://wiki.t2linux.org/distributions/arch/installation/) -- [EndeavourOS](https://wiki.t2linux.org/distributions/endeavouros/installation/) -- [Fedora](https://wiki.t2linux.org/distributions/fedora/home/) -- [Gentoo](https://wiki.t2linux.org/distributions/gentoo/installation/) -- [Manjaro](https://wiki.t2linux.org/distributions/manjaro/home/) -- [NixOS](https://wiki.t2linux.org/distributions/nixos/home/) -- [Ubuntu](https://wiki.t2linux.org/distributions/ubuntu/home/) -- [Debian, Linux Mint, Kali, Pop!_OS and other similar distros](https://wiki.t2linux.org/distributions/debian/installation/) +- [Arch Linux :simple-archlinux:](https://wiki.t2linux.org/distributions/arch/installation/) +- [EndeavourOS :simple-endeavouros:](https://wiki.t2linux.org/distributions/endeavouros/installation/) +- [Fedora :simple-fedora:](https://wiki.t2linux.org/distributions/fedora/home/) +- [Gentoo :material-gentoo:](https://wiki.t2linux.org/distributions/gentoo/installation/) +- [Manjaro :simple-manjaro:](https://wiki.t2linux.org/distributions/manjaro/home/) +- [NixOS :simple-nixos:](https://wiki.t2linux.org/distributions/nixos/home/) +- [Ubuntu :material-ubuntu:](https://wiki.t2linux.org/distributions/ubuntu/home/) +- [Debian, Pop!_OS and other similar distros](https://wiki.t2linux.org/distributions/debian/installation/) diff --git a/docs/distributions/ubuntu/faq.md b/docs/distributions/ubuntu/faq.md index 435ec262..da4c2f26 100644 --- a/docs/distributions/ubuntu/faq.md +++ b/docs/distributions/ubuntu/faq.md @@ -1,3 +1,7 @@ +--- +icon: material/ubuntu +--- + # Why does my MacBook turn off in the middle of the Ubuntu installation? This seems to happen with certain MacBooks because the GRUB bootloader installer tries accessing the efivars/nvram, which Apple doesn't allow and the installer doesn't know what to do. diff --git a/docs/distributions/ubuntu/home.md b/docs/distributions/ubuntu/home.md index 6046ca86..ec6109e1 100644 --- a/docs/distributions/ubuntu/home.md +++ b/docs/distributions/ubuntu/home.md @@ -1,3 +1,7 @@ -Welcome to the T2 Ubuntu wiki! +--- +icon: material/ubuntu +--- + +Welcome to the T2 Ubuntu wiki! :material-ubuntu: Follow [the installation guide](https://wiki.t2linux.org/distributions/ubuntu/installation/) to get started. If you need help, join the t2linux discord [server](https://discord.com/invite/68MRhQu) server and ask in `#ubuntu` over there. Alternately, you can open an issue in the GitHub [issue tracker](https://github.com/t2linux/T2-Ubuntu/issues). You can also refer to the [FAQ](https://wiki.t2linux.org/distributions/ubuntu/faq/) to fix common problems. diff --git a/docs/distributions/ubuntu/installation.md b/docs/distributions/ubuntu/installation.md index ab363d22..ef81ae23 100644 --- a/docs/distributions/ubuntu/installation.md +++ b/docs/distributions/ubuntu/installation.md @@ -1,12 +1,16 @@ +--- +icon: material/ubuntu +--- + # Ubuntu ## Download the latest release Download Links: -[Ubuntu and Kubuntu](https://github.com/t2linux/T2-Ubuntu/releases/latest) +[Ubuntu and Kubuntu :material-ubuntu:](https://github.com/t2linux/T2-Ubuntu/releases/latest) -[Linux Mint](https://github.com/t2linux/T2-Mint/releases/latest) +[Linux Mint :simple-linuxmint:](https://github.com/t2linux/T2-Mint/releases/latest) ## Hardware Requirements diff --git a/docs/guides/audio-config.md b/docs/guides/audio-config.md index 2d1ad7c1..39324b64 100644 --- a/docs/guides/audio-config.md +++ b/docs/guides/audio-config.md @@ -1,3 +1,7 @@ +--- +icon: material/speaker +--- + # Introduction This page explains how to get the config files for using the T2 audio device, which allows use of the 3.5mm headphone port, the built in speakers, the built in mic and the headphones' mic. diff --git a/docs/guides/fan.md b/docs/guides/fan.md index 97ab29d9..ffb9760c 100644 --- a/docs/guides/fan.md +++ b/docs/guides/fan.md @@ -1,3 +1,7 @@ +--- +icon: material/fan +--- + # Introduction This page is a step by step guide to get fan control working on T2 Macs. diff --git a/docs/guides/hybrid-graphics.md b/docs/guides/hybrid-graphics.md index 62a1a98e..e3b73a0d 100644 --- a/docs/guides/hybrid-graphics.md +++ b/docs/guides/hybrid-graphics.md @@ -1,3 +1,7 @@ +--- +icon: simple/intel +--- + # Introduction This page describes how to use the iGPU on MacBookPro's with Hybrid Graphics (2 GPUs). 13 inch MacBooks only have an iGPU, and do not need this. Using the iGPU means you can save power by putting the more powerful AMD dGPU in a low power state when you don't need it. @@ -6,7 +10,7 @@ This has been tested on the MacBookPro16,1 and the MacBookPro15,1. The 15,3 and Make sure you have a t2 kernel of version greater than 6.6.2-2 (you can check this with `uname -r`). -## Issues +## Issues :fontawesome-solid-triangle-exclamation: If you experience system freezes, then the laptop's fans becoming loud, before the whole computer shuts off (CPU CATERR), or if the amdgpu is making the computer too hot, consider trying: @@ -45,7 +49,7 @@ If you experience system freezes, then the laptop's fans becoming loud, before t `glxinfo | grep "OpenGL renderer"` should show an Intel GPU. Running programs with `DRI_PRIME=1` will make them render on your AMD GPU (some things do this automatically). You will get more battery time now as your AMD GPU can be turned off when not needed. -## Use on Windows +## Use on Windows :fontawesome-brands-windows: The iGPU only works on Windows if there's no driver for it installed. Windows likes installing drivers. diff --git a/docs/guides/kernel.md b/docs/guides/kernel.md index f643583a..f4eca703 100644 --- a/docs/guides/kernel.md +++ b/docs/guides/kernel.md @@ -1,3 +1,7 @@ +--- +icon: simple/linux +--- + # Kernel This page explains how to compile a Linux kernel with patches for T2 hardware support and with apple-bce + apple-ibridge included. If you have issues, make sure you are running the commands here with `bash`. diff --git a/docs/guides/postinstall.md b/docs/guides/postinstall.md index b948742c..5eaa478d 100644 --- a/docs/guides/postinstall.md +++ b/docs/guides/postinstall.md @@ -1,3 +1,7 @@ +--- +icon: material/nut +--- + # Introduction This page explains how to perform a basic set up after installing Linux on a T2 Mac. @@ -18,17 +22,18 @@ Installing a kernel with support for T2 Macs is required in order to get the Key Many distro maintainers provide compiled kernels which can be installed on your Linux installation. Following are the links to the repos providing such kernels: -| Linux Distribution | Kernel with T2 support | -| ----------------------------------- | ---------------------- | -| Arch based distros | | -| Arch based distros (Xanmod kernels) | | -| Fedora | | -| Fedora | | -| Gentoo | | -| Manjaro | | -| NixOS | | -| Ubuntu based distros | | -| Debian based distros | | +| Linux Distribution | Kernel with T2 support | +| --------------------------------------------------- | ---------------------- | +| Arch based distros :material-arch: | | +| Arch based distros (Xanmod kernels) :material-arch: | | +| Fedora :simple-fedora: | | +| Fedora :simple-fedora: | | +| Gentoo :material-gentoo: | | +| Manjaro :simple-manjaro: | | +| NixOS :simple-nixos: | | +| Ubuntu based distros :material-ubuntu: | | +| Debian based distros :simple-debian: | | +| Debian based distros :simple-debian: | | If compiled kernels for your distro are not available, then you shall have to compile a kernel on your own. You can follow the [Kernel](https://wiki.t2linux.org/guides/kernel/) guide for help. diff --git a/docs/guides/preinstall.md b/docs/guides/preinstall.md index ff5d6608..97efdfe8 100644 --- a/docs/guides/preinstall.md +++ b/docs/guides/preinstall.md @@ -1,3 +1,7 @@ +--- +icon: octicons/check-16 +--- + # Pre install steps These steps are common to most distros. Please refer to both this page and this wiki's install page for your distro. @@ -25,18 +29,18 @@ In macOS Disk Utility you need to create your Linux partition: Listed below are the currently available installer ISOs for download: -| Linux Distribution | Download ISO with T2 support | -| ------------------ | ---------------------------- | -| Arch Linux | | -| blendOS | | -| EndeavourOS | | -| Fedora | | -| Fedora | | -| Gentoo | Please refer to this [page](https://wiki.t2linux.org/distributions/gentoo/installation/) | -| Manjaro | | -| NixOS | | -| Ubuntu & Kubuntu | | -| Linux Mint | | +| Linux Distribution | Download ISO with T2 support | +| ---------------------------------- | ---------------------------- | +| Arch Linux :simple-archlinux: | | +| blendOS | | +| EndeavourOS :simple-endeavouros: | | +| Fedora :simple-fedora: | | +| Fedora :simple-fedora: | | +| Gentoo :material-gentoo: | Please refer to this [page](https://wiki.t2linux.org/distributions/gentoo/installation/) | +| Manjaro :simple-manjaro: | | +| NixOS :simple-nixos: | | +| Ubuntu & Kubuntu :material-ubuntu: | | +| Linux Mint :simple-linuxmint: | | #### Other distributions diff --git a/docs/guides/refind.md b/docs/guides/refind.md index c0726310..017bc06e 100644 --- a/docs/guides/refind.md +++ b/docs/guides/refind.md @@ -1,3 +1,7 @@ +--- +icon: octicons/terminal-16 +--- + # Introduction This guide shall help you install the rEFInd Boot Manager in your T2 Mac in the safest possible way. Though there are various options to get rEFInd on your Mac, it is recommended to follow the instructions given below unless you know what you are doing. diff --git a/docs/guides/startup-manager.md b/docs/guides/startup-manager.md index 0321320e..eb367a37 100644 --- a/docs/guides/startup-manager.md +++ b/docs/guides/startup-manager.md @@ -1,3 +1,7 @@ +--- +icon: material/harddisk +--- + # Introduction This guide shall help you perform 2 tasks. Firstly you shall be able to set the correct label for your Linux startup disk on Mac startup manager and replace the `EFI Boot` label, and give it an icon. Secondly you shall be able to make Linux startup disk as the default startup disk in case you wish to do so. diff --git a/docs/guides/uninstall.md b/docs/guides/uninstall.md index f326d698..43218dde 100644 --- a/docs/guides/uninstall.md +++ b/docs/guides/uninstall.md @@ -1,3 +1,7 @@ +--- +icon: octicons/trash-16 +--- + # Introduction This page explains how to remove Linux from your Mac. It shouldn't matter what distro you are using. diff --git a/docs/guides/wifi-bluetooth.md b/docs/guides/wifi-bluetooth.md index dce83361..80466eba 100644 --- a/docs/guides/wifi-bluetooth.md +++ b/docs/guides/wifi-bluetooth.md @@ -1,23 +1,16 @@ +--- +icon: material/wifi-strength-3 +--- + # Introduction This page is a step by step guide to get Wi-Fi and Bluetooth working on T2 Macs. This guide is also applicable to **iMac19,1** and **iMac19,2**, which are T1 Intel Macs. This guide is NOT applicable for rest T1 and older Intel Macs. -!!! Warning "Arch/EndeavourOS" +!!! Warning "Arch :simple-archlinux:/EndeavourOS :simple-endeavouros:" If you're running Arch or EndeavourOS and have `apple-bcm-firmware` installed, you do not need to follow this guide. -## Ensure Kernel Supports OTP Firmware Selection - -Check if this command outputs any lines: `modinfo brcmfmac | grep 4387` If it doesn't output anything, then upgrade your kernel. - -Refer to the "Updating Kernel" section on your distro's FAQ for instructions if you need to update your kernel: - -- [Arch](https://wiki.t2linux.org/distributions/arch/faq/#updating-kernel) -- [Fedora](https://github.com/t2linux/fedora?tab=readme-ov-file#instalation) -- [Manjaro](https://wiki.t2linux.org/distributions/manjaro/faq/#updating-kernel) -- [Ubuntu](https://github.com/t2linux/T2-Debian-and-Ubuntu-Kernel?tab=readme-ov-file#using-the-apt-repo) - ## Setting up We now use a script which can help you set up Wi-Fi and Bluetooth. Click [here](../tools/firmware.sh) to download the script. @@ -31,11 +24,11 @@ There are 4 methods supported by this script to get firmware for Linux, named as !!! Tip "macOS Removed after installing Linux" In case you have removed macOS after installing Linux, and need the firmware, **Method 4** is the only option for you. -### On macOS +### On macOS :fontawesome-brands-apple: Run the script on the macOS terminal. After you run the script, it will ask you to choose between 3 methods to move firmware to Linux: -=== "Method 1" +=== ":fontawesome-brands-apple: Method 1" **Method 1: Run the same script on Linux** If you choose this method, unlike **Method 2** and **Method 3**, you need not have any specific dependency already installed on your Mac. So if you don't want to install any additional software on macOS, this method is the only option for you. @@ -44,7 +37,7 @@ Run the script on the macOS terminal. After you run the script, it will ask you To retrieve the firmware from **EFI** partition in Linux, you shall have to run the same script on Linux. You have 2 options do so, described in detail in [On Linux](#on-linux) section. -=== "Method 2" +=== ":fontawesome-brands-apple: Method 2" **Method 2: Create a tarball of the firmware and extract it to Linux** If you choose this method, the script will install the following dependencies, if missing, on macOS: @@ -57,7 +50,7 @@ Run the script on the macOS terminal. After you run the script, it will ask you Now you have to extract the firmware in the tarball to Linux. The procedure has been described in detail in [On Linux](#on-linux) section. -=== "Method 3" +=== ":fontawesome-brands-apple: Method 3" **Method 3: Create a Linux specific package which can be installed using a package manager** If you choose this method, the script will install the following dependencies, if missing, on macOS: @@ -74,16 +67,16 @@ Run the script on the macOS terminal. After you run the script, it will ask you Now you have to install the package in Linux using your package manager. The procedure has been described in detail in [On Linux](#on-linux) section. -=== "Method 4" +=== ":fontawesome-brands-apple: Method 4" **Method 4: Download a macOS Recovery Image from Apple and extract the firmware from there** This method does not have any steps to be followed on macOS. See [On Linux](#on-linux) section. -### On Linux +### On Linux :fontawesome-brands-linux: Once you have run the script on macOS, depending on the method you chose, the steps to be followed on Linux are described below: -=== "Method 1" +=== ":fontawesome-brands-linux: Method 1" **Method 1: Run the same script on Linux** Now we need to retrieve the firmware from the **EFI** partition. You further have 2 options to do so: @@ -117,7 +110,7 @@ Once you have run the script on macOS, depending on the method you chose, the st This option shall be useful if you are unable to copy the script to Linux. -=== "Method 2" +=== ":fontawesome-brands-linux: Method 2" **Method 2: Create a tarball of the firmware and extract it to Linux** Now we shall extract the tarball of the firmware which was saved in the **Downloads** folder in macOS as `firmware.tar`. In order to do so, copy `firmware.tar` to Linux and extract the firmware to `/lib/firmware/brcm` by running: @@ -140,7 +133,7 @@ Once you have run the script on macOS, depending on the method you chose, the st sudo modprobe hci_bcm4377 ``` -=== "Method 3" +=== ":fontawesome-brands-linux: Method 3" **Method 3: Create a Linux specific package which can be installed using a package manager** Now we have to install the firmware package which was saved in the **Downloads** folder in macOS. Copy the package to Linux and follow the instructions below, depending on whether you use `apt`, `dnf` or `rpm`: @@ -187,7 +180,7 @@ Once you have run the script on macOS, depending on the method you chose, the st Replace `/path/to/firmware_package.pkg.tar.zst` with the actual path of the package. For example, if `apple-firmware-14.5-1-any.pkg.tar.zst` was created in macOS and has been copied to the Downloads folder in Linux, command to be run would be `sudo pacman -U $HOME/Downloads/apple-firmware-14.5-1-any.pkg.tar.zst` -=== "Method 4" +=== ":fontawesome-brands-linux: Method 4" **Method 4: Download a macOS Recovery Image from Apple and extract the firmware from there** !!! warning "Internet connection is required for **Method 4**" diff --git a/docs/guides/windows.md b/docs/guides/windows.md index 3de67393..7474516f 100644 --- a/docs/guides/windows.md +++ b/docs/guides/windows.md @@ -1,3 +1,7 @@ +--- +icon: simple/windows10 +--- + # Introduction This page is a guide on getting Windows and Linux both installed. Secure Boot Must be disabled from macOS recovery. If you want to be able to choose from macOS, Windows, or Linux in the Startup Manager (the menu you get by holding ⌥ key), goto 'Using seperate EFI partitions'. If you just want to select between Linux and Windows in the GRUB bootloader, goto 'Using the same EFI partition'. @@ -6,7 +10,7 @@ The simplist way to triple boot is to install Windows first, and install linux o # Using the same EFI partition -## If Windows is installed first +## If Windows is installed first :fontawesome-brands-windows: 1. Install linux normally, with a patched kernel and dkms modules (this is probably done for you if you are using an installer specific to t2 macs). 2. Put your bootloader on `/dev/nvme0n1p1`, which should be set to mount at `/boot/efi`. Once it installs the bootloader, the Windows entry in startup manager will boot linux. @@ -26,7 +30,7 @@ The simplist way to triple boot is to install Windows first, and install linux o 5. You should now be able to boot either Windows or Linux from the GRUB bootloader. -## If Linux is installed first +## If Linux is installed first :fontawesome-brands-linux: 1. Make sure that your linux partitions are not labled as `Microsoft Basic Data`, if they are, Bootcamp Assistant will think Windows is already installed. To fix this, go to Linux and do `sudo cfdisk /dev/nvme0n1` and change the type of your linux partitions to `Linux Filesystem`. 2. Install Windows normaly with Bootcamp. Windows will replace your Linux boot option. @@ -55,16 +59,16 @@ It may be possible to skip steps 5-8 by doing the following command in macOS: `s # Using seperate EFI partitions -## Installing Linux (With or without Windows already installed) +## Installing Linux (With or without Windows already installed) :fontawesome-brands-linux: -### In macOS +### In macOS :fontawesome-brands-apple: Create partitions with Disk Utility: - Make a 200Mb FAT32 partition, call it something like `EFI2`. Make sure you do not use `EFI` as the label. - Create your main partition(s) for Linux, make them macOS Extended/HFS+ to stop Bootcamp Installer from thinking they are Windows. These will be erased and reformatted by your installer. -### In your distro's installer +### In your distro's installer :material-arch::material-ubuntu::material-fedora::material-nix: If you are using an interactive installer: @@ -91,7 +95,7 @@ If you are doing it manually: 4. Within your chroot, do `grub-install --target=x86_64-efi --efi-directory=/boot/efi --bootloader-id=GRUB --no-nvram --removable` 5. There will now be an `EFI Boot` option in the macOS Startup Manager (The menu you get by holding option at boot) which will boot Linux. -## Installing Windows when Linux is installed +## Installing Windows when Linux is installed :fontawesome-brands-windows: 1. If there are partitions labeled as `Microsoft Basic Data`, Bootcamp Assistant will think you have Windows installed. Use `sudo cfdisk /dev/nvme0n1` to change your Linux partitions to `Linux Filesystem` or whatever is appropriate. 2. If your second EFI partition is labeled as `EFI System`, you'll need to use `cfdisk` again to make it not that, as the Windows installer fails if there are two. diff --git a/mkdocs.yml b/mkdocs.yml index 71cedb59..87f01ca0 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -14,6 +14,8 @@ theme: features: - tabs - content.tabs.link + - navigation.tabs + - navigation.sections favicon: assets/images/icon.png docs_dir: docs @@ -35,6 +37,10 @@ markdown_extensions: permalink: true - admonition - pymdownx.details + - attr_list + - pymdownx.emoji: + emoji_index: !!python/name:material.extensions.emoji.twemoji + emoji_generator: !!python/name:material.extensions.emoji.to_svg plugins: - redirects: