User:Claus chr/Guidelines: Difference between revisions

From KDE Wiki Sandbox
 
(7 intermediate revisions by the same user not shown)
Line 1: Line 1:
Some questions to consider with respect to our typographical guidelines:
Some questions to consider with respect to our typographical guidelines:
== Consistent terminology ==
* Keys are ''pressed''
* Buttons are ''clicked''
* Menu and list items are ''selected''
* Window/Guide/Dialog/Wizzard
* Panel
* Pane
* Common dialogs such as the file selector
Do we need to distinguish between selecting GUI elements and selecting data items (fx files in an Open dialog)?


== Bolding ==
== Bolding ==
Line 5: Line 17:
Should we use bolding or some other markup for
Should we use bolding or some other markup for
* Software, that is not operated by the user: servers, backends, libraries, ...
* Software, that is not operated by the user: servers, backends, libraries, ...
* Programs that are run in a console
* Non-KDE apps
* Non-KDE apps
* Distributions, OS'es
* Distributions, OS'es
* Acronyms for GUI elements (such as Amaroks APG and PUD)
* Tool tips


== Menuchoice ==
== Menuchoice ==
Line 30: Line 45:
* Names of icon buttons
* Names of icon buttons
* Buttons with both an image and a text
* Buttons with both an image and a text
* Options appearing in lists generated according to previous selections (like the items in the constraint tree in Amaroks APG Preset Editor.
* Information in a tree-structure (as in KInfoCenter)
* Packages, engines, demons, filetypes: Use <tt><tt></tt>?

Latest revision as of 11:45, 17 December 2011

Some questions to consider with respect to our typographical guidelines:

Consistent terminology

  • Keys are pressed
  • Buttons are clicked
  • Menu and list items are selected
  • Window/Guide/Dialog/Wizzard
  • Panel
  • Pane
  • Common dialogs such as the file selector

Do we need to distinguish between selecting GUI elements and selecting data items (fx files in an Open dialog)?

Bolding

Should we use bolding or some other markup for

  • Software, that is not operated by the user: servers, backends, libraries, ...
  • Programs that are run in a console
  • Non-KDE apps
  • Distributions, OS'es
  • Acronyms for GUI elements (such as Amaroks APG and PUD)
  • Tool tips

Menuchoice

  • Named sections of a window or dialog: Bolded (even when the name doesn't appear in the interface?)
  • Icon buttons with no text: Use the actual icon inline. How should the "tool tip name" be marked up when it needs to be referred to?
  • How to mark up modes?

Keycap

Only for actual key press actions. If we mention characters (rather then the key pressed to enter them) nor markup is appropriate (except perhaps quote marks)?

Other GUI elements

  • Text field with title in the fiels itself, fx Amaroks Search playlist
  • Named tools, when the name does not appear explicitely in the GUI, fx Amaroks Cover Manager or the Pop-Up Dropper
  • Concepts: should the be capitalized and italicized (only the first time)?
  • Only bold when referring to the actual GUI element, i.e. Playlist is the pane, playlist is a list created there
  • Items from a fixed list selectable from a dropdown list (fx Amaroks biases)
    • Items with names depending on some settings (fx names of items in Amaroks dynamic playlists - note, that the names of baises that can be selected when editing biases is different form the name of the bias that appear in the dynamic playlist)
  • Items in a predefined but modifiable list (typically combo box)
  • Predefined tags (as in Amarok: Artist, Title, ...)
  • Names of icon buttons
  • Buttons with both an image and a text
  • Options appearing in lists generated according to previous selections (like the items in the constraint tree in Amaroks APG Preset Editor.
  • Information in a tree-structure (as in KInfoCenter)
  • Packages, engines, demons, filetypes: Use ?