Help:Glossaries/id

Glosarium atau daftar istilah sangatlah penting bagi pengguna dan penerjemah. Glosarium memberikan definisi istilah-istilah yang digunakan oleh ekstensi dan oleh dokumentasi terkait secara tepat dan rapi. Dengan membaca glosarium, seorang pengguna bisa memahami istilah-istilah yang digunakan, dan seorang penerjemah bisa memikirkan istilah yang serupa dalam bahasa yang berbeda dari bahasa yang sedang dibaca (di wiki ini, bahasa Inggris).

Halaman ini mendaftarkan praktik terbaik yang sebaiknya digunakan di glosarium di mediawiki.org.

Praktik terbaik
Glosarium harus mudah dipelihara, mudah diterjemahkan, dan tentu saja mudah dibaca khususnya berkenaan dengan aksesibilitas.

Halamannya sebaiknya dibuat dengan desain yang umum, agar mudah apabila nanti perlu ditingkatkan. Kami menghindari penggunaan templat yang juga membutuhkan dokumentasi, pemeliharaan, dan terkadang bermasalah ketika berkenaan dengan penerjemahan RTL/LTR.

Penerjemahan harus bisa dan mudah dilakukan. Add terms that are not the equivalent of the official terms used of synonyms must be possible. Polishing a term to use the best English word, is less useful than work on the definition itself. The definition is the most important thing because it will allow translators to find an equivalent and accurate term in their language.

Definitions are standardized by W3C as "descriptions lists" or "definition lists". MediaWiki implements definition lists. Using such definition lists will structure data a minima and increase accessibility.

When you create a glossary, sort the terms that are the most important and used, first. Alphabetical order in English will not be an alphabetical order in another language.

Define a term
The most simple case is when you have a term and its definition:

Rendered as:


 * Term to define
 * Definition

Add synonyms
Synonyms are terms that are not the official term, but that can be used by people or in certain cases. There is no standard to add synonyms to a definition list. We are using the best equivalent we have found: add a definition, and label it as "also known as", and format it differently:

Rendered as:


 * Term to define
 * Also known as other term
 * Definition

The synonyms line is identified by italics, and synonymous terms are in bold to have a visual equivalent of the primary term. On text browsers, that will highlight the synonym.

It is possible to have multiples synonyms, separated by commas.

Add a second definition
It is possible to add a second definition:

Rendered as:


 * Term to define
 * Definition
 * Other definition

However, having two definitions for one term may be a source of confusion. Plus, a term in one language that has two meanings, may need two separated terms in another language.

Mark for translation
See also: 

Translate tags will allow people to translate the page. All components must be translated.

;Term to define :    :Definition

Translation for the synonyms line is done as one line, not as separated terms. This allows an easy translation for RTL languages and simplifies the addition of more synonymous terms.

The following task is only possible when the page has been marked for translations:

To encourage translators to add words used in their language, each translation item related to synonyms (the "qqq" message) must be documented with, which displays the following message: