Extension:LocalisationUpdate/fr

**Manuel des extensions MediaWiki**
LocalisationUpdate; État de la version : stable
Implémentation	Base de données
Description	Permet de conserver les messages traduits le plus à jour possible
Auteur(s)	Tom Maaswinkel (12wiki), Niklas Laxström
Dernière version	1.4.0 (2016-10-13)
MediaWiki	1.30+
Composer	mediawiki/localisation-update
Licence	Licence publique générale GNU v2.0 ou ultérieur
Téléchargement	Télécharger l'extension ; Git [?]: Télécharger la branche master de Git; parcourir le dépôt (GitHub); historique des validations (commits); contributeurs du dépôt (GitHub); relecture du code; ; Readme
	Paramètres $wgLocalisationUpdateRepository; $wgLocalisationUpdateDirectory; $wgLocalisationUpdateHttpRequestOptions; $wgLocalisationUpdateRepositories;
	Accroches utilisées LocalisationCacheRecache; LocalisationCacheRecacheFallback;
	Traduire l’extension LocalisationUpdate sur translatewiki.net si elle y est disponible
	Vérifier la matrice des utilisations et des versions.
Problèmes	Tâches ouvertes · Signaler un bogue

This page is a translated version of the page Extension:LocalisationUpdate and the translation is 100% complete.

Other languages:

Cette extension est fournie avec MediaWiki 1.21 et supérieur. Ainsi vous n'avez pas besoin de la télécharger à nouveau. Néanmoins, vous devez encore suivre les autres instructions fournies.

L'extension LocalisationUpdate permet de mettre à jour la traduction des messages de MediaWiki à tout instant, sans avoir à recharger le logiciel MediaWiki.

Installation

Téléchargez et placez le(s) fichiers (s) dans un répertoire appelé LocalisationUpdate dans votre dossier extensions/.

Ajoutez le code suivant à la fin de votre fichier LocalSettings.php :

wfLoadExtension( 'LocalisationUpdate' );
$wgLocalisationUpdateDirectory = "$IP/cache";

Créez un dossier cache dans le répertoire d'installation et assurez-vous que le serveur à le droit d'y écrire.
Fait – Accédez à Special:Version sur votre wiki pour vérifier que l'extension a bien été installée.

Configuration

$wgLocalisationUpdateDirectory

Dossier dans lequel iront les fichiers en cache, s'il n'est pas initialisé, on utilise par défaut $wgCacheDirectory . LocalisationUpdate nécessite un emplacement où stocker les fichiers afin de pouvoir fonctionner ; si ni $wgLocalisationUpdateDirectory ni $wgCacheDirectory ne sont initialisés, le script update.php LocalisationUpdate ne fonctionnera pas.

$wgLocalisationUpdateDirectory est mis à false par défaut.

$wgLocalisationUpdateRepository

Source de dépôt par défaut pour récupérer la traduction. GitHub est le dépôt initialisé par défaut. Ceci est ajouté avec la version 1.1.

$wgLocalisationUpdateRepositories

Tableau des URLs des dépôts à partir desquels récupérer les traductions pour le noyau MediaWiki et les extensions. Par défaut, la valeur est celle des dépôts Git MediaWiki de GitHub (à ne pas modifier, sauf si vous ne savez pas ce que vous faites). Ceci est ajouté avec la version 1.1.

Exemple pour l'utilisation de gitHub

$wgLocalisationUpdateRepositories['github'] = array(
	'mediawiki' =>
		'https://raw.github.com/wikimedia/mediawiki/master/%PATH%',
	'extension' =>
		'https://raw.github.com/wikimedia/mediawiki-extensions-%NAME%/master/%PATH%',
	'skin' =>
		'https://raw.github.com/wikimedia/mediawiki-skins-%NAME%/master/%PATH%'
);

Exemple de configuration pour le système de fichiers local

$wgLocalisationUpdateRepositories['local'] = array(
	'mediawiki' =>
		'file:///resources/projects/mediawiki/master/%PATH%',
	'extension' =>
		'file:///resources/projects/mediawiki-extensions/extensions/%NAME%/%PATH%',
	'skin' =>
		'file:///resources/projects/mediawiki-skins/skins/%NAME%/%PATH%'
);

