Backup/Wiki/wiki.txt

====== Sintaxe de Formatação ======

Suportamos a seguinte linguagem de marcação, a qual tenta ser o mais legível possível. Essa página contêm todos os tipos utilizáveis na edição de páginas. Veja a 'fonte' desta página clicando em "Editar essa página". Se você quer tentar algo, use a [[playground:playground|página de testes]]. A sintaxe de marcação também é facilmente acessível pelos [[doku>toolbar|quickbuttons]].

===== Formatação Básica de Texto =====

A Wiki suporta textos em **negrito**, //itálico//, __sublinhado__ e ''mono-espaçado''. Você também pode **__//''combiná-los''//__**.

  A Wiki suporta textos em **negrito**, //itálico//, __sublinhado__ e ''mono-espaçado''.
  Você também pode **__//''combiná-los''//__.

Também pode-se utilizar <sub> subscrito </sub> e <sup> sobrescrito </sup>. 

  Também pode-se utilizar <sub> subscrito </sub> e <sup> sobrescrito </sup>.

Ademais, você pode marcar algo como <del> deletado </del>.

  Ademais, você pode marcar algo como <del> deletado </del>.

**Parágrafos** são criados a partir de linhas em branco. Se você quer **forçar
uma nova linha** sem iniciar um parágrafo, deve usar duas contra-barras seguidas de um espaço em branco ou apenas as barras no final da linha.

  Este é um texto com algumas quebras de linhas\\ Note que os
  dois contra-barras só funcionam no fim da linha\\
  ou quando tem\\ uma espaço em branco \\Isso acontece sem o espaço em branco.

Você só deve forçar novas linhas quando for estritamente necessário.

===== Links =====

A Wiki suporta vários meios de se criar links.

==== Externo ====

