Версия для слабовидящих с OCR документов, озвучиванием и Брайлем

Версия 1.0.9

Обновление накопительное: оно включает исправления версий 1.0.6, 1.0.7 и 1.0.8.

Текстовые представления отдаются экранированными

Заголовок и текст представления теперь уходят на страницу в экранированном виде,

а панель разворачивает их обратно перед показом. Так значения безопасны при любом

способе вывода, даже если их отрисует сторонний код. Для посетителя ничего не

меняется: текст документа он видит и слышит как прежде, вместе со знаками

"больше" и "меньше".

Понятное сообщение, когда пробный период закончился

Раньше при попытке установить решение с закончившимся пробным периодом

установщик писал "Не удалось подключить модуль после регистрации" - фраза

техническая и ничего не объясняла. Теперь он прямо сообщает, что пробный период

на сайте закончился, продлить его переустановкой нельзя, и предлагает приобрести

решение.

Из версии 1.0.8: разметка снимается с полей представлений на сервере

Из версии 1.0.7: кнопка появляется на любом шаблоне сайта, а при новой установке

она закреплена в правом нижнем углу экрана.

Из версии 1.0.6: исправлена установка платной и пробной версии; версия платформы

проверяется до того, как установщик что-либо изменит на сайте.

Версия 1.0.8

Обновление накопительное: оно включает исправления версий 1.0.6 и 1.0.7.

Текстовые представления: разметка снимается на сервере

Заголовок представления строится из имени файла, а текст - из содержимого

документа; и то и другое задаёт тот, кто загрузил файл на сайт. Теперь модуль

снимает с них HTML-разметку сам, до записи в базу и ещё раз при выдаче, а

публичный ответ дополнительно экранирует угловые скобки и кавычки. Записи,

сохранённые прежними версиями, очищаются при выдаче.

Текст документа при этом не страдает: убираются только настоящие теги, а

сравнения вида "если a d" остаются как есть.

Из версии 1.0.7: кнопка появляется на любом шаблоне сайта

На сайтах, где шаблон не закрывает тег (в HTML5 это допустимо), модуль

подключал свои скрипты и стили, но саму кнопку и панель на страницу не выводил.

Из версии 1.0.7: кнопка снизу справа при новой установке

При первой установке кнопка включения версии для слабовидящих закреплена в

правом нижнем углу экрана. На уже установленных сайтах расположение кнопки не

меняется: оно хранится в настройках модуля.

Из версии 1.0.6: исправлена установка платной и пробной версии

Установка решения из Маркетплейса прерывалась ошибкой "syntax error, unexpected

token "

Версия 1.0.7

Обновление накопительное: оно включает исправления версии 1.0.6.

Кнопка появляется на любом шаблоне сайта

На сайтах, где шаблон не закрывает тег (в HTML5 это допустимо), модуль

подключал свои скрипты и стили, но саму кнопку и панель на страницу не выводил.

Теперь кнопка выводится на любом шаблоне.

Кнопка снизу справа при новой установке

При первой установке кнопка включения версии для слабовидящих теперь закреплена

в правом нижнем углу экрана - так её видно на любом шаблоне без правки вёрстки.

На уже установленных сайтах расположение кнопки не меняется: оно хранится в

настройках модуля.

Из версии 1.0.6: исправлена установка платной и пробной версии

При установке решения из Маркетплейса в демо-режиме или по купленной лицензии

установка прерывалась ошибкой "syntax error, unexpected token "

Версия 1.0.6

Исправлена установка платной и пробной версии из Маркетплейса

При установке решения в демо-режиме или по купленной лицензии установка

прерывалась ошибкой "syntax error, unexpected token "

Версия 1.0.5

Обновление рекомендуется установить всем: оно закрывает выявленную проблему

безопасности в разделе текстовых представлений файлов. Обновление накопительное

и включает в себя изменения версии 1.0.4.

Текстовые представления отдаются только из разрешённых каталогов

Раздел текстовых представлений превращает документы сайта в текст, который

панель читает голосом. Обращение к нему идёт от посетителя без авторизации - так

и задумано, специальной версией пользуются анонимные посетители. Проверка пути

при этом убеждалась, что файл существует, лежит под корнем сайта и имеет

поддерживаемое расширение, но не проверяла, что администратор этот каталог

публиковал. Посетитель, знающий или угадавший путь, мог запросить разбор

постороннего файла и затем получить его текст.

Теперь наружу отдаются только файлы из каталога загрузок /upload и из

дополнительных каталогов, которые администратор явно указал в настройках модуля

на странице "Текстовые представления файлов". Всё остальное под корнем сайта

