From 54f317a2a2b5f3b3384a3852f11db655872c3d77 Mon Sep 17 00:00:00 2001 From: "Ankur Sinha (Ankur Sinha Gmail)" Date: Mon, 25 Jul 2022 18:38:20 +0100 Subject: [PATCH] feat(switching-desktop-envs): update and improve page Note, the `/etc/sysconfig/desktop` file bit remains unreviewed because I was unable to find any conclusive information on it. --- ...alling-additional-desktop-enviroments.adoc | 29 ++++++++++++------- ...itching-desktop-enviroments-using-cli.adoc | 29 ++++++++++--------- ...itching-desktop-enviroments-using-gui.adoc | 18 ++++++------ .../pages/switching-desktop-environments.adoc | 6 ++-- 4 files changed, 46 insertions(+), 36 deletions(-) diff --git a/modules/ROOT/pages/_partials/proc_installing-additional-desktop-enviroments.adoc b/modules/ROOT/pages/_partials/proc_installing-additional-desktop-enviroments.adoc index 77983d5..d68ec64 100644 --- a/modules/ROOT/pages/_partials/proc_installing-additional-desktop-enviroments.adoc +++ b/modules/ROOT/pages/_partials/proc_installing-additional-desktop-enviroments.adoc @@ -1,10 +1,8 @@ [[installing-desktop-environments]] = Installing additional desktop environments - -.Procedure - -List available desktop environments: +You can list available desktop environments using the default package manager, [code]`dnf`. +In a terminal use the [code]`dnf grouplist` command to list all available package groups: ---- $ dnf grouplist -v @@ -17,23 +15,34 @@ Available Environment Groups: KDE Plasma Workspaces (kde-desktop-environment) Xfce Desktop (xfce-desktop-environment) LXDE Desktop (lxde-desktop-environment) - Hawaii Desktop (hawaii-desktop-environment) LXQt Desktop (lxqt-desktop-environment) Cinnamon Desktop (cinnamon-desktop-environment) MATE Desktop (mate-desktop-environment) Sugar Desktop Environment (sugar-desktop-environment) + Deepin Desktop (deepin-desktop-environment) Development and Creative Workstation (developer-workstation-environment) Web Server (web-server-environment) Infrastructure Server (infrastructure-server-environment) Basic Desktop (basic-desktop-environment) -Installed Groups: - KDE (K Desktop Environment) (kde-desktop) -[output has been truncated] + i3 desktop (i3-desktop-environment) +Available Groups: + 3D Printing (3d-printing) + Administration Tools (admin-tools) + Audio Production (audio) +... ---- -Install the selected desktop environment using the `dnf install` command. Ensure to prefix with -the `@` sign, for example: +Install the required desktop environment using the `dnf install` command. +Ensure to prefix with the `@` sign, for example: + ---- # dnf install @kde-desktop-environment ---- + +You can also use the full name using the `groupinstall` command: + +---- +# dnf groupinstall "KDE Plasma Workspaces" +---- + diff --git a/modules/ROOT/pages/_partials/proc_switching-desktop-enviroments-using-cli.adoc b/modules/ROOT/pages/_partials/proc_switching-desktop-enviroments-using-cli.adoc index 7776ddc..79215bb 100644 --- a/modules/ROOT/pages/_partials/proc_switching-desktop-enviroments-using-cli.adoc +++ b/modules/ROOT/pages/_partials/proc_switching-desktop-enviroments-using-cli.adoc @@ -1,9 +1,7 @@ [[switching-desktop-environments-using-cli]] -= Switching desktop environments using CLI += Switching desktop environments using the command line interface (CLI) -.Before you start - -Install the desired desktop environment as described in <> +First, install the desired desktop environment as described in link:#installing-desktop-environments[Installing additional desktop environments]. Install the [package]`switchdesk` package: @@ -12,29 +10,32 @@ Install the [package]`switchdesk` package: ---- -.Procedure - Pass the selected desktop environment as the only argument to the [command]`switchdesk` command, for example: ---- # switchdesk kde ---- -.More information +See the `switchdesk(1)` man page for more information. -See the `switchdesk(1)` man page. +== Manually editing the system configuration -Alternatively, edit the [filename]`/etc/sysconfig/desktop` file as *root*. This file specifies the desktop for new users and the display manager to run when entering runlevel 5. +You can also change your default desktop environment using the [filename]`/etc/sysconfig/desktop` system configuration file. +If this file does not exists, please create it. +This file specifies the desktop for new users and the display manager to run when entering runlevel 5. + +Please create/edit it using your preferred text editor. +Note that you will need administrator (root) privileges to create or edit this file. Correct values are: `DESKTOP="__"`, where `__` is one of the following: -1. `GNOME` — Selects the GNOME desktop environment. -2. `KDE` — Selects the KDE desktop environment. +1. `GNOME` - Selects the GNOME desktop environment. +2. `KDE` - Selects the KDE desktop environment. `DISPLAYMANAGER="__"`, where `__` is one of the following: -1. `GNOME` — Selects the GNOME Display Manager. -2. `KDE` — Selects the KDE Display Manager. -3. `XDM` — Selects the X Display Manager. +1. `GNOME` - Selects the GNOME Display Manager. +2. `KDE` - Selects the KDE Display Manager. +3. `XDM` - Selects the X Display Manager. diff --git a/modules/ROOT/pages/_partials/proc_switching-desktop-enviroments-using-gui.adoc b/modules/ROOT/pages/_partials/proc_switching-desktop-enviroments-using-gui.adoc index 64ecc86..80bd0d3 100644 --- a/modules/ROOT/pages/_partials/proc_switching-desktop-enviroments-using-gui.adoc +++ b/modules/ROOT/pages/_partials/proc_switching-desktop-enviroments-using-gui.adoc @@ -1,13 +1,10 @@ [[switching-desktop-environments-using-gui]] -= Switching desktop environments using GUI += Switching desktop environments using a graphical user interface (GUI) -.Before you start +First, install the desired desktop environment as described in link:#installing-desktop-environments[Installing additional desktop environments]. -Install the desired desktop environment as described in link:#installing-desktop-environments[Installing additional desktop environments]. - -.Procedure - -To login with a different desktop for a single session: +You can login to a different desktop for a single session using the login manager. +For example, for the Gnome Display Manager (GDM) that is used by default on the Fedora Linux Workstation: . On the login screen, select a user from the list. @@ -17,9 +14,12 @@ To login with a different desktop for a single session: image::switching-desktop-environments-login.png[Login Screen] -.More information +== Using switchdesk -. Alternatively, install the [package]`switchdesk` and [package]`switchdesk-gui` packages: +You also change your desktop environment using the [package]`switchdesk` tool. +It also allows you to change default desktop environment for individual users, and for all users. + +. Install the [package]`switchdesk` and [package]`switchdesk-gui` packages: + ---- # dnf install switchdesk switchdesk-gui diff --git a/modules/ROOT/pages/switching-desktop-environments.adoc b/modules/ROOT/pages/switching-desktop-environments.adoc index 29be89a..d9bf238 100644 --- a/modules/ROOT/pages/switching-desktop-environments.adoc +++ b/modules/ROOT/pages/switching-desktop-environments.adoc @@ -5,12 +5,12 @@ ifdef::context[:parent-context: {context}] [[switching-desktop-environments]] = Switching desktop environments -include::{partialsdir}/unreviewed-message.adoc[] +Different Fedora Linux variants (Spins/Labs) have different default environments. +For example, the Fedora workstation uses GNOME as its default desktop environment, while the KDE spin will use KDE. -Fedora's default desktop environment is GNOME 3 in the Workstation spin, but it is very easy to try any of the many other desktop environments that are available without affecting your current desktop environment. +Irrespective of what installation media you used to install Fedora Linux, you can easily try and switch to any of the many other desktop environments that are available without affecting your current desktop environment. include::{partialsdir}/proc_installing-additional-desktop-enviroments.adoc[leveloffset=+1] - include::{partialsdir}/proc_switching-desktop-enviroments-using-gui.adoc[leveloffset=+1] include::{partialsdir}/proc_switching-desktop-enviroments-using-cli.adoc[leveloffset=+1]