Mostrar código-fonte de Wikimotorpedia:Transclusão

{{atalho|WP:TRANS}}
{{Informativo aprovado|[[Wikimotorpedia:Esplanada/propostas/Oficializar artigos informativos (30mai2012)]]}}
'''[[Transclusão]]''' é a inclusão de conteúdo de um documento em outro documento através de referência.  No contexto da Wikimotorpedia, é o uso de [[Wikimotorpedia:Predefinições|funcionalidades predefinidas]] do [[MediaWiki]] para 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:
:<code><nowiki>{{Nome da predefinição}}</nowiki></code>

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 de '''[[Wikimotorpedia:Substituição|substituição]]''' ou 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 adicionar <code>subst:</code> depois das chaves de abertura, ficando a sintaxe final da seguinte forma:
:<code><nowiki>{{subst:Nome da predefinição}}</nowiki></code>

{{/Como a transclusão funciona}}

== Etimologia ==
[[Ted Nelson]] cunhou o termo em seu livro de 1982, ''[[Literary Machines]]'' ({{lang-pt|Máquinas Literárias}}). Ted Nelson também é o inventor dos termos "[[hipertexto]]" e "[[hipermídia]]".

== Transclusão Parcial ==
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 de [[WP:SS|artigos de resumo]], veja <!-- arranjar algum modo de tornar esta ligação segura para quem usa o endereço seguro... -->[http://en.wikipedia.org/w/index.php?title=Pathology&oldid=301684595 esta revisão do artigo Pathology] ({{lang-pt|Patologia}}) na [[:en:|Wikipédia anglófona]], que consistia de uma coleção de [[WP:INTRO|seções introdutórias]] trancluídas de diversos artigos principais.

=== Marcação ===
{{Vertambém|Wikimotorpedia:Predefinições#noinclude, includeonly e onlyinclude}}

Há três pares de [[Tag (programação)|etiquetas]] que podem ser utilizados no [[wikitexto]] para controlar como a transclusão afeta '''''[[HTML#Elementos|elementos]]''''' de 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á'''".

* '''<nowiki><noinclude></nowiki>''' este conteúdo '''não será apresentado ''acolá''''' '''<nowiki></noinclude></nowiki>'''. Estas etiquetas não possuem efeitos ''cá''.
* '''<nowiki><includeonly></nowiki>''' este conteúdo '''será apresentado <u>apenas</u> ''acolá''''', e não será apresentado ''cá'' '''<nowiki></includeonly></nowiki>''' (como [[tinta invisível]] visível apenas através de transclusão).
* '''<nowiki><onlyinclude></nowiki>''' este conteúdo será apresentado ''cá'' e não será apresentado ''acolá'' '''<nowiki></onlyinclude></nowiki>''' mas '''o resto do conteúdo será excluído da apresentação ''acolá'''''.

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 apresentar ''acolá'' uma ou mais seções da página ''cá'' use as etiquetas de marcação '''<nowiki><onlyinclude></nowiki>'''. Para acrescentar texto ''acolá'', envolva a adição com as etiquetas '''<nowiki><includeonly></nowiki>''' acima, dentro, ou abaixo da seção. Para omitir porções da seção, encapsule-as com etiquetas '''<nowiki><noinclude></nowiki>'''.

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

<!-- Precisa ser importada para cá
{{for example|m:template:information thread|the wikitext of the the wiki news thread.}}
-->
=== Subpáginas ===
Pode-se cortar e colar o texto a ser transcluído em uma [[Wikimotorpedia:Subpáginas|subpá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 Wikimotorpedia; atualmente, subpáginas [[Wikimotorpedia:Subpáginas#Artigos não possuem subpáginas|não podem ser criadas em artigos]].

Exemplo: você quer discutir a eliminação e redirecionamento de [[Pussycat]] para [[Cat]]. Primeiro, crie a subpágina [[Discussão:Pussycat/Vamos eliminar pussycat!]], escreva seu comentário nela, depois transclua-a em [[Discussão:Pussycat]] e [[Discussão:Cat]] usando a predefinição '''<nowiki>{{Discussão:Pussycat/Vamos eliminar pussycat!}}</nowiki>'''. 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 ===
{{Vertambém|Wikimotorpedia:Páginas especiais#Outras}}

Algumas páginas em [[Especial:Páginas especiais]] podem ser transcluídas, como [[Especial: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:
* <nowiki>{{Especial:Todas as páginas/Geral}}</nowiki> – uma lista de páginas começando em "Geral"
* <nowiki>{{Especial:Índice de prefixo/Geral}}</nowiki> – uma lista de páginas cujo prefixo é "Geral"
* <nowiki>{{Especial:Ficheiros novos/4}}</nowiki> – uma galeria das 4 mídias mais recentemente carregadas
* <nowiki>{{Especial:Páginas novas/5}}</nowiki> – uma galeria das 5 páginas mais recentemente criadas
* <nowiki>{{Especial:Mudanças recentes/5}}</nowiki> – as 5 mais recentes mudanças
* <nowiki>{{Especial:Alterações relacionadas/Geral}}</nowiki> – 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.

== Páginas relacionadas a [[MediaWiki]] [[transclusão]] ==
* [[m:Help:A simple composite example]] ({{lang-pt|Ajuda:Um exemplo de combinação simples}})
* [[Wikimotorpedia:Namespace MediaWiki]]
** [[m:Help:MediaWiki namespace]] ({{lang-pt|Espaço nominal MediaWiki}})
* [[m:Help:Variable]] ({{lang-pt|Ajuda:Variável}})
* [[:en:Wikipedia talk:Template namespace#transcluding prose]] ({{lang-pt|prosa da transclusão}})

== Predefinições ==
* [[Wikimotorpedia:Predefinições]]
* [[Ajuda:Guia de edição/Como criar predefinições]]

== Ver também ==
* [[MediaZilla:4547|Pedidos para transclusões do Commons]], interwiki predefinições, etc.
* [[Wikimotorpedia:Substituição]], o oposto da transclusão.

{{DEFAULTSORT:Transclusao}}
[[Categoria:Wikimotorpedia edição]]
[[Categoria:!Predefinições]]