# Комментарии

Комментируйте текст в общем проекте, упоминайте участников, отвечайте, помечайте обсуждения решёнными и открывайте их снова, а также узнайте, что происходит при выключенных комментариях.

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

Владельцы, редакторы, рецензенты и комментаторы могут комментировать. Редактор у комментатора доступен только для чтения, но комментатор всё равно может выделить текст и прокомментировать его. Читатели могут читать комментарии, но не писать их.

## Добавить комментарий

1. Выделите текст, который хотите прокомментировать.
2. Выберите **Добавить комментарий** в меню, появляющемся над выделением, или в контекстном меню.
3. Откроется панель **Комментарии** с процитированным сверху выбранным вами текстом. Напишите комментарий и выберите **Отправить**.

У строк с комментариями в редакторе появляется маркер сбоку. Выберите маркер, чтобы показать эти комментарии.

Комментарий остаётся прикреплённым к своему тексту, пока люди редактируют вокруг него. Если кто-то добавляет слова внутри прокомментированного текста, комментарий расширяется, чтобы охватить их.

Комментировать можно и офлайн. Ваши комментарии уйдут вместе с остальными изменениями при повторном подключении.

## Упомянуть участника

Введите `@` в комментарии или ответе и выберите человека из списка. В **Активности** у него появится запись о том, что вы его упомянули, с кнопкой **Показать комментарий** для перехода к нему.

Если сервер отправляет почту, упомянутый человек также получит письмо примерно через минуту. В нём названо, кто его упомянул, указаны проект и файл, текст, к которому относится комментарий, и сам комментарий, а также ссылка, открывающая комментарий в Oleafly. Упоминания, приходящие в течение этой минуты, объединяются в одно письмо.

Никто не получает писем о собственных комментариях или о проекте, который не может открыть. Редактирование комментария никогда не отправляет одно и то же упоминание дважды. Чтобы отключить письма об упоминаниях, откройте **Настройки → Совместная работа**, найдите карточку сервера и выключите **Сообщать мне по почте, когда меня упоминают в комментарии**.

## Ответ, пометка решённым и повторное открытие

- **Ответить** добавляет сообщение в обсуждение.
- **Решить** помечает обсуждение как завершённое и скрывает его. В обсуждении видно, кто его решил.
- **Показать решённые комментарии** вверху панели возвращает решённые обсуждения в поле зрения. Выберите **Открыть снова**, чтобы снова сделать обсуждение активным.

Если два человека решают или отвечают в один и тот же момент, в итоге у всех оказывается одно и то же обсуждение.

## Изменить или удалить

Вы можете менять только то, что написали сами. Откройте меню действий на своём комментарии, чтобы изменить или удалить его. Изменённый комментарий помечается как **Изменено**. Удалённый оставляет запись «Этот комментарий удалён», чтобы ответы сохраняли смысл.

Чтобы удалить целиком начатое вами обсуждение, выберите **Удалить обсуждение** в меню действий обсуждения. Если кто-то уже ответил, обсуждение останется. Вместо этого пометьте его решённым.

## Панель комментариев

Панель **Комментарии** открывается из проектной колонки. Она показывает комментарии всего проекта, сгруппированные по файлам, начиная с файла, который у вас открыт. Файл без комментариев не получает раздела. Если в проекте вообще нет комментариев, панель сообщает об этом одной строкой.

Выберите **Показать в редакторе** на обсуждении, чтобы перейти к тексту, о котором оно.

Предложенные изменения также появляются на этой панели, в тех же разделах файлов, и у каждого есть своё поле **Ответ**. Читайте [Предложение изменений](/docs/collaboration/suggesting/#review-suggestions).

### Комментарии, потерявшие свой текст

Когда весь текст, к которому относился комментарий, удаляется, обсуждение перемещается в раздел **Отвязанные** с пометкой «Текст, к которому относились эти комментарии, удалён». Там ещё можно прочитать обсуждение.

### Комментарии, авторов которых Oleafly не смог проверить

Oleafly проверяет, кто написал каждый комментарий. Если подтвердить автора не удаётся, комментарий помечается: «Не удалось проверить, кто это написал».

## Выключение комментариев

Владелец проекта может выключить комментарии в диалоге **Поделиться** переключателем **Комментарии**. Администратор сервера может выключить их для всех проектов на сервере параметром **Разрешить комментарии**. В обоих случаях комментарии скрываются, но не удаляются. Включение обратно возвращает все обсуждения, и все участники проекта сразу видят это изменение.

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

### Комментарии, написанные при выключенных комментариях

Иногда человек пишет комментарий офлайн, а владелец выключает комментарии до того, как комментарий доходит до сервера. Когда этот человек снова подключается:

- Комментарии не отправляются. Уведомление сообщает: «Комментарии в этом проекте выключены, поэтому написанные вами комментарии не отправлены».
- **Показать написанное** перечисляет текст этих комментариев, а **Скопировать текст** копирует его, чтобы можно было сохранить его в другом месте.
- Всё остальное, написанное этим человеком, отправляется как обычно. Задерживаются только комментарии.
