Edgewall Software

Trac Links Ru

Как вы могли догадаться, TracLinks - это важная особенность Trac.

Trac позволяет делать ссылки на различные объекты (карточки, отчёты, ревизии, страницы Wiki, этапы и исходные файлы) из любого места, где используются правила форматирования WikiFormatting.

TracLinks обычно имеют форму item:id (где id представляет номер, имя или путь объекта), хотя некоторые часто используемые виды объектов могут иметь дополнительные краткие формы записи.

Примеры указаний:

  • 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

Покажут:

Внимание: Форма записи wiki:CamelCase используется нечасто, но может быть удобной для ссылок на страницы, имена которых не следуют правилам WikiPageNames, то есть состоят из одиночных слов, неалфавитных символов и т.д.

Ссылки с использованием полного синтаксиса могут быть использованы также для указания названия ссылки вручную, например: 

[ticket:1 Это ссылка на карточку номер 1].

Покажет:

Это ссылка на карточку номер 1.

На первый взгляд это может показаться достаточно простым, но на самом деле позволяет иметь гибкий набор связанных данных.

На практике такой синтаксис является интуитивно простым в использовании, и мы (разработчики) находим "ссылки с названиями" (link trail) мощным подспорьем в понимании того, что произошло в проекте, и почему были сделаны конкретные изменения.

По умолчанию ссылки source:/some/path открывают браузер репозитория, если путь указывает на каталог. Иначе открывается просмотр истории изменений файла. Есть возможность ссылаться прямо на заданную ревизию файла: source:/some/file#123 или сразу на последнюю ревизию: source:/some/file#latest

Вы можете использовать их в:

  • Сообщениях коммитов (в Subversion)
  • Страницах Wiki
  • Полных описаниях карточек, отчётах и этапах

а также в любом другом текстовом поле, для которого указана поддержка WikiFormatting.

Во избежание обработки TracLink как ссылок вы можете предварять их символом '!' (знак восклицания). Например: 

 !НеНадоСсылок.
 ![42] никуда не ссылается.

Покажет:

НеНадоСсылок. [42] никуда не ссылается.

See also: WikiFormatting, TracWiki
See also (russian): TracTermsRu