ВикиТропы

Пожалуйста, экспериментируйте в песочнице!

авторам (основы) С помощью ВикиТроп вы можете связывать серии вики страниц в цепочку.

Прокладывание маршрута

Всё начинается с создания "страницы маршрута". На ней размещается маркированый или пронумерованый список пунктов тропы, где пунктами тропы выступают ссылки на вики страницы. Эти ссылки должны располагаться в строках сразу после маркеров списка.

Пример страницы маршрута: список вроде

    
    * [[СтраницаТропы1]]
    * Просто текст.
    * [[СтраницаТропы2]]
    ** [[СтраницаТропы3]]
    ** [[СтраницаТропы4]] какие-то слова [[Посторонняя страница]]
    ** Ещё несколько слов. [[Другая посторонняя страница]] 
    ** %center%[[возможноСтраницаТропы ]]

образует следующую "викитропу":

СтраницаТропы1 <-> СтраницаТропы2 <-> СтраницаТропы3 <-> СтраницаТропы4

Наблюдения:

  1. Уровень отступа в списке страниц значения не имеет. Тропы -- это линейная последовательность страниц.
  2. Страница становится частью маршрута только, если ссылка стоит сразу за маркером.

Использование троп

"Прокладывание маршрута" ничего собственно и не создаёт -- любая страница с нумероваными или маркироваными списками неявно описывает тропу. Что делает тропу "посещаемой" так это добавление разметки троп на страницы тропы (т.е. страницы перечисленые в маркированом/нумерованом списке).

Чтобы проложить тропу добавьте на страницу специальную разметку тропы -- <<|[[СтраницаМаршрута]]|>>, где СтраницаМаршрута -- страница содержащая список страниц маршрута. PmWiki покажет эту разметку с ссылками на предыдущую и следующие страницы тропы. Такая разметка может быть размещена в любом месте страницы, и более того на странице может быть несколько разметок троп. Если вы добавляете тропу на все страницы группы, то вместо того, чтобы исправлять каждую страницу рассмотрите возможность поместить разметку на страницу Group Header или GroupFooter.

PmWiki понимает два типа разметки троп:

  • <<|[[СтраницаМаршрута]]|>> показывается как "<< ПредыдущаяСтраница | СтраницаМаршрута | СледующаяСтраница >>".
  • <|[[СтраницаМаршрута]]|> выглядит как "< ПредыдущаяСтраница | СтраницаМаршрута | СледующаяСтраница >" с той лишь разницей, что на крайних страницах лишний символ стрелки показан не будет.

Ветвь тропы

^|[[СтраницаМаршрута]]|^ трактует уровни списка как иерархию и показывает путь для достижения текущей страницы (вроде путеводной нити). В примере маршрута выше разметка ^|СтраницаМаршрута|^ на странице СтраницаТропы4 будет показана как "СтраницаМаршрута | СтраницаТропы2 | СтраницаТропы4".

Администраторы вики могут изменить изначальные разделители "ветви" тропы ( ^|[[СтраницаМаршрута]]|^ ). Установка переменной $TrailPathSep в файле config.php в значение к примеру ' > ' ($TrailPathSep = ' > ';) даст вот такой внешний вид: "СтраницаМаршрута > СтраницаТропы2 > СтраницаТропы4".

Кольцевые тропы

Традиционно, тропа это прямой список с первой и последней страницей. Однако, тропу можно "зациклить" повторив первую страницу в конце списка маршрута:

    
    * [[СтраницаТропы1]]
    * [[СтраницаТропы2]]
    ...
    * [[СтраницаТропыN]]
    * [[СтраницаТропы1]]

Если страница маршрута предназначена для просмотра, последний элемент списка может быть спрятан с помощью стиля %item comment%:

    
    * [[СтраницаТропы1]]
    * [[СтраницаТропы2]]
    ...
    * [[СтраницаТропыN]]
    * [[СтраницаТропы1]] %item comment%

Тропы между группами

Указатели страниц маршрута в местах пересечения границ групп должны быть полными, т.е. включать имя группы (например, в формате Группа.Страница или Группа/Страница).

Другие примечания

Разметка %trail% используемая на многих страницах документации PmWiki является просто ВикиСтилем который делает фон серого цвета и не требуется для работы ВикиТропы. Этот стиль определен на странице GroupHeader.

<< Вики группа | Документация | Категории >>

Перевод страницы PmWiki.WikiTrails - Оригинал перевода PmWikiRu.WikiTrails - Backlinks
PmWikiRu.WikiTrails: редакция от September 10, 2011, at 08:48 PM
PmWiki.WikiTrails: редакция от February 12, 2023, at 12:10 PM