{{:pdf\manual.pdf|Manual do Sistema}}
===== Listas =====
O Dokuwiki suportas listas ordenadas (numeradas) e não-ordenadas. Para criar um item de listas, endente seu texto com dois espaços e use um ''*''(asterísco) para listas não-ordenadas e um ''-''(traço) para listas ordenadas.
* Esta é uma lista
* O segundo item
* você pode ter diferentes níveis
* Outro item
- A mesma lista porém ordenada
- Outro Item
- Simplesmente use endentação para criar níveis
- Último item
* Esta é uma lista
* O segundo item
* você pode ter diferentes níveis
* Outro item
- A mesma lista porém ordenada
- Outro Item
- Simplesmente use endentação para criar níveis
- Último item
Veja também o [[doku>faq:lists|FAQ de listas de itens]].
===== Conversões de Texto =====
O [[doku>DokuWiki]] pode converter certos caracteres ou textos predefinidos em imagens ou em outro texto ou em HTML.
A conversão de texto para imagem é feito principalmente para smileys(carinhas). E a conversão de texto para HTML é usado para substituição de tipografia, mas também pode ser configurada para usar outro HTML.
==== Conversão de Texto para Imagem ====
O DokuWiki produz os [[wp>emoticon]]s mais usados, convertendo em imagens os caracteres digitados no texto. Estes [[doku>Smileys]] e outras imagens podem ser configurados e estendidos. Aqui está uma visão geral do que já está incluído:
* 8-) %% 8-) %%
* 8-O %% 8-O %%
* :-( %% :-( %%
* :-) %% :-) %%
* =) %% =) %%
* :-/ %% :-/ %%
* :-\ %% :-\ %%
* :-? %% :-? %%
* :-D %% :-D %%
* :-P %% :-P %%
* :-O %% :-O %%
* :-X %% :-X %%
* :-| %% :-| %%
* ;-) %% ;-) %%
* ^_^ %% ^_^ %%
* :?: %% :?: %%
* :!: %% :!: %%
* LOL %% LOL %%
* FIXME %% FIXME %%
* DELETEME %% DELETEME %%
===== Conversão de Texto para HTML =====
O [[wiki:Dokuwiki]] pode converter caracteres de texto simples em suas entidades tipograficamente corretas. Aqui está um exemplo de caracteres reconhecidos.
-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
"Ele disse: 'Aquilo é um frango-d'água'..."
-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
"Ele disse: 'Aquilo é um frango-d'água'..."
===== Citações =====
Se precisar mostrar textos como diálogos igual ao abaixo, a sintaxe é a seguinte:
Eu pensei que nos deveríamos fazer isto
> Não, não deveríamos
>> Bem, eu disse que nós deveríamos
> Realmente?
>> Sim!
>>> Então vamos fazer isto!
Eu pensei que nos deveríamos fazer isto
> Não, não deveríamos
>> Bem, eu disse que nós deveríamos
> Realmente?
>> Sim!
>>> Então vamos fazer isto!
===== Tabelas =====
O Dokuwiki disponibiliza uma sintaxe simples para criação de tabelas.
^ Cabeçalho 1 ^ Cabeçalho 2 ^ Cabeçalho 3 ^
| Linha 1 Coluna 1 | Linha 1 Coluna 2 | Linha 1 Coluna 3 |
| Linha 2 Coluna 1 | Linha mesclada (repare o pipeline duplo) ||
| Linha 3 Coluna 1 | Linha 3 Coluna 2 | Linha 3 Coluna 3 |
Linhas de tabelas devem iniciar e terminar com um ''^''(circunflexo) para cabeçalhos e com um ''|''(pipeline) para linhas de dados.
^ Cabeçalho 1 ^ Cabeçalho 2 ^ Cabeçalho 3 ^
| Linha 1 Coluna 1 | Linha 1 Coluna 2 | Linha 1 Coluna 3 |
| Linha 2 Coluna 1 | Linha mesclada (repare o pipeline duplo) ||
| Linha 3 Coluna 1 | Linha 3 Coluna 2 | Linha 3 Coluna 3 |
Para conectar células horizontalmente, apenas faça a próxima célula vazia como exibido abaixo. Certifique-se de que existe a mesma quantidade de separadores de células em todas as linhas!
Cabeçalhos verticais também são possíveis.
| ^ Cabeçalho 1 ^ Cabeçalho 2 ^
^ Cabeçalho 3 | Linha 1 Coluna 3 | Linha 1 Coluna 3 |
^ Cabeçalho 4 | Sem mesclar dessa vez | |
^ Cabeçalho 5 | Linha 2 Coluna 3 | Linha 2 Coluna 3 |
Como você pode ver, é o separador de células anterior à célula que decide sobre a formatação:
| ^ Cabeçalho 1 ^ Cabeçalho 2 ^
^ Cabeçalho 3 | Linha 1 Coluna 3 | Linha 1 Coluna 3 |
^ Cabeçalho 4 | Sem mesclar dessa vez | |
^ Cabeçalho 5 | Linha 2 Coluna 3 | Linha 2 Coluna 3 |
Você pode conectar células verticalmente adicionando '':::'' dentro das células abaixo da qual elas devem conectar.
^ Cabeçalho 1 ^ Cabeçalho 2 ^ Cabeçalho 3 ^
| Linha 1 Coluna 1 | esta célula expande verticalmente | Linha 1 Coluna 3 |
| Linha 2 Coluna 1 | ::: | Linha 2 Coluna 3 |
| Linha 3 Coluna 1 | ::: | Linha 2 Coluna 3 |
Estas células não deverão conter nada além da sintaxe de conexão vertical.
^ Cabeçalho 1 ^ Cabeçalho 2 ^ Cabeçalho 3 ^
| Linha 1 Coluna 1 | esta célula expande verticalmente | Linha 1 Coluna 3 |
| Linha 2 Coluna 1 | ::: | Linha 2 Coluna 3 |
| Linha 3 Coluna 1 | ::: | Linha 2 Coluna 3 |
Você também pode alinhar o conteúdo da tabela, adicionando dois espaços no lado oposto ao do alinhamento:
* Para alinhar à direita adicione dois espaços no lado esquerdo.
* Para alinhar à esquerda adicione dois espaços no lado direito.
* Para centralizar adicione dois espaços nos dois lados.
^ Tabela com alinhamento ^^^
| direita| centro |esquerda |
|esquerda | direita| centro |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
Assim que aparede no código-fonte:
^ Tabela com alinhamento ^^^
| direita| centro |esquerda |
|esquerda | direita| centro |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
Nota: Alinhamento vertical não é suportado.
===== Blocos não-interpretados =====
Se você precisar exibir um texto sem formatação exatamente como digitado, delimite o texto com a tag ''%%
Este é um código pré-formatado, todos os espaços são preservados: como <- este
Este é um código pré-formatado, todos os espaços são preservados: como <-este
/**
* The HelloWorldApp class implements an application that
* simply displays "Hello World!" to the standard output.
*/
class HelloWorldApp {
public static void main(String[] args) {
System.out.println("Hello World!"); //Display the string.
}
}
As seguintes linguagens são reconhecidas: //abap, actionscript-french, actionscript, actionscript3, ada, apache, applescript, asm, asp, autoit, avisynth, bash, basic4gl, bf, bibtex, blitzbasic, bnf, boo, c, c_mac, caddcl, cadlisp, cfdg, cfm, cil, cmake, cobol, cpp, cpp-qt, csharp, css, d, dcs, delphi, diff, div, dos, dot, eiffel, email, erlang, fo, fortran, freebasic, genero, glsl, gml, gnuplot, groovy, gettext, haskell, hq9plus, html, idl, ini, inno, intercal, io, java5, java, javascript, kixtart, klonec, klonecpp, latex, lisp, locobasic, lolcode, lotusformulas, lotusscript, lscript, lsl2, lua, m68k, make, matlab, mirc, modula3, mpasm, mxml, mysql, nsis, oberon2, objc, ocaml-brief, ocaml, oobas, oracle8, oracle11, pascal, perl, per, php-brief, php, pic16, pixelbender, plsql, povray, powershell, progress, prolog, properties, providex, python, qbasic, rails, rebol, reg, robots, ruby, sas, scala, scheme, scilab, sdlbasic, smalltalk, smarty, sql, tcl, teraterm, text, thinbasic, tsql, typoscript, vbnet, vb, verilog, vhdl, vim, visualfoxpro, visualprolog, whitespace, winbatch, whois, xml, xorg_conf, xpp, z80//
==== Blocos de Código Baixáveis ====
Quando você usa as sintaxes ''%%%%'' ou ''%%%%'' descritas acima, poderá desejar que o código-fonte exibido seja disponibilizado para download. Para isso deve especificar o nome do arquivo após o nome da linguagem de programação desta forma:
Se você não quiser nenhum destaque no código-fonte mas quiser que o arquivo seja baixável, troque o nome da linguagem de programação por um traço (''-'') assim: ''%%%%'' ou ''%%%%''.
===== HTML e PHP embutido =====
Você pode embutir HTML e PHP puros dentro de seus documentos usando as tags ''%%%%'' ou ''%%%%''. (Use tags maiúsculas se você precisar incluir níveis de blocos de elementos.)
Exemplo em HTML:
Este é um HTML em linha
E este é um bloco HMTL
Este é um HTML em linha
E este é um bloco HMTL
Exemplo em PHP:
echo 'Uma logo gerada pelp PHP:';
echo ' . ')
';
echo '(HTML gerado em linha)';
echo 'O mesmo, mas dentro de um elemento de bloco de nível: ';
echo '
';
echo 'Uma logo gerada pelp PHP:';
echo '';
echo '(HTML gerado em linha)';
echo 'O mesmo, mas dentro de um elemento de bloco de nível: ';
echo '
';
**Nota:** HTML e PHP embutidos ficam desabilitados por padrão na configuração. Quando desabilitados, o código é exibido ao invés de executado. Se quiser habilitá-los, vá em Administrar -> Configurações do DokuWiki -> Configurações de edição e marque Permitir incorporação de HTML (htmlok) e Permitir incorporação de PHP (phpok).
===== RSS/ATOM Feed Aggregation =====
O Dokuwiki pode integrar com dados externos de XML feeds. O [[http://simplepie.org/|SimplePie]] é usado para interpretar os XML feeds. Todos os formatos suportados pelo SimplePie podem ser usados no Dokuwiki. Você pode influenciar na interpretação através de múltiplos parâmetros adicionais separados por espaço:
^ Parâmetro ^ Descrição ^
| número itens | será usado como máximo de itens a serem exibidos, o padrão é 8 |
| reverse | exibe os últimos itens no início na lista |
| author | exibe os nome dos autores dos itens |
| date | exibe as datas dos itens |
| description | exibe a descrição do item. Se [[doku>wiki:config#htmlok|HTML]] estiver desabilitado todas as tags serão removidas |
| //n//[dhm] | período de atualização, onde d=dias, h=horas, m=minutos. (ex. 12h = 12 horas). |
O período de atualização por padrão é 4 horas. Qualquer valor abaixo de 10 minutos será tratado como 10 minutos. O Dokuwiki geralmente vai tentar fornecer uma versão do //cache// da página, claro que isto é inapropriado quando a página contém conteúdo externo dinâmico. Os parâmetros falam pro Dokuwiki recarregar a página se tiver um perído maior que o //período de atualização// desde a última carga.
**Exemplo:**
{{rss>http://slashdot.org/index.rss 5 author date 1h }}
{{rss>http://slashdot.org/index.rss 5 author date 1h }}
===== Comandos de Controle =====
Alguns comandos influenciam em como o DokuWiki monta a página sem criar nenhuma informação visível para o leitor. Os seguintes comandos de controle estão disponíveis:
^ Comando ^ Descrição |
| %%~~NOTOC~~%% | Se este controle for encontrado na página, a Tabela de Conteúdos não será criada |
| %%~~NOCACHE~~%% | O DokuWiki faz //cache// de todas as páginas por padrão. Em alguns casos isto pode não ser desejável. Adicionar este controle forçará o DokuWiki a interpretar a página em cada chamada. |