[Django] #18108: Where are translations for docs
Django
-------------------------------------+-------------------------------------
Reporter: survaes@… | Owner: nobody
Type: Uncategorized | Status: new
Component: Djangoproject.com | Version:
Web site | Keywords: documentation
Severity: Release blocker | translation
Triage Stage: Unreviewed | Has patch: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------
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
[https://code.djangoproject.com/wiki/DjangoResources#Resourcesinotherlanguages
wiki1] and this other
[https://code.djangoproject.com/wiki/TranslateDocumentation 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
--
Ticket URL: <https://code.djangoproject.com/ticket/18108>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.
Django
-------------------------------------+-------------------------------------
Reporter: survaes@… | Owner: nobody
Type: Uncategorized | Status: new
Component: Djangoproject.com | Version:
Severity: Normal | Triage Stage:
Keywords: documentation | Unreviewed
translation | Needs documentation: 0
Has patch: 0 | Patch needs improvement: 0
Needs tests: 0 | UI/UX: 0
Easy pickings: 0 |
-------------------------------------+-------------------------------------
Changes (by aaugustin):
* needs_docs: => 0
* severity: Release blocker => Normal
* needs_tests: => 0
* needs_better_patch: => 0
Comment:
Technically this isn't a release blocker. It sounds more like a social
issue that a code issue, too.
--
Ticket URL: <https://code.djangoproject.com/ticket/18108#comment:1>
Django
-------------------------------------+-------------------------------------
Reporter: survaes@… | Owner: nobody
Component: | Version:
Internationalization | Resolution:
Severity: Normal | Triage Stage: Accepted
Keywords: documentation | Needs documentation: 0
translation | Patch needs improvement: 1
Has patch: 1 | UI/UX: 0
Needs tests: 0 |
Easy pickings: 0 |
-------------------------------------+-------------------------------------
Changes (by claudep):
* type: Uncategorized => New feature
* has_patch: 0 => 1
* component: Djangoproject.com Web site => Internationalization
* needs_better_patch: 0 => 1
* stage: Unreviewed => Accepted
Comment:
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.
--
Ticket URL: <https://code.djangoproject.com/ticket/18108#comment:2>
Django
-------------------------------------+-------------------------------------
Reporter: survaes@… | Owner: nobody
Component: | Version:
Internationalization | Resolution:
Severity: Normal | Triage Stage: Accepted
Keywords: documentation | Needs documentation: 0
translation | Patch needs improvement: 1
Has patch: 1 | UI/UX: 0
Needs tests: 0 |
Easy pickings: 0 |
-------------------------------------+-------------------------------------
Comment (by claudep):
I published a workflow proposal on a wiki page: TranslatingDocumentation
Please read and review/comment.
--
Ticket URL: <https://code.djangoproject.com/ticket/18108#comment:3>
Django
-------------------------------------+-------------------------------------
Reporter: survaes@… | Owner: nobody
Severity: Normal | Resolution:
Keywords: documentation | Triage Stage: Accepted
translation | Needs documentation: 0
Has patch: 1 | Patch needs improvement: 1
Needs tests: 0 | UI/UX: 0
Easy pickings: 0 |
-------------------------------------+-------------------------------------
Changes (by timo):
* component: Internationalization => Documentation
Comment:
Marking #8940 as a duplicate of this ticket since this one has more recent
activity.
--
Ticket URL: <https://code.djangoproject.com/ticket/18108#comment:4>
Django
Reporter: survaes@… | Owner: nobody
Component: Documentation | Version:
Severity: Normal | Resolution:
Keywords: documentation | Triage Stage: Accepted
translation | Needs documentation: 0
Has patch: 1 | Patch needs improvement: 1
Needs tests: 0 | UI/UX: 0
Easy pickings: 0 |
-------------------------------------+-------------------------------------
Comment (by jezdez):
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?
--
Ticket URL: <https://code.djangoproject.com/ticket/18108#comment:5>
Django
Reporter: survaes@… | Owner: nobody
Component: Documentation | Version:
Severity: Normal | Resolution:
Keywords: documentation | Triage Stage: Accepted
translation | Needs documentation: 0
Has patch: 1 | Patch needs improvement: 1
Needs tests: 0 | UI/UX: 0
Easy pickings: 0 |
-------------------------------------+-------------------------------------
Comment (by claudep):
Replying to [comment:5 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.
--
Ticket URL: <https://code.djangoproject.com/ticket/18108#comment:6>
Django
Reporter: survaes@… | Owner: nobody
Component: Documentation | Version:
Severity: Normal | Resolution:
Keywords: documentation | Triage Stage: Accepted
translation | Needs documentation: 0
Has patch: 1 | Patch needs improvement: 1
Needs tests: 0 | UI/UX: 0
Easy pickings: 0 |
-------------------------------------+-------------------------------------
Comment (by claudep):
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).
--
Ticket URL: <https://code.djangoproject.com/ticket/18108#comment:7>
Django
Reporter: survaes@… | Owner: nobody
Component: Documentation | Version:
Severity: Normal | Resolution:
Keywords: documentation | Triage Stage: Accepted
translation | Needs documentation: 0
Has patch: 1 | Patch needs improvement: 1
Needs tests: 0 | UI/UX: 0
Easy pickings: 0 |
-------------------------------------+-------------------------------------
Comment (by claudep):
Anyone at ease with writing Makefiles to create one to compile po files
into mo files in https://github.com/django/django-docs-translations ?
--
Ticket URL: <https://code.djangoproject.com/ticket/18108#comment:8>
Django
Reporter: survaes@… | Owner: nobody
Component: Documentation | Version:
Severity: Normal | Resolution:
Keywords: documentation | Triage Stage: Accepted
translation | Needs documentation: 0
Has patch: 1 | Patch needs improvement: 1
Needs tests: 0 | UI/UX: 0
Easy pickings: 0 |
-------------------------------------+-------------------------------------
* cc: hirokiky@… (added)
Comment:
I sent a pull-request adding a Makefile to compile po files into mo files.
https://github.com/django/django-docs-translations/pull/1
--
Ticket URL: <https://code.djangoproject.com/ticket/18108#comment:9>
Django
Reporter: survaes@… | Owner: nobody
Component: Documentation | Version:
Severity: Normal | Resolution:
Keywords: documentation | Triage Stage: Accepted
translation | Needs documentation: 0
Has patch: 1 | Patch needs improvement: 1
Needs tests: 0 | UI/UX: 0
Easy pickings: 0 |
-------------------------------------+-------------------------------------
Comment (by hirokiky):
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?
--
Ticket URL: <https://code.djangoproject.com/ticket/18108#comment:10>
Django
Reporter: survaes@… | Owner: nobody
Component: Documentation | Version:
Severity: Normal | Resolution:
Keywords: documentation | Triage Stage: Accepted
translation | Needs documentation: 0
Has patch: 1 | Patch needs improvement: 1
Needs tests: 0 | UI/UX: 0
Easy pickings: 0 |
-------------------------------------+-------------------------------------
Comment (by jezdez):
@hirokiky I've just enabled the Google machine translation ability (with
my personal account).
--
Ticket URL: <https://code.djangoproject.com/ticket/18108#comment:11>
Django
Reporter: survaes@… | Owner: nobody
Component: Documentation | Version:
Severity: Normal | Resolution:
Keywords: documentation | Triage Stage: Accepted
translation | Needs documentation: 0
Has patch: 1 | Patch needs improvement: 1
Needs tests: 0 | UI/UX: 0
Easy pickings: 0 |
-------------------------------------+-------------------------------------
Comment (by hirokiky):
@jezdez Thank you!
--
Ticket URL: <https://code.djangoproject.com/ticket/18108#comment:12>
Django
Reporter: survaes@… | Owner: nobody
Component: Documentation | Version:
Severity: Normal | Resolution:
Keywords: documentation | Triage Stage: Accepted
translation | Needs documentation: 0
Easy pickings: 0 |
-------------------------------------+-------------------------------------
* needs_better_patch: 1 => 0
* has_patch: 1 => 0
Comment:
I think the main task is to increase visibility of the translation
documentation (#22061), but I'll leave this open for Claude to confirm.
--
Ticket URL: <https://code.djangoproject.com/ticket/18108#comment:13>
Django
Reporter: survaes@… | Owner: nobody
Component: Documentation | Version:
Severity: Normal | Resolution:
Keywords: documentation | Triage Stage: Accepted
translation | Needs documentation: 0
Has patch: 0 | Patch needs improvement: 0
Needs tests: 0 | UI/UX: 0
Easy pickings: 0 |
-------------------------------------+-------------------------------------
Comment (by claudep):
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.
}}}
--
Ticket URL: <https://code.djangoproject.com/ticket/18108#comment:14>
Django
Reporter: survaes@… | Owner: nobody
Component: Documentation | Version:
Severity: Normal | Resolution:
Keywords: documentation | Triage Stage: Accepted
translation | Needs documentation: 0
Needs tests: 0 | UI/UX: 0
Easy pickings: 0 |
-------------------------------------+-------------------------------------
* has_patch: 0 => 1
Comment:
Looks good, revisions attached.
--
Ticket URL: <https://code.djangoproject.com/ticket/18108#comment:15>
Django
Reporter: survaes@… | Owner: nobody
Component: Documentation | Version:
Severity: Normal | Resolution:
translation | checkin
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------
* stage: Accepted => Ready for checkin
Comment:
Great (as usual). Please commit and close the ticket.
--
Ticket URL: <https://code.djangoproject.com/ticket/18108#comment:16>
Django
Reporter: survaes@… | Owner: nobody
Component: Documentation | Version:
Severity: Normal | Resolution: fixed
Keywords: documentation | Triage Stage: Ready for
translation | checkin
Has patch: 1 | Needs documentation: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------
* status: new => closed
* resolution: => fixed
Comment:
In [changeset:"1a3bec4a26248f93982e0349bab53adaab80e968"]:
{{{
#!CommitTicketReference repository=""
revision="1a3bec4a26248f93982e0349bab53adaab80e968"
Fixed #18108 -- Added instructions for translating documentation.
Thanks Claude Paroz.
}}}
--
Ticket URL: <https://code.djangoproject.com/ticket/18108#comment:17>
Django
Reporter: survaes@… | Owner: nobody
Component: Documentation | Version:
Severity: Normal | Resolution: fixed
Keywords: documentation | Triage Stage: Ready for
translation | checkin
Has patch: 1 | Needs documentation: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------
Comment (by Tim Graham <timograham@…>):
In [changeset:"0b2a36ecf787620ff96c6a342c11a9c39bcfc41b"]:
{{{
#!CommitTicketReference repository=""
revision="0b2a36ecf787620ff96c6a342c11a9c39bcfc41b"
[1.7.x] Fixed #18108 -- Added instructions for translating documentation.
Thanks Claude Paroz.
Backport of 1a3bec4a26 from master
}}}
--
Ticket URL: <https://code.djangoproject.com/ticket/18108#comment:18>