wiki:LinkExchangeИTrac
Last modified 11 months ago

LinkExchange и Trac

Для использования LinkExchange в  Trac необходимо выполнить следующее:

  1. Включить компонент linkexchange.trac.plugin.linkexchangeplugin в конфигурации окружения Trac.
  2. Создать файл конфигурации conf/linkexchange.cfg.
  3. В шаблонах использовать переменную linkexchange_blocks, которая содержит список блоков ссылок для размещения на странице.

Замечание: данный способ предполагает Trac >= 0.11.

Фрагмент файла конфигурации conf/trac.ini для примера: 

[components]
linkexchange.trac.plugin.linkexchangeplugin = enabled

Пример конфигурации conf/linkexchange.cfg: 

[client-1]
type = sape
user = user12345
db_driver.type = shelve
db_driver.filename = %(envdir)s/sape-XXX.db

[client-2]
type = linkfeed
user = user12345
db_driver.type = shelve
db_driver.filename = %(envdir)s/linkfeed-XXX.db

[formatter-1]
type = list
count = 2
class_ = linx
prefix = "- "
suffix = ". "

[formatter-2]
type = inline
count = 2
class_ = linx
delimiter = " | "
prolog = "| "
epilog = " |"

[formatter-3]
type = list
count = none
class_ = linx
prefix = "+ "
suffix = ". "

Фрагмент пользовательского шаблона templates/site.html для примера: 

<body py:match="body" py:attrs="select('@*')">
  ${select('*|text()')}
  <div py:if="defined('linkexchange_blocks')" py:replace="${Markup(linkexchange_blocks[0])}"/>
</body>

Контекстные ссылки

Для использование контекстных ссылок нужно сделать следующее:

  1. Включить компонент linkexchange.trac.plugin.linkexchangeplugin в конфигурации окружения Trac.
  2. Создать файл конфигурации conf/linkexchange.cfg, в котором определить клиент sape_context, а также в разделе [options] указать content_filtering = true.

Опции конфигурационного файла

content_filtering
Если true, включить фильтрацию контента на страницах. По умолчанию false.
filter_template_match
Фильтровать контент только если используемый файл шаблона соответствует данному регулярному выражению. По умолчанию ^wiki_view\.html$, что разрешает фильтрацию только на страницах вики.
use_raw_links
Значение true устанавливает переменную шаблона linkexchange_links со списком необработанных ссылок для текущей страницы. По умолчанию false.