===================================================================== AJPapps - TXT to HTML converter 3.01 Линда Кайе 2011-2021. Посвящается Ариэль ===================================================================== Эта программа конвертирует текстовые файлы в HTML для просмотра в броузере или выкладывании на вэб сайте. То есть она позволяет по-быстрому сконвертировать файл без потери форматирования и пробелов, не прибегая к помощи больших HTML редакторов. История создания ---------------- Когда-то мне была нужна программа для преобразования большого количества текстовых файлов, чтобы потом их собрать в одной большой свалке в CHM файле. Я бы могла просто оставить их в изначальном виде, только вот Web Browser Control не переносит текст по словам. Поэтому пришлось хитрить ^^ Сегодня от нечего делать решила наконец переписать эту программу. Переписала буквально за несколько часов, не имея исходников под рукой (сначала огорчилась, а потом поняла, что так лучше), а ведь когда-то мне требовалось достаточно много времени чтобы это всё написать ^^ Зато теперь у программы есть GUI и куча настроек. Правда, идея, которая побудила меня начать переписывать эту программу, испарилась бесследно... История изменений ----------------- • 2.00.0004 Первый публичный релиз. • 2.00.0006 [+] Программа поддерживает исходные файлы в кодировках ANSI, UTF-8 и UTF-16. [+] F1 в главном окне открывает этот файл. [+] Косметические изменения в списке выходных кодировок. • 2.01.0008 [+] Вместо двух файлов шаблонов используется один. [+] В шаблоне появился META тэг Description. [+] В шаблоне появился META тэг для нормального отображения на мобильных устройствах. [+] В шаблоне поправлены стили. [+] В готовом HTML на странице как заголовок выводится имя текстового файла. [+] При определении имени выходного файла появилась возможность не добавлять расширение, а заменять. Таким образом вместо Text.TXT.HTM будет Text.HTM. [+] При определении имени выходного файла появилась возможность использовать расширение HTML вместо HTM. [+] При определении имени выходного файла появилась возможность задавать регистр символов. [+] После конвертации программа предложит открыть полученный файл. • 3.00.0024 [+] Переписан интерфейс программы: большинство настроек вынесены в отдельный диалог. [+] Появилась поддержка нескольких шаблонов. [+] Был обновлён шаблон из предыдущих версий. [+] Были добавлены новые шаблоны. [+] Добавлены "встроенные" шаблоны, в которые попадает только сконвертированный текст. [+] Из шаблонов удалены лишние META тэги кроме "Author". [+] Тип тэгов, используемых при конвертации, зависит от выбранного шаблона: HTML4, HTML5, XHTML. [+] При конвертации через командную строку, учитываются настройки имени HTML файла, если таковой не задан вторым параметром. [+] При конвертации URL файла (ярлык интернета), код перехода на страницу, указанную в этом файле, дописывается без запросов. [+] Полностью переписан код конвертации текста в HTML. [+] Код конвертации вынесен в ActiveX DLL, которую смело можно использовать в программах и скриптах. [+] Появилась настройка ширины табуляции. [+] Появилась настройка, позволяющая обнаруживать в тексте ссылки и конвертировать их в HTML тэг A. [+] Появилась настройка сохранения BOM в HTML, если кодировка позволяет. [+] Появилась настройка порядка байт в HTML для кодировки UTF-16. [+] Появилась настройка типа переноса строк в HTML: CRLF, LF и CR. [+] Добавлены иконки 48x48. [+] Добавлена иконка в стиле Windows 8. [+] Обновлены библиотеки. [+] Диалог выбора TXT файла по умолчанию открывает текущий каталог, либо каталог введённого в поле "TXT файл" имени файла. Последний каталог больше не запоминается. [+] Диалог выбора HTML файла по умолчанию открывает текущий каталог, либо каталог введённого в поле "HTML файл" имени файла, либо каталог введённого в поле "TXT файл" имени файла. Последний каталог больше не запоминается. [+] В полях ввода имён файлов работает автозаполнение. • 3.00.0025 [22.04.2021] [+] Обновлены библиотеки. [-] Поправлен баг в определении границ URL'ов. Теперь границей считаются, в том числе, неразрывный пробел и маркер списка. • 3.01.0028 [22.04.2021] [+] Добавлена опция, позволяющая срезать пустые строки в начале и в конце входного файла. Для красоты. Зависимости ----------- Для работы этой программы нужны следующие компоненты: • AJPapps - AJPapps support library 1.00 Файл AJPappsSupport0100.DLL • AJPapps - AJPapps support library FBE 1.00 Файл AJPappsSupportFBE0100.DLL • AJPapps - Common dialogs library 1.00 Файл CommonDialogs0100.DLL • AJPapps - File I/O support 1.04 Файл FileIOSupport0104.DLL • AJPapps - TXT to HTML converter library 1.02 Файл TXT2HTMLLib0102.DLL • AJPapps - Библиотека общих функций 3.05 Файл CommonFunctions0305.DLL • Microsoft Visual Basic Virtual Machine Файл MSVBVM60.DLL Эти компоненты обязательны. Они уже включены в программу установки ^_^ Установка --------- Просто запустите Setup.TXT2HTML.EXE, и программа установки сама создаст все необходимые ярлыки. Использование ------------- Программу можно использовать как из командной строки, так и через диалоговое окно, запустив её без параметров. Чтобы получить справку по параметрам, запустите программу с параметром "/?" (без кавычек). После запуска программы без параметров, появится диалоговое окно, в котором следует указать имя текстового файла, который будет преобразован, и HTML файла, в который будет сохранён результат. После выбора текстового файла, программа автоматически подбирает имя HTML файла, дописывая расширение HTM к имени текстового файла. Однако, можно указать любое другое имя файла самостоятельно. Ниже расположен раскрывающийся список шаблонов, в котором можно выбрать интересующий. От выбора шаблона зависит формат, в который будет сконвертирован текст: HTML4, HTML5 или XHTML. После указания всех имён файлов и выбора шаблона достаточно нажать кнопку "Пуск!", и программа займётся делом ^_^ Настройки --------- Кнопка "Настройки..." открывает диалоговое окно, в котором можно уточнить процесс конвертации текста и сохранения его в HTML файл. Поле "ANSI charset" задаёт имя набора символов, который будет записан в заголовок HTML файла, если в качестве кодировки Вы выберете ANSI. Программа не умеет сама определять язык вашей системы, поэтому придётся указать его ручками. Для России здесь нужно указать "windows-1251". Тут возможен такой фокус. Допустим, у вас есть текстовый файл на японском. Чтобы он сконвертировался правильно, вам нужно выбрать кодировку ANSI и вписать "shift_jis" в поле "ANSI charset". Тоесть по факту текст перекодирован не будет, но броузер будет знать, как его правильно отображать. То же самое можно сделать и с текстами в DOS кодировке, указав "cp866", старыми Linux-текстами - указываем "koi-8r", ну и так далее. В списке "Абзацы" выбираются тэги, которые будут разделять абзацы в HTML файле. Обратите внимание, что "
" отменяет автоматические переносы, и годится для файлов, в которых переносы уже расставлены. Например, книги или RFC документы.

Удаление
--------

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

Маленький копирайт
------------------

1. Программа распространяется бесплатно.
2. Вы имеете право распространять её на тех же условиях.
3. При распространении вы не имеете права менять авторство программы, присваивать его себе или каким-либо иным способом искажать его.
4. Разрешено коммерческое использование программы (в офисе, на производстве) за исключением её платного распространения или сдачи в аренду.
5. Программа распространяется как есть. Автор не несёт ответственности за любые трагедии или несчастные случаи, вызванные использованием программы.
6. Вы имеете право использовать ActiveX компоненты, поставляемые с программой, в собственных программах. При этом автор не гарантирует совместимость будущих версий компонентов.
7. Для любого пункта данного соглашения может быть сделано исключение с разрешения автора программы.
8. По любым вопросам, связанным с данной программой, обращайтесь по адресу lindaoneesama@gmail.com

Контакты
--------

Почта: lindaoneesama@gmail.com
Сайт:  https://www.lindachan.net