Jump to content

Desejos técnicos da WMDE/Sub-referências

Add links
From Meta, a Wikimedia project coordination wiki
This page is a translated version of the page WMDE Technical Wishes/Sub-referencing and the translation is 66% complete.
Other languages:
Sub-referências
StatusEm progresso
OriginPesquisa de desejos técnicos de 2013, 2015, 2022 e outros
Focus areaFaça a reutilização de referências mais fácil
Phabricatorquadro do projecto
ResponsibleEquipe de desejos técnicos

Diga-nos a sua opinião

Convidamo-lo(a) a testar o recurso, que atualizamos continuamente. Siga esta página ou subscreva esta lista de mensagens para saber mais sobre as novidades que pode testar.
Leia mais sobre testes e comentários

Atualmente, não é possível reutilizar facilmente a mesma referência com detalhes diferentes num artigo. Membros da comunidade têm solicitado repetidamente uma solução para o MediaWiki que funcione sem predefinições e que se baseie na forma como as referências funcionam atualmente, tanto para o wikitexto como para o Editor Visual. » Saiba mais sobre o problema.

Como parte da área de foco "Facilitar a reutilização de referências", a equipa de Desejos Técnicos da Wikimedia Deutschland está a introduzir as Sub-referências – uma funcionalidade opcional que permite anexar facilmente diferentes detalhes a uma referência existente sem ter de a duplicar.

Desde agosto de 2026, a funcionalidade de sub-referência está implementada em todas as wikis da Wikimedia, exceto na Wikipédia em inglês, nas wikis de línguas com escrita da direita para a esquerda e nas wikis do Wikisource. O nosso plano é levar a sub-referência a todas as wikis da Wikimedia em 2026.

Sub-referências em poucas palavras

Para citar uma fonte mais de uma vez, com detalhes diferentes, são necessárias uma referência principal e uma sub-referência.

  • A referência principal contém as principais informações bibliográficas. Na captura de ecrã abaixo, "1. E. Miller …" na secção Referências representa a referência principal.
  • Uma sub-referência define detalhes adicionais, como números das páginas, capítulos, versículos, citações ou marcações de tempo de vídeo. Na captura de ecrã, "1.1" e "1.2" seguidos de um número da página representam duas sub-referências diferentes.
sub-referências – exemplo
  • Na secção de referências, os leitores veem todas as sub-referências agrupadas abaixo da referência principal em comum. Isto facilita a compreensão da frequência com que uma única fonte foi citada no artigo.
  • No wikitexto, utiliza-se um novo atributo para definir os detalhes de uma sub-referência. Chama-se details. Veja abaixo mais informações e exemplos.
  • No Editor Visual, estamos a expandir a caixa de diálogo de citação existente para suportar sub-referências.

Principais benefícios

  • As sub-referências baseiam-se, na maioria, no funcionamento atual das referências.
  • Foi projetado para funcionar tanto com o Editor Visual quanto com o wikitexto.
  • A solução será integrada na extensão MediaWiki Cite, ficando assim disponível em todas as wikis da Wikimedia e utilizável sem soluções alternativas baseadas em predefinições.
  • As sub-referências serão apresentadas corretamente nas Pré-visualizações de Referência e nos pop-ups de referência para dispositivos móveis.
  • É opcional. Pode ainda usar outros métodos de referência. Mas poderá encontrar sub-referências em artigos escritos por outros utilizadores.
Por favor, diga-nos o que pensa. É importante que esta nova funcionalidade não interrompa o fluxo de trabalho dos utilizadores, que seja intuitiva e que funcione bem para os utilizadores do wikitexto e do Editor Visual, independentemente do seu nível de experiência ou conhecimento sobre o wikitexto e as predefinições. Para garantir isso, precisamos do seu feedback:

Como funciona

No wikitexto

A solução em wikitexto para sub-referências pode ser testada no cluster beta. Benefícios específicos do wikitext:

  • A solução utiliza o conceito já existente e conhecido de referências nomeadas.
  • Não requer nenhum conhecimento de predefinições.
  • As referências quase duplicadas podem ser removidas no texto wiki, tornando-o mais limpo, menos redundante e mais fácil de ler.

 

 

