Transclusão
A transclusão permite que uma página seja incluída em outra. Esta página de ajuda explica o princípio geral de transclusão e sua implementação prática usando a tag <pages />. Esse é um guia para transclusão de textos transcritos por meio da extensão ProofreadPage.

A transclusão, em ciência da computação, é o ato de incluir uma página dentro de outra dinamicamente. A transclusão é diferente de cópia pois qualquer modificação da página de "origem" será refletida, de modo automático e imediato, na página "hospedeira".

Na Wikisource, a transclusão é usada principalmente para incluir páginas do espaço nominal Página (aonde os textos digitalizados são transcritos) ao espaço nominal principal (aonde o texto será exibido aos leitores). A transclusão é, portanto, mais frequentemente realizada após a revisão da transcrição do texto de obras digitalizadas, e permite que seja apresentado os leitores um texto seguindo sua estrutura lógica: por seções, por capítulos, por poemas... e não de acordo com a divisão física da obra original.

Esta transclusão é feita usando a função <pages /> .

Funcionamento da tag <pages /> editar

A tag <pages /> permite transcluir onde é usada um conjunto de páginas transcritos de páginas de origem, no todo ou em parte, de um livro que conhecemos a página de índice no domínio Galeria (nota: o número da página do índice do arquivo, djvu ou pdf, geralmente é diferente do número da página do livro em papel.)

Na maioria das vezes você irá transcluir várias páginas juntas do domínio Página: para o domínio principal como em A Ilustre Casa de Ramires/I. Há dois métodos que podem realizar a transclusão de páginas inteiras: usando a tag <pages/>, e o método mais antigo, usando {{Página}}. Quase sempre, a tag <pages/> é o melhor método de transclusão, mas você pode se deparar ainda com a predefinição antiga ao editar textos existentes.

Na página onde o texto será transcluído, use a sintaxe <pages/> a seguir:

<pages index="file_name.djvu" from=x to=y/>
  • "file_name.djvu" deve ser substituído pelo nome exato da página de galeria (sem o Galeria:) em que consta o índice da obra sendo transcrita.
  • "x" é o número que aparece após a barra inclinada (/) que segue o nome do arquivo/ficheiro da primeira página a ser transcluída.
  • "y" é o número que aparece após a barra inclinada (/) que segue o nome do arquivo/ficheiro da ultima página a ser transcluída.
Exemplo

Para apresentar o que foi transcluído em A Ilustre Casa de Ramires/I, você digitaria:

<pages index="A illustre Casa de Ramires (1900).djvu" from=9 to=36 header=1/>

que irá transcluir o texto das páginas Página:A illustre Casa de Ramires (1900).djvu/9 até a página Página:A illustre Casa de Ramires (1900).djvu/36, e inserir o cabeçalho de navegação

Todos atributos editar

Podem ser especificados, também, os seguintes tributos dentro da tag <pages />:

  • index (obrigatório): o nome da página de índice da obra transcrita, sem o prefixo Galeria:;
  • from (recomendado): a página inicial da transclusão do texto (página física do livro). Omitir esse parámetro e o parâmetro to para transcluir o sumário da obra;
  • to (recomendado): a página final do intervalo de transclusão (página física do livro);
  • fromsection (opcional): para transcluir na partir da página from, apenas seção indicada;
  • tosection (opcional): para trascluir na página to, apenas a seção indicada;
  • onlysection (opcional): transclui apenas a seção indicada em todas as páginas;
  • header (opcional): ver Header ;
  • step (opcional): permite transcluir uma página a cada n-páginas, contando a partir da primeira (indicada pelo from);
  • exclude (opcional): permite indicar quais páginas não se devem transcluir dentro do intervalo indicado; se várias páginas, listá-las entre aspas, usando virgula como separador.
  • include (opcional): permite incluir as páginas indicadas; se for o caso de várias páginas, listá-las entre aspas, usando virgula como separador.
