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

Trac Links

Table of Contents

Como você deve ter adivinhado, TracLinks é uma funcionalidade fundamental do Trac.

Eles permitem criar hyperlinks entre entidades do Trac (tickets, relatórios, changesets, páginas Wiki, milestones e arquivos-fonte) em qualquer lugar onde o WikiFormatting é usado.

TracLinks são geralmente da forma item:id (onde id representa o número, nome ou caminho do item) embora alguns tipos de itens frequentemente usados tambem têm abreviações, alternativas, notações.

Alguns exemplos:

  • 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

Demonstração:

Lembrete: O formulário wiki:CamelCase é raramente usado, mas ele pode ser conveniente para referir-se à páginas cujo os nomes não seguem as regras do WikiPageNames, isto é, palavras simples, caracteres não alfabéticos, etc.

Trac links using the full (non-shorthand) notation can also be given a custom link title like this:------------ 

[ticket:1 Esse é um atalho para o ticket número 1].

É mostrado:

Esse é um atalho para o ticket número 1.

Isso pode ser visto como um simples conceito suficiente, mas atualmente permite uma complexa rede de informações.

Porém, na prática isso é muito intuitivo e simples de usar e nós achamos o "rastro do link(atalho)" extremamente útil para o melhor entendimento do que está acontecendo em um projeto ou porque uma particular mudança foi feita.

O comportamento padrão para um fonte:/algo/caminho link é abrir diretório se o caminho aponta para um diretório, caso contrário deve apresentar um log. É também possível ligar diretamente para uma específica revisão de um arquivo como este: fonte:/algo/arquivo#123 ou como esse para ligar para a última revisão: fonte:/algo/arquivo#última.

Você pode usar TrackLinks? em:

  • Código fonte (Subversion) mensagens submetidas(commit)
  • Páginas Wikis
  • Descrição completa de tickets, relatórios e milestones

e qualquer outros campos de texto explicitamente marcados para suportar WikiFormatting.

TracLinks de escape

Para impedir um parsing de um TrackLink, você pode retirar isso precedendo o TrackLink com uma '!' (sinal de exclamação) 

 !NoLinkHere.
 ![42] tambem não é um link.

Display:

NoLinkHere. [42] tambem não é um link.

Visite também: WikiFormatting, TracWiki