Definir a referência principal

Antes de criar sub-referências, necessita de uma referência principal que contenha toda a informação bibliográfica. A esta referência deve ser atribuído um nome: 

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

Esta referência principal pode ser definida em linha (diretamente no texto do artigo) ou na secção de referências.

Criar uma sub-referência para referências em linha

Se a referência principal estiver em linha, pode criar uma sub-referência de duas formas utilizando o atributo details:

Opção 1: Modificar a referência principal para incluir detalhes adicionais (por exemplo, número da página) 

<!-- Adicione o atributo details diretamente na tag <ref> -->
<ref name="Miller" details="p. 23.">E. Miller, ''The Sun''. Nova Iorque: Academic Press, 2005.</ref>

<!-- Como próximo passo, pode adicionar outra sub-referência utilizando a seguinte instrução: -->
<ref name="Miller" details="p. 48." />

Exemplo:

Wikitexto Resultado 
De acordo com os cientistas, o Sol é muito grande. De facto, ele é muito grande.<ref name="Miller" details="p. 23">E. Miller, ''The Sun''. Nova Iorque: Academic Press, 2005.</ref> Acredite na palavra deles.<ref name="Miller" details="p. 48"/>

== Referências ==
<references /> <!-- ou {{reflist}} -->
De acordo com os cientistas, o Sol é muito grande. De facto, ele é muito grande.[1.1] Acredite na palavra deles.[1.2]


Referências
  1. ↑ E. Miller, The Sun. Nova Iorque: Academic Press, 2005.
    1. ↑ p. 23
    2. ↑ p. 48

Opção 2: Introduza uma ou mais sub-referências separadas directamente dentro de uma nova instrução em linha, mantendo a referência principal intacta. 

<!-- Referência principal inalterada (em linha): -->
<ref name="Miller">E. Miller, ''The Sun''. Nova Iorque: Academic Press, 2005.</ref>
<!-- Novas sub-referências: -->
<ref name="Miller" details="p. 23." />
<ref name="Miller" details="p. 48." />

Exemplo:

Wikitexto Resultado 
De acordo com os cientistas, o Sol é muito grande.<ref name="Miller">E. Miller, ''The Sun''. Nova Iorque: Academic Press, 2005.</ref> De facto, ele é muito grande.<ref name="Miller" details="p. 23" /> Acredite na palavra deles.<ref name="Miller" details="p. 48"/>

== Referências ==
<references /> <!-- ou {{reflist}} -->
De acordo com os cientistas, o Sol é muito grande.[1] De facto, ele é muito grande.[1.1] Acredite na palavra deles.[1.2]


Referências
  1. ↑ E. Miller, The Sun. Nova Iorque: Academic Press, 2005.
    1. ↑ p. 23
    2. ↑ p. 48

Criar uma sub-referência para referências definidas por lista

Se a referência principal estiver guardada na tag <references>, não precisa de a repor diretamente no código. Em vez disso, basta utilizar a seguinte sintaxe diretamente no código: 

<!-- Adicione isto diretamente ao local escolhido no texto do artigo -->
<ref name="Miller" details="p. 23." />

<!-- A referência definida por lista permanece inalterada: -->
<references>
<ref name="Miller">E. Miller, ''The Sun''. Nova Iorque: Academic Press, 2005.</ref>
</references>

Exemplo:

Wikitexto Resultado 
De acordo com os cientistas, o Sol é muito grande. De facto, ele é muito grande.<ref name="Miller" details="p. 23" /> Acredite na palavra deles.<ref name="Miller" details="p. 48"/>

== Referências ==
<references>
<ref name="Miller">E. Miller, ''The Sun''. Nova Iorque: Academic Press, 2005.</ref>
</references>
According to scientists, the Sun is pretty big. In fact, it is very big.[1.1] Acredite na palavra deles.[1.2]


Referências
  1. ↑ E. Miller, The Sun. Nova Iorque: Academic Press, 2005.
    1. ↑ p. 23
    2. ↑ p. 48

