OneClickHelp: самое простое создание справок

Автор: Артем Левичев
Опубликовано: 24.10.2013
Источник: SoftKey.info

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

Давайте посмотрим, как всё это работает.

Установка

Системные требования у данной утилиты не такие низкие, как можно было подумать. Всё потому, что для её работы вам совершенно необходимо иметь пакет MS Office. Точнее – программу MS Word, из которой и будут загружаться данные для преобразования в справку. А её разновидность для 2013 года, к примеру, нуждается минимально в 1 Гб ОЗУ и процессоре с частотой в 1 ГГц. Понятное дело, OneClickHelp работает только под ОС Windows. А еще для нормальной службы ей необходим пакет Microsoft .NET Framework 3.5. Как вариант вместо Word может сгодиться другой текстовый редактор, позволяющий сохранять данные в формате HTML, однако вся инструкция в программе написана именно под Microsoft, и именно под него, насколько я понимаю, утилита тестировалась. Лучше для начала скачать с Softkey.ru бесплатную версию приложения и проверить, насколько хорошо оно будет работать с файлами, полученными из вашего редактора.

Инсталлятор OneClickHelp, два файла в ZIP-архиве, занимает 13,6 Мб. Процесс установки – довольно типичен. Язык – только английский, хотя сама программа по умолчанию открывается на русском. После подписания лицензионного соглашения нам предлагается выбрать папку для установки (что уже серьезный шаг вперед по сравнению с тем, что предлагала нам утилита ArtScope от той же компании). А вот простановкой ярлыков на рабочий стол и в меню "Пуск" мы никак не управляем: они по умолчанию размещаются везде, где только можно, что, конечно, не радует. На самом диске утилите требуется 6,62 Мб. Очень скромно.

Интерфейс

Настроек у программы минимум. Фактически всё, что нам может понадобиться, располагается на главном окне. С ним мы и будем взаимодействовать в процессе работы с программой. Нужно сказать, оформлено всё это довольно неплохо: мы сразу видим, в какое поле следует загрузить файл .doc или .docx, понимаем, где выбрать заголовок для справки и в какую папку будет записан созданный нами проект. Довольно удобно реализован выбор формата для создаваемого документа: в выпадающем списке мы можем определить его как HTML, ASPX, CHM, HxS или сразу CHM и HxS. Также мне очень понравилось, что OneClickHelp позволяет нам сразу же открыть сформированную справку, чтобы посмотреть, вышла ли она такой, как надо. Замечательная опция, которую не мешало бы перенять и некоторым другим утилитам.

Однако у программы есть и очень надоедливые минусы. Даже более того: баги. У меня они присутствуют на обеих машинах с совершенно разными характеристиками (и даже разными ОС – Windows XP и Windows 7), так что по-другому их не назовешь. Первый недостаток проявляется тогда, когда мы хотим изменить размер главного окна. Казалось бы, кнопки здесь почти не занимают места, а длинные поля для работы с утилитой нам не нужны. Так почему бы немного не сжать окошко? Но нет, OneClickHelp такого нам не позволяет, он сопротивляется. Сколько бы вы его ни сжимали, он всё равно моментально разъедется в своё изначальное положение. Как будто у него специально скрипт такой прописан: "если <уменьшили размер окна>, то <вернуть всё как было>, THE END". Лучше бы уж совсем запретили трогать главное окно. Иначе выглядит откровенно криво. Для того чтобы достичь такого странного эффекта, нужно еще постараться. Причем в случае расширения того же окна утилита ведет себя вполне нормально. Да и все прочие окна, кроме главного и "Регистрации" (к примеру, ConfigEditor, "Справка" или окно "О программе"), ведут себя вполне нормально. По какой причине в определенных случаях баг заметен, а в других его нет, видимо, стоит спросить у программистов. Еще хуже то, что это ведь я тестирую версию 1.9.0.0. То есть утилита уже несколько раз обновлялась, а исправить такой простой, казалось бы, недостаток никто так и не додумался. Очень грустно.

