Experimental Hotkeys

We are testing out hotkeys on the main SuttaCentral.net website. They are only minimally documented on the site so far but testing and feedback is most welcome. As with all new changes, you may need to do a ctrl/cmd + shift + R to see the changes. Here is what we have so far:

key function
s Open the top search bar and place cursor ready to search
v toggle through three view states for aligned texts (plain/side by side/line by line)
n toggle through notes view (on asterisk/side notes/none)
m Toggle main reference numbers on and off
r Toggle all reference numbers on and off
esc close all overlays

You can find a more detailed discussion on the features on the GitHub issue: Keyboard shortcuts Ā· Issue #2308 Ā· suttacentral/suttacentral Ā· GitHub

Please give them a try and tell us what you think. Note: these are just single keys, no need for Alt/Ctrl/Cmd. So they shouldnā€™t interfere with other shortcuts you may be using.

For now they are hinted at in the view menu if you forget:

This work is being done by Ven. @Khemarato.bhikkhu. Much appreciation for his time getting these to work well.

10 Likes

Should esc also close the Pali lookup bottom sheet too? Right now it only closes the top sheets :thinking:

1 Like

Maybe notā€¦ All the other things are very temporary already. Like, you arenā€™t going to use the site with the settings panel open. But the Pali lookup is something I would imagine someone might keep open as they read. But I donā€™t actually use it much so I canā€™t really say.

3 Likes

v works. So awesome!
I had no luck with s and n

2 Likes

You probably need to force refresh. The previous version of SC had only (a buggy version of) the v shortcut :smile:

3 Likes

Just tried these on the mac and they work perfectly :heartpulse:

Many thanks, Ven. @Khemarato.bhikkhu !

:pray: :elephant:

2 Likes

Works brilliantly, itā€™s an amazing feature. Funny how such small things make such a big difference. :slight_smile: Thanks a lot Bhantes!

2 Likes

I know, right? I absolutely love them.

2 Likes

ā€œVā€ is truly awesomeā€¦ :boom:

3 Likes

Two new hotkeys have just been added:

key function
m Toggle main reference numbers on and off
r Toggle all reference numbers on and off

Please check them out and let us know how they work for you. Iā€™d also love to hear if there are other things you would like hotkeys for.

Note: Not all legacy (non-aligned) have reference numbers.

Thanks to Ven. @Khemarato.bhikkhu for his work on this.

6 Likes

Itā€™s so awesome having v, r, and n. Previously it was very tedious to turn pali, references, and notes on and off. Now itā€™s very fast! :pray:

2 Likes

I agree! Are there any other keyboard commands/hotkeys you think would be beneficial?

I canā€™t think of anything else right that would help me when reading individual suttas. For me, the main other issues have to do with searching and navigation - which are difficult problems that I know you are working on.

2 Likes

Oh guys, this is just excellent. Thanks so much!

I know itā€™s probably just for me, but a ā€˜pā€™ for PTS references (like ā€˜mā€™ for main) would be wonderful

1 Like

Well done!

Perhaps add ? to invoke the shortcuts list, like here on Discourse

4 Likes

We were planning on having I O and P open the Info, view (Options), and Parallels panels.

2 Likes

Very sensible. Iā€™ll take anything you like for PTS, even a punctuation character if you are considering implementing it Bhante.

1 Like

I had potentially listed t to toggle the toolbar setting:


But honestly I am not set on that. Iā€™m doubting people toggle that very often. We could use b for that if we really wanted it.

We are already using s for search. I think t would be good for PTS refs. @Khemarato.bhikkhu, what do you think?

:exploding_head:

I had no idea about this. Itā€™s curious that I donā€™t see any attempt to tell people about the shortcuts or the ?.

I like ? for this. Itā€™s used on GitHub as well. I had been thinking k but ? makes a bit more sense.

Another interesting observation is that I donā€™t think I have ever accidentally triggered any of those shortcuts on D&D, which indicates to me that having single keypress shortcuts works well.

Thanks for the feedback!!!

3 Likes

All works beautifully on the mac.

As a related aside, because the s hotkey will be popular, I wonder about this conundrum: When you go into search mode, unless you know to look for the small greyed-out x at the far right bottom of the search box, you will think thereā€™s no way to get back to whatever sutta you are searching from. Until youā€™ve done it once, thereā€™s an impression that thereā€™s no way to get back.

:elephant: :pray:

1 Like

:+1:

Hitting esc should work, no?

2 Likes