[Django] #27401: need Transifex config file for docs
Django
-------------------------------------+-------------------------------------
Reporter: Jeho, | Owner: nobody
Sung |
Type: | Status: new
Uncategorized |
Component: | Version: master
Documentation |
Severity: Normal | Keywords: transifex, document
Triage Stage: | Has patch: 1
Unreviewed |
Needs documentation: 0 | Needs tests: 0
Patch needs improvement: 0 | Easy pickings: 0
UI/UX: 0 |
-------------------------------------+-------------------------------------
It need Transifex config for docs/
tx pull -l <LANG>
LANGUAGE=<LANG> make html
--
Ticket URL: <https://code.djangoproject.com/ticket/27401>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.
Django
-------------------------------------+-------------------------------------
Type: Uncategorized | Status: new
Component: Documentation | Version: master
Severity: Normal | Resolution:
Keywords: transifex, document | Triage Stage:
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------
* Attachment "patch.diff" added.
Django
-------------------------------------+-------------------------------------
Reporter: Jeho, Sung | Owner: nobody
Component: Documentation | Version: master
Severity: Normal | Resolution:
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------
* type: Uncategorized => New feature
Old description:
> It need Transifex config for docs/
>
> tx pull -l <LANG>
> LANGUAGE=<LANG> make html
New description:
It need Transifex config for docs/
tx pull -l <LANG>
LANGUAGE=<LANG> make html
--
Comment:
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?
[https://github.com/django/django/pull/7450 PR]
--
Ticket URL: <https://code.djangoproject.com/ticket/27401#comment:1>
Django
-------------------------------------+-------------------------------------
Reporter: Jeho, Sung | Owner: nobody
Type: New feature | Status: new
Component: Documentation | Version: master
Severity: Normal | Resolution:
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------
Comment (by Jeho, Sung):
Replying to [comment:1 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?
>
> [https://github.com/django/django/pull/7450 PR]
sorry for my pool english, I try to explain.
this configuration is integrate with transifex service.
1. contributors(yes, they need to register at `django-docs` on transifex)
can `pull docs/locale/<lang>/LC_MESSAGES/` anytime.
2. contributors can build docs locally, and check it.
3. contributors can upload `.po` file by `tx push` in command line
environment
4. contributors can check warning by local build
5. and yes, it need to some modify on `README` and `Makefile`
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,
--
Ticket URL: <https://code.djangoproject.com/ticket/27401#comment:2>
Django
-------------------------------------+-------------------------------------
Reporter: Jeho, Sung | Owner: nobody
Type: New feature | Status: new
Component: Documentation | Version: master
Severity: Normal | Resolution:
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 1
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------
* needs_better_patch: 0 => 1
Comment:
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).
--
Ticket URL: <https://code.djangoproject.com/ticket/27401#comment:3>
Django
-------------------------------------+------------------------------------
Type: New feature | Status: new
Component: Documentation | Version: master
Severity: Normal | Resolution:
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 1
Easy pickings: 0 | UI/UX: 0
-------------------------------------+------------------------------------
* stage: Unreviewed => Accepted
--
Ticket URL: <https://code.djangoproject.com/ticket/27401#comment:4>
Django
-------------------------------------+------------------------------------
Reporter: Jeho, Sung | Owner: nobody
Type: New feature | Status: new
Component: Documentation | Version: master
Severity: Normal | Resolution:
Has patch: 1 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 1
Easy pickings: 0 | UI/UX: 0
-------------------------------------+------------------------------------
Comment (by Jeho, Sung):
Replying to [comment:3 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.
--
Ticket URL: <https://code.djangoproject.com/ticket/27401#comment:5>