Расширение Глоссария для XWiki

Редактировал(а) Coluns 17.12.2022

Глоссарий в XWiki

Расширение Глоссария позволяет добавить в вашу вики, специальный словарь.

Глосса́рий (лат. glossarium «собрание глосс») — словарь узкоспециализированных терминов в какой-либо отрасли знаний с толкованием, иногда переводом на другой язык, комментариями и примерами.

Данная функция будет очень полезна для проектных организаций.

Добавляя в глоссарий термины или описание сокращений, можно существенно повысить качество обмена информацией между сотрудниками.

Данное расширение обладает возможностью автоматически добавлять на страницу ссылки на элементы глоссария.

Это позволяет "связывать" страницы с терминами и сокращениями и их описаниями незаметно для пользователя.

Как же добавить расширение глоссария в ваш экземпляр XWiki?

Для начала необходимо установить расширение Glossary Application которое имеет id: org.xwiki.contrib.glossary:application-glossary-ui

Для установки расширений обратитесь к руководству на систему или к нам.

После установки, перейдите к настройкам глоссария (1), (2), (3)

Настройки глоссария в XWiki

Включите добавление ссылок в глоссарий при сохранении страниц (4) и\или создание ссылок периодически по расписанию (5).

Также вы можете указать разделы в которых должны добавляться ссылки (6) и нужно ли при автоматическом добавлении ссылок создавать новую версию страницы (7).

Про версии и их применение при создании документов в XWiki мы писали ранее в статье: Версии страниц в XWiki

После сохранения настроек ваш глоссарий начнет работать.

По умолчанию, глоссарий расположен по адресу вида https://corpwiki.ru/bin/view/Glossary/

На главной странице глоссария вы можете выполнить поиск по глоссарию (1), добавить новый элемент (2) и экспортировать глоссарий в офисный формат таблицы (3).

Все элементы располагаются в удобной таблице (4)

Главная страница глоссария в XWiki

 Страница термина это обычная страница к которой в скрытом режиме прикреплены объекты преобразующие ее в элемент глоссария.

Работа с термином проста: Нужно добавить сам термин (1) и его описание (2)

Добавление элемента глоссария в XWiki

 Концепция "В XWiki всё является страницей" работает и здесь.

После добавления термина, при сохранении страницы или периодически (в зависимости от настроек) система будет на страницах, где встречается термин вставлять специальный макрос, который при просмотре будет преобразовываться в ссылку на страницу глоссария.

Например, мы добавили термин corpwiki и когда сохранили эту страницу, система добавила к этому слову макрос-ссылку на страницу глоссария с этим термином.

И вот как это выглядит в режиме вики-редактирования:

Добавленный макрос глоссария к странице XWiki

Таким образом данное расширение позволяет создать удобный проектный глоссарий в вашей XWiki, что конечно упростит жизнь вашим сотрудникам.