Wikibase/Installation/Advanced configuration/fr

Introduction
Cette page décrit les paramètres avancés pour le client Wikibase et le dépôt. Si Wikibase n'est pas encore installé, consultez d'abord les instructions d'installation.

Faire des modifications dans les configurations du client et du dépôt implique qu'il faut ajouter ou modifier ou les lignes de  (respectivement) dans le fichier  de MediaWiki. Ce document ne couvre que quelques options; pour une liste exhaustive, consulter la documentation complète (valeurs par défaut : et  ).

Notez que le prefix wg de est distinct de celui des autres extensions, qui peuvent utiliser le préfixe. La différence est importante; votre configuration va échouer si vous utilisez un préfixe différent.

Les paramètres que vous définissez dans prévalent sur ceux qui ont été trouvés dans les fichiers mentionnés ci-avant. Placez à la fin de votre fichier, les paramètres que vous voulez redéfinir.

Exemple :

La ligne ci-dessus initialise le parameter  du dépôt Wikibase (car  ) à la valeur.



Utiliser uniquement le client ou le dépôt
Dans certaines circonstances vous pouvez utiliser uniquement le client ou le dépôt de code seul.



Dépôt uniquement
Les versions 1.36 et plus récentes utilisent l'enregistrement des extensions :

Utilisez l'extrait de code ci-dessous uniquement si votre version est antérieure à la 1.36 :

Ces configurations supposent que vos préfixes interwiki sont  et. Ajuster en fonction des besoins.

Notez que englobe tous les paramètres du dépôt Wikibase. Voir les valeurs par défaut dans Wikibase.default.php.



Client uniquement
Versions 1.36 et supérieures, utiliser l'enregistrement des extensions :

Pour un client wiki d'une autre langue telle que Farsi, changez la valeur de siteGlobalID en :

Utilisez l'extrait de code ci-dessous uniquement si votre version est antérieure à la 1.36 :

Vous pouvez également consulter la description officielle complète des options de configuration.

Notez que englobe tous les paramètres du client Wikibase. Voir les valeurs par défaut dans WikibaseClient.default.php.



Dépôt Wikibase