Observe que recomendamos não usar {{reflist|refs=...}} para referências definidas por lista, pois causa problemas para os usuários do Editor Visual.

Reutilizar uma sub-referência

Uma vez definida uma sub-referência, pode reutilizá-la em vários locais sem ter de repor a referência principal. Basta repetir a mesma sintaxe de referência em linha: 

<ref name="Miller" details="Page 23." />
  • Note que esta não é uma reutilização comum como está habituado com outras referências. Embora crie alguns duplicados no wikitexto, as sub-referências idênticas serão automaticamente fundidas no leitor e na vista do Editor Visual para evitar duplicações desnecessárias na saída renderizada.
  • A mesma opção de reutilização já funciona para referências regulares (tanto definidas por lista quanto em linha).
  • Dica: Copiar e colar uma declaração de sub-referência existente continua a ser uma abordagem simples e recomendada.

Exemplo – reutilização de sub-referências em linha:

Wikitexto Resultado 
De acordo com os cientistas, o Sol é muito grande.<ref name="Miller" details="p. 23">E. Miller, ''The Sun''. Nova Iorque: Academic Press, 2005.</ref> De facto, ele é muito grande. Acredite na palavra deles.<ref name="Miller" details="p. 48"/> Não olhe diretamente para o sol!<ref name="Miller" details="p. 23" />

== Referências ==
<references /> <!-- ou {{reflist}} -->
De acordo com os cientistas, o Sol é muito grande.[1.1] De facto, ele é muito grande. Acredite na palavra deles.[1.2] Não olhe diretamente para o sol![1.1]


Referências
  1. ↑ E. Miller, The Sun. Nova Iorque: Academic Press, 2005.
    1. ↑ a b p. 23
    2. ↑ p. 48

Exemplo – reutilização de referências definidas por lista:

Wikitexto Resultado 
De acordo com os cientistas, o Sol é muito grande.<ref name="Miller" details="p. 23" /> De facto, ele é muito grande. Acredite na palavra deles.<ref name="Miller" details="p. 48"/> Não olhe diretamente para o sol!<ref name="Miller" details="p. 23" />

== Referências ==
<references>
<ref name="Miller">E. Miller, ''The Sun''. Nova Iorque: Academic Press, 2005.</ref>
</references>
De acordo com os cientistas, o Sol é muito grande. De facto, ele é muito grande.[1.1] Acredite na palavra deles.[1.2] Não olhe diretamente para o sol![1.1]


Referências
  1. ↑ E. Miller, The Sun. Nova Iorque: Academic Press, 2005.
    1. ↑ a b p. 23
    2. ↑ p. 48

Converter referências existentes em sub-referências

Edite a referência que deverá tornar-se a nova referência principal, movendo detalhes como o número de da página para o novo atributo details="…". Substitua referências semelhantes por sub-referências.

Exemplo: Wikitexto sem sub-referências:

Wikitexto Resultado 
De acordo com os cientistas,<ref name="Miller">E. Miller, ''The Sun''. Nova Iorque: Academic Press, 2005, p. 23.</ref> o Sol é muito grande.<ref>E. Miller, ''The Sun''. Nova Iorque: Academic Press, 2005, p. 30.</ref> De facto, ele é muito grande.<ref>E. Miller, ''The Sun''. Nova Iorque: Academic Press, 2005, p. 35.</ref> Acredite na palavra deles.<ref>E. Miller, ''The Sun''. Nova Iorque: Academic Press, 2005, p. 48.</ref> Não olhe diretamente para o sol!<ref name="Miller" />

== Referências ==
<references /> <!-- ou {{reflist}} -->
De acordo com os cientistas,[1] o Sol é muito grande.[2] De facto, ele é muito grande.[3] Acredite na palavra deles.[4] Não olhe diretamente para o sol![1]


Referências
  1. ↑ a b E. Miller, The Sun. Nova Iorque: Academic Press, 2005, p. 23.
  2. ↑ E. Miller, The Sun. Nova Iorque: Academic Press, 2005, p. 30.
  3. ↑ E. Miller, The Sun. Nova Iorque: Academic Press, 2005, p. 35.
  4. ↑ E. Miller, The Sun. Nova Iorque: Academic Press, 2005, p. 48.

