TCSumatraPDF 1.17

Плагин TCSumatraPDF предназначен для просмотра файлов AI, AZW, AZW3, CB7, CBT,
CBR, CBZ, CHM, DJV, DJVU, EPUB, FB2, FB2Z, FBZ, KF8, MOBI, PDB, PDF, PRC, TCR,
XPS, ZFB2 при помощи программы SumatraPDF.
Плагин позволяет использовать SumatraPDF обеих разрядностей x86 и x64.
Причем их можно использовать как с Total Commander x86, так и с x64.
Можно использовать SumatraPDF одной разрядности сразу для обеих разрядностей
Total Commander.
Главным отличием плагина от аналогов является корректная работа клавиши Esc для
SumatraPDF x86 в Total Commander x64 и двойное использование клавиш '4', 'N' и
'P', которые имеют важное значение как для управления TC Lister, так и для
управления SumatraPDF.
В основном окне плагина клавиша '4' работает как в TC Lister и служит для
перебора плагинов просмотра. В закладках SumatraPDF клавиша '4' служит для
навигации по документу.
При просмотре одного документа клавиши 'N' и 'P' работают как в SumatraPDF и
служат для навигации по документу. В случае запуска для просмотра группы
выделенных файлов, клавиши 'N' и 'P' работают как в TC Lister и служат для
перелистывания списка файлов.
ВНИМАНИЕ: Для нормальной работы плагина необходимо в SumatraPDF-settings.txt
изменить значение параметра UseTabs = true на UseTabs = false и параметра
RememberOpenedFiles = true на RememberOpenedFiles = false.

Установка.
Плагин устанавливается стандартными средствами Total Commander.
Поддерживается автоматическая установка.
Плагин может использовать переносную или установленную в систему SumatraPDF.
Для использования переносной версии SumatraPDF в папке плагина TCSumatraPDF
автоматически создается подпапка \SumatraPDF.
Программу SumatraPDF https://www.sumatrapdfreader.org/download-free-pdf-viewer
распаковать в подпапку \SumatraPDF. Файлы из распакованного архива, в имени
которых указана версия программы типа SumatraPDF-3.4.6-32.exe или
SumatraPDF-3.4.6-64.exe, необходимо переименовать в SumatraPDF и SumatraPDF64
соответственно. Если необходимо использовать полное наименование файла,
необходимо прописать путь к ним в файле sumatrapdf.ini. Описание его приведено
ниже.
Плагин готов к работе. Можно начать просмотр файлов с помощью клавиш F3 или
Ctrl+Q.
Для установленного SumatraPDF необходимо прописать пути к его исполняемым файлам
SumatraPDF.exe в файле sumatrapdf.ini, который автоматически создается в папке
плагина после первого его использования.
Если при первой установке плагина необходимо немедленно прописать путь к
исполняемым файлам SumatraPDF, создайте файл sumatrapdf.ini вручную или
переименуйте и отредактируйте файл sumatrapdf.sample.ini.
В дальнейшем, при обновлении плагина sumatrapdf.ini не перезаписывается и хранит
настройки путей к SumatraPDF. В файле sumatrapdf.sample.ini перечислены
возможные варианты путей к SumatraPDF.
При установке SumatraPDF в защищенные папки необходимо убедиться, что доступ к
файлам SumatraPDF открыт.
По умолчанию в sumatrapdf.ini создается пустая секция [Options] для
использования переносной версии SumatraPDF. В этом случае файлы SumatraPDF
ищутся в подпапке \SumatraPDF плагина.
Даже для переносной версии SumatraPDF необходимо прописать путь к исполняемому
файлу, если разрядности SumatraPDF и Total Commander  не совпадают.
Файл настройки SumatraPDF SumatraPDF-settings.txt создается автоматически при
первом использовании плагина. Файл настройки общий для обеих разрядностей
SumatraPDF. Пользователь может по своему усмотрению изменять настройки
SumatraPDF, но опция UseTabs, имеющая по умолчанию значение true, должна быть
изменрена на UseTabs = false. Иначе нормальная работа плагина не гарантируется.
Так как использовать опцию UseTabs = true в плагине нельзя, для удобства
использования плагина есть возможность использовать разные файлы настройки
SumatraPDF-settings.txt для каждого режима просмотра. И отдельный файл настройки
для режима обычного запуска SumatraPDF. Файлы настройки SumatraPDF-settings.txt
для режимов Lister и QuickView должны находиться в отдельных папках, путь к
которым прописывается в переменных DirIniL=, DirIniQ= файла настройки плагина
sumatrapdf.ini. По умолчанию переменные DirIniL=, DirIniQ= не создаются и
используется основной файл SumatraPDF-settings.txt для всех режимов.
При задании пути к SumatraPDF допускается использовать переменные типа
%COMMANDER_PATH%.

