Ikebanto: /* Para Saber Mais */

2010-01-26T06:56:12Z

Para Saber Mais

2010-01-26T06:55:46Z

Para Saber Mais

Ikebanto: Nova página: == 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>
2010-01-26T06:51:46Z

Nova página: == 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></poe...

Página nova
== 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 ==

{| cellspacing="5"
!Texto de Entrada
!Texto de Saída
|-
|valign="top"|<pre><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></pre>
|valign="top"|
<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:

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

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.

{| cellspacing="5"
!Entrada
!Saida
!Entrada
!Saida
|-
|valign="top"|<pre><poem>
Um,
Dois.
</poem>
<poem>
Tres?
Quatro!
</poem></pre>
|valign="top"|
<poem>
Um,
Dois.
</poem>
<poem>
Tres?
Quatro!
</poem>
|valign="top"|<pre><poem compact>
Um,
Dois.
</poem>
<poem compact>
Tres?
Quatro!
</poem></pre>
|valign="top"|
<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 '' <nowiki><poem> ... </poem></nowiki>'', mas não dentro de ''<nowiki><poem ... ></nowiki>'' Isso impede que modelos como o código: ''<nowiki><poem style="{{{1}}}"></nowiki>.''

* Em vez disso uma solução é usar <nowiki><div style="{{{1}}}"> <poem> ... </poema> </ div> </nowiki>.

* Outra é usar o <code>#tag</code> [http://www.mediawiki.org/wiki/Help:Magic_words#Miscellaneous magic word]: <nowiki> ((# tag: poema | ... | ="{{{ estilo 1 }}}"}}</nowiki>.

** Obs: Este parece, no entanto, não para trabalhar com a opção ''"compact"''.

{| cellspacing="5"
!Entrada (interior OK, dentro não OK)
!Saida
|-
|valign="top"|<pre><poem style="{{{1|border: 1px solid Black;}}}">
Um,
{{{2|Dois.}}}
<poem></pre>
|valign="top"|
<poem style="{{{1|border: 1px solid Black;}}}">
One,
{{{2|Two.}}}
</poem>
|-
!Entrada (ambos interior OK, dentro OK)
!Saida
|-
|valign="top"|<pre><div style="{{{1|border: 1px solid Black;}}}"><poem>
Um
{{{2|Dois.}}}
</poem></div></pre>
|valign="top"|
<div style="{{{1|border: 1px solid Black;}}}"><poem>
Um,
{{{2|Dois.}}}
</poem></div>
|-
|valign="top"|<pre>{{#tag:poem|
Um,
{{{2|Dois.}}}
|style="{{{1|border: 1px solid Black;}}}"
}}</pre>
|valign="top"|
{{#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.