Closed
Milestone
Nov 18, 2024–Dec 20, 2024
[docs] Parser setup
- Defining what are the sending for translation and how translators will receive the scoped content.
- Filtering setup configed by Argo when working on the Argo-Clone roundtrip testing mielstone: docs-site-localization#35 (closed) . Verbatim from the issue description:
Filter Configuration Insights
- Segmentation for markdown files (e.g., debian.md) looks perfect with the applied settings (see screenshot in comment)
- GitLab markdown is related to GitHub markdown, with some differences noted in the documentation.
- Disabling "Import code blocks" prevents content inside triple backticks from being translatable.
- Enabling "Exclude code elements" places links and single backtick content inside placeholder tags, which can be edited if needed in the Phrase UI.
- Additional tests were run successfully (MANPHR-5 and MANPHR-6).
Specific Concerns Addressed ⚠️
- URLs: Can be modified as tags in Phrase.
- Code lines/blocks: Either fully translatable or not translatable. Recommendation is to leave them untranslatable in most cases.
- Tables: Filtered correctly, allowing all rows and column strings to be translatable
-
Code blocks:
- Generally recommended to be left untranslatable to avoid technical errors due to over-localization
- If translation of comments in code blocks is necessary, filter settings would need to be adjusted.
Loading
Loading
Loading
Loading