Skip to content
GitLab
Menu
Projects
Groups
Snippets
Help
Help
Support
Community forum
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in / Register
Toggle navigation
Menu
Open sidebar
tails
tails
Commits
6a7995ed
Commit
6a7995ed
authored
Sep 22, 2019
by
127.0.0.1
Committed by
IkiWiki
Sep 22, 2019
Browse files
This reverts commit
7a107dd9
parent
d98ec341
Changes
1
Show whitespace changes
Inline
Side-by-side
wiki/src/blueprint/translation_platform.mdwn
View file @
6a7995ed
...
...
@@ -20,7 +20,7 @@ Terms used in this document
website relies on, in scripts often called "main repository" or "main
Git"
- 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 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
platform, while only part of them are active on the website.
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
...
...
@@ -159,7 +161,7 @@ they needed?)
Whenever a contributor modifies a markdown (`*.mdwn`) file, and pushes
to master, the corresponding POT and PO files are updated, that is: the
translatable English strings within those files are updated. This
translat
e
able English strings within those files are updated. This
update happens on the production server itself, when [[building the
wiki|contribute/build/website]] for languages that are enabled on the
production website.
...
...
@@ -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
created, then every additional language PO file needs to be updated.
On top of this, if the
PO file of the
default
lang
uage (that is, its
markdown file)
have been renamed, moved or deleted, than the PO files of
additional
languages need to follow this step.
On top of this, if the
"
defaultlang
"s PO file (and its markdown file)
have been renamed, moved or deleted, than the PO files of
additional
languages need to follow this step.
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
...
...
@@ -224,7 +226,7 @@ can try?", who or what tries it when?)
If a fast-forward is not possible then the Canonical <-> Integration
loop has something to do (XXX: What does this mean "something to do"?
A
nd how do we know it's not possible?) and we try again later to pull.
a
nd 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
context?)
...
...
@@ -237,7 +239,7 @@ handled by another script:
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
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 config
uration
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
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.
...
...
@@ -257,7 +259,7 @@ done to PO files manually, via the canonical Git repository.
Again, PO file merges are done on translation units (`msgids`).
Furthermore, we make sure via the script that Weblate has only modified
Further
e
more, we make sure via the script that Weblate has only modified
PO files; indeed we automatically reset everything else to the version
that exists in canonical.
...
...
Write
Preview
Supports
Markdown
0%
Try again
or
attach a new file
.
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment