Referência de marcação wiki

There were scripting errors on this page. While those are being addressed by site editors, you can view partial content below.

O seguinte trata-se duma folha de referência de marcação do wiki específica ao MDC que reflecte as nossas actuais "melhores-práticas" para marcação das páginas do nosso wiki. A folha de referências está sujeita a mudanças ao longo do tempo, claro. Por isso são apenas recomendações fortes em vez de regras puras-e-duras.

Se precisa de fazer alguma marcação que vai contra estes princípios, faça-o -- ninguém vai gritar consigo. Apenas tente respeitar estes princípios o máximo possível.

Se possui alguma dúvida sobre estas indicações de marcação, contacte a alguém na comunidade.

Básico

Seções, Parágrafos e Novas Linhas

Resultado Marcação
Seções

This code prevents confusion in the section editing feature

<font style="font-size:160%"> Seção </font>

<hr>

<font style="font-size:140%"> Subseção </font>

<hr>

<font style="font-size:120%"> Subsubseção</font>

<font style="font-size:100%"> Subsubsubseção</font>

Caso necessite mais que quatro níveis de seção em um documento é recomendado que o divida em páginas menores, ligando-as entre si.

= Seção =

== Subseção ==

=== Subsubseção ===

==== Subsubsubseção ====
Parágrafos e Novas Linhas

Uma linha em branco entre duas

linhas implica em parágrafo novo.

Forçar uma linha nova na escrita do código não implica em retorno de carro.

Para isto use
a etiqueta "br"
durante a
sua escrita.

Uma linha em branco entre duas

linhas implica em parágrafo novo.

Forçar uma linha nova na escrita
do código não implica em retorno
de carro.

Para isto use <br/>
a etiqueta "br" <br/>
durante a <br/>
sua escrita.

Formatação de Texto

Resultado Marcação
Formatação de Texto

itálico ou ênfase

''itálico'' ou ''ênfase''

negrito ou forte


'''negrito''' ou '''forte'''

itálico negrito ou muito forte

'''''itálico negrito''''' ou '''''muito forte'''''

Aqui está algum código em-linha como exemplo.

Aqui está algum <code>código em-linha</code> como exemplo.
É assim que se
    fazem blocos
    de código.
<pre>
É assim que se
    fazem blocos
    de código.
</pre>
Blockquotes - isto é um bloco para citação.
<blockquote>
Blockquotes - isto é um bloco para citação.
</blockquote>

Texto pequeno.

<small>Texto pequeno.</small>

<big>Texto grande.</big>

<big>Texto grande.</big>

Riscado.

<strike>Riscado.</strike>

Sublinhado.

<u>Sublinhado.</u>

SuperScript.

<sup>Super</sup>Script.

SubScript.

<sub>Sub</sub>Script.

Listas

Resultado Marcação
Listas Marcadas
  • Manuais
    • Referências
    • Guia
  • Artigos
    • Tutoriais
      • JavaScript
      • HTML
      • CSS
    • Truques & Dicas
  • Perguntas Frequentes

As marcas das listas, a indentação e outros detalhes podem ser alterados via CSS. Acredite, este termo indentação existe. É o mesmo que identação, endentação ou edentação.

* Manuais
** Referências
** Guia
* Artigos
** Tutoriais
*** JavaScript
*** HTML
*** CSS
** Truques & Dicas
* Perguntas Frequentes
Listas Numeradas
  1. Manuais
    1. Referências
    2. Guia
  2. Artigos
    1. Tutoriais
      1. JavaScript
      2. HTML
      3. CSS
    2. Truques & Dicas
  3. Perguntas Frequentes

Os números e estilo da lista podem ser alterados via CSS.


# Manuais
## Referências
## Guia
# Artigos
## Tutoriais
### JavaScript
### HTML
### CSS
## Truques & Dicas
# Perguntas Frequentes

Atalhos

Resultado Marcação
Atalhos Internos

Atalho interno simples para outra página...

O dia 1 de Abril é o Dia das Mentiras.

O dia 1 de Abril é o [[Dia das Mentiras]].

Atalho interno onde o título da página-alvo é diferente do texto do atalho...

Por acaso o dia 1 de Abril também é o aniversário da Dria.

Por acaso o [[Dia das Mentiras|dia 1 de Abril]] também é o aniversário da Dria.

