P7 Office Zotero plugin

Плагин Zotero для Р7-офис, основанный на плагине от OnlyOffice зеркало на GiFlic и оригинал.

Плагин Zotero позволяет пользователям создавать библиографию в редакторах Р7-офис с помощью сервиса Zotero.

Плагин можно установить на сервер документов (не точно, для р7 - не проверял) и в настольные редакторы вручную (проверено).

Как установить в р7-офис

• Скачайте готовую версию из директории deploy (для скачивания нужна регистрация на GitFlic) или отсюда или заархивируйте файлы плагинов (архив должен содержать config.json, index.html и pluginCode.js).
• Измените расширение файла на .plugin.
• Зайдите в документ р7 и перейдите на вкладку Плагины, нажмите Настройки >> Добавить плагин, найдите файл .plugin.

Конфигурация

1. Найдите плагин Zotero на вкладке Плагины редактора документов Р7-офис и нажмите на него.

2. Войдите в свою учетную запись Zotero.

3. Перейдите по ссылке Настройки API Zotero из окна плагина. Если вы вошли в систему, вы сможете продолжить работу. Если вы не вошли в систему, вы увидите сообщение об ошибке. В этом случае войдите в систему или нажмите Зарегистрироваться (в правом верхнем углу экрана).

4. Нажмите Создать новый закрытый ключ.

5. Заполните Описание ключа (например, р7), убедитесь, что флажок Разрешить доступ к библиотеке установлен, и нажмите Сохранить ключ.

6. Скопируйте созданный ключ, вставьте в поле API Key в интерфейсе плагина и сохраните его.

Как использовать

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

1. Возможен поиск ссылок по автору, названию или году в вашей библиотеке.

2. Среди результатов поиска выберите те, которые вы хотите добавить в документ.

3. Выберите стиль (например, Chicago Manual, American Psychological Association или Russian GOST) и язык.

4. Нажмите Вставить цитату. На месте курсора появится цитата, оформленная в соответствии с настройками стиля (требованиями оформления)

5. Нажмите кнопку Вставить библиографию, чтобы добавить или обновить библиографию.

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

7. Нажмите кнопку Синхронизировать, чтобы синхронизировать данные с сервисом zotero и обновить их в документе.

8. Если вы хотите открыть этот документ в других редакторах, необходимо преобразовать все поля в текст. Для этогонажмите кнопку Сохранить как текст.

Как установить на сервер (не проверял)

Доступны два способа установки:

1. Поместите папку с кодом плагина в папку ONLYOFFICE Document Server в зависимости от операционной системы:

   Для Linux -/var/www/onlyoffice/documentserver/sdkjs-plugins/.

   Для Windows -`.

   Плагины будут доступны всем пользователям ONLYOFFICE Document Server. Перезапуск службы не требуется.

2. Отредактируйте конфигурацию сервера документов, добавив следующие строки:

   var docEditor = new DocsAPI.DocEditor("placeholder", {
       "editorConfig": {
           "plugins": {
               "autostart": [
                   "asc.{BFC5D5C6-89DE-4168-9565-ABD8D1E48711}",
                   ...
               ],
               "pluginsData": [
                   "https://example.com/path/to/zotero/config.json",
                   ...
               ]
           },
           ...
       },
       ...
   });
   

Важно: при интеграции ONLYOFFICE Document Server со сторонними хранилищами необходимо использовать специальные коннекторы (интеграционные приложения). Если вы скомпилируете коннектор из исходного кода или создадите новый, вы сможете добавить плагины с помощью конфигурации Document Server. Если вы используете готовые коннекторы (например, из маркетплейсов ownCloud/Nextcloud), добавление плагинов через конфигурацию неприменимо.

Известные проблемы в OnlyOffice (р7 - не тестировал в такой компоновке)

Для пользователей CentOS с включенным SELinx, после копирования папки src в sdkjs-plugins, плагины могут не работать из-за переменного контекста безопасности файла. Чтобы восстановить права, выполните следующую команду:

sudo restorecon -Rv /var/www/onlyoffice/documentserver/sdkjs-plugins/ 

После этого перезапустите службы:

sudo supervisorctl restart ds:docservice

Обратная связь и поддержка пользователей

Чтобы задать вопросы и поделиться отзывами, используйте вкладку “Проблемы” в этом репозитории.