Ajuda:Transclusão

Página semi-protegida

Transclusão significa a inclusão do conteúdo de um documento dentro de outro documento por referência . Na transclusão da Wikipedia, o software MediaWiki fará referência ao conteúdo de uma página, o modelo , para inclusão no conteúdo de qualquer outra página, a página de destino. Da mesma forma que qualquer nome de página pode se tornar um link colocando seu nome entre colchetes duplos, qualquer nome de página pode se tornar um modelo colocando-o entre chaves duplas, . As alterações feitas no modelo são refletidas automaticamente em todas as páginas nas quais essa página foi transcluída (embora às vezes uma limpeza possa ser necessária). {{Namespace:Pagename}}

Se o nome da página do modelo não começar com um namespace, presume-se que ele esteja no namespace Template. Para se referir a uma página no namespace "Principal" (artigo), é necessário prefixá-la com dois pontos ( : ) . Exemplos:

O que será transcluído de uma página pode ser controlado com as tags <noinclude>, <onlyinclude> e <includeonly> colocadas no wikitext da página de origem. (Consulte a marcação, abaixo.) O uso de tags permite que o modelo transclua parcialmente, caso contrário, as chaves duplas sempre transcluirão todo o conteúdo. Para a transclusão seletiva , as partes <includeonly> do modelo são nomeadas (com a ajuda de funções do analisador ) e esse modelo é então chamado com o parâmetro . transcludesection=name

Os eventos de transclusão ocorrem toda vez que a página é carregada , quando o modelo é renderizado. Outro uso do mesmo mecanismo é uma substituição única da própria chamada de modelo por sua página de origem transcluída. Uma chamada de modelo com o prefixo "subst:" é transcluída uma vez, mas nunca mais, porque o wikitexto dessa chamada é substituído (substituído) quando sua página é salva . O que era uma chamada de modelo única torna-se o wikitexto real do modelo no momento de sua chamada. {{fullpagename}}{{subst:fullpagename}}

Como funciona a transclusão

Para transcluir qualquer página de origem (dentro de um único projeto MediaWiki, como en:Wikipedia), use o seguinte código na página de destino :

{{SOURCEPAGE}}

Sempre que você escreve o código ( {{SOURCEPAGE}}) em uma página de destino, está dizendo ao software Wikipedia para colocar todo o conteúdo SOURCEPAGEna página de destino.

No exemplo abaixo, observe a página de destino A e SOURCEPAGE B .

Se B for transcluído em A , o software Wikipedia incluirá naquele local específico não o código ( {{B}}) em si, mas o conteúdo da página de origem B (que é apenas a palavra foo ).

A linha superior mostra como as páginas de destino A , P e Q ficarão com as alterações no código vistas na linha inferior para transcluir a página de origem B . Observe a posição do código em cada página de destino de exemplo.

O conteúdo da página de origem, foo , não será realçado ou enquadrado na página de destino. ( Foo está em uma caixa azul claro aqui para facilitar a ilustração e compreensão.)

Transclusion-multiple-foo.svg


A transclusão cria um link "ao vivo" entre uma página de origem e a(s) página(s) de destino onde o conteúdo da página de origem aparece. Isso significa que, ao editar uma página de origem, você estará atualizando seu conteúdo em todas as páginas de destino que a incluem. Digamos que você crie uma página de origem na Wikipedia com o endereço, data e hora de um evento local da Wikimedia para o qual deseja convidar 50 editores locais. Em seguida, transclua a página de origem do convite para sua página de discussão, bem como as páginas de discussão dos outros 50 editores. Uma semana depois, você descobre que o local do evento deve ser mudado. Você então atualizaria a página de origem e o novo endereço apareceria automaticamente nas páginas de discussão de todos os outros participantes. Você também pode dizer aos editores para convidar pessoas que você pode ter perdido.

Lembre-se de ser extremamente cuidadoso ao editar qualquer página de origem, especialmente se ela contiver transclusões de outras páginas de origem. A quebra de transclusões existentes em uma página de origem é chamada de quebra . Por favor, evite quebras porque não apenas a página de origem maior que você está editando e todas as páginas de destino que a incluem serão afetadas. O mesmo acontecerá com a página de origem já incorporada (agora quebrada) que foi usada para adicionar conteúdo à página de origem maior, bem como todas as páginas de destino em que a página de origem incorporada foi transcluída.

Sintaxe de transclusão

