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.
Nuestro plan es llevar la subreferenciación a las wikis de Wikimedia a finales de 2024.
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.
- 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.
- Para el wikitexto, se utilizará un nuevo atributo para la subreferenciación. El nombre actual de ese atributo es extends («extiende»), pero podría cambiar antes de que la funcionalidad se despliegue. Recogeremos más opiniones sobre el nombre.
- En el Editor Visual, estamos cambiando el diálogo actual de citaciones para que admita las subreferencias.
Principales beneficios
- La subreferenciación se basa en la forma existente en que funcionan las referencias.
- Funciona tanto para el Editor Visual como para el wikitexto, acercándonos a la paridad de características entre el Editor Visual y el wikitexto.
- 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.
Aun así, puedes probar el prototipo y decirnos cómo te funciona.
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.
Paso a paso
1) Necesitas una referencia con la información bibliográfica principal, la referencia principal. Esta referencia necesita un nombre:
<ref name="Miller">E. Miller, ''The Sun''. New York: Academic Press, 2005.</ref>
La referencia principal debería ponerse en la sección de referencias; de lo contrario, tendrás una referencia en el artículo que no muestre ningún detalle como los números de página. En la sección de referencias, utiliza la sintaxis <references> … </references>. Si el artículo ya utiliza la sintaxis <references />, elimínala.
2) Crea una subreferencia utilizando el nombre de la referencia principal con el atributo extends. Añade los detalles entre las etiquetas <ref>:
<ref extends="Miller">Page 23.</ref>
Se ve así:
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>
|
|
Si deseas referenciar una nueva fuente mediante subreferencias en wikitexto, solo necesitas asegurarte de crear la referencia principal en la sección de referencias.
Pero, en muchos casos, probablemente quieras utilizar la subreferenciación con una referencia que ya exista en el artículo. En estos casos
- Convierte la referencia original en una referencia principal mediante
<ref name>. - Pon la referencia principal en la sección de referencias.
- Crea una subreferencia donde la referencia principal se encontraba antes en el texto del artículo.
- Pon los detalles de la referencia principal (números de página, etc.) en la subreferencia. Asegúrate de que ya no estén en la referencia principal; de lo contrario, dichos detalles se mostrarán dos veces.
- Crea más subreferencias donde quieras para citar la misma fuente con distintos detalles en el artículo.
También puedes reutilizar la propia subreferencia dándole un nombre:
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>
|
|
Importante
- Convertir referencias (sin más) en referencias principales y subreferencias requiere algo de limpieza, y la referencia principal normalmente tiene que estar en la sección de referencias (tal como se describió previamente).
- Puedes utilizar subreferencias junto con plantillas de cita. Hemos probado las más utilizadas, pero puede que tu plantilla favorita necesite algunos ajustes para poder funcionar con nuestra solución.
- Algunos accesorios/scripts relacionados con referencias también pueden requerir una actualización para poder funcionar adecuadamente con la nueva solución de subreferenciación.
- No es posible crear una subreferencia de una subreferencia.
- Si se utiliza
<ref group>, la referencia principal y la subreferencia deben pertenecer al mismo grupo.
En el Editor Visual (en desarrollo)
En este punto, no sabemos exactamente qué aspecto tendrá la funcionalidad para el Editor Visual. Hasta ahora, aún no está lista para desplegarse. En las próximas semanas, lo más probable es que esta solución cambie.
También puedes probar el prototipo con el estado actual de la solución para el Editor Visual. Ten en cuenta que es probable que cambie. Actualizaremos esta página cuando se puedan probar nuevos aspectos.
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.
- En el Editor Visual, actualmente es posible crear una subreferencia de una subreferencia. Esto es incorrecto y causa un error al guardar. No debería funcionar en la solución definitiva y tampoco funciona en wikitexto.
- Aún tenemos que trabajar en qué ocurre al borrar una referencia que se esté reutilizando.
- Queda por definir el flujo de trabajo de convertir una referencia existente en una referencia principal y una subreferencia.
- Al crear una reutilización de una subreferencia en el Editor Visual y luego cambiar a wikitexto, verás que el código en wikitexto es
<ref extends="main-reference" name="sub-reference" />. Esto es un error y se corregirá como parte de T367749. - En la actualidad,
<ref name="sub-reference name"/>no muestra correctamente la previsualización de la subreferencia en el modo Editor Visual. Solo verás en el mensaje emergente los detalles de la subreferencia y no la información de la referencia principal. Para ver también la información de la referencia principal, deberías utilizar actualmente la sintaxis<ref extends="main" name="sub-reference name" />.
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.
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.
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.
Preguntas frecuentes
¿Cómo encuentro artículos que utilicen subreferencias?
Se añade a cada página donde se utilice la subreferenciación una categoría de seguimiento denominada Categoría:Páginas que utilizan referencias extendidas, lo que permite explorar o corregir las páginas que utilicen la nueva funcionalidad. El nombre de esta categoría puede cambiar.
¿Puedo utilizar esta funcionalidad con plantillas/herramientas de citas?
Sí, puedes utilizar subreferencias con plantillas de citas. Hemos probado las plantillas de citas más habituales (por ejemplo, cita libro o cita web) y no prevemos ningún problema. Pero tu plantilla favorita aún puede requerir algunos ajustes para funcionar con nuestra solución. Algunos accesorios/scripts relacionados con referencias también pueden requerir una actualización para poder funcionar adecuadamente con la nueva solución de subreferenciación. Como las plantillas, los accesorios y los scripts están en manos de las comunidades de los wikis, somos incapaces de adaptarlos.
Haznos saber, en la página de discusión, si descubres algún problema o necesitas ayuda para actualizar plantillas de citas para que funcionen con la nueva funcionalidad.
¿Cuál será el nombre del atributo de subreferencia?
Aún no lo sabemos. En la actualidad, el nombre del atributo para crear subreferencias en wikitexto es extends. Decidimos este nombre hace unos años tras discutirlo con comunidades y partes interesadas de la Fundación Wikimedia. Sin embargo hemos recibido algunos comentarios de que este nombre podría no ser la mejor opción. Antes de desplegar esta funcionalidad en los wikis, queremos obtener más comentarios sobre el nombre del atributo y planeamos someter a discusión algunas alternativas. Te avisaremos cuando eso suceda.
¿A qué se debe la elección de esta sintaxis de wikitexto?
Cuando empezamos a trabajar en la implementación de esta funcionalidad en wikitexto, discutimos distintas opciones. Se discutión con cuidado la posibilidad de crear una nueva etiqueta (por ejemplo, <subref>), pero quisimos ceñirnos al enfoque existente <subref> para minimizar la cantidad de sintaxis nueva que los usuarios deben aprender. Además, introducir una nueva etiqueta requeriría muchas actualizaciones en el software existente de la comunidad (herramientas, accesorios, bots, etc.) para referenciar.
Una propuesta (de 2008) consistía en especificar los detalles de la subreferencia dentro de la etiqueta <ref>, al utilizar el atributo name en <ref page="page 2" name="Miller"> o posteriormente en <ref detail="page 2" name="Miller"> para hacer referencia a la referencia principal. Esto es similar a lo que ya conocen los usuarios por haber trabajado con plantillas como {{cita libro}}.
El problema principal de este enfoque, sin embargo, es que produce problemas con las plantillas y es muy susceptible de provocar errores. Otro problema de esta sintaxis es que no permite reutilizar una subreferencia, ya que el atributo name ya se ha utilizado para hacer referencia a la referencia principal y no se puede utilizar por segunda vez.
Una forma de evitar ambos problemas es crear un atributo de referencia nuevo y poner los detalles de la subreferencia en el área comprendida entre las etiquetas <ref> de apertura y de cierre, del mismo modo que ya se hace para el contenido de las referencias. Esto es lo que hace nuestro método.
¿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.