ВНИМАНИЕ: Для нормальной работы плагина необходимо в SumatraPDF-settings.txt
изменить значение параметров UseTabs = true на UseTabs = false и
RememberOpenedFiles = true на RememberOpenedFiles = false.

Условия распространения.
Это программное обеспечение (ПО) распространяется по принципу "КАК ЕСТЬ"
("AS IS") и является бесплатным для некоммерческого использования. Автор не дает
никаких гарантий по работе этого ПО и не несет никакой ответственности при его
использовании.

История изменений.
Версия 1.17:
 * внутренние изменения.
Версия 1.16:
 * внутренние изменения.
Версия 1.15:
 * исправлено поведение фокуса для запароленных файлов.
 * внутренние изменения.
Версия 1.14:
 * для корректной работы плагина с версией SumatraPDF 3.6.16761 pre-release
больше не требуется файл настройки из архива плагина.
 * внутренние изменения.
Версия 1.13:
 * исправлен просмотр chm-файлов в версии 3.6.16761 pre-release. Работает только
с приложенным в архив плагина файлом настройки SumatraPDF-settings.txt из папки
SumatraPDF. У файла SumatraPDF-settings.txt обязательно должен быть установлен
атрибут "Только для чтения".
 * внутренние изменения.
Версия 1.12:
 * внутренние изменения.
Версия 1.11:
 * внутренние изменения.
Версия 1.10:
 + переключение между окнами Total Commaner и приложения клавишами Ctrl+TAB.
Версия 1.9:
 * внутренние изменения.
Версия 1.8:
 * поддержка SumatraPDF v3.6.15944 Git-ca6bf0185, вложенной в архив. С этой
версией SumatraPDF правильно работает просмотр chm-файлов.
 * внутренние изменения.
Версия 1.7:
 + добавлены новые опции в файл настройки плагина sumatrapdf.ini DirIniL=,
DirIniQ=. Теперь для каждого режима просмотра можно настроить свой файл
SumatraPDF-settings.txt.
 * внутренние изменения.
Версия 1.6:
 * решена проблема с фокусом в режиме быстрого просмотра при использовании
плагина с SumatraPDF версии новее 3.4.6.
 + добавлена обработка клавиш 1..8.
 * внутренние изменения.
Версия 1.51:
 * внутренние изменения.
Обратите внимание, что в версии SumatraPDF 3.4 клавиши 'N', 'P' по умолчанию не
работают для навигации внутри файлов при русской раскладке клавиатуры. Если эта
функция необходима, следует пользоваться версиями SumatraPDF 3.1, 3.2, 3.3, либо
переключаться на английскую раскладку клавиатуры.
Версия 1.5:
 + клавиши '4', 'N', 'P' используются и в SumatraPDF и в TC Lister, в зависимости
от ситуации.
Версия 1.4:
 * внутренние изменения.
Версия 1.3:
 * внутренние изменения.
Версия 1.2:
 * файл sumatrapdf.ini больше не перезаписывается при автоматической установке
плагина. Если он отсутствует, то создается новый файл со значениями по
умолчанию. Если файл sumatrapdf.ini существует, значения берутся из него.
Версия 1.1:
 * увеличена скорость работы.
Версия 1.0:
 * публичная версия.

Автор: Valery Kurenkov.