Exemplo: Wikitexto após as referências serem convertidas para sub-referências

Note-se que a primeira referência foi convertida em referência principal (incluindo detalhes), e as restantes referências foram convertidas em sub-referências.

Wikitexto Resultado 
De acordo com os cientistas,<ref name="Miller" details="p. 23">E. Miller, ''The Sun''. Nova Iorque: Academic Press, 2005.</ref> o Sol é muito grande.<ref name="Miller" details="p. 30" /> De facto, ele é muito grande.<ref name="Miller" details="p. 35" /> Acredite na palavra deles.<ref name="Miller" details="p. 48"/> Não olhe diretamente para o sol!<ref name="Miller" details="p. 23" />

== Referências ==
<references /> <!-- or {{reflist}} -->
De acordo com os cientistas,[1.1] o Sol é muito grande.[1.2] De facto, ele é muito grande.[1.3] Acredite na palavra deles.[1.4] Não olhe diretamente para o sol![1.1]


Referências
  1. ↑ E. Miller, The Sun. Nova Iorque: Academic Press, 2005.
    1. ↑ a b p. 23
    2. ↑ p. 30
    3. ↑ p. 35
    4. ↑ p. 48

Sub-referências aninhadas

É possível utilizar notas de rodapé aninhadas com sub-referências. O aninhamento em vários níveis provavelmente também funcionará, embora não seja ativamente suportado.

Exemplo: Sub-referências aninhadas utilizando {{refn}}

Wikitexto Resultado 
De acordo com os cientistas, o Sol é muito grande.<ref name="Miller" details="p. 23">E. Miller, ''The Sun''. Nova Iorque: Academic Press, 2005.</ref> De facto, ele é muito grande.{{refn|group="notes"|Alguns cientistas discordam.<ref details="p. 30." name="Miller" />}} Acredite na palavra deles.<ref name="Miller" details="p. 48"/>

== Notas ==
<references group="notes" /> <!-- ou {{reflist|group=notes}} -->

== Referências ==
<references /> <!-- ou {{reflist}} -->
De acordo com os cientistas, o Sol é muito grande.[1.1] De facto, ele é muito grande.[notes 1] Acredite na palavra deles.[1.3]


Notas
  1. ↑ Alguns cientistas discordam.[1.2]
Referências
  1. ↑ E. Miller, The Sun. Nova Iorque: Academic Press, 2005.
    1. ↑ p. 23
    2. ↑ p. 30.
    3. ↑ p. 48

Predefinições e sub-referências

Predefinições podem ser utilizadas nas referências principais e secundárias da mesma forma que nas referências comuns.

Exemplo: Sub-referências utilizando a predefinição de exemplo {{Subref}}

Wikitexto Resultado 
De acordo com os cientistas, o Sol é muito grande.<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> De facto, ele é muito grande. Acredite na palavra deles.<ref name="Miller" details="{{Subref|page=48}}" /> Não olhe diretamente para o sol!<ref name="Miller" details="{{Subref|page=50|quote=Don't do it}}" />

== Referências ==
<references /> <!-- or {{reflist}} -->
De acordo com os cientistas, o Sol é muito grande.[1.1] De facto, ele é muito grande. Acredite na palavra deles.[1.2] Não olhe diretamente para o sol![1.3]


Referências
  1. ↑ Miller, E. (2005). The Sun. New York: Academic Press. 
    1. ↑ p. 23 "It's soo big"
    2. ↑ p. 48
    3. ↑ p. 50 "Don't do it"

