WMDE Technical Wishes/Sub-referencing/fr
| 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 | |
Actuellement, il n'est pas possible de facilement réutiliser la même référence avec des détails différents 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
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.
Our plan is to bring Sub-referencing to the Wikimedia wikis in 2025.
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.
- A sub-reference defines additional details, such as page numbers, chapters, verses, quotes, or video timestamps. In the screenshot, "1.1" and "1.2" followed by a page number represent two different sub-references.
- 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.
In wikitext you use a new attribute to define the details of a sub-reference. It’s called details. See below for more information and examples.
Dans l'Éditeur Visuel, nous changeons le dialogue de citation existant pour qu'il permette les sous-références.
Bénéfices principaux
- Sub-referencing is largely based on the existing way references work.
- It's designed to work for both Visual Editor and wikitext.
- 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.
Comment ç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.
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.
How to use Sub-referencing in wikitext
1) Define a Main Reference
Before creating sub-references, you need a main reference that contains the full bibliographic information. This reference must be assigned a name:
<ref name="Miller">E. Miller, ''The Sun''. New York: Academic Press, 2005.</ref>
This main reference can either be defined in-line (within the article text) or in the reference section.
2) Creating a Sub-reference for Inline References
If the main reference is inline, you can create a sub-reference in two ways using the details attribute:
Option 1: Modify the main reference to include additional details (e.g. a page number)
<!-- Add the details attribute directly to the <ref> tag -->
<ref name="Miller" details="Page 23.">E. Miller, ''The Sun''. New York: Academic Press, 2005.</ref>
<!-- As a next step, you can add another sub-reference using the following statement: -->
<ref name="Miller" details="Page 48." />
Example Usage:
According to scientists, the Sun is pretty big. In fact, it is very big.<ref name="Miller" details="Page 23.">E. Miller, ''The Sun''. New York: Academic Press, 2005.</ref> Take their word for it.<ref name="Miller" details="Page 48." />
== References ==
{{reflist}} <!-- or <references /> -->
Option 2: Insert one or more separate sub-references directly within a new in-line statement while keeping the main reference intact.
<!-- Unchanged main reference (in-line): -->
<ref name="Miller">E. Miller, ''The Sun''. New York: Academic Press, 2005.</ref>
<!-- New sub-references: -->
<ref name="Miller" details="Page 23." />
<ref name="Miller" details="Page 48." />
Example Usage:
According to scientists, the Sun is pretty big. <ref name="Miller">E. Miller, ''The Sun''. New York: Academic Press, 2005.</ref> In fact, it is very big.<ref name="Miller" details="Page 23." /> Take their word for it.<ref name="Miller" details="Page 48." />.
== References ==
{{reflist}} <!-- or <references /> -->
3) Create Sub-References for List-Defined References
If the main reference is stored in the <references> tag or within {{reflist}} (or similar templates), you don't need to redefine it in-line. Instead, simply use the following syntax in-line:
<!-- Add this directly to the chosen location in the article text -->
<ref name="Miller" details="Page 23." />
<!-- The list-defined reference stays unchanged: -->
<references>
<ref name="Miller">E. Miller, ''The Sun''. New York: Academic Press, 2005.</ref>
</references>
Example Usage:
According to scientists, the Sun is pretty big. In fact, it is very big.<ref name="Miller" details="Page 23." /> Take their word for it.<ref name="Miller" details="Page 48." />
== References ==
<references>
<ref name="Miller">E. Miller, ''The Sun''. New York: Academic Press, 2005.</ref>
</references>
4) Reusing an Existing Sub-reference
Once a sub-reference has been defined, you can reuse it in multiple places without redefining the main reference. Simply repeat the same reference syntax in-line:
<ref name="Miller" details="Page 23." />
- Please note that while this is not a pure reuse like you are used to with main references and does create duplicates in wikitext, in the reader and Visual Editor view, identical statements will be merged to prevent unnecessary duplication in the rendered output. This is still work in progress.
- The same re-use statement applies for list-defined and inline main references.
- Tip: Copying and pasting an existing sub-reference statement remains a simple and recommended approach.
Example Usage for Reuse of Inline References:
According to scientists, the Sun is pretty big.<ref name="Miller" details="Page 23.">E. Miller, ''The Sun''. New York: Academic Press, 2005</ref> In fact, it is very big. Take their word for it.<ref name="Miller" details="Page 48." /> Don't look directly at the sun!<ref name="Miller" details="Page 23." />
== References ==
{{reflist}}
Example Usage for Reuse of List-defined References:
According to scientists, the Sun is pretty big.<ref name="Miller" details="Page 23." /> In fact, it is very big. Take their word for it.<ref name="Miller" details="Page 48." /> Don't look directly at the sun!<ref name="Miller" details="Page 23." />
== References ==
<references>
<ref name="Miller">E. Miller, ''The Sun''. New York: Academic Press, 2005</ref>
</references>
Keep In Mind
- Remember to always specify a reference name when using the details attribute. Using a reference name allows others to easily re-use the same reference with different details without needing to define a name first.
- Sub-referencing is not reserved for page numbers only. You can use it for other use cases, too. Some editors have mentioned to us that they’d like to use it for podcast timestamps, URLs, poetry verses, quotes, and other details.
- If you wish to use quotation marks
"withindetails="…"(e.g. when inserting a quote), make sure to use"instead, or delimit the details with single quotes. Visual Editor users will be able to type " when filling out sub-reference details and it will be converted automatically in wikitext. Other special characters which might need to be handled similarly when used withdetails="…"are<and>. - Some gadgets/scripts related to references might also need an update in order to properly work with the new sub-referencing solution.
- When using sub-references, please avoid templates that produce
<ref>tags, as these cause issues in Visual Editor which we cannot solve at this point in time.
Dans l'Éditeur Visuel (en cours de développement)
We are actively refining the user experience and workflows for Sub-referencing in Visual Editor. Currently, there is one entry point via the “re-use” tab for creating a sub-reference, but the solution for Visual Editor is expected to evolve in the coming months.
You can also test the prototype with the current state of the Visual Editor solution. Please keep in mind that it will likely change. As always, we will keep you and these project pages updated as Visual Editor gains more capabilities and let you know when we need your feedback!
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
- Cliquez sur le marqueur de la 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.
- We are actively working on creating an even more intuitive user experience for Visual Editor. What you see now is just the beginning, it will be refined and improved over time.
- Nous n'avons pas encore décidé sur ce qui se passe lorsque vous supprimez une référence qui est réutilisée.
- Currently, if you re-use a sub-reference it will show as a duplicate in the reference list. Once the Visual Editor's UX has evolved, the duplicates will automatically be merged in Visual Editor and the reader view.
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 arrive 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 contournements.
Status quo: réutilisation des références en wikitexte et dans l'Éditeur Visuel
Si vous souhaitez réutiliser une référence dans le Wikitexte, vous pouvez la transformer en référence nommée et faire référence à ce nom à un autre endroit de l'article. La référence nommée peut être placée dans le texte de l'article ou dans la section de référence. Dans l'Éditeur visuel, vous pouvez utiliser l'option « Re-use » dans la boîte « Add a citation ». Dans la section de référence, les références portant le même nom sont regroupées.
-
Wikitext : <ref name> dans le texte de l'article -
Wikitext : <ref name> dans la section de référence -
Éditeur visuel : boîte de dialogue de source -
Point de vue du lecteur
Statu quo : réutilisation de références avec des détails différents dans le Wikitexte
Si vous souhaitez réutiliser une référence existante avec des détails différents dans le Wikitexte, vous devez actuellement copier et coller la référence existante et modifier les détails du doublon ou créer une nouvelle référence (presque identique) à partir de zéro. Certains projets utilisent des solutions de contournement comme les références courtes ou des solutions basées sur des modèles comme les notes de bas de page raccourcies. Dans la section de référence, la référence d'origine et la nouvelle que vous avez créée ne sont pas regroupées.
-
Deux références presque identiques dans le Wikitexte. -
Point de vue du lecteur : Les références presque identiques ne sont pas regroupées -
Solution de contournement avec les références courtes dans le Wikitexte -
Point de vue du lecteur : solution de contournement avec des références courtes -
Solution de contournement avec {{sfn}} dans le Wikitext -
Point de vue du lecteur : solution de contournement avec {{sfn}}
Statu quo : réutilisation de références avec des détails différents dans l'Éditeur visuel
Si vous souhaitez réutiliser une référence existante avec des détails différents dans l'éditeur visuel, ni l'option « Réutiliser » dans la boîte de dialogue de source, ni la méthode copier-coller ne fonctionneront, car les deux conduisent à des « réutilisations identiques », et la modification des détails de la référence réutilisée/copiée modifie les « deux » instances de cette référence. Au lieu de cela, vous devrez créer une nouvelle référence (presque identique) à partir de zéro. Dans la section de référence, la référence d'origine et la nouvelle que vous avez créée ne sont pas regroupées.
Les références créées par des solutions de contournement basées sur des modèles comme {{sfn}} ne peuvent pas être modifiées à partir de la section de référence et n'apparaissent pas dans l'onglet de réutilisation des citations ; mais il est possible de les modifier manuellement lors de leur localisation dans le texte de l'article.
solution de contournement avec {{sfn}} :
-
Point de vue du lecteur -
Les références disparaissent de la section de référence en cliquant sur « Publier ». -
Il n'est pas possible d'utiliser les références {{sfn}} via la boîte de dialogue «Réutiliser ». -
Les références ne peuvent être modifiées que lors de la localisation de la référence dans le texte de l'article
Problèmes pour les lecteurs
Les solutions de contournement basées sur des modèles ne s'affichent pas correctement dans les Aperçus de référence, les info-bulles de référence et les fenêtres contextuelles de référence mobile.
Solution de contournement de {{sfn}} avec des aperçus pour les références :
-
Aperçu des références : Les informations principales ne sont pas incluses dans la fenêtre contextuelle. -
Info-bulles de référence : Les informations principales ne sont pas incluses dans la fenêtre contextuelle initiale. -
Info-bulles de référence : Les informations principales sont affichées dans une autre fenêtre contextuelle. -
Pop-ups de référence mobile : les informations principales ne sont pas incluses.
Principaux problèmes du statu quo
- L'expérience des utilisateurs de l'Éditeur visuel et du Wikitexte est très différente.
- La plupart des solutions de contournement pour réutiliser des références avec des détails différents ne fonctionnent pas correctement dans l'Éditeur visuel.
- La création de nombreuses références presque identiques avec des détails différents rend le Wikitexte plus long et potentiellement plus difficile à lire.
- Les solutions de contournement basées sur des modèles ne sont pas acceptées de la même manière par toutes les communautés et ne sont donc pas disponibles à l'échelle mondiale.
- Certains utilisateurs tentent d'éviter ce problème en plaçant les sources dans la section bibliographie sans les utiliser du tout comme références, ce qui rend plus difficile la vérification des sections de l'article.
Changements récents et prochaines étapes
Notre équipe travaille sur ce problème de manière intermittente depuis un certain temps maintenant. Voici un aperçu de l'historique de ce projet, y compris nos recherches.
Merci à tous ceux qui ont participé aux tests et aux entretiens et qui ont manifesté leur intérêt, ainsi qu'à tous ceux qui ont pris le temps de commenter nos pages de discussion au fil des ans. Nous vous en sommes très reconnaissants. Si vous avez d'autres commentaires, n'hésitez pas à les partager sur la page de discussion.
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.
Updates March 2025
In 2024 we worked on a prototype for discovery and testing purposes based on the extends syntax and engaged with the community through multiple on-wiki communications, user testing sessions, and workshops in different venues, including Wikimania 2024.- In October/November 2024, we explored possible changes to our wikitext approach, based on the community feedback we've received. We reached out to communities and presented a new solution to get their feedback on its usability. We found that the feedback was mixed but nothing spoke against the feature bringing its intended value to the community.
- In 2025, we started the development of the new syntax. The engineers and designer of the Technical Wishes team are working on building out Sub-referencing.
Next Steps
The Technical Wishes team’s focus remains on completing the sub-referencing feature.
- We’ll update you continuously as the feature evolves on the betawiki and we need you to test it.
- Conducting user testing sessions with community members to help us with intuitively designing the Visual Editor workflows.
- Once the development has reached a stable state, we will reach out to Pilot wikis to plan deployments.
- We are planning to deploy the sub-referencing feature to other Wikimedia wikis in 2025.
- We will continue to collect feedback to improve the solution after deployment.
Nous sommes conscients d'autres problèmes dans le domaine d'intérêt « réutiliser des références » et nous allons essayer de les résoudre au fur et à mesure. Notre objectif reste cependant de créer une solution pour le sous-référencement.
Archived updates from 2024
- Un prototype est disponible sur le wiki bêta. Il couvre la solution Wikitext et certaines des fonctionnalités de base de la solution Éditeur visuel. Vous pouvez continuellement tester le prototype et donner votre avis.
- Nous enverrons des annonces sur tous les wikis pour informer les communautés de cette fonctionnalité à venir et les inviter à la tester et à donner leur avis.
- Our team presented Sub-referencing at Wikimania 2024 and discussed with participants. (YouTube)
- Moderated users tests took place across different projects in 2024.
- As of October/November 2024, we are currently exploring possible changes to our wikitext approach, based on the community feedback we've received. We'll reach out to communities soon to get more feedback on possible changes to the Sub-referencing feature.
- Pilot wiki deployment is stalled, pending discussions and potential changes to our feature.
- We are planning to deploy the Sub-referencing feature to other Wikimedia wikis in 2025.
- Nous continuerons à recueillir des commentaires pour améliorer la solution après le déploiement.
Foire aux questions
Comment puis-je trouver des articles qui utilisent des sous-références ?
A tracking category called Category:Pages that use sub-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.
Also, the team has created a number of examples on the English betawiki.
Can I insert a template into the details attribute?
The feedback we received so far from the community suggests that using templates in an attribute may cause more issues than benefits. As such, we are evaluating whether to allow templates based on technical feasibility, their impact on Visual Editor’s rendering of references, and other concerns raised by contributors.
We will update you once we have learned more and a decision has been made. Please know that we will always include the community before such a decision is made. If you already have specific ideas about the use of templates within the details attribute, please let us know on our talk page.
How will the new feature affect existing gadgets and scripts?
Some gadgets and scripts related to references might need an update in order to properly work with the new Sub-referencing solution. Because 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.
Pourquoi avez-vous choisi cette syntaxe Wikitexte ?
This post provides a rationale for choosing the details syntax. We believe that the best and quickest path to delivering a usable feature is through the chosen syntax, even though it does come with some limitations.
Historically, no syntax has been perfect, and each solution has its shortcomings. After long discussions and consultations with multiple teams at the Wikimedia Foundation, we've concluded that this solution meets our technical requirements and is sustainable for long-term maintenance.
It's also fully compatible with wikis that continue to rely on or prefer using {{reflist}}. This syntax allows the main reference to be used in-line without needing to be placed in the References section, which would otherwise cause limitations in the Visual Editor.
Furthermore, we’re confident that this approach will work consistently across Visual Editor workflows as well.
Pourquoi a-t-il fallu autant de temps pour trouver une solution ?
L'équipe Technical Wishes a travaillé sur cette fonctionnalité de manière intermittente pendant de nombreuses années. Si vous souhaitez en savoir plus, voici un aperçu de l'historique et de la complexité de ce problème.