pt-br: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 | ||
pt-br:wiki:syntax [2015-11-11 19:17] – 201.77.112.33 | pt-br:wiki:syntax [2023-05-23 21:17] (atual) – [Sintaxe de Formatação] nerun | ||
---|---|---|---|
Linha 1: | Linha 1: | ||
- | Boa tarde, pensei | + | ====== Sintaxe de Formatação ====== |
+ | O Dokuwiki suporta algumas linguagens de marcação bem simples | ||
+ | ===== 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 [[: | ||
+ | ====== 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: | ||
+ | |||
+ | < | ||
+ | {{: | ||
+ | </ | ||
+ | |||
+ | |||
+ | ==== Formatos de Mídia Suportados ==== | ||
+ | |||
+ | O Wiki pode embutir os seguintes formatos de mídia diretamente. | ||
+ | |||
+ | | Imagem | '' | ||
+ | | Video | '' | ||
+ | | Áudio | ||
+ | | Flash | '' | ||
+ | |||
+ | Se você especificar um nome de arquivo que não é suportado, então ele será exibido como um link. | ||
+ | |||
+ | Adicionando ''? | ||
+ | |||
+ | {{wiki: | ||
+ | |||
+ | {{wiki: | ||
+ | |||
+ | ==== Formatos Avançados ==== | ||
+ | |||
+ | Infelizmente nem todos os navegadores entendem todos os formatos de videos e de áudio. Para mitigar este problema, você pode enviar diferentes formatos para o máximo de compatibilidade dos navegadores. | ||
+ | |||
+ | Por exemplo, considere este vídeo embutido: | ||
+ | |||
+ | {{video.mp4|Um vídeo engraçado}} | ||
+ | |||
+ | Quando você faz o upload de um '' | ||
+ | |||
+ | Além disso, o DokuWiki suporta uma imagem " | ||
+ | |||
+ | |||
+ | ===== 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 nós deveríamos fazer isto | ||
+ | | ||
+ | > Não, não deveríamos | ||
+ | | ||
+ | >> Bem, eu disse que nós deveríamos | ||
+ | | ||
+ | > Realmente? | ||
+ | | ||
+ | >> Sim! | ||
+ | | ||
+ | >>> | ||
+ | |||
+ | Eu pensei que nós 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: | ||
+ | |||
+ | Existem [[doku> | ||
+ | ==== 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// | 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 em //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íodo 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~~%% |
pt-br/wiki/syntax.txt · Última modificação: 2023-05-23 21:17 por nerun