ÉditeurVisuel/Outils de citation

From mediawiki.org
Jump to navigation Jump to search
This page is a translated version of the page VisualEditor/Citation tool and the translation is 75% complete.
Outdated translations are marked like this.
Other languages:
Bahasa Indonesia • ‎Cymraeg • ‎English • ‎Tiếng Việt • ‎Türkçe • ‎català • ‎dansk • ‎español • ‎euskara • ‎français • ‎italiano • ‎português • ‎português do Brasil • ‎slovenščina • ‎suomi • ‎svenska • ‎български • ‎українська • ‎հայերեն • ‎فارسی • ‎ქართული • ‎中文 • ‎日本語

L'outil de citation de l'Éditeur Visuel permet aux utilisateurs de votre Wikipedia d'utiliser des modèles de citations depuis l'Éditeur Visuel. Pour activer l'outil, vous devez être équipé de ce qui suit : une installation fonctionnelle de l'Éditeur Visuel et de Parsoid, des modèles de citation contenant des TemplateData, et un message .json spécifique afin de lier le modèle et l'ÉditeurVisuel.

Importer les modèles de citation

Vous devez avoir des modèles de citation dans la base de donnée de votre wiki pour pouvoir utiliser une fonctionnalité de citation. Si vous n'en avez pas encore (installation vierge par exemple) vous devez les obtenir. Les copier de Wikipédia est le moyen le plus simple. Si vous en avez, vous pouvez passer à la suite.

  1. Installez Extension:Scribunto, Extension:ParserFunctions, Extension:Cite et Extension:TemplateData. La plupart des modèles de citation de Wikipédia sont codés en langage Lua (rendu disponible par Scribunto) et utilisent aussi les outils d'analyse. L'extension Cite permet d'utiliser les balises ‎<ref>. All Wikipedias and other WMF wikis already have all of these things installed.
  2.  Exporter les modèles de citation depuis Wikipédia: Manual:Using_content_from_Wikipedia. Les modèles Template:Cite_web, Template:Cite_news, Template:Cite_journal, Template:Cite_book sont un bon départ sur la Wikipédi en anglais par exemple (en français, Modèle:Ouvrage ; Modèle:Article ou Modèle:Lien_web ) Recent versions of these templates at the English Wikipedia and some others also require the supporting Lua modules.
  3. Téléversez vos modèle grâce à la page Spéciale:Import de votre wiki (par exemple http://localhost/index.php/Special:Import)

Template data

Vous devez avoir l'extension Extension:TemplateData pour que l'outil de citation puisse charger les template datas dans les champs de l'éditeur visuel, et chaque modèle doit avoir un "template data" dédié. Pour plus d'information sur comment définir un templatedata pour les citations, et pour voir des captures d'écran d'une fenêtre de citation qui fonctionne, voir: Wikipedia:VisualEditor/TemplateData

Définition des outils de citation

Pour activer l'outil VisualEditor citation tool sur votre wiki, vous devez créer un message spécial sur votre wiki: MediaWiki:Visualeditor-cite-tool-definition.json. Cela parce que chaque wiki est différent et doit être personnalisé en fonction des fonctionnalité qu'on souhaite utiliser; par exemple les noms des modèles de votre wikis peuvent être différents de ceux d'autres wikis.

But du message de configuration

Le message:

  • Indiquer quel modèle utiliser pour les citations habituelles (vous pouvez en donner jusqu'à 5).
    • Notez que chacun de ces modèles doit disposer d'un TemplateData défini ou alors le système sera très difficile à comprendre pour les utilisateurs. Si votre wiki n'utilise pas encore de modèles de citation, il est pratique de copier les modèles de la Wikipédia en anglais comme un jeu de modèles généraux.
  • Indique les intitulés à utiliser pour chaque sorte de citation.
    • Il en existe quatre standards: "web", "book", "news" et "journal" (web, livre, article de journal, journal scientifique) qui correspondent à MediaWiki:Visualeditor-cite-tool-name-web etc.
  • Indique une icône à utiliser pour chaque type de citation.
    • Il en existe quatre standards, "ref-cite-web", "ref-cite-book", "ref-cite-news" and "ref-cite-journal" qui correspondent aux classes des feuilles de style CSS avec l'icône en image de fond (format SVG) appelée oo-ui-icon-ref-cite-news etc.

Une fois que le message de configuration MediaWiki:Visualeditor-cite-tool-definition.json est créé, l'outil de citation sera en ligne pour tous les éditeurs visuels de votre wiki après quelques minutes.

Types supplémentaires

Si vous envisagez d'ajouter un nouveau type de citation, l'équipe de développement souhaite vraiment vous parler au préalable, pour vous donner des conseils, vous aider à créer une icône appropriée, et pour que nous puissions envisager de l'intégrer dans l'outil si c'est pertinent, pour que tout le monde puisse en profiter.

Pour ajouter un type de citation, vous devrez :

  1. Décider du type que vous souhaitez créer
    • Dans cet exemple, on décide que vous voulez référencer des bases de données, vous pourriez appeler ce type "database".
  2. Créez un intitulé approprié
    • Pour notre exemple, vous pourriez choisir nom d'intitulé db et ajouter un intitulé pour MediaWiki:Visualeditor-cite-tool-name-db avec la valeur base de donnée. Il devrait être dans la langue du contenu de votre wiki. Si votre wiki utilise plusieurs langages ou alphabets, vous pourriez avoir à créer plusieurs de ces intitulés.
  3. Créez une icône appropriée
    • Dans notre exemple, on choisira comme intitulé pour l'icône "ref-cite-dbase" et on téléversera notre création pour l'icône sous forme d'un fichier qu'on téléversera à commons, créer la classe d'icône "oo-ui-icon-ref-cite-dbase" en MediaWiki:Common.css et indiquera l'icône avec "background-image:url(//upload.wikimedia.org/wikipedia/commons/1/12/VisualEditor_-_Icon_-_Ref_db.svg)" ou similaire.

Exemples

Vous pouvez voir des exemples de messages de définition sur la Wikipédia en anglais ou en Polonais. Copy the code to your wiki and adapt the names to the local context.

"Citation needed" tool

The "citation needed" tool.

"Citation needed" templates can be configured to show an "Add a citation" button in the editor by configuring MediaWiki:Visualeditor-template-tools-definition.json with a citationNeeded key.

The configuration value lists templates (which can contain multiple titles for redirects) and parameter mappings. Currently supported keys are:

  • reason - shows the reason a citation is needed in the context item
  • date - shows the date "citation needed" template was added in the context item
  • encapsulate - text which has been wrapped by the template, and which should be unwrapped when a citation is added

The value of these mappings is the name of the parameter(s) in the local template:

{
	"citationNeeded": [
		// This key is always "citationNeeded" in every language
		// Each item of this list represents a single template
		{
			"title": [
				// Title can be a string, or list of redirects
				"Citation needed",
				"Cn",
				...
			],
			"params": {
				"reason": "reason",
				"date": "date"
			}
		},
		// This template is defined separately as it supports the
		// "encapsulate" param. On some wikis this is the same
		// template as the one above.
		{
			"title": [
				"Citation needed span",
				"Cite needed span",
				...
			],
			"params": {
				// Parameters can be a string or list of aliases
				"encapsulate": [ "1", "text" ],
				"reason": "reason",
				"date": "date"
			}
		}
	]
}

See the example definition on English Wikipedia.

Dépannage

Si vous naviguez vers Spécial:Version et si TemplateData est installé, mais que les champs ne sont pas montrés dans le dialogue de citation, vous pourriez devoir ouvrir le modèle de citation en modification et sauvegarder sans rien changer. C'est la faute d'un bug qui survient quand TemplateData est transclu (présent dans Template:Cite_web/doc et pas directement dans Template:Cite_web par exemple) mais pas chargé dans la base de donnée tant que le modèle n'est pas édité ; voir tâche T52372.

Veuillez aussi noter que l'expérience utilisateur va être légèrement différente lorsque vous utilisez vos propres modèles, en dehors des 4 standards. Par exemple, une liste de champs ne s'affichera pas d'emblée dans la boîte de dialogue de citation, mais vous pourrez demander à ajouter une liste des champs possible en cliquant sur un bouton.