Вторая серьезная оплошность – сам процесс конвертирования документа из Word в новый документ-справку. Это ведь самая главная операция, это то, ради чего мы здесь все собрались! А отображается она только маленькой иконкой, неприметно возникающей в нижней части окна. Пока она там торчит, конвертация идёт (в случае с большими файлами она может затянуться даже на минуты). Как только исчезла, можно идти смотреть на свою новую справку. Для начала хотелось бы более серьезного подтверждения работы утилиты. Такого, которое занимало бы, скажем, половину окна OneClickHelp. В нем ведь всё равно в это время ничем другим заняться не получится. К тому же возникает забавная ситуация, если тот файл, который вы хотите обработать через OneClickHelp, оказывается открытым. Утилита не может получить к нему доступ, у неё ничего не получается, но об этом нигде не говорится.

Если вы не поймете, в чем дело, вам может показаться, что программа попросту зависла. Ждать исчезновения мелкой пиктограммы в таком случае можно до бесконечности. А ведь, казалось бы, можно было просто сделать так, чтобы, когда вы пытаетесь сконвертировать открытый файл, перед вами выскакивало окошко с напоминанием – мол, так делать нельзя, закройте Word и попытайтесь еще. Но нет, не додумались, к сожалению. Более того, отменить выполнение конвертации в OneClickHelp тоже нельзя. Попросту не приделали такой кнопки. Так что, если закрывать свой файл вы пока не собираетесь, можно считать, что программа действительно зависла. Впору вызывать диспетчер задач и завершать процесс через него. А потом еще и ошибку к вашему Word-файлу может выдать, так что его придется пересохранять под новым названием! Сколько лишних проблем, которые можно было бы разрешить, "прикрутив" всего лишь одно выскакивающее окошко-напоминалку! Очень хотелось бы, чтобы на этот момент, равно как и на предыдущий, разработчики обратили внимание в последующих обновлениях. У программы есть отличный потенциал, но вот такие мелкие огрехи интерфейса её совсем не красят.

Другие соринки у OneClickHelp тоже есть, однако они не настолько серьезные и на процесс работы никак не влияют. Скажем, в полях "Файл стилей" и "Формат справки", значения для которых выбираются в выпадающем списке, по какой-то причине можно писать. Разумеется, ваш текст там – как пятое колесо, и он сразу стирается, как только вы определяетесь с одним из значений из списка. Но почему туда вообще разрешается что-то вводить – непонятно. А для кнопок в утилите используются стандартные иконки, которые по смыслу подходят далеко не всегда. Ну и окна "Параметры проекта" и "Параметры OneClickHelp", что открываются, если вы зайдете в меню "Редактирование", могли бы быть понятнее. А сейчас нам показывается некий скелет стандартных настроек, подходящий разве что для программистов и продвинутых пользователей. К примеру, если вы захотите изменить язык с русского на английский, нужно будет в одном из полей вместо "ru-RU" самостоятельно написать "en-EN", а потом перезапустить приложение. И это только самое простое, самое базовое! Изменять другие опции окажется ничуть не проще. Почему нельзя было сделать обычные выпадающие списки и избавить нас от необходимости угадывать и вводить символы – очередной вопрос, на который не будет ответа. К счастью, скорее всего, изменение настроек вам и не потребуется: по умолчанию всё стоит довольно правильно.

Впрочем, в интерфейсе OneClickHelp есть и неожиданно приятные моменты. К примеру, документ в Word можно просто перетащить в предназначенное для него поле – и там в результате появится его точный адрес. Это позволяет нам не заморачиваться поиском нужного файла где-то далеко в папках. Очень удобная и полезная функция. Аналогично и с папкой для проекта. В программе есть подробная, очень подробная русскоязычная справка. В ней имеются советы, есть довольно обширный блок вопросов и ответов, есть глоссарий. Есть огромное количество дополнительного текста и даже кода для продвинутых пользователей. Если создание справок понадобится вам для работы, если вы захотите уделить этому много времени - утилита снабдит вас всей необходимой информацией. Ну, еще бы: программа для компиляции справочных файлов просто обязана была иметь самую лучшую в мире инструкцию!

В целом интерфейс у OneClickHelp не идеален, но свою функцию он выполняет. Разобраться с базой можно буквально за пару минут, а если вы захотите вникнуть в эту сферу поглубже – инструменты для этого разработчики опять же предоставили в полном объеме. Самое главное: компиляция справки с такой утилитой превращается в очень простой и незамысловатый процесс. А ведь как много игр и программ сегодня выходят вообще без руководства! Если бы только их создатели знали об этом приложении от HelpSoft...

Работа

