WMDE Technical Wishes/Sub-referencing/fr
Actuellement, il n'est pas possible de facilement réutiliser la même référence avec les mêmes détails dans un article. Des membres de la communauté ont à plusieurs reprises demandé une solution Mediawiki fonctionnant sans modèles et basée sur le mode de fonctionnement actuel de références, à la fois pour l'éditeur de Wikitexte et l'Éditeur visuel. » En savoir plus sur ce problème
| Sous-références | |
|---|---|
| Status | En cours |
| Origin | Enquête des vœux techniques 2013, 2015, 2022 et d'autres |
| Focus area | Faciliter la réutilisation de références |
| Phabricator | comité de projet |
| Responsible | Équipe des vœux techniques |
 Donnez-nous votre avis Nous vous invitons à tester notre prototype que nous mettons à jour en permanence. Mettez cette page dans la liste de suivi ou inscrivez-vous à cette liste de destinataires pour l’envoi en masse de messages pour découvrir de nouvelles choses à tester | |
Au sein du thème « Faciliter la réutilisation de références », l'équipe Souhaits Techniques de Wikimedia Allemagne introduit les sous-références — une fonctionnalité optionnelle qui vous permet de facilement rattacher des détails différents à une référence existante, sans avoir à la dupliquer.
Notre objectif et d'apporter les sous-références aux wikis Wikimedia fin 2024.
Les sous-références en bref
Pour citer une source plus d'une fois avec des détails différents, vous avez besoin d'une référence principale et d'une sous-référence.
- La références principale contient les informations bibliographiques principales.
- La sous-référence contient les détails : les numéros de page, ou n'importe quelle autre information supplémentaire qui diffère de chaque citation, par ex. chapitres, vers, ou notes.
- Dans la section références, les lecteurs verront toutes les sous-références groupées ensembles sous leur référence principale. Cela facilite la compréhension de la fréquence d'utilisation d'une source.
- Pour le wikitexte, vous pouvez utiliser un nouvel attribut pour les sous-références. Le nom actuel de cet attribut est extends, mais ce nom pourrait changer d'ici au déploiement. Nous sommes ouverts à des retours sur ce nom.
- Dans l'Éditeur Visuel, nous changeons le dialogue de citation existant pour qu'il permette les sous-références.
Bénéfices principaux
- La sous-référence sera basée sur le mode de fonctionnement actuel des références.
- Elle fonctionne à la fois dans l'Éditeur Visuel et en Wikitexte — nous rapprochant de la parité des fonctionnalités entre l'éditeur visuel et le Wikitexte.
- La solution sera intégrée à MediaWiki, donc disponible sur tous les wikis Wikimedia et utilisable sans solutions de contournement basées sur des modèles.
- Les sous-références seront affichées correctement dans les Aperçus de Références et dans les popup de références sur mobile.
- Elles sont facultatives: Vous pouvez toujours utiliser d'autre méthodes pour référencer. Mais vous pourriez rencontrer des sous-références dans des articles écrits par d'autres utilisateurs.
- Essayez le prototype ! En savoir plus sur comment tester.
- Donner des retours sur la page de discussion.
- Suivre cette page ou abonnez-vous à cette liste de messages pour en savoir plus sur de nouvelles fonctionnalités à tester.
Commend ça marche
En wikitexte
La solution en wikitexte pour les sous-références est presque terminée. Toutefois, le nom de l'attribut pourrait changer. La solution n'a pas encore été déployée principalement parce que nous voulons éviter que les utilisateurs de l'Éditeur Visuel aient une expérience très différente de celle des utilisateurs de wikitexte. La solution pour l'Éditeur Visuel est encore en développement.
Vous pouvez tout de même tester le prototype et nous dire s'il fonctionne pour vous.
Bénéfices spécifiques au wikitexte
- La solution est basée sur le concept existant et connu de références nommées.
- Il ne nécessite aucune connaissance des modèles.
- Les références presque dupliquées peuvent être supprimées dans le texte wiki, ce qui le rend plus propre, moins redondant et plus facile à lire.
Étape par étape
1) Vous avez besoin d'une référence avec les informations bibliographqiues principales, la référence principale. Cette référence à besoin d'un nom:
<ref name="Miller">E. Miller, ''The Sun''. New York: Academic Press, 2005.</ref>
La référence principale devrait être placée dans la section références, ou vous aurez une référence dans l'article qui ne montre pas de détails comme les numéros de page.
2) Vous créez une sous-référece, utilisant le nom de la référence principale aved l'attribut extends. Vous ajoutez les détails entre les balises <ref>:
<ref extends="Miller">Page 23.</ref>
Ça ressemble à ça:
According to scientists, the Sun is pretty big.<ref extends="Miller">Page 23.</ref> In fact, it is very big. Take their word for it.<ref extends="Miller">Page 48.</ref> Don't look directly at the sun!<ref extends="Miller">Page 23.</ref>
==References==
<references >
<ref name="Miller">E. Miller, ''The Sun''. New York: Academic Press, 2005.</ref>
</references>
|
|
Si vous voulez faire référence à une nouvelle source en utilisant des sous-références dans le wikitexte, vous avez seulement desoin de créer la référence principale dans la section références.
Mais dans de nombreux cas, vous voudrez probablement utiliser une sous-référencement avec une référence qui existe déjà dans l'article. Dans ces cas
- Transformer la référence originale en référence principale en utilisant le
<ref name>. - Mettez la référence principale dans la section de références.
- Créer une sous-référence là où la référence originale était précédemment dans le texte de l'article.
- Déplacez les détails de la référence principale (numéros de page, etc.) dans la sous-référence. Veillez à ce qu'ils ne restent plus dans la référence principale, sinon ces détails seront affichés deux fois.
- Créez plus de sous-références là où vous voulez citer la source avec des détails différents dans l'article.
Vous pouvez également réutiliser une sous-référence en donnant un nom à la sous-référence:
According to scientists, the Sun is pretty big.<ref extends="Miller" name="Miller, 23">Page 23.</ref> In fact, it is very big. Take their word for it.<ref extends="Miller">Page 48.</ref> Don't look directly at the sun!<ref name="Miller, 23" />
==References==
<references >
<ref name="Miller">E. Miller, ''The Sun''. New York: Academic Press, 2005.</ref>
</references>
|
|
Veuillez noter
- Convertir les références en références principales et sous-références nécessite un peu de nettoyage; et la référence principale doit typiquement être dans la section référence (comme décrit ci-dessus).
- Vous pouvez utiliser le sous-référencement avec des modèles de citation. Nous avons testé les plus couramment utilisés, mais votre modèle préféré pourrait avoir besoin de mises à jour pour fonctionner avec notre solution.
- Certains gadgets/scripts liés aux références pourraient également avoir besoin d'une mise à jour afin de fonctionner correctement avec la nouvelle solution de sous-référencement.
- Il n'est pas possible de faire une sous-référence d'une sous-référence.
- Si l
<ref group>est utilisé, la référence principale et la sous-référence doivent être dans le même groupe.
Dans l'Éditeur Visuel (en cours de développement)
À ce stade, nous ne savons pas exactement à quoi ressemblera la fonctionnalité pour Visual Editor. Pour l'instant, nous avons une solution très minimale qui n'est pas encore prête à être déployée. Dans les semaines à venir, cette solution va très probablement changer.
Vous pouvez également tester le prototype actuel de la solution pour l'Éditeur Visuel. Veuillez garder à l'esprit qu'elle changera probablement. Nous mettrons à jour cette pages quand de nouveaux aspects pourront être testés.
Bénéfices spécifiques à l'Éditeur Visuel
- Pour citer la même source avec des détails différents, vous n'avez plus besoin de créer une nouvelle référence à partir de zéro.
- Les sous-références sont entièrement compatibles avec Visual Editor (par opposition aux solutions de travail basées sur des modèles): vous pouvez les créer via le dialogue de citation et vous pouvez les modifier à partir de la section de référence.
Flux de travail du prototype actuel (va probablement changer)
Créer une sous-référence
- La création d'une sous-référence fonctionne actuellement via le dialogue de citation existant.
- Dans l'onglet "extends", sélectionnez la référence que vous souhaitez réutiliser. Cet onglet sera probablement amélioré après nos sessions de test d'utilisateurs actuelles.
- Entrez les détails de cette sous-référence et cliquez sur insérer.
- Le popup de référence dans Visual Editor vous montre que cette référence est une sous-référence et la fréquence à laquelle elle est réutilisée.
Modifier une sous-référence existante
- Clockez sur le marqueur de note de bas de page dans le texte de l'article pour modifier une sous-référence.
- Vous pouvez maintenant modifier les détails de la sous-référence. Vous êtes également informé qu'il s'agit d'une sous-référence.
- Vous ne pouvez pas encore modifier une sous-référence depuis la liste de références.
- Pour modifier la référence principale, cliquez dessus dans la section de références.
Réutiliser une sous-référence
- Vous pouvez réutiliser une sous-référence en utilisant l'onglet "réutiliser" dans le dialogue de citation.
Veuillez noter
- Le problème existant avec le nommage automatiques des références dans l'Éditeur Visuel arrive aussi aux sous-références.
- Dans l'Éditeur Visuel, il est actuellement possible de créer une sous-référence d'une sous-référence. Ceci est une erreur et en cause un lors de l'enregistrement. Ceci n'est pas censé fonctionner dans la solution finale, et ne fonctionne pas non plus en wikitexte.
- Nous n'avons pas encore décidé sur ce qui se passe lorsque vous supprimez une référence qui est réutilisée.
- Le flux de travail pour transformer une référence existante en référence principale et sous-référentielle n'a pas encore été défini.
- Quand vous créer une réutlisation d'une sous-référence dans l'Éditeur Visuel et passez au wikitexte, vous verrez que l'expression dans le wikitexte est
<ref extends="main-reference" name="sub-reference" />. Ceci est un bog et sera réparé au sein de T367749. <ref name="sub-reference name"/>ne montre actuellement pas correctement l'aperçu de référence dans le mode Éditeur Visuel. Vous ne verrez que les détails de la sous-référence dans le pop-up et pas l'information de la référence principale. Pour également la voir, vous devriez actuellement utiliser la syntaxe<ref extends="main" name="sub-reference name" />.
Tester le prototype
Nous avons besoin de vos retours pour s'assurer que nous allons dans la bonne direction. Des commentaires ou des questions sont toujours les bienvenues sur la page de discussion de ce projet.
Le prototype est disponible sur beta wiki. Actuellement, nous vous invitons à tester la solution wikitexte:
- Il peuvent ressembler à autre chose (par ex. ne pas utiliser votre habillage préféré).
- Ils pourraient offrir des nouvelles fonctionnalités qui sont encore expérimentales.
- Ils ne contiennent que quelques pages et modèles de test, pas tout le contenu de votre wiki, et pas tous les modèles, modules, gadgets, etc. auxquels vous êtes habitué.
- La connection Wikimédia normale ne fonctionne pas sur les wikis beta. Vous pouvez soit créer un compte — assurez-vous d'utiliser un mot de passe différent de celui de votre compte principal — ou tester la fonctionnalité sans un compte, ce qui mènera à la création d'un compte temporaire (sur de-betawiki) — ou à l'affichage de votre addresse IP (on en-betawiki).
Le problème que nous résolvons
Dans les articles Wikipédia, il arrie souvent de faires référence à une source plusieurs fois. Mais tandis que vous pouvez réutiliser une référence exactement telle quelle, vous ne pouvez actuellement pas réutiliser la même référence avec des détails différents (par ex. des numéros de page différents). Votre seule option est de créer une nouvelle référence ou d'utiliser des coutournements.
Status quo: réutilisation des références en wikitexte et dans l'Éditeur Visuel
If you want to re-use a reference in wikitext, you can turn it into a named reference and refer to that name at another point in the article. The named reference can be placed in the article text or in the reference section. In Visual Editor you can use the option "re-use" in the citation dialog. In the reference section, references with the same name are grouped together.
-
Wikitext: <ref name> in the article text -
Wikitext: <ref name> in the reference section -
Visual Editor: citation dialog -
Point de vue du lecteur
Status quo: Re-using references with different details in wikitext
If you want to re-use an existing reference with different details in wikitext, you currently need to copy and paste the existing reference and change the details of the duplicate or create a new (almost identical) reference from scratch. Some projects use workarounds like short citations or template-based solutions like shortened footnotes. In the reference section, the original reference and the new one you created are not grouped together.
-
Two almost identical references in the wikitext. -
Reader's view: Almost identical references are not grouped together -
Workaround with short citations in wikitext -
Reader's view: workaround with short citations -
Workaround with {{sfn}} in wikitext -
Reader's view: workaround with {{sfn}}
Status quo: Re-using references with different details in Visual Editor
If you want to re-use an existing reference with different details in Visual Editor, neither the option "re-use" in the citation dialog nor the copy-and-paste method will work, because both lead to identical re-uses, and changing details of the re-used/copied reference changes both instances of that reference. Instead you’ll need to create a new (almost identical) reference from scratch. In the reference section, the original reference and the new one you created are not grouped together.
References created by template-based workarounds like {{sfn}} cannot be edited from within the reference section and don’t appear in the citation re-use tab; but it is possible to edit them manually when locating them in the article text.
workaround with {{sfn}}:
-
Point de vue du lecteur -
The references disappear from the reference section when clicking "edit". -
It is not possible to use {{sfn}} references via the "re-use"-dialog. -
References can only be edited when locating the reference in the article text
Problems for readers
Template-based workarounds are not properly displayed in Reference Previews, Reference Tooltips and mobile reference pop-ups.
{{sfn}} workaround with previews for references:
-
Reference Previews: The main information is not included in the pop-up. -
Reference Tooltips: The main information is not included in the initial pop-up. -
Reference Tooltips: The main information is shown in another pop-up. -
mobile reference pop-ups: The main information is not included.
Main problems with the status quo
- The experience of Visual Editor and wikitext users is very different.
- Most workarounds for reusing references with different details don’t work properly in Visual Editor.
- Creating lots of almost identical references with different details makes the wikitext longer and potentially harder to read.
- Template-based workarounds are not equally accepted by all communities and thus not globally available.
- Some users try to avoid this issue by putting sources in the bibliography section without using them as references at all, which makes it harder to verify sections of the article.
Recent changes and next steps
Our team has worked on this problem on and off for some time now. Here is an overview of this project’s history, including our research.
Thank you to everyone who participated in tests and interviews and who showed interest, as well as everyone who took the time to comment on our talk pages over the years. It is deeply appreciated. If you have further feedback, please share it on the talk page.
A prototype is available on beta wiki. It covers the wikitext solution and some of the basic features of the Visual Editor solution. You can continuously test the prototype and give feedback.- Users across different projects are currently participating in moderated user testing.
- We will send out announcements across all wikis to let communities know about this upcoming feature, and invite them to test and give feedback.
- We have multiple questions and assumptions we need to test before moving to the next stage of development. Please check the feedback section where we will frequently raise current questions.
- Our plan is to deploy the sub-referencing feature for wikitext and Visual Editor by the end of 2024.
- We will continue to collect feedback to improve the solution after deployment.
We are aware of other problems in the focus area "reusing references", and we will try to address them along the way. Our focus, however, remains on creating a solution for sub-referencing.
Frequently Asked Questions
How can I find articles that use sub-referencing?
A tracking category called Category:Pages that use extended references is added to any page where sub-referencing is used, allowing you to explore or fix pages using the new feature. The name of this category might change.
Can I use this feature with citation templates/tools?
Yes, you can use sub-referencing with citation templates. We’ve tested the most common citation templates (e.g. cite book or cite web) and don’t expect any issues. But your favorite template might need some updates in order to work with our solution. Some gadgets/scripts related to references might also need an update in order to properly work with the new sub-referencing solution. Because templates, gadgets and scripts are in the hands of the wiki communities, we are unable to adapt them.
Please let us know, on the talk page, if you discover any problems or need some help updating citation templates to make them work with the new feature.
You are also invited to come to our Wikimania workshop "A brand new citation option – What does this mean for citation templates?" (hybrid) or watch the recording later.
What will the name of the sub-reference attribute be?
We don’t know yet. Currently, the attribute name for creating sub-references in wikitext is extends. We decided on this name some years ago after discussing with communities and stakeholders at the Wikimedia Foundation. However, we have received some feedback that this name might not be the best option. Before we will deploy this feature to the wikis, we want to get more feedback on the attribute name and are planning to put some alternatives up for discussion. We’ll let you know when that happens.
Why did you choose this wikitext syntax?
When we first started working on the wikitext implementation of this feature, we discussed different options. Adding a new tag (e.g. <subref>) was discussed carefully, but we wanted to stick to the existing <ref> approach, to minimize the amount of new syntax users have to learn. Besides, introducing a new tag would require many updates to existing community software (tools, gadgets, bots etc.) for referencing.
One proposal (from 2008) was to specify the subreference’s details within the <ref> tag: <ref page="page 2" name="Miller"> or later <ref detail="page 2" name="Miller"> using the name attribute to refer to the main reference. This is similar to what users know from working with templates like {{cite book}}.
The main issue with this approach is, however, that it causes problems with templates and is very likely to cause errors. Another problem with this syntax is that it does not allow to re-use a sub-reference, because the name attribute has already been used to refer to the main reference and cannot be used a second time.
A way to avoid both these issues is to create a new reference attribute and put the sub-reference’s details in the area between the opening and closing <ref> tags, the same way it is already done for the content of references. This is what our approach does.
Why did it take so long to find a solution?
The Technical Wishes team has worked on this feature on and off for many years. If you want to know more, here’s an overview of the history and complexity of this problem.