From 764b4820ab543cdb76c9290d928e515e6a81a27a Mon Sep 17 00:00:00 2001 From: Duncan Dewhurst Date: Mon, 4 Mar 2024 11:22:34 +1300 Subject: [PATCH 1/3] docs/standard/translation/using_transifex.rst: Describe what not to translate --- docs/standard/translation/using_transifex.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/standard/translation/using_transifex.rst b/docs/standard/translation/using_transifex.rst index 5432bce..1a556d5 100644 --- a/docs/standard/translation/using_transifex.rst +++ b/docs/standard/translation/using_transifex.rst @@ -16,7 +16,7 @@ Translator #. Sort by "Untranslated (Descending)" #. Click on a resource with untranslated strings #. Click "Untranslated" -#. Read the English text and author the translated text +#. Read the English text and author the translated text. Do not translate words in backticks (e.g. \`title\`) or single quotes (e.g. 'open'). #. Click "Save Translation" (or press ``TAB``) #. Repeat from Step 4 #. Notify the Proofreader when strings have been translated From fb4ce06344c5756054dd7a8c62f7a0af39c4caad Mon Sep 17 00:00:00 2001 From: Duncan Dewhurst Date: Mon, 4 Mar 2024 11:29:16 +1300 Subject: [PATCH 2/3] docs/standard/translation/using_transifex.rst: Don't translate hyperlinks --- docs/standard/translation/using_transifex.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/standard/translation/using_transifex.rst b/docs/standard/translation/using_transifex.rst index 1a556d5..291d1d0 100644 --- a/docs/standard/translation/using_transifex.rst +++ b/docs/standard/translation/using_transifex.rst @@ -16,7 +16,7 @@ Translator #. Sort by "Untranslated (Descending)" #. Click on a resource with untranslated strings #. Click "Untranslated" -#. Read the English text and author the translated text. Do not translate words in backticks (e.g. \`title\`) or single quotes (e.g. 'open'). +#. Read the English text and author the translated text. Do not translate words in backticks, e.g. \`title\`, or single quotes, e.g. 'open'. When translating a hyperlink, do not translate the part in parentheses (round brackets), e.g. [translate this text](#do-not-translate-this-text). #. Click "Save Translation" (or press ``TAB``) #. Repeat from Step 4 #. Notify the Proofreader when strings have been translated From 73cb404e383fbfd96376bcd939d0471a8231fa68 Mon Sep 17 00:00:00 2001 From: James McKinney <26463+jpmckinney@users.noreply.github.com> Date: Tue, 5 Mar 2024 15:06:57 -0500 Subject: [PATCH 3/3] chore: Change instruction to admonition --- docs/standard/translation/using_transifex.rst | 13 ++++++++++++- 1 file changed, 12 insertions(+), 1 deletion(-) diff --git a/docs/standard/translation/using_transifex.rst b/docs/standard/translation/using_transifex.rst index 291d1d0..6e478f0 100644 --- a/docs/standard/translation/using_transifex.rst +++ b/docs/standard/translation/using_transifex.rst @@ -16,7 +16,18 @@ Translator #. Sort by "Untranslated (Descending)" #. Click on a resource with untranslated strings #. Click "Untranslated" -#. Read the English text and author the translated text. Do not translate words in backticks, e.g. \`title\`, or single quotes, e.g. 'open'. When translating a hyperlink, do not translate the part in parentheses (round brackets), e.g. [translate this text](#do-not-translate-this-text). +#. Read the English text and author the translated text + + .. warning:: + + Do not translate: + + - words in backticks, like \`title\` (often used for schema fields) + - words in single quotes, like 'open' (often used for codelist codes) + - relative URLs, like ``[translate this](#but-not-this)`` + + Absolute URLs (that is, starting with ``https://``) can be translated: for example, if the website offers content in multiple languages. + #. Click "Save Translation" (or press ``TAB``) #. Repeat from Step 4 #. Notify the Proofreader when strings have been translated