Links externos são vinculados automaticamente: https://www.fsf.org ou simplesmente www.fsf.org - Você pode utilizar links como textos: [[https://www.gnu.org|Esse link aponta para o projeto GNU]]. Endereços de email como <john@teste.org> também são aceitos.

  A Wiki suporta vários meios de se criar links. Links externos são vinculados
  automaticamente: https://www.fsf.org ou simplesmente www.fsf.org - Você pode
  utilizar links como textos: [[https://www.gnu.org|Esse link aponta para o projeto GNU]].
  Endereços de email como <john@teste.org> também são aceitos.

==== Interno ====

Links internos são criados usando colchetes. Apenas use o nome da [[página]] ou use um [[página|texto]] para vinculá-los.

  Links internos são criados usando colchetes. Apenas use o nome 
  da [[página]] ou use um [[página|texto]] para vinculá-los.

[[doku>página|Páginas da Wiki]] são convertidas em caixa-baixa automaticamente, caracteres especiais não são aceitos.

Você pode utilizar [[algum:espaço de nomes]] usando dois pontos no nome da página. 

  Você pode utilizar [[alguma:espaço de nomes]] usando dois pontos no nome da página. 

Para mais detalhes sobre espaço de nomes, veja [[doku>espaço de nomes]].

Apontar para uma sessão específica também é possível. Adicione o nome da sessão entre um cerquilha, assim como no HTML. Isso aponta para [[sintaxe#interno|essa Sessão]]. 

  Isso aponta para [[sintaxe#interno| essa Sessão]].

Notas:

  * Links para [[sintaxe|páginas existentes]] são mostrados de forma diferente de uma [[página inexistente]].
  * Quando o título de uma sessão é mudado, a marcação também muda. Não confie muito ao linkar sessões.

==== InterWiki ====

Também suportamos Interwiki links. São links rápidos para outras Wikis. Por exemplo, esse é um link para a página da Wikipedia sobre Linux: [[wp>Linux]].

  Também suportamos Interwiki links. São links rápidos para outras Wikis. 
  Por exemplo, esse é um link para a página da Wikipedia sobre Linux: [[wp>Linux]].

==== Links em Imagens ====

Você pode adicionar uma imagem apontando para algum link interno ou externo combinando a sintaxe de links e [[#imagens_e_outros_arquivos|imagens]] (veja abaixo) assim: 

  [[https://kernel.org|{{wiki:tux.png}}]]

[[https://kernel.org|{{wiki:tux.png}}]]

Toda a sintaxe de [[#imagens_e_outros_arquivos]] e [[#link|link]] é suportada (incluindo redimensionamento de imagem, imagens internas e externas, URLs e links para outras wikis).

===== Notas de rodapé =====

Notas de rodapé são adicionadas usando parênteses duplos. ((Este é um exemplo de nota de rodapé)).

  Notas de rodapé são adicionadas usando parênteses duplos. ((Este é um exemplo de nota de rodapé)).

===== Sessões =====

Pode-se utilizar diferentes níveis de títulos para a estruturação do artigo. Se você tem três ou mais títulos, o índice do artigo é gerado automaticamente. 

==== Título Nível 3 ====

=== Título Nível 2 ===

== Títulos Nível 1 ==

  ==== Título Nível 3 ====
  === Título Nível 2 ===
  == Títulos Nível 1 ==

Utilizando quatro ou mais traços, você pode criar uma linha horizontal:

----

===== Arquivos de Mídia =====

Você pode incluir [[doku>imagens|imagens, vídeos e arquivos de áudio]] externos e internos com colchetes. Opcionalmente você pode especificar o tamanho deles. 

Tamanho real:                           {{wiki:tux.png}}

Redimensionando a largura:              {{wiki:tux.png?50}}

Redimensionando a altura e largura:     ((se a altura x largura especificadas não coincidirem com a da imagem, ela será recortada para a nova proporção antes do redimensionamento)) {wiki:tux.png?200x50}}

Imagem externa resimensionada:          {{http://www.gnu.org/graphics/heckert_gnu.transp.small.png?200x50}}

  Tamanho real:                           {{wiki:tux.png}}

  Redimensionando a largura:              {{wiki:tux.png?50}}

  Redimensionando a altura e largura:     {{wiki:tux.png?200x50}}

  Imagem externa resimensionada:          {{http://www.gnu.org/graphics/heckert_gnu.transp.small.png?200x50}}
   

Usando um espaço a direita ou esquerda, você pode escolher o alinhamento das imagens.

{{ wiki:tux.png}}

{{wiki:tux.png }}

{{ wiki:tux.png }}

  {{ wiki:tux.png}}
  {{wiki:tux.png }}
  {{ wiki:tux.png }}

Obviamente, você também pode adicionar um título (exibida como uma 'dica de ferramenta' pela maioria dos navegadores).

{{ wiki:gnu.png |Exemplo de legenda}}

  {{ wiki:gnu.png |Exemplo de legenda}}

Para linkar uma imagem a outra página, veja [[#Links em Imagens]].

==== Formatos de Mídia Suportados ====

A Wiki consegue exibir diretamente os seguintes formatos:

| Imagem | ''gif'', ''jpg'', ''png''    |
| Vídeo  | ''webm'', ''ogv'', ''mp4''   |
| Áudio  | ''ogg'', ''mp3'', ''wav''    |
| Flash  | ''swf''                      |

Caso você especifique um arquivo que não seja suportado, ele será exibido como um link para o original.

Adicioanndo ''?linkonly'' você provêm um link para o arquivo sem exibi-lo.

  {{wiki:tux.png?linkonly}}

{{wiki:tux.png?linkonly}} Um link para um imagem. 

==== Formatos reservas ====

Infelizmente, nem todos os navegadores conseguem entender todos os formatos de vídeo e áudio. Para contornar esse problema, você pode colocar o seu arquivo em diferentes formatos para uma maior compatibilidade.

Por exemplo, considere este vídeo mp4:

  {{video.mp4| Um vídeo qualquer}}

Quando você subir um ''video.webm'' e um ''video.ogv'' ao lado de ''video.mp4'', a Wiki automaticamente adicioná-los-á como alternativas ao ''video.mp4'', exibindo algum que seja entendido pelo navegador.

Adicionalmente, a Wiki suporta uma imagem como miniatura do vídeo, exibindo-a antes do vídeo ser reproduzido. Essa imagem tem que ter o mesmo nome do vídeo e ser do formato png ou jpg. Para o exemplo anterior, a imagem 'video.jpg' deve funcionar. 

===== Listas =====

Suportamos listas ordenadas e inordenadas. Para criar um item na lista, indente seu texto com dois espaços e use um ''*'' para listar inordenadas e ''-'' para ordenadas. 

  * Essa é uma lista inordenada
  * Segundo item 
    * Você também pode ter subitens
  * Mais um item

  - Outra lista, dessa vez ordenada
  - Outro item
    - Subitens em ordem alfabética
  - Item número 3

<code>
  * Essa é uma lista inordenada
  * Segundo item 
    * Você também pode ter subitens
  * Mais um item

  - Outra lista, dessa vez ordenada
  - Outro item
    - Subitens em ordem alfabética
  - Item número 3
</code>

===== Citações =====

Às vezes você pode desejar marcar certos trechos do texto como uma citação ou comentário. Utilize esta sintaxe: 

<code>
Acho que devemos fazê-lo.

>Não, não devemos.

>> Bem, digo que devemos.

> Sério? 

>> Sim!

>>> Então fá-lo-emos. 
</code>

Acho que devemos fazê-lo.

>Não, não devemos.

>> Bem, digo que devemos.

> Sério? 

>> Sim!

>>> Então fá-lo-emos.

===== Tabelas =====

Suportamos um modo simples de criar tabelas:

^ Título 1      ^ Título 2      ^ Título 3      ^
| linha 1 col 1 | linha 1 col 2 | linha 1 col 3 |
| linha 2 col 1 | linha extra-colunal (dois)   ||
| linha 3 col 1 | linha 3 col 2 | linha 3 col 3 | 

As linhas da tabela devem começar e terminar com um ''|'' para linhas e ''^'' para cabeçalhos. 

  ^ Título 1      ^ Título 2      ^ Título 3      ^
  | linha 1 col 1 | linha 1 col 2 | linha 1 col 3 |
  | linha 2 col 1 | linha extra-colunal (dois)   ||
  | linha 3 col 1 | linha 3 col 2 | linha 3 col 3 | 

Para conectar linhas  horizontalmente, apenas deixe a próxima linha na coluna desejada em branco. Certifique-se de ter sempre a mesma quantidade de separadores!

Também é possível criar cabeçalhos na vertical.

|           ^ Título 1                      ^ Título 2      ^
^ Título 3  | linha 1 col 2                 | linha 1 col 3 |
^ Título 4  | sem dados nessas duas linhas  |               |
^ Título 5  | linha 3 col 2                 | linha 3 col 3 |

Como você pode observar, é a separador de colunas antes da linha que decide o formato:

  |           ^ Título 1                      ^ Título 2      ^
  ^ Título 3  | linha 1 col 2                 | linha 1 col 3 |
  ^ Título 4  | sem dados nessas duas linhas  |               |
  ^ Título 5  | linha 3 col 2                 | linha 3 col 3 |

Você também pode criar linhas conectadas verticalmente adicionando ''%%:::%%'' nas linhas que devem ser preenchidas.

^ Título 1          ^ Título 2                      ^ Título 3          ^
| linha 1 col 1     | estender-se-á verticalmente   | linha 1 col 3     |
| linha 2 col 1     | :::                           | linha 2 col 3     |
| linha 3 col 1     | :::                           | linha 3 col 3     |

Considerando a sintaxe para linhas conectadas verticalmente associadas, esse exemplo mostra uma verticalmente estendida por duas linhas vazias.

  ^ Título 1          ^ Título 2                      ^ Título 3          ^
  | linha 1 col 1     | estender-se-á verticalmente   | linha 1 col 3     |
  | linha 2 col 1     | :::                           | linha 2 col 3     |
  | linha 3 col 1     | :::                           | linha 3 col 3     |

Para criar uma tabela com alinhamentos, adicione dois espaços no lado oposto do termino do seu texto: dois a esquerda para alinhar a direita, dois a direita para alinhar a esquerda e dois nos dois lados para alinhar ao centro.

^           Tabela com alinhamentos           ^^^
|        direita|    centro     |esquerda       |
|esquerda       |        direita|     centro    |
| xxxxxxxxxxxxx | xxxxxxxxxxxxx | xxxxxxxxxxxxx | 

Parecer-se-á assim na fonte:

  ^           Tabela com alinhamentos           ^^^
  |        direita|    centro     |esquerda       |
  |esquerda       |        direita|     centro    |
  | xxxxxxxxxxxxx | xxxxxxxxxxxxx | xxxxxxxxxxxxx | 

Nota: alinhamento na vertical não é suportado.

===== Sem Formatação =====

Se você precisar inserir um texto e não desejar que ele seja 'interpretado' pelo nosso esquema de sintaxe, utilize a seguinte notação:

<nowiki>
Esse texto não será __formatado__ de forma //alguma//, mesmo que eu utilize vários parâmetros da [[http://gnulinux.gq/wiki|wiki]].
</nowiki>

Outro **texto**, mas agora **__//formatado//__**.

  <nowiki>
  Esse texto não será __formatado__ de forma //alguma//, mesmo que utilize-se de vários parâmetros da [[http://gnulinux.gq/wiki|wiki]].
  </nowiki>

  Outro **texto**, mas agora **__//formatado//__**.

===== Blocos de Código =====

Você pode incluí-los no artigo deixando dois espaços entre a margem esquerda e o texto (como nos exemplos dados neste artigo> ou então utilizando as tags ''%%<code>%%'' ou ''%%<file>%%''.

  Esse é um exemplo utilizando dois espaços como recuo e sinalização. 

<code>
Outro exemplo, só que neste todos os espaços são preservados: mais ou menos              <- assim.
</code>

<file>
Mais ou menos igual, mas neste você pode mostrar como se estivesse quotando um arquivo.
</file>

Esses exemplos foram criados assim:

    Esse é um exemplo utilizando dois espaços como recuo e sinalização. 

  <code>
  Outro exemplo, só que neste todos os espaços são preservados: mais ou menos              <- assim.
  </code>

  <file>
  Mais ou menos igual, mas neste você pode mostrar como se estivesse quotando um arquivo.
  </file>

==== Realce de sintaxe ====

Nossa Wiki pode realçar os códigos fontes nela inseridos, isso torna-os mais legíveis. Utiliza o mesmo sistema das tags ''<nowiki> <code> </nowiki>'' e ''<nowiki> <file> </nowiki>''. O nome da linguagem a ser sinalizada deve vir logo após a 'abertura' da tag: ''<nowiki> <code bash> </nowiki>'' ou ''<nowiki> <file php> </nowiki>''.

<code c>
/* Exemplo de código em C para demonstrar o realce de sintaxe */

#include <stdio.h>

int
main(void)
{
    fprintf(stdout,"Realce de sintaxe é demais!\n");
    return 0;
}
</code>

As seguintes linguagens podem utilizar-se deste recurso: //4cs, 6502acme, 6502kickass, 6502tasm, 68000devpac, abap, actionscript-french, actionscript, actionscript3, ada, algol68, apache, applescript, asm, asp, autoconf, autohotkey, autoit, avisynth, awk, bascomavr, bash, basic4gl, bf, bibtex, blitzbasic, bnf, boo, c, c_loadrunner, c_mac, caddcl, cadlisp, cfdg, cfm, chaiscript, cil, clojure, cmake, cobol, coffeescript, cpp, cpp-qt, csharp, css, cuesheet, d, dcs, delphi, diff, div, dos, dot, e, epc, ecmascript, eiffel, email, erlang, euphoria, f1, falcon, fo, fortran, freebasic, fsharp, gambas, genero, genie, gdb, glsl, gml, gnuplot, go, groovy, gettext, gwbasic, haskell, hicest, hq9plus, html, html5, icon, idl, ini, inno, intercal, io, j, java5, java, javascript, jquery, kixtart, klonec, klonecpp, latex, lb, lisp, llvm, locobasic, logtalk, lolcode, lotusformulas, lotusscript, lscript, lsl2, lua, m68k, magiksf, make, mapbasic, matlab, mirc, modula2, modula3, mmix, mpasm, mxml, mysql, newlisp, nsis, oberon2, objc, objeck, ocaml-brief, ocaml, oobas, oracle8, oracle11, oxygene, oz, pascal, pcre, perl, perl6, per, pf, php-brief, php, pike, pic16, pixelbender, pli, plsql, postgresql, povray, powerbuilder, powershell, proftpd, progress, prolog, properties, providex, purebasic, pycon, python, q, qbasic, rails, rebol, reg, robots, rpmspec, rsplus, ruby, sas, scala, scheme, scilab, sdlbasic, smalltalk, smarty, sql, systemverilog, tcl, teraterm, text, thinbasic, tsql, typoscript, unicon, uscript, vala, vbnet, vb, verilog, vhdl, vim, visualfoxpro, visualprolog, whitespace, winbatch, whois, xbasic, xml, xorg_conf, xpp, yaml, z80, zxbasic//

<note> Utilize esse ótimo recurso sempre que possível! </note>

====== Incorporando HTML e PHP =====

Você pode adicionar código em HTML e PHP no seu artigo utilizando as tags ''%%<html>%%'' ou ''%%<php>%%''. (Utilize ''%%<HTML>%%'' e ''%%PHP%%'' para fechar blocos internos de código.)

Exemplo de HTML:

<code>
<html>
Exemplo de <span style="color:red;font-size:150%;">texto em HTML</span>
</html>
<HTML>
<p style="border:2px dashed red;">E este é um bloco em HTML</p>
</HTML>
</code>

<html>
Exemplo de <span style="color:red;font-size:150%;">texto em HTML</span>
</html>
<HTML>
<p style="border:2px dashed red;">E este é um bloco em HTML</p>
</HTML>

Exemplo de PHP:

<code>
<php>
echo 'versão do PHP: ';
echo phpversion();
echo ' (gerado em uma linha HTML)';
</php>
<PHP>
echo '<table class="inline"><tr><td>Idem, mas dentro de um sub bloco.:</td>';
echo '<td>'.phpversion().'</td>';
echo '</tr></table>';
</PHP>
</code>

===== Agregamento de Feed RSS/ATOM =====

Pode-se agregar Feeds em XML na wiki. Para 'traduzir' (parsing) o Feed em XML, o [[http://simplepie.org|SimplePie]] é usado. Todos os formatos entendidos por ele são aceitos na Wiki. Você pode customizar a renderização utilizado estes parâmetros: 

^ Parâmetro         ^ Descrição ^
| qualquer número   | será utilizado para especificar o número de itens a serem exibidos. 8 é o padrão |
| reverso           | mostrará o feed na ordem inversa (os últimos serão os primeiros) |
| autor             | mostra o autor dos itens do feed |
| date              | exibe a data dos itens |
| nosort            | não ordena os itens do feed |
| //n/[dhn]         | período de atualização, onde d=dias, h=horas, m=minutos |

O período padrão de atualização é 4 horas. Qualquer valor abaixo de 10 minutos será tratado como 10 minutos.

Por padrão, os feeds serão organizados pela data, os mais novos primeiro. Você pode organizá-los a partir dos mais antigos utilizando o parâmetro ''reverse'', ou deixá-lo como ''nosort''.

**Exemplo**

  {{rss>http://slashdot.org/index.rss 5 author date 1h }}

{{rss>http://slashdot.org/index.rss 5 author date 1h }}


===== Macros de Controle ===== 

Algumas sintaxes na página também influenciam no modo como a Wiki renderiza a página, no entanto, elas não produzem nenhuma saída explícita. Os seguintes macros estão disponíveis:

^ Macro             ^ Descrição |
| %%~~NOTOC~~%%     | Se este macro estiver na página, nenhuma tabela será criada |
| %%~~NOCACHE~~%%   | A Wiki guardará em cache toda a saída por padrão. Às vezes esse comportamento não é esperado (por exemplo, quanto a sintaxe %%<php>%% abaixo é utilizada), adicionar esse macro forçará  a Wiki a renderizar a página a cada chamada |

Tradução e adaptação não oficial para o português do [[https://www.dokuwiki.org/wiki:syntax|artigo original da DokuWiki]].