Souhaits techniques pour WMDE/Sous-références

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 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 Wikicode 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 est déployé sur les Wikipédia en tchèque, en français, en allemand, en italien, en polonais et en suédois, ainsi que sur quelques petits wikis à partir de juin 2026. Nous prévoyons d’étendre le sous-référencement aux autres wikis de Wikimédia en 2026.

• » Foire aux questions
• » Changements récents et prochaines étapes

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érence 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 les références temporelles pour les vidéos. Sur la capture, "1.1" et "1.2" suivis d'un numéro de page représentent deux sous-références distinctes.

• 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.
• Dans le wikicode, un nouvel attribut details permet de définir les détails d’une sous-référence. Des explications détaillées avec des exemples sont données plus bas.
• Dans l’Éditeur Visuel, nous ajoutons dans la boîte de dialogue déjà présente « Sourcer » la prise en charge des sous-références.

Bénéfices principaux

• Les sous-références fonctionneront de la même manière que les références actuellement.
• Elles fonctionneront avec l’Éditeur Visuel et en wikicode.
• La solution sera intégrée dans l'extension MediaWiki Cite, disponible dans tous les wikis Wikimedia : il n’y aura plus besoin d’utiliser les modèles qui mettaient en place une solution palliative.
• Les sous-références seront affichées correctement dans les Aperçus de Références et dans les fenêtres contextuelles de références sur mobile.
• Elles sont facultatives : vous pouvez toujours utiliser d'autres méthodes pour sourcer. 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, qu'elle soit intuitive et fonctionne bien pour le Wikicode et l'Éditeur Visuel peu importe leur niveau d'expérience ou de connaissance à propos du Wikicode et des modèles. Pour s'assurer de cela, nous avons besoin de vos retours :

• Essayez le prototype ! En savoir plus sur comment tester.
• Donner des retours sur la page de discussion.
• Suivez cette page ou abonnez-vous à cette liste de diffusion pour en savoir plus sur de nouvelles fonctionnalités à tester.

Comment ça marche

En Wikicode

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

• La solution utilise le concept existant et connu de références nommées.
• Elle ne nécessite aucune connaissance des modèles.
• Les références presque dupliquées peuvent être supprimées dans le wikicode, ce qui le rend plus propre, moins redondant et plus facile à lire.

 

---

 

Définir une référence principale

Avant de créer des sous-références, vous devez avoir une référence principale qui contient les informations bibliographiques complètes. Cette référence doit avoir un nom :

<ref name="Miller">E. Miller, ''The Sun''. New York: Academic Press, 2005.</ref>

Cette référence principale peut être intégrée (c’est-à-dire définie au sein du contenu) ou dans la section Références.

Créer une sous-référence pour des références intégrées

Si la référence principale est intégrée, vous pouvez créer une sous-référence de deux manières en utilisant l’attribut details :

option 1 : modifier la référence principale pour y ajouter les détails additionnel (par exemple le numéro de page) ;

<!-- Ajoutez l'attribut details directement à la balise<ref>étiquette</ref> -->
<ref name="Miller" details="p. 23.">E. Miller, ''The Sun''. New York: Academic Press, 2005.</ref>

<!-- Dans un deuxième temps, vous pouvez ajouter une autre sous-référence à l'aide de l'instruction suivante : -->
<ref name="Miller" details="p. 48." />

Exemple :

Wikicode	Résultat
Selon les scientifiques, le Soleil est assez grand. En effet, il est vraiment très grand.<ref name="Miller" details="p. 23">E. Miller, ''The Sun''. New York: Academic Press, 2005.</ref> Croyez-les sur parole.<ref name="Miller" details="p. 48"/> == Références == <references /> <!-- ou {{reflist}} -->	Selon les scientifiques, le Soleil est assez grand. En effet, il est vraiment très grand. Croyez-les sur parole. Références

Option 2 : insérer une ou plusieurs sous-références séparée directement intégrée dans le contenu en laissant la référence principale inchangée ;

