diff --git a/en-US/images/switching-desktop-environments-login.png b/en-US/images/switching-desktop-environments-login.png new file mode 100644 index 0000000..5c39f61 Binary files /dev/null and b/en-US/images/switching-desktop-environments-login.png differ diff --git a/en-US/images/switching-desktop-environments-switchdesk.png b/en-US/images/switching-desktop-environments-switchdesk.png new file mode 100644 index 0000000..713adeb Binary files /dev/null and b/en-US/images/switching-desktop-environments-switchdesk.png differ diff --git a/en-US/modules/proc_installing-additional-desktop-enviroments.adoc b/en-US/modules/proc_installing-additional-desktop-enviroments.adoc new file mode 100644 index 0000000..5a213f3 --- /dev/null +++ b/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 diff --git a/en-US/modules/proc_switching-desktop-enviroments-using-cli.adoc b/en-US/modules/proc_switching-desktop-enviroments-using-cli.adoc new file mode 100644 index 0000000..be08ae3 --- /dev/null +++ b/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 <> + +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=`"", where "" is one of the following: + +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. diff --git a/en-US/modules/proc_switching-desktop-enviroments-using-gui.adoc b/en-US/modules/proc_switching-desktop-enviroments-using-gui.adoc new file mode 100644 index 0000000..35bc57c --- /dev/null +++ b/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 <> + +.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] diff --git a/en-US/switch-desktop-env.adoc b/en-US/switch-desktop-env.adoc deleted file mode 100644 index a6dd8a6..0000000 --- a/en-US/switch-desktop-env.adoc +++ /dev/null @@ -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. diff --git a/en-US/switching-desktop-environments.adoc b/en-US/switching-desktop-environments.adoc new file mode 100644 index 0000000..7278d4d --- /dev/null +++ b/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