3pp-mirror/docusaurus
1
0
Fork 0
mirror of https://github.com/facebook/docusaurus.git synced 2025-08-03 16:59:06 +02:00
Code Issues Projects Releases Packages Wiki Activity

docs: Crowdin + MT issue (#9620)

Browse source 
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
Download patch file Download diff file Expand all files Collapse all files

6
website/docs/i18n/i18n-crowdin.mdx
View file

@ -515,3 +515,9 @@ import CodeBlock from '@theme/CodeBlock';
.join('\n')}
</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.