Найти тему
CorpWiki

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

Расширение глоссария в XWiki
Расширение глоссария в XWiki

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

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

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

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

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

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

Полезный совет
Так как глоссарий является словарём сложных терминов, не следует включать в глоссарий все термины, которые встречаются в проекте.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Макрос глоссария в XWiki
Макрос глоссария в XWiki

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

Полезный совет
К сожалению, расширение не переведено на русский язык и некоторые элементы интерфейса на английском.
Но вы можете обратиться к нам и мы вам поможем.

Прочитать эту статью и посмотреть как работает глоссарий, вы можете на нашем сайте.