Lembre-se


  • Lembre-se de especificar sempre um nome de referência quando utilizar o atributo de detalhe. A utilização de um nome de referência permite que outras pessoas reutilizem facilmente a mesma referência com detalhes diferentes, sem ter de definir um nome primeiro.
  • Sub-referências não se limitam apenas ao número da página. Também pode usá-las para outros fins. Alguns editores disseram-nos que gostariam de a utilizar para registos de tempo de podcasts, URLs, versos de poesia, citações e outros detalhes.
  • Se pretender utilizar as aspas " dentro de details="…" (por exemplo, ao introduzir uma citação), certifique-se de que utiliza &quot; em vez disso ou delimite os detalhes com aspas simples. Utilizadores do Editor Visual poderão digitar " ao preencher os detalhes da sub-referência e esta será automaticamente convertida em wikitexto. Outros caracteres especiais que podem necessitar de tratamento semelhante quando utilizados com details="…" são < e >.
  • Alguns gadgets/scripts relacionados com referências também podem necessitar de uma atualização para funcionar corretamente com a nova solução de sub-referência.
  • Quando utilizar sub-referências, evite predefinições que gerem tags <ref>, pois estas causam problemas no Editor Visual que não conseguimos resolver neste momento.


No Editor Visual

A implementação do Editor Visual para sub-referências pode ser testada no cluster beta. Alguns detalhes ainda precisam de ser corrigidos, e outras funcionalidades serão desenvolvidas após a implementação global. Benefícios específicos do Editor Visual:

  • Para citar a mesma fonte com detalhes diferentes, já não precisa de criar uma nova referência a partir do zero.
  • As sub-referências foram projetadas para serem totalmente compatíveis com o Editor Visual (ao contrário das soluções alternativas baseadas em predefinições).

 

 

Definir a referência principal

  • Utilize a caixa de diálogo de citação existente para criar uma referência principal que contenha toda a informação bibliográfica, exceto os detalhes (por exemplo, número da página) que pretende utilizar nas sub-referências.

Criar uma sub-referência

  • Selecione uma referência reutilizada ou crie uma reutilização (copiando e colando uma referência ou utilizando o diálogo de reutilização de citações).
  • Clique no botão "adicionar detalhes" que aparece no pop-up de referência se a referência for reutilizada.
  • Insira os detalhes dessa sub-referência e clique em aplicar alterações.

Editar uma sub-referência

  • Clique no marcador de nota de rodapé no texto do artigo e selecione o segundo botão de edição (o ícone de caneta) para alterar uma sub-referência.
  • Agora pode editar os detalhes da sub-referência.
  • Não é possível editar uma sub-referência clicando sobre ela na lista de referências – editar a referência principal desta forma funciona normalmente.

Reutilizar uma sub-referência

  • Pode reutilizar uma sub-referência utilizando o separador "reutilizar" na caixa de diálogo de citação.
  • Em alternativa, pode – tal como acontece com as referências regulares – selecionar a nota de rodapé de uma sub-referência e copiá-la para o local desejado no artigo utilizando copiar e colar, o que também cria uma reutilização.

Converter referências existentes em sub-referências

  • Selecione uma referência reutilizada (ou crie uma reutilização).
  • Clique em editar, copie os detalhes que pretende utilizar para a sub-referência (por exemplo, o número da página) e apague os detalhes para transformar a referência numa referência principal.

  • Clique no botão "adicionar detalhes".
  • Cole (ou digite) os dados que acabou de remover e clique em "aplicar alterações".
  • Substitua outras referências semelhantes por reutilizações da referência principal e adicione detalhes para cada uma delas.

Predefinições e sub-referências

Predefinições podem ser utilizadas nas sub-referências e referências principais da mesma forma que nas referências comuns.

  • Clique no botão "adicionar detalhes".
  • Utilize o botão "inserir" para escolher uma predefinição.
  • Utilize a caixa de diálogo de predefinições para procurar a predefinição desejada.
  • Preencha os parâmetros da predefinição e insira a predefinição.
  • A sub-referência é agora exibida junto com a predefinição.

Observação

  • O comportamento atual de criação automática de nomes para referências reutilizadas no Editor Visual também ocorre com sub-referências. A correção deste problema está fora do âmbito deste projeto, mas estamos a trabalhar em melhorias como parte do nosso novo projeto sobre nomes de referência gerados automaticamente pelo Editor Visual.


 Teste a funcionalidade

Precisamos do seu feedback para garantir que estamos a criar as coisas certas. Comentários e perguntas são sempre bem-vindos na página de discussão deste projeto ou agendando uma chamada diretamente com o nosso investigador de utilizadores. A funcionalidade está disponível na versão beta da wiki e na maioria das wikis da Wikimedia.

