[kde-doc-english] KDE DocBook Sanitizer

Carlos Leonhard Woelz carloswoelz at imap-mail.com
Sat Sep 3 17:30:53 CEST 2005


On Fri, 2 Sep 2005 22:48:24 +0100, "Philip Rodrigues"
<philip.rodrigues at chch.ox.ac.uk> said:
> At the moment the list of terms is online at 
> http://www.kde.me.uk/index.php?page=Consistency+rules . This is the list
> of 
> forms that the en_GB translators use(d) for proofreading, so it's more de 
> facto than anything. The version of the word list used by the script is 
> http://people.fruitsalad.org/frerich/sanitizer/tools/preferred_forms .

Great, I'll make a patch.
 
> > Also, there are some terms from the visual
> > guide that are considered deprecated! For instance "Drop Down Box" is
> > considered deprecated. I would like to change that (also to-do vs todo,
> > etc...).
> 
> I think we should get some people together who are interested in pursuing 
> this. I'm unfortunately not able to motivate myself for it. As I
> understand it, the HIG team will at some point take responsibility for
> this, so you would have to get in touch with them. I'll check this with
> Lauri. OK, I just did - what I said is correct.

You got me wrong here: I do not have sufficient English knowledge to
discuss the best forms for the widgets with the HIG team or with you.

What bugs me now, is that the visual guide, which I have been using so
far, says something, and the script says the opposite. I get dozens of
errors, and I don't know what to do. I don't think that something taken
from the visual guide can be considered "wrong". If someone has a
different opinion, fine to me, but please change the visual guide first,
so I'll know what to do. BTW, the visual guide really helps poor English
speakers like me :)

My suggestion would be to take all the widget names than appear in the
visual guide of the search *for now*.

Here is a patch that correct the to-do, remove some controversial choices, 
remove some duplications, fix cases.

Cheers,

Carlos Woelz
-------------- next part --------------
# Preferred forms of words for KDE user-visible strings
# Enter as:
# Deprecated form/Preferred form[/Optional comment]
# Enter one deprecated form for each possible conjugation of the word,
# including plurals and capitalizations, since we might want to enforce a
# particular capitalization (eg, for 'Internet')
# Comments must be whole line, beginning with '#'
# TODO:
# Add '<keycap>' -> '<keysym>' corrections
# NB: <keycap>Page Up</>, <keysym>Left/Right/Up/Down Arrow</> are correct
# <key(cap|sym)>Ctrl -> &Ctrl;

Addressbook/Address book
addressbook/address book
Addressbooks/Address books
addressbooks/address books

Anti alias/Anti-alias
anti alias/anti-alias
Anti aliases/Anti-aliases
anti aliases/anti-aliases
Anti aliasing/Anti-aliasing
anti aliasing/anti-aliasing

Antialias/Anti-alias
antialias/anti-alias
Antialiases/Anti-alias
antialiases/anti-alias
Antialiasing/Anti-aliasing
antialiasing/anti-aliasing

Can not/Cannot/Only use 'can not' for emphasis
can not/cannot/Only use 'can not' for emphasis
can't/cannot
Can't/Cannot

Checkbox/Check box
checkbox/check box
Checkboxes/Check boxes
checkboxes/check boxes

#Color Selector

Dropdown list/Drop down box
dropdown list/drop down box
Drop-down list/Drop down box
drop-down list/drop down box
Drop down list/Drop down box
drop down list/drop down box

Dropdown box/Drop down box
dropdown box/drop down box
Drop-down box/Drop down box
drop-down box/drop down box
Drop-down boxes/Drop down boxes
drop-down boxes/drop down boxes
Dropdown boxes/Drop down boxes
dropdown boxes/drop down boxes


#Dialog Box

Directories/Folders/Only use 'directory' for CLI
directories/folders/Only use 'directory' for CLI
Directory/Folder/Only use 'directory' for CLI
directory/folder/Only use 'directory' for CLI

E-mail/Email
e-mail/email
E-mails/Emails
e-mails/emails

File size/Filesize
file size/filesize
File sizes/Filesizes
file sizes/filesizes

Filesystem/File system
filesystem/file system
Filesystems/File systems
filesystems/file systems

Fine tune/Fine-tune
fine tune/fine-tune
Fine tunes/Fine-tunes
fine tunes/fine-tunes

Formula-bar/Formula bar
formula-bar/formula bar
Formula-bars/Formula bars
formula-bars/formula bars

Formulabar/Formula bar
formulabar/formula bar
Formulabars/Formula bars
formulabars/formula bars

Gray scale/Grayscale
gray scale/grayscale
Gray scales/Grayscales
gray scales/grayscales
Gray scaled/Grayscaled
gray scaled/grayscaled

Harddisk/Hard disk
harddisk/hard disk
Harddisks/Hard disks
harddisks/hard disks

Highscore/High score
highscore/high score
Highscores/High scores
highscores/high scores

Hit a key/Press a key
hit a key/press a key

hz/Hz

Icon List

Infra-red/Infrared
infra-red/infrared
Infra-reds/Infrareds
infra-reds/infrareds

internet/Internet

it'll/it will
It'll/It will

