Predefinição:Mbox

De Minecraft Wiki
Ir para: navegação, pesquisa
[ver | editar | histórico | purgar]Documentação

Este é o {{mbox}}, uma predefinição do meta para caixas de mensagem com estilo semelhante ao da Wikipédia.

Esta predefinição, na nossa wiki, possui duas variantes, mas que se adaptam entre os namespaces. Para os artigos e imagens, usa-se a variante Ambox, enquanto para todo o resto da wiki, como mensagens de sistema, categorias, páginas de discussão e predefinições, é usada a variante Ombox. Usando {{mbox}}, a caixa se adapta automaticamente.

Portanto, {{ambox}} e {{ombox}} não devem ser usados diretamente na Minecraft Wiki. Se você quer travar uma predefinição para usar apenas um dos estilos, leia abaixo sobre como usar o parâmetro {{{demospace}}}.

Exemplos de uso

Exemplo básico:

{{mbox
| text = Esta é uma caixa de mensagem normal.
}}

Exemplo complexo:

{{mbox
| type      = style
| image     = [[File:Grass Block.png|40px]]
| style     = width: 400px; 
| textstyle = color: red; font-weight: bold; font-style: italic;
| text      = Texto útil e descritivo.
}}

Tipos de caixa de mensagem nas páginas

Os exemplos a seguir usam diferentes parâmetros de type, mas não usam parâmetros de imagem; portanto, eles usam as imagens padrão para cada tipo.

Exemplos

Alguns exemplos usando o estilo "notice":

Parâmetros

Lista com todos os parâmetros:

{{mbox
| demospace = {{{demospace|}}} / main / talk / file / category / other
| name = nome da predefinição
| type  = speedy / delete / content / style / notice / move / protection
| image = none / [[File:Alguma imagem.svg|40px]]
| imageright = [[File:Alguma imagem.svg|40px]]
| style = valores CSS
| textstyle = valores CSS
| plainlinks = no
| text  = O texto do corpo da mensagem. 
| small = {{{small|}}} / yes / left
| smallimage = none / [[File:Alguma imagem.svg|30px]]
| smallimageright = none / [[File:Alguma imagem.svg|30px]]
| smalltext  = Um texto mais curto no corpo da mensagem.
}}

demospace

(opcional) Usado para travar o tipo da caixa. "main" e "file" geram uma ambox, enquanto os outros geram uma caixa comum ombox.

name

(Opcional) Nome da predefinição. Isso adiciona uma classe CSS com o nome box-name ao elemento HTML, para uso por bots ou scripts.

type

Se nenhum parâmetro type for fornecido, o modelo padrão será o tipo notice. Isso significa que obtém uma borda cinza.

image

Sem parâmetro = Se nenhum parâmetro image for fornecido, a predefinição usa uma imagem padrão. Qual imagem padrão ele usa depende do parâmetro type.
Uma imagem = Deve ser uma imagem com notação wiki normal. Largura de 40px - 50px geralmente é aproximadamente certa, dependendo da proporção entre a altura e a largura da imagem. (Mas a caixa de mensagem pode lidar com imagens de qualquer tamanho.) Por exemplo:
image = [[File:Iron Ore.png|40px]]Iron Ore JE3.png
Um sprite com itens do game = Deve ser uma imagem do {{invSprite}}. É possível alternar o parâmetro scale pra deixar maior ou menor de acordo com a necessidade, mas o ideal é 1.3. Por exemplo:
image = {{InvSprite|Batata|scale=1.3}}
none = Significa que nenhuma imagem é usada.

imageright

Sem parâmetro = Se nenhum parâmetro imageright for fornecido, não é mostrado nenhuma imagem no lado direito.
Uma imagem = Deve ser uma imagem com notação wiki normal. Largura de 40px - 50px geralmente é aproximadamente certa, dependendo da proporção entre a altura e a largura da imagem. (Mas a caixa de mensagem pode lidar com imagens de qualquer tamanho.) Por exemplo:
image = [[File:Piston.png|40px]]Piston.png
Um sprite com itens do game = Deve ser uma imagem do {{invSprite}}. É possível alternar o parâmetro scale pra deixar maior ou menor de acordo com a necessidade, mas o ideal é 1.3. Por exemplo:
image = {{InvSprite|Estandarte cantão roxo na ponta dextra|scale=1.3}}
Qualquer coisa = Qualquer outro objeto que você deseja mostrar no lado direito.