Testar na beta wiki Deixar um comentário Reservar uma chamada

Por favor, note que as wikis beta são um pouco diferentes da sua wiki usual:
  • Podem ter um aspeto diferente (por exemplo, não usar o tema que prefere).
  • Podem oferecer alguns novos recursos que ainda estão em fase de testes.
  • Elas contêm apenas algumas páginas e predefinições de teste, não todo o conteúdo da sua wiki, nem todas as predefinições, módulos, gadgets, etc. aos quais está habituado.
  • O seu login normal da Wikimedia não funciona em wikis beta. Pode registar uma conta – certifique-se de que utiliza uma palavra-passe diferente da sua conta Wikimedia normal – ou testar a funcionalidade sem uma conta, o que levará à criação de uma conta temporária.

In Progress

Sub-referencing is now ready in Wikitext and VisualEditor and deployed to most Wikimedia wikis. Some of our next steps:

The problem we are solving

In Wikipedia articles, it's common to reference a source multiple times. But while you can re-use a reference exactly as it is, you currently cannot re-use the same reference with different details (e.g. different page numbers). Your only option is to create a whole new reference or to use workarounds.

Status quo: Re-using references in wikitext and VisualEditor

If you want to re-use a reference in wikitext, you can turn it into a named reference and refer to that name at another point in the article. The named reference can be placed in the article text or in the references section. In VisualEditor you can use the option "re-use" in the citation dialog. In the references section, references with the same name are grouped together.

Status quo: Re-using references with different details in wikitext

If you want to re-use an existing reference with different details in wikitext, you currently need to copy and paste the existing reference and change the details of the duplicate or create a new (almost identical) reference from scratch. Some projects use workarounds like short citations or template-based solutions like shortened footnotes. In the references section, the original reference and the new one you created are not grouped together.

  • Two almost identical references in the wikitext.
    Two almost identical references in the wikitext.
  • Reader's view: Almost identical references are not grouped together
    Reader's view: Almost identical references are not grouped together
  • Workaround with short citations in wikitext
    Workaround with short citations in wikitext
  • Reader's view: workaround with short citations
    Reader's view: workaround with short citations
  • Workaround with {{sfn}} in wikitext
    Workaround with {{sfn}} in wikitext
  • Reader's view: workaround with {{sfn}}
    Reader's view: workaround with {{sfn}}

Status quo: Re-using references with different details in VisualEditor

If you want to re-use an existing reference with different details in VisualEditor, neither the option "re-use" in the citation dialog nor the copy-and-paste method will work, because both lead to identical re-uses, and changing details of the re-used/copied reference changes both instances of that reference. Instead you’ll need to create a new (almost identical) reference from scratch. In the references section, the original reference and the new one you created are not grouped together.

References created by template-based workarounds like {{sfn}} cannot be edited from within the references section and don’t appear in the citation re-use tab; but it is possible to edit them manually when locating them in the article text.

workaround with {{sfn}}:

  • Reader's view
    Reader's view
  • The references disappear from the references section when clicking "edit".
    The references disappear from the references section when clicking "edit".
  • It is not possible to use {{sfn}} references via the "re-use"-dialog.
    It is not possible to use {{sfn}} references via the "re-use"-dialog.
  • References can only be edited when locating the reference in the article text
    References can only be edited when locating the reference in the article text

Problems for readers

Template-based workarounds are not properly displayed in Reference Previews, Reference Tooltips and mobile reference pop-ups.

{{sfn}} workaround with previews for references:

  • Reference Previews: The main information is not included in the pop-up.
    Reference Previews: The main information is not included in the pop-up.
  • Reference Tooltips: The main information is not included in the initial pop-up.
    Reference Tooltips: The main information is not included in the initial pop-up.
  • Reference Tooltips: The main information is shown in another pop-up.
    Reference Tooltips: The main information is shown in another pop-up.
  • mobile reference pop-ups: The main information is not included.
    mobile reference pop-ups: The main information is not included.

