MDC:Referência de marcação wiki
De MDC
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.
Tabela de conteúdo |
[editar] Básico
[editar] Seções, Parágrafos e Novas Linhas
| Resultado | Marcação |
| Seções | |
|
Subseção Subsubseção Subsubsubseção 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 |
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. |
[editar] 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 |
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> |
|
Texto grande. |
<big>Texto grande.</big> |
|
|
<strike>Riscado.</strike> |
|
Sublinhado. |
<u>Sublinhado.</u> |
|
SuperScript. |
<sup>Super</sup>Script. |
|
SubScript. |
<sub>Sub</sub>Script. |
[editar] Listas
| Resultado | Marcação |
| Listas Marcadas | |
As marcas das listas, a indentação e outros detalhes podem ser alterados via CSS. |
* Manuais ** Referências ** Guia * Artigos ** Tutoriais *** JavaScript *** HTML *** CSS ** Truques & Dicas * Perguntas Frequentes |
| Listas Numeradas | |
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 |
[editar] 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... |
[[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. |
Em Abril, as [[flor]]es começam a desabrochar. |
|
Adicionar uma assinatura que serve de atalho à sua página de Utilizador... or Dria 13:39, 15 Mar 2005 (EST) |
~~~ or ~~~~ |
| Atalhos Externos | |
|
Atalho URL simples... |
http://www.mozilla.org |
|
Atalho Externo com um texto de atalho diferente... |
[http://www.mozilla.org Projeto Mozilla] |
| Atalhos Interwiki | |
|
TBD |
TBD |
[editar] 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 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. --> |
[editar] Avançado
[editar] 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. | |||||
|
<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>
| ||||
|
{| class="tabela-normal"
|-
|class="header"|cabeçalho 1
|class="header"|cabeçalho 2
|-
|-
|célula 1
|célula 2
|-
|}
| ||||
[editar] Imagens
| Resultado | Marcação |
| Imagens | |
|
Imagem em linha...
|
[[Image:firefox-logo.png]] |
|
Imagem em linha com texto alternativo...
|
[[Image:firefox-logo.png|Firefox - Take back the web.]] |
|
Imagem thumbnail com texto alternativo...
|
[[Image:flower.jpg|thumb|Flower macro shot.]] |
|
Atalho para uma imagem... |
[[media:flower.jpg|Flower macro shot.]] |
[editar] 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.
[editar] 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.
[editar] 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'''
[editar] HTML no Wikitexto
As seguintes etiquetas são de momento aceitas na marcação wiki:
[editar] Caracteres Especiais
| Resultado | Marcação |
|
Umlauts (tremas) e acentos: è é ê ë ì í À Á Â Ã Ä Å |
è é ê ë ì í À Á Â Ã Ä Å Æ Ç È É Ê Ë Ì Í Î Ï Ñ Ò Ó Ô Õ Ö Ø Ù Ú Û Ü ß à á â ã ä å æ ç è é ê ë ì í î ï ñ ò ó ô œ õ ö ø ù ú û ü ÿ |
|
Pontuação: |
¿ ¡ « » § ¶ † ‡ • - – — |
|
Símbolos comerciais: |
™ © ® ¢ € ¥ £ ¤ |
| Caracteres gregos: α β γ δ ε ζ |
α β γ δ ε ζ η θ ι κ λ μ ν ξ ο π ρ σ ς τ υ φ χ ψ ω Γ Δ Θ Λ Ξ Π Σ Φ Ψ Ω |
|
Caracteres matemáticos: |
∫ ∑ ∏ √ − ± ∞ ≈ ∝ ≡ ≠ ≤ ≥ × · ÷ ∂ ′ ″ ∇ ‰ ° ∴ ℵ ø ∈ ∉ ∩ ∪ ⊂ ⊃ ⊆ ⊇ ¬ ∧ ∨ ∃ ∀ ⇒ ⇔ → ↔ ↑ |
x2 ≥ 0 true.
|
<i>x</i><sup>2</sup> ≥ 0 true. |
[editar] Extensões úteis do Firefox
- Extensão Wikipedia para Firefox que fornece uma barra de ferramentas para auxilio de etiquetagem. É muito porreira e parece que funcionar com o Firefox 1.0.3.
- Apoio de editores de texto externos para Firefox e MediaWiki.
[editar] Outras referências
[editar] Específicas ao MDC
- Classes CSS Personalizadas definidas para todas as páginas do MDC.
- Predefinições MediaWiki notáveis criadas para uso no MDC, com explicações.
- Políticas e guias MDC:
- Se não tem a certeza sobre como nomear a sua página, veja Guia para nomeação de páginas.
- MDC:Desambiguação