Extension:Labeled Section Transclusion/pt-br

Esta extensão permite transclusão seletiva de seções marcadas de texto. Sua funcionalidade é semelhante a uma versão melhorada da tag com transclusão wiki normal, que seleciona as seções para a inclusão. Está habilitada em todas as wikis da Wikimedia.

Enquanto a transclusão normal é destinada principalmente para transcluir grandes porções de pequenas predefinições, a transclusão de seções etiquetadas destina-se a pequenas porções de páginas grandes.

No entanto, existem algumas diferenças. Na transclusão de predefinição nativa, as seções são marcadas por comportamentos; portanto, você pode ter apenas uma seção (possivelmente não contígua) a ser incluída ou ignorada.

Aqui, as seções são marcadas por nome, e o comportamento é escolhido pelo autor da chamada, que pode incluir ou pular seções, conforme necessário. Diferentes páginas podem incluir ou excluir seções selecionadas; pode haver números arbitrários de seções, que também podem se sobrepor de forma arbitrária.

A marcação de seções por nome em vez de comportamento permite que links de edição de seção sejam processados de forma mais adequada para obter trechos de texto maiores, já que a extensão pode agora responder por seções que são ignoradas no início da página, permitindo que seções transcluídas sejam compensadas de forma adequada.

Passo 1: Marque as seções
Marque as seções no texto usando tags, desta maneira:

&lt;translate>this is a chapter&lt;/translate>

Note that these tags are not HTML/XML, and do not use the normal attribute syntax. For this reason, and because the begin and end markers are individual, rather than normal XML open/close tags, this allows nested or overlapping sections. This allows you to insert section tags without worrying about interfering with other sections.

Passo 2a: Transclua a seção
Chame a parser function #lst para transclui-la, p.ex. para transcluir uma seção chamada chapter1 de uma página chamada articleX:

O artigo de destino define o local da seção; o seu comportamento é determinado pela parser function.

Passo 2b: Transclua a página, mas excluindo a seção
Para transcluir uma página, porém excluindo uma seção específica, utilize a função #lstx:

Opcionalmente, você pode adicionar o texto de substituição para a seção excluída.

Exemplo:

O texto de substituição será exibido na área onde a seção é ignorada (excluída).

Seções adjacentes
É possível ter várias seções com o mesmo nome; neste caso, todas as seções com esse nome serão incluídas/excluídas. Isto é especialmente útil para marcar várias discussões.

Intervalos de seções
Estas funções têm um argumento adicional, opcional para especificar um intervalo de seção; ou seja,, para incluir tudo, desde o início do capítulo 1 ao fim do capítulo 3. Isto permite a utilização de pares de marcadores vazios para marcar uma extremidade da seção, possivelmente em uma predefinição. Um mecanismo semelhante é usado atualmente no Wikisource em francês.

Substituição
Isso também funciona com substituição; é até possível para um artigo substituir uma seção dele mesmo. Um dos usos fornece uma maneira elegante para arquivar páginas de discussão: Marque o texto a ser arquivado usando, etc. Em seguida, crie uma página de arquivo com o texto, usando archive , que copia seções arquivadas. Por fim, substitua o conteúdo do talk_page com archive para remover essas seções.

Transcluindo seções através de títulos
Há suporte opcional para transcluir seções de texto marcadas com os títulos normais, ou seja,. Se instalado, isto é feito com a função lsth.

Transclusão de introdução
Para transcluir a introdução de uma página (isto é, o conteúdo antes da primeira posição), usar

Transclusão de uma seção específica
Você também pode transcluir todo o conteúdo da sectionX (que inclui todas as suas sub-secções, mas exclui o título de sectionX).

Coisas a serem observadas:


 * 1) Apenas a primeira ocorrência de sectionX é transcluída se você tiver mais de uma seção com o mesmo nome.
 * 2) Certifique-se de digitar o título de sectionX que está em código wiki, não como ele é exibido. Por exemplo, se o título da seção é  , você deve digitar " ", não " ".
 * 3) A correspondência não diferencia maiúsculas de minúsculas, para evitar links quebrados devido a alterações de caso.

Transclusão de múltiplas seções
Você também pode transcluir a partir da primeira ocorrência de sectionX (excluindo o próprio cabeçalho de sectionX) até que atinja a próxima ocorrência de sectionY. Observe que sectionY atua como um ponto de parada de forma que a inclusão não contém o conteúdo de sectionY.

Notas sobre títulos ignorados
Uma vez que a transclusão tradicional no MediaWiki não se destina a transcluir seções, que não leva em conta títulos ignorados. Como resultado, se você fosse transcluir um predefinição com vários títulos, e pular o primeiro título, em seguida, todos os links de edição de seções apontaria para a seção errada na predefinição.

Quando esta extensão é usada (com MediaWiki 1.9 ou posterior), as funções #lst e #lsth contam títulos na parte inicial "ignorada", e compensam títulos transcluída adequadamente. Isso permitirá que esses links apontem para a seção correta no caso simples.

Note que #lstx não conta títulos ignorados, e que estes títulos dentro de seções adjacentes não são compensados​​. '''Mas parece que isso foi corrigido agora (provavelmente quando portado para o novo pré-processador do MediaWiki). Os títulos transcluídos podem ser ligados às seções corretas'''.

Localização
Internamente, todas as funções do analisador usam o prefixo lst, por coerência com o nome da extensão. Uma vez que esta sigla pode ser confusa para não-desenvolvedores, as variantes de inglês legível foram introduzidas, então as funções atualmente podem ser chamadas a partir de qualquer nome.

Adicionalmente, a tag já pode ser localizada (atualmente inglês, alemão e hebraico), ou seja:


 * Inglês: ...
 * Alemão:  ... 
 * Hebraico (RTL): <קטע התחלה=א> ... <קטע סוף=א> (código de "início" para a direita e código de "final" para a esquerda)
 * Português:  ...

Limitações

 * While it is possible to use this extension across namespaces, interwiki references are not resolved. It is not yet possible, for example, to include part of a Wikisource page into a remote MediaWiki installation.
 * Section tags cannot themselves be transcluded in order to work on other pages. This means, for instance, that these tags cannot be embedded in a template using template parameters and parser functions. The  magic word does not work with section tags.   produces balanced tags, while the section tags uses singular tags. See.
 * As of 2014, section tags don't have any effect when used inside a template parameter. If page A contains a text, there's no way  can access X.

Exemplos

 * wikisource:user:sanbeg/Includer é uma demonstração a curto prazo, que mostra algumas das características básicas.
 * Bible/2_John/1/1 é uma das primeiras páginas de conteúdo que mostram como usar a extensão.

Ver também

 * DynamicPageList (third-party) includes a slightly modified built-in version of Labeled Section Transclusion