docs: Crowdin + MT issue (#9620)

Co-authored-by: Dominique Eav <dominique.eav@blue-mind.net>
This commit is contained in:
domeav 2023-12-09 00:01:43 +01:00 committed by GitHub
parent d3752d227b
commit 61116e2ad6
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
2 changed files with 9 additions and 0 deletions

View file

@ -5,6 +5,7 @@ Agan
alexbdebrie alexbdebrie
Alexey Alexey
algoliasearch algoliasearch
Allez
Anshul Anshul
anshul anshul
août août
@ -185,6 +186,7 @@ Mdxjs
mdxjs mdxjs
Meilisearch Meilisearch
meilisearch meilisearch
merveilleuse
metadatum metadatum
metastring metastring
metrica metrica
@ -379,6 +381,7 @@ Vieira
Viet Viet
Vinnik Vinnik
vjeux vjeux
voir
waivable waivable
WCAG WCAG
wcag wcag

View file

@ -515,3 +515,9 @@ import CodeBlock from '@theme/CodeBlock';
.join('\n')} .join('\n')}
</CodeBlock> </CodeBlock>
``` ```
### Machine Translation (MT) issue: links/image handling
Crowdin recently rolled out some major changes to the markdown file format and now the links are treated differently than they were before. Before they were considered as tags, but now they appear as plain text. Because of these changes the plain text links are passed to the MT engine which attempts to translate the target, thus breaking the translation (for instance: this string `Allez voir [ma merveilleuse page](/ma-merveilleuse-page)` is translated `Check out [my wonderful page](/my-wonderful-page)`, and this breaks docusaurus i18n workflow as the page name should not be translated).
As of 2023 Dec.7, they are not planning to change the logic of how links are treated, so you should have this in mind if you plan to use Crowdin with MT.