WMDE Technical Wishes/Sub-referencing/es
| 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. | |
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
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.
Sub-referencing is deployed to German Wikipedia as of September 2025. Our plan is to bring sub-referencing to the other Wikimedia wikis in 2026.
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 VisualEditor 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.
- 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.
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." />
Ejemplo:
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." />
Ejemplo:
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>
Ejemplo:
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}} -->
|
|
Mantén En Mente
- 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. 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 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 VisualEditor which we cannot solve at this point in time.
En el Editor Visual (en desarrollo)
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.
Crear una subreferencia
- 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.
- Introduce los detalles de esa subreferencia y haz clic en «Insertar».
Editar una subreferencia
- 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.
Reutilizar una subreferencia
- Puedes reutilizar una subreferencia mediante la pestaña «Reutilizar» en el cuadro de diálogo de citas.
- 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.
Importante
- 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.
- El problema existente con el nombrado automático de referencias en el Editor Visual también se presenta en las subreferencias.
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).
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.
- 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.
In Progress
Subreferencing is now ready in Wikitext and VisualEditor and deployed to German Wikipedia 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> - 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.
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.
Actualizaciones
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.
- We have deployed sub-referencing in September 2025 to German Wikipedia as our first pilot wiki.
- We are improving sub-referencing and will reach out to other potential pilot wikis in the upcoming months.
Siguientes Pasos
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.
- 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?
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.
¿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 VisualEditor.
Furthermore, we’re confident that this approach will work consistently across VisualEditor 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.