[kde-guidelines] Styleguide: Capitalization

Thomas Pfeiffer colomar at autistici.org
Thu Jan 9 14:11:48 UTC 2014


On Thursday 09 January 2014 12:57:41 Heiko Tietze wrote:
> Do not apply capitalization except for titles and in case of sentence style.
> http://techbase.kde.org/Projects/Usability/HIG/Capitalization
> 
> __NOTOC__
> 
> == Purpose ==
> ''Capitalization'' is a feature of case-sensitive languages to foster
> relevance. 

I'd use "indicate" instead of "foster" here, since the language does not 
actually change the relevance.

>In terms of software it draws attention to words with capital
> letters. For a consistent look and feel of the software it is important to
> implement capitalization consistently. On the other hand, capitalization
> slows down translation and increases the risk of inconsistent terminology.
> 
> == Guidelines ==
> There are two types of capitalization, title capitalization and sentence
> style capitalization:
> 
> === Title Capitalization ===
> * Title capitalization is when every word in a sentence, statement, phrase,
> or label are capitalized except for certain words.  Capitalize all words
> except for: **  Prepositions having less than five letters, (e.g. "for",
> "in", "with" or "to", but "From" or "Under") **  Conjunctions ("and", "or"
> and "but")
> **  Articles ("the", "a" and "an")
> * Use title capitalization in the following cases:
> ** Window and dialog box titles
> ** Group box / group line labels
> ** Button labels
> ** Tab labels
> ** Listview column headers
> ** Menu titles / menu items
> ** Derivatives of KCommand
> ** Combobox items
> ** Listbox items
> ** Tree list items
> ** Other heading/title text
> 
> === Sentence Style Capitalization ===
> * Sentence style capitalization is when the first letter of the sentence,
> statement, phrase, or label is capitalized and all other words are lower
> case.  The only exception to this is proper nouns which are always
> capitalized. * Use sentence style capitalization in the following cases:
> ** Edit box labels
> ** List box labels
> ** Combo box labels
> ** Spin box labels
> ** Check box labels
> ** Option button labels
> ** Slider labels
> ** Pop-up hint text
> ** Dialog header/description
> ** Other non heading/title text

I'd suggest using simple paragraphs instead of the first-level bullets in both 
sections and move the second-level bullets to first level for better 
readability. What do you think?

> === Acronyms/Initialisms, Internet ===
> * Words such as URL, JPEG, or LDAP should be written in capital letters
> * Internet (if referring to ''the'' Internet) takes a capital I.
> 
> [[Category:Usability]][[Category: Presentation]][[Category:Text]]
> 
> (Only minor changes of structure and purpose made)



More information about the kde-guidelines mailing list