Skip to content

Commit

Permalink
Editing dconf.md (#2244)
Browse files Browse the repository at this point in the history
* replace conjunctions with words
* some sentence simplification
* replace most passive voice phrasing with active voice
* change all instances of Gnome for GNOME as preferred
* replace the HTML keyboard commands (<kbd>) with the markdown equivalent
* other minor changes
  • Loading branch information
sspencerwire authored Aug 9, 2024
1 parent 246bac0 commit fa8646f
Showing 1 changed file with 30 additions and 29 deletions.
59 changes: 30 additions & 29 deletions docs/desktop/gnome/dconf.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,59 +6,60 @@ contributors: Steven Spencer

## Introduction

Gnome takes a very streamlined approach to its user interface and its features. This isn't a bad thing, as it's easy enough to learn, and the default Gnome experience lets you get right to work doing... well, your work.
GNOME takes a very streamlined approach to its user interface and its features. This is not a bad thing, as it is easy enough to learn, and the default GNOME experience lets you get right to work doing your work.

However, this approach also means that it's not as easily configurable as some people would like. Sure, if you can't find what you need in the Settings panel, you can install Gnome Tweaks to expand your options. You can even install Gnome extensions to get new features and options.
However, this approach also means that it is not as easily configurable as some people would like. Sure, if you can not find what you need in the Settings panel, you can install GNOME Tweaks to expand your options. You can even install GNOME extensions to get new features and options.

But what if you want to see all the little settings, features, and configurations that the Gnome developers have, let's face it, hidden from you? Sure, you can look up your current problem online, and type in a command to change an obscure variable... or you could install `dconf Editor`.
But what if you want to see all the little settings, features, and configurations that the GNOME developers have hidden from you? Sure, you can look up your current problem online, and type in a command to change an obscure variable, or you could install `dconf Editor`.

`dconf Editor` is essentially a Gnome Settings app that has *everything*. In fact, it may remind you a little bit of the Windows Registry, and it *is* similar. However, it's a lot more readable, and it really only covers Gnome functionality, and some of the software built for Gnome.
`dconf Editor` is essentially a GNOME Settings app that has *everything*. In fact, it might remind you a little bit of the Windows Registry, and it *is* similar. However, it is more readable, it only covers GNOME functionality, and some of the software built for GNOME.

Oh, and you can also edit settings for Gnome extensions, so that's cool.
Oh, and you can also edit settings for GNOME extensions, so that is cool.

!!! Warning

The comparison to the Windows Registry was quite intentional. Like bad Registry keys, *some* of the Gnome Shell settings can actually break your Gnome installation, or at least cause issues. You may need to restore the old settings via the command line.
The comparison to the Windows Registry was quite intentional. Like bad Registry keys, *some* of the GNOME Shell settings can actually break your GNOME installation, or at least cause issues. You may need to restore the old settings via the command line.

If you're not sure what a particular setting does, research it first. Changing app settings is fine, though, and much easier to reverse.
If you are not sure what a particular setting does, research it first. Changing app settings is fine, though, and much easier to reverse.

## Assumptions
For this guide, you're going to need:

* Rocky Linux with Gnome installed.
* The authority to install software on your system (sudo privilege).
For this guide, you are going to need:

And that's it.
* Rocky Linux with GNOME installed.
* The authority to install software on your system (`sudo` privileges).

And that is it.

## Installing `dconf Editor`

Oh that's easy. Go to the Software app, search for Dconf Editor, and hit this install button. It's available in the default Rocky Linux repository, so there's no special configuration needed.
Go to the "Software" app, search for "Dconf Editor", and hit this install button. It is available in the default Rocky Linux repository.

![the Gnome software center, featuring dconf Editor](images/dconf-01.png)
![the GNOME software center, featuring dconf Editor](images/dconf-01.png)

For those of you who want to do it the command line way, that's:
For those of you who want to do it the command line way, that is:

```bash
sudo dnf install dconf-editor
```

## Using `dconf Editor`

Once you open up the app which you'll see three important bits of the UI. Up at the top is the path. Yes, your Gnome settings are all organized in a path/folder structure.
Once you open up the app, you will see three important bits of the user interface. Up at the top is the path. Yes, your GNOME settings are all organized in a path/folder structure.

At the top-right, you'll see a button with a little star on it. That's the favorites button, so you can save your place in the app and come back to it later quickly and easily. Down below is the main panel where you select your settings subfolders, and actually change settings as you see fit.
At the top right, you will see a button with a little star on it. That is the favorites button, so you can save your place in the app and come back to it later quickly and easily. Down below is the main panel where you select your settings subfolders, and actually change settings as you see fit.

![a screenshot of the dconf Editor window with arrows pointing at the aforementioned elements](images/dconf-02.png)

Left of the favorite button, you'll see the search button, which does exactly what you'd expect.
Left of the favorite button, you will see the search button, which does exactly what you would expect.

Now let's say you want to change some settings in the file manager. For example, I love the sidebar. I find it very handy. But maybe you feel differently, and want to change things up. So, for the purposes of this guide, it has got to go.
Now, what if you want to change some settings in the file manager? For example, I love the sidebar. I find it very handy. But maybe you feel differently, and want to change things up. So, for the purposes of this guide, it has got to go.

![a screenshot of the Nautilus file manager, with a threatening red X over the doomed sidebar](images/dconf-03.png)

*Good night, sweet prince.*

Go to `/org/gnome/nautilus/window-state`, and you'll see an option called `start-with-sidebar`. Hit the toggle, and click the "Reload" button when that shows up, like so:
Go to `/org/gnome/nautilus/window-state`, and you will see an option called `start-with-sidebar`. Hit the toggle, and click the "Reload" button when that shows up like this:

![a screenshot of dconf Editor, showing the toggle and reload button in question](images/dconf-04.png)

Expand All @@ -68,26 +69,26 @@ If everything has gone right, the next file browser window you open should look

If that feels wrong to you -- and this author contends that it should -- just switch it right back, hit Reload again, and open a new file browser window.

Lastly, you can also click directly on any setting in the `dconf Editor` window to see more information (and sometimes more options). For example, here's what the `initial-size` settings screen for Gnome's file manager looks like.
Lastly, you can also click directly on any setting in the `dconf Editor` window to see more information (and sometimes more options). For example, here is what the `initial-size` settings screen for the GNOME file manager looks like.

![a screenshot of dconf Editor showsing the initial-size settings for the file manager](images/dconf-06.png)
![a screenshot of dconf Editor showing the initial-size settings for the file manager](images/dconf-06.png)

## Troubleshooting

If you're making changes to your settings in `dconf Editor` and you're not seeing anything change, try one of the following fixes:
If you are making changes to your settings in `dconf Editor` and you are not seeing anything change, try one of the following fixes:

1. Restart the app to which you are making the changes.
2. Log out and log back in, or reboot for some changes to Gnome Shell.
3. Give up because that option just isn't actually functional anymore.
2. Log out and log back in, or reboot for some changes to GNOME Shell.
3. Give up because that option just is not functional anymore.

On that last point: Yes, the Gnome developers will sometimes just take away your ability to actually change a setting, even with `dconf Editor`.
On that last point: Yes, the GNOME developers will sometimes just take away your ability to actually change a setting, even with `dconf Editor`.

For example, I tried making changes to the window switcher settings (the list of open windows that shows up when you press <kbd>Alt</kbd>+<kbd>Tab</kbd>), and got nowhere. No matter what I tried, `dconf Editor` seems to have no effect on some of its functions.
For example, I tried making changes to the window switcher settings (the list of open windows that shows up when you press ++alt+tab++), and got nowhere. No matter what I tried, `dconf Editor` seems to have no effect on some of its functions.

Now that could be a bug, but it wouldn't be the first time a setting shown in `dconf Editor` was essentially stealth-disabled. If you run into that problem, search the Gnome Extensions site to see if there's an extension that adds the option you want back into Gnome.
Now that could be a bug, but it would not be the first time a setting shown in `dconf Editor` was essentially stealth-disabled. If you run into that problem, search the GNOME Extensions site to see if there is an extension that adds the option you want back into GNOME.

## Conclusion

And that's all you need to know to get started. Just remember to keep track of all your changes, don't go changing settings without knowing exactly what they do, and have fun exploring the options that are (mostly) available to you.
That is all you need to know to get started. Just remember to keep track of all your changes, do not change settings without knowing exactly what they do, and have fun exploring the options that are (mostly) available to you.

Have fun!
Have fun!

0 comments on commit fa8646f

Please sign in to comment.