style

Valores CSS opcionais, usados por toda a tabela da caixa de mensagem. Sem aspas " " mas com o ponto e vírgula no final ;. Por exemplo:
style = margin-bottom: 0.5em;
Importante: nem todas as caixas são suportadas pelo modo escuro. Para adicionar estilos CSS de cor, use o parâmetro name.

textstyle

Valores CSS opcionais, usados por todo o texto na célula. Por exemplo:
textstyle = text-align: center;

plainlinks

Normalmente, na Wikipedia, os links externos têm um ícone de seta ao lado deles, como este: Example.com. No entanto, nas caixas de mensagens, o ícone de seta é suprimido por padrão, assim: Example.com. Para obter o estilo normal de link externo com o ícone de seta, use |plainlinks=no.

text

O texto do corpo da mensagem.

Parâmetro small

Nota: a seguir é exibido o uso em omboxes, que aceitam "yes" para caixas pequenas. No caso da ambox é a mesma coisa, porém o parâmetro deve ser definido como "left".

small

yes = Torna-o uma caixa de mensagem menor flutuante à direita. Isso também torna as imagens padrão menores. Observe que quaisquer dados dos parâmetros smallimage, smallimageright e smalltext são exibidos apenas de "small=yes". Para fazer com que sua predefinição também entenda o parâmetro small, você pode usar este código:
small = {{{small|}}}

smallimage

Sem parâmetro = Se o parâmetro smallimage não é definido, a predefenição usará o parâmetro image. Se o parâmetro image também está vazio então a imagem padrão pequena é utilizada.
Uma imagem = Deve ser uma imagem com notação wiki normal. Largura de 30px geralmente é a ideal. Por exemplo:
smallimage = [[File:Prof hydra.png|30px]]
none = Significa que nenhuma imagem é usada. Isso substitui qualquer imagem no parâmetro image, quando "small=yes".

smallimageright

Sem parâmetro = Se o parâmetro smallimageright não é definido, a predefenição usará o parâmetro imageright. Se o parâmetro imageright também está vazio então nenhuma imagem é exibida no lado direito.
Uma imagem = Deve ser uma imagem com notação wiki normal. Largura de 30px geralmente é a ideal. Por exemplo:
smallimageright = [[File:Nuvola apps bookcase.png|30px]]
Qualquer coisa = Qualquer outro objeto que você deseja mostrar no lado direito.
none = Significa que nenhuma imagem é usada. Isso substitui qualquer imagem no parâmetro imageright, quando "small=yes".

smalltext

A shorter version of the message body text. If no smalltext parameter is given then this template falls back to use the text parameter.
Uma versão mais curta do texto do corpo da mensagem. Se nenhum parâmetro smalltext for fornecido, esta predefinição volta a usar o parâmetro text.

Detalhes técnicos

Se você precisa usar caracteres especiais no parâmetro de texto, você precisa escapar deles assim:

{{mbox
| text  = <div>
Sinal de igual = e uma chave de início e fim { } funcionam naturalmente. 
Mas aqui está uma barra {{!}} e duas chaves de fim <nowiki>}}</nowiki>. 
E aqui está uma barra com duas chaves de fim <nowiki>|}}</nowiki>.
</div>
}}

Esta predefinição usa as classes CSS da mbox em MediaWiki:Gadget-enwp-boxes.css para a maioria de seus looks, portanto, é totalmente modificável com skins.

Para mais detalhes técnicos veja a página da predefinição no Meta.

[ver | editar | histórico | purgar]A documentação acima é transcluída de Predefinição:Mbox/doc.