Talk:Commands

From Audacity Development Manual
Revision as of 15:24, 27 April 2017 by PeterSampson (talk | contribs) (April 2017: And note that Connie wants spaces either side of the + sign in the shortcuts.)
Jump to: navigation, search

This is an experiment by James with an auto-generated sortable list of commands and shortcuts. Sortability is going to depend on stylesheets in the manual. So far this only includes menu commands.


April 2017

  • Gale: As I already pointed out on Wiki, kbrd template is not correct here. Kbrd is explicitly not for Audacity shortcuts.

    Does this replace Keyboard Shortcut Reference? That is a pain to maintain, though it has better text than we currently have here.

    • I think the kbrd outline looks better than the purple. But I am not attached to it. Manual team can decide. It is easy to change/autogenerate in either version.
      • Gale 17Apr17: I don't care that much, but if we change the key/shortcut templates to look like the current kbrd, then kbrd will have to change to some other design.
    • The plan is to offer Keyboard Shortcut Reference autogenerated as well - and let manual team decide whether to use one or both. The main point of a single table is sorting. And that only makes sense if sorting is available in this wiki. I can also auto-generate tables sorted in different ways, but that is less elegant than a single sorted table I think.
    • The descriptive text is autogenerated. The plan is to re use the hand crafted text. When that is done properly the image maps for menus could reuse the same descriptive text, if we want.
  • Gale 18Apr17: We'll need a decision when possible on whether we can add Commands from Keyboard Preferences to this list. If we can, then most likely this would supersede Keyboard Shortcut Reference.
  • James 27Apr17 We now have a box round the key template, that is like the box round kbrd, but retains the purple colour. Maybe we can choose a new colour that is a bit lighter? This is kbrd CTRL and this is key CTRL+A and here are some other possible variations CTRL+A, CTRL+A, CTRL+A, CTRL+A, CTRL+A. I am proposing CTRL+A as being a lighter CTRL+A and still visibly distinct from CTRL + A .
  • Peter 27Apr17: things like Ctrl+A are "shortcuts" not "keys" and thus should be expressed as CTRL + A with the shortcut template. And note that Connie wants spaces either side of the + sign in the shortcuts.

'Source Code'

This page is now the 'source code' for generating hover text in the image maps of menus, when regenerating images for the menu pages. The text that goes into the links is the 'hover' argument, with wiki menu links and hyperlink formatting removed.