A sintaxe geral para transclusão na Wikipédia é , onde descreve o título de uma página da Wikipédia. {{Namespace:Pagename}}Namespace:Pagename

O uso da sintaxe de transclusão requer algum conhecimento dos títulos das páginas. Na Wikipedia, as páginas que não são de artigos têm títulos com um namespace visível e um nome de página separados por dois pontos; por exemplo, a página Wikipedia:Dicas tem Wikipediacomo namespace e Tipscomo nome da página. Mas os artigos enciclopédicos têm apenas um nome de página visível em seus títulos: por exemplo, o artigo Potato tem Potatocomo nome de página, e o namespace, chamado namespace principal , não é visível.

  • O wikitexto {{Namespace:Pagename}} transcluirá a página intitulada Namespace:Pagename. Por exemplo, se uma página tiver o wikitexto {{Wikipedia:Notability}}, ela transcluirá a página Wikipédia:Notabilidade para ela. Observe que {{WP:Notability}}faria exatamente a mesma coisa, pois WP:é um alias de namespace , que é traduzido automaticamente pelos servidores da Wikipédia para Wikipedia:.
  • Se o namespace for omitido, mas os dois pontos forem incluídos, como {{:Pagename}}, o artigo enciclopédico Pagenameserá transcluído. Por exemplo, {{:Notability}}irá transcluir o artigo Notability .
  • Se o namespace e os dois pontos forem omitidos, como {{Pagename}}, o Template:Pagenameserá transcluído. Por exemplo {{Notability}}, e também {{Template:Notability}}, transcluirão o Predefinição:Notabilidade .

Portanto, em resumo, uma página de exemplo com o wikitexto {{Pagename}}ou {{Template:Pagename}}incluído, transcluirá o Template:Pagenamepara essa página de exemplo. Mas {{:Pagename}}terá um efeito diferente: transcluirá o artigo Pagename. Além disso, {{Namespace:Pagename}}transcluirá a página Namespace:Pagename, para páginas com títulos desse formato. Você também tem a opção de usar parâmetros de modelo e modificadores de transclusão.

Subpáginas

Subpáginas são páginas separadas por "/" (uma barra) de sua página 'pai'. Para uma página pai com o formato de nome Namespace:Pagename, seu nome de subpágina teria o formato Namespace:Pagename/Subpagename. Este recurso está desabilitado nos namespaces main, file e MediaWiki , mas não em seus namespaces talk correspondentes.

Para transcluir uma subpágina:

  • A sintaxe geral é {{Namespace:Pagename/Subpagename}}.
  • Na página pai de uma subpágina, é a sintaxe geral ou {{/Subpagename}}.
  • Para uma página de namespace de modelo, é a sintaxe geral ou {{Pagename/Subpagename}}.
  • As subpáginas de artigos estão desativadas neste wiki, mas, caso contrário, seriam {{:Pagename/Subpagename}}.
  • Você também tem a opção de usar parâmetros de modelo e modificadores de transclusão

Por exemplo, para transcluir Predefinição:Like/doc , seria {{Template:Like/doc}}ou {{Like/doc}}. Observe que os nomes das subpáginas diferenciam maiúsculas de minúsculas e {{Like/Doc}}não funcionariam.

Parâmetros do modelo

A aplicação mais comum de transclusão é a transclusão de modelos . Templates são páginas escritas com o objetivo principal de serem incluídas em outras páginas, seja por transclusão ou substituição . Como mostrado acima, a sintaxe usual para transcluir uma predefinição intitulada Predefinição:Nome da página é {{Pagename}}. No entanto, alguns modelos também podem usar parâmetros . Parâmetros são variáveis ​​que podem receber valores (também denominados argumentos ) que podem ser passados ​​para determinados modelos para que funcionem de maneiras diferentes. Os modelos podem usar nenhum parâmetro, um número fixo de parâmetros ou um número variável de parâmetros. O número de parâmetros que um modelo pode usar é de um para cima.

A sintaxe exata para usar parâmetros com modelos pode variar muito, dependendo do modelo real que está sendo usado. Mas, para um modelo de exemplo intitulado Template:Pagename, que usa três parâmetros, a forma geral seria:

{{Pagename|parameter1|parameter2|parameter3}}

  • WP:SEM NOME
  • WP:POSPARAM
  • WP: POSICIONAL

