Translation: Issues with downloading files from Crowdin

[max-re]

After creating a PR to move translated/changed files from Crowdin to here (see #1178), I have noticed multiple issues with the downloading process that I would like to list here. This is relevant for PR #1061.

1. Download translated files in a zip archive: This downloads only some files, not all. One has to manually download the missing files (only 21/37 files).
2. Some downloaded files (in the zip archive) may not include recent changes.
3. In one file, double spaces were added between strings.
4. Crowdin seems that it can't handle some special constructions correctly (e.g. it is not omitting part of a string). on Crowdin: English file: please <0>}}">click here</0>. German file: möchten, <0>}}">klicken Sie bitte hier</0>. downloaded file: English: please <a href="{{< relref "/become-a-sponsor" >}}">click here</a>.</div> German: möchten, <a href="{{< relref ">}}">klicken Sie bitte hier</a>.</div>
5. A linebreak may be inserted before > }} which causes the CI build to break (see commit b278f5b
6. The file allow-port-80.md is outside the folder content.

Surely, this is a Crowdin issue and might be resolved by filing a bug report with them, which I might do (or rather someone of the managers of the translation project on Crowdin). I do, however, consider this relevant for all translations here (and it is a known issue, according to @tdelmas).

[max-re]

Hi @tdelmas, are there any updates? I tried to get the latest translations from Crowdin but the same issues persist, making this process a bit tiresome.

[tdelmas]

@max-re thank you for the update, here is a summary of the current situation:

1. Download translated files in a zip archive: This downloads only some files, not all. One has to manually download the missing files (only 21/37 files).

I think it's because it only downloads fully translated pages. (That's the expected behaviour)

2. Some downloaded files (in the zip archive) may not include recent changes.

Before downloading, there is a "build" button.

3. In one file, double spaces were added between strings.

Crowdin does split files in sentences and put them together again, some spacing may be different, that shouldn't impact the rendering.

4. Crowdin seems that it can't handle some special constructions correctly (e.g. it is not omitting part of a string).

Some macros were updated to avoid that. If should happen less now. (Please to tell when you encounter the problem)

5. A linebreak may be inserted before > }} which causes the CI build to break

It's still a problem...

6. The file allow-port-80.md is outside the folder content.

In Crowdin it's now in content/docs as it should.

If you have any suggestion to make the update process less tiresome?

Thank you again for your help and the detailed issue!