Poem

De Wiki

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

<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:

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.

<poem>
Um,
Dois.
</poem>
<poem>
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".

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

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

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

Para Saber Mais

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

• http://www.mediawiki.org/wiki/Extension:Poem

É 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