Вики Кластер

Что это такое

Кластеры — это метод организации документов с помощью виртуальных каталогов (разделов). Кластеры позволяют выстраивать иерархии документов и объединять документы со сходной тематикой. Для упрощенного указания ссылок между страницами кластера используется принцип, аналогичный адресации в URL, и ряд специальных правил маркировки.
Кластер позволяет создание страниц с "составными" именами, перечисленными через символ "/". Например ВикиДокументация/ВикиПаттерны/ВикиКластер. При этом страницы нижнего уровня ВикиКластер считаются "вложенными" в страницу верхнего уровня ВикиДокументация/ВикиПаттерны.


Кластером в WackoWiki:Doc/Russian/Кластеры так же называют страницу, которая содержит в себе другие. Например, если в системе есть ВикиДокументация/ВикиПаттерны/ВикиКластер, то ВикиДокументация/ВикиПаттерны и ВикиДокументация будут называться кластерами.


Из этого следует важное правило – обычное Вики Имя всегда ищется в текущем кластере. Если необходимо адресовать страницу в корне или в другом кластере, то ее имя нужно начать с "/". Например, чтобы из ВикиДокументация/ВикиПаттерны/ВикиМаркер"" сослаться на CompoWiki/ToDo, нужно писать CompoWiki/ToDo, тогда как просто CompoWiki/ToDo будет воспринято системой как ВикиДокументация/ВикиПаттерны/CompoWiki/ToDo. Имя, начинающееся с "/" сохранит свое значение в любом кластере.


Подробно о правилах адресации страниц в кластерах можно почитать на WackoWiki:Doc/Russian/Кластеры.

Метафора файловой системы


Для того, чтобы представить себе кластер в Compo Wiki, можно использовать метафору файловой системы. С файловой системой большинство пользователей встречалось и предствляет, как работать с файлами и каталогами. Эта метафора очень удобна, так как она позволяет понять правила адресации в Вике, но у нее есть свои ограничения, как и у любой метафоры.

Общее у файловой системы и вики-кластеров

  1. Полное имя файла/каталога/страницы должно включать в себя имена всех каталогов, в котором оно находится.
  2. Если мы находимся в каталоге/кластере, то можем обратиться к лежащим здесь же файлам/страницам просто по имени, не указывая полный путь.
  3. Чтобы из каталога/кластера обратиться к файлу/странице, находящемуся в корне, нужно перед его полным именем указать "/".
  4. Чтобы из каталога/кластера обратиться к файлу/странице, находящемуся на один уровень выше, нужно перед его именем указать "../"

Отличия файловой системы и вака-кластеров

  1. Главное отличие Вики от файловой системы – это то, что в Вике нет файлов и каталогов, в ней есть только страницы. Из чего и следуют все остальные отличия.
  2. В каталоге всегда есть список вложенных файлов (и больше ничего). На странице-кластере может быть список вложенных страниц, может быть неполный список, может вообще такового не быть. Чтобы увидеть список всех страниц кластера надо воспользоваться полным списком страниц сайта или же воспользоваться действием например {{tree [page="НачалоКластера"]}}
  3. Если существует файл, лежащий в каком-то каталоге, то заведомо существует сам каталог. Из существования страницы ВикиДокументация/ВикиПаттерны/ВикиМаркер еще не следует, что существует страница ВикиДокументация. Она вполне может отсутствовать.
  4. Удаление каталога означает удаление всех файлов этого каталога. Удаление страницы-кластера никак не повлияет на вложенные в него страницы.
  5. В файл нельзя поместить другой файл по правилам файловой системы. В любую вако-страницу можно вложить другую страницу. Поэтому в Compo Wiki существует специальный синтаксис обращения к вложенной странице: !/ИмяСтраницы. Например, со страницы ВикиДокументация/ВикиПаттерны можно обратиться к ВикиДокументация/ВикиПаттерны/ВикиКластер вот так: !/ВикиКластер.

Правила упрощённой адресации:


  1. Если две страницы лежат внутри одного и того же кластера, то чтобы из одной поставить ссылку на другую, не обязательно писать полное имя. Например, чтобы из ВикиДокументация/ВикиПаттерны/ВикиКластер сослаться на ВикиДокументация/ВикиПаттерны/ВикиМаркер, достаточно написать ВикиМаркер.
  2. Ссылка на страницу того же уровня вложенности
    • если с этой страницы нужно сослаться на /WackoКластеры/ДопИнформация
    • нужно написать ДопИнформация
  3. Ссылка на страницу, которая вложена в эту на уровень ниже
    • если с этой страницы нужно сослаться на /WackoКластеры/ПравилаАдресации/ПодСтраница
    • нужно написать !/ПодСтраница
  4. Ссылка на страницу уровнем выше
    • если с этой страницы нужно сослаться на /WackoDownload, которая расположена на один уровень выше,
    • нужно написать ../WackoDownload
  5. Ссылка на страницу первого уровня
    • если с этой страницы нужно сослаться на /WackoDownload
    • нужно написать /WackoDownload

Общая оценка документа [показать форму]

страница еще не оценена