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>

Observe que ela utiliza dois marcadores individuais, em vez das tags XML normais de abertura e fechamento, o que simplifica seções aninhadas ou sobrepostas. Isso permite que você insira marcas de seção sem se preocupar com a interferência com outras seções.

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

 * Embora seja possível usar essa extensão em todos os namespaces, referências interwiki não são resolvidas. Ainda não é possível, por exemplo, para incluir parte de uma página Wikisource em uma instalação remota do MediaWiki.
 * Tags de seção Tags de seção não podem se ser transcluídas para funcionar em outras páginas. Isto significa, por exemplo, que essas tags não podem ser incorporadas em uma predefinição usando parâmetros de predefinição e funções parser. A palavra mágica  não funciona com tags de seção.   produz tags equilibradas, enquanto as tags de seção utiliza tags singulares. Consulte.

Requisitos
Esta extensão requer uma instalação do MediaWiki com suporte para funções parser. Este suporte foi amadurecido na série 1.7, embora algumas versões da 1.6 também podem ser feitas para funcionar.

Melhorias do analisador do MediaWiki
Support for regression testing parser functions was added in MediaWiki 1.9alpha (17410) in order to test this extension; if you want to run the regression tests in an older installation, you'll need to apply the patch for maintenance/ParserTests.inc from 7801

Support for offsetting edit section links (so that it can detect sections that aren't transcluded, and skip them) was added in MediaWiki 1.9alpha (18218).

Como instalar
Copie os arquivos da extensão de Subversion, e coloque em seu diretório de extensões. Então, inclua o seguinte no arquivo LocalSettings.php:

Para habilitar a transclusão de seções visuais, também adicione

Since the code is still undergoing some restructuring in preparation for deployment on the official projects, the internal functions may change from time to time. Although there is currently no public API to call these functions, DynamicPageList2 calls some of the internal functions directly. To make this more stable, the file compat.php has been added, in order to provide a more consistent API. This file is not used by LST, and is only provided for compatibility with DPL2.

Se estiver usando DPL2, você também deve adicionar

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

 * Subversion download
 * Brion's comments on the application of the extension at Wikisource
 * The original proposal (at en.wikisource)
 * 5881 contains older versions of the extension as attachments.
 * 7995 is a Wikimedia site request to have this extension installed at Wikisource.
 * 6563 describes a limitation in template transclusion that is addressed by this extension.
 * DynamicPageList (third-party) includes a slightly modified built-in version of Labeled Section Transclusion