Edgewall Software

Opened 5 years ago

Closed 4 years ago

Last modified 3 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 5 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 3 years ago by cboos

  • Release Notes modified (diff)

comment:9 Changed 3 years ago by cboos

  • Release Notes modified (diff)

Modify Ticket

Change Properties
Set your email in Preferences
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.

Add Comment

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

Note: See TracTickets for help on using tickets.