Instructions seem to have errors

[ryanhellyer]

I think there is something wrong with the instructions. It says "Open gnome-tweak-tool" but I don't think that exists within Gnome does it? I think it's a reference to the Gnome tweaks tool which you need to install separately. Then the instructions say "go to “Shell Extensions”, but I don't see anything about shell extensions in the Gnome tweaks tool.

[zakkak]

Hello @ryanhellyer . Thanks for your comment. Indeed the documentation seems outdated. gnome-tweak-tool is now gnome-tweaks (and indeed needs to be installed separately) and Shell Extensions is just Extensions.

Please feel free to update the documentation and open a PR.

[svenevs]

@zakkak I will do a quick pass-through and try and update these. I just found out the "Install new extension" has been removed from Gnome Tweaks, meaning it should be advised to install via the website or unpack manually. See GitLab issue discussing its removal.

I think I can write up some good (but relatively brief) instructions on how to use the website. But ideally we would also have instructions to do it offline (e.g., if somebody needs to download the .zip from the releases page for some reason).

Would you be able to give me any thoughts how you actually, once the .zip is downloaded, if there is anything special to do? I installed via my browser (never done this before, always selected the .zip from gnome-tweak-tool), and got the result

$ ls ~/.local/share/gnome-shell/extensions
workspace-grid@mathematical.coffee.gmail.com

I guess I'm just looking for confirmation that it actually is as easy as

1. Download the right .zip from the releases page (check gnome-shell --version).

2. Make / extract there:

   # make the user-extensions directory if it does not yet exist
   $ mkdir -p ~/.local/share/gnome-shell/extensions/workspace-grid@mathematical.coffee.gmail.com
   $ cd ~/.local/share/gnome-shell/extensions/workspace-grid@mathematical.coffee.gmail.com
   
   # copy .zip to this new extension directory and extract
   $ cp ~/Downloads/workspace-grid-for-3.16-to-3.26.zip .
   $ unzip workspace-grid-for-3.16-to-3.26.zip
   
   # Cleanup: no need to keep the .zip around
   $ rm workspace-grid-for-3.16-to-3.26.zip

Let me know if this looks right to you and I'll open a docs PR with updated install docs / renames :)

[zakkak]

Hi @ryanhellyer, yes you are pretty close it should actually be as simple as:

# make the user-extensions directory if it does not yet exist
mkdir -p ~/.local/share/gnome-shell/extensions
cd ~/.local/share/gnome-shell/extensions

# copy .zip to this new extension directory and extract
cp ~/Downloads/workspace-grid-for-3.16-to-3.26.zip .
unzip workspace-grid-for-3.16-to-3.26.zip

# Cleanup: no need to keep the .zip around
rm workspace-grid-for-3.16-to-3.26.zip

[felipemarinho97]

Don't forget compiling the schemas glib-compile-schemas workspace-grid@mathematical.coffee.gmail.com/schemas

[zakkak]

Shouldn't the schemas be already properly compiled in the zip file? Is something I can fix when distributing the package or is it mandatory to compile the schemas locally to make sure they are compatible with the local version of gnome?

[zakkak]

You can now just run make install ;)

[alifare]

Anybody knows how to switch between windows by Alt+Tab in just one workspace, instead of switching between windows in all workspaces?