home

Новый модуль ELiS PDF вместо Ebooks

При создании ELiS первым модулем работы с документами был модуль Ebooks. Модуль создает ноды типа ebook и ebookpage для сущности книги и сущностей ее страниц и связывает их.

Т.о. страницы оказывались тоже сущностями связанными с сущностью книги и к страницам можно прикреплять собственные поля.

Но по факту этот функционал никто не использует.

Минусы подхода - появляется много нод страниц и пользователям сложнее понимать что это. Пока работают с PDF обученные специалисты - это не очень важно, но если сервисом пользуются необученные, то уже доставляет неудобство.

Поэтому принято решение отказаться от старого подхода с генерацией сущностей страниц и генерировать только одну ноду - ноду книги с типом ноды "pdf".

Но проблема в том, что старый модуль Ebooks широко используется, на страницы оставляются ссылки, поэтому вместо того, чтобы менять поведение старого модуля и удалить ноды страниц, решено сделать новый модуль с новым названием и новым типом контента. Этот новый модуль называется ELiS PDF.

Плеер и функционал остались достаточно близки, но в ELiS PDF пока реализован не весь функционал: нет комментариев к страницам PDF, не работает поиск по страницам книг (полнотекстовый поиск ведет на книгу, а не на отдельную страницу). В дальнейшем этот функционал будет добавлен.

Преимущества[править]

В ELiS PDF теперь можно вначале создать описание и когда-нибудь потом загрузить книгу. Это может быть полезно для задач оцифровки.

Ссылки на страницы теперь не в виде уникальных идентификаторов нод, а отображаются с помощью параметра fragment=page-N к ноде книги, например https://elis.example.com/node/12345?fragment=page-6.

Также теперь можно обновлять PDF (не меняя URL), при этом ссылки на страницы не побьются, это может быть полезно при появлении новой ревизии PDF.

Можно ожидать уменьшение числа deadlock-ов т.к. в базу теперь пишется меньше информации.

Недостатки[править]

Пока не реализован офлайн-режим в приложениях ELiS.

Миграция[править]

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

Установка[править]

Новый модуль будет доступен всем у кого есть доступ к Ebooks, отдельно покупать его не надо.

Важное замечание по обновлению: для обновления надо запустить не стандартный способ через запуск /usr/lib64/elis/bin/update_elis.sh, а нижеописанным способом:

# /usr/lib64/elis/bin/update_elis.sh
# dnf install drupal7-elis-mod-pdf drupal7-elis-mod-ebooks
# cd /var/www/vh/library
# su elis
$ drush en elis_pdf

Использование[править]

Создать новый документ можно по node/add/pdf