Изменения документа Аннотирование документов в XWiki

Редактировал(а) Coluns 16.08.2024
От версии 2.2
отредактировано Coluns
на 09.12.2022
Изменить комментарий: К данной версии нет комментариев
К версии 8.10
отредактировано XWikiGuest
на 03.03.2023
Изменить комментарий: Добавлен комментарий

Сводка

Подробности

Свойства страницы
Автор документа
... ... @@ -1,1 +1,1 @@
1 -XWiki.coluns
1 +XWiki.XWikiGuest
Теги
... ... @@ -1,0 +1,1 @@
1 +функции|комментирование|аннотации
Содержимое
... ... @@ -62,6 +62,15 @@
62 62  
63 63  Мы добавили к данной странице несколько аннотаций для иллюстрации механизма.
64 64  
65 +Попробуйте включить аннотации для данной страницы и посмотрите как это работает.
66 +
67 +{{cl-plate-advice}}
68 +В настройках механизма аннотаций вы можете включить отображение аннотаций по умолчанию при загрузке страницы.
69 +{{/cl-plate-advice}}
65 65  ----
71 +**Не любите читать? Посмотрите видео на эту тему на нашем канале:**
66 66  
73 +{{video url="https://www.youtube.com/watch?v=ZYH3m7cFLFE"/}}
74 +----
75 +
67 67  {{cl-plate-help/}}
XWiki.XWikiComments[0]
Автор
... ... @@ -1,0 +1,1 @@
1 +xwiki:XWiki.coluns
Комментарий
... ... @@ -1,0 +1,1 @@
1 +Первая аннотация
Дата
... ... @@ -1,0 +1,1 @@
1 +2022-12-09 18:15:37.0
Selection
... ... @@ -1,0 +1,1 @@
1 +Такая возможность
State
... ... @@ -1,0 +1,1 @@
1 +SAFE
Target
... ... @@ -1,0 +1,1 @@
1 +Stati.Funktsii-XWiki.Annotirovanie-dokumentov-v-XWiki.WebHome
XWiki.XWikiComments[1]
Автор
... ... @@ -1,0 +1,1 @@
1 +xwiki:XWiki.coluns
Комментарий
... ... @@ -1,0 +1,1 @@
1 +Вторая аннотация
Дата
... ... @@ -1,0 +1,1 @@
1 +2022-12-09 18:15:57.0
Selection
... ... @@ -1,0 +1,1 @@
1 +ниже выделенного текста
State
... ... @@ -1,0 +1,1 @@
1 +SAFE
Target
... ... @@ -1,0 +1,1 @@
1 +Stati.Funktsii-XWiki.Annotirovanie-dokumentov-v-XWiki.WebHome
XWiki.XWikiComments[2]
Комментарий
... ... @@ -1,0 +1,1 @@
1 +Пробная аннотация
Дата
... ... @@ -1,0 +1,1 @@
1 +2023-02-16 11:21:23.0
Selection
... ... @@ -1,0 +1,1 @@
1 +аннотаций
Selection Left Context
... ... @@ -1,0 +1,1 @@
1 +Мы добавили к данной странице несколько
Selection Right Context
... ... @@ -1,0 +1,1 @@
1 +для иллюстрации механизма.
State
... ... @@ -1,0 +1,1 @@
1 +SAFE
Target
... ... @@ -1,0 +1,1 @@
1 +Stati.Funktsii-XWiki.Annotirovanie-dokumentov-v-XWiki.WebHome
XWiki.XWikiComments[3]
Автор
... ... @@ -1,0 +1,1 @@
1 +hp
Комментарий
... ... @@ -1,0 +1,11 @@
1 +Да, XWiki удобна в плане ревью, поскольку поддерживает как общие, так и внутритекстовые комментарии.
2 +
3 +Но есть один нюанс, о котором здесь не сказано. Возможно, вы просто с этим еще не столкнулись, а я уже ))
4 +
5 +Суть проблемы в том, что, судя по всему, внутритекстовые комментарии ("аннотации" в терминах XWIKI) привязываются не к позиции комментируемого фрагмента текста, а к его окружению в пределах абзаца. Отсюда возникают нюансы: если текст в разных абзацах полностью идентичен, то аннотация в итоге будет привязана не к выделеному изначально фрагменту текста, а к самому первому совпадению с ним.
6 +
7 +Вот ссылка на видео, демонстрирующее этот баг: [[https:~~/~~/youtu.be/OGHdG56B~~-~~-0>>https://youtu.be/OGHdG56B--0]]
8 +
9 +----
10 +
11 +PS: пробную аннотацию выше можно удалить, это был я )
Дата
... ... @@ -1,0 +1,1 @@
1 +2023-02-28 16:52:42.0
XWiki.XWikiComments[4]
Автор
... ... @@ -1,0 +1,1 @@
1 +XWiki.coluns
Комментарий
... ... @@ -1,0 +1,27 @@
1 +Добрый день!
2 +
3 +Да, вы правы. Такая особенность действительно есть. Спасибо за то, что обращаете внимание.
4 +
5 +Эта проблема известна и есть обсуждение с авторами данного плагина.
6 +
7 +//"Система аннотаций имеет хранилище контекста для правильного размещения аннотации на основе окружающего текста (а не только аннотируемых слов), и существует алгоритм для обнаружения этого контекста при добавлении аннотации. //
8 +
9 +//Этот алгоритм использует инкрементный метод, так что он обнаруживает как можно более короткий контекст, который делает аннотацию уникальной;//
10 +
11 +// слишком большой контекст будет чувствителен к любым изменениям, даже в частях документа, совершенно не связанных с аннотацией, и приведет к сбою идентификации аннотации.//
12 +
13 +//Мы пытаемся найти “золотую середину” между одним риском и другим.//
14 +
15 +//В некоторых случаях этому алгоритму не удается найти уникальный контекст, даже при расширении контекста пару раз, и в результате аннотация помещается в первое вхождение этого контекста, а не во второе. //
16 +
17 +//Этот случай, который вы обнаружили, является одним из таких случаев, и он связан с тем фактом, что один и тот же абзац, который также довольно длинный, появляется в документе дважды.
18 +Принцип этого алгоритма заключается в том, чтобы наилучшим образом охватить реальные ситуации, но не обязательно все тестовые ситуации (существует множество тестовых случаев, для которых размещение аннотаций может завершиться неудачно, но энтропия этого контента не та, которая встречается на практике).
19 +Это добавленный вами тестовый контент или у вас есть реальный контент, в котором возникает такая ситуация?//
20 +
21 +//Существует проблема, открытая для этого ограничения здесь [[https:~~/~~/jira.xwiki.org/browse/XWIKI-8400>>url:https://jira.xwiki.org/browse/XWIKI-8400]]"//
22 +
23 +Очень похожий на Ваш случай.
24 +
25 +
26 +
27 +
Дата
... ... @@ -1,0 +1,1 @@
1 +2023-03-01 03:36:25.0
XWiki.XWikiComments[5]
Автор
... ... @@ -1,0 +1,1 @@
1 +hp
Комментарий
... ... @@ -1,0 +1,1 @@
1 +Да, все так. Остается надеяться, что когда-нибудь поправят...
Дата
... ... @@ -1,0 +1,1 @@
1 +2023-03-02 12:12:47.0
Ответить
... ... @@ -1,0 +1,1 @@
1 +4
XWiki.XWikiComments[6]
Автор
... ... @@ -1,0 +1,1 @@
1 +XWiki.coluns
Комментарий
... ... @@ -1,0 +1,12 @@
1 +Есть такой макрос [[Комментарий>>doc:Stati.Makrosy.Makros-Kommentarii.WebHome]]
2 +
3 +Нужен для того чтобы в тексте оставлять заметки невидимые.
4 +
5 +Можно реализовать что то вроде этого. Т.е. вставлять комментарий прямо в текст страницы.
6 +
7 +Но это будет влиять на содержание. Так что тоже возможно спорное решение.
8 +
9 +(% class="ghost-text-message ghost-text-message-error" style="display: none;" %)
10 +(((
11 +Unable to connect to the editor. [[Need help?>>url:https://ghosttext.fregante.com/troubleshooting/#unable-to-connect]]
12 +)))
Дата
... ... @@ -1,0 +1,1 @@
1 +2023-03-02 12:29:38.0
Ответить
... ... @@ -1,0 +1,1 @@
1 +5
XWiki.XWikiComments[7]
Автор
... ... @@ -1,0 +1,1 @@
1 +hp
Комментарий
... ... @@ -1,0 +1,1 @@
1 +Да, думал про этот вариант, но он не очень подходит для проведения коллективного ревью, т.к. не все участники могут иметь права на редактирование статей. Ну и сам процесс усложняется - нужно обязательно входить в режим редактирования ((
Дата
... ... @@ -1,0 +1,1 @@
1 +2023-03-02 16:24:13.0
Ответить
... ... @@ -1,0 +1,1 @@
1 +6
XWiki.XWikiComments[8]
Автор
... ... @@ -1,0 +1,1 @@
1 +hp
Комментарий
... ... @@ -1,0 +1,1 @@
1 +Есть еще один баг, с которым мы столкнулись: если переместить аннотированную страницу, то все внутритекстовые аннотации преобразуются в нижние комментарии и теряют связь с откомментированными фрагментами текста. Это очень плохо, т.к. после реструктуризации серьезно усложняется анализ ревью  ((
Дата
... ... @@ -1,0 +1,1 @@
1 +2023-03-02 16:29:02.0
XWiki.XWikiComments[9]
Автор
... ... @@ -1,0 +1,1 @@
1 +XWiki.coluns
Комментарий
... ... @@ -1,0 +1,15 @@
1 +Вы правы, есть такая ошибка.
2 +
3 +Проверили, связана с тем, что в объекте который хранит в себе аннотацию, есть поле "target" в котором хранится ссылка на аннотируемую страницу.
4 +
5 +При стандартном перемещении, данное поле не меняется, поэтому аннотации перестают отображаться (хотя и остаются физически в странице как объекты).
6 +
7 +Очевидным решением будет сделать так, чтобы механизм отображения аннотаций не учитывал данное поле.
8 +
9 +Не понятен на самом деле его смысл: ведь аннотация по определению относится к "текущей" странице и поле  "target" кажется избыточным.
10 +
11 +Мы зафиксировали данную ошибку в нашем трекере и постараемся устранить.
12 +
13 +Так как для корпоративной базы знаний, функция аннотирования нам кажется важной.
14 +
15 +Спасибо вам за наблюдательность! 👍
Дата
... ... @@ -1,0 +1,1 @@
1 +2023-03-03 06:59:17.0
Ответить
... ... @@ -1,0 +1,1 @@
1 +8
XWiki.XWikiComments[10]
Автор
... ... @@ -1,0 +1,1 @@
1 +XWiki.coluns
Комментарий
... ... @@ -1,0 +1,7 @@
1 +Возможным решением кажется учитывать при определении контекста номера строк.
2 +
3 +Т.е. чтобы система учитывала не только "слова слева" и "слова справа" но и скажем так "диапазон строк" в котором искать контекст.
4 +
5 +Это позволит решить проблему.
6 +
7 +Как думаете?
Дата
... ... @@ -1,0 +1,1 @@
1 +2023-03-03 07:01:03.0
Ответить
... ... @@ -1,0 +1,1 @@
1 +7
XWiki.XWikiComments[11]
Автор
... ... @@ -1,0 +1,1 @@
1 +hp
Комментарий
... ... @@ -1,0 +1,3 @@
1 +Пожалуйста )) Очень надеюсь, что удастся устранить данный баг. Если найдете решение – поделитесь, плиз ))
2 +\\Я довольно давно использую XWiki и тоже заинтересован в развитии этой замечательной платформы )) Готов делиться не только найденными багами, но и рецептами по улучшению функциональности ))
3 +К сожалению, не встречал русскоязычного сообщества активных пользователей XWiki, только иностранные форумы. А платформа перспективна и наверняка будет распространяться все шире, особенно в свете политики Atlassian ))
Дата
... ... @@ -1,0 +1,1 @@
1 +2023-03-03 08:42:30.19
Ответить
... ... @@ -1,0 +1,1 @@
1 +9