$wgLocalisationUpdateHttpRequestOptions

Version de MediaWiki :

≥ 1.35

Options à passer à Http::get(). Clés possibles pour le tableau : (voir HttpRequestFactory::create()).

timeout: Durée en secondes ou valeur par défaut
connectTimeout: Temporisation pour la connexion, en secondes (curl uniquement) ou valeur par défaut
postData: Tableau de paires clé/valeur, ou une donnée codée sous forme d'URL
proxy: Proxy à utiliser. Sinon $wgHTTPProxy sera utilisé (s'il est initialisé). Dans le cas contraire ce sera la variable d'environnement « http_proxy » (si elle est initialisée)
noProxy: N'utilisez aucun proxy du tout. Prévaut sur la/les valeur(s) de proxy.
sslVerifyHost: Vérifie le nom de l'hôte par rapport au certificat
sslVerifyCert: Vérifier le certificat SSL
caInfo: Fournit l'information CA (Certificate Authority)
maxRedirects: Nombre maximum de redirections à suivre (par défaut : 5)
followRedirects: Indique s'il faut suivre les redirectons (false par défaut) Note: ceci ne doit être utilisé que si l'URL cible est fiable, afin d'éviter les attaques des services intranet avec HTTP.
userAgent: Un agent utilisateur, si vous souhaitez réécraser la valeur par défaut MediaWiki/$wgVersion
logger: Une instance \Psr\Logger\LoggerInterface pour tracer les informations de débogage
username: Nom d'utilisateur pour l'authentification HTTP de base
password: Mot de passe pour l'autentification HTTP de base
originalRequest: Les informations concernant la requête originale (en tant qu'objet WebRequest, ou un tableau associatif avec l'adresse IP et l'agent utilisateur).

Exemple utilisant GitHub avec l'authentification HTTP basique

$wgLocalisationUpdateHttpRequestOptions = array(
	'followRedirects' => true,
	'username' => 'YOUR_GITHUB_USERNAME',
	'password' => 'YOUR_GITHUB_PERSONAL_ACCESS_TOKEN'
);

Utilisation

Lorsque vous voulez exécuter une mise à jour, entrez php extensions/LocalisationUpdate/update.php sur la ligne de commande, ou enregistrez une tâche cron.

LocalisationUpdate ne met pas à jour les traductions automatiquement

Si vous utilisez un system de type Unix, vous devez ajouter LocalisationUpdate à la crontab :

crontab -e
# Add the following line
@daily php /path/to/your/wiki/extensions/LocalisationUpdate/update.php --quiet

Si la mise à jour des traductions semble ne pas se faire, vous devrez éventuellement exécuter php maintenance/rebuildLocalisationCache.php --force.

Paramètres de script

--repoid: Rechercher les traductions sur les dépôts identifiés par ce paramètre

Voir aussi

Internationalisation
Détails techniques concernant la manière dont ceci est fait dans les projets Wikimedia.

This extension is included in the following packages and/or wiki farms:

LocalisationUpdate État de la version : stable
Implémentation	Base de données
Description	Permet de conserver les messages traduits le plus à jour possible
Auteur(s)	Tom Maaswinkel (12wiki), Niklas Laxström
Dernière version	1.4.0 (2016-10-13)
MediaWiki	1.30+
Composer	mediawiki/localisation-update
Licence	Licence publique générale GNU v2.0 ou ultérieur
Téléchargement	Télécharger l'extension Git ^[?]: Télécharger la branche master de Git parcourir le dépôt (GitHub) historique des validations (commits) contributeurs du dépôt (GitHub) relecture du code Readme
Paramètres $wgLocalisationUpdateRepository $wgLocalisationUpdateDirectory $wgLocalisationUpdateHttpRequestOptions $wgLocalisationUpdateRepositories
Accroches utilisées LocalisationCacheRecache LocalisationCacheRecacheFallback
Traduire l’extension LocalisationUpdate sur translatewiki.net si elle y est disponible
Vérifier la matrice des utilisations et des versions.
Problèmes	Tâches ouvertes · Signaler un bogue