Opened 8 years ago
Last modified 8 years ago
#27401 new New feature
Add Transifex config to build translated docs
Reported by: | Jeho, Sung | Owned by: | nobody |
---|---|---|---|
Component: | Documentation | Version: | dev |
Severity: | Normal | Keywords: | transifex, document |
Cc: | Triage Stage: | Accepted | |
Has patch: | yes | Needs documentation: | no |
Needs tests: | no | Patch needs improvement: | yes |
Easy pickings: | no | UI/UX: | no |
Description (last modified by )
It need Transifex config for docs/
tx pull -l <LANG>
LANGUAGE=<LANG> make html
Attachments (1)
Change History (6)
by , 8 years ago
Attachment: | patch.diff added |
---|
follow-up: 2 comment:1 by , 8 years ago
Description: | modified (diff) |
---|---|
Summary: | need Transifex config file for docs → Add Transifex config to build translated docs |
Type: | Uncategorized → New feature |
comment:2 by , 8 years ago
Replying to Tim Graham:
Claude, could you advise about this? I'm not sure if it's duplicating anything that's implemented for the djangoproject.com builds. If accepted, should we also add some docs about building the translated docs locally?
sorry for my pool english, I try to explain.
this configuration is integrate with transifex service.
- contributors(yes, they need to register at
django-docs
on transifex) canpull docs/locale/<lang>/LC_MESSAGES/
anytime. - contributors can build docs locally, and check it.
- contributors can upload
.po
file bytx push
in command line environment - contributors can check warning by local build
- and yes, it need to some modify on
README
andMakefile
Ok, I'm not expert and almost newbie- but if you help me(eg: correction typo, syntax...),
I want to contribute this ticket myself. (anyway it's my first ticket on django)
I'm not sure if it's duplicating anything that's implemented for the djangoproject.com builds.
yhea, that's problem.
if any existing repository like "django/docs" on the github, it would be happy- but not exists such repository.
So i forked django official repository, and write some configuration.
Could you check about this by forwarding this ticket? actually i don't know about djangoproject.com
's build plan,
follow-up: 5 comment:3 by , 8 years ago
Patch needs improvement: | set |
---|
Currently, this is handled in the django-docs-translation repository (https://github.com/django/django-docs-translations/tree/stable/1.10.x), and the translation process is described in https://code.djangoproject.com/wiki/TranslatingDocumentation.
I'm not against improving this toolchain (it was a bit experimental at the time) and integrating part of all of it directly inside the Django main repository, but the patch should also include functional instructions in the Django docs (How to build translated documentation).
comment:4 by , 8 years ago
Triage Stage: | Unreviewed → Accepted |
---|
comment:5 by , 8 years ago
Replying to Claude Paroz:
Currently, this is handled in the django-docs-translation repository (https://github.com/django/django-docs-translations/tree/stable/1.10.x), and the translation process is described in https://code.djangoproject.com/wiki/TranslatingDocumentation.
I'm not against improving this toolchain (it was a bit experimental at the time) and integrating part of all of it directly inside the Django main repository, but the patch should also include functional instructions in the Django docs (How to build translated documentation).
Oh. what a shame..
I didn't know about django-docs-translation repository.
You don't need doing "experimental", keep it safe.
please roll back my PR.
If this "improvement" really need it, I'll request again.
sorry again.
Claude, could you advise about this? I'm not sure if it's duplicating anything that's implemented for the djangoproject.com builds. If accepted, should we also add some docs about building the translated docs locally?
PR