Edgewall Software

Opened 4 years ago

Closed 4 years ago

Last modified 2 years ago

#9666 closed enhancement (fixed)

Option's doc should be translated.

Reported by: songofacandy@… Owned by: jomae
Priority: normal Milestone: 1.0
Component: i18n Version: 0.12
Severity: normal Keywords: i18n
Release Notes:

Translation of the documentation for TracIni options is now possible (in separate tracini.po catalogs)

API Changes:


Option's doc should be i18n target.

Attachments (0)

Change History (9)

comment:1 Changed 4 years ago by cboos

  • Keywords userpreferences added
  • Milestone changed from 0.12.2 to 0.13

Not for 0.12.2, and not all.

But the "user-oriented" ones (query:keywords~=userpreferences), yes.

comment:2 Changed 4 years ago by rblank

  • Milestone changed from 0.13 to 0.14

comment:3 Changed 4 years ago by jomae

I worked the issue, https://github.com/jun66j5/trac/compare/t9666-i18n-option-doc.

New trac.dist.extract_python method can extract messages from doc keyword argument of Option family and ConfigSection. [[TracIni]] macro shows translated documentation of each option.

comment:4 Changed 4 years ago by cboos

  • Keywords userpreferences removed

Wow, lots of work in perspective for translators ;-)

For this reason, I wouldn't put the messages by default in the "messages" domain, but in a separate "tracini". That way, it's easy for translators to decide if they want to support this or not (this is not "end-user" facing text, only "admin-user").

Also, though it's easy to see that extract_python initially comes from Babel, maybe just add a note explaining what it does differently ("""Patched extract_python from Babel to support keyword argument mapping. with a brief overview of what this is about).

Other than those few remarks, looks great! If you want this for 0.13, please do so.

comment:5 Changed 4 years ago by jomae

Ok. I agreed the separating catalog. I will create extract_messages_tracini, init_catalog_tracini, compile_catalog_tracini and update_catalog_tracini commands of setup.py.

Last edited 4 years ago by jomae (previous) (diff)

comment:6 Changed 4 years ago by jomae

  • Milestone changed from 0.14 to 0.13
  • Resolution set to fixed
  • Status changed from new to closed

Committed in [10598]. The translators can do options' documents in each tracini.po!

comment:7 Changed 4 years ago by jomae

  • Keywords i18n added
  • Owner set to jomae

comment:8 Changed 2 years ago by cboos

  • Release Notes modified (diff)

comment:9 Changed 2 years ago by cboos

  • Release Notes modified (diff)

Add Comment

Modify Ticket

Change Properties
<Author field>
as closed The owner will remain jomae.
The resolution will be deleted. Next status will be 'reopened'.
to The owner will be changed from jomae to the specified user.

E-mail address and user name can be saved in the Preferences.

Note: See TracTickets for help on using tickets.