slitaz-doc-wiki-data annotate pages/pt/wiki/syntax.txt @ rev 3

Add pages/pt folder.
author Christopher Rogers <slaxemulator@gmail.com>
date Sat Feb 26 12:12:42 2011 +0000 (2011-02-26)
parents
children
rev   line source
slaxemulator@3 1 ====== Sintaxe de Formatação ======
slaxemulator@3 2
slaxemulator@3 3 O [[http://www.dokuwiki.org/DokuWiki|Dokuwiki]] suporta algumas linguagens de marcação bem simples, as quais procuram fazer com que os arquivos de dados sejam o mais legíveis possível. Esta página contém todos os comandos disponíveis que você poderá usar para editar as páginas. Dê uma olhada no código-fonte dessa página clicando no botão //Editar esta página// no topo ou no rodapé da página. Se você quiser treinar um pouco, use a página [[http://doc.slitaz.org/en:guides:playground|playground]]. As marcações mais simples também são acessíveis através da [[doku>wiki:quickbuttons|barra de botões]].
slaxemulator@3 4
slaxemulator@3 5 ===== Formatação Básica de Texto =====
slaxemulator@3 6
slaxemulator@3 7 O Dokuwiki suporta textos em **negrito**, //itálico//, __sublinhado__ e ''mono espaçado''. Obviamente você poderá **__//''combinar''//__** todas elas.
slaxemulator@3 8
slaxemulator@3 9 O Dokuwiki suporta textos em **negrito**,
slaxemulator@3 10 //itálico//, __sublinhado__ e ''mono espaçado''.
slaxemulator@3 11 Obviamente você poderá **__//''combinar''//__**
slaxemulator@3 12 todas elas.
slaxemulator@3 13
slaxemulator@3 14 Você também pode usar <sub>subscrito</sub> e <sup>sobrescrito</sup>.
slaxemulator@3 15
slaxemulator@3 16 Você também pode usar <sub>subscrito</sub> e <sup>sobrescrito</sup>.
slaxemulator@3 17
slaxemulator@3 18 Você poderá marcar algo como <del>tachado</del>.
slaxemulator@3 19
slaxemulator@3 20 Você poderá marcar algo como <del>tachado</del>.
slaxemulator@3 21
slaxemulator@3 22 **Paragrafos** são criados a partir de linhas em branco. Se você quiser **forçar a quebra de linha** sem um novo parágrafo, você poderá usar duas contra-barras seguidas de um espaço em branco ou o fim da linha.
slaxemulator@3 23
slaxemulator@3 24 Este é um texto com algumas quebras de linha\\ Note que as
slaxemulator@3 25 duas contra-barras são reconhecidas apenas no fim da linha\\
slaxemulator@3 26 ou seguidas por\\ um espaço \\isto que acontece sem o espaço.
slaxemulator@3 27
slaxemulator@3 28 Este é um texto com algumas quebras de linha\\ Note que as
slaxemulator@3 29 duas contra-barras são reconhecidas apenas no fim da linha\\
slaxemulator@3 30 ou seguidas por\\ um espaço \\isto que acontece sem o espaço.
slaxemulator@3 31
slaxemulator@3 32 Você deve forçar as quebras de linha apenas quando necessário.
slaxemulator@3 33
slaxemulator@3 34 ===== Links =====
slaxemulator@3 35
slaxemulator@3 36 O Dokuwiki suporta múltiplas formas de criar links(ligações entre páginas).
slaxemulator@3 37
slaxemulator@3 38 ==== Externos ====
slaxemulator@3 39
slaxemulator@3 40 Links externos são reconhecidos automaticamente: http://www.google.com ou simplesmente www.google.com - Você também pode nomear os links: [[http://www.google.com|Este link aponta para o Google]]. Endereços de e-mail como este: <andi@splitbrain.org> também são reconhecidos automaticamente.
slaxemulator@3 41
slaxemulator@3 42 Links externos são reconhecidos automaticamente: http://www.google.com
slaxemulator@3 43 ou simplesmente www.google.com - Você também pode nomear os links:
slaxemulator@3 44 [[http://www.google.com|Este link aponta para o Google]].
slaxemulator@3 45 Endereços de e-mail como este: <andi@splitbrain.org>
slaxemulator@3 46 também são reconhecidos automaticamente.
slaxemulator@3 47
slaxemulator@3 48 ==== Internos ====
slaxemulator@3 49
slaxemulator@3 50 Links internos são criados usando colchetes. Você pode apenas fornecer o [[http://www.dokuwiki.org/pt-br:pagename|nome da página]] ou usar uma descrição adicional [[http://www.dokuwiki.org/pt-br:pagename|Título da Página]]. Os nomes das páginas wiki são convertidos para minúsculo automaticamente e caracteres especiais(espaço, acentos e pontuação) não são permitidos.
slaxemulator@3 51
slaxemulator@3 52 Links internos são criados usando colchetes. Você pode apenas fornecer
slaxemulator@3 53 o [[nome_da_pagina]] ou usar uma descrição adicional
slaxemulator@3 54 [[nome_da_pagina|Título da Página]]. Os nomes das páginas
slaxemulator@3 55 wiki são convertidos para minúsculo automaticamente e
slaxemulator@3 56 caracteres especiais(espaço, acentos e pontuação) não são permitidos.
slaxemulator@3 57
slaxemulator@3 58 Você pode usar [[namespaces]] incluindo dois-pontos no nome da página.
slaxemulator@3 59
slaxemulator@3 60 Você pode usar [[namespaces]] incluindo dois-pontos
slaxemulator@3 61 no nome da página.
slaxemulator@3 62
slaxemulator@3 63 //Namespaces// são diretórios de páginas usados para organizar e evitar que páginas com o mesmo nome entrem em conflito.
slaxemulator@3 64 [[http://www.dokuwiki.org/pt-br:namespaces|Clique aqui]] para saber mais sobre [[http://www.dokuwiki.org/pt-br:namespaces]].
slaxemulator@3 65
slaxemulator@3 66 É possível apontar um link para uma seção específica. Basta adicionar o nome da seção após um caractere de cerquilha(#) assim como no HTML. Este link aponta para [[pt:wiki:syntax#internos|esta seção]].
slaxemulator@3 67
slaxemulator@3 68 Este link aponta para [[pt:wiki:syntax#internos|esta seção]].
slaxemulator@3 69
slaxemulator@3 70 Notas:
slaxemulator@3 71
slaxemulator@3 72 * Links para [[pt:wiki:syntax|páginas existentes]] são exibidos em estilo diferente dos [[não existentes]].
slaxemulator@3 73 * Quando os nomes das seções são alterados, os links que apontam pra elas devem ser alterados também. Portanto, não conte muito com os links de seção.
slaxemulator@3 74 ==== Interwiki ====
slaxemulator@3 75
slaxemulator@3 76 O Dokuwiki suporta links [[http://www.dokuwiki.org/pt-br:interwiki|Interwiki]], que são links rápidos com outros wikis. Este é um exemplo de link para a página sobre Wikis da Wikipedia: [[wp>Wiki]].
slaxemulator@3 77
slaxemulator@3 78 O Dokuwiki suporta links [[http://www.dokuwiki.org/pt-br:interwiki|Interwiki]], que são
slaxemulator@3 79 links rápidos com outros wikis. Este é um exemplo de link para a
slaxemulator@3 80 página sobre Wikis da Wikipedia: [[wp>Wiki]].
slaxemulator@3 81
slaxemulator@3 82
slaxemulator@3 83 ==== Links com Imagens ====
slaxemulator@3 84
slaxemulator@3 85 Você também poderá usar uma imagem para linkar outra página interna ou externa combinando a sintaxe de links e de [[pt:wiki:syntax#imagens e outros arquivos|imagens]] (veja abaixo) desta forma:
slaxemulator@3 86
slaxemulator@3 87 [[http://www.php.net|{{wiki:dokuwiki-128.png}}]]
slaxemulator@3 88
slaxemulator@3 89 [[http://www.php.net|{{wiki:dokuwiki-128.png}}]]
slaxemulator@3 90
slaxemulator@3 91 Favor observar: A formatação de imagem é a única sintaxe de formatação aceita nos nomes de links.
slaxemulator@3 92
slaxemulator@3 93 A sintaxe completa de [[pt:wiki:syntax#imagens_e_outros_arquivos|imagem]] e de [[pt:wiki:syntax#links|link]] é suportada. (incluindo redimensionamento de imagens, imagens internas e externas e links para URLs e interwiki).
slaxemulator@3 94
slaxemulator@3 95 ===== Notas de Rodapé =====
slaxemulator@3 96
slaxemulator@3 97 Você pode adicionar notas de rodapé ((Isto é uma nota de rodapé)) usando parênteses duplos.
slaxemulator@3 98
slaxemulator@3 99 Você pode adicionar notas de rodapé ((Isto é uma nota de rodapé))
slaxemulator@3 100 usando parênteses duplos.
slaxemulator@3 101
slaxemulator@3 102 ===== Seções =====
slaxemulator@3 103
slaxemulator@3 104 Você pode usar até cinco diferentes níveis de títulos para estruturar seu conteúdo. Se você tiver mais de três níveis, uma Tabela de Conteúdo será gerada automaticamente. A Tabela de Conteúdo aparecerá no lado direito no topo da página e poderá ser desabilitada incluindo o comando ''<nowiki>~~NOTOC~~</nowiki>'' no documento.
slaxemulator@3 105
slaxemulator@3 106 ==== Título Nível 3 ====
slaxemulator@3 107 === Título Nível 4 ===
slaxemulator@3 108 == Título Nível 5 ==
slaxemulator@3 109
slaxemulator@3 110 ==== Título Nível 3 ====
slaxemulator@3 111 === Título Nível 4 ===
slaxemulator@3 112 == Título Nível 5 ==
slaxemulator@3 113
slaxemulator@3 114 Usando quatro ou mais traços, você poderá incluir uma linha horizontal:
slaxemulator@3 115
slaxemulator@3 116 ----
slaxemulator@3 117
slaxemulator@3 118 ===== Imagens e Outros Arquivos =====
slaxemulator@3 119
slaxemulator@3 120 Você pode incluir [[http://www.dokuwiki.org/pt-br:images|imagens]] internas e externas usando chaves. Opcionalmente você pode especificar o tamanho delas.
slaxemulator@3 121
slaxemulator@3 122 Tamanho real: {{wiki:dokuwiki-128.png}}
slaxemulator@3 123
slaxemulator@3 124 Tamanho personalizado: {{wiki:dokuwiki-128.png?50}}
slaxemulator@3 125
slaxemulator@3 126 Redimensionar para uma largura ou largura específica((Quando a proporção da largura e altura especificada não coincidir com a da imagem, ela será recortada para a nova proporção antes de ser redimensionada)): {{wiki:dokuwiki-128.png?200x50}}
slaxemulator@3 127
slaxemulator@3 128 Imagem externa redimensionada: {{http://de3.php.net/images/php.gif?200x50}}
slaxemulator@3 129
slaxemulator@3 130 Tamanho Real: {{wiki:dokuwiki-128.png}}
slaxemulator@3 131 Redimensionada para uma largura específica: {{wiki:dokuwiki-128.png?50}}
slaxemulator@3 132 Redimensionada para uma altura específica: {{wiki:dokuwiki-128.png?200x50}}
slaxemulator@3 133 Imagem externa redimensionada: {{http://de3.php.net/images/php.gif?200x50}}
slaxemulator@3 134
slaxemulator@3 135 Usando espaços em branco na direita e na esquerda, você poderá mudar o alinhamento:
slaxemulator@3 136
slaxemulator@3 137 {{ wiki:dokuwiki-128.png}}
slaxemulator@3 138
slaxemulator@3 139 {{wiki:dokuwiki-128.png }}
slaxemulator@3 140
slaxemulator@3 141 {{ wiki:dokuwiki-128.png }}
slaxemulator@3 142
slaxemulator@3 143 {{ wiki:dokuwiki-128.png}}
slaxemulator@3 144 {{wiki:dokuwiki-128.png }}
slaxemulator@3 145 {{ wiki:dokuwiki-128.png }}
slaxemulator@3 146
slaxemulator@3 147 Obviamente, você também pode trocar o título da imagem(exibido como //tooltip// por muitos navegadores quando se pára o mouse sobre a imagem ou a imagem não é encontrada).
slaxemulator@3 148
slaxemulator@3 149 {{ wiki:dokuwiki-128.png |Este é o título}}
slaxemulator@3 150
slaxemulator@3 151 {{ wiki:dokuwiki-128.png |Este é o título}}
slaxemulator@3 152
slaxemulator@3 153 Se você especificar um nome de arquivo (externo ou interno) que não é uma imagem(''gif, jpeg, png''), então este texto será exibido como um link.
slaxemulator@3 154
slaxemulator@3 155 Para linkar uma umagem para outra página, veja o tópico [[#Links com Imagens]] acima.
slaxemulator@3 156
slaxemulator@3 157 ===== Listas =====
slaxemulator@3 158
slaxemulator@3 159 O Dokuwiki suportas listas ordenadas 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.
slaxemulator@3 160
slaxemulator@3 161 * Esta é uma lista
slaxemulator@3 162 * O segundo item
slaxemulator@3 163 * você pode ter diferentes níveis
slaxemulator@3 164 * Outro item
slaxemulator@3 165
slaxemulator@3 166 - A mesma lista porém ordenada
slaxemulator@3 167 - Outro Item
slaxemulator@3 168 - Simplesmente use endentação para criar níveis
slaxemulator@3 169 - Último item
slaxemulator@3 170
slaxemulator@3 171 <code>
slaxemulator@3 172 * Esta é uma lista
slaxemulator@3 173 * O segundo item
slaxemulator@3 174 * você pode ter diferentes níveis
slaxemulator@3 175 * Outro item
slaxemulator@3 176
slaxemulator@3 177 - A mesma lista porém ordenada
slaxemulator@3 178 - Outro Item
slaxemulator@3 179 - Simplesmente use endentação para criar níveis
slaxemulator@3 180 - Último item
slaxemulator@3 181 </code>
slaxemulator@3 182
slaxemulator@3 183 Veja também o [[http://www.dokuwiki.org/pt-br:faq:lists|FAQ de listas de itens]].
slaxemulator@3 184
slaxemulator@3 185 ===== Conversões de Texto =====
slaxemulator@3 186
slaxemulator@3 187 O Dokuwiki pode converter certos caracteres ou textos predefinidos em imagens ou em outro texto ou em HTML.
slaxemulator@3 188
slaxemulator@3 189 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.
slaxemulator@3 190
slaxemulator@3 191 ==== Conversão de Texto para Imagem ====
slaxemulator@3 192
slaxemulator@3 193 O Dokuwiki converte os [[wp>emoticon]]s mais usados para seus equivalente em imagem. Estes [[http://www.dokuwiki.org/pt-br:Smileys]] e outras imagens podem ser configurados e estendidos. Aqui está uma visão geral do que já está incluído:
slaxemulator@3 194
slaxemulator@3 195 O Dokuwiki converte os [[wp>emoticon]]s mais usados para equivalentes em formato gráfico. Veja a lista de //smileys// incluídos no Dokuwiki.
slaxemulator@3 196
slaxemulator@3 197 * 8-) %% 8-) %%
slaxemulator@3 198 * 8-O %% 8-O %%
slaxemulator@3 199 * :-( %% :-( %%
slaxemulator@3 200 * :-) %% :-) %%
slaxemulator@3 201 * =) %% =) %%
slaxemulator@3 202 * :-/ %% :-/ %%
slaxemulator@3 203 * :-\ %% :-\ %%
slaxemulator@3 204 * :-? %% :-? %%
slaxemulator@3 205 * :-D %% :-D %%
slaxemulator@3 206 * :-P %% :-P %%
slaxemulator@3 207 * :-O %% :-O %%
slaxemulator@3 208 * :-X %% :-X %%
slaxemulator@3 209 * :-| %% :-| %%
slaxemulator@3 210 * ;-) %% ;-) %%
slaxemulator@3 211 * ^_^ %% ^_^ %%
slaxemulator@3 212 * :?: %% :?: %%
slaxemulator@3 213 * :!: %% :!: %%
slaxemulator@3 214 * LOL %% LOL %%
slaxemulator@3 215 * FIXME %% FIXME %%
slaxemulator@3 216 * DELETEME %% DELETEME %%
slaxemulator@3 217
slaxemulator@3 218 ===== Conversão de Texto para HTML =====
slaxemulator@3 219
slaxemulator@3 220 O [[http://www.dokuwiki.org/pt-br:Dokuwiki]] pode converter caracteres de texto simples em suas entidades tipograficamente corretas. Aqui está um exemplo de caracteres reconhecidos.
slaxemulator@3 221
slaxemulator@3 222 -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
slaxemulator@3 223 "Ele disse: 'Aquilo é um frango-d'água'..."
slaxemulator@3 224
slaxemulator@3 225 <code>
slaxemulator@3 226 -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
slaxemulator@3 227 "Ele disse: 'Aquilo é um frango-d'água'..."
slaxemulator@3 228 </code>
slaxemulator@3 229
slaxemulator@3 230 ===== Citações =====
slaxemulator@3 231
slaxemulator@3 232 Em alguns casos você precisará marcar textos para serem exibidos em uma resposta ou comentário. Você pode usar a seguinte sintaxe:
slaxemulator@3 233
slaxemulator@3 234 Eu pensei que nos deveríamos fazer isto
slaxemulator@3 235
slaxemulator@3 236 > Não, não deveríamos
slaxemulator@3 237
slaxemulator@3 238 >> Bem, eu disse que nós deveríamos
slaxemulator@3 239
slaxemulator@3 240 > Realmente?
slaxemulator@3 241
slaxemulator@3 242 >> Sim!
slaxemulator@3 243
slaxemulator@3 244 >>> Então vamos fazer isto!
slaxemulator@3 245
slaxemulator@3 246 Eu pensei que nos deveríamos fazer isto
slaxemulator@3 247
slaxemulator@3 248 > Não, não deveríamos
slaxemulator@3 249
slaxemulator@3 250 >> Bem, eu disse que nós deveríamos
slaxemulator@3 251
slaxemulator@3 252
slaxemulator@3 253 > Realmente?
slaxemulator@3 254
slaxemulator@3 255 >> Sim!
slaxemulator@3 256
slaxemulator@3 257 >>> Então vamos fazer isto!
slaxemulator@3 258
slaxemulator@3 259 ===== Tabelas =====
slaxemulator@3 260
slaxemulator@3 261 O Dokuwiki disponibiliza uma sintaxe simples para criação de tabelas.
slaxemulator@3 262
slaxemulator@3 263 ^ Cabeçalho 1 ^ Cabeçalho 2 ^ Cabeçalho 3 ^
slaxemulator@3 264 | Linha 1 Coluna 1 | Linha 1 Coluna 2 | Linha 1 Coluna 3 |
slaxemulator@3 265 | Linha 2 Coluna 1 | Linha mesclada (repare o pipeline duplo) ||
slaxemulator@3 266 | Linha 3 Coluna 1 | Linha 3 Coluna 2 | Linha 3 Coluna 3 |
slaxemulator@3 267
slaxemulator@3 268 Linhas de tabelas devem iniciar e terminas com um ''|''(pipeline) para linhas de dados ou com um ''^''(circunflexo) para cabeçalhos.
slaxemulator@3 269
slaxemulator@3 270 ^ Cabeçalho 1 ^ Cabeçalho 2 ^ Cabeçalho 3 ^
slaxemulator@3 271 | Linha 1 Coluna 1 | Linha 1 Coluna 2 | Linha 1 Coluna 3 |
slaxemulator@3 272 | Linha 2 Coluna 1 | Linha mesclada (repare o pipeline duplo) ||
slaxemulator@3 273 | Linha 3 Coluna 1 | Linha 3 Coluna 2 | Linha 3 Coluna 3 |
slaxemulator@3 274
slaxemulator@3 275 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!
slaxemulator@3 276
slaxemulator@3 277 Cabeçalhos verticais também são possíveis.
slaxemulator@3 278
slaxemulator@3 279 | ^ Cabeçalho 1 ^ Cabeçalho 2 ^
slaxemulator@3 280 ^ Cabeçalho 3 | Linha 1 Coluna 3 | Linha 1 Coluna 3 |
slaxemulator@3 281 ^ Cabeçalho 4 | Sem mesclar dessa vez | |
slaxemulator@3 282 ^ Cabeçalho 5 | Linha 2 Coluna 3 | Linha 2 Coluna 3 |
slaxemulator@3 283
slaxemulator@3 284 Como você pode ver, é o separador de células anterior à célula que decide sobre a formatação:
slaxemulator@3 285
slaxemulator@3 286 | ^ Cabeçalho 1 ^ Cabeçalho 2 ^
slaxemulator@3 287 ^ Cabeçalho 3 | Linha 1 Coluna 3 | Linha 1 Coluna 3 |
slaxemulator@3 288 ^ Cabeçalho 4 | Sem mesclar dessa vez | |
slaxemulator@3 289 ^ Cabeçalho 5 | Linha 2 Coluna 3 | Linha 2 Coluna 3 |
slaxemulator@3 290
slaxemulator@3 291 Você pode conectar células verticalmente adicionando '':::'' dentro das células abaixo da qual elas devem conectar.
slaxemulator@3 292
slaxemulator@3 293 ^ Cabeçalho 1 ^ Cabeçalho 2 ^ Cabeçalho 3 ^
slaxemulator@3 294 | Linha 1 Coluna 1 | esta célula expande verticalmente | Linha 1 Coluna 3 |
slaxemulator@3 295 | Linha 2 Coluna 1 | ::: | Linha 2 Coluna 3 |
slaxemulator@3 296 | Linha 3 Coluna 1 | ::: | Linha 2 Coluna 3 |
slaxemulator@3 297
slaxemulator@3 298 Estas células não deverão conter nada além da sintaxe de conexão vertical.
slaxemulator@3 299
slaxemulator@3 300 ^ Cabeçalho 1 ^ Cabeçalho 2 ^ Cabeçalho 3 ^
slaxemulator@3 301 | Linha 1 Coluna 1 | esta célula expande verticalmente | Linha 1 Coluna 3 |
slaxemulator@3 302 | Linha 2 Coluna 1 | ::: | Linha 2 Coluna 3 |
slaxemulator@3 303 | Linha 3 Coluna 1 | ::: | Linha 2 Coluna 3 |
slaxemulator@3 304
slaxemulator@3 305 Você também pode alinhar o conteúdo da tabela apenas incluindo dois espaços no lado oposto do alinhamento: Inclua dois espaços no lado esquerdo para alinhar à direita, dois espaços a direta para alinha à esquerda e dois espaços nos dois lados para alinhamento centralizado.
slaxemulator@3 306
slaxemulator@3 307 ^ Tabela com alinhamento ^^^
slaxemulator@3 308 | direita| centro |esquerda |
slaxemulator@3 309 |esquerda | direita| centro |
slaxemulator@3 310 | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
slaxemulator@3 311
slaxemulator@3 312 Assim que aparede no código-fonte:
slaxemulator@3 313
slaxemulator@3 314 ^ Tabela com alinhamento ^^^
slaxemulator@3 315 | direita| centro |esquerda |
slaxemulator@3 316 |esquerda | direita| centro |
slaxemulator@3 317 | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
slaxemulator@3 318
slaxemulator@3 319 Nota: Alinhamento vertical não é suportado.
slaxemulator@3 320
slaxemulator@3 321 ===== Blocos não-interpretados =====
slaxemulator@3 322
slaxemulator@3 323 Se você precisar exibir um texto exatamente como ele foi digitado(sem nenhuma formatação), delimite a área com a tag ''%%<nowiki>%%'' ou simplesmente com dois caracteres percento ''<nowiki>%%</nowiki>''.
slaxemulator@3 324
slaxemulator@3 325 <nowiki>
slaxemulator@3 326 Este é um texto que contém endereços como este: http://www.Dokuwiki.com.br e **formatação**, mas nada é feito com eles.
slaxemulator@3 327 </nowiki>
slaxemulator@3 328 O mesmo acontece com %%//__este__ **texto**// com um smiley ;-)%%.
slaxemulator@3 329
slaxemulator@3 330 <nowiki>
slaxemulator@3 331 Este é um texto que contém endereços como este: http://www.Dokuwiki.com.br e **formatação**, mas nada é feito com eles.
slaxemulator@3 332 </nowiki>
slaxemulator@3 333 O mesmo acontece com %%//__este__ **texto**// com um smiley ;-)%%.
slaxemulator@3 334
slaxemulator@3 335 ===== Blocos de código =====
slaxemulator@3 336
slaxemulator@3 337 Você pode incluir blocos de código-fonte em seu documento endentando-os com dois espaços no início da linha(como nos exemplos anteriores) ou usando as tags ''code'' ou ''file''.
slaxemulator@3 338
slaxemulator@3 339 <code>
slaxemulator@3 340 Este é um código pré-formatado, todos os espaços são preservados: como <- este
slaxemulator@3 341 </code>
slaxemulator@3 342
slaxemulator@3 343 <file>
slaxemulator@3 344 Este é exatamente o mesmo mas você deve usá-lo para dizer que citou um arquivo.
slaxemulator@3 345 </file>
slaxemulator@3 346
slaxemulator@3 347 Estes blocos foram criados pelo seguinte fonte:
slaxemulator@3 348
slaxemulator@3 349 <code>
slaxemulator@3 350 Este é um código pré-formatado, todos os espaços são preservados: como <-este
slaxemulator@3 351 </code>
slaxemulator@3 352
slaxemulator@3 353 <file>
slaxemulator@3 354 Este é exatamente o mesmo mas você deve usá-lo para dizer que citou um arquivo.
slaxemulator@3 355 </file>
slaxemulator@3 356 ==== Destaque de Sintaxe ====
slaxemulator@3 357
slaxemulator@3 358 [[wiki:DokuWiki]] pode destacar códigos-fonte para facilitar a sua leitura. Ele usa o [[http://qbnz.com/highlighter/|GeSHi]] Generic Syntax Highlighter -- portanto, qualquer linguagem suportada pelo GeSHi é suportada. A sintaxe é a mesma da dos blocos de código(code) e arquivo(file) da seção anterior, mas desta vez o nome da linguagem usada é inserida dentro da tag. Ex. ''<nowiki><code java></nowiki>'' ou ''<nowiki><file java></nowiki>''.
slaxemulator@3 359
slaxemulator@3 360 <code java>
slaxemulator@3 361 /**
slaxemulator@3 362 * The HelloWorldApp class implements an application that
slaxemulator@3 363 * simply displays "Hello World!" to the standard output.
slaxemulator@3 364 */
slaxemulator@3 365 class HelloWorldApp {
slaxemulator@3 366 public static void main(String[] args) {
slaxemulator@3 367 System.out.println("Hello World!"); //Display the string.
slaxemulator@3 368 }
slaxemulator@3 369 }
slaxemulator@3 370 </code>
slaxemulator@3 371
slaxemulator@3 372 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//
slaxemulator@3 373
slaxemulator@3 374 ==== Blocos de Código Baixáveis ====
slaxemulator@3 375
slaxemulator@3 376 Quando você usa as sintaxes ''%%<code>%%'' ou ''%%<file>%%'' descritas acima, você poderá desejar que o código-fonte exibido seja disponibilizado para download. Para fazer isto vocë deve especificar o nome do arquivo após o nome da linguagem desta forma:
slaxemulator@3 377
slaxemulator@3 378 <code>
slaxemulator@3 379 <file php myexample.php>
slaxemulator@3 380 <?php echo "hello world!"; ?>
slaxemulator@3 381 </file>
slaxemulator@3 382 </code>
slaxemulator@3 383
slaxemulator@3 384 <file php myexample.php>
slaxemulator@3 385 <?php echo "hello world!"; ?>
slaxemulator@3 386 </file>
slaxemulator@3 387
slaxemulator@3 388 Se você não quiser nenhum destaque no código-fonte mas quiser que o arquivo seja baixável, inclua um traço (''-'') no lugar do nome da linguagem desta forma: ''%%<code - myfile.foo>%%''.
slaxemulator@3 389
slaxemulator@3 390
slaxemulator@3 391 ===== HTML e PHP embutido =====
slaxemulator@3 392
slaxemulator@3 393 Você pode embutir HTML e PHP puros dentro de seus documentos usando as tags ''%%<html>%%'' ou ''%%<php>%%''. (Use tags maiúsculas se você precisar incluir níveis de blocos de elementos.)
slaxemulator@3 394
slaxemulator@3 395 Exemplo em HTML:
slaxemulator@3 396
slaxemulator@3 397 <code>
slaxemulator@3 398 <html>
slaxemulator@3 399 Este é um <span style="color:red;font-size:150%;">HTML em linha</span>
slaxemulator@3 400 </html>
slaxemulator@3 401 <HTML>
slaxemulator@3 402 <p style="border:2px dashed red;">E este é um bloco HMTL</p>
slaxemulator@3 403 </HTML>
slaxemulator@3 404 </code>
slaxemulator@3 405
slaxemulator@3 406 <html>
slaxemulator@3 407 Este é um <span style="color:red;font-size:150%;">HTML em linha</span>
slaxemulator@3 408 </html>
slaxemulator@3 409 <HTML>
slaxemulator@3 410 <p style="border:2px dashed red;">E este é um bloco HMTL</p>
slaxemulator@3 411 </HTML>
slaxemulator@3 412
slaxemulator@3 413 Exemplo em PHP:
slaxemulator@3 414
slaxemulator@3 415 <code>
slaxemulator@3 416 <php>
slaxemulator@3 417 echo 'Uma logo gerada pelp PHP:';
slaxemulator@3 418 echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />';
slaxemulator@3 419 echo '(HTML gerado em linha)';
slaxemulator@3 420 </php>
slaxemulator@3 421 <PHP>
slaxemulator@3 422 echo '<table class="inline"><tr><td>O mesmo, mas dentro de um elemento de bloco de nível:</td>';
slaxemulator@3 423 echo '<td><img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" /></td>';
slaxemulator@3 424 echo '</tr></table>';
slaxemulator@3 425 </PHP>
slaxemulator@3 426 </code>
slaxemulator@3 427
slaxemulator@3 428 <php>
slaxemulator@3 429 echo 'Uma logo gerada pelp PHP:';
slaxemulator@3 430 echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />';
slaxemulator@3 431 echo '(HTML gerado em linha)';
slaxemulator@3 432 </php>
slaxemulator@3 433 <PHP>
slaxemulator@3 434 echo '<table class="inline"><tr><td>O mesmo, mas dentro de um elemento de bloco de nível:</td>';
slaxemulator@3 435 echo '<td><img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" /></td>';
slaxemulator@3 436 echo '</tr></table>';
slaxemulator@3 437 </PHP>
slaxemulator@3 438
slaxemulator@3 439 **Anote**: HTML e PHP embutidos ficam desabilitado por padrão na configuração. Se desabilitado, o código é exibido ao invés de executado.
slaxemulator@3 440
slaxemulator@3 441 ===== RSS/ATOM Feed Aggregation =====
slaxemulator@3 442 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:
slaxemulator@3 443
slaxemulator@3 444 ^ Parâmetro ^ Descrição ^
slaxemulator@3 445 | número itens | será usado como máximo de itens a serem exibidos, o padrão é 8 |
slaxemulator@3 446 | reverse | exibe os últimos itens no início na lista |
slaxemulator@3 447 | author | exibe os nome dos autores dos itens |
slaxemulator@3 448 | date | exibe as datas dos itens |
slaxemulator@3 449 | description | exibe a descrição do item. Se [[doku>wiki:config#htmlok|HTML]] estiver desabilitado todas as tags serão removidas |
slaxemulator@3 450 | //n//[dhm] | período de atualização, onde d=dias, h=horas, m=minutos. (ex. 12h = 12 horas). |
slaxemulator@3 451
slaxemulator@3 452 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.
slaxemulator@3 453
slaxemulator@3 454 **Exemplo:**
slaxemulator@3 455
slaxemulator@3 456 {{rss>http://slashdot.org/index.rss 5 author date 1h }}
slaxemulator@3 457
slaxemulator@3 458 {{rss>http://slashdot.org/index.rss 5 author date 1h }}
slaxemulator@3 459
slaxemulator@3 460 ===== Comandos de Controle =====
slaxemulator@3 461
slaxemulator@3 462 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:
slaxemulator@3 463
slaxemulator@3 464 ^ Comando ^ Descrição |
slaxemulator@3 465 | %%~~NOTOC~~%% | Se este comendo for encontrado na página, a tabela de conteúdo não será criada |
slaxemulator@3 466 | %%~~NOCACHE~~%% | O Dokuwiki faz //cache// de todas as páginas por padrão. Em alguns casos is pode não ser desejável. Adicionar esta macho forçará o Dokuwiki a interpretar a página em cada chamada. |