Switching desktop environments

en-US/modules/proc_installing-additional-desktop-enviroments.adoc

@@ -0,0 +1,42 @@
+[[installing-desktop-environments]]
+= Installing additional desktop environments
+
+.Before you start
+
+.Procedure
+
+List available desktop environments:
+
+----
+$ dnf grouplist -v
+Available Environment Groups:
+   Fedora Custom Operating System (custom-environment)
+   Minimal Install (minimal-environment)
+   Fedora Server Edition (server-product-environment)
+   Fedora Workstation (workstation-product-environment)
+   Fedora Cloud Server (cloud-server-environment)
+   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)
+   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]
+----
+
+Install the selected desktop environment using the dnf install command. Ensure to prefix with
+the `@` sign, for example:
+
+----
+# dnf install @kde-desktop-environment
+----
+
+.More information

en-US/modules/proc_switching-desktop-enviroments-using-cli.adoc

@@ -0,0 +1,37 @@
+[[switching-desktop-environments-using-cli]]
+= Switching desktop environments using CLI
+
+.Before you start
+
+Install the desired desktop environment as described in <<proc_installing-additional-desktop-enviroments.adoc#installing-desktop-environments,Installing additional desktop environments>>
+
+Install the [package]`switchdesk` package:
+----
+# dnf install switchdesk
+----
+
+.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.
+
+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.
+
+Correct values are:
+
+`DESKTOP=`"<value>", where "<value>" is one of the following:
+
+1. `GNOME` — Selects the GNOME desktop environment.
+2. `KDE` — Selects the KDE desktop environment.
+
+`DISPLAYMANAGER=`"<value>", where "<value>" 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.

en-US/modules/proc_switching-desktop-enviroments-using-gui.adoc

@@ -0,0 +1,30 @@
+[[switching-desktop-environments-using-gui]]
+= Switching desktop environments using GUI
+
+.Before you start
+
+Install the desired desktop environment as described in <<proc_installing-additional-desktop-enviroments.adoc#installing-desktop-environments,Installing additional desktop environments>>
+
+.Procedure
+
+To login with a different desktop for a single session:
+
+1. On the login screen, select a user from the list.
+
+2. Click on the Preferences icon right below the password field. A window appears with a list of several different desktop environments.
+
+3. Choose one, and enter password as usual.
+
+image::switching-desktop-environments-login.png[Login Screen]
+
+.More information
+
+1. Alternatively, install the [package]`switchdesk` and [package]`switchdesk-gui` packages:
+----
+# dnf install switchdesk switchdesk-gui
+----
+2. Run the `Desktop Switching Tool` application.
+
+3. Select the default desktop from the list of available desktop environments, and confirm.
+
+image::switching-desktop-environments-switchdesk.png[Desktop Switching Tool]

en-US/switch-desktop-env.adoc

@@ -1,87 +0,0 @@
-= Switching Desktop Environments
-
-'''
-
-[IMPORTANT]
-======
-
-This page was automatically converted from https://fedoraproject.org/wiki/Switching_Desktop_Environments
-
-It is probably
-
-* Badly formatted
-* Missing graphics and tables that do not convert well from mediawiki
-* Out-of-date
-* In need of other love
-
-Please fix it, remove this notice, and then add to `_topic_map.yml`
-
-Pull requests accepted at https://pagure.io/fedora-docs/quick-docs
-
-Once that is live, go to the original wiki page and add an `{{old}}`
-tag, followed by a note like
-
-....
-{{admon/note|This page has a new home!|
-This wiki page is no longer maintained. Please find the up-to-date
-version at: https://docs.fedoraproject.org/whatever-the-url
-}}
-....
-
-======
-
-'''
-
-
-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.
-
-The desktop environment such as KDE, XFCE or MATE can be installed using
-GNOME Software or with dnf directly from the terminal
-
-[[installation]]
-Installation
-~~~~~~~~~~~~
-
-To use dnf, first find the full environment name using
-
-....
-dnf grouplist -v
-....
-
-`Available environment groups:` +
-`  Fedora Server (server-product-environment)` +
-`  Fedora Workstation (workstation-product-environment)` +
-`  Fedora Cloud Server (cloud-server-environment)` +
-`  KDE Plasma Workspaces (kde-desktop-environment)` +
-`  Xfce Desktop (xfce-desktop-environment)` +
-`  LXDE Desktop (lxde-desktop-environment)` +
-`  Cinnamon Desktop (cinnamon-desktop-environment)` +
-`  LXQt Desktop (lxqt-desktop-environment)` +
-`  MATE Desktop (mate-desktop-environment)` +
-`  Sugar Desktop Environment (sugar-desktop-environment)` +
-`  Development and Creative Workstation (developer-workstation-environment)` +
-`  Web Server (web-server-environment)` +
-`  Infrastructure Server (infrastructure-server-environment)` +
-`  Basic Desktop (basic-desktop-environment)` +
-`  Minimal Install (minimal-environment)`
-
-For actual installation, type the following, and be sure to prefix with
-the @ sign
-
-....
-sudo dnf install @kde-desktop-environment
-....
-
-[[switching-desktop-session]]
-Switching Desktop Session
-~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Once installed, you can switch to the new desktop simply by logging out
-and switching the session to the new desktop environment on the login
-screen. The exact method differs based on the display manager in use.
-'''
-
-See a typo, something missing or out of date, or anything else which can be
-improved? Edit this document at https://pagure.io/fedora-docs/quick-docs.

en-US/switching-desktop-environments.adoc

@@ -0,0 +1,16 @@
+:md: ./modules
+:imagesdir: ./images
+
+[[switching-desktop-environments]]
+= Switching desktop environments
+
+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.
+
+include::{md}/proc_installing-additional-desktop-enviroments.adoc[leveloffset=+1]
+
+include::{md}/proc_switching-desktop-enviroments-using-gui.adoc[leveloffset=+1]
+
+include::{md}/proc_switching-desktop-enviroments-using-cli.adoc[leveloffset=+1]
+
+[[switching-desktop-environments-additional-resources]]
+== Additional resources