Extension:LocalisationUpdate/fr

From mediawiki.org
Jump to navigation Jump to search
This page is a translated version of the page Extension:LocalisationUpdate and the translation is 100% complete.
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
OOjs UI icon advanced-invert.svg
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

Readme
Exemple Wikipedia
  • $wgLocalisationUpdateRepository
  • $wgLocalisationUpdateDirectory
  • $wgLocalisationUpdateHttpRequestOptions
  • $wgLocalisationUpdateRepositories
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

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.
  • Yes 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