EWriter — это формат справки и электронных книг для Windows от разработчика Help+Manual, компании EC Software. Несмотря на то, что формат EWriter не так популярен, как CHM и WebHelp, внешний вид документа EWriter как вызывал, так и вызывает много вопросов. В этой статье я расскажу, как настроить внешний вид окна документа в формате EWriter.
Что есть что
Для начала разберемся, что есть что в окне EWriter, и о каких настройках пойдет речь. Для примера возьмем WebHelp, развернутый здесь (исходник можно скачать по ссылке) и соберем из него документ в формате EWriter. Подробную информацию об устройстве EWriter смотрите в материале Формат EWriter. В статье можно ознакомиться с другими вариантами дизайна EWriter, а также с инструментами для его сборки. После сборки будет открыто окно с документом примерно следующего вида.
Все, что отображается внутри окна, это WebHelp (веб-сайт, веб-приложение). В этой статье настроек внешнего вида WebHelp я касаться не буду.
В этой статье я расскажу, как настроить меню, и где задать название документа, которое отображается в строке заголовка окна EWriter. На рисунках выше показан их вид по умолчанию.
Еще один важный нюанс. Чтобы получить документ EWriter такого вида, я использовал первую версию бесплатного сборщика EWriter - The eBook Compiler для Windows XP и Vista. Последняя актуальная версия сборщика 2.6 (для Windows 7 – 11, скачать можно здесь) по умолчанию дает внешний вид, как показано на следующем рисунке. Но плоский дизайн – это дело вкуса.
Как настроить меню
Чтобы настроить меню, в окне сборщика EWriter - The eBook Compiler перейдите на вкладку Menu.
Чтобы отключить меню, снимите соответствующий флажок:
- Include an Application Menu – отключить главное меню.
- Browser window has custom right-click menu – отключить контекстное меню.
Чтобы настроить меню, выделите его элемент (название меню, команду или разделитель) и в области справа задайте необходимые настройки. Для кнопки, открывающей меню, можно задать свое название (в поле Caption), а также выбрать цвет фона и цвет шрифта.
Выделенный элемент меню можно переместить вверх / вниз / в подменю (если подменю добавлено). Можно задать тип элемента меню, его название и команду. Выделенный элемент меню можно также удалить. При необходимости в меню можно добавить новый элемент, разделитель или подменю. Кнопка Reset позволяет сбросить все пользовательские настройки меню.
Поддерживаются следующие типы элементов меню:
- Command - Команда – для команды далее нужно выбрать одну из поддерживаемых команд.
- Page link - Ссылка на страницу документации – выбрать HTML-файл документа.
- Web-link - Ссылка на веб-ресурс – ввести ссылку.
- Execute external file - Вызов внешнего файла – позволяет запустить программу или открыть внешний файл; ввести путь к файлу, имя файла и параметры его вызова.
- Submenu - Подменю – указать название.
- Splitter - Разделитель.
При помощи элемента Web link можно создать пункт меню Обратная связь, который будет запускать почтовую программу, выбранную в ОС Windows для работы с почтой по умолчанию, создавать письмо с заданными адресом и темой. Формат ссылки следующий:
Код:
mailto:e-mail?subject=Вопрос по книге о HelpNDoc
Для типа элемента меню Command можно выбрать следующие команды:
- :home– позволяет открыть страницу документа, заданную для открытия по умолчанию при запуске файла EWriter; элемент меню можно назвать Главная или Домой.
- :back – перейти к последней открытой странице; Назад.
- :forward – перейти к следующей странице; Вперед.
- :selectall – выделить весь контент на странице; Выделить всё.
- :copy – копировать выделенный контент в буфер обмена; Копировать.
- :print - распечатать текущую страницу; Печать.
- :exit – закрыть электронную книгу; Выход или Закрыть.
В настройках безопасности на вкладке Protection (Защита) можно запретить копирование контента и печать страниц электронной книги. В этом случае команды Выделить все, Копировать и Печать в меню электронной книги будут неактивными. А кнопка Печать в строке заголовка окна будет скрыта.
Контекстное меню настраивается аналогичным образом.
Как задать название документа
Название документа, которое отображается в строке заголовка окна EWriter, по умолчанию My eBook title, задается на вкладке Source (Исходные данные) в поле Book title (Заголовок книги). Обратите внимание на флажок Display title of HTML pages in eBook title bar (Отображать заголовок HTML-страницы в строке заголовка окна электронной книги). По умолчанию он помечен. При таких настройках пользовательский заголовок книги будет отображаться только во время запуска файла электронной книги, то есть первые несколько секунд. Когда будет открыта страница книги, выбранная как страница по умолчанию, в строке заголовка окна появится заголовок текущей страницы. Далее в строке заголовка окна будут отображаться заголовки страниц, выбранных в содержании.
Сборка EWriter из проекта Help+Manual
Документацию в формате EWriter можно также собрать из проекта Help+Manual. Настройки, аналогичные описанным выше, можно найти в дереве проекта, выбрав Configuration \ Publishing Options \ eBooks ..\ EWriter eBooks for Windows. Пользовательский интерфейс с настройками меню на вкладке Menus and Translation (Меню и перевод) такой же, как в сборщике EWriter - The eBook Compiler.
Название документа, которое отображается в строке заголовка окна EWriter, задается в поле Help title в настройках проекта Configuration \ Common Properties \ Title & Copyright.