com cada parâmetro sendo substituído por a value, ou a parameter name=value, quando usado na prática. Observe que cada parâmetro é separado por uma barra vertical . Os parâmetros que assumem a forma valuesão chamados de parâmetros sem nome ou posicionais. Os parâmetros que assumem a forma parameter name=valuesão chamados de parâmetros nomeados . Com parâmetros sem nome, o primeiro, segundo, terceiro etc. parâmetros são equivalentes aos parâmetros '1', '2', '3' etc. na documentação do modelo. Os parâmetros sem nome devem estar na ordem correta e devem ser colocados antes dos parâmetros nomeados. Um exemplo da sintaxe usando o Template:Collapse top :

{{Collapse top|This is the title text|This is a custom warning line|left=true}}

Neste exemplo específico, três parâmetros são usados, mas Template:Collapse top pode realmente usar um número variável de parâmetros. This is the title texte This is a custom warning linesão os valores dos parâmetros sem nome '1' e '2'; e trueé o valor do parâmetro nomeado left.

Para obter mais detalhes, consulte Ajuda:Modelo . Além disso, consulte Wikipedia:Índice de modelos para obter uma lista de links para modelos relacionados ao Namespace principal disponíveis (geralmente para artigos enciclopédicos); e outros modelos relacionados a Namespace (geralmente para páginas não relacionadas a artigos); há também uma função de pesquisa. Os parâmetros do modelo também são usados ​​no método de parametrização da transclusão seletiva.

Substituição

A substituição tem uma sintaxe semelhante de colchetes duplos e sua ação é semelhante à transclusão. Quando você visualiza uma página com wikitexto de substituição, sua ação é idêntica à transclusão. Mas quando você salva uma página com wikitexto de substituição, a diferença é que substitui esse wikitexto pelo wikitexto real do modelo.

Por exemplo, quando {{subst:Like}}é salvo, ele substituiria esse wikitexto pelo wikitexto real do Predefinição:Like . Na prática, a principal diferença que isso faz é que se acontecesse uma atualização no wikitexto do Template:Like, ele não atualizaria nenhuma página onde {{subst:Like}}já havia sido salva.

palavras mágicas

Palavras mágicas não são exemplos de transclusão. Mas alguns têm uma sintaxe de colchete duplo semelhante e ação para transclusão. Por exemplo, {{FULLPAGENAME}}renderiza o Fullpagename de qualquer página da Wikipédia. Assim como os templates, algumas palavras mágicas também podem receber parâmetros, que são separados por dois pontos (:); por exemplo {{FULLPAGENAME:value}}.

Existem modelos para algumas palavras mágicas, por exemplo, Template:FULLPAGENAME ; mas estes apenas invocam a palavra mágica relacionada ao passar parâmetros usando uma barra vertical (|); por exemplo como {{FULLPAGENAME|value}}. Mas os parâmetros de palavras mágicas são melhor passados ​​diretamente usando dois pontos, por exemplo, como {{FULLPAGENAME:value}}, que ignora quaisquer modelos.

Modificadores de transclusão

Conforme discutido acima, com o exemplo {{subst:Like}}, o subst:código altera a transclusão para substituição. Este é um modificador de transclusão , um tipo de palavra mágica especializada para alterar a transclusão de alguma maneira. Outro exemplo é {{:Notability}}, onde o :(caractere de dois pontos) força a transclusão para o namespace principal. Existem modificadores de transclusão adicionais, como safesubst:, int:, msg:, msgnw:e raw:. Para obter mais detalhes sobre seu uso, consulte mw:Ajuda:Palavras mágicas § Modificadores de transclusão. Veja também os comandos modificados #section:e usados ​​para transclusão de #section-x:seção rotulada . #section-h:

Aplicações de transclusão

A aplicação mais comum da transclusão é no uso de modelos . No entanto, outras páginas também são às vezes transcluídas, principalmente no espaço do projeto.

páginas compostas

As páginas compostas consistem, total ou parcialmente, em páginas componentes transcluídas. O wikitexto de tal página pode, parcial ou totalmente, consistir em tags, para a inclusão de páginas componentes. As páginas componentes geralmente não estão no namespace do modelo e geralmente são páginas inteiras por direito próprio. As páginas compostas destinam-se a reuni-las em um local central.

Exemplos de páginas compostas:

Isso permite escolher entre visualizar as páginas componentes separadamente ou em conjunto. A exibição de uma página composta é conveniente quando há muitas páginas de componentes pequenas relacionadas, pois permite uma visão geral de todos os componentes sem o esforço de seguir vários links.