Atalho interno para uma secção específica de outra página...

Alguns Aniversários no Dia das Mentiras.

[[Dia das Mentiras#Aniversários|Alguns Aniversários no Dia das Mentiras]].

Terminação misturada à palavra mas não ao atalho...

Em Abril, as flores começam a desabrochar.plural de açafrão é açafrões, o que não daria para usar como exemplo.

Em Abril, as [[flor]]es começam a desabrochar.

Adicionar uma assinatura que serve de atalho à sua página de Utilizador...

Dria

or

Dria 13:39, 15 Mar 2005 (EST)

~~~

or

~~~~
Atalhos Externos

Atalho URL simples...

http://www.mozilla.org

http://www.mozilla.org

Atalho Externo com um texto de atalho diferente...

Projeto Mozilla

[http://www.mozilla.org Projeto Mozilla]
Atalhos Interwiki

TBD

TBD

Comentários

Resultado Marcação

Aqui o comentário não aparece no resultado. É exatamente igual a um comentário HTML.

Use comentários para deixar notas e instrucções a outros escritores, editores e revisores.

Aqui está o comentário.

Aqui o comentário não aparece no resultado. 
É exatamente igual a um comentário HTML.

Use comentários para deixar notas e 
instrucções a outros escritores, editores e 
revisores.

<!-- Aqui está o comentário. -->

Avançado

Tabelas

Resultado Marcação
Marcação de Tabelas

Pode usar a habitual marcação HTML de tabelas para fazer tabelas wiki, ou pode usar a marcação wiki. A marcação wiki de tabelas usa menos caracteres , mas é a única vantagem. Use o que lhe é mais confortável.

cabeçalho 1 cabeçalho 2
célula 1 célula 2
<table class="tabela-normal">
  <tr>
    <th>cabeçalho 1</th>
    <th>cabeçalho 2</th>
  </tr>
  <tr>
    <td>célula 1</td>
    <td>célula 2</td>
  </tr>
</table>
cabeçalho 1 cabeçalho 2
célula 1 célula 2
{| class="tabela-normal"
|-
|class="header"|cabeçalho 1
|class="header"|cabeçalho 2
|-
|-
|célula 1
|célula 2
|-
|}

Imagens

Resultado Marcação
Imagens

Imagem em linha...

Image:firefox-logo.png

[[Image:firefox-logo.png]]

Imagem em linha com texto alternativo...

Firefox - Take back the web.

[[Image:firefox-logo.png|Firefox - Take back the web.]]

Imagem thumbnailtradução com texto alternativo...

Flower macro shot.

[[Image:flower.jpg|thumb|Flower macro shot.]]

Atalho para uma imagem...

Flower macro shot.

[[media:flower.jpg|Flower macro shot.]]

Categorias

Toda a página no wiki deve ser incluida em pelo menos uma Categoria MediaWiki. Para adicionar uma categoria numa página, use a sintaxe seguinte:

[[Categoria:NomeDaCategoria]]

Estes atalhos para categorias devem ser colocados no final das páginas a seguir ao conteúdo. Adicione a quantidade de categorias que achar apropriado. Por exemplo, um tutorial sobre como usar o depurador Venkman pode inserir-se nas categorias "Venkman", "Ferramentas" e "Tutoriais".

Todas as categorias, em seu lugar, devem ser colocadas em Categoria:Todas as Categorias.

Referências a versões de outras linguas

É sempre desejado referenciar as versões da página em outras linguagens. Por exemplo, para relacionar esta página com a sua versão em inglês, basta acrescentar a seguinte sintaxe no final da página:

 [[en:Help:Wiki Markup Reference]]

Ou seja, só precisa de inserir o atalho interno para a página que deseja referenciar com o prefixo que refere à lingua da versão.

A referência a versões de outras linguas também funciona (e é incentivado) em atalhos de categorias.

Forçar o Ignorar da Marcação Wiki

Se precisar que uma marcação wiki seja ignorada pelo analisador gramatical simplesmente envolva-o com etiquetas "nowiki"...

<nowiki>'''esta marcação wiki não será interpretada'''</nowiki>

'''esta marcação wiki não será interpretada'''

Retirado do trecho em inglês If you need a particular piece of wiki markup ignored by the parser, simply enclose it in "nowiki" tags, like so:

HTML no Wikitexto

As seguintes etiquetas são de momento aceitas na marcação wiki:

  • {{ mediawiki.interwiki('wikipedia', 'HTML_element#Presentational markup', '') }}
  • {{ mediawiki.interwiki('wikipedia', 'HTML_element#Presentational markup', '<big>') }}</big>
  • {{ mediawiki.interwiki('wikipedia', 'HTML_element#Text containers', '
    ') }}
  • {{ mediawiki.interwiki('wikipedia', 'HTML_element#Others', '
    ') }}
  • {{ mediawiki.interwiki('wikipedia', 'HTML_element#Tables', '') }}
  • <center>
  • <cite>
  • {{ mediawiki.interwiki('wikipedia', 'HTML_element#Logical markup', '') }}
  • {{ mediawiki.interwiki('wikipedia', 'HTML_element#Lists', '
    ') }}
  • {{ mediawiki.interwiki('wikipedia', 'HTML_element#Other containers', '
    ') }}
  • {{ mediawiki.interwiki('wikipedia', 'HTML_element#Lists', '
    ') }}
  • {{ mediawiki.interwiki('wikipedia', 'HTML_element#Lists', '
    ') }}
  • {{ mediawiki.interwiki('wikipedia', 'HTML_element#Logical markup', '') }}
  • {{ mediawiki.interwiki('wikipedia', 'HTML_element#Presentational markup', '<font>') }}</font>
  • {{ mediawiki.interwiki('wikipedia', 'HTML_element#Headings', '

    ') }}

  • {{ mediawiki.interwiki('wikipedia', 'HTML_element#Headings', '

    ') }}

  • {{ mediawiki.interwiki('wikipedia', 'HTML_element#Headings', '

    ') }}

  • {{ mediawiki.interwiki('wikipedia', 'HTML_element#Headings', '

    ') }}

  • {{ mediawiki.interwiki('wikipedia', 'HTML_element#Headings', '
    ') }}
  • {{ mediawiki.interwiki('wikipedia', 'HTML_element#Headings', '
    ') }}
  • {{ mediawiki.interwiki('wikipedia', 'HTML_element#Other containers', '<hr>') }}
  • {{ mediawiki.interwiki('wikipedia', 'HTML_element#Presentational markup', '') }}
  • {{ mediawiki.interwiki('wikipedia', 'HTML_element#Lists', '
  • ') }}
  • {{ mediawiki.interwiki('wikipedia', 'HTML_element#Lists', '
      ') }}
  • {{ mediawiki.interwiki('wikipedia', 'HTML_element#Text containers', '

    ') }}

  • {{ mediawiki.interwiki('wikipedia', 'HTML_element#Text containers', '
    ') }}
  • <rb>
  • <rp>
  • <rt>
  • <ruby>
  • {{ mediawiki.interwiki('wikipedia', 'HTML_element#Presentational markup', '<s>') }}</s>
  • {{ mediawiki.interwiki('wikipedia', 'HTML_element#Presentational markup', '') }}
  • {{ mediawiki.interwiki('wikipedia', 'HTML_element#Presentational markup', '') }}
  • {{ mediawiki.interwiki('wikipedia', 'HTML_element#Logical markup', '') }}
  • {{ mediawiki.interwiki('wikipedia', 'HTML_element#Presentational markup', '') }}
  • {{ mediawiki.interwiki('wikipedia', 'HTML_element#Presentational markup', '') }}
  • {{ mediawiki.interwiki('wikipedia', 'HTML_element#Tables', '') }}
  • {{ mediawiki.interwiki('wikipedia', 'HTML_element#Tables', '') }}
  • {{ mediawiki.interwiki('wikipedia', 'HTML_element#Tables', '') }}
  • {{ mediawiki.interwiki('wikipedia', 'HTML_element#Tables', '') }}
  • {{ mediawiki.interwiki('wikipedia', 'HTML_element#Presentational markup', '<tt>') }}</tt>
  • {{ mediawiki.interwiki('wikipedia', 'HTML_element#Presentational markup', '') }}
  • {{ mediawiki.interwiki('wikipedia', 'HTML_element#Lists', '
      ') }}
  • {{ mediawiki.interwiki('wikipedia', 'HTML_element#Logical markup', '') }}
  • {{ mediawiki.interwiki('wikipedia', 'HTML_element#Others', '') }}

Caracteres Especiais

Resultado Marcação

Umlauts (tremas) e acentos:

è é ê ë ì í

À Á Â Ã Ä Å
Æ Ç È É Ê Ë
Ì Í Î Ï Ñ Ò
Ó Ô Õ Ö Ø Ù
Ú Û Ü ß à á
â ã ä å æ ç
è é ê ë ì í
î ï ñ ò ó ô
œ õ ö ø ù ú
û ü ÿ


è é ê ë ì í

&Agrave; &Aacute; &Acirc; &Atilde; &Auml; &Aring;
&AElig; &Ccedil; &Egrave; &Eacute; &Ecirc; &Euml;
&Igrave; &Iacute; &Icirc; &Iuml; &Ntilde; &Ograve;
&Oacute; &Ocirc; &Otilde; &Ouml; &Oslash; &Ugrave;
&Uacute; &Ucirc; &Uuml; &szlig; &agrave; &aacute;
&acirc; &atilde; &auml; &aring; &aelig; &ccedil;
&egrave; &eacute; &ecirc; &euml; &igrave; &iacute;
&icirc; &iuml; &ntilde; &ograve; &oacute; &ocirc;
&oelig; &otilde; &ouml; &oslash; &ugrave; &uacute;
&ucirc; &uuml; &yuml;

Pontuação:
¿ ¡ « » § ¶
† ‡ • - – —

&iquest; &iexcl; &laquo; &raquo; &sect; &para;
&dagger; &Dagger; &bull; - &ndash; &mdash;

Símbolos comerciais:
™ © ® ¢ € ¥

£ ¤
&trade; &copy; &reg; &cent; &euro; &yen;
&pound; &curren;
Caracteres gregos:

α β γ δ ε ζ
η θ ι κ λ μ ν
ξ ο π ρ σ ς
τ υ φ χ ψ ω
Γ Δ Θ Λ Ξ Π
Σ Φ Ψ Ω

&alpha; &beta; &gamma; &delta; &epsilon; &zeta;
&eta; &theta; &iota; &kappa; &lambda; &mu; &nu;
&xi; &omicron; &pi; &rho;  &sigma; &sigmaf;
&tau; &upsilon; &phi; &chi; &psi; &omega;
&Gamma; &Delta; &Theta; &Lambda; &Xi; &Pi;
&Sigma; &Phi; &Psi; &Omega;

Caracteres matemáticos:
∫ ∑ ∏ √ − ± ∞
≈ ∝ ≡ ≠ ≤ ≥
× · ÷ ∂ ′ ″
∇ ‰ ° ∴ ℵ ø
∈ ∉ ∩ ∪ ⊂ ⊃ ⊆ ⊇
¬ ∧ ∨ ∃ ∀ ⇒ ⇔
→ ↔ ↑

&int; &sum; &prod; &radic; &minus; &plusmn; &infin;
&asymp; &prop; &equiv; &ne; &le; &ge; 
&times; &middot; &divide; &part; &prime; &Prime;
&nabla; &permil; &deg; &there4; &alefsym; &oslash;
&isin; &notin; &cap; &cup; &sub; &sup; &sube; &supe;
&not; &and; &or; &exist; &forall; &rArr; &hArr;
&rarr; &harr; &uarr;
x2   ≥   0 true.
  • Para espaçar as coisas, use espaços não-quebraveis - <tt>&nbsp;</tt>.
  • <tt>&nbsp;</tt> também previne quebras de linha no meio do texto. É útil em fórmulas.
<i>x</i><sup>2</sup>&nbsp;&nbsp;&ge;&nbsp;&nbsp;0 true.

Extensões úteis do Firefox

Outras referências

Específicas ao MDC

Externas

{{ languages( { "en": "Project:en/Wiki_Markup_Reference", "de": "Help:de/Wiki_Markup_Referenz", "fr": "Help:fr/R\u00e9f\u00e9rence_des_balises_wiki", "ja": "Help:ja/Wiki_Markup_Reference", "zh-cn": "Project:cn/Wiki_Markup_Reference" } ) }}

Document Tags and Contributors

Last updated by: Leandro Mercês Xavier,