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

1

(% style="text-align:center" %)

2

[[image:Глоссарий.svg||alt="Глоссарий в XWiki" height="600" width="600"]]

3

4

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

(% class="box" %)

(((

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

9

)))

10

11

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

12

13

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

14

15

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

16

17

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

18

19

20

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

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

25

26

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

(% class="box" %)

(((

Для установки расширений обратитесь к [[руководству>>https://extensions.xwiki.org/xwiki/bin/view/Extension/Extension%20Manager%20Application]] на систему или [[к нам>>mailto:info@corpwiki.ru]].

31

)))

32

33

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

34

35

(% style="text-align:center" %)

36

[[image:image-20221217152511-1.png||alt="Настройки глоссария в XWiki" height="486" width="1000"]]

37

38

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

39

40

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

(% class="box" %)

(((

Про версии и их применение при создании документов в XWiki мы писали ранее в статье: [[Версии страниц в XWiki>>doc:Stati.Funktsii-XWiki.Versii-stranits-v--XWiki.WebHome]]

45

)))

46

47

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

48

49

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

50

51

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

52

53

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

54

55

(% style="text-align:center" %)

56

[[image:image-20221217153242-2.png||alt="Главная страница глоссария в XWiki" height="354" width="1000"]]

57

58

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

59

60

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

61

62

(% style="text-align:center" %)

63

[[image:image-20221217153825-3.png||alt="Добавление элемента глоссария в XWiki" height="468" width="1000"]]

64

65

(% class="box warningmessage" %)

66

(((

67

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

68

)))

69

70

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

71

72

Например, мы добавили термин {{glossaryReference glossaryId="Glossary" entryId="corpwiki"}}corpwiki{{/glossaryReference}} и когда сохранили эту страницу, система добавила к этому слову макрос-ссылку на страницу глоссария с этим термином.

73

74

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

75

76

(% style="text-align:center" %)

77

[[image:image-20221217154508-1.png||alt="Добавленный макрос глоссария к странице XWiki" height="476" width="1000"]]

78

79

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

80