Оконная оболочка программы Program23

Для удобной работы с классом ODT2HTML предназначена оконная оболочка, которую в зависимости от языка можно запустить с помощью следующих файлов:

• program23_1_0_0_ru.pyw — открывает окно программы Program23 на русском языке. Для запуска необходимо чтобы интерпретатор нужной версии Python автоматически обрабатывал файлы с расширением pyw;
• program23_1_0_0_ru.bat — программа под Windows, позволяющая указать путь к интерпретатору нужной версии Python. По умолчанию прописан путь к Python 3.8, если нужна другая версия, то отредактируйте содержимое файла с помощью текстового редактора (лучше использовать Notepad++). После запуска открывает окно программы Program23 на русском языке. Содержимое файла:

@echo off
start C:\Python38\pythonw.exe program23_1_0_0_ru.pyw

• anaconda_program23_1_0_0_ru.bat — программа под Windows, позволяющая указать путь к интерпретатору нужной версии Python из комплекта Anaconda. По умолчанию прописан путь к C:\Anaconda38, если нужна другая версия, то отредактируйте содержимое файла с помощью текстового редактора (лучше использовать Notepad++). После запуска открывает окно программы Program23 на русском языке. Содержимое файла:

@echo off
set Path=C:\Anaconda38;C:\Anaconda38\Library\mingw-w64\bin;C:\Anaconda38\Library\bin;C:\Anaconda38\Scripts;C:\Anaconda38\bin;C:\Anaconda38\condabin;%Path%
start C:\Anaconda38\pythonw.exe program23_1_0_0_ru.pyw

Оконную оболочку можно запустить из командной строки с помощью следующих команд:

<Путь к python.exe> <Путь к program23_1_0_0_ru.pyw>

Пример:

C:\Users\Unicross>C:\Python38\python.exe D:\projects\python\odt2html\program23_1_0_0_ru.pyw

Фрагмент C:\Users\Unicross> перед командой — это приглашение оболочки для ввода команды с указанием текущего рабочего каталога. В вашем случае каталог будет другим. Лучше сразу сделать текущим каталог с программой Program23. В этом случае путь к программе Program23 можно не указывать, достаточно будет передать только название запускаемого файла:

C:\Users\Unicross>D:

D:\>cd D:\projects\python\odt2html

D:\projects\python\odt2html>C:\Python38\pythonw.exe program23_1_0_0_ru.pyw

Вкладка 1. Основные

Вкладка 1. Основные содержит поля, которые нужно заполнить в приоритетном порядке (для полей с остальных вкладок можно оставить значения по умолчанию):

• поле Путь к файлу .odt — задает абсолютный путь до файла odt. Поле является обязательным. Для указания значения откройте папку с файлом в Проводнике и перетащите значок файла внутрь рамки поля и сбросьте. Путь до файла отобразится внутри поля;
• поле Путь к файлу с шаблоном — задает абсолютный путь до файла с HTML-шаблоном для страниц. Поле является обязательным. Для указания значения откройте папку с файлом в Проводнике и перетащите значок файла внутрь рамки поля и сбросьте. Путь до файла отобразится внутри поля;
• поле Путь к файлу с шаблоном для оглавления — задает абсолютный путь до файла с HTML-шаблоном для оглавления. Если поле не заполнено, то используется значение из поля Путь к файлу с шаблоном. Для указания значения откройте папку с файлом в Проводнике и перетащите значок файла внутрь рамки поля и сбросьте. Путь до файла отобразится внутри поля;
• поле Абсолютный URL для link rel="canonical" — позволяет указать абсолютный URL-адрес, к которому будет добавлено название страницы. Полученное значение вставляется в тег <link rel="canonical" href="Значение">. Это значение используется поисковыми системами для определения уникального адреса страницы. Если поле не заполнено, то тег не создается;
• поле Ключевые слова по умолчанию — задает значение по умолчанию для тега <meta name="keywords" content="Значение">. Ключевые слова указываются по одному на строке или через запятую с пробелом. К заданному значению добавляются ключевые слова, найденные на странице, за вычетом ключевых слов, указанных в поле Запрещенные ключевые слова, расположенном на вкладке 2. Настройки.

Оконная оболочка Program23 на русском языке. Вкладка 1. Основные

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

Вкладка 2. Настройки

Вкладка 2. Настройки (рис. 1.25) содержит поля, позволяющие изменить значения настроек по умолчанию (значения настроек по умолчанию зависят от используемого языка):

• поле Запрещенные ключевые слова — задает ключевые слова, не подлежащие добавлению в тег <meta name="keywords" content="Значение">. Ключевые слова указываются по одному на строке или через запятую с пробелом;
• поле Язык по умолчанию для листингов — позволяет задать язык программирования для листингов, в первой строке которых не указан язык с помощью тега ===codelang=<Название>===;
• поле Префикс для картинок — значение, добавляемое перед названием изображения для создания относительного или абсолютного пути;
• поле Количество пробелов в табуляции — позволяет указать количество пробелов для замены символа табуляция.

Рис. 1.25. Вкладка 2. Настройки

Вкладка 3. Навигация

Вкладка 3. Навигация (рис. 1.26) содержит поля, позволяющие изменить значения настроек по умолчанию для панели навигации (значения настроек по умолчанию зависят от используемого языка):

