Etherpad¶
Установка плагинов¶
Для установки плагинов или изменения конфигурации воспользуйтесь панелью адмнистратора /admin
.
Полный перечень доступных плагинов можно найти здесь.
Администратор¶
Первый вошедший в Etherpad пользователь будет считаться администратором. Дополнительные пользователи с правами администратора могут быть добавлены в раздел ep_cloudron.admins
файла /app/data/settings.json
при помощи Файлового менеджера.
"ep_cloudron": {
"admins": [
"username1",
"username2"
]
}
После изменения настроек в файле /app/data/settings.json
приложение должно быть перезапущено. Пользователю с изменённой ролью, в свою очередь, необходимо перезайти в приложение.
Прочие настройки¶
Используйте Терминал для редактирования файла /app/data/settings.json
.
После изменения настроек в файле /app/data/settings.json
приложение должно быть перезапущено.
Сделать документы общедоступными¶
По умолчанию Etherpad всегда требует авторизацию пользователя для просмотра и редактирования документа. Чтобы открыть доступ сторонним пользователям, добавьте следующую строку в /app/data/settings.json
при помощи Файлового менеджера:
"requireAuthentication": false,
Кастомизирование CSS¶
CCS и Javascript могут настраиваться через редактирование файлов в /app/data/custom/
. Для подробной информации, обратитесь к документации Etherpad.
Тёмная тема¶
Etherpad по умолчанию поставляется с темой colibris. Данная тема поддерживает тёмную тему через skinVariants. Для активации тёмного режима отредактируйте app/data/settings.json
:
"skinVariants": "super-dark-toolbar super-dark-editor dark-background",
API Access¶
Получить доступ к Etherpad API можно при помощи APIKEY. Для получения ключа воспользуйтесь Терминалом и откройте файл /app/data/APIKEY.txt
.
curl https://etherpad.domain/api/1.2.7/listAllPads?apikey=c5513793f24a6fbba161e4497b26c734ff5b2701fad0f1211097ccb405ea65c7
Решение проблем¶
Если Etherpad не хочет запускаться (особенно после обновления), обычно проблема кроется к несовместимых плагинах. Для исправления возникших ошибок, включите режим восстановления и откройте Терминал. После чего получите список установленных плагинов через команду:
npm ls 2> /dev/null | grep ep_
Два обязательных плагина ep_cloudron
и ep_etherpad-lite
не могут вызвать ошибок, в свою очередь остальные плагины вполне могут вызывать ошибки несовместимости. Вы можете удалять ненужные плагины один за другим при помощи команды:
npm rm <pluginname>
Чтобы убедиться, что приложение работает, запустите /app/pkg/start.sh
. Если Etherpad успешно запустился, отключите режим восстановления и продолжайте пользоваться приложением. Если этого не произошло, продолжайте удаление плагинов.
Плагины, которые не вызывают проблем могут быть установлены повторно через команду:
npm i <pluginname>