Еще перед запуском OneClickHelp нам потребуется создать документ в MS Word (или другом редакторе вроде LibreOffice или Open Office). Там нужно будет сделать несколько заголовков, если вы хотите, чтобы ваш файл со справкой имел нормальное содержание с главами, которые могли бы открываться или закрываться нажатием на плюсик. В текстовом редакторе готовится всё содержание справки: информация, изображения, ссылки на разные источники. Часть текста выделяется жирным шрифтом, другая часть – курсивом. Строятся нумерованные или маркированные списки. В общем, основная работа проходит вообще за пределами утилиты HelpSoft. А потом её результат сохраняется в файле с расширением XML, RTF, DOC, DOCX, HTM или HTML.

Убедитесь, кстати, что имена у ваших разделов не слишком длинные. Если они занимают больше пары сотен символов, это просто вызовет ошибку. К тому же, если вы хотите преобразовать файл из Word в формат HTML, используйте не больше шести уровней заголовков (остальные просто не пройдут компиляцию). И, разумеется, первый уровень у вас всегда должен присутствовать, иначе программе не за что будет "зацепиться".

Рабочая папка с файлами справки

Если у вас есть желание, к справке, помимо навигации, можно добавить и другие дополнительные элементы. К примеру, раскрывающиеся группы текста, фиксированный колонтитул, перемещение между разделами при помощи стрелок, возможность увеличения изображений. Если вы станете продвинутым пользователем OneClickHelp, вы научитесь создавать инструкции в виде слайд-шоу.

Если у вас в одной из папок хранится ваш сайт или его часть – эту папку можно просканировать и создать на её основании справку. А еще при необходимости такие инструкции можно объединять в большие "коллекции" (как их называют сами создатели утилиты), объединяющие все ваши знания, всю информацию в один большой блок со своей навигацией и удобным поиском. Люди, которые потом будут пользоваться вашим сайтом или вашей программой, за такое подробное руководство скажут вам большое спасибо.

Компиляция справки занимает некоторое время – вплоть до пары минут, если документ достаточно большой. К тому же, нередко, если документ в Word подготовлен неверно, при выполнении преобразования возникают ошибки. OneClickHelp хочет, чтобы всё в точности соответствовало инструкции. В оформлении не должно быть ошибок. Поэтому вполне возможно, что первые пару раз при выполнении компиляции у вас ничего не получится. Однако потом, когда вы научитесь правильно оформлять главы и текст в своих документах (что, по идее, не должно занять больше десяти минут), окажется, что создание справок – это самая простая работа на свете.

Покупка

К вопросу оплаты создатели OneClickHelp относятся не слишком жестко. В одной этой утилите, фактически, есть пять программ: одна из них преобразует в справку файлы Word, а другие отвечают за компиляцию или декомпиляцию целых папок или документов в CHM/HxS. Так вот, почти всеми функциями приложения можно пользоваться вообще без получения лицензий. Активация необходима только для самого главного – работы с теми файлами Word, которые по размеру превышают 500 КБ (а именно такие, чаще всего, потребуются вам для создания профессиональной и подробной справки). При этом вы можете скачать бесплатную версию с сайта Softkey или портала разработчиков – и ознакомиться со всеми особенностями данного ПО. Очень удобно.

Но демо-режим – это не единственный бонус, который нам тут предоставляют. Можно оценить полные возможности OneClickHelp еще до проведения платежа! Для этого достаточно скачать бесплатную версию, зайти в меню "Справка" –> "Регистрация" и ввести там ваши имя, фамилию, название фирмы и контактный e-mail. Через пару минут, если у вас есть подключение к Интернету, на вашу электронную почту придет код для получения временной лицензии. Эти циферки вставляются в окошко "Справка" –> BuyNow. Туда же, если что, понадобится вставить и настоящий, пожизненный код, отправляемый после покупки.

После того, как вы убедитесь, что возможности OneClickHelp вам подходят, код программы можно купить в магазине Softkey или в самой утилите, в том же окошке BuyNow (через PayPal или банковскую карту). В общем, в этом плане разработчики постарались: процесс покупки оказывается простым и удобным, а до желаемой цели можно добраться массой способов. К тому же, приятно, что утилита стоит не какие-то баснословные средства: 900 рублей – вполне адекватная цена за ПО, предназначенное, в основном, для использования предприятиями. А если вы покупаете сразу много лицензий, то стоимость каждой отдельной падает практически в разы.

Итоги

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