Extension:InterwikiExtracts

**Manuel des extensions MediaWiki**
InterwikiExtracts; État de la version : stable
Implémentation	Fonction d'analyseur
Description	Permet de réutiliser le contenu d'autres wikis
Auteur(s)	Sophivorusdiscussion
Dernière version	4.5
MediaWiki	>= 1.40.0
Modifie la base; de données	Non
	Accroches utilisées ParserFirstCallInit;
Licence	Licence publique générale GNU v3.0 ou ultérieur
Téléchargement	Télécharger l'extension ; Git [?]: parcourir le dépôt (Phabricator · GitHub); relecture Gerrit du code; historique Git des validations (commits); Télécharger le tarball source;
Exemple	[1]
	Traduire l’extension InterwikiExtracts sur translatewiki.net si elle y est disponible
Problèmes	Tâches ouvertes · Signaler un bogue

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

InterwikiExtracts (anciennement WikipediaExtracts) est une extension permettant de réutiliser le contenu d'autres wikis. Introduit la fonction d'analyse syntaxique {{#InterwikiExtract}} qui fournit du contenu à partir de tout wiki défini dans votre table interwiki . Voir la section Ajouter de nouveaux wikis pour étendre la table interwiki.

Le contenu peut être renvoyé sous trois formats : HTML, wikicode ou texte brut. Voir la section Utilisation pour le détail de chaque format.

Installation

Téléchargez et placez le(s) fichier(s) dans un répertoire appelé InterwikiExtracts dans votre dossier extensions/.
Les développeurs et les contributeurs au code doivent à la place installer l'extension à partir de Git en utilisant:
```
cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/InterwikiExtracts
```
Ajoutez le code suivant à la fin de votre fichier LocalSettings.php :
```
wfLoadExtension( 'InterwikiExtracts' );
```
Fait – Accédez à Special:Version sur votre wiki pour vérifier que l'extension a bien été installée.

Utilisation

Ajouter de nouveaux wikis

Pour utiliser le contenu d'un wiki, il doit être chargé dans la table interwiki . MediaWiki est fourni avec un ensemble de wikis déjà chargés, y compris la Wikipédia anglaise et de nombreux autres projets Wikimedia, de sorte que ces wikis fonctionnent déja à l'installation.

Pour ajouter facilement de nouveaux wikis à la table interwiki, installer Extension:Interwiki , aller sur Special:Interwiki et suivre l'interface. Pour que cela fonctionne, vérifier d'avoir inclus l'URL de l'API du wiki à ajouter.

Dans les versions plus anciennes de l'extension Interwiki il n'est pas possible de définir l'URL de l'API à partir de la page spéciale, vous devez donc le faire directement à partir de la base de données en exécutant une commande SQL similaire à : UPDATE interwiki SET iw_api = "https://es.wikipedia.org/w/api.php" WHERE iw_prefix = "eswiki";

Si vous n'avez pas accès à Special:Interwiki, ou si vous ne voulez pas traiter avec la table interwiki, vous pouvez aussi spécifier directement le point d'accès de l' API avec le paramètre api ainsi :

{{#InterwikiExtract: Title of the article
| api = https://www.somewiki.org/w/api.php
}}

Extraits HTML

Par défaut l'extension récupère le contenu de Wikipedia au format HTML. Ainsi pour obtenir le code HTML de tout article Wikipedia, il suffit d'écrire :

{{#InterwikiExtract:Title of the article}}

Si vous omettez le titre, c'est le titre de la page actuelle qui sera utilisé. Si vous entrez le titre d'une page de redirection, la redirection sera effectuée et le contenu de l'article ciblé sera renvoyé. Si la redirection se fait vers une section de l'article ciblé, elle extraira l'article entièrement et pas uniquement la section.

Vous pouvez contrôler plusieurs aspects du contenu à obtenir en ajoutant des paramètres à la fonction d'analyse syntaxique, selon la syntaxe habituelle du modèle. Par exemple :

{{#InterwikiExtract: Title of the article
| section = 0
}}

Extraits de wikicode

Vous pouvez obtenir le contenu au format wikicode avec la syntaxe suivante :

{{#InterwikiExtract: Title of the article
| format = wiki
}}

Le contenu sera analysé après l'avoir récupéré, ce qui signifie que tous les liens vers des pages de votre wiki qui n'existent pas encore seront montrés en rouge, y compris les modèles !

Le format wikicode n'est pas prévu pour être utilisé avec le contenu de Wikipedia, mais il peut être plus utile avec le contenu de wikis plus petits avec moins de liens internes et de modèles.

Extraits de texte brut

Pour obtenir le contenu au format texte brut, le wiki cible doit avoir installé Extension:TextExtracts . Tous les wikis Wikimedia doivent l'activer, mais pas forcément les autres !

Vous pouvez obtenir le contenu au format wikicode brut avec la syntaxe suivante :

{{#InterwikiExtract: Title of the article
| format = text
}}

Les paramètres disponibles sont :

section – titre de la section à récupérer (sauf les sous-sections).
paragraphs – nombre de paragraphes à récupérer
intro – indique si vous voulez ou non obtenir le contenu qui précède la première section. Toute valeur équivaut à true.
sentences – nombre de phrases à obtenir de l'introduction. Ne peut pas être utilisé en même temps que le paramètre chars.
chars – nombre de caractères à récupérer. Ne peut pas être utilisé en même temps que le paramètre sentences.
plaintext – Indique si le contenu doit être récupéré (ou pas) en tant que texte brut plutôt qu'en HTML limité. Toute valeur équivaut à true.
sectionformat – Une valeur parmi plain, wiki, raw . Par défaut wiki.

Sauf pour section et paragraphs tous les paramètres sont basés sur l'API Extension:TextExtracts . Voir la documentation pour plus de détails.

Modèles en tant que conteneur

En général vous souhaiterez cacher la fonction d'analyse syntaxique dans un modèle pour simplifier la syntaxe et initialiser les valeurs par défaut sensibles. Par exemple, si vous voulez utiliser l'extension pour obtenir les introductions des articles de Wikipédia, vous pouvez créer un modèle appelé Template:WikipediaLead avec le contenu suivant :

{{#InterwikiExtract: {{{1|{{PAGENAME}}}}}
| wiki = wikipedia
| format = text
| intro = true
}}

En appelant ce modèle sans paramètre vous obtiendrez la section principale de l'article Wikipedia qui a le même titre que la page courante. Si vous voulez le titre d'un article différent, vous pouvez fournir l'article dans premier paramètre, comme ceci :

{{WikipediaLead|Title of the article}}

De même, si vous voulez utiliser cette extension pour obtenir de courtes définitions de Wikipédia, vous pouvez créer un modèle Template:WikipediaDefinition avec le contenu suivant :

{{#InterwikiExtract: {{{1|{{PAGENAME}}}}}
| wiki = wikipedia
| format = text
| sentences = 1
}}

En appelant ce modèle sans paramètre vous obtiendrez la première phrase de l'article Wikipedia qui a le même titre que la page courante. Si vous souhaitez n'avoir que la première phrase d'un article différent, entrez l'article dans le premier paramètre.

Paternité des auteurs

A chaque fois que vous utilisez cette extension vous devez toujours créditer les auteurs du contenu que vous réutilisez. Vous pouvez facilement faire cela en incluant un lien dans votre modèle de conteneur. Par exemple :

{{#InterwikiExtract: {{{1|{{PAGENAME}}}}}
| wiki = wikipedia
| format = text
| intro = true
}}
[{{fullurl:wikipedia:{{{1|{{PAGENAME}}}}}}} From Wikipedia]

Voir aussi

Extension:TextExtracts
Appropedia:Template:Wikipedia excerpt - cas réel où cette extension est utilisée