Register Guidelines E-Books Search Today's Posts Mark Forums Read

Go Back   MobileRead Forums > E-Book Software > Calibre > Development

Notices

Reply
 
Thread Tools Search this Thread
Old 08-01-2011, 05:37 PM   #1
drMerry
Addict
drMerry has become one with the cosmosdrMerry has become one with the cosmosdrMerry has become one with the cosmosdrMerry has become one with the cosmosdrMerry has become one with the cosmosdrMerry has become one with the cosmosdrMerry has become one with the cosmosdrMerry has become one with the cosmosdrMerry has become one with the cosmosdrMerry has become one with the cosmosdrMerry has become one with the cosmos
 
drMerry's Avatar
 
Posts: 293
Karma: 21022
Join Date: Mar 2011
Location: NL
Device: Sony PRS-650
Question Translation and shortcuts best practice

Hi all,

Just a question about translations.
I had a discussion with another translator about this, and I would like to hear some other opinions.

INTRO
While translating calibre, you will also have to translate the shortcuts
e.g. on a button.

The shortcut is marked with the & character.

Change &cover

means: press c to use the change cover function (in calibre you will see the c is underlined.
/INTRO

So, during translation, you will get problems translating the exact word. E.g. in dutch the translation of cover is omslag. As you can see, no c.

So, what should I do in general, there are 4 options

1. Choose another word
2. Use the same word but don't create a shortcut
3. Use the same word, add an extra character
4. Use the same word but just create another shortcut

In the case &cover it would be:

1. Omslag (voor &calibre)
2. Omslag
3. Omslag &c
4. &Omslag

There is no good other translation for cover containing a c so I added "used in caliber" at the end for 1.

My opinion is, you should use 1 if possible, otherwise 2.
4 would be bad practice in my opinion for 4 reasons:

1. If you are used to shortcuts, you do need the same shortcut in all languages. If d means duplicate in one language and delete in another, you do have a problem (if you disable the warning messages, you will have a big problem).
2. If you get duplicate shortcuts on 1 screen, the shortcut won't work or will have unexpected behavior.
3. If you mange to check all duplicates, and Kovid adds a text that uses the shortcut you chose for a translated item, you do have a problem again.
4. It is (in my opinion) unmanageable, and if the original translator does leave the project, you will have to read all shortcuts to be sure no conflicts are created (not even talking about translators that just pop-in....)

The pro's of using 1, 2 and 3 are:
- Shortcuts stay the same in all languages (when using 2, some shortcuts won't work, but the are not used for another function either).
- When new functions are available, you just have to translate the same shortcut, and you do not have to check if the shortcuts are occupied already (I trust Kovid doing this for the original translation)

The pro for using four would be:
All shortcuts are translated so all functions that do have a shortcut will have one after translating
You do not have to use 'bad' translations (e.g. you can use "&station" and not "&railroad stop" if the original translation requires a &r)

But personally speaking, the cons are much bigger than the pros.
What do you think?
drMerry is offline   Reply With Quote
Old 08-01-2011, 08:20 PM   #2
kovidgoyal
creator of calibre
kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.
 
kovidgoyal's Avatar
 
Posts: 26,433
Karma: 5383257
Join Date: Oct 2006
Location: Mumbai, India
Device: Various
These shortcuts do not refer to single key shortcuts. You have too press Alt+the key and even then, all that happens in the corresponding control is selected.

The single letter shortcuts are translated separately and you should almost always leave them as is, unless you really, really know what you are doing.
kovidgoyal is offline   Reply With Quote
Old 08-04-2011, 07:45 PM   #3
drMerry
Addict
drMerry has become one with the cosmosdrMerry has become one with the cosmosdrMerry has become one with the cosmosdrMerry has become one with the cosmosdrMerry has become one with the cosmosdrMerry has become one with the cosmosdrMerry has become one with the cosmosdrMerry has become one with the cosmosdrMerry has become one with the cosmosdrMerry has become one with the cosmosdrMerry has become one with the cosmos
 
drMerry's Avatar
 
Posts: 293
Karma: 21022
Join Date: Mar 2011
Location: NL
Device: Sony PRS-650
I'm sorry,

I was referring to the alt + shortcuts.
Is your last sentence also applicable on the alt + ?
In that case we do have the same opinion.
And which translation should be preferred in case problematic cases,

2 or 3?

(2 = extra character; 3 = no translated shortcut)
drMerry is offline   Reply With Quote
Old 08-04-2011, 08:21 PM   #4
kovidgoyal
creator of calibre
kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.
 
kovidgoyal's Avatar
 
Posts: 26,433
Karma: 5383257
Join Date: Oct 2006
Location: Mumbai, India
Device: Various
With the text shortcuts you should use whatever letter makes sense for the translation. So for example, &cover -> &Omslag

With the single letter shortcuts, they should remain the same:

So C -> C, D -> D and so on
kovidgoyal is offline   Reply With Quote
Old 08-05-2011, 09:59 PM   #5
drMerry
Addict
drMerry has become one with the cosmosdrMerry has become one with the cosmosdrMerry has become one with the cosmosdrMerry has become one with the cosmosdrMerry has become one with the cosmosdrMerry has become one with the cosmosdrMerry has become one with the cosmosdrMerry has become one with the cosmosdrMerry has become one with the cosmosdrMerry has become one with the cosmosdrMerry has become one with the cosmos
 
drMerry's Avatar
 
Posts: 293
Karma: 21022
Join Date: Mar 2011
Location: NL
Device: Sony PRS-650
All right,

Thank you.
But then how do you solve these problems:

1. duplicate assignments
a-How to detect
b-How to inform translators about used shortcuts
c-How to react on new translations (e.g. if you add an extra button &open in the same screen as &omslag)
d-what will happen when a character is pressed that is assigned two times?
2-How to support people using various languages (e.g. If I have &cover -> &omslag + st&op server -> server uits&chakelen) in this translation the shortcuts for people using the English version are opposite of the people using the translated version.
drMerry is offline   Reply With Quote
Old 08-05-2011, 10:34 PM   #6
kovidgoyal
creator of calibre
kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.
 
kovidgoyal's Avatar
 
Posts: 26,433
Karma: 5383257
Join Date: Oct 2006
Location: Mumbai, India
Device: Various
Duplicate dont matter. If you have two control with shortcut Alt+C then when you press Alt+C the first time, the first control is selected, when you press it again, the next one will be selected. There are duplicates in the original english as well.
kovidgoyal is offline   Reply With Quote
Old 08-06-2011, 07:35 AM   #7
tEmrich
Junior Member
tEmrich began at the beginning.
 
tEmrich's Avatar
 
Posts: 9
Karma: 10
Join Date: Apr 2011
Location: Germany
Device: Kindle 3
Quote:
Originally Posted by kovidgoyal View Post
With the text shortcuts you should use whatever letter makes sense for the translation. So for example, &cover -> &Omslag
I did it the same way with german translations but tried not to produce duplicates wherever possible (i.e. by using another prominent character). This is a nice workflow AND you can keep correct and consistent translations.
tEmrich is offline   Reply With Quote
Old 08-06-2011, 01:27 PM   #8
kovidgoyal
creator of calibre
kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.kovidgoyal ought to be getting tired of karma fortunes by now.
 
kovidgoyal's Avatar
 
Posts: 26,433
Karma: 5383257
Join Date: Oct 2006
Location: Mumbai, India
Device: Various
Quote:
Originally Posted by tEmrich View Post
I did it the same way with german translations but tried not to produce duplicates wherever possible (i.e. by using another prominent character). This is a nice workflow AND you can keep correct and consistent translations.
Indeed it is good to try to avoid duplicates as far as possible, but sometimes it cannot be helped.
kovidgoyal is offline   Reply With Quote
Reply

Tags
best practice, translate

Thread Tools Search this Thread
Search this Thread:

Advanced Search

Forum Jump

Similar Threads
Thread Thread Starter Forum Replies Last Post
K3 keyboard shortcuts et al btobw Amazon Kindle 25 10-15-2011 10:43 AM
ids - Best practice drMerry Library Management 7 05-07-2011 12:02 PM
Shortcuts ? tarke9891 Amazon Kindle 5 09-23-2010 12:33 PM
Keyboard shortcuts VenturingSoul enTourage Archive 1 04-15-2010 11:21 PM
keyboard shortcuts? tashiegirl Calibre 5 04-12-2010 10:25 PM


All times are GMT -4. The time now is 06:43 PM.


MobileRead.com is a privately owned, operated and funded community.