Em geral, cada página componente e a página composta são tratadas separadamente. Embora as alterações reais nas páginas componentes sejam transcluídas na página composta, o histórico de edição, alterações recentes, configurações de exibição de página, proteção de página, sumário, links "quais links aqui" e outros recursos da página composta não refletem , ou afetar, as histórias, configurações de exibição, níveis de proteção, quais links aqui listam as páginas de componentes. A página composta é uma página por si só. A página de discussão de uma página composta é usada para falar sobre a composição e a página em geral, não as páginas componentes; embora, por sua vez, possa ser uma composição das páginas de discussão das páginas componentes.

A edição de uma seção de uma página de componente pode ser feita diretamente da página composta, consulte edição de seções de modelos incluídos . Depois de salvar, acaba-se editando a página do componente ao qual a seção pertence.

Em projetos com o recurso de link de interlíngua , a página composta mostra os links de interlíngua combinados de todas as páginas componentes, portanto, possivelmente vários links para um idioma ou mesmo para uma página.

Veja também Wikipedia talk:Template namespace/Archive 1#transcluding prosa .

Páginas com uma seção comum

  • WP:COMMONSECTION

Quando duas páginas precisam discutir o mesmo material da mesma forma, elas podem compartilhar uma seção. Isso envolve criar uma terceira página e transcluir essa página em ambas as páginas. Esta terceira página pode ser uma página independente ou uma subpágina de qualquer uma das outras duas e, se for a primeira, pode ser colocada no mesmo namespace das outras páginas ou no namespace do modelo. Seções comuns como esta devem ser marcadas com um cabeçalho explicativo e/ou receber um layout especial, para informar ao leitor que esta seção da página está em um local diferente, pois transcluir seções de artigos compartilhados pode facilmente confundir editores novatos e leitores se deixado sem marcação.

Isso pode ser muito útil quando duas páginas de desambiguação compartilham conteúdo, [ disputado ] ou uma página de lista e uma página de desambiguação compartilham conteúdo (veja o terceiro exemplo abaixo).

Exemplos:

Repetição dentro de uma página

Em páginas onde há muitas informações repetitivas — vários tipos de listas, geralmente — às vezes é útil criar um modelo que contenha o texto repetido e, em seguida, chamar esse modelo várias vezes. Por exemplo, a linha de construção listada Predefinição:EH é usada repetidamente para construir tabelas em muitos artigos.

A repetição simples do mesmo texto pode ser tratada com a repetição de um parâmetro em um único modelo: por exemplo, {{ 3x }}, onde {{3x| howdy!}}produz howdy! howdy! howdy!.

Para mais informações sobre repetição, veja também m:Ajuda:Conversão recursiva de wikitexto.

Para obter mais informações sobre o sistema de modelo atual, consulte Wikipedia:Template namespace .

transclusão parcial

  • WP:PARTRANS

Usando <noinclude>, <includeonly>e <onlyinclude>marcação, é possível transcluir parte de uma página, em vez de toda ela. Essas transclusões parciais podem ser obtidas pela transclusão de qualquer página, incluindo subpáginas. Muitas vezes, é útil excluir parte de uma página em uma transclusão, sendo um exemplo com a documentação do modelo.

Para um exemplo de como essa técnica pode ser aplicada para simplificar a criação de artigos de resumo , veja como parte da História da patologia (veja a diferença aqui) foi transcluída para a Patologia (veja a diferença aqui) usando a {{:History of pathology}}marcação. O artigo de Patologia naquela época (veja aqui) consistia principalmente em parágrafos principais transcluídos e outras seções de vários artigos. Olhe para a fonte para ver como isso foi feito. Desde então, o artigo de Patologia foi reescrito e não inclui todas essas transclusões.

Outro exemplo pode ser encontrado na transclusão de parte de HitRecord (somente parágrafo introdutório) em uma seção de resumo de mesmo nome em Joseph Gordon-Levitt .

marcação

Na transclusão, uma página de origem é transcluída em uma página de destino. Mas com a transclusão parcial, apenas parte dessa página de origem será transcluída em uma página de destino. Mas, além disso, o que é transcluído para uma página de destino não precisa estar visível na página de origem.

A renderização de uma página de origem pode ser definida como a renderização dessa página de origem quando ela é salva, que será igual à visualização . Podemos chamar isso de renderização aqui .

