Diferenças
Esta página mostra as diferenças entre as duas revisões da página.
| pt:wiki:syntax [22/02/2011 23:41] – Criação deste novo documento. jpc | pt:wiki:syntax [22/02/2011 23:42] (Atual) – jpc | ||
|---|---|---|---|
| Linha 1: | Linha 1: | ||
| - | ====== | + | ====== |
| - | [[doku> | + | O Dokuwiki suporta algumas linguagens de marcação bem simples, |
| - | Leia o [[doku> | + | ===== Formatação Básica de Texto ===== |
| - | ===== Download ===== | + | O Dokuwiki suporta textos em **negrito**, |
| - | O DokuWiki está disponível | + | |
| + | | ||
| + | Obviamente você poderá **__//'' | ||
| + | todas elas. | ||
| - | ===== Leia Mais ===== | + | Você também pode usar < |
| - | Toda documentação | + | Você também pode usar < |
| - | **Sobre o DokuWiki** | + | Você poderá marcar algo como < |
| - | | + | |
| - | * [[doku>users|Usuários Felizes]] | + | |
| - | * [[doku> | + | |
| - | * [[doku> | + | |
| - | * [[http:// | + | |
| - | **Instalando o DokuWiki** | + | **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. |
| - | * [[doku> | + | Este é um texto com algumas quebras |
| - | * [[http:// | + | duas contra-barras são reconhecidas apenas no fim da linha\\ |
| - | * [[doku> | + | ou seguidas por\\ um espaço \\isto que acontece sem o espaço. |
| - | * [[doku> | + | |
| - | * [[doku> | + | |
| - | **Usando | + | Este é um texto com algumas quebras de linha\\ Note que as |
| + | duas contra-barras são reconhecidas apenas no fim da linha\\ | ||
| + | ou seguidas por\\ um espaço \\isto que acontece sem o espaço. | ||
| - | * [[doku> | + | Você deve forçar as quebras de linha apenas quando necessário. |
| - | * [[doku> | + | |
| - | * [[doku> | + | |
| - | * [[doku> | + | |
| - | * [[http:// | + | |
| - | **Personalizando o DokuWiki** | + | ===== Links ===== |
| - | * [[doku> | + | O Dokuwiki suporta múltiplas formas de criar links(ligações entre páginas). |
| - | * [[doku> | + | |
| - | * [[doku> | + | |
| - | * [[doku> | + | |
| - | **Feedback e Comunidade do DokuWiki** | + | ==== Externos ==== |
| - | * [[doku> | + | Links externos são reconhecidos automaticamente: http://www.google.com ou simplesmente www.google.com - Você também pode nomear os links: |
| - | * [[doku> | + | |
| - | * [[http://forum.dokuwiki.org|Confira o fórum de usuários]] | + | |
| - | * [[doku> | + | |
| - | * [[http://bugs.splitbrain.org/ | + | |
| - | * [[http:// | + | |
| - | * [[doku> | + | |
| - | ===== Copyright ===== | + | Links externos são reconhecidos automaticamente: |
| + | ou simplesmente www.google.com - Você também pode nomear os links: | ||
| + | [[http:// | ||
| + | Endereços de e-mail como este: < | ||
| + | também são reconhecidos automaticamente. | ||
| - | 2004-2010 (c) Andreas Gohr < | + | ==== Internos ==== |
| - | O motor DokuWiki está licenciado sob a licença //[[http:// | + | Links internos são criados usando colchetes. Você pode apenas fornecer o |
| - | Não tem certeza | + | Links internos são criados usando colchetes. Você pode apenas fornecer |
| + | | ||
| + | [[doku> | ||
| + | wiki são convertidos para minúsculo automaticamente e | ||
| + | caracteres especiais(espaço, | ||
| + | Você pode usar [[namespaces]] incluindo dois-pontos no nome da página. | ||
| + | |||
| + | Você pode usar [[namespaces]] incluindo dois-pontos | ||
| + | no nome da página. | ||
| + | |||
| + | // | ||
| + | [[namespaces|Clique aqui]] para saber mais sobre [[namespaces]]. | ||
| + | |||
| + | É possível apontar um link para uma seção específica. Basta adicionar o nome da seção após um caractere de cerquilha(# | ||
| + | |||
| + | Este link aponta para [[pt-br: | ||
| + | |||
| + | Notas: | ||
| + | |||
| + | * Links para [[pt-br: | ||
| + | * 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:// | ||
| + | |||
| + | Favor observar: A formatação de imagem é a única sintaxe de formatação aceita nos nomes de links. | ||
| + | |||
| + | 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 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 ''< | ||
| + | |||
| + | ==== Título Nível 3 ==== | ||
| + | === Título Nível 4 === | ||
| + | == Título Nível 5 == | ||
| + | |||
| + | ==== Título Nível 3 ==== | ||
| + | === Título Nível 4 === | ||
| + | == Título Nível 5 == | ||
| + | |||
| + | Usando quatro ou mais traços, você poderá incluir uma linha horizontal: | ||
| + | |||
| + | ---- | ||
| + | |||
| + | ===== 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 é uma imagem('' | ||
| + | |||
| + | Para linkar uma umagem para outra página, veja o tópico [[#Links com Imagens]] acima. | ||
| + | |||
| + | ===== Lists ===== | ||
| + | |||
| + | 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 '' | ||
| + | |||
| + | * 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 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 converte os [[wp> | ||
| + | |||
| + | O Dokuwiki converte 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 ===== | ||
| + | |||
| + | Em alguns casos você precisará marcar textos para serem exibidos em uma resposta ou comentário. Você pode usar a seguinte sintaxe: | ||
| + | |||
| + | 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 terminas 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 apenas incluindo dois espaços no lado oposto do alinhamento: | ||
| + | |||
| + | ^ | ||
| + | | | ||
| + | |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 exatamente como ele foi digitado(sem nenhuma formatação), | ||
| + | |||
| + | < | ||
| + | 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 myexample.php> | ||
| + | <?php echo "hello world!"; | ||
| + | </ | ||
| + | </ | ||
| + | |||
| + | <file php myexample.php> | ||
| + | <?php echo "hello world!"; | ||
| + | </ | ||
| + | |||
| + | Se você não quiser nenhum destaque no código-fonte mas quiser que o arquivo seja baixável, inclua um traço ('' | ||
| + | |||
| + | |||
| + | ===== 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 '</ | ||
| + | </ | ||
| + | |||
| + | **Anote**: HTML e PHP embutidos ficam desabilitado por padrão na configuração. Se desabilitado, | ||
| + | |||
| + | ===== 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 esta macho forçará o Dokuwiki a interpretar a página em cada chamada. | | ||