• флажок Показывать панель навигации — если флажок установлен, то панель навигации будет отображаться, если флажок сброшен — то нет. Флажок следует сбросить, если страницы не связаны друг с другом тематически;
• поле Надпись Предыдущая на панели навигации — текст ссылки, ведущей на предыдущую страницу;
• поле Надпись Следующая на панели навигации — текст ссылки, ведущей на следующую страницу;
• поле Надпись Оглавление на панели навигации — текст ссылки, ведущей на оглавление;
• поле Ссылка на Оглавление — относительный или абсолютный URL страницы с оглавлением;
• поле Расширение файла с Оглавлением — позволяет изменить расширение файла с оглавлением. Расширение добавляется к фрагменту "index.".

Рис. 1.26. Вкладка 3. Навигация

Оконная оболочка программы Program23 позволяет автоматически сгенерировать названия страниц на основе текста заголовков и вставить их в теги. Название генерируются на транслите. Для начала заполните поля на вкладке 1. Основные, а затем перейдите на вкладку 3. Навигация.

Генерация названий страниц

В поле Префикс для ссылок на страницы при необходимости введите нужный фрагмент, который будет добавлен перед названием страницы, например, program23-. Затем нажмите кнопку Загрузить и обработать. Убедитесь, что внутри поля Результат нет описания ошибок. Если ошибки есть, то сначала их нужно исправить. Если ошибок нет, то нажмите кнопку Сохранить названия. В одной папке с файлом ODT будет создана папка с автоматически сгенерированным названием. Внутри этой папки можно найти файл links.txt. Примерное содержимое файла:

===pageend===
===page=program23-sistemnye-trebovaniya.html===

===pageend===
===page=program23-ustanovka-python-3.html===

===pageend===
===page=program23-ustanovka-pyqt5.html===

===pageend===
===page=program23-ustanovka-komplekta-anaconda.html===

Скопируйте пару из закрывающего и открывающего тегов и вставьте её перед заголовком с таким же названием. Стиль абзацев с тегами должен быть Основной текст. При необходимости измените название файла и его расширение. После окончания разметки можно будет разбить документ на файлы, нажав кнопку Загрузить, обработать и сохранить в файлы.

Вкладка 4. Разное

Вкладка 4. Разное (рис. 1.27) содержит следующие кнопки:

• Загрузить и обработать — загружает данные и обрабатывает их. Кнопку следует нажимать при изменении настроек, иначе программа будет работать со старыми настройками и данными. Если возникли ошибки, то они выводятся внутри поля Результат. При этом сохранение обработанных данных в файлы не производится. Чтобы сохранить данные нужно нажать кнопку Сохранить в один файл или кнопку Сохранить в файлы;
• Сохранить в один файл — сохраняет обработанные данные в один файл без разбиения на страницы. Если данные не были загружены и обработаны или изменены настройки, то предварительно нужно нажать кнопку Загрузить и обработать. Результат сохранения отобразится в поле Результат;
• Сохранить в файлы — сохраняет обработанные данные в несколько файлов в соответствии с разметкой внутри файла odt. Если данные не были загружены и обработаны или изменены настройки, то предварительно нужно нажать кнопку Загрузить и обработать. Результат сохранения отобразится в поле Результат.

Рис. 1.27. Вкладка 4. Разное

Сохранение настроек в конфигурационный файл

Изменять настройки нужно перед каждой обработкой. При частом использовании этот процесс может стать утомительным. Чтобы упростить работу с программой достаточно сохранить все настройки в конфигурационный файл. Для этого достаточно нажать кнопку Сохранить настройки в файл, которая расположена на вкладке 4. Разное (рис. 1.28). Путь к сохраненному файлу отобразится в поле Результат.

Чтобы загрузить настройки из конфигурационного файла открываем папку с файлом в Проводнике и перетаскиваем значок файла на поле Путь к файлу с настройками, а затем сбрасываем внутри рамки. Путь отобразится внутри поля. Для загрузки следует нажать кнопку Загрузить настройки из файла. Результат загрузки отобразится в поле Результат.

Рис. 1.28. Сохранение настроек в конфигурационный файл

Вкладка 5. Утилиты

Оконная оболочка программы Program23 позволяет упростить создание тега для вставки изображения. Для этого на вкладке 5. Утилиты перетаскиваем значок файла с изображением из программы Проводник Windows на поле Путь к изображению и сбрасываем его внутри рамки. Поддерживаются следующие расширения файлов с изображениями: .jpeg, .jpg, .png, .bmp, .gif, .tif и .tiff. Путь с названием файла будет отображено внутри рамки. Затем нажимаем кнопку Сгенерировать тег изображения. Сгенерированный тег будет вставлен в поле Результат. Размеры изображения будут вычислены автоматически.

Генерация тега для вставки изображения

Оконная оболочка программы Program23 позволяет упростить создание тега для вставки гиперссылки. Для этого на вкладке 5. Утилиты заполняем поля URL ссылки и Текст ссылки. Если нужно чтобы ссылка открывалась в новом окне, то устанавливаем флажок Открывать в новом окне. Если нужно открывать ссылку в текущей вкладке, то сбрасываем флажок Открывать в новом окне. Затем нажимаем кнопку Сгенерировать тег ссылки. Сгенерированный тег будет вставлен в поле Результат.

Генерация тега для вставки гиперссылки

Оконная оболочка программы Program23 позволяет упростить создание тега для указания языка программирования для листинга. Для этого на вкладке 5. Утилиты вводим название языка в поле Язык программирования и нажимаем кнопку Сгенерировать тег языка листинга. Сгенерированный тег будет вставлен в поле Результат.

Генерация тега для указания языка программирования