Diferenças

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

--- aracnus:seminario_dokuwiki [2015/02/10 01:04] – [Links] aracnus
+++ aracnus:seminario_dokuwiki [2015/02/10 09: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).  :-)
@@ 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>.
-==== 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\\
@@ 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.
-==== 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.
-==== Listas ====
+===== Listas =====
 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) :-(
-==== Tabelas ====
+===== Tabelas =====
 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 |
-==== 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:
@@ Linha 146: / Linha 162: @@
 </code>
-==== Imagens ====
+===== Imagens =====
 É possível inserir imagens e alinhá-las à esquerda, à direita ou ao centro.
@@ Linha 162: / Linha 178: @@
 {{: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.