Jump to content

WMDE Technical Wishes/Sub-referencing/fr

From Meta, a Wikimedia project coordination wiki
This page is a translated version of the page WMDE Technical Wishes/Sub-referencing and the translation is 47% complete.
Sous-références
StatusEn cours
OriginEnquête des vœux techniques 2013, 2015, 2022 et d'autres
Focus areaFaciliter la réutilisation de références
Phabricatorcomité 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
En savoir plus sur les tests et les commentaires

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.

Le sous-référencement sera déployé sur Wikipédia en allemand à partir de septembre 2025 et sur d'autres wikis pilotes à partir de février 2026. Nous prévoyons d'étendre le sous-référencement aux autres wikis Wikimedia en 2026.

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. Sur l'écran ci-dessous "1. E. Miller …" dans la section des Références est la référence principale.
  • Une sous-référence définit les détails supplémentaires tels que les numéros de page, les chapitres, les versets, les citations, ou es références temporelles pour les vidéos. Sur l'écran, "1.1" et "1.2" suivis d'un numéro de page représentent deux sous-références distinctes.
sous-référencement – exemple


  • Dans la section des références, les lecteurs voient toutes les sous-références regroupées sous leur référence principale commune. Cela permet de mieux comprendre la fréquence à laquelle une même source a été citée dans l'article.
  • 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 élargissons la boîte de dialogue de citation existante afin qu'elle prenne en charge 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 VisualEditor and wikitext.
  • La solution sera intégrée dans l'extension MediaWiki Cite, disponible dans tous les wikis Wikimedia et utilisable sans solutions de travail 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.
Dites-nous ce que vous en pensez. Il est important que cette nouvelle fonctionnalité n'interrompe pas le flux de travail des utilisateurs, soit intuitive et fonctionne bien pour le Wikitexte et l'Éditeur Visuel peu importe leur niveau d'expérience ou de connaissance à propos du Wikitexte et des modèles. Pour s'assurer de cela, nous avons besoin de vos retours:

Comment ça marche

En Wikitexte

La solution wikitext pour les sous-références peut être testée sur le cluster bêta. Avantages spécifiques au wikitexte :

  • La solution utilise 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.

 


 

Defining 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.

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:

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 ==
<references /> <!-- or {{reflist}} -->

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:

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 ==
<references /> <!-- or {{reflist}} -->

Creating a sub-reference 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:

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>

Re-using a 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 this is not a regular reuse like you are used to with other references. While it does create some duplicates in wikitext, identical sub-references will be automatically merged in the reader and VisualEditor view to prevent unnecessary duplication in the rendered output.
  • The same re-use option already works for regular references (both list-defined and inline).
  • Tip: Copying and pasting an existing sub-reference statement remains a simple and recommended approach.

Example – reuse of inline sub-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 ==
<references /> <!-- or {{reflist}} -->

Example – reuse of list-defined sub-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>

Converting existing references to sub-references

Edit the reference which is supposed to become the new main reference by moving details like page numbers to the new details="…" attribute. Replace similar references with sub-references.

Example: Wikitext without sub-references:

According to scientists,<ref name="Miller">E. Miller, ''The Sun''. New York: Academic Press, 2005. Page 23.</ref> the Sun is pretty big.<ref>E. Miller, ''The Sun''. New York: Academic Press, 2005. Page 30.</ref> In fact, it is very big.<ref>E. Miller, ''The Sun''. New York: Academic Press, 2005. Page 35.</ref> Take their word for it.<ref>E. Miller, ''The Sun''. New York: Academic Press, 2005. Page 48.</ref> Don't look directly at the sun!<ref name="Miller" />

== References ==
<references /> <!-- or {{reflist}} -->

Example: Wikitext once references are converted to sub-references

Note that the first reference has been converted to a main reference (including details), the other references have been converted to sub-references.

According to scientists,<ref name="Miller" details="Page 23.">E. Miller, ''The Sun''. New York: Academic Press, 2005</ref> the Sun is pretty big.<ref name="Miller" details="Page 30." /> In fact, it is very big.<ref name="Miller" details="Page 35." /> 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 /> <!-- or {{reflist}} -->

Nesting sub-references

It is possible to use nested footnotes with sub-referencing. Multi-level nesting will probably work as well, although it's not actively supported.

Example: Nesting sub-references using {{refn}}

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.{{refn|group="notes"|Some scientists disagree.<ref details="Page 30." name="Miller" />}} Take their word for it.<ref name="Miller" details="Page 48." />.

== Notes ==
<references group="notes" />

== References ==
<references />

Templates and sub-references

Templates can be used within sub- and main references just as with regular references.

Example: Sub-references using an example {{subref}} template

According to scientists, the Sun is pretty big.<ref name="Miller" details="{{Subref|page=23|quote=It's soo big}}">{{Cite book |last=Miller |first=E. |title=The Sun |publisher=Academic Press |location=New York |date=2005}}</ref> In fact, it is very big. Take their word for it.<ref name="Miller" details="{{Subref|page=48}}" /> Don't look directly at the sun!<ref name="Miller" details="{{Subref|page=50|quote=Don't do it}}" />

== References ==
<references /> <!-- or {{Reflist}} -->

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 " within details="…" (e.g. when inserting a quote), make sure to use &quot; instead, or delimit the details with single quotes. VisualEditor 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 with details="…" 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 VisualEditor which we cannot solve at this point in time.


ÉditeurVisuel

The VisualEditor implementation for sub-references can be tested on the beta cluster. Some details still need to be fixed, other features might evolve after after pilot wiki deployment. Benefits specific to VisualEditor:

  • To cite the same source with different details, you no longer have to create a new reference from scratch.
  • Sub-references are designed to be fully compatible with VisualEditor (as opposed to template-based workarounds).

 


 

