Poem

De Pontão Nós Digitais
Ir para navegaçãoIr para pesquisar

O faz essa extensão?

A extensão do poema, permite a inclusão fácil de poemas e materiais similares, nas páginas do MediaWiki, simplesmente colocando-os entre <poem></poem> marcas, em vez de adicionar <br> até o fim ou: no início de cada linha, que é prática comum agora. Apesar de pequeno, poderia ser útil, especialmente na biblioteca ou projetos similares (há poemas com milhares de linhas, a solução de tão obviamente atual não é prático). A extensão preserva wikilinks, negrito, etc, se estiverem presentes no poema, assim como avançar as linhas que começam com espaços.


Instalando a extensão

Primeiro Coisa é baixar a extensão. Pode fazer isso usando o no terminal o comando:

wget http://upload.wikimedia.org/ext-dist/Poem-MW1.15-r47297.tar.gz 


Na seguencia voce descompacta o arquivo na pasta extensions do seu wiki:

tar -xzf Poem-MW1.15-r47297.tar.gz -C /var/www/mediawiki/extensions


Em seguida, adicione a seguinte linha no seu LocalSettings.php:

require_once($IP.'/extensions/Poem/Poem.php');

Exemplo

Texto de Entrada Texto de Saída
<poem>
meus avós foram queimados
pelo sol da África
minh'alma recebeu o batismo dos tambores
atabaques, gongôs e agogôs
Contaram-me que meus avós
vieram de Loanda
como mercadoria de baixo preço
plantaram cana pro senhor de engenho novo
e fundaram o primeiro Maracatu
Depois meu avô brigou como um danado
nas terras de Zumbi
Era valente como quê
Na capoeira ou na faca
escreveu não leu
o pau comeu
Não foi um pai João
humilde e manso
</poem>

<poem> meus avós foram queimados pelo sol da África minh'alma recebeu o batismo dos tambores atabaques, gongôs e agogôs Contaram-me que meus avós vieram de Loanda como mercadoria de baixo preço plantaram cana pro senhor de engenho novo e fundaram o primeiro Maracatu Depois meu avô brigou como um danado nas terras de Zumbi Era valente como quê Na capoeira ou na faca escreveu não leu o pau comeu Não foi um pai João humilde e manso </poem>


Estilo

O texto poema é envolto em uma div, que não tem estilo, por padrão, mas herda qualquer estilo ou opção de classe passado para o poema.

Por exemplo, enquanto o texto recortado pode ser usado para exemplos simples para evitar encher e ultrapassar uma bela caixa azul, pode ser difícil de ler em alguns casos, desde longas linhas não são quebradas. Um efeito semelhante ou um pouco melhor pode ser obtido com:

<poem style="border: 1px dashed #2f6fab; background-color: #f9f9f9; padding: 1em;">


Quando aplicado ao exemplo acima, o resultado é o seguinte:


<poem style="border: 1px dashed #2f6fab; background-color: #f9f9f9; padding: 1em;"> meus avós foram queimados pelo sol da África minh'alma recebeu o batismo dos tambores atabaques, gongôs e agogôs Contaram-me que meus avós vieram de Loanda como mercadoria de baixo preço plantaram cana pro senhor de engenho novo e fundaram o primeiro Maracatu Depois meu avô brigou como um danado nas terras de Zumbi Era valente como quê Na capoeira ou na faca escreveu não leu o pau comeu Não foi um pai João humilde e manso </poem>


Opção "compact"

Normalmente, o analisador toma cada verso do poema em um parágrafo. Ocasionalmente, se isso não é desejado, utilizando a opção "compact" suprime-se novas linhas no poema, para permitir que versos de estrofes diferentes possa se misturar.

Entrada Saida Entrada Saida
<poem>
Um,
Dois.
</poem>
<poem>
Tres?
Quatro!
</poem>

<poem> Um, Dois. </poem> <poem> Tres? Quatro! </poem>

<poem compact>
Um,
Dois.
</poem>
<poem compact>
Tres?
Quatro!
</poem>

<poem compact> Um, Dois. </poem> <poem compact> Tres? Quatro! </poem>


Problemas e Soluções

  • As variáveis e Funções (ParserFunctions) fazem o trabalho dentro das marcas <poem> ... </poem>, mas não dentro de <poem ... > Isso impede que modelos como o código: <poem style="{{{1}}}">.
  • Em vez disso uma solução é usar <div style="{{{1}}}"> <poem> ... </poema> </ div> .
  • Outra é usar o #tag magic word: ((# tag: poema | ... | ="{{{ estilo 1 }}}"}}.
    • Obs: Este parece, no entanto, não para trabalhar com a opção "compact".


Entrada (interior OK, dentro não OK) Saida
<poem style="{{{1|border: 1px solid Black;}}}">
Um,
{{{2|Dois.}}}
<poem>

<poem style="border: 1px solid Black;"> One, Two. </poem>

Entrada (ambos interior OK, dentro OK) Saida
<div style="{{{1|border: 1px solid Black;}}}"><poem>
Um
{{{2|Dois.}}}
</poem></div>
<poem>

Um, Dois.

</poem>
{{#tag:poem|
Um,
{{{2|Dois.}}}
|style="{{{1|border: 1px solid Black;}}}"
}}

<poem style="border: 1px solid Black;"> Um, Dois. </poem>


Para Saber Mais

Esse artigo tem como base o artigo em ingles da dita extenção no seguinte link:

É uma tentativa de tradução, ou seja provavelmente a erros por aqui, fique a vontade para fazer as correções.


Referencia: http://ikebanto.batemacumba.net/index.php?title=Poem