Описание дополнительных настроек и сервисных функций расширения Поиск статей на Sci-Hub. Общие принципы управления расширением и запуском поиска в различных режимах.
В этой статье:
Описанные в этом документе опции и настройки соответствуют текущей официальной версии расширения, в более ранних* релизах аддона часть настроек может называться иначе, часть функций в них может отсутствовать.
* Для ознакомления с настройками этих выпусков смотрим соответствующие ссылки в Истории версий расширения.
Расширение не имеет никакого интерфейса, кроме контекстного меню и кнопки на тулбаре. Все настройки выполняются через контекстное меню, отдельной страницы настроек нет (и не будет). Вне зависимости от версии вашего браузера, все функции и опции настроек полностью идентичны.
Изменение настроек выполняется щелчком по требуемой опции в меню, все изменения сохраняются автоматически и применяются сразу же. Перезапуск расширения или иные действия при этом не требуются.
В браузерах версиях старше CR48 все дополнительные настройки и сервисные ссылки будут доступны в контекстном меню страницы только при клике на её свободном месте (т.е. НЕ на ссылке, изображении или выделенном тексте):
В более новых версиях браузеров (48+) настройки доступны всегда – в меню кнопки на тулбаре:
Щёлкните по изображению, чтобы просмотреть скриншот на другом языке.
В контекстном меню страницы в версиях CR48+ оставлен только пункт поиска:
Если у вас установлен режим прямой загрузки (включена опция "Загружать найденное без просмотра"), соответственно изменяется и контекстное меню страницы и действие по умолчанию для горячей клавиши и щелчка по кнопке на тулбаре. Изменённый пункт выглядит вот так:
Кроме вызова из контекстного меню, запуск поиска (или загрузки) по URL текущей вкладки может быть выполнен с помощью горячей клавиши или по щелчку на кнопке расширения на тулбаре:
Начиная с версии 2021.9.18 для решения любых проблем с меню в аддон добавлена функция "Волшебной Кнопки" – ручного принудительного перестроения меню. Вызывается щелчком по кнопке на тулбаре (или по горячей клавише) на любой служебной странице браузера или на любой локальной странице.
После такого перестроения меню выдаётся сообщение:
Кроме решения некоторых частных проблем в отдельных версиях браузеров, эта функция также может применяться и для перестроения меню после смены локали браузера.
Функционально запуск поиска по горячей клавише дублирует запуск по щелчку на кнопке на тулбаре и предназначен для тех, кто привык больше работать с клавиатурой, чем с мышью. Комбинация по умолчанию – Ctrl+Shift+F, её можно изменить в настройках "Быстрых клавиш" браузера:
Начиная с версии 2021.9.18 основная горячая клавиша может быть использована для временного оперативного реверса (смены) текущего установленного режима просмотра/загрузки. Эта функция опциональна* и включается в настройках пунктом "Временная смена режима по хоткею".
* Если у вас есть потребность и в дублировании функции поиска по хоткею (как в предыдущих версиях), но вы также хотите использовать и новую функцию реверса режима, вы можете задать ещё одну горячую клавишу – для стандартного пункта "Активация расширения" (в настройках "Быстрых клавиш" на странице chrome://extensions, например, задать Alt+Shift+F).
В связи с тем, что в некоторых браузерах версий старше CR31 функция вызова по хоткею может частично не работать (из‑за ограниченной реализации API горячих клавиш в этих браузерах), при вызове хоткея производится автопроверка на корректность работы API и, в случае ошибки, выдаётся сообщение о проблеме и предлагаются варианты её решения.
При этом вызов хоткея "ставится на счётчик" и полностью блокируется* после третьей ошибки (например, при третьей попытке вызова "Волшебной Кнопки"). После этого пользователю выдаётся только запрос на включение дополнительного разрешения на доступ ко всем вкладкам:
* Блокировка автоматически снимается при подтверждении разрешения, при обновлении браузера или при полном сбросе настроек расширения, хоткей снова автоматически включается и становится доступен для вызова. Исходя из этого, если вы обновили браузер, вы снова можете попытаться использовать функцию поиска, оперативного реверса режима и/или "Волшебной Кнопки", никаких ручных изменений в настройках для этого не потребуется.
В браузерах версий CR31+ указанная проблема отсутствует, в них можно применять функцию оперативного реверса режима без каких‑либо ограничений.
Предназначена для установки отдельного действия по щелчку по кнопке на тулбаре, отличающегося от вызова по хоткею или из контекстного меню страницы. Ранее действие по щелчку жёстко определялось только комбинацией настроек, для временного выбора другого действия было необходимо их изменение. В текущих версиях можно задать для кнопки любое из действий, оперативно перекрывающих часть текущих настроек.
Пункты группы работают только в контексте URL текущей вкладки и функционально эквивалентны разным наборам настроек, исходя из логики их названий:
"Старое" поведение кнопки, аналогично запуску поиска (или загрузки) из контекстного меню страницы.
Режим открытия зависит только от установки опции прямого просмотра (PDF или страница сайта).
Метод загрузки и создание описания определяются текущими настройками загрузчика.
Метод загрузки и создание описания определяются текущими настройками загрузчика..
Метод загрузки – "автокликером", имя файла определяется настройками загрузчика.
* В любом случае, независимо от настройки "Открывать поиск в новой вкладке".
Принципиально аналогичен вызову пункта меню "Ручной поиск документов на Sci-Hub" (в группе "Общая поддержка поиска", открывает URL, установленный как текущий поиск, для доменов Sci-Hub это главная страница сайта).
На странице поиска выводится только поисковая строка, запуск поиска по клавише <Enter>. В поисковую строку при этом автоматически** подставляется URL текущей вкладки, на которой была нажата кнопка на тулбаре:
** Автоподстановка URL выполняется только для доменов Sci-Hub, для пользовательского движка выдаётся пустая форма поиска (в общем случае, если только он не переопределён как дополнительный домен Sci-Hub).
По умочанию опция включена, запуск происходит сразу же после переключения в меню, равносильно переключению режима с "автощелчком" по кнопке на тулбаре. Может применяться для оперативного выполнения редко используемых действий.
Эта группа разбита на логические части, основная из которых расположена в верхней части меню группы и связана непосредственно с выбором и настройкой поисковых редиректоров. В этой группе опций также есть дополнительные сервисные функции, скомпонованные по отдельным логическим частям (через разделители).
В настройках можно выбрать/изменить URL основного и резервных редиректов и URL пользовательского поиска:
Поскольку домен сервиса периодически изменяется, для сохранения доступа* требуется сброс URL по умолчанию. В качестве оперативной меры, при недоступности сайта сервиса по каким‑либо причинам, также можно переключиться с основного URL поиска (по умолчанию) на резервные (текущие рабочие зеркала сервиса) и наоборот.
* На момент выпуска релиза каждой версии в качестве дефольтных "зашиваются" текущие рабочие URL.
Для удобства пользователей в нижней части меню этой группы добавлен ссылочный переход на страницу с автоматически обновляющимся списком текущих рабочих доменов сервиса.
При изменении настроек поисковых строк следует помнить о том, что если URL:
* Под изменением понимается внесение любого отличия в URL (даже пробела, к примеру), а под удалением – полное стирание URL, т.е. пустая строка.
Для примера – диалог установки базового URL поиска (по умолчанию):
Диалоги изменения других поисковых URL идентичны по логике действий. В случае очистки и сброса URL выдаётся сообщение о сбросе настройки (пример для базового URL поиска):
Диалог установки второго альтернативного URL поиска (второй резервный):
Диалог сброса второго альтернативного URL поиска (второй резервный):
В связи с добавкой локализации в расширение, URL пользовательского поиска по умолчанию теперь зависит от локали. Для англоязычных (en, en-US, en-GB) это домен google.com, для остальных локалей автоматически устанавливается региональный поисковик (для зоны ru, соответственно, это google.ru).
Все остальные функции, настройки и пункты меню полностью идентичны для любой локали и работают независимо от текущего языка браузера. Все ссылочные переходы также не зависят от текущей локали.
При смене языковой локали в браузере следует обязательно сделать перезапуск для перестроения меню.
Это делается выбором пункта "Перезагрузить и устранить ошибки" (в английской локали "Fast Restart and Reset any errors") или с помошью "Волшебной Кнопки".
Особый интерес в этой группе представляет ссылочный переход "Текущий список доступных доменов", ведущий на страницу неофициальной поддержки проекта Sci‑Hub. По заявлению авторов список автообновляется каждые 5 минут.
При необходимости (и после обязательной собственноручной проверки* их работоспособности) вы можете использовать адреса, указанные в этом списке, для замены неработающих поисковых редиректоров.
* Учитывайте, что отдельные зеркала сервиса могут быть недоступны в вашей стране (заблокированы). Для решения проблемы можно использовать расширение UltraSurf VPN RU или другие средства.
Кроме того, на отдельных зеркалах прямой доступ к найденным документам может быть ограничен с помощью капчи. При этом режимы прямого просмотра или прямой загрузки не будут работать. Для решения этой проблемы следует отключать эти режимы и использовать стандартный просмотр и загрузку непосредственно через интерфейс сервиса.
Другие пункты этой группы работают исходя из логики их названий:
В принципе, вместо гугло-поиска по умолчанию здесь может быть задан URL любого из доступных доменов Sci-Hub. Это дополнительно расширяет ваши возможности по прямому поиску документов. Кроме того, в этом случае такой URL используется ещё и при ручном поиске.
Ранее назывался "Домашняя страница проекта". Ссылка открывается в новой вкладке при выборе этого пункта меню.
Официальный ресурс. Предназначен для получения всех идентификаторов научной работы. Ссылка открывается в новой вкладке при выборе этого пункта меню.
По умолчанию автозапуск включен. Выполняется сразу же при переключении поисковика в меню или при изменении любого из URL поиска. Для повышения удобства работы, равносильно выбору поисковика с автощелчком по кнопке на тулбаре. Поиск идёт в контексте URL текущей вкладки, по аналогии с автозапуском действия для кнопки на тулбаре при его изменении.
Ранее назывался "Группа проекта ВКонтакте". Ссылка открывается в новой вкладке при выборе этого пункта меню.
В этой группе расположены все настройки, связанные с загрузкой файлов:
Общие положения: файлы сохраняются в папке загрузок по умолчанию, имя определяется настройками и создаётся автоматически, имя и путь могут меняться вручную при сохранении, выдача диалога сохранения зависит только от настроек вашего браузера и может отсутствовать (автосохранение).
Начиная с версии 2021.11.5 в расширении добавлен метод ускоренной загрузки документов, применимый для всех браузеров версий CR36+ (метод "автоклика").
Этот метод включен по умолчанию, не требует "шаманства" с таймаутами на закрытие временной вкладки и исключает ожидание перезагрузки временной вкладки для получения конечного PDF-файла документа.
Метод основан на создании временного объекта-ссылки в памяти и автощелчка по нему. При этом сам процесс загрузки запускается намного быстрее и не приводит к лишним запросам. Создание ещё одной временной фоновой вкладки и дополнительный автопереход в ней не требуются в случае, если вы уже просматриваете найденный документ, независимо от режима просмотра (прямой просмотр или на странице сайта Sci-Hub).
Метод "автоклика" не применим в некоторых* браузерах версий старше CR36!
* Проверено в SRWare Iron 29/31, в других версиях проверяем работоспособность самостоятельно.
Автоклик может вызывать в этих версиях различные проблемы с загрузкой. В первом случае (CR29) файлы либо не сохраняются совсем, либо сохраняются дважды (в зависимости от настроек аддона и самого браузера), файлы описаний (см.ниже) в принципе отсутствуют. Во втором случае (CR31) автоклик стабильно приводит к падению браузера, если включена опция сохранения описаний (см.ниже) и независимо от других настроек.
В случае каких-либо проблем с загрузкой, этот метод может быть отключён в настройках.
Для этого следует включить опцию "Классический метод загрузки файла". В этом случае загрузчик работает как в предыдущих версиях аддона, всегда с созданием временной фоновой вкладки.
Ниже перечислены все настройки этой группы с необходимыми пояснениями:
Режим предназначен для оперативного скачивания PDF-файлов любых доступных документов (статей) с сервиса Sci-Hub без необходимости ручного ввода запроса. Работает эквивалентно ручному нажатию кнопки "Скачать" на страницах сервиса. Если документ найден, будет автоматически выдан стандартный диалог сохранения файла (при "классическом" методе загрузки имя оригинальное, как есть, при использовании загрузки с "автокликером" имя определяется настройкой "Имя файла по заголовку документа").
При включении режима изменяется контекстное меню, вместо пункта "Найти эту статью на Sci-Hub" будет отображаться "Скачать документ со Sci-Hub", соответственно изменяется и дублирующий пункт в меню кнопки на тулбаре и само действие по умолчанию при щелчке по этой кнопке или при вызове по горячей клавише. Режим просмотра: и режим загрузки:
Конечный PDF-файл при этом не сохраняется, только текстовый файл со ссылками и кратким описанием. Эта опция может применяться при оперативном подборе материалов для "отложенного" изучения. Если при этом напрягают множественные диалоги сохранения, просто отключаем этот запрос в настройках браузера.)
Если выключено, все имена файлов (аннотации, PDF и описания к ним) устанавливаются по оригинальному имени конечного найденного PDF-файла документа. Если включено (по умолчанию), при формировании имени учитывается заголовок вкладки. Все символы, кроме латиницы, кириллицы и цифр заменяются на символы подчёркивания (как и все пробелы, точки и другие знаки препинания). Опция неприменима для "классического метода" загрузки, в этом случае всегда сохраняется оригинальное имя (по PDF-файлу).
Максимум 249 символов, читаем предупреждения об ограничениях в диалоге установки этого параметра.
При выборе этого пункта выдаётся диалог изменения с соответствующими подсказками: Щёлкните по изображению, чтобы просмотреть скриншот на другом языке.
Для удобства работы, при поиске документов. В режиме загрузки вкладка с найденным и загруженным документом остаётся в фоне и не будет автоматически закрыта, вы можете при необходимости просмотреть найденную статью или закрыть вкладку вручную. Автоперевод этой вкладки на прямой просмотр зависит от метода загрузки и определяется текущими настройками.
Относится только к загрузке PDF-файлов (описания всегда сохраняются "автокликом"). Если включено, используется перезапуск фоновой вкладки поиска для вызова диалога сохранения файла (как в предыдущих версиях). Иными словами, при включении этой опции загрузчик работает как в предыдущих версиях аддона, всегда с созданием временной фоновой вкладки.
В этой вкладке производятся все запросы по поиску документов и получению их прямых URL с сервиса Sci-Hub без ручного ввода запроса. В целом, это что-то типа "автоуборки мусора", по умолчанию фоновая вкладка закрывается автоматически через 10 секунд после получения результата (URL конечного документа) и выдачи диалога сохранения файла. Понятно, можно и вручную закрыть, но – "сервис наше всё!"…))
Применимо только к режиму прямой загрузки. Начиная с версии 2021.11.5 этот параметр работает только для "классического" метода загрузки (неприменим для метода "автоклика"). Также эта опция неприменима, если включена настройка "Оставлять вкладку после загрузки". Этот пункт будет недоступен при любой комбинации этих условий.
Не рекомендуется устанавливать задержку меньше 3-5 секунд, иначе могут быть проблемы с запуском загрузки файла.
Эта группа также разбита на логические части, основная из которых расположена в верхней части меню группы и связана непосредственно с настройкой режимов поиска, просмотра и загрузки. Кроме того, в этой группе опций есть дополнительные сервисные функции, скомпонованные по отдельным логическим частям (через разделители):
Начиная с версии 2021.11.5 в расширении добавлены функции для создания резервных копий и восстановления настроек расширения. Вызов функций экспорта/импорта – через отдельный блок действий в этой группе.
Общие положения по резервному копированию и восстановлению настроек:
Вывод результатов поиска либо в новой (по умолчанию), либо в текущей активной вкладке. Для более комфортной работы выключать не рекомендуется (не придётся ждать пока документ будет найден).
Режим открытия зависит только от ваших предпочтений и может быть изменён по текущей рабочей ситуации. Независимо от состояния этого переключателя, по завершению поиска вкладка с результатом автоматически активируется.
Способ открытия поиска зависит и от установленного режима работы (просмотр или загрузка) и применим только к режиму просмотра. Если выбран режим прямой загрузки, промежуточная вкладка для формирования и обработки поискового запроса всегда открывается в фоне и автоматически активируется только в случае ошибки поиска. При этом также изменяется иконка расширения на тулбаре, индицирующая ошибку для конкретной вкладки:
Без особой необходимости отключать эту настройку НЕ рекомендуется, иначе режим просмотра может не всегда отработать корректно – в сочетании с другими настройками И в зависимости от конкретных браузеров и частных условий применения (зависит от поддержки просмотра PDF в браузере, скорости работы сети, общей загрузки системы и т.д.).
Этот совет относится только к режиму просмотра (в том числе – прямого, если у вас включена следующая опция), любые процедуры загрузки файлов и/или аннотаций всегда запускаются в новых вкладках.
Ведён начиная с версии 2021.9.8 (безусловно). При этом сразу же производится второй автоматический редирект, уже непосредственно на сам конечный документ (в формате PDF), который и будет отображён во вкладке браузера. Для удобства пользователя все процессы переходов в этой (и последующих) версиях производятся в фоновой вкладке, которая автоматически активируется* по завершению запроса.
* В случае использования режима прямой загрузки вместо активации вкладки автоматически выдаётся стандартный диалог сохранения файла, а временная фоновая вкладка будет автоматически закрыта по истечению таймаута (при "классическом" методе загрузки время ожидания по умолчанию – 10 секунд, по желанию может быть изменено в Настройках, при выборе метода "автоклика" время ожидания равно нулю и временная вкладка загрузчика закрывается сразу же после получения прямого URL на файл).
Следует понимать, что режим прямой загрузки имеет более высокий приоритет, чем режим прямого просмотра, поэтому он и будет определять необходимость автоматического закрытие вкладки (в соответствии с настройками загрузчика).
Начиная с версии 2021.9.14 режим прямого просмотра сделан опциональным, его можно отключить** с помощью этого пункта. При отключении последний редирект (непосредственно на файл) не производится, открывается и активизируется страница сервиса Sci‑Hub с открытым во фрейме документом (аналогично результату поиска вручную).
** При этом немного сокращается общее время поиска, поскольку второй переход (на сам документ) при этом не нужен. Однако, разница во времени не превышает каких‑то миллисекунд и, в общем‑то, эта опция для тех, кому штатная страница сервиса просто дорога как память "привычнее". :)
Зачем/почему – ранее вызов по горячей клавише полностью дублировал вызов из контекстного меню страницы (поиск по URL текущей вкладки) или по щелчку на кнопке тулбара. Теперь для хоткея можно задать функцию временного переключения режима с просмотра на загрузку и наоборот. По умолчанию опция включена, хоткей отрабатывается с реверсом режима.
Это переключение применимо только на момент вызова и только к конкретному поиску (никакие настройки в меню при этом не изменяются). Функция работает следующим образом: если в настройках включен реверс И установлен режим загрузки – при вызове по хоткею вместо загрузки документа будет произведено его открытие в новой вкладке. И наоборот, если установлен режим просмотра, при нажании хоткея будет выполнена попытка загрузки конечного документа.
Если же опция реверса выключена вызов по хоткею работает точно также, как и во всех предыдущих версиях, и его действие определяется только конкретным установленным режимом. Для удобства работы все вызовы по хоткею отрабатываются теперь в новой вкладке, независимо от заданного режима и других настроек.
Следует помнить, что при вызове по хоткею поиск в любом случае производится только по URL текущей вкладки.
Если у вас есть потребность и в дублировании функции поиска по хоткею (как в предыдущих версиях), но вы также хотите использовать и новую функцию реверса режима, вы можете задать ещё одну горячую клавишу – для стандартного* пункта "Активация расширения" (в настройках "Быстрых клавиш" на странице chrome://extensions, например, задать Alt+Shift+F).
* Должно быть понятно, что это также будет зависеть и от того, какое именно действие вы указали в настройках группы "Действия по умолчанию", при использовании стандартной активации расширения будет выполняться именно оно.
По умолчанию режим включен, автовыгрузка фонового процесса происходит немедленно после завершения запроса или действия. Однако, при активной работе и при частом использовании аддона отключение быстрой выгрузки может немного ускорить вызов и обработку ваших запросов. Надо это вам или нет – попробуйте и решите сами… :)
Предназначена для оперативной проверки работоспособности расширения в различных режимах и с разными настройками. Ссылка открывается в новой вкладке при выборе этого пункта меню.
Ранее этот пункт назывался "Открыть тестовую страницу PubMed", функционально не изменён, переименован по причине того, что теперь это может быть любая произвольная страница любого сайта.)
При выборе текущий URL запоминается и в следующий раз будет вызван при щелчке по предыдущему пункту.
В диалоге дано краткое пояснение, если URL отсутствует, он устанавливается по умолчанию (ссылка): Щёлкните по изображению, чтобы просмотреть скриншот на другом языке.
В диалоговом окне кратко описаны все варианты действий и некоторые пояснения по ним. Щёлкните по изображению, чтобы просмотреть скриншот на другом языке.
Имя и папка размещения выбираются автоматически, файлы по умолчанию сохраняются в вашей папке загрузок. Если не устраивает – выбираем путь и имя вручную в диалоге сохранении файла (в зависимости от настроек браузера диалог сохранения при этом может и не выводиться).
При выборе этого пункта выполняется очистка локального хранилища аддона, все настройки (в том числе – все URL поиска) будут установлены по умолчанию, т.е. аддон приводится в состояние "искаропки". Применяется в ситуациях "что-то у меня поломалось". Во избежание "несчастных случаев" перед этим выдаётся запрос на подтверждение. Щёлкните по изображению, чтобы просмотреть скриншот на другом языке.
Практически, то же самое, что и полный сброс, только без потери настроек. Способ перезапуска зависит от режима "быстрой выгрузки", если он включен – аддон перезагружается полностью, если нет – только перезапуск фонового скрипта. Когда нужен – ну, мало ли.. Например, при смене локали браузера или если вдруг загрузка подвиснет или как-то некорректно будет обработан запрос на поиск. В общем, это "маленькая красная кнопка", на случай каких-то мелких сбоев…)
Функция, проверяющая номер текущей стабильной версии на сайте, сравнивающая его с версией, установленной в вашем браузере, и выдающая по результату проверки соответствующее сообщение: Щёлкните по изображению, чтобы просмотреть скриншот на другом языке.
Если установленная и официальная версия отличаются, выдаётся запрос на переход на страницу ченч-лога текущей официальной версии для ознакомления с изменениями в ней и самостоятельной загрузки и установки обновления.
Начиная с версии 2021.11.5 при этом одновременно выполняется и автозапуск* загрузки CRX-установщика текущей стабильной версии в соответствующем формате (по версии вашего браузера, до версий CR67 всегда грузится CRXv2, для более новых – только CRXv3).
* В зависимости от "огороженности" вашего браузера может потребоваться подтверждение скачивания "опасного файла". :)
В группе опций "Сведения о расширении" доступны некоторые полезные ссылки на документацию по работе с сервисом Sci‑Hub (пункт "Ресурсы и ссылки по Sci-Hub"), а также ссылки на общую документацию по расширению, размещённую на этом сайте. Все эти ссылки всегда открываются в новых вкладках.
В этой же подгруппе опций доступна ссылка на страницу баг‑репорта (для сообщения об ошибках и решения проблем, пункт "Сообщить об ошибке аддона") и постоянная ссылка на ознакомление с изменениями и загрузку установщиков текущего релиза (пункт "Авторская стабильная версия").
Общий алгоритм запуска поиска подробно описан в статье Find Docs in Sci-Hub RU : Поиск статей на Sci‑Hub.
Помимо этого рекомендуется ознакомиться со статьёй Find Docs in Sci‑Hub RU : "Что под капотом", в которой приведены дополнительные технические сведениями по настройке и работе расширения, а также некоторые пояснения по исходному коду этой разработки (для подготовленных пользователей и технических специалистов).