Main problems with the status quo

  • The experience of VisualEditor and wikitext users is very different.
  • Most workarounds for reusing references with different details don’t work properly in VisualEditor.
  • Creating lots of almost identical references with different details makes the wikitext longer and potentially harder to read.
  • Template-based workarounds are not equally accepted by all communities and thus not globally available.
  • Some users try to avoid this issue by putting sources in the bibliography section without using them as references at all, which makes it harder to verify sections of the article.

Recent changes and next steps

Our team has worked on this problem on and off for some time now. Here is an overview of this project’s history, including our research.

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

  • Green tickY We have deployed sub-referencing in September 2025 to German Wikipedia as our first pilot wiki.
  • Green tickY Read more about our learnings and observations from three months of sub-referencing on German Wikipedia.
  • Green tickY We have deployed sub-referencing to nine additional pilot wikis in February 2026, including Polish and Swedish Wikipedia. (phab:T418209)
  • Green tickY We have deployed sub-referencing to Czech and Italian Wikipedia in April 2026. (phab:T420938)
  • Green tickY We have deployed sub-referencing to French Wikipedia and most non-Wikipedia wikis in June 2026. (phab:T425662)
  • Green tickY We have deployed sub-referencing to Azerbaijani, Catalan, Dutch, Portuguese and Spanish Wikipedia and many smaller Wikipedia language versions in June 2026. (phab:T428902)
  • Green tickY We have deployed sub-referencing to Finnish, Greek, Hungarian, Thai and Turkish Wikipedia in July 2026. (phab:T430941)
  • Green tickY We have deployed sub-referencing to Chinese, Indonesian, Japanese, Korean, Russian, Simple, Ukranian and Vietnamese Wikipedia in August 2026. (phab:T432731)
  • We are continuously improving the feature and implementing community feedback.

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.
  • We are planning to deploy the sub-referencing feature to English Wikipedia as well as right-to-left language wikis and Wikisource wikis in the next months.
  • Check our report and phab:T414094 for our deployment plan and our roadmap for upcoming improvements to sub-referencing.
  • We will continue to collect feedback to improve the feature after the global deployment.

Archived updates from 2025

  • Green tickY 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.
  • Green tickY 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.
  • Green tickY 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.
  • Green tickY We have deployed sub-referencing in September 2025 to German Wikipedia as our first pilot wiki.
  • Green tickY We are improving sub-referencing and will reach out to other potential pilot wikis in the upcoming months.

Archived updates from 2024

  • Green tickY A prototype is available on beta wiki. It covers the wikitext solution and some of the basic features of the VisualEditor solution. You can continuously test the prototype and give feedback.
  • Green tickY We've sent out announcements across all wikis to let communities know about this upcoming feature, and have invited them to test and give feedback.
  • Green tickY Our team presented sub-referencing at Wikimania 2024 and discussed with participants. (YouTube)
  • Green tickY Moderated users tests took place across different projects in 2024.
  • As of October/November 2024, we are currently exploring possible changes to our wikitext approach, based on the community feedback we've received. We'll reach out to communities soon to get more feedback on possible changes to the sub-referencing feature.
  • Pilot wiki deployment is stalled, pending discussions and potential changes to our feature.
  • 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.


Frequently Asked Questions

How can I find articles that use sub-referencing?

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, see our examples for wikitext and VisualEditor. 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 can I prepare for the deployment of sub-referencing?

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.

Wikis that host a copy of the Reference Tooltips gadget are asked to update their version – typically located at MediaWiki:Gadget-ReferenceTooltips.js – as shown here. See phab:T416304 for more information.

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.

Why did you choose this wikitext syntax?

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.

Can I use sub-references for details other than page numbers?

Yes you can, the feature is intentionally designed to allow other types of details, e.g. chapters, quotes or audio timestamps. We've selected a variety of different examples from German Wikipedia in our pilot wiki report.

Why did it take so long to find a solution?

The Technical Wishes team has worked on this feature on and off for many years. If you want to know more, here’s an overview of the history and complexity of this problem.

Retrieved from "https://meta.wikimedia.org/w/index.php?title=WMDE_Technical_Wishes/Sub-referencing/pt&oldid=31095250"