недоступно, служебный каталог /bitrix и кеш ресайза изображений исключены

отдельно. Проверка выполняется и при поиске представления, и при выдаче текста,

поэтому каталог, убранный из списка, перестаёт отдаваться сразу - вместе с уже

готовыми представлениями своих файлов.

Что осталось прежним

Порядок работы не изменился. Документы из /upload и из разрешённых каталогов

по-прежнему находятся автоматически и ставятся в очередь на разбор при первом

обращении; сканер, агенты, распознавание и административные экраны работают как

раньше; накопленные текстовые представления сохраняются, настройки не

затрагиваются. Ограничение касается только выдачи посетителю: администратор

по-прежнему может указать для сканирования любой каталог.

Из версии 1.0.4: единый шрифт Брайля

Модуль показывает Брайль в двух местах: отдельным окном с текстом страницы и

режимом, где точками отображается весь сайт. Раньше ячейки рисовались шрифтом,

который найдётся на компьютере посетителя, а он у всех разный: на macOS

показывались только выпуклые точки, на Windows - полная матрица из шести

позиций, где невыпуклые точки обозначены контурными кружками.

Теперь шрифт входит в состав модуля, и ячейки везде выглядят одинаково - только

выпуклые точки. Шрифт весит около 2.4 КБ, загружается один раз и используется

исключительно для символов Брайля. Если файл шрифта не загрузится, ячейки

покажутся системным шрифтом, как раньше.

Из версии 1.0.4: восстановление недостающих файлов

Обновление везёт только изменившиеся файлы, и если какого-то файла модуля на

сайте не оказалось, вернуть его оно не могло. Теперь установка обновления

приводит служебные каталоги модуля к полному составу: скрипты, стили, шрифт,

компонент, страницы админки, файл темы и публичная точка входа копируются из

установленного модуля целиком. Настройки и накопленные текстовые представления

при этом не затрагиваются.

Версия 1.0.4

Шрифт Брайля теперь одинаковый у всех

Модуль отображает Брайль в двух местах: отдельным окном с текстом страницы и

режимом, где точками показывается весь сайт. Раньше рисовать ячейки приходилось

шрифтом, который найдётся на компьютере посетителя, а он у всех разный: на macOS

показывались только выпуклые точки, на Windows - полная матрица из шести

позиций, где невыпуклые точки обозначены контурными кружками. Выбрать вид было

нельзя: на Windows другого шрифта с ячейками Брайля просто нет.

Теперь шрифт входит в состав модуля. Ячейки везде выглядят одинаково - только

выпуклые точки, без пустых кружков. Шрифт весит около 2.4 КБ, загружается один

раз и используется исключительно для символов Брайля: остальной текст страницы

по-прежнему показывается шрифтом сайта или выбранной в панели гарнитурой.

Если файл шрифта по какой-то причине не загрузится, ячейки покажутся системным

шрифтом, как раньше, - Брайль не пропадёт.

Обновление восстанавливает недостающие файлы модуля

Обновление везёт только изменившиеся файлы. Если на сайте какого-то файла модуля

не оказалось, обновление его не возвращало: модуль оставался неполным, панель

отображалась, но не работала. Теперь установка обновления приводит служебные

каталоги модуля к полному составу - скрипты, стили, шрифт, компонент, страницы

админки, файл темы и публичная точка входа копируются из установленного модуля

целиком. Настройки и накопленные текстовые представления не затрагиваются.

Версия 1.0.3

Обновление устанавливается поверх 1.0.1 и включает изменения версий 1.0.2 и 1.0.3.

Кнопка "Текстовая версия" больше не ломает вёрстку списков

Кнопка добавляется рядом со ссылкой на документ. Если ссылка была прямым

элементом сетки или флекс-раскладки, кнопка становилась таким же элементом и

занимала целую ячейку: рядом с карточкой документа появлялась пустая карточка.

Теперь в таких раскладках ссылка и кнопка занимают одно место вместе, а кнопка

встаёт под ссылкой. В обычном тексте всё как было: кнопка остаётся в строке со

ссылкой. При выключении специальной версии разметка страницы возвращается в

исходный вид.

Одинаковый шрифт Брайля в обоих режимах

Модуль показывает Брайль в двух местах: отдельным окном с текстом страницы и

режимом, где точками отображается весь сайт. Раньше эти два места запрашивали у

браузера разные гарнитуры, браузер подбирал под них разные шрифты замены, и на

одной и той же странице Брайль выглядел по-разному: где-то только выпуклые

точки, где-то полная матрица с контурными кружками. Теперь оба режима

используют один и тот же набор шрифтов.

Озвучивание выделенного фрагмента

