Tutorial DokuWiki

Essa é uma revisão anterior do documento!

Com o DokuWiki é possível formatar em negrito, itálico e sublinhado, além de usar caracteres com espaçamento único. É possível, inclusive, combinar tudo isso (mas, convenhamos, fica muito papagaiado).

Além disso é possível também escrever em _subscrito, ^sobrescrito e marcar o texto como ~~tachado~~.

Parágrafos são gerados deixando-se uma linha em branco entre eles. Também é possível forçar
quebras de linhas
a qualquer momento
utilizando-se duas contrabarras (\\). Mas isso só funciona se as contrabarras estiverem no final da linha ou seguidas por espaço(s) em branco. Por isso é possível colocá-las aqui \\, sem que a linha seja quebrada.

É possível incluir notas de rodapé ¹⁾ em qualquer lugar do texto. A nota aparece ao parar o mouse sobre o seu número. Também é possível ir até ela clicando no indicador.

Com o DokuWiki é possível criar listas ordenadas, como essa:

Primeiro item da lista
Segundo item da lista
1. Primeiro subitem do segundo item
  1. Subsubitem
    1. Subsubsubitem
      1. Subsubsubsubitem
        
        Sub…. ah, ok, já deu, nem tem mais marcadores diferentes…
Terceiro item da lista

Também é possível montar listas não ordenadas, assim:

Primeiro item da lista
Segundo item da lista
- Primeiro subitem do segundo item (opa, aqui não tem diferença entre marcadores)

As tabelas podem ter mesclagens de colunas e linhas, além de ser possível definir o seu alinhamento.

Cabeçalho 1	Cabeçalho 2	Cabeçalho 3
Lin. 1 Col. 1	Lin. 1 Col. 2	Lin. 1 Col. 3
Lin. 2 Col. 1	Lin. 2 Cols. 2 e 3 mescladas
Lin. 3 Col. 1	Lin. 3 Col. 2
Lin. 4 Col. 1	Lin. 4, 5 e 6 mescladas Col. 2	Lin. 4 Col. 3
Lin. 5 Col. 1		Lin. 5 Col. 3
Lin. 6 Col. 1		Lin. 6 Col. 3
Esquerda	Centro	Direita

Muito útil para inserir códigos de programação ou citações extensas, os blocos de código podem ser gerados:

Colocando dois espaços em branco no início do texto

Delimitando o texto com as tags "code"

Delimitando o texto com as tags "file"

É importante atentar para o fato de que textos em blocos não possuem quebra automatica de linha.

Por isso, se você escrever um texto muito grande, como esse, ele vai gerar uma barra de rolagem horizontal na tela, e isso pode ser um grande incômodo.

Além disso espaços, como esses ->                     <- são preservados na íntegra.

Usando as tags “code” e “file” é possível fazer a marcação colorida de sintaxe. Pra isso, basta indicar o nome da linguagem em que o código foi escrito, junto com a tag:

#!/usr/local/bin/perl
 
print ("Enter a number:\n");
 
$number1 = <STDIN>;
 
chop ($number1);
 
print ("Enter another number:\n");
 
$number2 = <STDIN>;
 
chop ($number2);
 
if ($number1 == $number2)
   {
     print ("The two numbers are equal.\n");
   }
   elsif ($number1 == $number2 + 1)
   {
     print ("The first number is greater by one.\n");
   }
   elsif ($number1 + 1 == $number2)
   {
     print ("The second number is greater by one.\n");
   }
   else
   {
     print ("The two numbers are not equal.\n");
   }
 
print ("This is the last line of the program.\n");

Ainda mais legal, é possível permitir que as pessoas façam o download do código que está entre as tags “code” ou “file”. Pra isso, basta dar um nome para o código, após a definição da linguagem a ser destacada:

exemplo01.pl

#!/usr/local/bin/perl
 
print ("Enter a number:\n");
 
$number1 = <STDIN>;
 
chop ($number1);
 
print ("Enter another number:\n");
 
$number2 = <STDIN>;
 
chop ($number2);
 
if ($number1 == $number2)
   {
     print ("The two numbers are equal.\n");
   }
   elsif ($number1 == $number2 + 1)
   {
     print ("The first number is greater by one.\n");
   }
   elsif ($number1 + 1 == $number2)
   {
     print ("The second number is greater by one.\n");
   }
   else
   {
     print ("The two numbers are not equal.\n");
   }
 
print ("This is the last line of the program.\n");