Définir les liens pour les identifiants externes
Pour ajouter les liens des identifiants externes dans l'interface principale (comme montré dans cet exemple Wikidata Q85#P214 et le paramètre P214#P1630):
 * 1) Créer une propriété de type String (tout comme la propriété formatter URL dans Wikidata). La propriété que nous créons dans cette étape sera utilisée pour enregistrer le formateur de liens dans les autres propriétés (par exemple utilisation de formatter URL dans VIAF ID). Les propriétés qui utilisent cette propriété doivent être du type External identifier.
 * 2) Récupérer l'ID de la propriété créée à l'étape précédente (c'est à dire  ).
 * 3) Configurer dans   :
 * 4) Si l'ajout du paramètre ne fonctionne pas tout seul, exécutez la commande suivante
 * 5) Maintenant les utilisateurs disposent de cette propriété (  dans l'exemple ci-desus) dans les propriétés dont le type est External Identifier. La valeur doit contenir   dans le formateur d'URL  (comme  ),   sera ensuite remplacé par l'identifiant fourni dans les éléments qui utilisent la propriété que nous initialisons dans l'option.

Les URIs canoniques peuvent être configurés de manière similaire dans les vidages RDF (préfixes wdtn:, psn:, pqn:, prn:), comme indiqué dans Wikidata avec la propriété P1921 et utilisé dans la propriété P214#P1921). La configuration est similaire au paramètre.



propertyOrderUrl
propertyOrderUrl permet de personnaliser le classement des propriétés en utilisant la fonction LUA  comme expliqué dans le Manuel de l'interface

statementSections
statementSections &mdash; permet à l'administrateur Wikibase de personnaliser l'affichage des déclarations et le groupement dans Wikibase.

Dans LocalSettings.php, définir  avec des sections séparées pour chaque wiki de votre instance. Pour les identifiants et les contraintes, vous pouvez définir un  qui filtre certains éléments hors de leur propre section.

Les options de syntaxe pour  et   sont :
 * &mdash; aucun élément n'est placé dans une section séparée
 * &mdash; les éléments avec le ou les types de données spécifiés apparaissent dans une section distincte
 * &mdash; spécifier le ou les types à filtrer
 * &mdash; éléments avec la ou les propriétés spécifiées apparaissent dans une section distincte
 * &mdash; spécifier la ou les propriétés à filtrer

Par exemple, pour répliquer la manière dont Wikidata sépare les identifiants externes du reste des propriétés, déclarez : Vous pouvez personnaliser le nom du libellé en utilisant la page.

Voir aussi :
 * Billet Phabricator pour la déclaration des sections
 * Configuration propre à Wikidata
 * Exemple du dépôt de code Wikibase



Options de configuration disponibles
Tous les paramètres de configuration disponibles sont décrits dans le document de configuration principal.



Scripts de maintenance
Wikibase fournit quelques scripts de maintenance dans le dossier. Wikibase doit être installé dans le répertoire des extensions MediaWiki. S'il a été installé ailleurs vous pouvez initialiser la variable d'environnement avec le chemin de votre installation MediaWiki et les scripts l'utiliseront.

Dépôt
Manière commune d'initialiser l'environnement pour les scripts appelés par les tâches en cron :

populateSitesTable.php
Ce script va charger la matrice du wiki de meta.wikimedia.org et utiliser cette information pour populer la table locale. Cela fournit à Wikibase les informations dont il a besoin pour se connecter aux autres wikis, pour par exemple faire des suggestions ou normaliser le titre des pages lorsque vous créez des liens de site.

Dans le dossier d'installation MediaWiki, exécutez :

Pour insérer un nouveau client Wikibase sans utiliser la matrice du wiki, voir le manuel de la Table des sites.

dispatchChanges.php
Ce script met à jour le cache local des éléments du wiki client.

1. Fournir au script les informations nécessaires à propos des bases de données du wiki client.

LocalSettings.php:

2. Exécuter le script de distribution des modifications.

Notez que ce script réalise la synchronisation; le dépôt et le client resteront synchronisés tant que ce script s'exécutera.

pruneChanges.php
Ce script vous permet d'élaguer la table des modifications Wikibase. S'il est exécuté sans paramètres, il supprime toutes les modifications faites il y a plus de 7 jours. Vous pouvez spécifier le drapeau  pour les périodes ayant une autre longueur :



Fonctionnalités et utilisation
Après que Wikibase soit installé,les liens inter-langues sont récupérés automatiquement à partir du dépôt et ajoutés aux pages des wikis clients tant que le script qui réalise le balayage reste en cours d'exécution. L'extension trie les liens ensuite (comme défini par le wiki local), les affiche et les enregistre dans la base de données exactement comme ils sont définis sur la page. L'extension est robuste et elle conserve les liens existants lorsque le wiki central n'est plus en ligne.

Par défaut l'extension fonctionne uniquement dans l'espace de noms principal, mais vous pouvez en changer en utilisant l'option de configuration des espaces de noms.



Avoir des liens Wikidata et des liens locaux
L'extension n'impacte pas la manière dont les liens inter-langues travaillent; ils peuvent être utilisés en parallèle avec l'extension. Il existe plusieurs cas :


 * Les liens vers les pages dont les espaces de noms ne sont pas configurés pour utiliser l'extension fonctionneront comme si l'extension n'avait pas été installée.
 * Si vous souhaitez ajouter des liens en plus de ceux actuellement enregistrés dans Wikidata, ajoutez-les simplement en wikicode; vos liens seront affichés ensemble avec ceux de Wikidata.
 * Pour exclure un ou plusieurs liens Wikidata, utilisez noexternallanglinks avec la ou les langues souhaitées. Les autres liens continueront à fonctionner normalement.
 * Pour remplacer un ou plusieurs liens Wikidata, utilisez noexternallanglinks et ajoutez les nouveaux liens en wikicode.
 * Pour arrêter tous les liens Wikidata d'un seul coup, utilisez uniquement noexternallanglinks. Les liens que vous fournissez fonctionneront comme si l'extension n'était pas installée.

noexternallanglinks
est un mot magique et une fonction d'analyse syntaxique qui peut désactiver cette extension sur une page donnée, ou supprimer certains des liens interlangue produits par l'extension.

Si utilisé séparément, Wikibase est effectivement désactivé sur la page en question. Seuls les liens interlangues présents dans le wikicode sont utilisés. Le mot réagit de la même manière lorsqu'il est utilisé comme fonction, avec un astérisque :  (l'astérisque ramassant toutes les langues).

Dans l'utilisation en tant que fonction avec paramètres, les liens vers les langues spécifiées sont enlevés. Par exemple,  supprime les liens vers le français et l'indonésien. Il est également possible d'appeler la fonction plus d'une fois :. Il vaut mieux supprimer les liens vers les langues qui n'existent pas.



Transclusion de données
WikibaseClient permet d'inclure les données à partir du dépôt Wikibase en utilisant la fonction  de l'analyseur syntaxique avec Lua.


 * Lua
 * Documentation Lua


 * Fonctions d'analyse
 * Recherche à l'aide de l'Id de propriété (par exemple P2) pour inclure les données d'un élément Wikibase connecté via un lien de site. Par exemple,.
 * Rechercher à l'aide du libellé de la propriété. Par exemple,.
 * Lorsque l'accès arbitraire est activé, il peut être appliqué à n'importe quel élément. Par exemple,.
 * En plus de  qui génère le wikicode lié, vous pouvez utiliser   qui donne les étiquettes non liées.
 * Pour plus d'information, voir Comment utiliser les données avec les projets Wikimedia.



Autre barre latérale de projets

 * Voir aussi Interface des liens interprojet pour avoir l'état actuel des projets Wikimedia.

L'option de configuration  crée une section Autres projets dans la barre latérale avec des liens vers les autres projets à partir de l'élément lié à la page actuelle. Actuellement, il supporte exactement un seul lien par projet et ne supplante pas encore les liens dans le wikicode en utilisant une fonction d'analyseur (bien que les modifications du JavaScript actuel puissent être facilement adaptées).

