Conteúdo apagado Conteúdo adicionado
← nova página: {{cabeçalho para documentação | título = Transclusão | seção = | anterior = Estado dos progressos | posterior =... |
Sem resumo de edição |
||
Linha 8:
}}
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
Na Wikisource, a transclusão é usada principalmente para incluir páginas do espaço nominal [[Ajuda:Obras com visualização de originais|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
Esta transclusão é feita usando a função <code>'''<nowiki> <pages /> </nowiki>'''</code>.
== Funcionamento da tag <nowiki><pages /></nowiki> ==
A tag <nowiki> <pages /> </nowiki> 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 <nowiki><pages/></nowiki>, e o método mais antigo, usando {{tl|Página}}. Quase sempre, a tag <nowiki><pages/></nowiki> é 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 <nowiki><pages/></nowiki> a seguir:
<pre><pages index="file_name.djvu" from=x to=y/></pre>
:*"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.
<div style="margin: 0.5em auto; padding: 0 0.5em 0.5em 0.5em; border:1px solid green; margin-left:1.5em;">Exemplo
Para apresentar o que foi transcluído em [[A Ilustre Casa de Ramires/I]], você digitaria:
<pre><pages index="A illustre Casa de Ramires (1900).djvu" from=9 to=36 header=1/></pre>
</div>
</div>
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===
Podem ser especificados, também, os seguintes tributos dentro da tag <nowiki><pages /></nowiki>:
* '''index''' (''obrigatório''): o nome da página de índice da obra transcrita, sem o prefixo {{verde|Galeria:}};
Linha 24 ⟶ 45:
* '''onlysection''' (''opcional''): transclui apenas a seção indicada em todas as páginas;
* '''header''' (''opcional''): ver [[#Header|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
{| class="wikitable"
Linha 46 ⟶ 67:
|Mostra as páginas 2, 3, 4, 5 e 9.
|}
Pode-se, é claso, utilizar todos atributos na mesma tag. Por exemplo <nowiki><pages from=1 to=10 include="31" exclude="2-4" step="2" /></nowiki> 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 {{sc|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).
| |||