Opened 18 months ago
Last modified 18 months ago
#27401 new New feature
Add Transifex config to build translated docs
Reported by: | Jeho, Sung | Owned by: | nobody |
---|---|---|---|
Component: | Documentation | Version: | master |
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)
Changed 18 months ago by
Attachment: | patch.diff added |
---|
comment:1 follow-up: 2 Changed 18 months ago by
Description: | modified (diff) |
---|---|
Summary: | need Transifex config file for docs → Add Transifex config to build translated docs |
Type: | Uncategorized → New feature |
comment:2 Changed 18 months ago by
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,
comment:3 follow-up: 5 Changed 18 months ago by
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 Changed 18 months ago by
Triage Stage: | Unreviewed → Accepted |
---|
comment:5 Changed 18 months ago by
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