khz/kHz

#List Box

lower case/lowercase
lower-case/lowercase
Lower case/Lowercase
Lower-case/Lowercase


Menu bar/Menubar
menu bar/menubar
Menu bars/Menubars
menu bars/menubars

Menu-bar/Menubar
menu-bar/menubar
Menu-bars/Menubars
menu-bars/menubars

Mhz/MHz
mhz/MHz/Unless you mean milliHertz...

Ok/OK
Ok/Ok

Pop-up menu/Popup menu
pop-up menu/popup menu
Pop-up menus/Popup menus
pop-up menus/popup menus

Pre-set/Preset
pre-set/preset
Pre-sets/Presets
pre-sets/presets

#Progress Bar

#Radio Button

Re start/Restart
re start/restart
Re starts/Restarts
re starts/restarts

Re-start/Restart
re-start/restart
Re-starts/Restarts
re-starts/restarts

Real time/Real-time
real time/real-time
Realtime/Real-time
realtime/real-time

Screensaver/Screen saver
screensaver/screen saver
Screensavers/Screen savers
screensavers/screen savers

#Scroll Bar

Sidebar/Navigation panel
sidebar/navigation panel
Sidebars/Navigation panels
sidebars/navigation panels

Keybinding/Shortcut
keybinding/shortcut
Keybindings/Shortcuts
keybindings/shortcuts

Key binding/Shortcut
key binding/shortcut
Key bindings/Shortcuts
key bindings/shortcuts


#Slider

Spell check/Spellcheck
spell check/spellcheck
Spell checking/Spellchecking
spell checking/spellchecking
Spell checks/Spellchecks
spell checks/spellchecks

Spell-check/Spellcheck
spell-check/spellcheck
Spell-checking/Spellchecking
spell-checking/spellchecking
Spell-checks/Spellchecks
spell-checks/spellchecks

#Spin Box

statusbar/status bar
status-bar/status bar
Statusbar/Status bar
Status-bar/Status bar

Sub process/Sub-process
sub process/sub-process
Sub processes/Sub-processes
sub processes/sub-processes

Subprocess/Sub-process
subprocess/sub-process
Subprocesses/Sub-processes
subprocesses/sub-processes

Taskmanager/Task manager
taskmanager/task manager
Taskmanagers/Task managers
taskmanagers/task managers

textbox/text box
textboxes/text boxes
text-box/text box
text-boxes/text boxes

title bar/titlebar
title-bar/titlebar
Title bar/Titlebar
Title-bar/Titlebar

Todo/To-do
todo/to-do
Todos/To-dos
todos/to-dos

Tool tip/Tooltip
tool tip/tooltip
Tool tips/Tooltips
tool tips/tooltips

Tool-tip/Tooltip
tool-tip/tooltip
Tool-tips/Tooltips
tool-tips/tooltips

tool bar/toolbar
tool-bar/toolbar
Tool bar/Toolbar
Tool-bar/Toolbar

tool bars/toolbars
tool-bars/toolbars
Tool bars/Toolbars
Tool-bars/Toolbars

treeview/tree view
Treeview/Tree view
TreeView/tree view

treeviews/tree views
Treeviews/Tree views
TreeViews/tree views

Upper case/Uppercase
upper case/uppercase
Upper-case/Uppercase
upper-case/uppercase

Webbrowser/Web browser
webbrowser/web browser
Webbrowsers/Web browsers
webbrowsers/web browsers

Webpage/Web page
webpage/web page
Webpages/Web pages
webpages/web pages

Webserver/Web server
webserver/web server
Webservers/Web servers
webservers/web servers

Whitespace/White space
whitespace/white space
Whitespaces/White spaces
whitespaces/white spaces

#Window Titlebar

# Specials

# !/!/No spacing before punctuation
# ?/?/No spacing before punctuation
, that/ that/Don't usually need comma before 'that'

'll/ will/Use contractions only in informal sections
'd/ had' or `would/Use contractions only in informal sections
've/ have/Use contractions only in informal sections

I'm/I am
i'm/I am
they're/they are
They're/They are

i\.e\./&ie;/Use the entity!
I\.e\./&ie;/Use the entity!
ie\./&ie;/Use the entity!

e\.g\./&eg;/Use the entity!
eg\./&eg;/Use the entity!

etc./&etc;/Use the entity!
etc/&etc;/Use the entity!

<!-- <othercredit role=/<othercredit role=/This can be uncommented when the bug is fixed

# It would be nice to check for quotes used instead of <quote>, but
# they are used legitimately in some places, so can't really check for them at this
# stage
#"/<quote>.../Should this be contained in a <quote>?

# Deprecated entities

&kcontrol;/&kcontrolcenter;/Use &kcontrol; only when you want to expand to 'KControl'
&kappname;//Use the entity for this application instead
&kmyapplication;//Use the entity for this application instead
-------------- next part --------------
A non-text attachment was scrubbed...
Name: pref.diff
Type: text/x-diff
Size: 2010 bytes
Desc: not available
Url : http://mail.kde.org/pipermail/kde-doc-english/attachments/20050903/d196bd6c/attachment.bin 


More information about the kde-doc-english mailing list