VisualEditor/Citation tool/fr

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

Il est recommandé d'avoir les extensions suivantes pour utiliser avec les modèles de citation classiques: Extension:VisualEditor, Extension:Scribunto, Extension:Cite, Extension:TemplateData, et Extension:ParserFunctions.

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:Cite/Cite.php, Extension:ParserFunctions et Extension:TemplateData. Scribunto vous permet d'utiliser le langage de programmation lua dans vos modèles de citation, et la plupart des modèles de citation de Wikipédia sont codés en lua et utilisent les parser functions. L'extension  Cite permet d'utiliser les balises . L'extension TemplateData permet aux modèles de fournir des informations sur les intitulés et sur leur propre structure à VisualEditor.
 * 2) Export citation templates from wikipedia: Manual:Using_content_from_Wikipedia. Exporting Template:Cite_web, Template:Cite_news, Template:Cite_journal, Template:Cite_book is a good place to start.
 * 3) Upload your templates using the Special:Import page on your wiki (for example, 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
To enable the VisualEditor citation tool on your wiki, you need to create a special message on your wiki:. This is because each wiki is different and so needs to customise which features it wants to use; for example, the names of the templates used on your wiki might be different from those of other wikis.

But du message de configuration
Le message:

Once the  configuration message is created, the citation tool will be live for all VisualEditor users on your wiki within a few minutes.
 * Says which templates your wiki uses for standard citations (you can state up to 5).
 * Note that each template must have TemplateData defined or the system will be very difficult for users to understand. If your wiki does not currently use citation templates, it is common to copy the templates from the English Wikipedia as a good general set.
 * Says which label you wish to use for each type of citation.
 * There are a standard four, "web", "book", "news" and "journal", which correspond to  etc.
 * Says which icon you wish to use for each type of citation.
 * There are a standard four, "ref-cite-web", "ref-cite-book", "ref-cite-news" and "ref-cite-journal", which correspond to CSS classes with the icon as a background SVG image called  etc.

Types supplémentaires
If you are considering adding an additional type, the development team would really like to talk with you first, to give advice, help create an appropriate icon, and so we can consider whether other wikis might also want this type defined for all wikis.

To add an additional type, you will need to:


 * 1) Decide what type you wish to create
 * 2) * In this example, say you wished to have a database reference, you could call the type "database".
 * 3) Créez un intitulé approprié
 * 4) * For the example, you could make the label name "db" and add a label at   with the value "database". This should be in your wiki's content language. If your wiki uses multiple languages or scripts, you may need to create several of these labels.
 * 5) Créez une icône pour lui
 * 6) * For the example, you could make the icon label "ref-cite-dbase", and create the icon as an SVG file uploaded to commons, create the icon class " " in  and add the icon you want with " " or similar.

Exemples
You can see example definition messages on the English Wikipedia and the Polish Wikipedia.

Dépannage
If you navigate to Special:Version and TemplateData is installed, but fields aren't showing up in the citation dialog, you may need to open the citation template for editing, make no changes, and save it again. This is due to a bug where TemplateData which is transcluded (i.e. present in Template:Cite_web/doc instead of directly on Template:Cite_web) is not loaded into the database until the parent template is edited; see.

Please note that the user experience will differ slightly when using your own templates other than the standard 4. For instance, a list of fields won't show up initially in the citation dialog, but you will be able to request a list of all possible fields by clicking a button.