<!-- Référence principale inchangée : -->
<ref name="Miller">E. Miller, ''The Sun''. New York: Academic Press, 2005.</ref>
<!-- Nouvelles sous-références -->
<ref name="Miller" details="p. 23." />
<ref name="Miller" details="p. 48." />

Exemple :

Wikicode	Résultat
Selon les scientifiques, le Soleil est assez grand.<ref name="Miller">E. Miller, ''The Sun''. New York: Academic Press, 2005.</ref> En effet, il est vraiment très grand.<ref name="Miller" details="p. 23" /> Croyez-les sur parole.<ref name="Miller" details="p. 48"/> == Références == <references /> <!-- ou {{reflist}} -->	Selon les scientifiques, le Soleil est assez grand. En effet, il est vraiment très grand. Croyez-les sur parole. Références

Créer une sous-référence pour une référence listée dans la section dédiée

Si la référence principale est enregistrée au sein de la balise <references>, vous n’avez pas à la redéfinir dans le contenu. À la place, utilisez simplement la syntaxe suivante dans le contenu :

<!-- Ajoutez ceci directement à l'emplacement choisi dans le texte de l' article -->
<ref name="Miller" details="p. 23." />

<!-- La référence définie par la liste reste inchangée : -->
<references>
<ref name="Miller">E. Miller, ''The Sun''. New York: Academic Press, 2005.</ref>
</references>

Exemple :

Wikicode	Résultat
Selon les scientifiques, le Soleil est assez grand. En effet, il est vraiment très grand.<ref name="Miller" details="p. 23" /> Croyez-les sur parole.<ref name="Miller" details="p. 48"/> == Références == <references> <ref name="Miller">E. Miller, ''The Sun''. New York: Academic Press, 2005.</ref> </references>	According to scientists, the Sun is pretty big. In fact, it is very big. Croyez-les sur parole. Références

Sachez que nous recommandons de ne pas utiliser {{reflist|refs=...}} pour les références définies car cela cause des problèmes pour les utilisateurs de l’Éditeur Visuel.

Réutiliser une sous-référence

Dès lors qu’une sous-référence a été définie, vous pouvez la réutiliser à plusieurs endroits sans redéfinir la référence principale. Répétez simplement la même syntaxe de référence intégrée :

<ref name="Miller" details="Page 23." />

• Attention : il ne s’agit pas d’une réutilisation classique, comme pour d’autres références. Même si le wikicode semble contenir des doublons, les sous-références identiques seront automatiquement fusionnées dans le rendu pour ne pas créer de doublon lors de la lecture.
• La même possibilité de réutilisation fonctionne déjà pour les références classiques (à la fois celles définies dans la balise Références et celles intégrées).
• Astuce : copier et coller une déclaration de sous-référence reste une façon de faire simple et recommandée.

Exemple – réutilisation de sous-références intégrées :

Wikicode	Résultat
Selon les scientifiques, le Soleil est assez grand.<ref name="Miller" details="p. 23">E. Miller, ''The Sun''. New York: Academic Press, 2005.</ref> En effet, il est vraiment très grand. Croyez-les sur parole.<ref name="Miller" details="p. 48"/> Ne regardez pas directement le Soleil !<ref name="Miller" details="p. 23" /> == Références == <references /> <!-- ou {{reflist}} -->	Selon les scientifiques, le Soleil est assez grand. En effet, il est vraiment très grand. Croyez-les sur parole. Ne regardez pas directement le Soleil ! Références

Exemple – réutilisation de sous-références listées dans la balise Références :

Wikicode	Résultat
Selon les scientifiques, le Soleil est assez grand.<ref name="Miller" details="p. 23" /> En effet, il est vraiment très grand. Croyez-les sur parole.<ref name="Miller" details="p. 48"/> Ne regardez pas directement le Soleil !<ref name="Miller" details="p. 23" /> == Références == <references> <ref name="Miller">E. Miller, ''The Sun''. New York: Academic Press, 2005.</ref> </references>	Selon les scientifiques, le Soleil est assez grand. En effet, il est vraiment très grand. Croyez-les sur parole. Ne regardez pas directement le Soleil ! Références

