====== Formatting Syntax ====== [[doku>DokuWiki]] suporta alguma linguagem de marcação simples, que tenta fazer com que os arquivos de dados sejam o mais legíveis possível. Esta página contém toda a sintaxe possível que você pode usar ao editar as páginas. Basta dar uma olhada na fonte desta página pressionando "Editar esta página". Se você quiser tentar algo, basta usar a página [[playground:playground|playground]]. A marcação mais simples é facilmente acessível via [[doku>toolbar|quickbuttons]], também. ===== Formatação básica de texto ===== DokuWiki suporta textos em **negrito**, //itálico//, __sublinhado__ e ''monoespaçado''. Claro que você pode **__//''combinar''//__** todos eles. DokuWiki suporta textos em **negrito**, //itálico//, __sublinhado__ e ''monoespaçado''. Claro que você pode **__//''combinar''//__** todos eles. Você também pode usar subscrito e sobrescrito. Você também pode usar subscrito e sobrescrito. Você também pode marcar algo como excluído. Você também pode marcar algo como excluído. **Parágrafos** são criados a partir de linhas em branco. Se você quiser **forçar uma nova linha** sem um parágrafo, você pode usar duas barras invertidas seguidas por um espaço em branco ou o fim da linha. Este é um texto com algumas quebras de linha. Observe que as duas barras invertidas são reconhecidas apenas no final de uma linha. \\ ou seguidas por \\ um espaço em branco. \\Isso acontece sem ele. Este é um texto com algumas quebras de linha. Observe que as duas barras invertidas são reconhecidas apenas no final de uma linha. \\ ou seguidas por \\ um espaço em branco. \\Isso acontece sem ele. Você deve usar quebras de linha forçadas somente se realmente necessário. ===== Links ===== O DokuWiki suporta diversas maneiras de criar links. ==== Externo ==== Links externos são reconhecidos automaticamente: http://www.google.com ou simplesmente www.google.com - Você também pode definir o texto do link: [[http://www.google.com|Este link aponta para o Google]]. Endereços de e-mail como este: também são reconhecidos. DokuWiki suporta várias maneiras de criar links. Links externos são reconhecidos automagicamente: http://www.google.com ou simplesmente www.google.com - Você pode definir texto de link também: [[http://www.google.com|Este link aponta para o Google]]. Endereços de e-mail como este: também são reconhecidos. ==== Interno ==== Links internos são criados usando colchetes. Você pode apenas dar um [[nomedapágina]] ou usar um [[nomedapágina|textodolink]] adicional. Links internos são criados usando colchetes. Você pode apenas dar um [[nomedapágina]] ou usar um [[nomedapágina|textodolink]] adicional. [[doku>pagename|Nomes de páginas wiki]] são convertidos para minúsculas automaticamente, caracteres especiais não são permitidos. Você pode usar [[some:namespaces]] usando dois pontos no nome da página. Você pode usar [[some:namespaces]] usando dois pontos no nome da página. Para detalhes sobre namespaces, consulte [[doku>namespaces]]. Também é possível vincular a uma seção específica. Basta adicionar o nome da seção atrás de um caractere hash, como é conhecido em HTML. Isso vincula a [[syntax#internal|esta Seção]]. Este link leva a [[syntax#internal|esta seção]]. Notas: * Links para [[syntax|páginas existentes]] são mostrados em um estilo diferente dos [[não existentes]]. * O DokuWiki não usa [[wp>CamelCase]] para criar links automaticamente por padrão, mas esse comportamento pode ser habilitado no arquivo [[doku>config]]. Dica: Se o DokuWiki for um link, então ele está habilitado. * Quando o título de uma seção é alterado, seu marcador também muda. Então não confie muito em links de seção. ==== Interwiki ==== DokuWiki suporta links [[doku>Interwiki]]. Esses são links rápidos para outros Wikis. Por exemplo, esse é um link para a página da Wikipedia sobre Wikis: [[wp>Wiki]]. DokuWiki suporta links [[doku>Interwiki]]. Esses são links rápidos para outros Wikis. Por exemplo, esse é um link para a página da Wikipedia sobre Wikis: [[wp>Wiki]]. ==== Compartilhamentos do Windows ==== Compartilhamentos do Windows como [[\\server\share|this]] também são reconhecidos. Observe que eles só fazem sentido em um grupo de usuários homogêneo, como uma [[wp>Intranet]] corporativa. Compartilhamentos do Windows como [[\\server\share|this]] também são reconhecidos. Notas: * Por razões de segurança, a navegação direta de compartilhamentos do Windows só funciona no Microsoft Internet Explorer por padrão (e apenas na "zona local"). * Para Mozilla e Firefox, pode ser habilitado por meio de diferentes soluções alternativas mencionadas na [[http://kb.mozillazine.org/Links_to_local_pages_do_not_work|Mozilla Knowledge Base]]. No entanto, ainda haverá um aviso do JavaScript sobre a tentativa de abrir um compartilhamento do Windows. Para remover esse aviso (para todos os usuários), coloque a seguinte linha em ''conf/lang/en/lang.php'' (mais detalhes em [[doku>localization#changing_some_localized_texts_and_strings_in_your_installation|localization]]): ==== Links de imagem ==== Você também pode usar uma imagem para criar um link para outra página interna ou externa combinando a sintaxe para links e [[#images_and_other_files|imagens]] (veja abaixo) assim: [[http://php.net|{{wiki:dokuwiki-128.png}}]] [[http://php.net|{{wiki:dokuwiki-128.png}}]] Observação: a formatação de imagem é a única sintaxe de formatação aceita em nomes de links. Toda a sintaxe [[#images_and_other_files|image]] e [[#links|link]] é suportada (incluindo redimensionamento de imagens, imagens internas e externas, URLs e links interwiki). ===== 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. ===== Seccionamento ===== Você pode usar até cinco níveis diferentes de títulos para estruturar seu conteúdo. Se você tiver mais de três títulos, um índice é gerado automaticamente -- isso pode ser desabilitado incluindo a string ''~~NOTOC~~'' no documento. ==== Headline Level 3 ==== === Headline Level 4 === == Headline Level 5 == ==== Headline Level 3 ==== === Headline Level 4 === == Headline Level 5 == Usando quatro ou mais traços, você pode fazer uma linha horizontal: ---- ===== Arquivos de mídia ===== Você pode incluir [[doku>images|imagens, vídeos e arquivos de áudio]] externos e internos com chaves. Opcionalmente, você pode especificar o tamanho deles. Tamanho real: {{wiki:dokuwiki-128.png}} Redimensioanr para a largura informada: {{wiki:dokuwiki-128.png?50}} Redimensionar para a largura e altura fornecidas ((quando a proporção da largura e altura fornecidas não corresponder à da imagem, ela será cortada para a nova proporção antes do redimensionamento)): {{wiki:dokuwiki-128.png?200x50}} Imagem externa redimensionada:           {{https://www.php.net/images/php.gif?200x50}} Tamanho real: {{wiki:dokuwiki-128.png}} Redimensionar para a largura fornecida: {{wiki:dokuwiki-128.png?50}} Redimensionar para a largura e altura fornecida: {{wiki:dokuwiki-128.png?200x50}} Imagem externa redimensionada:           {{https://www.php.net/images/php.gif?200x50}} Usando espaços em branco à esquerda ou à direita, você pode escolher o alinhamento. {{ wiki:dokuwiki-128.png}} {{wiki:dokuwiki-128.png }} {{ wiki:dokuwiki-128.png }} {{ wiki:dokuwiki-128.png}} {{wiki:dokuwiki-128.png }} {{ wiki:dokuwiki-128.png }} Claro, você também pode adicionar um título (exibido como uma dica de ferramenta pela maioria dos navegadores). {{ wiki:dokuwiki-128.png |This is the caption}} {{ wiki:dokuwiki-128.png |This is the caption}} For linking an image to another page see [[#Image Links]] above. ==== Formatos de mídia suportados ==== O DokuWiki pode incorporar os seguintes formatos de mídia diretamente. | Image | ''gif'', ''jpg'', ''png'' | | Video | ''webm'', ''ogv'', ''mp4'' | | Audio | ''ogg'', ''mp3'', ''wav'' | | Flash | ''swf'' | Se você especificar um nome de arquivo que não seja um formato de mídia suportado, ele será exibido como um link. Ao adicionar ''?linkonly'' você fornece um link para a mídia sem exibi-lo em linha {{wiki:dokuwiki-128.png?linkonly}} {{wiki:dokuwiki-128.png?linkonly}} Este é apenas um link para a imagem. ==== Formatos de fallback ==== Infelizmente, nem todos os navegadores entendem todos os formatos de vídeo e áudio. Para mitigar o problema, você pode carregar seu arquivo em formatos diferentes para compatibilidade máxima com o navegador. Por exemplo, considere este vídeo mp4 incorporado: {{video.mp4|A funny video}} Quando você carrega um ''video.webm'' e ''video.ogv'' ao lado do ''video.mp4'' referenciado, o DokuWiki os adicionará automaticamente como alternativas para que um dos três arquivos seja compreendido pelo seu navegador. Além disso, o DokuWiki suporta uma imagem de "pôster" que será mostrada antes do vídeo começar. Essa imagem precisa ter o mesmo nome de arquivo do vídeo e ser um arquivo jpg ou png. No exemplo acima, um arquivo ''video.jpg'' funcionaria. ===== Listas ===== O Dokuwiki suporta listas ordenadas e não ordenadas. Para criar um item de lista, indente seu texto em dois espaços e use um ''*'' para listas não ordenadas ou um ''-'' para listas ordenadas. * Esta é uma lista * O segundo item * Você pode ter níveis diferentes * Outro item - A mesma lista, mas ordenada - Outro item - Basta usar recuo para níveis mais profundos - É isso * Esta é uma lista * O segundo item * Você pode ter níveis diferentes * Outro item - A mesma lista, mas ordenada - Outro item - Basta usar recuo para níveis mais profundos - É isso Dê uma olhada também no [[doku>faq:lists|FAQ sobre itens de lista]]. ===== Conversões de texto ===== O DokuWiki pode converter certos caracteres ou strings predefinidos em imagens ou outro texto ou HTML. A conversão de texto para imagem é feita principalmente para smileys. E a conversão de texto para HTML é usada para substituições de tipografia, mas pode ser configurada para usar outro HTML também. ==== Conversões de texto para imagem ==== DokuWiki converte [[wp>emoticons]] comumente usados ​​em seus equivalentes gráficos. Esses [[doku>Smileys]] e outras imagens podem ser configuradas e estendidas. Aqui está uma visão geral dos Smileys incluídos no DokuWiki: * 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: [[DokuWiki]] pode converter caracteres de texto simples para suas entidades tipograficamente corretas. Aqui está um exemplo de caracteres reconhecidos. -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) "Ele pensou: 'É um mundo de homens'..." -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) "Ele pensou: 'É um mundo de homens'..." O mesmo pode ser feito para produzir qualquer tipo de HTML, bastando adicioná-lo ao [[doku>entities|arquivo de padrões]]. Há três exceções que não vêm desse arquivo de padrão: entidade de multiplicação (640x480), 'single' e "double quotes". Elas podem ser desativadas por meio de uma [[doku>config:typography|opção de configuração]]. ===== Citando ===== Às vezes você quer marcar algum texto para mostrar que é 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! >>> Então vamos fazer isso! I think we should do it > Não, não deveríamos >> Bem, eu digo que deveríamos > Sério? >> Sim! >>> Então vamos lá! ===== Tabelas ===== O DokuWiki suporta uma sintaxe simples para criar 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 | some Colunaspan (note the double pipe) || | Linha 3 Coluna 1 | Linha 3 Coluna 2 | Linha 3 Coluna 3 | As Linhas da tabela devem começar e terminar com ''|'' para Linhas normais ou ''^'' para cabeçalhos. ^ 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 | some Colunaspan (note the double pipe) || | Linha 3 Coluna 1 | Linha 3 Coluna 2 | Linha 3 Coluna 3 | Para conectar células horizontalmente, basta deixar a próxima célula completamente vazia, como mostrado acima. Certifique-se de ter sempre a mesma quantidade de separadores de células! Também são possíveis cabeçalhos de tabela verticais. | ^ Cabeçalho 1 ^ Cabeçalho 2 ^ ^ Cabeçalho 3 | Linha 1 Coluna 2 | Linha 1 Coluna 3 | ^ Cabeçalho 4 | no Colunaspan this time | | ^ Cabeçalho 5 | Linha 2 Coluna 2 | Linha 2 Coluna 3 | Como você pode ver, é o separador de células antes de uma célula que decide sobre a formatação: | ^ Cabeçalho 1 ^ Cabeçalho 2 ^ ^ Cabeçalho 3 | Linha 1 Coluna 2 | Linha 1 Coluna 3 | ^ Cabeçalho 4 | no Colunaspan this time | | ^ Cabeçalho 5 | Linha 2 Coluna 2 | Linha 2 Coluna 3 | Você pode ter Linhaspans (células conectadas verticalmente) adicionando ''%%:::%%'' nas células abaixo daquela à qual elas devem se conectar. ^ Cabeçalho 1 ^ Cabeçalho 2 ^ Cabeçalho 3 ^ | Linha 1 Coluna 1 | this cell spans vertically | Linha 1 Coluna 3 | | Linha 2 Coluna 1 | ::: | Linha 2 Coluna 3 | | Linha 3 Coluna 1 | ::: | Linha 2 Coluna 3 | Além da sintaxe do Linhaspan, essas células não devem conter mais nada. ^ Cabeçalho 1 ^ Cabeçalho 2 ^ Cabeçalho 3 ^ | Linha 1 Coluna 1 | this cell spans vertically | 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. Basta adicionar pelo menos dois espaços em branco na extremidade oposta do seu texto: adicione dois espaços à esquerda para alinhar à direita, dois espaços à direita para alinhar à esquerda e dois espaços pelo menos em ambas as extremidades para texto centralizado. ^ Tabela com alinhamento ^^^ | direita| centro |esuerda | |esquerda | direita| centro | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | É assim que aparece na fonte: ^ Tabela com alinhamento ^^^ | direita| centro |esquerda | |esquerda | direita| centro | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | Observação: o alinhamento vertical não é suportado. ===== Sem formatação ===== Se você precisar exibir o texto exatamente como ele foi digitado (sem nenhuma formatação), delimite a área com as tags ''%%%%'' ou, ainda mais simples, com sinais de porcentagem duplos ''%%''. Este é um texto que contém endereços como este: http://www.splitbrain.org e **formatação**, mas nada é feito com ele. O mesmo vale para %%//__este__ texto// com um smiley ;-)%%. Este é um texto que contém endereços como este: http://www.splitbrain.org e **formatação**, mas nada é feito com ele. O mesmo é verdade para %%//__este__ texto// com um smiley ;-)%%. ===== 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 ''%%%%'' ou ''%%%%''. Este texto é recuado por dois espaços. Este é um código pré-formatado, todos os espaços são preservados: como <-este Isso é praticamente o mesmo, mas você pode usá-lo para mostrar que citou um arquivo. Esses blocos foram criados por esta fonte: Este texto é recuado por dois espaços. Este é um código pré-formatado, todos os espaços são preservados: como <-este Isso é praticamente o mesmo, mas você pode usá-lo para mostrar que citou um arquivo. ==== Destaque de sintaxe ==== [[wiki:DokuWiki]] pode destacar o código-fonte, o que o torna mais fácil de ler. Ele usa o [[http://qbnz.com/highlighter/|GeSHi]] Generic Syntax Highlighter -- então qualquer linguagem suportada pelo GeSHi é suportada. A sintaxe usa o mesmo código e blocos de arquivo descritos na seção anterior, mas desta vez o nome da sintaxe da linguagem a ser destacada é incluído dentro da tag, por exemplo, '''' ou ''''. /** * A classe HelloWorldApp implementa um aplicativo que * simplesmente exibe "Olá, Mundo!" na saída padrão. */ class HelloWorldApp { public static void main(String[] args) { System.out.println("Olá, Mundo!"); //Display the string. } } As seguintes sequências de caracteres de idioma são atualmente reconhecidas: //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 ícone 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 por pf phix php-brief php pic16 pike pixelbender pli plsql postgresql postscript povray powerbuilder powershell proftpd progresso prolog propriedades providex purebasic pycon pys60 python qbasic qml q racket rails rbs rebol reg rexx robôs roff rpmspec rsplus ruby ​​ferrugem sas sass scala esquema scilab scl sdlbasic smalltalk smarty spark sparql sql sshconfig standardml stonescript swift systemverilog tclegg tcl teraterm texgraph texto thinbasic tsql twig typoscript unicon upc urbi uscript vala vbnet vb vbscript vedit verilog vhdl vim visualfoxpro visualprolog espaço em branco whois winbatch wolfram xbasic xml xojo xorg_conf xpp yaml z80 zxbásico// Há [[doku>syntax_highlighting|opções avançadas]] adicionais disponíveis para destaque de sintaxe, como destacar linhas ou adicionar números de linha. ==== Blocos de código para download ==== Quando você usa a sintaxe ''%%%%'' ou ''%%%%'' como acima, você pode querer tornar o código mostrado disponível para download também. Você pode fazer isso especificando um nome de arquivo após o código de idioma como este: Se você não quiser nenhum destaque, mas quiser um arquivo para download, especifique um traço (''-'') como o código do idioma: ''%%%%''. ===== RSS/ATOM Feed Aggregation ===== [[DokuWiki]] pode integrar dados de feeds XML externos. Para analisar os feeds XML, [[http://simplepie.org/|SimplePie]] é usado. Todos os formatos compreendidos pelo SimplePie podem ser usados ​​no DokuWiki também. Você pode influenciar a renderização por vários parâmetros adicionais separados por espaço: ^ Parâmetro ^ Descrição ^ | qualquer número | será usado como número máximo de itens a serem exibidos, o padrão é 8 | | reverso | exibir os últimos itens no feed primeiro | | autor | mostrar nomes de autores de itens | | data | mostrar datas de itens | | descrição| mostrar a descrição do item. Todas as tags HTML serão removidas | | nosort | não classificar os itens no feed | | //n//[dhm] | período de atualização, onde d=dias, h=horas, m=minutos. (por exemplo, 12h = 12 horas). | O período de atualização padrão é de 4 horas. Qualquer valor abaixo de 10 minutos será tratado como 10 minutos. O [[wiki:DokuWiki]] geralmente tentará fornecer uma versão em cache de uma página, obviamente isso é inapropriado quando a página contém conteúdo externo dinâmico. O parâmetro diz ao [[wiki:DokuWiki]] para renderizar novamente a página se tiver passado mais de //período de atualização// desde que a página foi renderizada pela última vez. Por padrão, o feed será classificado por data, os itens mais novos primeiro. Você pode classificá-lo pelo mais antigo primeiro usando o parâmetro ''reverse'' ou exibir o feed como está com ''nosort''. **Examplo:** {{rss>http://slashdot.org/index.rss 5 author date 1h }} {{rss>http://slashdot.org/index.rss 5 author date 1h }} ===== Macros de controle ===== Alguma sintaxe influencia como o DokuWiki renderiza uma página sem criar nenhuma saída por si só. As seguintes macros de controle estão disponíveis: ^ Macro ^ Descrição | | %%~~NOTOC~~%% | Se esta macro for encontrada na página, nenhuma tabela de conteúdo será criada | | %%~~NOCACHE~~%% | O DokuWiki armazena em cache todas as saídas por padrão. Às vezes, isso pode não ser desejado (por exemplo, quando a sintaxe %%%% acima é usada), adicionar esta macro forçará o DokuWiki a renderizar novamente uma página em cada chamada | ===== Syntax Plugins ===== A sintaxe do DokuWiki pode ser estendida por [[doku>plugins|Plugins]]. Como os plugins instalados são usados ​​é descrito em suas páginas de descrição apropriadas. Os seguintes plugins de sintaxe estão disponíveis nesta instalação particular do DokuWiki: ~~INFO:syntaxplugins~~