Opened 12 years ago

Closed 10 years ago

Last modified 10 years ago

#18108 closed New feature (fixed)

Official translations of the documentation

Reported by: survaes@… Owned by: nobody
Component: Documentation Version:
Severity: Normal Keywords: documentation translation
Cc: hirokiky@… Triage Stage: Ready for checkin
Has patch: yes Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: no UI/UX: no

Description

In the docs, the url is prefixed by en/version, if i change to another language i found 404 pages.

I think this point is important and that many tranlators have stopped theirs job because they are not published (if you show this page wiki1 and this other wiki2), you can see that many efforts have been made.

I take this report as blocked, because i think that for too much developpers, don't to read docs in theirs language is blocking. For me even if i can read and write english, i read and write slowly than in my mother language. For coding this is a little problem (signs are near math formulas), for docs, this is a strong problem, as you read many sentences in shorts times.

To conclude my questions are :

  • Is it possible with actual system to publish translation.
  • If yes :
    • when django will permit to send translations and to publish them?
    • where? (svn, git, a special django system...)
    • what will be the translation process? acceptance - failover...

If this is possible, i will participates and many others. Be sure that this interessests many people.

Whatever your answer, thanks for your works, this site is so clear and django is a powerfull framework.

Best Regard,

Nicolas

Attachments (2)

docs_translation.diff (4.2 KB ) - added by Claude Paroz 12 years ago.
Draft of build instructions
18108.diff (1.6 KB ) - added by Tim Graham 10 years ago.

Download all attachments as: .zip

Change History (20)

comment:1 by Aymeric Augustin, 12 years ago

Severity: Release blockerNormal

Technically this isn't a release blocker. It sounds more like a social issue that a code issue, too.

by Claude Paroz, 12 years ago

Attachment: docs_translation.diff added

Draft of build instructions

comment:2 by Claude Paroz, 12 years ago

Component: Djangoproject.com Web siteInternationalization
Has patch: set
Patch needs improvement: set
Triage Stage: UnreviewedAccepted
Type: UncategorizedNew feature

We are very close to a working process for translating the Django documentation. Just attaching a work-in-progress patch to share my experiments until now.

comment:3 by Claude Paroz, 11 years ago

I published a workflow proposal on a wiki page: TranslatingDocumentation

Please read and review/comment.

comment:4 by Tim Graham, 11 years ago

Component: InternationalizationDocumentation
Summary: Where are translations for docsOfficial translations of the documentation

Marking #8940 as a duplicate of this ticket since this one has more recent activity.

comment:5 by Jannis Leidel, 11 years ago

I've reviewed the TranslatingDocumentation page and agree with it, although have a few questions:

What do we need to modify in the djangoproject.com code to search the different languages?
When do we pull the changes from Transifex?

in reply to:  5 comment:6 by Claude Paroz, 11 years ago

Replying to jezdez:

What do we need to modify in the djangoproject.com code to search the different languages?

Oh well, I didn't think about that. Probably we should create a different search index for each language. I will add a note on the Wiki.

When do we pull the changes from Transifex?

This is still undecided, might be once a week, for example. It depends also on the automation we'll achieve with the whole process.

comment:7 by Claude Paroz, 11 years ago

Git repo: https://github.com/django/django-docs-translations
Transifex project: https://www.transifex.com/projects/p/django-docs/

The question arose about sharing translation teams with Django Transifex. Mixing 17185 translatable strings (344891 words) in django-docs with django's 3042 words would make translation stats looks imbalanced. The current feeling is to not share teams (small overhead to manage 2 different team sets).

comment:8 by Claude Paroz, 11 years ago

Anyone at ease with writing Makefiles to create one to compile po files into mo files in https://github.com/django/django-docs-translations ?

comment:9 by Hiroki Kiyohara, 11 years ago

Cc: hirokiky@… added

I sent a pull-request adding a Makefile to compile po files into mo files.

https://github.com/django/django-docs-translations/pull/1

comment:10 by Hiroki Kiyohara, 11 years ago

I want to use machine translation on Web interface of Transifex.
But, I'm not have a permission to change the setting of this project (https://www.transifex.com/projects/p/django-docs/).

Would someone set the cooperation to translation service?

comment:11 by Jannis Leidel, 11 years ago

@hirokiky I've just enabled the Google machine translation ability (with my personal account).

comment:12 by Hiroki Kiyohara, 11 years ago

@jezdez Thank you!

comment:13 by Tim Graham, 10 years ago

Has patch: unset
Patch needs improvement: unset

I think the main task is to increase visibility of the translation documentation (#22061), but I'll leave this open for Claude to confirm.

comment:14 by Claude Paroz, 10 years ago

Timo, shouldn't we complement the https://docs.djangoproject.com/en/dev/internals/contributing/localizing page about documentation translation? I would write something like this, but feel free to rewrite it in a better English.

Documentation
=============
There is also the opportunity to translate the documentation, even if this is a huge work to complete entirely
(you have been warned!). We use the same Transifex tool, but at this URL: https://www.transifex.com/projects/p/django-docs/.
The translation will appear on the docs.djangoproject.com Web site as soon as at least the ``intro`` part is
fully translated in your language.

by Tim Graham, 10 years ago

Attachment: 18108.diff added

comment:15 by Tim Graham, 10 years ago

Has patch: set

Looks good, revisions attached.

comment:16 by Claude Paroz, 10 years ago

Triage Stage: AcceptedReady for checkin

Great (as usual). Please commit and close the ticket.

comment:17 by Tim Graham <timograham@…>, 10 years ago

Resolution: fixed
Status: newclosed

In 1a3bec4a26248f93982e0349bab53adaab80e968:

Fixed #18108 -- Added instructions for translating documentation.

Thanks Claude Paroz.

comment:18 by Tim Graham <timograham@…>, 10 years ago

In 0b2a36ecf787620ff96c6a342c11a9c39bcfc41b:

[1.7.x] Fixed #18108 -- Added instructions for translating documentation.

Thanks Claude Paroz.

Backport of 1a3bec4a26 from master

Note: See TracTickets for help on using tickets.
Back to Top