Convertir des références existantes en sous-références

Modifiez la référence qui est supposée devenir la référence principale en déplaçant les détails tels que le numéro de page dans le nouvel attribut details="…". Puis remplacez les références similaires par des sous-références.

Exemple – wikicode sans sous-références :

Wikicode

Résultat

Selon les scientifiques,<ref name="Miller">E. Miller, ''The Sun''. New York: Academic Press, 2005, p. 23.</ref> Le Soleil est assez grand.<ref>E. Miller, ''The Sun''. New York: Academic Press, 2005, p. 30.</ref> En effet, il est vraiment très grand.<ref>E. Miller, ''The Sun''. New York: Academic Press, 2005, p. 35.</ref> Croyez-les sur parole.<ref>E. Miller, ''The Sun''. New York: Academic Press, 2005, p. 48.</ref> Ne regardez pas directement le Soleil !<ref name="Miller" /> == Références == <references /> <!-- ou {{reflist}} -->

Selon les scientifiques, Le Soleil est assez grand. En effet, il est vraiment très grand. Croyez-les sur parole. Ne regardez pas directement le Soleil ! Références

Exemple – wikicode après que les références sont converties en sous-références :

Notez que la première référence a été convertie en référence principale (y compris les détails), les autres sont devenues des sous-références.

Wikicode

Résultat

Selon les scientifiques,<ref name="Miller" details="p. 23">E. Miller, ''The Sun''. New York: Academic Press, 2005.</ref> Le Soleil est assez grand.<ref name="Miller" details="p. 30" /> En effet, il est vraiment très grand.<ref name="Miller" details="p. 35" /> Croyez-les sur parole.<ref name="Miller" details="p. 48"/> Ne regardez pas directement le soleil !<ref name="Miller" details="p. 23" /> == Références == <references /> <!-- ou {{reflist}} -->

Selon les scientifiques, Le Soleil est assez grand. En effet, il est vraiment très grand. Croyez-les sur parole. Ne regardez pas directement le Soleil ! Références

Imbrication des sous-références

Il est possible d'utiliser des notes de bas de page imbriquées avec des sous-références. L'imbrication à plusieurs niveaux devrait également fonctionner, bien qu'elle ne soit pas officiellement prise en charge.

Exemple : imbrication de sous-références à l'aide de {{refn}}

Wikicode

Résultat

