Wikipédia:Transclusão

Esta é umapágina informativa.

Ela descreve a prática estabelecida da comunidade sobre algum ou mais aspetos das normas e costumes da Wikipédia e que foram consideradosconsensuaispela comunidade. Prefira utilizar apágina de discussãoou até mesmo aesplanadaantes de fazer uma modificação que altere o contexto.

Transclusãoé a inclusão de conteúdo de um documento em outro documento através de referência. No contexto da Wikipédia, é o uso defuncionalidades predefinidasdoMediaWikipara incluir o mesmo conteúdo em múltiplos documentos sem a necessidade de editá-los separadamente. A transclusão de predefinições é a forma comum de usar mensagens predefinidas, e é implementada utilizando-se uma marcação de predefinição, como na forma abaixo:

{{Nome da predefinição}}

Geralmente pode-se querer utilizar uma predefinição, mas por uma razão ou outra pode-se não querer utilizar a transclusão. A cópia automática uma única vez do conteúdo/resultado de uma predefinição para a localização especificada é chamada desubstituiçãoou sublusão (substituição + transclusão). Para subcluir o conteúdo/resultado de uma predefinição, a sintaxe da predefinição deve ser modificada de transcluir para substituir, bastando adicionarsubst:depois das chaves de abertura, ficando a sintaxe final da seguinte forma:

{{subst:Nome da predefinição}}

Como a transclusão funciona[editar código-fonte]

Sintaxe da predefinição

Se a fonte faz parte do artigoespaço nominalPrincipal (ex., "Cat"), você deve colocar um dois pontos (:) na frente do nome, logo:{{:Cat}}

Se a fonte esta no espaço nominal Predefinição (ex., "Predefinição:GNU"), use só o nome da página, apenas, logo:{{GNU}}

Se a fonte esta em outro espaço nominal (ex., "Usuário:Exemplo"), você deve usar o nome completo, incluindo o espaço nominal, logo:{{Usuário:Exemplo}}

Paratranscluirqualquer páginafonte(dentro de um mesmo projeto MediaWiki, como a pt:Wikipedia), inclua o seguinte código na páginaalvo:

{{:ALGUMAPÁGINA}}

Onde a página alvoAcom este código é apresentada, o motor vai incluirnaquele localnão o código em si, mas o conteúdo/resultado completo da página fonteB,no caso ALGUMAPÁGINA (a sintaxe completa da transclusão pode ser vista no quadro ao lado).

Por exemplo, criar uma caixa de navegação sobre eventos ocorridos nas ilhas do pacífico. A tranclusão cria uma ligação "viva" entre a página da predefinição e a(s) página(s) alvo, através da qual as mensagens apareceriam. Quando a predefinição fosse editada, todas páginas alvo seriam editadas também.

Outro exemplo seria a criação de uma predefinição na Wikipédia com os locais onde ocorreram os jogos olímpicos, e depois transcluí-la nas páginas sobre cada evento. Conforme novos jogos forem realizados, basta atualizar uma única lista, uma única vez, e a ligação será consultada na próxima vez que o artigo for apresentado, mostrando as alterações.

Etimologia[editar código-fonte]

Ted Nelsoncunhou o termo em seu livro de 1982,Literary Machines(emportuguês:Máquinas Literárias). Ted Nelson também é o inventor dos termos "hipertexto"e"hipermídia".

Transclusão Parcial[editar código-fonte]

Ao utilizar os termos "noinclude", "onlyinclude" e "includeonly" da linguagem de marcação, é possível transcluir apenas partes de um todo ao invés dele mesmo. Estas transclusões parciais também são obtidas ao transcluir-se de outras páginas, como subpáginas. Frequentemente é útil não transcluir algumas informações, como a documentação de uso de uma predefinição.

Como um exemplo de como esta técnica pode ser aplicada para simplificar a criação deartigos de resumo,vejaesta revisão do artigo Pathology(emportuguês:Patologia) naWikipédia anglófona,que consistia de uma coleção deseções introdutóriastrancluídas de diversos artigos principais.

Marcação[editar código-fonte]

Há três pares deetiquetasque podem ser utilizados nowikitextopara controlar como a transclusão afetaelementosde uma predefinição ou artigo.

Elas determinam se o wikitexto é apresentado ou não, em sua própria página, a qual chamaremos de "cá",ou em outra página onde ela é transcluída, que chamaremos de"acolá".

<noinclude>este conteúdonão será apresentadoacolá</noinclude>.Estas etiquetas não possuem efeitoscá.
<includeonly>este conteúdoserá apresentadoapenasacolá,e não será apresentadocá</includeonly>(comotinta invisívelvisível apenas através de transclusão).
<onlyinclude>este conteúdo será apresentadocáe não será apresentadoacolá</onlyinclude>maso resto do conteúdo será excluído da apresentaçãoacolá.

Não podem haver vários elementos de tal seção. Além disso, eles podem ser aninhados. Todas as representações possíveis são realizáveis. Por exemplo, para apresentaracoláuma ou mais seções da páginacáuse as etiquetas de marcação<onlyinclude>.Para acrescentar textoacolá,envolva a adição com as etiquetas<includeonly>acima, dentro, ou abaixo da seção. Para omitir porções da seção, encapsule-as com etiquetas<noinclude>.

Para auxiliar a memória, insira a fraseNa Transclusãoentre as duas palavras para obter "noNaTransclusãoInclude", "includeNaTransclusãoOnly" e "onlyNaTransclusãoInclude" (esta dica funciona melhor em inglês:In Transclusion).

Subpáginas[editar código-fonte]

Pode-se cortar e colar o texto a ser transcluído em umasubpágina,e depois utilizar o nome da subpágina na predefinição de transclusão. Esta implementação só pode ser usada com subpáginas do espaço de Usuário, Discussão ou Wikipedia; atualmente, subpáginasnão podem ser criadas em artigos.

Exemplo: você quer discutir a eliminação e redirecionamento dePussycatparaCat.Primeiro, crie a subpáginaDiscussão:Pussycat/Vamos eliminar pussycat!,escreva seu comentário nela, depois transclua-a emDiscussão:PussycateDiscussão:Catusando a predefinição{{Discussão:Pussycat/Vamos eliminar pussycat!}}.Comentários postados em qualquer das páginas (que na verdade estarão sendo postos na predefinição) será mostrado em ambas.

Páginas especiais[editar código-fonte]

Algumas páginas emEspecial:Páginas especiaispodem ser transcluídas, comoEspecial:Todas as páginas,Especial:Índice de prefixo,Especial:Ficheiros novos(em implementação),Especial:Páginas novas,Especial:Mudanças recentes,Especial:Alterações relacionadas,etc.

Exemplos:

{{Especial:Todas as páginas/Geral}} – uma lista de páginas começando em "Geral"
{{Especial:Índice de prefixo/Geral}} – uma lista de páginas cujo prefixo é "Geral"
{{Especial:Ficheiros novos/4}} – uma galeria das 4 mídias mais recentemente carregadas
{{Especial:Páginas novas/5}} – uma galeria das 5 páginas mais recentemente criadas
{{Especial:Mudanças recentes/5}} – as 5 mais recentes mudanças
{{Especial:Alterações relacionadas/Geral}} – mudanças recentes nos afluentes de "Geral"

Exceto por Especial:Alterações relacionadas, a palavra/número após a barra pode ser omitida, fornecendo uma lista de páginas sem um ponto de partida específico, ou uma lista com o comprimento padrão.