A renderização de transclusão de uma página de origem pode ser definida como a renderização de uma página de destino que possui uma página de origem transcluída nela; mas apenas a parte da página de destino que foi transcluída da página de origem. A visualização da renderização da transclusão será novamente idêntica. Podemos chamar isso de renderização .

Existem três pares de tags envolvidos nos casos em que a renderização da página aqui deve diferir da renderização da transclusão ali . Conforme descrito anteriormente, estes são <noinclude>, <includeonly>e <onlyinclude>. Essas tags são invisíveis, mas afetam a renderização da página aqui e a renderização da transclusão ali . Essas tags emparelham-se para demarcar seções que criarão diferenças. Cada tag descreverá exceções para transcluir toda a página nomeada.

<noinclude> Esta seção é visível aqui; mas esta seção não é visível lá. As seções fora dessas tags ficarão visíveis aqui e ali. </noinclude>

<onlyinclude> Esta seção é visível aqui; esta seção também é visível lá. As seções fora dessas tags ficarão visíveis aqui, mas não lá. </onlyinclude>

<includeonly> Esta seção não está visível aqui; mas é visível lá. As seções fora dessas tags ficarão visíveis aqui e ali. </includeonly>
Wikitexto O que é renderizado aqui (página de origem) O que está transcluído (página de destino)
<noinclude>text1</noinclude>texto2 text1 text2 text2
<onlyinclude>text1</onlyinclude>texto2 text1 text2 text1
<includeonly>text1</includeonly>texto2 text2 text1 text2

Um ponto importante a ser observado é que <noinclude>e <onlyinclude>não afeta a página renderizada aqui , ao contrário de <includeonly>. As <noinclude>tags impedem que o texto dentro das tags seja transcluído ali , enquanto <onlyinclude>tem o efeito oposto: impede que o texto fora das tags seja transcluído ali .

Apenas <includeonly>impede que o texto seja renderizado pela página aqui . Mas naturalmente é transcluído . O texto fora das tags será renderizado aqui e transcluído ali .

Pode haver várias dessas seções. Além disso, eles podem ser aninhados. Todas as diferenças possíveis entre aqui e são alcançáveis.

Um exemplo é um editor de conteúdo que escolhe uma <onlyinclude>seção e, em seguida, retira uma <noinclude>seção dela; mas depois escolhe outra <onlyinclude>seção para anexar ; mas nada disso afeta seu artigo de forma alguma.

Outro exemplo é o programador de modelo, que fará <includeonly>a seção de código e <noinclude>a seção de documentação de uma página.

Transclusão seletiva

  • WP:TRANSCLUSÃO SELECTIVA
  • WP:SELTRANS

A transclusão seletiva é o processo de transclusão parcial de uma seção selecionada de um documento que possui mais de uma seção transcluível. Conforme observado acima, se apenas uma seção de um documento deve ser transcluída, isso pode ser feito simplesmente envolvendo a seção de interesse com <onlyinclude> … </onlyinclude>tags e transcluindo a página inteira. No entanto, transcluir seletivamente uma seção de um modelo ou documento em uma página e outra seção do mesmo modelo ou documento em uma segunda página e/ou uma seção diferente da mesma página requer uma maneira de:

a) marcar de forma única cada seção transcluível no documento de origem; e
b) no(s) documento(s) de destino (aqueles para mostrar as seções transcluídas), uma forma de especificar qual seção deve ser transcluída.

Esta seção descreve como fazer isso. Existem três maneiras de fazer isso: (1) Transclusão baseada em cabeçalho de seção, (2) Transclusão de seção rotulada e (3) o método de parametrização.

Transclusão de seção padrão (marcação de documento de origem especial não necessária!)