Selon les scientifiques, le Soleil est assez grand.<ref name="Miller" details="p. 23">E. Miller, ''The Sun''. New York: Academic Press, 2005.</ref> En effet, il est vraiment très grand.{{refn|group="notes"|Certains scientifiques ne sont pas d'accord.<ref details="p. 30." name="Miller" />}} Croyez-les sur parole.<ref name="Miller" details="p. 48"/> == Notes == <references group="notes" /> <!-- ou {{reflist|group=notes}} --> == Références == <references /> <!-- ou {{reflist}} -->

Selon les scientifiques, le Soleil est assez grand. En effet, il est vraiment très grand. Croyez-les sur parole. Notes Références

Modèles et sous-références

Les modèles peuvent être utilisés dans les sous-références et les références principales, comme c'est déjà le cas avec les références.

Exemple : sous-références à l'aide d'un exemple de modèle {{Subref}}

Wikicode

Résultat

Selon les scientifiques, le Soleil est assez grand.<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> En effet, il est vraiment très grand. Croyez-les sur parole.<ref name="Miller" details="{{Subref|page=48}}" /> Ne regardez pas directement le soleil !<ref name="Miller" details="{{Subref|page=50|quote=Don't do it}}" /> == Références == <references /> <!-- ou {{reflist}} -->

Selon les scientifiques, le Soleil est assez grand. En effet, il est vraiment très grand. Croyez-les sur parole. Ne regardez pas directement le Soleil ! Références

À savoir

• N'oubliez pas de toujours indiquer un nom de référence lorsque vous utilisez l'attribut « details ». L'utilisation d'un nom de référence permet à d'autres utilisateurs de réutiliser facilement la même référence avec des détails différents sans avoir à définir un nom au préalable.
• Le sous-référencement ne se réserve pas uniquement aux numéros de page. Vous pouvez l'utiliser autrement aussi. Certains contributeurs nous ont dit qu'ils aimeraient l'utiliser pour les horodotages de podcast, les URL, les vers de poésie, les citations et d'autres détails.
• Si vous souhaitez utiliser des guillemets " dans details="…" (par exemple, pour insérer une citation), veillez à utiliser " à la place, ou à délimiter les détails par des guillemets simples. Les utilisateurs de ÉditeurVisuel pourront saisir " lorsqu'ils renseignent les détails d'une sous-référence ; cela sera automatiquement converti en wikicode. Les autres caractères spéciaux pouvant nécessiter un traitement similaire lorsqu'ils sont utilisés avec details="…" sont < et >.
• 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.
• Lorsque vous utilisez des sous-références, veuillez éviter les modèles qui produisent des balises <ref>, car ils causent des problèmes dans l'ÉditeurVisuel que nous ne pouvons pas résoudre à ce stade.

Dans l'ÉditeurVisuel

La mise en place des sous-références pour l'ÉditeurVisuel peut être testée sur le cluster bêta. Certains détails doivent encore être réglés, et d'autres fonctionnalités pourraient évoluer après le déploiement sur un wiki pilote. Avantages 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 conçues pour être entièrement compatibles avec ÉditeurVisuel (par opposition aux solutions de contournement basées sur des modèles).

 

---

 

Définir une référence principale

• Utilisez la boîte de dialogue de référencement existante pour créer une référence principale contenant toutes les informations bibliographiques, à l'exception des détails (par exemple, les numéros de page) que vous souhaitez utiliser dans les sous-références.

Créer une sous-référence

• Sélectionnez une référence réutilisée ou créez une réutilisation (en copiant et en collant une référence ou en utilisant la boîte de dialogue de réutilisation d'une référence).
• Cliquez sur le bouton "ajouter des détails" qui apparaît dans la fenêtre contextuelle de référence si la référence est réutilisée.
  
• 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.
  
• Vous pouvez également, comme pour les références classiques, sélectionner la note de bas de page d'une sous-référence et la copier à l'endroit souhaité dans l'article à l'aide de copier-coller, ce qui permet également de la réutiliser.

Convertir des références existantes en sous-références

• Sélectionnez une référence réutilisée (ou créez une réutilisation).
• Cliquez sur Modifier, copiez les détails que vous souhaitez utiliser pour le sous-référencement (par exemple, le numéro de page) et supprimez les détails pour transformer la référence en référence principale.
  

• Cliquez sur le bouton " Ajouter des détails ".
  
• Collez (ou écrivez) les détails que vous venez de supprimer et cliquez sur "appliquer des modifications".
  
• Remplacez d'autres références similaires par des réutilisations de la référence principale et ajoutez des détails pour chacune d'elles.

Modèles et sous-références

Les modèles peuvent être utilisés dans les sous-références et les références principales, tout comme dans les références habituelles.

• Cliquez sur le bouton " Ajouter des détails ".
  
• Utilisez le bouton "insérer" pour choisir un modèle.
  
• Utilisez la boîte de dialogue du modèle pour rechercher le modèle souhaité.
  
• Remplissez les paramètres du modèle et insérez le modèle.
  
• La sous-référence est maintenant affichée avec le modèle.
  

Veuillez noter

• Nous travaillons actuellement à la mise en place d'une expérience utilisateur encore plus intuitive pour l'utilisation des références dans ÉditeurVisuel. Ce que vous voyez actuellement n'est qu'un début ; nous avons notamment des idées pour améliorer la boîte de dialogue d'édition des références. Nous solliciterons vos commentaires sur certains prototypes après avoir déployé les sous-références sur les premiers wikis pilotes.
• 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.

Nous avons décidé de supprimer la possibilité de créer des sous-références via l'onglet « Réutiliser » de la boîte de dialogue de citation pour notre version pilote du wiki, car les tests effectués auprès des utilisateurs ont montré que cette fonctionnalité n'était pas très intuitive. Nous recueillerons d'autres retours d'expérience après le déploiement de la version pilote du wiki afin de déterminer s'il convient de réintroduire cette option dans les versions ultérieures (et, le cas échéant, comment l'améliorer).

 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 Laisser des commentaires Réservez un appel

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.

En cours

Le sous-référencement est dès à présent prêt dans le Wikicode et l'ÉditeurVisuel et déployé pour les Wikipédia en tchèque, français, allemand, italien, polonais et suédois ainsi que d'autres plus petits wikis. Voici certaines de nos prochaines étapes:

• Si les diffs classiques ne posent aucun problème, les diffs Visuelles n'affichent actuellement pas correctement les sous-références (phab:T397319).
• Les sauts de ligne dans les sous-références du wikicode ne sont pas actuellement chargés dans ÉditeurVisuel (phab:T390266).
• Nous étudions actuellement des améliorations possibles pour l'affichage en mode lecture, comme indiqué dans notre rapport.

Le problème que nous résolvons

Dans les articles de Wikipédia, il arrive souvent de faire référence à une source plusieurs fois. Bien 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 wikicode et dans l'Éditeur Visuel

Si vous souhaitez réutiliser une référence dans le Wikicode, 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 des références. Dans l'Éditeur Visuel, vous pouvez utiliser l'option « Re-use » dans la boîte « Add a citation ». Dans la section des références, les références portant le même nom sont regroupées.

• 
  Wikicode : <ref name> dans le texte de l'article
• 
  Wikicode : <ref name> dans la section des références
• 
  ÉditeurVisuel : boîte de dialogue d'ajout de références
• 
  Point de vue du lecteur

Statu quo : réutilisation de références avec des détails différents dans le Wikicode

Si vous souhaitez réutiliser une référence existante avec des détails différents dans le Wikicode, 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 des références, 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 Wikicode.
• 
  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 Wikicode
• 
  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'ÉditeurVisuel

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 des références, 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 des références 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 Wikicode 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 Wikicode 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.

Merci à tous les personnes qui ont participé aux tests et aux entretiens et qui ont montré de l'intérêt, ainsi qu'à tous ceux qui se sont réservés le temps de commenter nos pages de discussion au fil des ans. Nous apprécions profondément vos retours. Si vous avez des commentaires supplémentaires, veuillez les partager sur la page de discussion.

Mises à jour

• Y Nous avons déployé les sous-références en septembre 2025 sur la Wikipédia en allemand comme notre premier wiki pilote.
• Y En savoir plus sur nos conclusions et observations issues de trois mois de travail de sous-référencement sur Wikipédia en allemand.
• Y Nous avons déployé le sous-référencement de neuf wikis d'essais additionnels en février 2026, en incluant les Wikipédias polonais et suédois. (phab:T418209)
• Y Nous avons déployé le sous-référencement des Wikipédias tchèques et italiens en avril 2026. (phab:T420938)
• Y Nous avons déployé les sous-références sur la Wikipédia en français et sur la plupart des wikis autres que Wikipédia en juin 2026. (phab:T425662)
• Nous améliorons continuellement la fonctionnalité et mettons en œuvre les retours de la communauté.

Prochaines étapes

L'équipe des souhaits techniques reste concentrée sur la réalisation de la fonction de sous-référencement.

• Nous vous informeront en continu à mesure que la fonction évoluera sur le betawiki et nous avons besoin que vous le testiez.
• Nous prévoyons de déployer graduellement la fonction de sous-référencement sur tous les autres wikis de Wikimédia à partir de juin 2026.
• Consultez notre rapport et phab:T414094 pour découvrir notre plan de déploiement préliminaire ainsi que notre feuille de route concernant les améliorations à venir en matière de sous-référencement.
• Nous continuerons à recueillir des commentaires pour améliorer la solution après son déploiement.

Mises à jour archivées de 2025

• Y En 2024, nous avons travaillé sur un prototype à des fins de découverte et de test basé sur la syntaxe extend et engagé la communauté à travers plusieurs communications sur wiki, des sessions de test d'utilisateurs et des ateliers dans différents lieux, y compris Wikimania 2024.
• Y En octobre/novembre 2024, nous avons étudié les modifications possibles de notre approche du wikicode, en nous appuyant sur les commentaires reçus de la communauté. Nous avons contacté les communautés et leur avons présenté une nouvelle solution afin de recueillir leurs avis sur sa facilité d'utilisation. Nous avons constaté que les avis étaient mitigés, mais rien ne s'opposait à ce que cette fonctionnalité apporte à la communauté la valeur ajoutée escomptée.
• Y En 2025, nous avons commencé à développer la nouvelle syntaxe. Les ingénieurs et les concepteurs de l'équipe des souhaits techniques travaillent à la mise au point du sous-référencement.
• Y Nous avons déployé les sous-références en septembre 2025 sur la Wikipédia en allemand comme notre premier wiki pilote.
• Y Nous améliorons le sous-référencement et nous atteindrons d'autres wikis pilotes potentiels dans les mois à venir.

Mises à jour archivées de 2024

• Y 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.
• Y 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.
• Y Notre équipe a présenté les sous-références à Wikimania 2024 et a discuté avec les participants. (YouTube)
• Y Les équipes de modération ont effectué des test sur différents projets en 2024.
• En octobre/novembre 2024, nous explorons actuellement des changements possibles à notre approche du wikicode, en fonction des commentaires de la communauté que nous avons reçus. Nous allons bientôt contacter les communautés pour obtenir plus de commentaires sur les changements possibles à la fonctionnalité de sous-référencement.
• Le déploiement du wiki pilote est bloqué, en attendant des discussions et des changements potentiels à notre fonctionnalité.
• Nous prévoyons de déployer graduellement la fonctionnalité de sous-référencement sur tous les autres wikis de Wikimédia à partir de juin 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 ?

Une catégorie de suivi intitulée Category:Pages that use sub-references est ajoutée à toute page utilisant des sous-références ce qui vous permet d'explorer ou de corriger les pages qui utilisent cette nouvelle fonctionnalité. Le nom de cette catégorie est susceptible d'être modifié.

En outre, l'équipe a créé un certain nombre d'exemples sur le betawiki en anglais.

<span id="Can_I_insert_a_template_into_the_details_attribute?">

Puis-je insérer un modèle dans l'attribut details ?

Oui, vous pouvez insérer des modèles aussi bien dans la référence principale que dans les sous-références, voir nos exemples pour le wikicode et ÉditeurVisuel. Au départ, nous avons reçu des commentaires indiquant que l'utilisation de modèles dans un attribut pouvait causer plus de problèmes qu'elle n'apportait d'avantages. D'autres utilisateurs ont expressément souhaité que les modèles soient pris en charge, en particulier dans l'éditeur visuel. N'hésitez pas à partager votre avis sur les sous-références et les modèles sur la page de discussion.

Comment puis-je me préparer au déploiement des sous-références ?

• Vérifiez s'il existe des messages de l'outil de Citation non traduits dans votre langue.
• Envisagez de créer la catégorie de suivi cite-tracking-category-ref-details, accessible depuis la page Special:TrackingCategories de votre wiki. Utilisez __HIDDENCAT__ (ou un modèle dédié) pour la masquer aux lecteurs. Ajoutez la catégorie à d:Q129764848.
  • Exemple de la Wikipédia en anglais : en:Category:Pages that use sub-references
• Vérifiez si votre wiki utilise les infobulles de référence et suivez les instructions ci-dessous (ou sur phab:T416304) s'il nécessite une mise à jour. Aucune action n'est requise si votre wiki utilise les aperçus de référence par défaut.
  • Exemple de la Wikipédia en anglais : en:Special:Diff/1344408362
• Pensez à créer des versions localisées de MediaWiki:Cite-ve-dialog-subreference-help-dialog-link et MediaWiki:Cite-ve-dialog-subreference-help-dialog-link-ve sur votre wiki, en remplaçant les liens par défaut Special:MyLanguage par des liens pointant vers la version traduite de cette page de projet. Ce n'est pas obligatoire, mais Special:MyLanguage ne fonctionne pas correctement pour les utilisateurs non connectés : le remplacement du lien par défaut garantit qu'ils accèdent toujours à la page du projet traduite. Il est également possible de remplacer ces liens par des liens vers des pages d'aide de votre wiki local.
  • Exemple de la Wikipédia en français : fr:MediaWiki:Cite-ve-dialog-subreference-help-dialog-link / fr:MediaWiki:Cite-ve-dialog-subreference-help-dialog-link-ve
• Les wikis utilisant MediaWiki:Edittools ou des fonctionnalités de wikicode associées telles que en:MediaWiki:Gadget-charinsert-core.js ou de:MediaWiki:Gadget-editMenus.js peuvent souhaiter ajouter <ref name="..." details="..." /> à ces outils.
  • Exemple de la Wikipédia en polonais : pl:Special:Diff/79273099

Quel sera l'impact de cette nouvelle fonctionnalité sur les gadgets et les scripts existants ?

Certains gadgets et scripts liés aux références pourraient nécessiter une mise à jour pour fonctionner correctement avec la nouvelle solution de sous-référencement. Étant donné que ces gadgets et scripts sont gérés par les communautés wiki, nous ne sommes pas en mesure de les adapter.

Les wikis qui hébergent une copie du gadget Reference Tooltips sont invités à mettre à jour leur version – généralement située à l'emplacement MediaWiki:Gadget-ReferenceTooltips.js – comme indiqué ici. Voir phab:T416304 pour plus d'informations.

N'hésitez pas à nous signaler, sur la page de discussion, tout problème que vous pourriez rencontrer ou à nous demander de l'aide pour mettre à jour les modèles de référence afin qu'ils fonctionnent avec la nouvelle fonctionnalité.

Pourquoi avez-vous choisi cette syntaxe de Wikicode ?

Cet article explique les raisons qui ont motivé le choix de la syntaxe details. Nous pensons que cette syntaxe constitue le moyen le plus efficace et le plus rapide de proposer une fonctionnalité utilisable, même si elle comporte certaines limites.

D'un point de vue historique, aucune syntaxe n'a jamais été parfaite, et chaque solution présente ses inconvénients. Après de longues discussions et consultations avec plusieurs équipes de la Fondation Wikimédia, nous sommes parvenus à la conclusion que cette solution répond à nos exigences techniques et qu'elle est viable pour une maintenance à long terme.

Elle est également entièrement compatible avec les wikis qui continuent de s'appuyer sur {{reflist}} ou qui préfèrent l'utiliser. Cette syntaxe permet d'utiliser la référence principale en ligne sans avoir à la placer dans la section « Références », ce qui entraînerait sinon des limitations dans l'éditeur visuel.

De plus, nous sommes convaincus que cette approche fonctionnera de manière cohérente dans tous les flux de travail d'ÉditeurVisuel.

Puis-je utiliser les sous-références pour des détails autres que les numéros de page ?

Oui, c'est possible. Cette fonctionnalité a été conçue intentionnellement pour permettre d'autres types de détails, par exemple des chapitres, des citations ou des repères temporels audio. Nous avons sélectionné divers exemples tirés de Wikipédia en allemand dans notre rapport sur le wiki pilote.

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.