Home Page do Portal
Brasil, um país de todos

WikiFormatting

Table of Contents

A formatação do Wiki é uma característica fundamental do Trac, intimamente integrado com todas as outras partes do Trac, formando um conjunto flexível e poderoso.

Trac tem uma ferramenta integrada para criação de wikis que é pequena e poderosa. Esta ferramenta wiki implementa especialmente um crescente subconjunto de comandos de outros Wikis populares MoinWiki.

Esta página demonstra a sintaxe de formatação disponível onde o WikiFormatting pode ser usado.

Estilos de fontes

O wiki do Trac suporta os seguintes estilos de fontes: negrito, itálico, sublinhado e rasura. 

O wiki do Trac suporta os seguintes estilos de fontes: '''negrito''', ''itálico'',
__sublinhado__ e ~~rasura~~.

Cabeçalho

Você pode criar cabeçalho começando uma linha com um até cinco sinais de igual '=' seguido de um espaço em branco e o texto do cabeçalho. A linha deverá ser terminda com um espaço em branco seguido pelo mesmo número sinais de igual.

Lembrete: Como na escrita, cabeçalhos não podem conter TracLinks.

Exemplo:

= Cabeçalho =
== Subcabeçalho ==

Parágrafos

Um novo parágrafo de texto começa sempre que dois blocos de texto estão separados por uma ou mais linhas em branco.

Uma forma de forçar a quebra de linha pode ser : 

Linha 1[[BR]]Linha 2

Demonstração:

Linha 1
Linha 2

Parágrafos podem ser edentados para começarem as linhas com dois ou mais espaços.

Listas

O wiki suporta listas ordenadas,numeradas e desordenadas.

Exemplo: 

 * Item 1
   * Item 1.1
 * Item 2

 1. Item 1
   1. Item 1.1
 1. Item 2

Demonstração:

  • Item 1
    • Item 1.1
  • Item 2
  1. Item 1
    1. Item 1.1
  2. Item 2

Texto pré-formadado

Bloco de citações, textos pré-formatados, são alterados para pedaços de código-fonte,notas e exemplos. Use três chaves envolvendo o texto para definir um bloco de citação: Exemplo: 

 {{{
  def HelloWorld()
      print "Hello World"
 }}}

Demonstração: 

 def HelloWorld()
     print "Hello World"

Tabelas

Tabelas simples podem ser criadas como esta: 

||Cell 1||Cell 2||Cell 3||
||Cell 4||Cell 5||Cell 6||

Demonstração:

Cell 1Cell 2Cell 3
Cell 4Cell 5Cell 6

!Hyperlinks e urls são automaticamente criados pelo WikiPageNames. WikiPageLinks podem ser desativados pelo uso de um sinal de exclamação como em !WikiPageLink.

Exemplos:

TitleIndex, http://www.edgewall.com/.

Links podem possuir títulos de descrição, basta escrever o link seguido de um espaço e um título e tudo isso entre dois colchetes. Igual à: 

 * [http://www.edgewall.com/ Edgewall Software]
 * [wiki:TitleIndex Title Index]

Demonstração:

Páginas Wiki podem ser ligadas diretamente com outra parte do sistema do Trac. As páginas podem fazer referências à tickets, relatórios, changesets, milestones, arquivos fontes e outras páginas Wiki, usando a seguinte notação:

  • Tickets: #1 or ticket:1
  • Reports: {1} or report:1
  • Changesets: [1] or changeset:1
  • Wiki pages: CamelCase or wiki:CamelCase
  • Milestones: milestone:1.0
  • Files: source:trunk/COPYING
  • A specific file revision: source:/trunk/COPYING#200

Demonstração:

Veja TracLinks para mais informações.

Links de escape e WikiNames?

Você pode evitar fazer hyperlinks fora do TracLinks. Basta preceder uma expressão com um simples '!' (sinal de exclamação). 

 !NoHyperLink
 !#42 is not a link

Demonstração:

NoHyperLink #42 is not a link

Imagens

Urls terminadas com .png, .gif ou .jpg são automaticamente interpretadas como links para imagens, e serão convertidas para IMG tags.

Exemplo: 

http://www.edgewall.com/gfx/trac_example_image.png

Demonstração:

http://www.edgewall.com/gfx/trac_example_image.png

Macros

Macros são funções customisadas para inserção de conteúdo dinâmico em uma página. Para o uso de macros visite WikiMacros.

Exemplo: 

 [[Timestamp]]

Demonstração:

Sun Jun 1 12:17:16 2008

Processos

Trac suporta formatos alternativos usando o WikiProcessors. Por exemplo, interpretadores são usados para escrever páginas in reStructuredText ou HTML.

Para mais informações visite WikiProcessors.

Exemplo 1: 

{{{
#!html
<h1 style="text-align: right; color: blue">HTML Test</h1>
}}}

Demonstração:

HTML Test

Exemplo 2: 

{{{
#!python
class Test:
    def __init__(self):
        print "Hello World"
if __name__ == '__main__':
   Test()
}}}

Demonstração: 

class Test:
    def __init__(self):
        print "Hello World"
if __name__ == '__main__':
   Test()

Miscellaneous

Quatro ou mais hífens são substituidos por uma linha horizontal (<HR>) 

 ----

Demonstração:

Veja também: TracLinks, TracGuide, WikiHtml, WikiMacros, WikiProcessors, TracSyntaxColoring.