Defining a main reference

  • Use the existing citation dialog to create a main reference that contains the full bibliographic information except for the details (e.g. page numbers) you want to use in sub-references.

Créer une sous-référence

  • Select a re-used reference or create a re-use (either by copy and pasting a reference or by using the re-use citation dialog).
  • Click on the "add details" button which appears in the reference popup if the reference is re-used.
  • Entrez les détails de cette sous-référence et cliquez sur Appliquer les modifications.

Modifier une sous-référence

  • Cliquez sur le marqueur de note de bas de page dans le texte de l'article et sélectionnez le deuxième bouton d'édition (l'icône en forme de stylo) pour modifier une sous-référence.
  • Vous pouvez maintenant modifier les détails de la sous-référence.
  • Vous ne pouvez pas modifier une sous-référence en cliquant dessus dans la liste de référence - modifier la référence principale de cette façon fonctionne comme d'habitude.

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.
  • Alternatively, you can – as with regular references – select the footnote of a sub-reference and copy it to the desired location in the article using copy & paste, which also creates a re-use.

Converting existing references to sub-references

  • Select a re-used reference (or create a re-use).
  • Click edit, copy the details you want to use for sub-referencing (e.g. the page number) and delete the details to turn the reference into a main reference.

  • Click on the "add details" button.
  • Paste (or enter) the details you just removed and click "apply changes".
  • Replace other similar references with re-uses of the main reference and add details for each of those.

Templates and sub-references

Templates can be used within sub- and main references just as with regular references.

  • Click on the "add details" button.
  • Use the "insert" button to choose a template.
  • Use the template dialog to search for the desired template.
  • Fill out the template parameters and insert the template.
  • The sub-reference is now displayed with the template.

Veuillez noter

  • We are working on creating an even more intuitive user experience for using references in VisualEditor. What you see now is just the beginning, among other things we have ideas for an improved reference editing dialogue. We will ask for feedback on some prototypes after deploying sub-referencing to the first pilot wikis.
  • Le comportement actuel consistant à créer des noms automatiques pour les références réutilisées dans VisualEditor se produit également avec les sous-références. La résolution de ce problème n'entre pas dans le cadre de ce projet.

We've decided to remove the option to create sub-references via the "re-use" tab in the citation dialog for our pilot wiki release, because our user testing indicated it's not very intuitive. We will gather additional feedback after the pilot wiki deployment to check if we should add the option again in later iterations (and if so, how we can improve it).


 Tester le prototype

Nous avons besoin de vos commentaires pour nous assurer que nous développons les bonnes fonctionnalités. Vos commentaires ou questions sont toujours les bienvenus sur la page de discussion de ce projet ou en prenant directement rendez-vous avec notre chercheur utilisateur. Le prototype est disponible sur le wiki bêta.

Rester sur un wiki en beta Leave feedback Book a call

Veuillez noter que les wikis beta sont légèrement différents des wikis normaux:
  • 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é.
  • Votre identifiant Wikimedia habituel ne fonctionne pas sur les wikis bêta. Vous pouvez soit créer un compte (veillez à utiliser un mot de passe différent de celui de votre compte Wikimedia habituel), soit tester la fonctionnalité sans compte, ce qui entraînera la création d'un compte temporaire.

In Progress

Subreferencing is now ready in Wikitext and VisualEditor and deployed to German, Polish and Swedish Wikipedia as well as some other pilot wikis to gain new insights for future improvements. Some of our next steps:

  • While there are no issues with regular diffs, Visual diffs currently don't display sub-references correctly (phab:T397319).
  • VisualEditor edits in articles using sub-references sometimes lead to unexpected changes to the wikitext without effect on the reader's view ("dirty diffs"), e.g. replacing <references /> with <references></references> (phab:T403379).
  • Newlines within sub-references in wikitext currently don't load in VisualEditor (phab:T390266).
  • There are still issues with VisualEditor and {{Reflist}} which we need to solve before deploying to projects using similar templates.

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.

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.

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}} :

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 :

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 déjà. Voici un aperçu de l'historique de ce projet, y compris nos recherches.

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

  • Green tickY We have deployed sub-referencing in September 2025 to German Wikipedia as our first pilot wiki.
  • Green tickY Read more about our learnings and observations from three months of sub-referencing on German Wikipedia.
  • Green tickY We have deployed sub-referencing to additional pilot wikis in February 2026. (phab:T414094)
  • We are continuously improving the feature and implementing community feedback.

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.
  • We are planning to deploy the sub-referencing feature to other Wikimedia wikis in 2026.
  • Check our report and phab:T414094 for our preliminary deployment plan and our roadmap for upcoming improvements to sub-referencing.
  • We will continue to collect feedback to improve the solution after deployment.

Archived updates from 2025

  • Green tickY 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.
  • Green tickY 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.
  • Green tickY 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.
  • Green tickY We have deployed sub-referencing in September 2025 to German Wikipedia as our first pilot wiki.
  • Green tickY We are improving sub-referencing and will reach out to other potential pilot wikis in the upcoming months.

Archived updates from 2024

  • Green tickY 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.
  • Green tickY Nous avons envoyé des annonces sur tous les wikis pour informer les communautés de cette fonctionnalité à venir, et nous les avons invités à tester et à donner des commentaires.
  • Green tickY Our team presented sub-referencing at Wikimania 2024 and discussed with participants. (YouTube)
  • Green tickY 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?

Yes, you can insert templates in both the main- and the sub-reference. We've initially received feedback suggesting that using templates in an attribute may cause more issues than benefits. Other users explicitly wished for template support, especially in visual editor. Please share your thoughts on sub-references and templates on the 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 VisualEditor.

Furthermore, we’re confident that this approach will work consistently across VisualEditor 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.