[2024-feb-29] Sad news: Eric Layton aka Nocturnal Slacker aka vtel57 passed away on Feb 26th, shortly after hospitalization. He was one of our Wiki's most prominent admins. He will be missed.
no way to compare when less than two revisions
Diferenças
Aqui você vê as diferenças entre duas revisões dessa página.
— | pt-br:wiki:syntax [2013/01/12 20:42 (UTC)] (atual) – criada (https://www.dokuwiki.org/pt-br:wiki:syntax) alienbob | ||
---|---|---|---|
Linha 1: | Linha 1: | ||
+ | ====== Sintaxe de Formatação ====== | ||
+ | O Dokuwiki suporta algumas linguagens de marcação bem simples que 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. Veja o código-fonte, | ||
+ | ===== Formatação Básica de Texto ===== | ||
+ | O Dokuwiki suporta textos em **negrito**, | ||
+ | O Dokuwiki suporta textos em **negrito**, | ||
+ | // | ||
+ | Obviamente, você poderá **__//'' | ||
+ | todos os formatos. | ||
+ | |||
+ | Você também pode usar < | ||
+ | |||
+ | Você também pode usar < | ||
+ | |||
+ | Você poderá marcar algo como < | ||
+ | |||
+ | Você poderá marcar algo como < | ||
+ | |||
+ | **Parágrafos** são criados a partir de linhas em branco. Se quiser **forçar a quebra de linha** sem um novo parágrafo, você poderá usar duas barras (\\) seguidas do fim da linha ou de um espaço em branco. | ||
+ | |||
+ | Este é um texto com algumas quebras de linha\\ Note que as | ||
+ | duas barras (\\) são reconhecidas apenas no fim da linha\\ | ||
+ | ou seguidas por\\ um espaço \\isto que acontece sem o espaço. | ||
+ | |||
+ | Este é um texto com algumas quebras de linha\\ Note que as | ||
+ | duas barras (\\) são reconhecidas apenas no fim da linha\\ | ||
+ | ou seguidas por\\ um espaço \\isto que acontece sem o espaço. | ||
+ | |||
+ | Você deve forçar as quebras de linha apenas quando necessário. | ||
+ | ===== Links ===== | ||
+ | O Dokuwiki suporta múltiplas formas de criar ligações entre páginas (links). | ||
+ | ==== Externos ==== | ||
+ | Links externos são reconhecidos automaticamente: | ||
+ | |||
+ | Links externos são reconhecidos automaticamente: | ||
+ | ou simplesmente www.google.com - Você também pode rotular os links: | ||
+ | [[http:// | ||
+ | Endereços de e-mail como este: < | ||
+ | também são reconhecidos automaticamente. | ||
+ | ==== Internos ==== | ||
+ | Links internos são criados usando colchetes. Você pode apenas fornecer o [[pagename|nome da página]] ou usar uma descrição adicional [[pagename|Título da Página]]. Os nomes das páginas wiki são convertidos para minúsculo automaticamente e caracteres especiais(espaço, | ||
+ | |||
+ | Links internos são criados usando colchetes. Você pode apenas fornecer | ||
+ | o [[doku> | ||
+ | [[doku> | ||
+ | wiki são convertidos para minúsculo automaticamente e | ||
+ | caracteres especiais(espaço, | ||
+ | |||
+ | Você pode usar [[namespaces: | ||
+ | |||
+ | Você pode usar [[namespaces: | ||
+ | |||
+ | // | ||
+ | [[namespaces|Clique aqui]] para saber mais sobre [[namespaces]]. | ||
+ | |||
+ | É possível apontar um link para uma seção específica da página. Basta adicionar o nome da seção após um caractere de cerquilha (#) igual como é no HTML. Este link aponta para [[# | ||
+ | |||
+ | Este link aponta para [[# | ||
+ | |||
+ | Notas: | ||
+ | |||
+ | * Links para [[pt-br: | ||
+ | * Seções são iniciadas por parágrafos. Uma linha qualquer de texto não serve de destino de um link interno. | ||
+ | * 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. | ||
+ | ==== Interwiki ==== | ||
+ | |||
+ | O Dokuwiki suporta links [[doku> | ||
+ | |||
+ | O Dokuwiki suporta links [[doku> | ||
+ | links rápidos com outros wikis. Este é um exemplo de link para a | ||
+ | página sobre Wikis da Wikipedia: [[wp> | ||
+ | ==== Links com Imagens ==== | ||
+ | Você também poderá usar uma imagem para linkar outra página interna ou externa combinando a sintaxe de links e de [[# | ||
+ | |||
+ | [[http:// | ||
+ | |||
+ | [[http:// | ||
+ | |||
+ | **Importante**: | ||
+ | |||
+ | A sintaxe completa de [[# | ||
+ | ===== Notas de Rodapé ===== | ||
+ | Você pode adicionar notas de rodapé ((Isto é uma nota de rodapé)) usando parênteses duplos. | ||
+ | |||
+ | Você pode adicionar notas de rodapé ((Isto é uma nota de rodapé)) | ||
+ | usando parênteses duplos. | ||
+ | ===== Seções ===== | ||
+ | Você pode usar até cinco diferentes níveis de títulos para estruturar o conteúdo. Com 3 ou mais níveis será automaticamente gerada uma Tabela de Conteúdos visível à direita do topo da página. A Tabela de Conteúdos | ||
+ | |||
+ | O documento [[https:// | ||
+ | ====== Título de nível 1 ====== | ||
+ | ===== Título de nível 2 ===== | ||
+ | ==== Título de nível 3 ==== | ||
+ | === Título de nível 4 === | ||
+ | == Título de nível 5 == | ||
+ | |||
+ | ====== Título de nível 1 ====== | ||
+ | ===== Título de nível 2 ===== | ||
+ | ==== Título de nível 3 ==== | ||
+ | === Título de nível 4 === | ||
+ | == Título de nível 5 == | ||
+ | |||
+ | Para incluir uma linha horizontal como a abaixo digite 4 ou mais traços: | ||
+ | |||
+ | ---- | ||
+ | ===== Imagens e Outros Arquivos ===== | ||
+ | Você pode incluir [[doku> | ||
+ | |||
+ | Tamanho real: {{wiki: | ||
+ | |||
+ | Tamanho personalizado: | ||
+ | |||
+ | 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)): | ||
+ | |||
+ | Imagem externa redimensionada: | ||
+ | |||
+ | Tamanho Real: | ||
+ | Redimensionada para uma largura específica: | ||
+ | Redimensionada para uma altura específica: | ||
+ | Imagem externa redimensionada: | ||
+ | |||
+ | Usando espaços em branco na direita e na esquerda, você poderá mudar o alinhamento: | ||
+ | |||
+ | {{ wiki: | ||
+ | |||
+ | {{wiki: | ||
+ | |||
+ | {{ wiki: | ||
+ | |||
+ | {{ wiki: | ||
+ | {{wiki: | ||
+ | {{ wiki: | ||
+ | |||
+ | 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). | ||
+ | |||
+ | {{ wiki: | ||
+ | |||
+ | {{ wiki: | ||
+ | |||
+ | Se você especificar um nome de arquivo (externo ou interno) que não seja uma imagem ('' | ||
+ | |||
+ | Para linkar uma imagem para outra página, veja o tópico [[#Links com Imagens]] acima. | ||
+ | ==== Arquivos PDF ==== | ||
+ | Para abrir arquivos PDF, execute primeiro o upload com o Media Manager, programe a referência semelhante à das imagens. Por exemplo, se foi feito o upload do arquivo manual.pdf para \media\pdf, assim ficará a referência: | ||
+ | |||
+ | < | ||
+ | {{: | ||
+ | </ | ||
+ | ===== 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 '' | ||
+ | |||
+ | * 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> | ||
+ | ===== Conversões de Texto ===== | ||
+ | O [[doku> | ||
+ | |||
+ | 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> | ||
+ | * 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: | ||
+ | |||
+ | -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) | ||
+ | "Ele disse: ' | ||
+ | |||
+ | < | ||
+ | -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) | ||
+ | "Ele disse: ' | ||
+ | </ | ||
+ | ===== 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! | ||
+ | | ||
+ | >>> | ||
+ | |||
+ | Eu pensei que nos deveríamos fazer isto | ||
+ | |||
+ | > Não, não deveríamos | ||
+ | |||
+ | >> Bem, eu disse que nós deveríamos | ||
+ | |||
+ | |||
+ | > Realmente? | ||
+ | |||
+ | >> Sim! | ||
+ | |||
+ | >>> | ||
+ | ===== 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 '' | ||
+ | |||
+ | ^ 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, | ||
+ | |||
+ | 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 '':::'' | ||
+ | |||
+ | ^ Cabeçalho 1 ^ Cabeçalho | ||
+ | | Linha 1 Coluna 1 | esta célula expande verticalmente | ||
+ | | 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 | ||
+ | | Linha 1 Coluna 1 | esta célula expande verticalmente | ||
+ | | 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. | ||
+ | |||
+ | ^ | ||
+ | | | ||
+ | |esquerda | ||
+ | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | | ||
+ | |||
+ | Assim que aparede no código-fonte: | ||
+ | |||
+ | ^ | ||
+ | | | ||
+ | |esquerda | ||
+ | | 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 texto que contém endereços como este: http:// | ||
+ | </ | ||
+ | O mesmo acontece com %%// | ||
+ | |||
+ | < | ||
+ | Este é um texto que contém endereços como este: http:// | ||
+ | </ | ||
+ | O mesmo acontece com %%// | ||
+ | ===== Blocos de código ===== | ||
+ | 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 '' | ||
+ | |||
+ | < | ||
+ | Este é um código pré-formatado, | ||
+ | </ | ||
+ | |||
+ | < | ||
+ | Este é exatamente o mesmo mas você deve usá-lo para dizer que citou um arquivo. | ||
+ | </ | ||
+ | |||
+ | Estes blocos foram criados pelo seguinte fonte: | ||
+ | |||
+ | < | ||
+ | Este é um código pré-formatado, | ||
+ | </ | ||
+ | |||
+ | < | ||
+ | Este é exatamente o mesmo mas você deve usá-lo para dizer que citou um arquivo. | ||
+ | </ | ||
+ | ==== Destaque de Sintaxe ==== | ||
+ | [[wiki: | ||
+ | |||
+ | <code java> | ||
+ | /** | ||
+ | * The HelloWorldApp class implements an application that | ||
+ | * simply displays "Hello World!" | ||
+ | */ | ||
+ | class HelloWorldApp { | ||
+ | public static void main(String[] args) { | ||
+ | System.out.println(" | ||
+ | } | ||
+ | } | ||
+ | </ | ||
+ | |||
+ | As seguintes linguagens são reconhecidas: | ||
+ | ==== Blocos de Código Baixáveis ==== | ||
+ | Quando você usa as sintaxes '' | ||
+ | |||
+ | < | ||
+ | <file php exemplo.php> | ||
+ | <?php echo "hello world!"; | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | <file php exemplo.php> | ||
+ | <?php echo "hello world!"; | ||
+ | </ | ||
+ | |||
+ | 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 ('' | ||
+ | |||
+ | < | ||
+ | <file - exemplo.php> | ||
+ | <?php echo "hello world!"; | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | <file - exemplo.php> | ||
+ | <?php echo "hello world!"; | ||
+ | </ | ||
+ | |||
+ | |||
+ | ===== HTML e PHP embutido ===== | ||
+ | Você pode embutir HTML e PHP puros dentro de seus documentos usando as tags '' | ||
+ | |||
+ | Exemplo em HTML: | ||
+ | |||
+ | < | ||
+ | < | ||
+ | Este é um <span style=" | ||
+ | </ | ||
+ | < | ||
+ | <p style=" | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | < | ||
+ | Este é um <span style=" | ||
+ | </ | ||
+ | < | ||
+ | <p style=" | ||
+ | </ | ||
+ | |||
+ | Exemplo em PHP: | ||
+ | |||
+ | < | ||
+ | <php> | ||
+ | echo 'Uma logo gerada pelp PHP:'; | ||
+ | echo '< | ||
+ | echo '(HTML gerado em linha)'; | ||
+ | </ | ||
+ | <PHP> | ||
+ | echo '< | ||
+ | echo '< | ||
+ | echo '</ | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | <php> | ||
+ | echo 'Uma logo gerada pelp PHP:'; | ||
+ | echo '< | ||
+ | echo '(HTML gerado em linha)'; | ||
+ | </ | ||
+ | <PHP> | ||
+ | echo '< | ||
+ | echo '< | ||
+ | echo '</ | ||
+ | </ | ||
+ | |||
+ | **Nota:** HTML e PHP embutidos ficam desabilitados por padrão na configuração. Quando desabilitados, | ||
+ | ===== RSS/ATOM Feed Aggregation ===== | ||
+ | O Dokuwiki pode integrar com dados externos de XML feeds. O [[http:// | ||
+ | |||
+ | ^ Parâmetro | ||
+ | | número itens | será usado como máximo de itens a serem exibidos, o padrão é 8 | | ||
+ | | reverse | ||
+ | | author | ||
+ | | date | exibe as datas dos itens | | ||
+ | | description | ||
+ | | // | ||
+ | |||
+ | 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// | ||
+ | |||
+ | **Exemplo: | ||
+ | |||
+ | {{rss> | ||
+ | |||
+ | {{rss> | ||
+ | ===== 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 | ||
+ | | %%~~NOTOC~~%% | ||
+ | | %%~~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. | |