View Code? Open in Web Editor
NEW
This project forked from stuarthayhurst/alphabetical-grid-extension
Restore the alphabetical ordering of the app grid, removed in GNOME 3.38
Home Page: https://extensions.gnome.org/extension/4269/alphabetical-app-grid/
License: GNU General Public License v3.0
JavaScript 80.69%
Shell 9.10%
Makefile 10.22%
alphabetical-grid-extension's Introduction
Alphabetical App Grid GNOME Extension
![Donate](https://camo.githubusercontent.com/0283ea90498d8ea623c07906a5e07e9e6c2a5eaa6911d52033687c60cfa8d22f/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f446f6e6174652d50617950616c2d677265656e2e737667)
- Restore the alphabetical ordering of the app grid, removed in GNOME 3.38
- Supports GNOME 3.38+, earlier versions are untested, and unnecessary
- Get the extension from here
- This project is licensed under GPL 3.0
- Any donations are greatly appreciated :)
Install the extension from releases:
- Extract the zip to
~/.local/share/gnome-shell/extensions/AlphabeticalAppGrid@stuarthayhurst/
- Reload GNOME: ALT+F2, r, ENTER
- Enable the extension:
gnome-extensions enable AlphabeticalAppGrid@stuarthayhurst
Install the extension from source:
- Make sure the install dependencies are installed
make build
make install
- Reload GNOME: ALT+F2, r, ENTER
- Enable the extension:
gnome-extensions enable AlphabeticalAppGrid@stuarthayhurst
-
Common targets: Regular build system targets to build, install and uninstall
make build
: Compiles GSettings schemas and creates extension zip
make check
: Runs checks on built extension zip
make install
: Installs the extension
make uninstall
: Uninstalls the extension
-
Development targets: These targets are aimed at developers and translators
make clean
: Deletes extension zip, locale
and automatic backups
make gtk4
: Simplifies and converts UI files (Should be run after any changes to files in ui/
)
make translations
: Updates translations
make compress
: Losslessly compresses any .pngs in docs/
- Allows passing
COMPRESSLEVEL="-o[X]"
, where [X]
is an integer between 0-7
make release
: Updates the GTK 4 UI, translations, then creates and checks an extension zip
- Calls
make gtk4 translations compress build check
- Supports any variables / arguments supported by these targets
- Also allows passing
VERSION="[XX]"
, where [XX]
is the version to update metadata.json
to
make package
: Creates the extension zip from the project's current state (Only useful for debugging)
- gettext
- gnome-shell (
gnome-extensions
command)
- libglib2.0-bin
Build dependencies: (Only required if running make release
)
All install dependencies
- sed (
make translations
)
- libgtk-3-bin (
make gtk4
)
- libgtk-4-bin (
make gtk4
)
- optipng (
make compress
)
What happened to the show favourites option?
- Maintaining this feature was going to end up complicated and messy
- It was also out of scope, and this extension did the job better
- With this in mind, the feature was removed in release
v16
- Help with the project is always appreciated, refer to
docs/CONTRIBUTING.md
to get started
- Documentation, code, translations and UI improvements are all welcome!
Bug reporting / debugging:
- If you were simply told "Error" while installing, reboot and if there's still an issue
- When installing an extension from GNOME's extension site, this is normal
- A log of what the extension is doing is very helpful for fixing issues
- The extension logs to the system logs when enabled, which can be accessed with
journalctl /usr/bin/gnome-shell
- A live feed of GNOME's logs can be accessed with
journalctl /usr/bin/gnome-shell -f -o cat
- To enable logging, the setting can be found under the
Developer settings
section of the extension's settings:
![Enable logging](docs/enable-logging.png)
scripts/update-po.sh
and scripts/update-pot.sh
were derived from Fly-Pie, originally licensed under the MIT license
![Settings](docs/settings.png)
alphabetical-grid-extension's People
Watchers