Небольшие заметки о том, как организована Wiki

Почти все в wiki - страницы

Именно так. Даже меню на титульной странице - тоже страница. Все страницы в wiki имеют свое уникальное имя, которое выглядит так «namespace:level1:level2: <…>: levelN». Это позволяет естественным образом структурировать информацию. При этом, прямой доступ к странице возможен посредством перехода по ссылке вида http://www.statmod.ru/wiki/name, где name - имя страницы. В терминах Wiki, «name» - это тема, для которой может быть создана страница, а, может, и нет.

Примеры: http://statmod.ru/wiki/study:fall2007:intror http://statmod.ru/wiki/study:exams:winter2008

Добавление страниц

Как правило, добавление нового материала на саму страницу происходит достаточно редко. В основном приходится создавать новые страницы. Для того, чтобы создать новую страницу следует просто перейти на нее; при этом wiki сама предложит ее создать.

Например, для создания нового расписания экзаменов достаточно перейти по ссылке типа http://statmod.ru/wiki/study:exams:winter2050 и создать новую страницу

Удаление страниц

Для удаления страницы достаточно просто стереть все ее содержимое. Страница без содержимого считается «пустой».

Страницы-заглушки

Часто приходится добавлять материал, имеющий структуру списка. Например: список преподавателей, списки расписаний экзаменов и т.п. Если отдельные элементы этого списка небольшие, то можно все это «связать на одной странице». Проблема возникает, когда материала по каждому пункту достаточно много (например, расписание экзаменов) и кроме того, он постепенно добавляется. Тогда естественным решением служит выделение под каждый элемент своей страницы. Однако, эти элементы надо как-то «связать воедино».

Это можно сделать руками, а можно использовать плагин indexmenu. Работу этого плагина можно наблюдать в разделах «Преподаватели» и «Расписание экзаменов». Работа плагина основана на простом принципе: ему передается путь и «глубина просмотра». Плагин просматривает заданный путь на соотв. глубину, собирает имена и названия всех страниц и выводит в древовидной структуре. В качестве «названия» страницы используется содержимое самого первого заголовка.

Однако, у этого плагина есть одно забавное свойство: просмотр страниц делается только при создании / редактировании страницы, где этот плагин вызывается. Это логично, т.к. такой просмотр при каждом открытии страницы может быть очень медленным. В связи с этим при добавлении новой страницы в контролируемое плагином пространство (а также при изменении его имени) необходимо делать «пустую» правку страницы с вызовом плагина, например, посредством добавления или удаления пустых строк.

Эта типичная операция производится при добавлении списка экзаменов и т.п.

Полная документация о плагине indexmenu находится тут: http://wiki.splitbrain.org/plugin:indexmenu2

To Be Continued

common/doc.txt · Последнее изменение: 2007/12/22 22:20 — asl
Наверх
CC Attribution-Noncommercial-Share Alike 4.0 International
Driven by DokuWiki Recent changes RSS feed Valid CSS Valid XHTML 1.0