Poem
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