Раньше синтез речи читал страницу целиком. Теперь можно выделить нужный кусок

текста, и рядом с выделением появится кнопка "Озвучить выделенное": читается

ровно выделенное. Кнопка появляется только при включённой версии для

слабовидящих и прячется, как только выделение снято. Выделение внутри полей

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

отдельно в настройках модуля и по умолчанию включена. Кнопка синтеза речи в

панели работает по-прежнему: читает страницу целиком.

Кнопка озвучивания растёт вместе с размером текста

Подпись на кнопке у выделения была мельче, чем текст страницы, увеличенный самим

модулем. Теперь размер кнопки привязан к выбранной ступени масштаба: при 250 %

она вчетверо крупнее исходной. Отступы, значок и высота считаются от того же

размера.

На узком экране панель настроек не закрепляется сверху

Закрепление панели у верхнего края на телефоне играло против пользователя:

развёрнутая панель занимала до двух третей экрана, и столько же уходило под её

отступ - сайт становилось невозможно просматривать. Теперь решение принимается

по замеру: если панель занимает больше трети высоты экрана, она едет вместе со

страницей и уезжает вверх при прокрутке. На широком экране всё остаётся как было.

Значки управления речью

Символы воспроизведения, паузы и остановки заменены рисунками: у символа

воспроизведения была смещена отцентровка внутри кнопки, и в чёрно-белых схемах

он оставался цветным.

Версия 1.0.2

Озвучивание выделенного фрагмента

Раньше синтез речи читал страницу целиком - с начала и до конца. Теперь можно

выделить нужный кусок текста, и рядом с выделением появится кнопка "Озвучить

выделенное": читается ровно выделенное, а не вся страница. Кнопка появляется

только при включённой версии для слабовидящих и прячется, как только выделение

снято. Выделение внутри полей ввода и внутри самой панели настроек кнопку не

вызывает.

Возможность включается отдельно в настройках модуля - "Озвучивание выделенного

фрагмента" - и по умолчанию включена. Кнопка синтеза речи в панели работает

по-прежнему: читает страницу целиком.

Кнопка озвучивания растёт вместе с размером текста

Подпись на кнопке у выделения была мельче, чем текст страницы, увеличенный самим

модулем. Теперь размер кнопки привязан к выбранной ступени масштаба: при 250 %

она вчетверо крупнее исходной. Отступы, значок и высота считаются от того же

размера, поэтому кнопка остаётся соразмерной на всех ступенях.

На узком экране панель настроек не закрепляется сверху

Закрепление панели у верхнего края, появившееся в версии 1.0.1, на телефоне

играло против пользователя: развёрнутая панель занимала до двух третей экрана, и

столько же уходило под её отступ - сайт становилось невозможно просматривать.

Теперь решение принимается по замеру: если панель занимает больше трети высоты

экрана, она едет вместе со страницей и уезжает вверх при прокрутке. На широком

экране, где панель занимает около пятой части высоты, всё остаётся как было -

панель закреплена, содержимое опущено под неё.

Значки управления речью

Символы воспроизведения, паузы и остановки заменены рисунками: у символа

воспроизведения была смещена отцентровка внутри кнопки, и в чёрно-белых схемах

он оставался цветным.

Версия 1.0.1

Панель настроек закреплена сверху

Панель больше не уезжает вместе со страницей: она остаётся у верхнего края и

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

Элемент, у которого был собственный отступ сверху, свой отступ сохраняет.

Перекраска в цветовую схему добирается до всей страницы

На крупных витринах часть элементов ниже сгиба оставалась в фирменных цветах:

обход останавливался на середине страницы. Предел поднят с запасом - на витрине

из тринадцати с половиной тысяч элементов теперь перекрашивается всё, и это

занимает около десятой доли секунды.

Меню не рвёт слова

При увеличенном шрифте пункты меню на некоторых шаблонах распадались по буквам:

"КАТАЛО - Г". Теперь слова остаются целыми, а сам ряд меню переносится на

следующую строку.

Значок кнопки следует цветовой схеме

Значок на кнопке "Версия для слабовидящих" был цветным символом и оставался

цветным в чёрно-белых схемах. Заменён на рисунок, который принимает цвет

выбранной схемы.

Иконки в левом меню админки

У пунктов модуля появились собственные значки: глаз - сам модуль, шестерёнка -

настройки, стетоскоп - диагностика, документ - текстовые представления.

Исправления к выпуску

Убраны символы, которые не переживали перевод архива в кодировку cp1251: на

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

Все файлы библиотеки, компонентов и шаблонов закрыты проверкой на подключение

через ядро. Консольная команда массовой обработки документов переехала из

каталога tools в каталог cli.