Хотелось столько всего рассказать, столько всего написать, что теряешься от созерцания горизонтов тем, мыслей, соображений.
Наверно стоило бы рассказывать о компании и о ее проектах, но это может быстро ввести читателя в грусть-тоску. Поэтому первое, с чего мы решили начать, спросить совета.
С ростом проекта WELLtime команда наших разработчиков встала перед несколькими вопросами. Развивающийся программный продукт дал почву для реорганизации линейки предложений, изменения приоритетов между его модулями и подал много интересных идей.
Но это были одни из основных ожидаемых направлений деятельности.
Не думали не гадали мы, и, прямо таки, никак не ожидали мы, что продукт станет ожидать от нас координального обновления справочного материала.
Сделать продукт не просто, но написать к нему грамотный мануал не легче. Возникло много интересных идей и рациональных предложений, но хотелось бы спросить у хабролюдей, что для них является показателем хорошего мануала к ПО?
Простенькая токарная программа в Manual guide i
Источник: habr.com
HelpManual — удобнейшее приложение для работы с документацией – для ее создания, оформления и публикации в самые разные форматы: CHM, WebHelp, PDF, DOCX, EPUB, MOBI и др. По сути это программный комплекс, потому что кроме непосредственно редактора структуры и контента в него входит графический редактор для создания иллюстраций, редактор шаблонов для наведения красоты в PDF и видеограббер для снятия видео с экрана и вставки его в документацию.
Быстрый старт
Чтобы начать новый проект надо кликнуть на кнопку и выбрать, как вы хотите проект создавать — или с «чистого листа», или импортировать из другого формата. Даже если вы выберите чистый проект, то после его создания в левом блоке Project Explorer образуется начальная структура проекта с парой разделов верхнего уровня и несколькими разделами дочерних уровней. Вам теперь предстоит эти раздела переименовать и заполнить свои контентом.
В Project Explorer может быть открыто несколько проектов, которые могут сворачиваться/разворачиваться по клику на их название. В каждом проекте есть Содержание (Table of Contents), Файлы (Projects Files) и Настройки (Configurations).
Projects Files создаются автоматически по мере создания вами новых разделов. Каждый раздел — это новый xml-файл внутри проекта, а при публикации, например, в WebHelp — это новый html-файл на диске. Раздел в проекте имеет свой термин — Topic. Обязательно присваивайте ID каждому топику — это будет имя файла, и по ID можно будет ссылаться на этот топик из других топиков. ID можно задать в окне Topic Options (см. закладку между Project Explorer и самим топиком).
В Configurations регулируются настройки как проекта в целом, так и параметры публикации для каждого формата.
Программа Pythia v.1.0 для прогнозирования рынка. Руководство пользователя.
Все инструменты для манипуляций с Project Explorer расположены на панели верхнего меню Projects. Создавать новые топики, менять их взаимное расположение и иерархию, менять иконки.
Редактирование
При клике на топик в Table of Contents открывается соответствующая топику страница в главном окне. Переключите верхнее меню на закладку Write, которая по своему составу напомнит вам MS Word. Тут вам и карты в руки.
Замечу, что кроме WISIWYG представления в редакторе есть еще XML представление (см. закладку между Project Explorer и самим топиком). Если вы разбираетесь в тэгах HTML и свойствах CSS, то тут можете применить свои знания.
В текст страницы можно вставлять плейсхолдеры, называемые в программе переменными. Это могут быть дата создания документа, его версия, копирайт. Можно также создавать свои переменные.
Уважаемой особенностью программ для создания документации является их способность публиковать проект в самые разнообразные форматы. Но мне лично достаточно двух из представленных восьми в Help+Manual. Это PDF, пожалуй самый универсальный формат, доступный для просмотра практически на любом устройстве.
И формат WebHelp — очень выигрышный формат справки для просмотра из любого браузера. Ну, может быть еще EPUB для любителей читать книги на мобильном устройстве. Эти три формата перекрывают 100% потенциальных читателей.
Удобство для разработчика документации состоит в том, что, имея всего один источник контента, он на выходе получает самые разные представления. Отредактировав текст и иллюстрации один раз, он получает отредактированный текст в разных форматах быстро и надежно. Не надо залезать в восемь документов и в каждом исправлять одно и то же место.
Публикация результата вашего труда начинается с кнопки — после нажатия на нее выбирается формат вывода и нажимается кнопка [Publish Now!]. Посмотрите как это выглядит и, возможно, у вас появится желание кастомизировать форматирование html-страниц. Не обязательно этим заниматься с набором html-файлов, которые вы получили на диске. Это можно сделать в Project Explorer > Configurations > Publishing Options > WebHelp, чтобы закрепить свое форматирование для всех последующих публикаций.
Help Manual Professional — профессиональный программный продукт для создания справочных файлов и документации. Имеет встроенные функции для дальнейшей печати созданной справки. Справочные файлы могут быть сохранены в разных форматах, включая HTML Help, Winhelp, Visual Studio Help и другие.
Возможности создания справочной сопроводительной документации потребуются в основном разработчикам программного обеспечения. В файлах может храниться абсолютно любая информация, включая текст и картинки. Визуальный редактор WYSIWYG XML позволяет изменять шрифт и его размеры, проводить форматирование текста и вставлять изображения в документацию.
Стоит отметить, что редактор для создания документации поддерживает работу с шаблонами, а также с несколькими локализациями. Таким образом, созданное пособие может иметь несколько языков. Используйте комментарии и заметки, управляйте графической и текстовой информацией, создавайте оглавление и структуру справки в полной версии приложения.
Полная поддержка UNICODE;
Многофункциональный редактор WYSIWYG XML;
Вставка изображений, оглавлений, ссылок;
Работа с текстом (выделение, изменение стиля и шрифта и т.д.);
Поддержка добавления нескольких локализаций для справки;
Сохранение документации в форматах Visual Studio Help, Winhelp, HTML Help, MS HELP, Pdf;
Работа с шаблонами;
Есть русификатор интерфейса для программы;
Интуитивно понятный интерфейс.
Источник: pcprogs.net
Мануал
Мануал (англ. user manual) — руководство пользователя — документ, в подробностях описывающий работу с какой-либо программой или устройством.
Назначение мануала — максимально доступно разъяснить пользователю, что и как делается в этой программе или устройстве. Для этого используются упрощённые описания, картинки, а в случае с программами и снимки экрана.
К примеру, если бабушка Сима приобрела МФУ (принтер-сканер-копир), то чтобы запустить его, ей придётся открыть большой, сложенный в несколько раз лист бумаги, на котором разработчики в подробностях описали, как распаковать этот МФУ, убрать из него все обёртки, подключить к сети и компьютеру и начать пользоваться.
Мануалы к серьёзным программам обычно поставляются в электронном виде на компакт-дисках и на сайте разработчика.
Источник: www.bestfree.ru
Help Manual представляет собой многофункциональный комплекс, позволяющий создавать разнообразные справочные руководства, в нескольких системных форматах. С помощью этой программы пользователи значительно упростят свою задачу, а так же выполнят ее в максимально короткие сроки, с высокой эффективностью.
Создание руководства здесь происходит при помощи заранее готовых шаблонов, что позволяет значительно сэкономить время человеку, не затрачивая его на разработку структуры проекта. Однако так же шаблон можно сделать и самостоятельно, для этого пользователю будут предложены десятки разнообразных инструментов и функций.
Пароль к архиву : 1progs
04.09.2020 в 11:05
Справка на русском к Help Manual 7.5.3 Build 4740 НЕ НА РУССКОМ ЯЗЫКЕ а НА АНГЛИЙСКОМ И НЕМЕЦКОМ
28.04.2020 в 17:34
для составления учебно методического пособия, лекции и практического занятия
