summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorintrigeri <intrigeri@boum.org>2019-10-12 11:04:12 +0000
committerintrigeri <intrigeri@boum.org>2019-10-12 11:37:55 +0000
commit52ec8eb26dd048680a0d792c5782e09c7a97f3e3 (patch)
treef74c562dfb9db6281cbb4dba9f3c288edd008447
parent0f742975acbeb1a73ef64e09b3f617d1c026275c (diff)
Move translation platform ops doc under its (future) role page (refs: #15086).
-rw-r--r--wiki/src/blueprint/translation_platform.mdwn32
-rw-r--r--wiki/src/contribute.mdwn1
-rw-r--r--wiki/src/contribute/l10n_tricks.mdwn36
-rw-r--r--wiki/src/contribute/working_together/roles/translation_platform.mdwn10
-rw-r--r--wiki/src/contribute/working_together/roles/translation_platform/operations.mdwn61
5 files changed, 72 insertions, 68 deletions
diff --git a/wiki/src/blueprint/translation_platform.mdwn b/wiki/src/blueprint/translation_platform.mdwn
index e7c6c2f..9379c80 100644
--- a/wiki/src/blueprint/translation_platform.mdwn
+++ b/wiki/src/blueprint/translation_platform.mdwn
@@ -475,38 +475,6 @@ The tmserver can be queried like this [(see
http://localhost:8080/tmserver/en/de/unit/contribute
-Weblate administration
-======================
-
-- [[Enabling a new language|contribute/l10n_tricks#weblate-administration]]<br/>
- Make sure to enable languages only if they are part of our tier-1
- list or discuss the matter on the l10n-mailing list.
-
-- Sysadmin: This documentation currently still lives in
- `translate-server.git` and might be moved somewhere else in the future
- ([[!tails_ticket 15086]]).
-
-Manually fix issues
--------------------
-
-Our Weblate codebase is stored in `/usr/local/share/weblate`.
-
-If commands have to be run, they should be run as the `weblate` user;
-for example, with `sudo -u weblate COMMAND`.
-
-However, this VM is supposed to run smoothly without human
-intervention, so be careful with what you do and please document
-modifications you make so that they can be fed back to a more
-appropriate place, such as our Puppet code or this document.
-
-Reload translations from Git and cleanup orphaned checks and suggestions
-------------------------------------------------------------------------
-
-If something went wrong, we may need to ask Weblate to reload all
-translations from Git, using the following command:
-
- sudo -u weblate ./manage.py loadpo --all
-
Weblate installation and maintenance
====================================
diff --git a/wiki/src/contribute.mdwn b/wiki/src/contribute.mdwn
index ae223db..b7ec3bb 100644
--- a/wiki/src/contribute.mdwn
+++ b/wiki/src/contribute.mdwn
@@ -220,6 +220,7 @@ Collective process
- [[Sysadmins|contribute/working_together/roles/sysadmins]]
- [[Technical writers|contribute/working_together/roles/technical_writer]]
- [[Test suite maintainers|contribute/working_together/roles/test_suite]]
+ - [[Translation platform maintainers|contribute/working_together/roles/translation_platform]]
- [[UX designers|contribute/working_together/roles/ux]]
- [[Verification extension
maintainers|contribute/working_together/roles/verification_extension]]
diff --git a/wiki/src/contribute/l10n_tricks.mdwn b/wiki/src/contribute/l10n_tricks.mdwn
index f7998f1..d7dc43e 100644
--- a/wiki/src/contribute/l10n_tricks.mdwn
+++ b/wiki/src/contribute/l10n_tricks.mdwn
@@ -145,39 +145,3 @@ You can then configure it on your Poedit:
1. *Edit* → *Preferences* → *TM*
2. *Learn from files*
3. Select your newly created file (`allspanish.po` in this case)
-
-<a id="weblate-administration"></a>
-
-# Weblate administration
-
-## Enable a new language
-
-Make sure to read the [[blueprint|blueprint/translation_platform/]],
-future [[design documentation|design/translation_platform/]] before doing this.
-
-1. Add the new language code to the `exclude` setting in
- [[!tails_gitweb ikiwiki.setup]] and [[!tails_gitweb ikiwiki-cgi.setup]]
- and have this change reviewed and merged into our `master` branch.
-2. Add the new language to `$weblate_additional_languages` in
- <https://git.tails.boum.org/puppet-tails/tree/manifests/website/params.pp>
- and have a sysadmin review your changes and deploy them to production.
-3. To create PO files for the new language and commit them to Git,
- run this command on the system that runs our translation platform,
- as the `weblate` user:
-
- ~/scripts/weblate_status.py
-
- Once satisfied, run this command again with the `--modify`
- argument, so it actually performs the desired changes:
-
- ~/scripts/weblate_status.py --modify
-
- Note that this script must not be run concurrently with
- [`cron.sh`](https://git.tails.boum.org/puppet-tails/tree/files/weblate/scripts/cron.sh). Hence, they both use a shared lock file.
-4. Finally, to update the Weblate components, run this command as the
- `weblate` user:
-
- python3 /usr/local/share/weblate/manage.py \
- loadpo --all --lang <LANG>
-
- … where `<LANG>` is the newly added 2-letter language code.
diff --git a/wiki/src/contribute/working_together/roles/translation_platform.mdwn b/wiki/src/contribute/working_together/roles/translation_platform.mdwn
new file mode 100644
index 0000000..6c030c4
--- /dev/null
+++ b/wiki/src/contribute/working_together/roles/translation_platform.mdwn
@@ -0,0 +1,10 @@
+[[!meta title="Translation platform maintainers"]]
+
+XXX: fill this page with the role definition once we have one
+([[!tails_ticket 17050]]).
+
+# Resources
+
+ - [[design documentation|contribute/design/translation_platform]]
+ - [[operations documentation|translation_platform/operations]]
+ - [[documentation for translators|contribute/how/translate/with_translation_platform]]
diff --git a/wiki/src/contribute/working_together/roles/translation_platform/operations.mdwn b/wiki/src/contribute/working_together/roles/translation_platform/operations.mdwn
new file mode 100644
index 0000000..6a1a60c
--- /dev/null
+++ b/wiki/src/contribute/working_together/roles/translation_platform/operations.mdwn
@@ -0,0 +1,61 @@
+[[!meta title="Translation platform: operations documentation"]]
+
+**Note**: there is more such documentation in `translate-server.git`;
+it might be moved somewhere else in the future ([[!tails_ticket 15086]]).
+
+[[!toc levels=1]]
+
+Enable a new language
+=====================
+
+If the language you're planning to enable is part of our [[(Tier-1)
+languages|contribute/how/translate#tier-1-languages]], you may proceed.
+Else, propose this on the [[tails-l10n mailing list|about/contact#tails-l10n]].
+
+1. Add the new language code to the `exclude` setting in
+ [[!tails_gitweb ikiwiki.setup]] and [[!tails_gitweb ikiwiki-cgi.setup]]
+ and have this change reviewed and merged into our `master` branch.
+2. Add the new language to `$weblate_additional_languages` in
+ <https://git.tails.boum.org/puppet-tails/tree/manifests/website/params.pp>
+ and have a sysadmin review your changes and deploy them to production.
+3. To create PO files for the new language and commit them to Git,
+ run this command on the system that runs our translation platform,
+ as the `weblate` user:
+
+ ~/scripts/weblate_status.py
+
+ Once satisfied, run this command again with the `--modify`
+ argument, so it actually performs the desired changes:
+
+ ~/scripts/weblate_status.py --modify
+
+ Note that this script must not be run concurrently with
+ [`cron.sh`](https://git.tails.boum.org/puppet-tails/tree/files/weblate/scripts/cron.sh). Hence, they both use a shared lock file.
+4. Finally, to update the Weblate components, run this command as the
+ `weblate` user:
+
+ python3 /usr/local/share/weblate/manage.py \
+ loadpo --all --lang <LANG>
+
+ … where `<LANG>` is the newly added 2-letter language code.
+
+Manually fix issues
+===================
+
+Our Weblate codebase is stored in `/usr/local/share/weblate`.
+
+If commands have to be run, they should be run as the `weblate` user;
+for example, with `sudo -u weblate COMMAND`.
+
+However, this VM is supposed to run smoothly without human
+intervention, so be careful with what you do and please document
+modifications you make so that they can be fed back to a more
+appropriate place, such as our Puppet code or this document.
+
+Reload translations from Git and cleanup orphaned checks and suggestions
+========================================================================
+
+If something went wrong, we may need to ask Weblate to reload all
+translations from Git, using the following command:
+
+ sudo -u weblate ./manage.py loadpo --all