[Bf-docboard] Keyboard shortcut convention

S J Bennett quollism at ii.net
Fri Nov 28 11:11:59 CET 2014


Sphinx/Python recommendation for hotkey sequences is :kbd:`G Shift-X 
Shift-X` resulting in [G Shift-X Shift-X]. Are we OK with that too?

On 28/11/2014 5:04 PM, Campbell Barton wrote:
> How about:
>
> - use sphinx/python preferred:
>     :kbd:`Ctrl-A`,  :kbd:`A`
>    see: http://sphinx-doc.org/markup/inline.html?highlight=kbd#role-kbd
>
> - If we don't like the way it renders in HTML, we modify the theme,
>    hacking on sphinx isn't so hard and we already have some extensions
> for youtube and vimeo.
>
> (excuse the appeal to authority, but I rather we stick to the standard
> here unless theres a _very_ good reason not to).
>
> On Fri, Nov 28, 2014 at 9:18 AM, koil . <dd4567 at hotmail.co.uk> wrote:
>> Ye, I agree easy to read is probably more important.
>>
>> If possible, Id like it to look like the wiki shortcuts.
>> Like this picture: http://wiki.blender.org/uploads/9/99/RSTK.PNG
>>
>> Combo ... :kbd:`Ctrl`:kbd:`Alt`:kbd:`P` ... [Ctrl][Alt][P] ...
>> (Simultaneous)
>> Chain ... :kbd:`R`, :kbd:`X`, :kbd:`X` ... [R], [X], [X] ... (Sequence)
>>
>> Though im not is rst parses this syntax.
>>
>> Then [Ctrl][+] would also work, if thats a problem.
>>
>> _______________________________________________
>> Bf-docboard mailing list
>> Bf-docboard at blender.org
>> http://lists.blender.org/mailman/listinfo/bf-docboard
>>
>
>



More information about the Bf-docboard mailing list