Download Reference Manual
The Developer's Library for D
About Wiki Forums Source Search Contact

Ticket #30 (new task)

Opened 18 years ago

Last modified 17 years ago

Consider how to handle translations

Reported by: larsivi Assigned to:
Priority: major Milestone: Documentation
Component: Documentation Version:
Keywords: Cc:

Description

Many D users will not be entirely comfortable with reading the documentation in English, and thus we should look into solutions for how to store translated versions, both for API documenation, and the rest.

Change History

06/12/06 21:52:14 changed by kris

  • owner changed from pragma to AbrahamZ.
  • component changed from DDL to Documentation.

01/11/07 18:20:06 changed by larsivi

  • owner deleted.
  • milestone deleted.

01/11/07 20:49:15 changed by pragma

I did some basic research on this topic:

There is a Trac I18n ticket on edgewall. It's as old as the hills and has been pushed back to 0.11: http://trac.edgewall.org/ticket/280

I found this thread, which was rather eye opening: http://www.arcknowledge.com/gmane.comp.version-control.subversion.trac.devel/2006-09/msg00030.html

Within it, Matt Good suggests the use of Genshi filters for internationalization. From the outset this seems like a spiffy idea, but in reality, is only useful for changing the text for form labels and such:

http://genshi.edgewall.org/wiki/ApiDocs/genshi.filters

I'd like to suggest that we arrive at something resembling a final cut of the docs, then translate them wholesale. Downloadable versions aside, the online rendition should probably be kept in the Wiki as a parallel doc structure. A good example of this is how the PHP docs are organized:

http://www.php.net/docs.php

I have no doubt that Trac could be modified to keep parallel Wiki's on hand, each associated with a different locale. But between those database changes, Trac modifications and the mechanism for switching locale, it adds up to a sizable patch to Trac itself. IMO, that's a bit beyond the scope of this ticket.

02/04/07 11:55:43 changed by larsivi

  • milestone set to Documentation.