Ajuda:Extensió:Translate/Estats dels grups de missatges

From mediawiki.org
This page is a translated version of the page Help:Extension:Translate/Message group states and the translation is 35% complete.
LanguageStats pot ser verificat per l'estat de cada grup de missatges en aquest idioma

Aquesta pàgina conté la documentació per als estats de flux de treball de grup de missatges. Imaginem que una organització està utilitzant MediaWiki amb l'extensió Translate. Ells fan servir el wiki per escriure comunicats de premsa, entre altres coses. Què fan? En primer lloc, escriuen un comunicat de premsa en un wiki, i després el fen traduïble i conviden als traductors a treballar-hi. Quan les traduccions estan llestes, es poden publicar en un altre lloc en la seva pàgina web. Però, com saber quan una traducció està a punt, o més important: revisada i corregida (vegeu la garantia de qualitat)? I si algú troba i corregeix un error i la versió publicada ha de ser actualitzada?

Aquest és el cas d'ús de la funció del flux de treball dels grups de missatges. Permet col·locar una etiqueta a un grup de missatges que indica l'estat en què es troba, igual que «traduint-se», «revisant-se», «llest» o «publicat». Això permet als diferents integrants que treballen en un comunicat de premsa exposar explícitament l'estat actual sense la necessitat d'altres mètodes de comunicació. Els traductors poden indicar quan consideren que les seves traduccions estan a punt, i els altres traductors poden veure les traduccions que ja estan publicades. L'administrador de la traducció pot comprovar periòdicament que les traduccions estan llestes i publicar-les, així com actualitzar les pàgines que ja estan publicades. Això és un flux de treball.

Setting up

By default, this feature is disabled. It must be set up in the wiki configuration (LocalSettings.php ). You need to decide what states you want to configure, and assign them colors in the hex format. In addition you can choose the user groups that can by default change the states.

Here is a sample configuration:


$wgTranslateWorkflowStates = array(
     'new' => array( 'color' => 'FF0000' ), // red
     'needs_proofreading' => array( 'color' => '0000FF' ), // blue
     'ready' => array( 'color' => 'FFFF00' ), // yellow
     'published' => array( 'color' => '00FF00' ), // green
); 

$wgGroupPermissions['translator']['translate-groupreview'] = true;

Message groups can override the global workflow states and provide their own ones. They can do more granular permission control by state level. A state can only be selected by the user groups that have the specified right.

$wgTranslateWorkflowStates = array(
     'published' => array( 'color' => 'FF0000', 'right' => 'translate-publish' )
);

$wgGroupPermissions['translationadmin']['translate-publish'] = true;

How to use

On Special:Translate the status is shown and can be changed

Once the configuration is set, both Special:LanguageStats and Special:MessageGroupStats will show a new column for the current state, and the tables can be sorted by state. The state can be changed in Special:Translate: just choose the group and language and you will see the state in the top corner of the message group description.

This state applies to a single language of a single message group, say the whole Italian translation of the translatable page "Fréttinga". In contrast, individual translation units can be accepted and whole translatable pages can be discouraged from further translation.

Automatic state changes

Since September 2012 Translate supports automatic state changes. For example, when all the messages are translated, the state changes itself to proofreading, and when all messages have been proofread, the state changes to ready.

The conditions for these changes are called transitions. Transitions can have zero or more conditions on the following variables: UNTRANSLATED, OUTDATED, TRANSLATED, PROOFREAD. Each variable represents the number of messages in that state. UNTRANSLATED variable includes the OUTDATED messages. Each variable can be compared to three values: ZERO, NONZERO and MAX. For example transition to ready state would have condition PROOFREAD is MAX. See code example below.

The state of a language of a message group will be updated whenever a translation is changed or reviewed in that language. The state transitions are matched in the declaration order. All conditions must be fulfilled for the transition to match. If no transition matches, the message group will keep its existing state.

$wgTranslateWorkflowStates = array(
	// States
	// 'ready' => ( ... ),
	'state conditions' => array(
		array( 'ready', array( 'PROOFREAD' => 'MAX' ) ),
		array( 'proofreading', array( 'TRANSLATED' => 'MAX' ) ),
		array( 'unset', array( 'UNTRANSLATED' => 'MAX', 'OUTDATED' => 'ZERO', 'TRANSLATED' => 'ZERO' ) ),
		array( 'inprogress', array( 'UNTRANSLATED' => 'NONZERO' ) ),
	)
);