Diferenças

Aqui você vê as diferenças entre duas revisões dessa página.

Link para esta página de comparações

Ambos lados da revisão anterior Revisão anterior
aracnus:seminario_dokuwiki [2015/02/09 23:04]
aracnus [Links]
aracnus:seminario_dokuwiki [2015/02/10 07:39] (atual)
aracnus
Linha 1: Linha 1:
-====== Tutorial DokuWiki ======+======= Tutorial DokuWiki ​=======
  
-===== Formatação ​===== +===== Caracteres ​=====
- +
-==== Caracteres ​====+
  
 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). ​ :-) 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). ​ :-)
Linha 9: Linha 7:
 Além disso é possível também escrever em <​sub>​subscrito</​sub>,​ <​sup>​sobrescrito</​sup>​ e marcar o texto como <​del>​tachado</​del>​. Além disso é possível também escrever em <​sub>​subscrito</​sub>,​ <​sup>​sobrescrito</​sup>​ e marcar o texto como <​del>​tachado</​del>​.
  
-==== Parágrafos ====+===== Seções ===== 
 + 
 +O //​DokuWiki//​ trabalha com uma lógica de "​seções",​ que são divisões macro na página. Funcionam, na prática, como títulos e subtítulos. O //​DokuWiki//​ utiliza até 5 níveis de seções, sendo o nível 1 o mais alto. E os três primeiros níveis são indexados na própria página, em um menu lateral. Os cabeçalhos das seções possuem uma formatação própria, exemplificados abaixo: 
 + 
 +----- 
 + 
 +======= Cabeçalho de nível 1 ======= 
 + 
 +====== Cabeçalho de nível 2 ====== 
 + 
 +===== Cabeçalho de nível 3 ===== 
 + 
 +=== Cabeçalho de nível 4 === 
 + 
 +== Cabeçalho de nível 5 == 
 + 
 +----- 
 + 
 +===== Parágrafos ​=====
  
 Parágrafos são gerados deixando-se uma linha em branco entre eles. Também é possível forçar\\ Parágrafos são gerados deixando-se uma linha em branco entre eles. Também é possível forçar\\
Linha 16: Linha 32:
 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. 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.
  
-==== Notas de rodapé ====+===== Notas de rodapé ​=====
  
 É possível incluir notas de rodapé ((Como essa aqui)) 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. É possível incluir notas de rodapé ((Como essa aqui)) 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.
  
-==== Listas ====+===== Listas ​=====
  
 Com o DokuWiki é possível criar listas ordenadas, como essa: Com o DokuWiki é possível criar listas ordenadas, como essa:
Linha 39: Linha 55:
     * Primeiro subitem do segundo item (opa, aqui não tem diferença entre marcadores) :-(     * Primeiro subitem do segundo item (opa, aqui não tem diferença entre marcadores) :-(
  
-==== Tabelas ====+===== Tabelas ​=====
  
 As tabelas podem ter mesclagens de colunas e linhas, além de ser possível definir o seu alinhamento. As tabelas podem ter mesclagens de colunas e linhas, além de ser possível definir o seu alinhamento.
Linha 52: Linha 68:
 | Esquerda ​       |      Centro ​    ​| ​        ​Direita | | Esquerda ​       |      Centro ​    ​| ​        ​Direita |
  
-==== Blocos de código ====+===== Blocos de código ​=====
  
 Muito útil para inserir códigos de programação ou citações extensas, os blocos de código podem ser gerados: Muito útil para inserir códigos de programação ou citações extensas, os blocos de código podem ser gerados:
Linha 146: Linha 162:
 </​code>​ </​code>​
  
-==== Imagens ====+===== Imagens ​=====
  
 É possível inserir imagens e alinhá-las à esquerda, à direita ou ao centro. É possível inserir imagens e alinhá-las à esquerda, à direita ou ao centro.
Linha 162: Linha 178:
 {{:​wiki:​dokuwiki-128.png?​100x50}} {{:​wiki:​dokuwiki-128.png?​100x50}}
  
-==== Links ====+===== Links ====
 + 
 +Uma das maiores flexibilidades de qualquer wiki é a possibilidade de se criar rapidamente novas páginas a partir da atual. Pra isso, basta colocar um [[link interno]]. Quando não se especifica nada, ele cria uma página baseada no texto que foi marcado como link. Também é possível [[teste_seminario_dokuwiki|explicitar o nome da página de destino]], o que é o indicado, pois permite um maior controle e organização dos nomes. 
 + 
 +Links externos são reconhecidos "​automatigamente",​ como esse: http://​www.sigass.fiocruz.br/​. Mas eles também podem ficar ocultos atrás de um texto explicativo,​ como [[https://​wiki.lnt.ei.tum.de/​lib/​exe/​fetch.php?​media=dokuwiki_cheatsheet.pdf|esse guia de referência para o DokuWiki]]. 
 + 
 +Muito importante também para a organização é a utilização dos chamados "​espaços de nome" (//​namespaces//​). Eles funcionam como pastas, onde é possível armazenar um conjunto de páginas. A experiência para o usuário final é transparente,​ mas seu uso acrescenta duas funcionalidades. Primeiro, ajuda a organizar os trabalhos, uma vez que as páginas criadas e as imagens adicionadas ficam agrupadas em um único local. E segundo, são uma camada de segurança e privacidade extra, já que é possível definir permissões de acesso e escrita específicas para cada espaço de nome. 
 + 
 +É muito simples criar ou utilizar um espaço de nome, basta defini-lo junto ao nome da página que será criada, [[wiki:​teste|desse jeito]]. Para facilitar o trabalho, uma vez que se entra em qualquer página dentro de um espaço de nome, não é preciso mais defini-lo, pois o //​DokuWiki//​ considera que você vai continuar trabalhando dentro daquele espaço e já cria as páginas lá, automaticamente. 
 + 
 +===== Eliminar formatação ===== 
 + 
 +E caso você não queira que um determinado texto não seja formatado, basta colocar a tag "​nowiki"​ ou usando <​nowiki>​%%</​nowiki>​. 
 + 
 +<​nowiki>​ 
 +Por exemplo, aqui tem um link que não é reconhecido automagicamente:​ http://​pt.wikipedia.org. E as //​formatações//​ __também__ são **ignoradas**. 
 +</​nowiki>​
  
-https://wiki.lnt.ei.tum.de/lib/exe/​fetch.php?​media=dokuwiki_cheatsheet.pdf+O mesmo vale para %%//__esse trecho texto__//%%, mas não pra **esse** que está fora do encapsulamento.
  • aracnus/seminario_dokuwiki.txt
  • Última modificação: 2015/02/10 07:39
  • por aracnus