Extension:Cite

Cette page documente l'extension. Pour savoir comment l'utiliser, voir Aide sur les citations.

Manuel des extensions MediaWiki

Cite État de la version : stable
Implémentation	Balise
Description	Permet d'avoir des notes de bas de page pour citer les sources et aide à citer correctement le contenu des médias qui ne se trouvent pas en ligne.
Auteur(s)	Ævar Arnfjörð Bjarmasondiscussion
Dernière version	Mises à jour continues
Politique de compatibilité	Versions ponctuelles alignées avec MediaWiki. Le master n'est pas compatible arrière.
MediaWiki	1.34+
PHP	7.0+
Modifie la base de données	Non
Licence	Licence publique générale GNU v2.0 ou supé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	Wikipedia:Footnotes
Paramètres $wgCiteDefaultBacklinkAlphabet $wgCiteReferencePreviewsConflictingNavPopupsGadgetName $wgCiteResponsiveReferencesThreshold $wgCiteResponsiveReferences $wgCiteSubReferencing $wgCiteBacklinkCommunityConfiguration $wgCiteUseLegacyBacklinkLabels $wgCiteReferencePreviews $wgCiteSubRefMergeInDevelopment $wgCiteVisualEditorOtherGroup $wgCiteReferencePreviewsConflictingRefTooltipsGadgetName
Balises ‎<ref> ‎<references>
Accroches utilisées APIQuerySiteInfoGeneralInfo CommunityConfigurationProvider_initList ContentHandlerDefaultModelFor EditPage::showEditForm:initial GetPreferences MakeGlobalVariablesScript ParserAfterParse ParserClearState ParserFirstCallInit ResourceLoaderGetConfigVars ResourceLoaderRegisterModules UserGetDefaultOptions
Traduire l’extension Cite sur translatewiki.net si elle y est disponible
Problèmes	Tâches ouvertes · Signaler un bogue

L'extension Cite permet à un utilisateur de créer sur une page des références sous forme de notes de bas de page. Elle ajoute deux accroches d'analyseur syntaxique à MediaWiki, ‎<ref> et ‎<references> ; elles interagissent ensemble pour ajouter des citations dans les pages.

Utilisation

Pour les informations supplémentaires, voir la page d'aide pour l'utilisation de l'extension Cite.

Installation

Cette extension est fournie avec MediaWiki 1.21 et supérieur. Les instructions de configuration restantes doivent encore être suivies.

• Téléchargez et placez le(s) fichier(s) dans un répertoire appelé Cite 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/Cite
  

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

  wfLoadExtension( 'Cite' );
  

• Configurez comme demandé.
• Fait – Accédez à Special:Version sur votre wiki pour vérifier que l'extension a bien été installée.

Installer Vagrant :

• Si vous utilisez Vagrant , installez avec vagrant roles enable cite --provision

Configuration

$wgCiteBookReferencing

Active une fonctionnalité expérimentale pour les sous-références lorsqu'elle est initialisée à true, voir la page d'aide. Valeur par défaut : false

$wgCiteResponsiveReferences

valeur par défaut de l'affichage dynamique des références. S'il est initialisé à true, la section des références sera affichée sur plusieurs colonnes. Voir la documentation d'utilisation. Valeur par défaut : true

$wgCiteVisualEditorOtherGroup

S'il est initialisé à true, le bouton de la barre d'outils Cite peut être déplacé sous le menu Insert. Ceci est utilisé sur les sites de Wikivoyage. Voir la demande originelle de fonctionnalité. Valeur par défaut : false.

En ajoutant une définition en JSON à MediaWiki:Cite-tool-definition.json, le menu de citation peut être rempli avec des outils qui créent des références contenant des modèles spécifiques. Le contenu de la définition doit être un tableau contenant une série d'objets, un par outil. Chaque objet doit contenir les propriétés name, icon, template. Une propriété optionnelle title peut aussi être utilisée pour définir le titre de l'outil sous forme de texte brut. La propriété name est l'identifiant unique de l'outil, et elle fournit également un titre de repli pour l'outil en étant transformé en clé de message. Le nom est préfixé par visualeditor-cite-tool-name- et les messages peuvent être définis sur le Wiki. Certains messages communs sont prédéfinis pour le nom des outils comme web, book, news, journal, map.

Exemple :

[ { "name": "web", "icon": "browser", "template": "Cite web" }, ... ]

(De : gerrit:plugins/gitiles/mediawiki/extensions/Cite/+/refs/heads/wmf/1.46.0-wmf.7/modules/ve-cite/ve.ui.MWReference.init.js#66)

Limites

Suivi dans Phabricator
Tâche T4700
Ouvert

• L'astuce de la barre verticale ainsi que les autres transformations avant enregistrement ne fonctionnent pas pour les notes de bas de page créées avec cette extension.

Voir aussi

• Aide:Cite
• Extension:Citations Semantic
• Extension:CiteThisPage