WMDE Technical Wishes/Sub-referencing/fr

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

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

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.

• » 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é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.

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:

• 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. 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 l'information bibliographique principale, 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érence, utilisant le nom de la référence principale avec 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>

Souvenez-vous

Si vous voulez faire référence à une nouvelle source en utilisant des sous-références dans le wikitexte, vous avez seulement besoin de créer la référence principale dans la section références.

Mais dans de nombreux cas, vous voudrez probablement utiliser un sous-référencement avec une référence qui existe déjà dans l'article. Dans ces cas

1. Transformer la référence originale en référence principale en utilisant le <ref name>.
2. Mettez la référence principale dans la section de références.
3. Créer une sous-référence là où la référence originale était précédemment dans le texte de l'article.
4. 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.
5. 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 page 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

• 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.
• 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: Rester sur un wiki en beta Retours

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é.
• 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.

• 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.
• YNous 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.
• YOur team presented sub-referencing at Wikimania 2024 and discussed with participants. (YouTube)
• Les utilisateurs de différents projets participent actuellement à des tests utilisateurs modérés.
• Nous allons bientôt contacter des wikis pilotes potentiels et espérons les déployer à la fin du mois de septembre.
• Notre plan est de déployer la fonctionnalité de sous-référencement pour le Wikitexte et l'Éditeur visuel d'ici la fin de 2024.
• Nous continuerons à recueillir des commentaires pour améliorer la solution après le déploiement.

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.

Foire aux questions

Comment puis-je trouver des articles qui utilisent des sous-références ?

Une catégorie de suivi appelée Catégorie:Pages qui utilisent des références étendues est ajoutée à toute page où le sous-référencement est utilisé, ce qui vous permet d'explorer ou de corriger les pages à l'aide de la nouvelle fonctionnalité. Le nom de cette catégorie peut changer.

Puis-je utiliser cette fonctionnalité avec des modèles/outils de référencement ?

Oui, vous pouvez utiliser le sous-référencement avec les modèles de référencement. Nous avons testé les modèles de source les plus courants (par exemple, citer un livre ou citer un site Web) et nous ne prévoyons aucun problème. Mais votre modèle préféré peut nécessiter quelques mises à jour pour fonctionner avec notre solution. Certains gadgets/scripts liés aux références peuvent également nécessiter une mise à jour pour fonctionner correctement avec la nouvelle solution de sous-référencement. Étant donné que les modèles, les gadgets et les scripts sont entre les mains des communautés wiki, nous ne sommes pas en mesure de les adapter.

Veuillez nous informer, sur la page de discussion, si vous découvrez des problèmes ou si vous avez besoin d'aide pour mettre à jour les modèles de référencement afin qu'ils fonctionnent avec la nouvelle fonctionnalité. Vous êtes également invité à venir à notre atelier de Wikimania « [$1 Une option de citation toute nouvelle - Que signifie-t-elle pour les modèles de citation ?] » (hybride) ou à regarder l'enregistrement plus tard.

Quel sera le nom de l’attribut de sous-référence ?

Nous ne le savons pas encore. Actuellement, le nom de l’attribut permettant de créer des sous-références dans le Wikitexte est extends. Nous avons décidé de ce nom il y a quelques années après en avoir discuté avec les communautés et les parties prenantes de la Wikimedia Foundation. Cependant, nous avons reçu des commentaires indiquant que ce nom n’était peut-être pas la meilleure option. Avant de déployer cette fonctionnalité sur les wikis, nous souhaitons obtenir davantage de commentaires sur le nom de l’attribut et prévoyons de proposer des alternatives à la discussion. Nous vous tiendrons au courant lorsque cela se produira.

Pourquoi avez-vous choisi cette syntaxe Wikitexte ?

Lorsque nous avons commencé à travailler sur la mise en œuvre du wikitext de cette fonctionnalité, nous avons discuté de différentes options. L'ajout d'une nouvelle balise (par exemple <subref>) a été discuté avec soin, mais nous voulions nous en tenir à l'approche <ref> existante, pour minimiser la quantité de nouvelles syntaxes que les utilisateurs doivent apprendre. En outre, l'introduction d'une nouvelle balise nécessiterait de nombreuses mises à jour du logiciel communautaire existant (outils, gadgets, bots, etc.) pour le référencement.

Une proposition (de 2008) consistait à spécifier les détails de la sous-référence « à l'intérieur » de la balise <ref> : <ref page="page 2" name="Miller"> ou plus tard <ref detail="page 2" name="Miller"> en utilisant l'attribut name pour faire référence à la référence principale. Cela ressemble à ce que les utilisateurs connaissent en travaillant avec des modèles comme {{Ouvrage}}.

Le problème principal de cette approche est qu'elle cause des problèmes avec les modèles' et est très susceptible de provoquer des erreurs. Un autre problème avec cette syntaxe est qu'elle ne permet pas de réutiliser une sous-référence, car l'attribut name a déjà été utilisé pour faire référence à la référence principale et ne peut pas être utilisé une deuxième fois.

Une façon d'éviter ces deux problèmes consiste à créer un nouvel attribut de référence et à placer les détails de la sous-référence dans la zone entre les balises <ref> ouvertes et fermées, de la même manière que cela se fait déjà pour le contenu des références. C'est ce que fait notre approche.

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.