diff --git a/docs/xml/quickstart-translation.xml b/docs/xml/quickstart-translation.xml index b75b369e..3436b576 100644 --- a/docs/xml/quickstart-translation.xml +++ b/docs/xml/quickstart-translation.xml @@ -24,6 +24,23 @@ +
+ Selecting strings for translation + + + By default, all strings in a MetaInfo file that are in translatable elements will be marked for translation. + If you are using xgettext, itstool or any other tool that uses ITS rules + for translation, and have AppStream or AppStream's ITS rules installed, you can exclude any element from + being translated by adding a translate="no" attribute to it. + + + One special case is the description block in MetaInfo files and release metadata. In MetaInfo files, + each individual paragraph of a description (or enumerated entry) is translated individually, however you can only + exclude the complete block from being translated by adding translate="no" to the description + element. It is generally discouraged to not translate component descriptions, so please use this with care! + +
+
Translating using Itstool