WMDE Technical Wishes/Sub-referencing/es
Actualmente, no es posible reutilizar fácilmente la misma referencia con diferentes detalles en un artículo. Los miembros de la comunidad han solicitado repetidamente una solución de MediaWiki que funcione sin plantillas y que esté basada en la forma en que funcionan las referencias ya existentes, tanto para wikitexto como para el Editor Visual. » Aprende más sobre este problema
| Subreferenciación | |
|---|---|
| Status | En proceso |
| Origin | Encuestas de Deseos Técnicos de 2013, 2015, 2022 y otras |
| Focus area | Facilitar la reutilización de referencias |
| Phabricator | Tablón del proyecto |
| Responsible | Equipo de Deseos Técnicos |
 Dinos lo que piensas Te invitamos a probar nuestro prototipo, el cual actualizamos continuamente. Mira esta página o subscríbete a esta lista de difusión para aprender sobre nuevas cosas que puedes probar. | |
Como parte del área de interés "Facilitar la reutilización de referencias", el equipo de Deseos Técnicos de Wikimedia Deutschland está introduciendo la subreferenciación – una funcionalidad opcional que te permite enlazar diferentes detalles a una misma referencia existente, sin tener que duplicarla.
Our plan is to bring Sub-referencing to the Wikimedia wikis in 2025.
Subreferenciación en pocas palabras
Para citar una misma fuente más de una vez con diferentes detalles, se necesita una referencia principal y una subreferencia.
- La referencia principal contiene la información bibliográfica principal.
- La subreferencia contiene los detalles, como números de página, o cualquier otra información adicional que sea diferente para cada citación, como capítulos, versos u otras notas.
- 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.
- En la sección de referencias, los lectores verán todas las subreferencias de un artículo agrupadas bajo la referencia principal del mismo. Esto hará más sencillo saber cuán frecuentemente una misma fuente ha sido citada en ese artículo.
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.
En el Editor Visual, estamos cambiando el diálogo actual de citaciones para que admita las subreferencias.
Principales beneficios
- Sub-referencing is largely based on the existing way references work.
- It's designed to work for both Visual Editor and wikitext.
- La solución se integrará en MediaWiki, por lo tanto, estará disponible en todas las wikis de Wikimedia y será utilizable sin la necesidad de soluciones alternativas basadas en plantillas.
- Las subreferencias se mostrarán adecuadamente en las previsualizaciones de referencias y en los mensajes emergentes de referencias para móviles.
- Es opcional: puedes seguir utilizando otros métodos para referenciar, pero te puedes encontrar con subreferencias en artículos escritos por otros usuarios.
- ¡Prueba el prototipo! Lee más para saber cómo probarlo.
- Danos una opinión general en la página de discusión.
- Sigue esta página o suscríbete a esta lista de mensajes para aprender sobre nuevas funcionalidades que puedes probar.
Cómo funciona
En wikitexto
La solución en wikitexto para la subreferenciación está casi terminada. Sin embargo, el nombre del atributo podría cambiar. La solución aún no se ha desplegado principalmente porque queremos evitar que los usuarios del Editor Visual tengan una experiencia muy distinta de los usuarios de wikitexto. El soporte para el Editor Visual aún está en desarrollo.
Beneficios específicos para el wikitexto
- La solución se basa en el concepto existente y conocido de las referencias nombradas.
- No requiere ningún conocimiento de plantillas.
- Las referencias casi duplicadas se pueden eliminar en el wikitexto, haciéndolo más limpio, menos redundante y más fácil de leer.
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.
En el Editor Visual (en desarrollo)
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!
Beneficios específicos para el Editor Visual
- Para citar la misma fuente con distintos detalles, ya no tienes que crear una nueva referencia desde cero.
- Las subreferencias son completamente compatibles con el Editor Visual (a diferencia de las soluciones basadas en plantillas): puedes crearlas mediante el cuadro de diálogo de citas y editarlas directamente en la sección de referencias.
Flujos de trabajo en el prototipo actual (probablemente cambien)
Crear una subreferencia
- La creación de una subreferencia funciona en la actualidad mediante el cuadro de diálogo actual de citas.
- En la pestaña «Reutilizar», selecciona la referencia que quieras reutilizar mediante los tres puntos y haz clic en «Reutilizar esta referencia con detalles adicionales».
- Introduce los detalles de esa subreferencia y haz clic en «Insertar».
- El mensaje emergente de referencia en el Editor Visual muestra que esta referencia es una subreferencia, y con qué frecuencia se reutiliza.
Editar una subreferencia existente
- Haz clic en el marcador de nota al pie en el texto del artículo para editar una subreferencia.
- Ahora puedes cambiar los detalles de la subreferencias. También se te indicará que es una subreferencia.
- Todavía no puedes editar una subreferencia desde la lista de referencias.
- Para editar la referencia principal, haz clic sobre ella en la sección de referencias.
Reutilizar una subreferencia
- Puedes reutilizar una subreferencia mediante la pestaña «Reutilizar» en el cuadro de diálogo de citas.
Importante
- El problema existente con el nombrado automático de referencias en el Editor Visual también se presenta en las subreferencias.
- 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.
- Aún tenemos que trabajar en qué ocurre al borrar una referencia que se esté reutilizando.
- 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.
Probar el prototipo
Necesitamos tu opinión para asegurarnos de ir en la dirección correcta. Tus comentarios y preguntas son siempre bienvenidos en la página de discusión de este proyecto.
El prototipo está disponible en el wiki beta. En la actualidad, te invitamos principalmente a probar la solución en wikitexto.
- Pueden tener un aspecto diferente (por ejemplo, no utilizan tu apariencia preferida).
- Pueden ofrecer algunas funcionalidades nuevas que aún se encuentren en pruebas.
- Solo contienen algunas páginas y plantillas de pruebas, no el contenido completo de tu wiki, y no todas las plantillas, módulos, accesorios, etc., a las que te hayas acostumbrado.
- Tu acceso normal a Wikimedia no funciona en los wikis beta. Puedes registrar una cuenta (asegúrate de utilizar una contraseña diferente de la de tu cuenta habitual de Wikimedia) o probar la funcionalidad sin cuenta, lo que supondrá crear una cuenta temporal (en de-betawiki) o que se muestre tu dirección IP (en en-betawiki).
El problema que estamos solucionando
En los artículos de Wikipedia, es habitual referenciar varias veces una misma fuente. Pero, aunque puedes reutilizar una referencia tal cual, en la actualidad no es posible reutilizar la misma referencia con distintos detalles (por ejemplo, distintos números de página). Tu única opción es crear una referencia nueva o recurrir a soluciones alternativas.
Statu quo: Reutilizar referencias en wikitexto y en el Editor Visual
Si deseas reutilizar una referencia en wikitexto, puedes convertirla en una referencia nombrada y referirte a ese nombre en otra parte del artículo. La referencia nombrada se puede poner en el texto del artículo o en la sección de referencias. En el Editor Visual puedes utilizar la opción «Reutilizar» en el cuadro de diálogo de citas. En la sección de referencias se agruparán las referencias del mismo nombre.
-
Wikitexto: <ref name> en el texto del artículo -
Wikitext: <ref name> en la sección de referencias -
Editor Visual: cuadro de diálogo de citas -
Perspectiva del lector
Statu quo: Reutilizar referencias con distintos detalles en wikitexto
Si deseas reutilizar una referencia existente con distintos detalles en wikitexto, en la actualidad tienes que copiar y pegar la referencia existente y cambiar los detalles del duplicado o bien crear una nueva referencia (casi idéntica) desde cero. Algunos proyectos utilizan soluciones alternativas como citas cortas o soluciones basadas en plantillas como notas al pie acortadas. En la sección de referencias no se agruparán la referencia original y la que acabas de crear.
-
Dos referencias casi idénticas en el wikitexto. -
Perspectiva del lector: Las referencias casi idénticas no se agrupan -
Solución alternativa con citas cortas en wikitexto -
Perspectiva del lector: solución alternativa con citas cortas -
Solución alternativa con {{sfn}} en wikitexto -
Perspectiva del lector: solución alternativa con {{sfn}}
Statu quo: Reutilizar referencias con distintos detalles en el Editor Visual
Si deseas reutilizar una referencia existente con distintos detalles en el Editor Visual, no funcionará ni la opción de «Reutilizar» en el cuadro de diálogo de citas ni el método de copiar y pegar, ya que ambas soluciones darán lugar a reutilizaciones idénticas, y cambiar detalles de la referencia reutilizada/copiada cambiará ambas instancias de esa referencia. En lugar de ello, tendrás que crear una referencia nueva (casi idéntica) desde cero. En la sección de referencias no se agruparán la referencia original y la que acabas de crear.
Las referencias creadas mediante soluciones alternativas basadas en plantillas como $cide no se pueden editar desde dentro de la sección de referencias y no aparecen en la pestaña de reutilización de citas, pero es posible editarlas a mano al localizarlas en el texto del artículo.
Solución alternativa con {{sfn}}:
-
Perspectiva del lector -
Las referencias desaparecen de la sección de referencias al hacer clic en «Editar». -
No es posible utilizar referencias {{sfn}} con la pestaña «Reutilizar» del cuadro de diálogo de citas. -
Las referencias solo se pueden editar al localizarlas en el texto del artículo
Problemas para los lectores
Las soluciones alternativas basadas en plantillas no se muestran adecuadamente en las previsualizaciones de referencias, los tooltips de referencias y los mensajes emergentes de referencias para móviles.
Solución alternativa basada en {{sfn}} con previsualizaciones para referencias:
-
Previsualizaciones de referencias: La información principal no está incluida en el mensaje emergente. -
Tooltips de referencias: La información principal no está incluida en el mensaje emergente inicial. -
Tooltips de referencias: La información principal se muestra en otro mensaje emergente. -
Mensajes emergentes de referencias para móviles: La información principal no está incluida.
Principales problemas con el statu quo
- La experiencia de los usuarios del Editor Visual y de wikitexto es muy diferente.
- La mayoría de las soluciones para reutilizar referencias con distintos detalles no funcionan adecuadamente en el Editor Visual.
- Crear muchas referencias casi idénticas con distintos detalles hace que el wikitexto resulte más largo y potencialmente más difícil de leer.
- Las soluciones basadas en plantillas no son igualmente aceptadas en todas las comunidades y por tanto no están disponibles a nivel global.
- Algunos usuarios intentan evitar este problema poniendo las fuentes en la sección de bibliografía sin utilizarlas en absoluto como referencias, lo que dificulta la verificación de las secciones del artículo.
Cambios recientes y próximos pasos
Nuestro equipo ha abordado este problema de forma intermitente desde hace algún tiempo. He aquí un resumen de la historia de este proyecto, incluida nuestra investigación.
Gracias a todos los que han participado en pruebas y entrevistas y que han mostrado interés, así como a todos los que se han tomado la molestia de dejar comentarios en nuestras páginas de discusión a lo largo de los años. Lo agradecemos profundamente. Si tienes más que comentar, no dudes en hacerlo en la página de discusión.
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.
Somos conscientes de otros problemas en el área de interés «reutilizar referencias», y trataremos de abordarlos a lo largo del camino. Nuestro objetivo, sin embargo, sigue siendo crear una solución para la subreferenciación.
Archived updates from 2024
- Hay un prototipo disponible en el wiki beta. Cubre la solución en wikitexto y algunas funcionalidades básicas de la solución en el Editor Visual. Puedes probar el prototipo continuamente y dejarnos tus comentarios.
- Hemos enviado anuncios a todos los wikis para dar a conocer a las comunidades esta próxima funcionalidad, y les hemos invitado a probarla y dejar comentarios.
- Nuestro equipo presentó la subreferenciación en Wikimanía 2024 y dialogó con los participantes. (YouTube)
- En 2024 se realizaron pruebas moderadas de usuarios en distintos proyectos.
- En octubre/noviembre de 2024, estamos explorando posibles cambios a nuestro enfoque en wikitexto basados en los comentarios que hemos recibido. Contactaremos pronto con las comunidades para obtener más opiniones sobre posibles cambios en la funcionalidad de subreferenciación.
- El despliegue en wikis piloto está estancado, a la espera de discusiones y cambios potenciales en nuestra funcionalidad.
- Planeamos desplegar la funcionalidad de subreferenciación en otros wikis de Wikimedia en 2025.
- Seguiremos recopilando comentarios para mejorar la solución tras el despliegue.
Preguntas frecuentes
¿Cómo encuentro artículos que utilicen subreferencias?
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.
¿A qué se debe la elección de esta sintaxis de wikitexto?
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.
¿Por qué ha demorado tanto encontrar una solución?
El equipo de Deseos Técnicos ha trabajado de forma intermitente en esta funcionalidad a lo largo de muchos años. Si quieres saber más, he aquí un resumen de la historia y complejidad de este problema.