Usando {{#section-h:PAGENAME|SECTIONNAME}}, pode-se transcluir facilmente o conteúdo dentro de uma seção em uma página para outra, referindo-se aos cabeçalhos de seção padrão e onipresentes baseados em manchetes usados ​​em toda a Wikipédia. Para transcluir o lead de um artigo com este método, pode-se usar {{#section-h:PAGENAME}}. Isso é mais simples do que os métodos de transclusão seletiva já amplamente usados ​​das seções abaixo, que requerem marcação especial do documento de origem.

 Esse método de transclusão seletiva geralmente adiciona uma quebra de linha acima e/ou abaixo da transclusão da seção, dependendo da marcação do documento de origem e destino; para evitar esse problema, envolva o modelo de transclusão seletiva em um modelo. {{trim}}Em outras palavras, use as seguintes modificações no código de transclusão listado imediatamente acima:

  • Código para transcluir uma seção no corpo de um artigo:{{trim|{{#section-h:PAGENAME|SECTIONNAME}}}}
  • Código para transcluir o lead de um artigo:{{trim|{{#section-h:PAGENAME}}}}

Hatnote da seção transcluída

Com o objetivo de indicar onde o conteúdo do artigo seletivamente transcluído está localizado, é útil incluir uma nota de chapéu no topo da seção correspondente de um artigo; ou seja, use ou , dependendo se o conteúdo transcluído é uma seção inteira da página de destino. Esses modelos são renderizados da seguinte maneira. {{Transcluded section}}{{transcluded section|source=PAGENAME}}{{transcluded section|source=PAGENAME|part=yes}}

  • {{transcluded section|source=PAGENAME}}processa como:
  • {{transcluded section|source=PAGENAME|part=yes}}processa como:

Usando o método da seção rotulada

A transclusão seletiva de seção rotulada usa as funções do analisador listadas em mw:Extension:Transclusão de seção rotulada, que estão habilitadas em todos os wikis da Wikimedia, para transcluir seletivamente o conteúdo. Consulte Ajuda:Transclusão de seção rotulada para saber como funciona a transclusão de seção rotulada.

Método de parametrização

Marcação do documento de origem

Insira a seguinte linha no documento "fonte" (aquele do qual o texto será transcluído), imediatamente antes da primeira linha de cada seção a ser transcluída, substituindo SECTIONNAME (duas vezes) pelo nome exclusivo da respectiva seção. O nome da seção pode ser qualquer identificador e deve ser único dentro desse documento:

<onlyinclude>{{#ifeq:{{{transcludesection|SECTIONNAME}}}|SECTIONNAME|

Termine cada uma dessas seções transcluíveis com:

}}</onlyinclude>
Marcação do documento de destino

Para transcluir uma seção marcada como acima em outra página (a "página de destino"), use a seguinte linha nessa página, substituindo PAGENAME pelo documento "fonte" do qual o texto será transcluído e SECTIONNAME pelo nome da seção que você deseja transcluir:

{{PAGENAME|transcludesection=SECTIONNAME}}

Assim, cada seção incluída nas <onlyinclude> … </onlyinclude> tags sempre será renderizada quando o transcludesectionparâmetro não estiver definido (quando o documento for visualizado normalmente ou quando o documento for transcluído sem definir o transcludesectionparâmetro conforme mostrado abaixo) e será renderizado por transclusão em qualquer página que não definido transcludesectioncomo o nome da seção. Ele não será renderizado pela transclusão que usa o transcludesectionparâmetro, mas o define como algo diferente do nome da seção.

Além disso, ao fornecer PAGENAME, sem fornecer um Namespace , o wiki assumirá que o PAGENAME pertence ao Template Namespace . Para transcluir de um artigo do Mainspace , use :PAGENAME.

{{:PAGENAME|transcludesection=SECTIONNAME}}
Exemplo

Se quisermos que as seções "Principal Criteria" e "Common Name" de WP:TITLE sejam independentemente transcluíveis, editamos a página WP:TITLE e incluímos a seção "Principal Criteria" da seguinte forma:

<onlyinclude> {{ # ifeq : {{{ transcludesection | critérios principais }}} | critérios principais | 
... 
'' ( texto  da  seção "Critérios Principais"  ) '' ... }} </onlyinclude>


Da mesma forma, incluímos a seção "Nome comum" com:

<onlyinclude> {{ # ifeq : {{{ transcludesection | nome comum }}} | nome comum | 
... 
'' ( texto  da  seção "Nome comum"  ) '' ... }} </onlyinclude>


Em seguida, para transcluir a seção "Principal Criteria" em outra página, inserimos nessa página:

{{WP:TITLE|transcludesection=principalcriteria}}

Para transcluir a seção "Nome comum" em outra página, inserimos nessa página:

{{WP:TITLE|transcludesection=commonname}}

Obviamente, a mesma página pode transcluir duas ou mais seções dessa maneira, incluindo várias dessas linhas.

Não há limite para quantas seções selecionáveis ​​para transclusão um documento pode ter. O único requisito é que cada um transcludesectionreceba um valor exclusivo dentro dessa página.

Marcação adicional para leads de subartigo transcluídos seletivamente

Por MOS:LEAD#Format da primeira frase , a primeira instância do título do subartigo deve aparecer em negrito na primeira frase principal desse artigo; isso geralmente não é desejável para uma transclusão para uma seção do artigo principal. Além disso, o artigo pai geralmente tem um wikilink no início de um subartigo; quando transcluído para o artigo pai, este wikilink aparecerá como texto em negrito. A marcação de wikitexto listada abaixo pode ser usada para resolver esses dois problemas.

Para garantir que o título do artigo esteja em negrito na primeira frase do subartigo, mas sem negrito e wikilink na transclusão para o artigo principal, faça a seguinte substituição na primeira frase principal do subartigo:

Substituir
SUB-ARTICLE_PAGENAME
com
<noinclude>'''</noinclude>{{No selflink|SUB-ARTICLE_PAGENAME}}<noinclude>'''</noinclude>

Se houver um wikilink para o artigo pai na seção principal do subartigo, substituir o wikilink para o artigo pai por um modelo garantirá que ele seja wikilinkado no título do subartigo, mas não na transclusão para o artigo pai . Em outras palavras: {{no selflink}}

  1. Se o wikilink para o artigo principal não for um link WP:Piped , substitua por no cabeçalho do subartigo[[PARENT_ARTICLE]]{{no selflink|PARENT_ARTICLE}}
  2. Se o wikilink para o artigo principal incluir um pipe (por exemplo, este link) , substitua por no cabeçalho do subartigo[[PARENT_ARTICLE|Piped link wikitext]]{{No selflink|PARENT_ARTICLE|Piped link wikitext}}

Desvantagens

  • H:TRANSDRAWBACKS

Como muitas tecnologias de software, a transclusão vem com uma série de desvantagens. O mais óbvio é o custo em termos de aumento dos recursos necessários da máquina; para mitigar isso até certo ponto, limites de modelo são impostos pelo software para reduzir a complexidade das páginas. Algumas desvantagens adicionais estão listadas abaixo.

páginas especiais

Algumas páginas em Special:Specialpages podem ser transcluídas, como Special:Allpages , Special:Prefixindex , Special:Newfiles , Special:Newpages , Special:Recentchanges e Special:Recentchangeslinked . Amostras:

  • {{Special:Allpages/General}}– uma lista de páginas começando em "Geral".
  • {{Special:Prefixindex/General}}– uma lista de páginas com o prefixo "Geral".
  • {{Special:Newfiles/4}}– uma galeria dos quatro arquivos carregados mais recentemente.
  • {{Special:Newpages/5}}– uma lista das cinco páginas criadas mais recentemente.
  • {{Special:Recentchanges/5}}– as cinco mudanças mais recentes.
  • {{Special:Recentchangeslinked/General}}– mudanças recentes nas páginas vinculadas em "Geral".

Tentar transcluir {{Special:Categories}}não resultará em uma lista real de categorias, mas {{Special:Prefixindex/Category:}}pode ser usada para essa finalidade.

Exceto por Special:Recentchangeslinked, a barra e a palavra ou número após a barra podem ser omitidas, fornecendo uma lista de páginas sem um ponto inicial específico ou uma lista do comprimento padrão.

Os parâmetros de URL podem ser fornecidos como parâmetros de modelo:

  • {{Special:Recentchanges|namespace=10|limit=5}}– as cinco alterações mais recentes no namespace "Template".
  • {{Special:Prefixindex/Jimbo Wales/|namespace=2|stripprefix=1}}– as subpáginas para User:Jimbo Wales , mas sem o prefixo da página do usuário.

Nota: A transclusão de certas páginas especiais (como Special:Newpages ) pode alterar o título exibido da página.

Veja também

Transclusão do MediaWiki

  • mw:Transclusion: uma introdução simples (em MediaWiki).
  • meta:Ajuda:Página incorporada: fornece informações básicas (no Meta-Wiki).
  • Wikipédia:espaço de nomes MediaWiki
    • meta:Help:MediaWiki namespace: em Meta-Wiki.
  • meta:Help:Variable: informações sobre variáveis ​​MediaWiki (em Meta-Wiki).
  • Ajuda:Transclusão de seção marcada :
    • mw:Extensão:Transclusão de seção rotulada:no MediaWiki.
    • meta:Help:Template#Transclusão de seção marcada: no Meta-Wiki.

Modelos

Outro