código efeito produzido
<pages index="Baudelaire - Les Fleurs du mal 1857.djvu" from="106" to="107" /> Transclui as páginas 106 à 107 do livro Baudelaire - Les Fleurs du mal 1857.djvu.
<pages index="Dickens - La Petite Dorrit - Tome 2.djvu" from="16" fromsection="chap2" to="20" tosection="chap2" /> Transclui as páginas 16 à 20 du livre Dickens - La Petite Dorrit - Tome 2.djvu. Pour la page 16, transclure uniquement la section chap2, pour la page 20 transclure uniquement la section chap2.
<pages index="" from="1" to="10" step=2 /> Mostra as páginas 1, 3, 5, 7 e 9.
<pages index="" from="1" to="10" exclude="2-5,9" /> Mostra as páginas 1, 6, 7, 8 e 10.
<pages index="" include="2-5,9" /> Mostra as páginas 2, 3, 4, 5 e 9.

Pode-se, é claso, utilizar todos atributos na mesma tag. Por exemplo <pages from=1 to=10 include="31" exclude="2-4" step="2" /> irá apresentar a 1ª, 5ª, 7ª, 9ª e 31ª página.

Nota: Uma boa prática diz que os atributos dentro da tag <pages> devem estar entre aspas. É importante não ter atributos vazios sem aspas dentro de tags, então, por favor, ou inclua os atributos vazios usando aspas, u remova os atributos desnecessários..

Os números das páginas exibidos na lateral das páginas transcluídas são os números atribuídos a essas páginas na página de índice do livro (que devem corresponder ao número atribuído na paginação original do livro).

Se o atributo from estiver presente sem o atributo to, então o último é definido por padrão para a última página do livro: as páginas são transcluídas até o final do livro.

Se nem from, nem to estão presentes, então obtemos uma transclusão da sumário do livro conforme aparece na página de índice do espaço do Livro, precedido por uma caixa de título contendo as informações desta página (ver Header).

Header editar

O atributo header é usado para exibir uma caixa de navegação acima das páginas transcluídas. Esta caixa de navegação contém as informações encontradas na página índice do livro de onde se originam as páginas transcluídas: título, autor, edição, etc. Os valores possíveis para o atributo header são:

  • header = 1: caixa de título com caixa de navegação ({{navegar}}). Abaixo do título da página obtemos uma caixa de navegação que inclui um link para o texto anterior e um link para o texto que segue o texto atual. Esses links são obtidos automaticamente a partir dos links que aparecem nos conteúdos presentes na página de índice do espaço Galeria.
  • header = "toc": caixa de título sem navegador, apenas as informações da página de índice são incluídas. Não há links para os textos anteriores e posteriores ao texto atual. Os números das páginas transcluídas também não são indicados.


Como mencionado acima, ambos from e to não são especificados na tag <pages /> , obtemos uma transclusão do sumário do livro. A caixa de título tem a mesma aparência de header = "toc" .

Exemplos

código effet produit
<pages index="Dickens - La Petite Dorrit - Tome 2.djvu" from="16" to="20" header=1/> Transclui as páginas 16 à 20 do livro Dickens - La Petite Dorrit - Tome 2.djvu, boîte de titre avec navigateur. Résultat. Noter que les liens vers le texte suivant et le texte précédent sont ceux qui apparaissent autour du texte dans le sommaire sur la page d’index du Livre.
<pages index="Verlaine - Œuvres complètes, Vanier, I.djvu" from="440" fromsection="s2" to="442" header=Sommaire /> Transclui as páginas 440 à 442 do livro Verlaine - Œuvres complètes, Vanier, I.djvu. Boîte de titre sans navigateur. Résultat.
<pages index="Bloy - Les Dernières Colonnes de l’Église, Mercure de France, 1903.djvu"/> Transclui o sumário do livro Bloy - Les Dernières Colonnes de l’Église, Mercure de France, 1903.djvu. Résultat.

Ver também editar