Commit 6a7995ed authored by 127.0.0.1's avatar 127.0.0.1 Committed by IkiWiki
Browse files

This reverts commit 7a107dd9

parent d98ec341
...@@ -20,7 +20,7 @@ Terms used in this document ...@@ -20,7 +20,7 @@ Terms used in this document
website relies on, in scripts often called "main repository" or "main website relies on, in scripts often called "main repository" or "main
Git" Git"
- Production server: the server that hosts our website - Production server: the server that hosts our website
- translate.lizard: the VM that hosts our Weblate web interface, the - translate.lizard: the VM that hosts our Weblate webinterface, the
corresponding Git repositories, as well as the staging website. corresponding Git repositories, as well as the staging website.
[Corresponding tickets on Redmine](https://redmine.tails.boum.org/code/projects/tails/issues?query_id=321) [Corresponding tickets on Redmine](https://redmine.tails.boum.org/code/projects/tails/issues?query_id=321)
...@@ -77,7 +77,9 @@ thus approved translations of all languages enabled on the Weblate ...@@ -77,7 +77,9 @@ thus approved translations of all languages enabled on the Weblate
platform, while only part of them are active on the website. platform, while only part of them are active on the website.
Each PO file corresponds to a single component in Weblate, in order to Each PO file corresponds to a single component in Weblate, in order to
appear in the Weblate interface. For example, the component: appear in the Weblate interface.
For example, the component:
wiki/src/support.*.po wiki/src/support.*.po
...@@ -159,7 +161,7 @@ they needed?) ...@@ -159,7 +161,7 @@ they needed?)
Whenever a contributor modifies a markdown (`*.mdwn`) file, and pushes Whenever a contributor modifies a markdown (`*.mdwn`) file, and pushes
to master, the corresponding POT and PO files are updated, that is: the to master, the corresponding POT and PO files are updated, that is: the
translatable English strings within those files are updated. This translateable English strings within those files are updated. This
update happens on the production server itself, when [[building the update happens on the production server itself, when [[building the
wiki|contribute/build/website]] for languages that are enabled on the wiki|contribute/build/website]] for languages that are enabled on the
production website. production website.
...@@ -202,9 +204,9 @@ we've previously defined as a default language. If the actual POT file, ...@@ -202,9 +204,9 @@ we've previously defined as a default language. If the actual POT file,
generated on the production server differs from the POT file we've just generated on the production server differs from the POT file we've just
created, then every additional language PO file needs to be updated. created, then every additional language PO file needs to be updated.
On top of this, if the PO file of the default language (that is, its On top of this, if the "defaultlang"s PO file (and its markdown file)
markdown file) have been renamed, moved or deleted, than the PO files of have been renamed, moved or deleted, than the PO files of additional
additional languages need to follow this step. languages need to follow this step.
Finally, the script will test if the new commit has triggered any change, Finally, the script will test if the new commit has triggered any change,
(XXX: I don't understand what "the new commit" is here, can you please (XXX: I don't understand what "the new commit" is here, can you please
...@@ -224,7 +226,7 @@ can try?", who or what tries it when?) ...@@ -224,7 +226,7 @@ can try?", who or what tries it when?)
If a fast-forward is not possible then the Canonical <-> Integration If a fast-forward is not possible then the Canonical <-> Integration
loop has something to do (XXX: What does this mean "something to do"? loop has something to do (XXX: What does this mean "something to do"?
And how do we know it's not possible?) and we try again later to pull. and how do we know it's not possible?) and we try again later to pull.
(XXX: What is this triggered by? What does "later" mean in this (XXX: What is this triggered by? What does "later" mean in this
context?) context?)
...@@ -237,7 +239,7 @@ handled by another script: ...@@ -237,7 +239,7 @@ handled by another script:
There may be other scripts (XXX: like what?), that may update the master There may be other scripts (XXX: like what?), that may update the master
branch of Weblate repo besides our script, that's why the script is branch of Weblate repo besides our script, that's why the script is
using an own Git remote named "cron" (XXX: is this information using an own Git remote named "cron" (XXX: is this information
up-to-date? I cannot find it in the script. If this is a configuration up-to-date? I cannot find it in the script. If this is a config
variable, let's make it clear. I also don't understand what this own Git variable, let's make it clear. I also don't understand what this own Git
remote is, where does it come from, is it up-to-date?) to keep track of which commits need to remote is, where does it come from, is it up-to-date?) to keep track of which commits need to
be scanned (XXX: scanned, really?) for Weblate component changes. be scanned (XXX: scanned, really?) for Weblate component changes.
...@@ -257,7 +259,7 @@ done to PO files manually, via the canonical Git repository. ...@@ -257,7 +259,7 @@ done to PO files manually, via the canonical Git repository.
Again, PO file merges are done on translation units (`msgids`). Again, PO file merges are done on translation units (`msgids`).
Furthermore, we make sure via the script that Weblate has only modified Furtheremore, we make sure via the script that Weblate has only modified
PO files; indeed we automatically reset everything else to the version PO files; indeed we automatically reset everything else to the version
that exists in canonical. that exists in canonical.
......
Supports Markdown
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment