Skip to content

Commit

Permalink
Light editing gnome extensions (#2142)
Browse files Browse the repository at this point in the history
* light editing `gnome-extensions.md`
* change quote to block quote
* fix "no raw URL's" issue
* fix some passive voice issues
* Sentence style capitalization throughout

* missed one passive voice statement not in block quotes
  • Loading branch information
sspencerwire authored Jun 28, 2024
1 parent 4a0011a commit 209046d
Showing 1 changed file with 16 additions and 18 deletions.
34 changes: 16 additions & 18 deletions docs/desktop/gnome/gnome-extensions.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
title: GNOME Shell Extensions
author: Joseph Brinkman
contributors: Steven Spencer
tested with: 9.4
tags:
- desktop
Expand All @@ -11,11 +12,9 @@ tags:

From the [GNOME website](https://extensions.gnome.org/about/){:target="_blank"}:

"GNOME Shell provides core user interface functions for GNOME, like switching to windows and launching applications. User interface elements provided by GNOME Shell include the Panel at the top of the screen, the Activities Overview, and Message Tray at the bottom of the screen."

GNOME Shell extensions are small pieces of code written by third party developers that modify the way GNOME works. (If you are familiar with Chrome Extensions or Firefox Addons, GNOME Shell extensions are similar to them.) You can find and install GNOME Shell extensions using this website.

Since extensions are created outside of the normal GNOME design and development process, they are supported by their authors, rather than by the GNOME community. Some features first implemented as extensions might find their way into future versions of GNOME."
>GNOME Shell provides core user interface functions for GNOME, like switching to windows and launching applications. User interface elements provided by GNOME Shell include the Panel at the top of the screen, the Activities Overview, and Message Tray at the bottom of the screen."
>GNOME Shell extensions are small pieces of code written by third party developers that modify the way GNOME works. (If you are familiar with Chrome Extensions or Firefox Addons, GNOME Shell extensions are similar to them.) You can find and install GNOME Shell extensions using this website.
>Creation of extensions are created outside of the normal GNOME design and development process, they are supported by their authors, rather than by the GNOME community. Some features first implemented as extensions might find their way into future versions of GNOME.
## Assumptions

Expand All @@ -26,51 +25,50 @@ Since extensions are created outside of the normal GNOME design and development
GNOME Extensions is available from the "appstream" repository, requiring no additional repository configuration. Install with:

```bash
sudo dnf install gnome-extensions
sudo dnf install gnome-extensions
```

Installation includes all needed dependencies.

## Install Browser Integration
## Install browser integration

Gnome Extensions has a software library available through their website gnome.extensions.org where you can install extensions right off their website. To achieve this a connection needs to be facilitated between your browser and gnome-extensions.
Gnome Extensions has a software library available through their website gnome.extensions.org where you can install extensions right off their website. To achieve this, your browser and gnome-extensions needs to facilitate a connection.

```bash
sudo dnf install chrome-gnome-shell
```

[installation guide](https://gnome.pages.gitlab.gnome.org/gnome-browser-integration/pages/installation-guide.html){target="_blank"}

## Determining Gnome Shell Version
## Determining GNOME shell version

The browser extension used to faciliate extensions installations from extensions.gnome.org should automatically detect the version of GNOME shell your system is currently running.
The browser extension used to facilitate extensions installations from extensions.gnome.org should automatically detect the version of GNOME shell your system is currently running.

If you wish to perform a local install you will need to download the extension with the correct GNOME shell version.

```bash
gnome-shell --version
```

## Installing an Extension
## Installing an extension

For this example we will install the popular dash to dock extension.
For this example we will install the popular dash to dock extension.

1. Go to [dash to dock extension webpage](https://extensions.gnome.org/extension/307/dash-to-dock/){target="_blank"}
2. Toggle extension from "off" to "on"
![Toggle extension](images/gnome_extensions_images/gnome-shell-extensions-toggle-btn.webp)
3. When prompted to install the extension, click "yes"

## Managing Installed Extensions
## Managing installed extensions

GNOME extensions can not only be installed on gnome.extensions.org but also managed.
GNOME extensions are installed and managed on gnome.extensions.org.

To manage your GNOME extensions, first go to https://extensions.gnome.org/local/
To manage your GNOME extensions, first go to <https://extensions.gnome.org/local/>

![Manage GNOME extensions](images/gnome_extensions_images/gnome-shell-installed-extensions.webp)

On this page you will find a list of installed extensions. You can toggle each of these on or off. You can also configure the shell settings by using the toggle button on either of the two available menu options "Disable all extensions" "Disable version validation".

On this page you will find a list of installed extensions. You can toggle each of these on or off. You can also configure the shell settings by using the toggle button on either of the two available menu options "Disable all extensions" "Disable version validation".

## Conclusion

GNOME Extensions is a good tool for adding additional functionality and customizing your GNOME desktop environment.
GNOME Extensions is a good tool for adding additional functionality and customizing your GNOME desktop environment.

0 comments on commit 209046d

Please sign in to comment.