Extension:LocalisationUpdate/fr

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.

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 (maintainer)
Dernière version	1.4.0 (2016-10-13)
Politique de compatibilité	Le master conserve la compatibilité arrière.
MediaWiki	1.30+
Licence	Licence publique générale GNU v2.0 ou ultérieur
Téléchargement	Inclus dans le paquet des extensions de langue 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
Exemple	Wikipedia
Paramètres $wgLocalisationUpdateRepository $wgLocalisationUpdateDirectory $wgLocalisationUpdateHttpRequestOptions $wgLocalisationUpdateRepositories
Accroches utilisées LocalisationCacheRecache LocalisationCacheRecacheFallback
Traduire l’extension LocalisationUpdate sur translatewiki.net
Vérifier la matrice des utilisations et des versions.
Problèmes	Tâches ouvertes · Signaler un bogue

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.