Exemple de configuration (les liens seront affichés dans l'ordre spécifié) :

L'Id de la barre latérale est « wikibase-otherprojects ». Vous pouvez l'utiliser pour personnaliser la position des sections dans la barre latérale en utilisant Sidebar.

Chaque lien possède le libellé contenant les messages i18n wikibase-otherprojects- ID  avec ID comme Id du goupe lié de sites (comme wikipedia, wikisource ou commons).

Page d'exemple : [|Le bistro]

commaseparatedlist
est une fonction de formatage du texte pouvant être utilisée dans le résumé des modifications. Elle renvoie sa liste d'arguments séparés avec le séparateur propre à la langue donnée. Par exemple donne comme résultat word1, word2, word3.



Activer les liens de sites
Les liens de site sont des liens spéciaux avec un site et un titre, liant les éléments individuels à des pages qui appartiennent à d'autres wikis. Dans Wikidata ils pointent vers les autres sites Wikimedia tels que Wikipedia, Wikisource et Wikivoyage. Parmi les autres choses, les liens de site permettent de référencer une propriété d'élément sur la page liée dans le wiki client, une fonctionnalité connue sous le nom d' Accès direct.



Configurer ses groupes de liens de site
Vous devez d'abord penser à la manière de regrouper les wikis clients que vous souhaitez voir dans la zone de vos liens de site pour les éléments du wiki du dépôt.



Définir des groupes personnalisés
Dans le wiki du dépôt, remplacez le contenu de dans   par les groupes que vous voulez y voir.

Par exemple considérez la ligne suivante dans  :

Cela va créer trois groupes dans la boîte des liens de site de la page de l'élément :


 * le  défini en standard pour les sites globaux Wikipedia
 * deux groupes de wikis personnalisés (nommés ici  et  )

Les noms définis ici sont relatifs au champ  de la table des , comme spécifié ci-dessous.

Dans votre wiki client ajoutez une ligne de configuration semblable avec votre  :



Désactiver la fonctionnalité des liens de sites
Si vous ne souhaitez pas du tout que votre installation utilise les liens de site, vous pouvez les désactiver en initialisant le paramètre avec un tableau vide :

<span id="Localise_your_groups">

Internationaliser vos groupes
Pour afficher l'entête correcte de vos groupes, vous devez créer la page  avec l'entête textuelle souhaitée.

Vous pouvez créer des sous-pages pour définir les titres dans les différentes langues, par exemple créer  pour créer un titre en allemand.

<span id="Add_the_wikis_to_the_sites_table">

Ajouter les wikis à la table des sites
Pour ajouter les liens de site aux éléments du wiki de dépôt, vous devez ajouter les wikis clients dans la table des sites. Le nom des groupes doit correspondre aux noms des groupes que vous avez ajoutés à votre configuration. D'après l'exemple ci-dessus, vous devriez obtenir un ou plusieurs sites avec  et   comme texte dans le champ.

Vous devez définir à la fois le chemin du fichier et le chemin de la page, et chacun doit contenir le paramètre de substitution.

Exemple
Pour ajouter votre wiki (avec un Id se terminant par ) au groupe , exécutez :

Soyez sûr de faire cela sur le wiki du dépôt ainsi que sur tous les wikis clients de sorte que la fonctionnalité Ajouter des liens dans les autres langues fonctionne correctement.

Veuillez suivre ces instructions pour avoir d'autres détails sur la manière d'ajouter des sites à la table.

<span id="Inform_the_repo_wiki_of_the_other_client_wiki_databases">

Informer le wiki du dépôt, des bases de données disponibles sur les autres wikis clients
localClientDatabases &mdash; tableau des bases de données clientes accessibles localement, à utiliser lors de la modification du mécanisme de répartition. Ce paramètre indique les wikis vers lesquels les modifications sont directement poussées. Il faut indiquer soit un tableau associatif (qui donne la correspondance des IDs globaux des sites avec les noms logiques des bases de données) ou une liste de bases de données (si leur nom correspond aux IDs des sites). Par défaut, le tableau est vide, ce qui signifie qu'il n'y a pas de bases de données client locales.

<span id="Verify_that_you_can_add_sitelinks">

Vérifier que l'on peut ajouter des liens de sites

 * 1) Allez sur la page   du wiki de votre dépôt et essayez de lier à un Item existant (champ « ID ») de l'un des sites configuré ci-dessus (champ « Site ID ») en spécifiant une page existante sur ce wiki (champ « Sitelink »). Si cela échoue, vous devriez recevoir un message d'erreur explicatif.
 * 2) Sur la page que vous avez ajoutée ci-dessus, vérifiez que l'Accès direct fonctionne en référençant une propriété de l'élément Item dans une fonction d'analyseur syntaxique.

Résolution des problèmes
<span id="There_are_no_sites_I_can_link_pages_to_in_an_item.">

Il n'existe pas de site pour lier les pages à un élément
Une ou plusieurs des propositions suivantes pourraient vous aider :