wiki:syntax
Diferenças
Aqui você vê as diferenças entre duas revisões dessa página.
| Ambos lados da revisão anteriorRevisão anteriorPróxima revisão | Revisão anterior | ||
| wiki:syntax [2026/08/12 17:19] – brsavi | wiki:syntax [2026/10/11 20:07] (atual) – removida - edição externa (Data desconhecida) 127.0.0.1 | ||
|---|---|---|---|
| Linha 1: | Linha 1: | ||
| - | ====== Sintaxe de Formatação ====== | ||
| - | O [[doku> | ||
| - | |||
| - | ===== Formatação Básica de Texto ===== | ||
| - | |||
| - | O DokuWiki suporta textos em **negrito**, | ||
| - | |||
| - | O DokuWiki suporta textos em **negrito**, | ||
| - | Naturalmente, | ||
| - | |||
| - | Observe que os marcadores de formatação devem envolver o texto diretamente; | ||
| - | |||
| - | Você também pode usar < | ||
| - | |||
| - | Você também pode usar < | ||
| - | |||
| - | Você também pode marcar algo como < | ||
| - | |||
| - | Você também pode marcar algo como < | ||
| - | |||
| - | **Parágrafos** são criados a partir de linhas em branco. Se quiser **forçar uma quebra de linha** sem iniciar um novo parágrafo, pode usar duas barras invertidas seguidas de um espaço ou do fim da linha. | ||
| - | |||
| - | Este é um texto com algumas quebras de linha\\ Observe que as | ||
| - | duas barras invertidas só são reconhecidas no final de uma linha\\ | ||
| - | ou seguidas por\\ um espaço \\isto acontece sem ele. | ||
| - | |||
| - | Este é um texto com algumas quebras de linha\\ Observe que as | ||
| - | duas barras invertidas só são reconhecidas no final de uma linha\\ | ||
| - | ou seguidas por\\ um espaço \\isto acontece sem ele. | ||
| - | |||
| - | Você deve usar quebras de linha forçadas apenas quando realmente necessário. | ||
| - | |||
| - | ===== Links ===== | ||
| - | |||
| - | O DokuWiki suporta várias formas de criar links. | ||
| - | |||
| - | ==== Externos ==== | ||
| - | |||
| - | Links externos são reconhecidos automaticamente: | ||
| - | |||
| - | O DokuWiki suporta várias formas de criar links. Links externos são reconhecidos | ||
| - | automaticamente: | ||
| - | o texto do link: [[http:// | ||
| - | de e-mail como este: < | ||
| - | |||
| - | ==== Internos ==== | ||
| - | |||
| - | Links internos são criados usando colchetes. Você pode simplesmente indicar um [[nome da página]] ou usar a forma [[nome da página|texto do link]]. | ||
| - | |||
| - | Links internos são criados usando colchetes. Você pode simplesmente indicar | ||
| - | um [[nome da página]] ou usar a forma [[nome da página|texto do link]]. | ||
| - | |||
| - | [[doku> | ||
| - | |||
| - | Você pode usar [[alguns: | ||
| - | |||
| - | Você pode usar [[alguns: | ||
| - | |||
| - | Para detalhes sobre namespaces, consulte [[doku> | ||
| - | |||
| - | Também é possível criar links para uma seção específica. Basta adicionar o nome da seção após um caractere de cerquilha (#), como é feito em HTML. Este link aponta para [[syntax# | ||
| - | |||
| - | Este link aponta para [[syntax# | ||
| - | |||
| - | Notas: | ||
| - | |||
| - | * Links para [[syntax|páginas existentes]] são exibidos com um estilo diferente daqueles para [[páginas inexistentes]]. | ||
| - | * Por padrão, o DokuWiki não usa [[wp> | ||
| - | * Quando o título de uma seção é alterado, sua âncora (bookmark) também muda. Portanto, evite depender excessivamente de links para seções. | ||
| - | |||
| - | ==== Interwiki ==== | ||
| - | |||
| - | O DokuWiki suporta links [[doku> | ||
| - | |||
| - | O DokuWiki suporta links [[doku> | ||
| - | Por exemplo, este é um link para a página da Wikipédia sobre wikis: [[wp> | ||
| - | |||
| - | ==== Compartilhamentos do Windows ==== | ||
| - | |||
| - | Compartilhamentos do Windows como [[\\server\share|este]] também são reconhecidos. Observe que eles só fazem sentido em um grupo de usuários homogêneo, como uma [[wp> | ||
| - | |||
| - | Compartilhamentos do Windows como [[\\server\share|este]] também são reconhecidos. | ||
| - | |||
| - | Notas: | ||
| - | |||
| - | * Por motivos de segurança, a navegação direta em compartilhamentos do Windows funciona por padrão apenas no Microsoft Internet Explorer (e somente na "zona local" | ||
| - | * No Mozilla e no Firefox, isso pode ser habilitado através de soluções alternativas mencionadas na [[http:// | ||
| - | <code - conf/ | ||
| - | <?php | ||
| - | /** | ||
| - | * Personalização do arquivo de idioma inglês | ||
| - | * Copie apenas as strings necessárias | ||
| - | a ser modificado | ||
| - | */ | ||
| - | $lang[' | ||
| - | </ | ||
| - | |||
| - | ==== Links de Imagem ==== | ||
| - | |||
| - | Você também pode usar uma imagem para criar um link para outra página interna ou externa, combinando a sintaxe de links e de [[# | ||
| - | |||
| - | [[http:// | ||
| - | |||
| - | [[http:// | ||
| - | |||
| - | Observe: a formatação de imagem é a única sintaxe de formatação aceita nos nomes dos links. | ||
| - | |||
| - | Toda a sintaxe de [[# | ||
| - | |||
| - | ===== Notas de Rodapé ===== | ||
| - | |||
| - | Você pode adicionar notas de rodapé ((Esta é uma nota de rodapé)) usando parênteses duplos. | ||
| - | |||
| - | Você pode adicionar notas de rodapé ((Esta é uma nota de rodapé)) usando parênteses duplos. | ||
| - | |||
| - | ===== Divisão em Seções ===== | ||
| - | |||
| - | Você pode usar até cinco níveis diferentes de títulos para estruturar seu conteúdo. Se houver mais de três títulos, um sumário é gerado automaticamente — isso pode ser desativado incluindo a string ''< | ||
| - | |||
| - | ==== Título de Nível 3 ==== | ||
| - | === Título de Nível 4 === | ||
| - | == Título de Nível 5 == | ||
| - | |||
| - | ==== Título de Nível 3 ==== | ||
| - | === Título de Nível 4 === | ||
| - | == Título de Nível 5 == | ||
| - | |||
| - | Usando quatro ou mais traços, você pode criar uma linha horizontal: | ||
| - | |||
| - | ---- | ||
| - | |||
| - | ===== Arquivos de Mídia ===== | ||
| - | |||
| - | Você pode incluir [[doku> | ||
| - | |||
| - | Tamanho real: {{wiki: | ||
| - | |||
| - | Redimensionar para a largura especificada: | ||
| - | |||
| - | Redimensionar para a largura e altura especificadas((quando a proporção da largura e altura especificadas não corresponder à da imagem, ela será cortada para a nova proporção antes do redimensionamento)): | ||
| - | |||
| - | Imagem externa redimensionada: | ||
| - | |||
| - | Tamanho real: {{wiki: | ||
| - | Redimensionar para a largura especificada: | ||
| - | Redimensionar para a largura e altura especificadas: | ||
| - | Imagem externa redimensionada: | ||
| - | |||
| - | |||
| - | Você pode definir o alinhamento usando espaços em branco à esquerda ou à direita. | ||
| - | |||
| - | {{ wiki: | ||
| - | |||
| - | {{wiki: | ||
| - | |||
| - | {{ wiki: | ||
| - | |||
| - | {{ wiki: | ||
| - | {{wiki: | ||
| - | {{ wiki: | ||
| - | |||
| - | Você também pode definir o alinhamento explicitamente com um parâmetro ''? | ||
| - | |||
| - | {{wiki: | ||
| - | |||
| - | {{wiki: | ||
| - | |||
| - | É claro que você também pode adicionar um título (exibido como uma dica de ferramenta pela maioria dos navegadores). {{ wiki: | ||
| - | |||
| - | {{ wiki: | ||
| - | |||
| - | Para vincular uma imagem a outra página, consulte [[#Links de Imagem]] acima. | ||
| - | |||
| - | ==== Formatos de Mídia Suportados ==== | ||
| - | |||
| - | O DokuWiki pode incorporar diretamente os seguintes formatos de mídia. | ||
| - | |||
| - | | Imagem | '' | ||
| - | | Vídeo | ||
| - | | Áudio | ||
| - | | Flash | '' | ||
| - | |||
| - | Se você especificar um nome de arquivo que não corresponda a um formato de mídia suportado, ele será exibido como um link. | ||
| - | |||
| - | Ao adicionar ''? | ||
| - | |||
| - | {{wiki: | ||
| - | |||
| - | {{wiki: | ||
| - | |||
| - | ==== Formatos Alternativos (Fallback) ==== | ||
| - | |||
| - | Infelizmente, | ||
| - | |||
| - | Por exemplo, considere este vídeo mp4 incorporado: | ||
| - | |||
| - | {{video.mp4|Um vídeo engraçado}} | ||
| - | |||
| - | Ao enviar os arquivos '' | ||
| - | |||
| - | Além disso, o DokuWiki suporta uma imagem de capa (" | ||
| - | |||
| - | ===== Listas ===== | ||
| - | |||
| - | O DokuWiki suporta listas ordenadas e não ordenadas. Para criar um item de lista, recue o texto em dois espaços e use um '' | ||
| - | |||
| - | * Esta é uma lista | ||
| - | * O segundo item | ||
| - | * Você pode ter diferentes níveis | ||
| - | * Outro item | ||
| - | |||
| - | - A mesma lista, mas ordenada | ||
| - | - Outro item | ||
| - | - Basta usar recuo para níveis mais profundos | ||
| - | - É só isso | ||
| - | |||
| - | < | ||
| - | * Esta é uma lista | ||
| - | * O segundo item | ||
| - | * Você pode ter diferentes níveis | ||
| - | * Outro item | ||
| - | |||
| - | - A mesma lista, mas ordenada | ||
| - | - Outro item | ||
| - | - Basta usar recuo para níveis mais profundos | ||
| - | - É só isso | ||
| - | </ | ||
| - | |||
| - | Veja também o [[doku> | ||
| - | |||
| - | ===== Conversões de Texto ===== | ||
| - | |||
| - | O DokuWiki pode converter certos caracteres ou sequências predefinidos em imagens, ou em outros textos ou HTML. | ||
| - | |||
| - | A conversão de texto para imagem é realizada principalmente para *smileys*. Já a conversão de texto para HTML é utilizada para substituições tipográficas, | ||
| - | |||
| - | ==== Conversões de Texto para Imagem ==== | ||
| - | |||
| - | O DokuWiki converte [[wp> | ||
| - | |||
| - | * 8-) %% 8-) %% | ||
| - | * 8-O %% 8-O %% | ||
| - | * :-( %% :-( %% | ||
| - | * :-) %% :-) %% | ||
| - | * =) %% =) %% | ||
| - | * :-/ %% :-/ %% | ||
| - | * :-\ %% :-\ %% | ||
| - | * :-? %% :-? %% | ||
| - | * :-D %% :-D %% | ||
| - | * :-P %% :-P %% | ||
| - | * :-O %% :-O %% | ||
| - | * :-X %% :-X %% | ||
| - | * :-| %% :-| %% | ||
| - | * ;-) %% ;-) %% | ||
| - | * ^_^ %% ^_^ %% | ||
| - | * m( %% m( %% | ||
| - | * :?: %% :?: %% | ||
| - | * :!: %% :!: %% | ||
| - | * LOL %% LOL %% | ||
| - | * FIXME %% FIXME %% | ||
| - | * DELETEME %% DELETEME %% | ||
| - | |||
| - | ==== Conversões de Texto para HTML ==== | ||
| - | |||
| - | Tipografia: O [[DokuWiki]] pode converter caracteres de texto simples em suas entidades tipograficamente corretas. Aqui está um exemplo de caracteres reconhecidos. | ||
| - | |||
| - | -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) | ||
| - | "Ele pensou 'É um mundo dos homens' | ||
| - | |||
| - | < | ||
| - | -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) | ||
| - | "Ele pensou 'É um mundo dos homens' | ||
| - | </ | ||
| - | |||
| - | O mesmo pode ser feito para produzir qualquer tipo de HTML; basta adicionar o padrão ao [[doku> | ||
| - | |||
| - | Existem três exceções que não vêm desse arquivo de padrões: a entidade de multiplicação (640x480), as aspas ' | ||
| - | |||
| - | ===== Citações ===== | ||
| - | |||
| - | Às vezes, você quer marcar um texto para indicar que se trata de uma resposta ou comentário. Você pode usar a seguinte sintaxe: | ||
| - | |||
| - | < | ||
| - | Acho que deveríamos fazer isso | ||
| - | |||
| - | > Não, não deveríamos | ||
| - | |||
| - | >> Bem, eu digo que deveríamos | ||
| - | |||
| - | > Sério? | ||
| - | |||
| - | >> Sim! | ||
| - | |||
| - | >>> | ||
| - | </ | ||
| - | |||
| - | Acho que deveríamos fazer isso | ||
| - | |||
| - | > Não, não deveríamos | ||
| - | |||
| - | >> Bem, eu digo que deveríamos | ||
| - | |||
| - | > Sério? | ||
| - | |||
| - | >> Sim! | ||
| - | |||
| - | >>> | ||
| - | |||
| - | ===== Tabelas ===== | ||
| - | |||
| - | O DokuWiki suporta uma sintaxe simples para criar tabelas. | ||
| - | |||
| - | ^ Cabeçalho 1 ^ Cabeçalho 2 ^ Cabeçalho 3 ^ | ||
| - | | Linha 1 Col 1 | Linha 1 Col 2 | Linha 1 Col 3 | | ||
| - | | Linha 2 Col 1 | algum colspan (note a barra dupla) | ||
| - | | Linha 3 Col 1 | Linha 3 Col 2 | Linha 3 Col 3 | | ||
| - | |||
| - | As linhas da tabela devem começar e terminar com um caractere '' | ||
| - | |||
| - | ^ Cabeçalho 1 ^ Cabeçalho 2 ^ Cabeçalho 3 ^ | ||
| - | | Linha 1 Col 1 | Linha 1 Col 2 | Linha 1 Col 3 | | ||
| - | | Linha 2 Col 1 | colspan (note a barra dupla) || | ||
| - | | Linha 3 Col 1 | Linha 3 Col 2 | Linha 3 Col 3 | | ||
| - | |||
| - | Para unir células horizontalmente, | ||
| - | |||
| - | Também é possível criar cabeçalhos de tabela verticais. | ||
| - | |||
| - | | ^ Cabeçalho 1 ^ Cabeçalho 2 ^ | ||
| - | ^ Cabeçalho 3 | Linha 1 Col 2 | Linha 1 Col 3 | | ||
| - | ^ Cabeçalho 4 | sem colspan desta vez| | | ||
| - | ^ Cabeçalho 5 | Linha 2 Col 2 | Linha 2 Col 3 | | ||
| - | |||
| - | Como você pode ver, é o separador de célula posicionado antes da célula que define a formatação: | ||
| - | |||
| - | | ^ Cabeçalho 1 ^ Cabeçalho 2 ^ | ||
| - | ^ Cabeçalho 3 | Linha 1 Col 2 | Linha 1 Col 3 | | ||
| - | ^ Cabeçalho 4 | sem colspan desta vez| | ||
| - | ^ Cabeçalho 5 | Linha 2 Col 2 | Linha 2 Col 3 | | ||
| - | |||
| - | Você pode criar *rowspans* (células unidas verticalmente) inserindo ''::: | ||
| - | |||
| - | ^ Cabeçalho 1 ^ Cabeçalho 2 ^ Cabeçalho 3 ^ | ||
| - | | Linha 1 Col 1 | esta célula se estende verticalmente | Linha 1 Col 3 | | ||
| - | | Linha 2 Col 1 | ::: | Linha 2 Col 3 | | ||
| - | | Linha 3 Col 1 | ::: | Linha 2 Col 3 | | ||
| - | |||
| - | Exceto pela sintaxe do *rowspan*, essas células não devem conter mais nada. | ||
| - | |||
| - | ^ Cabeçalho 1 ^ Cabeçalho 2 ^ Cabeçalho 3 ^ | ||
| - | | Linha 1 Col 1 | esta célula se estende verticalmente | Linha 1 Col 3 | | ||
| - | | Linha 2 Col 1 | ::: | Linha 2 Col 3 | | ||
| - | | Linha 3 Col 1 | ::: | Linha 2 Coluna 3 | | ||
| - | |||
| - | Você também pode alinhar o conteúdo da tabela. Basta adicionar pelo menos dois espaços em branco na extremidade oposta ao texto: adicione dois espaços à esquerda para alinhar à direita, dois espaços à direita para alinhar à esquerda e pelo menos dois espaços em ambas as extremidades para centralizar o texto. | ||
| - | |||
| - | ^ | ||
| - | | direita | centro | ||
| - | |esquerda | ||
| - | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | | ||
| - | |||
| - | Veja como isso aparece no código-fonte: | ||
| - | |||
| - | ^ | ||
| - | | | ||
| - | |esquerda | ||
| - | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | | ||
| - | |||
| - | Nota: O alinhamento vertical não é suportado. | ||
| - | |||
| - | ===== Sem Formatação ===== | ||
| - | |||
| - | Se você precisar exibir um texto exatamente como foi digitado (sem nenhuma formatação), | ||
| - | |||
| - | < | ||
| - | Este é um texto que contém endereços como este: http:// | ||
| - | </ | ||
| - | O mesmo vale para %%// | ||
| - | |||
| - | < | ||
| - | Este é um texto que contém endereços como este: http:// | ||
| - | </ | ||
| - | O mesmo vale para %%// | ||
| - | |||
| - | ===== Blocos de Código ===== | ||
| - | |||
| - | Você pode incluir blocos de código em seus documentos recuando-os em pelo menos dois espaços (como usado nos exemplos anteriores) ou usando as tags '' | ||
| - | |||
| - | Este texto está recuado em dois espaços. | ||
| - | |||
| - | < | ||
| - | Este é um código pré-formatado; | ||
| - | </ | ||
| - | |||
| - | < | ||
| - | Isso é praticamente a mesma coisa, mas você pode usar para indicar que citou um arquivo. | ||
| - | </ | ||
| - | |||
| - | Esses blocos foram criados a partir deste código-fonte: | ||
| - | |||
| - | Este texto está recuado em dois espaços. | ||
| - | |||
| - | < | ||
| - | Este é um código pré-formatado; | ||
| - | </ | ||
| - | |||
| - | < | ||
| - | Isso é praticamente a mesma coisa, mas você pode usar para indicar que citou um arquivo. | ||
| - | </ | ||
| - | |||
| - | ==== Realce de Sintaxe ==== | ||
| - | |||
| - | O [[wiki: | ||
| - | |||
| - | <code java> | ||
| - | /** | ||
| - | * A classe HelloWorldApp implementa uma aplicação que | ||
| - | * simplesmente exibe "Hello World!" | ||
| - | */ | ||
| - | class HelloWorldApp { | ||
| - | public static void main(String[] args) { | ||
| - | System.out.println(" | ||
| - | } | ||
| - | </ | ||
| - | |||
| - | As seguintes strings de linguagem são reconhecidas atualmente: //4cs 6502acme 6502kickass 6502tasm 68000devpac abap actionscript3 actionscript ada aimms algol68 apache applescript apt_sources arm asm asp asymptote autoconf autohotkey autoit avisynth awk bascomavr bash basic4gl batch bf biblatex bibtex blitzbasic bnf boo caddcl cadlisp ceylon cfdg cfm chaiscript chapel cil c_loadrunner clojure c_mac cmake cobol coffeescript c cpp cpp-qt cpp-winapi csharp css cuesheet c_winapi dart dcl dcpu16 dcs delphi diff div dos dot d ecmascript eiffel email epc e erlang euphoria ezt f1 falcon fo fortran freebasic freeswitch fsharp gambas gdb genero genie gettext glsl gml gnuplot go groovy gwbasic haskell haxe hicest hq9plus html html4strict html5 icon idl ini inno intercal io ispfpanel java5 java javascript jcl j jquery julia kixtart klonec klonecpp kotlin latex lb ldif lisp llvm locobasic logtalk lolcode lotusformulas lotusscript lscript lsl2 lua m68k magiksf make mapbasic mathematica matlab mercury metapost mirc mk-61 mmix modula2 modula3 mpasm mxml mysql nagios netrexx newlisp nginx nimrod nsis oberon2 objc objeck ocaml-brief ocaml octave oobas oorexx oracle11 oracle8 oxygene oz parasail parigp pascal pcre perl6 perl per pf phix php-brief php pic16 pike pixelbender pli plsql postgresql postscript povray powerbuilder powershell proftpd progress prolog properties providex purebasic pycon pys60 python qbasic qml q racket rails rbs rebol reg rexx robots roff rpmspec rsplus ruby rust sas sass scala scheme scilab scl sdlbasic smalltalk smarty spark sparql sql sshconfig standardml stonescript swift systemverilog tclegg tcl teraterm texgraph text thinbasic tsql twig typoscript unicon upc urbi uscript vala vbnet vb vbscript vedit verilog vhdl vim visualfoxpro visualprolog whitespace whois winbatch wolfram xbasic xml xojo xorg_conf xpp yaml z80 zxbasic// | ||
| - | |||
| - | Existem [[doku> | ||
| - | |||
| - | ==== Blocos de código para download ==== | ||
| - | |||
| - | Ao utilizar a sintaxe '' | ||
| - | |||
| - | < | ||
| - | <file php myexample.php> | ||
| - | <?php echo "hello world!"; | ||
| - | </ | ||
| - | </ | ||
| - | |||
| - | <file php myexample.php> | ||
| - | <?php echo "hello world!"; | ||
| - | </ | ||
| - | |||
| - | Se você não quiser destaque de sintaxe, mas desejar um arquivo para download, especifique um traço ('' | ||
| - | |||
| - | ===== Agregação de feeds RSS/ATOM ===== | ||
| - | O [[DokuWiki]] pode integrar dados de feeds XML externos. O [[http:// | ||
| - | |||
| - | ^ Parâmetro | ||
| - | | qualquer número | será usado como o número máximo de itens a exibir; o padrão é 8 | | ||
| - | | reverse | ||
| - | | author | ||
| - | | date | exibir datas dos itens | | ||
| - | | description| exibir a descrição do item. Todas as tags HTML serão removidas | | ||
| - | | nosort | ||
| - | | //n//[dhm] | período de atualização, | ||
| - | |||
| - | O período de atualização padrão é de 4 horas. Qualquer valor inferior a 10 minutos será tratado como 10 minutos. O [[wiki: | ||
| - | |||
| - | Por padrão, o feed será ordenado por data, com os itens mais recentes primeiro. Você pode ordená-lo começando pelos mais antigos usando o parâmetro '' | ||
| - | |||
| - | **Exemplo: | ||
| - | |||
| - | {{rss> | ||
| - | |||
| - | {{rss> | ||
| - | |||
| - | |||
| - | ===== Macros de Controle ===== | ||
| - | |||
| - | Alguns elementos de sintaxe influenciam a forma como o DokuWiki renderiza uma página sem gerar nenhuma saída por si só. As seguintes macros de controle estão disponíveis: | ||
| - | |||
| - | ^ Macro ^ Descrição | | ||
| - | | %%~~NOTOC~~%% | ||
| - | | %%~~NOCACHE~~%% | O DokuWiki armazena em cache toda a saída por padrão. Às vezes, isso pode não ser desejado (por exemplo, quando a sintaxe %%< | ||
| - | |||
| - | ===== Plugins de Sintaxe ===== | ||
| - | |||
| - | A sintaxe do DokuWiki pode ser estendida por meio de [[doku> | ||
| - | |||
| - | ~~INFO: | ||
wiki/syntax.1786565969.txt.gz · Última modificação: por brsavi
