Ticket #2 (closed defect: fixed)
Description of scripts in keyboard help are not translatable
| Reported by: | mdcurran | Owned by: | mdcurran |
|---|---|---|---|
| Priority: | minor | Milestone: | 2009.1 |
| Component: | Localisation | Version: | development |
| Keywords: | keyboard help script description translation | Cc: | |
| Operating system: | Blocked by: | ||
| Blocking: |
Description
Because descriptions of scripts in NVDA are doc strings, it makes it very hard to allow them to be translatable for various languages. Rather than the doc string being set inside the function, it should be manually set after the function is defined, so that the string can be enclosed in _()
Change History
comment:3 follow-up: ↓ 4 Changed 4 years ago by pvagner
- Version set to trunk
BTW majority of the _doc strings is translateable now.
The related thing which bothers me currently is ability to have list of commands within the given appmodule built dynamically.
I have started working on this but the problem I am facing is I haven't got an idea how to report keyboard shortcuts and make them translateable as well.
E.G. currently it gives me clear review current word. I think we would rather like to have numpad5 listed.
comment:4 in reply to: ↑ 3 ; follow-up: ↓ 5 Changed 4 years ago by jteh
- Component changed from Core to Localization
- Milestone set to 0.6
Replying to pvagner:
BTW majority of the _doc strings is translateable now.
Can you think of any areas where the docstrings haven't been translated? If not, this ticket can probably be closed.
The related thing which bothers me currently is ability to have list of commands within the given appmodule built dynamically.
I've been thinking about this for a while, but haven't come up with a nice way to order the scripts. Alphabetical order is not particularly useful in some cases. Also, they should probably be categorised. In any case, I think this is probably an issue for another ticket.
comment:5 in reply to: ↑ 4 Changed 4 years ago by pvagner
Replying to jteh:
Can you think of any areas where the docstrings haven't been translated? If not, this ticket can probably be closed.
Yes I can find no more....
I've been thinking about this for a while, but haven't come up with a nice way to order the scripts. Alphabetical order is not particularly useful in some cases. Also, they should probably be categorised. In any case, I think this is probably an issue for another ticket.
I am thinking about adding name and category fields the same way _description is used currently and then sort by category. The categories I can think of at the moment are:
*caret navigation
*object navigation
*status reporting
*settings and toggle scripts
But sorry, we will perhaps create a seperate thread as you pointed out.
NVDA is developed by 
A few scripts have already been changed in appModules/_default.py, though there are still many to go there, plus in NVDA objects and virtual Buffers.