Jump to content

Project:Terminology gadget/acm

From translatewiki.net
This page is a translated version of the page Project:Terminology gadget and the translation is 23% complete.
شنو يصير إذا تحرك مؤشر الماوس على مصطلح اله تعريف باستخدام أداة المصطلحات.

تخلي أداة المصطلحات المترجمين يخزنون الترجمات وملاحظات الاستخدام في مكان مركزي ، وتطلع ذيج الترجمات وملاحظات الاستخدام للمترجمين من يترجمون. راح تطلع المصطلحات اللي الها تعريف بلون خلفيه مختلف في رسالة المصدر بالإنكليزي، مما ينطي دليل مرئي للمترجمين أن اكو هناك تعريف في لغتهم لهاذ المصطلح.

يتم تمكين الأداة الذكية للكل افتراضيًا ؛ إذا جنت تريد تطفيه، تكدر تسوي هيج عن طريق زيارة "Gadgets" في تفضيلاتك.

الخلفيه

The impetus for creating this gadget came from talks during the Arctic Knot Conference 2021, where some users mentioned the difficulty of translating certain terms into smaller languages. Some languages may not have words for certain technical terms that are used a lot in MediaWiki, like "file" or "category". Because of this, they may need to discuss what word they should use for those terms – and even if they come to a conclusion, the next person who translates wouldn't necessarily know what to use when translating the same term if they aren't aware of the previous discussion.

The need for consistent terminology isn't only limited to smaller languages, however. All languages can have multiple translations for the same terms in English, and staying consistent within the same context is always an advantage.

شلون تشتغل

The gadget works on the English source messages, and scans them for terms that have been defined for the current language. If it finds any, it marks the term with a background color according to the legend. If you hover one of these terms, you will be shown the translation and, if they exist, the usage notes that have been defined for that term. You will also see a menu icon that you can click to edit the definition, or start a discussion about it.

When you add or edit a term, the definition will be saved to a subpage of your language's portal called terminology.json. See Portal:Nb/terminology.json and Portal:Sms/terminology.json for a couple of examples, or try this search for a full list of terminology pages. These JSON pages are not meant to be edited manually, but it's possible when absolutely necessary.

When editing the "translation" or "usage notes" field, you can use full wiki syntax – you can even use parser functions and templates if necessary.

"إعادة توجيه اللغات"

It is possible to set an entire language code to redirect to another. This can be useful in cases of language variants where the terminology used should be shared between several variants. For example, the language codes de (German) and de-ch (Swiss German) should probably share the same terminology, so de-ch could be set as a redirect to de.

For languages with variant redirects, you can use the special "magic word" $VARIANT in the translation and usage notes field in the gadget, if you wish to show or highlight different things for different variants.

دوس حتى تطلع تفاصيل فنيه
إعادة توجيه اللغه

In order to set a language as a redirect to another, its terminology.json page should look like this (in the JSON data page):

{
	"@redirect": "<span lang="en" dir="ltr" class="mw-content-ltr">target language code</span>"
}
مثال على $VARIANT

Let's say de-ch redirects to de. The translation for "file size" is "Dateigröße" in de and "Dateigrösse" in de-ch. In order to reflect this in the terminology gadget, you could do something like this (within the definition, usage notes or discussions about that term, using the MediaWiki syntax):

{{#switch:$VARIANT
| de-ch = Dateigrösse
| #default = Dateigröße
}}

This could be turned into a template for more efficiency, just remember to pass $VARIANT as a parameter to the template.

For some real-life examples, see how {{tgzh}} is used in Portal:Zh/terminology.json (which has the variants zh-hans, zh-hant, and zh-hk defined as redirects).

Other languages with variants defined as redirects include Portal:Es/terminology.json, Portal:Hu/terminology.json, and Portal:Nl/terminology.json for their “formal” or “informal” variants.

Most often, there's a default variant and sometimes there's no distinction with the base language because they are simple aliases. For example the variant Portal:De-formal/terminology.json is redirected to Portal:De/terminology.json, which does not distinguish that “formal” variant from the base language in its definitions and notes.

Legend

  • Term – terms marked like this have a translation saved for the current language.
  • Term – terms marked like this have usage notes attached to them.

Term – terms marked like this are under discussion on the language's portal talk page. They may also already have a translation and usage notes attached.


Source code

The source code for the gadget is at MediaWiki:Gadget-terminology.js, with some additional CSS at MediaWiki:Gadget-terminology.css.

Feedback

If you have any feedback, comments or bug reports regarding the gadget, please post them on the talk page.