adwaita.docc/Tutorial/GNOME/SetUpGNOME.tutorial

55 lines
2.6 KiB
Plaintext

@Tutorial {
@Intro(title: "Set up GNOME") {
While you can develop Adwaita apps on macOS and Windows, it is recommended to use Linux.
Learn how to install GNOME on your device.
}
@Section(title: "Install GNOME on Apple silicon devices") {
@ContentAndMedia {
Follow this tutorial if you want to install GNOME on a recent Mac model. Note that you could also use a virtual machine instead.
}
@Steps {
@Step {
Install [Asahi Linux](https://asahilinux.org/) by running the following command in a macOS terminal: **`curl https://alx.sh | sh`**
Follow the instructions until you get to the OS selection.
@Image(source: "Asahi.svg", alt: "A laptop showing the Asahi logo.")
}
@Step {
Make sure to select the GNOME installation option.
Follow the instructions to complete the setup.
@Image(source: "SelectGNOME.png", alt: "Terminal showing the OS selection.")
}
@Step {
Configure GNOME. Use the settings app to change the display scaling, cursor speed, etc.
Make sure to have at least GNOME Software, Files, and a terminal emulator installed (this should be the case).
@Image(source: "GNOMEMacBook.png", alt: "GNOME desktop showing the Mac system information.")
}
}
}
@Section(title: "Install GNOME on other devices") {
@ContentAndMedia {
If you own an older Mac or another device, you have more choice.
}
@Steps {
@Step {
Select a Linux distro [on the GNOME website](https://www.gnome.org/getting-gnome/). Follow the instructions on the distro's website.
Recommended distros providing a vanilla GNOME experience out of the box are [Vanilla OS](https://vanillaos.org/) and [Fedora Workstation](https://fedoraproject.org/en/workstation/download).
Ubuntu is a popular distro that isn't particularly recommended as it applies its theme on your GNOME apps, and [Flatpak](https://flatpak.org/) needs additional setup.
@Image(source: "VanillaOS.png", alt: "The Vanilla OS website.")
}
@Step {
Configure GNOME using the GNOME settings app.
Make sure to have GNOME Software, GNOME Files (Nautilus), and a terminal emulator (e.g. GNOME Console) installed.
@Image(source: "GNOMELaptop.png", alt: "GNOME on a laptop.")
}
}
}
}