Что такое мануалы в софте

Что такое хороший мануал к ПО?

Хотелось столько всего рассказать, столько всего написать, что теряешься от созерцания горизонтов тем, мыслей, соображений.

Наверно стоило бы рассказывать о компании и о ее проектах, но это может быстро ввести читателя в грусть-тоску. Поэтому первое, с чего мы решили начать, спросить совета.

С ростом проекта 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#128215; Документация Helphttp://www.newart.ru/htm/myzavr/mz124.php» target=»_blank»]www.newart.ru[/mask_link]

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

для составления учебно методического пособия, лекции и практического занятия

Сохранить:

Источник: kmsauto2020.ru

Что такое мануал?

Категория:
Что такое?

– Автор:
Игорь (Администратор)

В рамках данной заметки, я расскажу вам что такое мануал, а так же некоторые особенности. И начну с определения.

Мануал (Manual) — это, в ИТ сфере, руководство пользователя по использованию какой-либо программы, сервиса и тому подобного. Если говорить простыми словами, то это нечто вроде «инструкции для чайников» или «инструкции по применению».

Зачем нужен мануал? Данный документ обычно содержит подробное описание основных возможностей описываемого объекта (программы, сервиса и т.п.). Кроме того, в него могут входить инструкции для решения типовых проблем, различные нюансы использования и прочее, что только может понадобиться пользователю.

В каких ситуациях применяется термин мануал? Чаще всего слово мануал совмещают с такими словами как «смотри», «читай», «изучай» и подобными. Как бы указывая пользователю, что решение проблемы можно найти в документе и, в ряде случаев, что не стоит пытаться «повесить» свои проблемы на других людей (обычно, из-за лени).

Примеры для понимания. Позитивный. Допустим, у пользователя возникла проблема с программой и он спрашивает людей на форуме как с ней справиться. Ему пишут «не знаю, посмотри мануал», что можно перевести как «ранее не сталкивался с подобным и не представляю что можно сделать, но наверняка полезную информацию можно будет найти в руководстве пользователя». Негативный. Допустим, программа небольшая и, соответственно, у нее небольшой мануал. И вместо того, чтобы изучить документ и настроить как требуется (и проявить хоть какую-либо активность), пользователь жалуется в форуме что ему нужно настроить и что он не знает что делать (при чем вопрос достаточно простой). Ему пишут «читай мануал», что можно перевести как «будьте добры, проявите элементарную самостоятельность, почитайте мануал и не забивайте своими пустяками другим голову».

Тем не менее, стоит знать, что у данного термина существуют иные значения. Например, под словом «мануал» могут подразумевать клавиатуру органа.

Так же советую ознакомиться с обзором Как правильно задавать технические вопросы.

Понравилась заметка? Тогда время подписываться в социальных сетях и делать репосты!

Что такое хороший мануал к ПО?

Хотелось столько всего рассказать, столько всего написать, что теряешься от созерцания горизонтов тем, мыслей, соображений.

Наверно стоило бы рассказывать о компании и о ее проектах, но это может быстро ввести читателя в грусть-тоску. Поэтому первое, с чего мы решили начать, спросить совета.

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

Но это были одни из основных ожидаемых направлений деятельности.

Не думали не гадали мы, и, прямо таки, никак не ожидали мы, что продукт станет ожидать от нас координального обновления справочного материала.

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

Итак, вы создали программное обеспечение, которое собираетесь продать и неплохо на этом заработать. Программа, скомпилирована, отлажена и протестирована. Единственное, чего ей не хватает, — это файла помощи. Ни одно серьезное программное обеспечение не обходится без модуля справочной информации и руководства пользователя. Это придает программе законченный вид и показывает заботу о пользователе. В этом обзоре будет рассмотрена программа Help&Manual от компании EC Software, способная генерировать help-файлы самых различных форматов.

Главным преимуществом программы является ее универсальность. С ее помощью можно получить файл справочной информации в любом из наиболее распространенных на сегодняшний день форматов (CHM, HLP, HXS, HTML, PDF, RTF, EXE, XML). Интуитивно понятный интерфейс делает программу простой в освоении. Основной блок программы составляет текстовый редактор, мало отличимый от MS Word как по интерфейсу, так и по количеству возможностей.

Интерфейс программы

Интерфейс состоит из двух областей. Первая – это панель Navigation с древовидной структурой содержания файла. Вторая – редактор страниц.

В дереве задается вся структура файла содержания, так как его будет видеть пользователь. Здесь задаются заголовки папок и страниц. Для каждого элемента дерева можно задать собственную иконку и статус. В зависимости от статуса элемент выделяется своим цветом (желтый — редактируется, голубой — требует доработки, белый — готов), тем самым делая работу по наполнению страниц более наглядной.

Редактор страниц состоит из трех закладок: Topic Options (опции), Page Editor (редактор страницы), XML Source Code (исходник в формате XML).

Главное окно программы

На первой закладке определяются основные параметры текущей страницы: идентификатор страницы, идентификатор окна, в котором она будет открываться, ключевые слова, якорь по умолчанию, компиляторы, включающие данную страницу в конечный файл.

Вторая закладка – это непосредственно сам редактор, на котором пользователь пишет текст, форматирует его, добавляет таблицы, рисунки, медиафайлы, ссылки, якоря и прочее.

Третья закладка – это исходный текст страницы в формате XML. При желании пользователь имеет возможность редактировать страницу прямо в исходнике или добавлять сюда код, который невозможно ввести с помощью редактора (хотя такое трудно себе представить).

Рассмотрим некоторые важные инструменты редактора.

Якоря

Якорем в программе называется невидимая метка в тексте страницы, к которой будет осуществляться переход по ключевому слову или по гиперссылке. Добавляя якорь, мы указываем для него идентификатор и ключевые слова. Все ключевые слова, указанные как целиком для страниц, так и для якорей, будут выводиться на странице «Указатель (Предметный указатель, Index) сгенерированных файлов помощи». Щелкнув по выбранному ключевому слову, будет осуществлен переход к объекту, на который то ссылается: страницу или якорь.

Окно добавления якоря

Гиперссылки

Гиперссылки здесь выполняют ту же роль, что и в интернет-браузере, – осуществляют переход на указанную страницу. Гиперссылки могут быть четырех типов.

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

  Окно добавления гиперссылки

• Интернет-ссылки. В этом случае здесь указывается адрес страницы или электронной почты. Для первого варианта можно задать, в каком окне страница будет открываться: в том же или в новом (имеет значение только для файлов CHM, HTML и XML). Причем адрес должен быть полным (например, http://www.yandex.ru , а не www.yandex.ru). Для второго варианта будет создаваться электронное письмо с исходящим адресом, указанным в ссылке.
• Ссылки на файлы. Указывается файл, который будет открываться при переходе по ссылке.
• Ссылка на скрипт. Для этого случая в параметрах ссылки пишется выполняемый скрипт или макрос.

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

Условия

Если есть необходимость добавить в проект текстовый блок, который должен отображаться только в избранных форматах файлов помощи, то на помощь придет инструмент «Условие».

Окно добавления условия

В параметрах этого инструмента выбираются форматы компилируемых файлов и ставится логическое условие IF, IFNOT или ELSE (если, если не, иначе). После применения этого инструмента выделенный текстовый блок заключается в красные маркеры.

Текстовые переменные

В параметрах проекта можно задать несколько предопределенных параметров, таких как заголовок, автор, копирайт, номер версии и т. д. Эти параметры можно выводить на страницах с помощью текстовых переменных. Кроме предопределенных параметров можно добавлять собственные текстовые параметры, которые также будут доступны в списке переменных.

Окно добавления текстовой переменной

Комментарии

При написании помощи нередко ее автору требуется вставить на страницу текст, интересный только ему. Эту роль в программе выполняет инструмент «Комментарий». Он вставляет на страницу текстовый блок желтого цвета, который при компиляции файла игнорируется.

Свойства проекта

В окне свойств проекта можно задать основные настройки будущего файла помощи. Все настройки разбиты на девять групп.

Окно параметров проекта

В первой группе задаются свойства, не зависящие от формата будущего файла. Это значения текстовых переменных (как предопределенных, так и заданных дополнительно), настройки языка, шрифт по умолчанию, каталоги с картинками, собственное хранилище картинок и прочее.

По умолчанию в программе определено одно окно с идентификатором Main. Пользователь имеет возможность добавлять новые окна и задавать для каждого из них собственные настройки. Все это делается во второй группе настроек. Здесь задаются такие параметры, как наличие у окна заголовка, цвета фона, позиция. Для файлов формата CHM и HLP здесь можно настроить набор кнопок, которые будут доступны в окне файла помощи.

Следующие семь групп содержат индивидуальные настройки для каждого формата файла помощи. Например, параметры страницы для RTF или доступность текста для выделения и копирования в файле eBook(EXE).

Внешние компоненты

Из дополнительных средств Help&Manual хочется обратить внимание на три внешние компоненты, помогающие в написании инструкции.

Первая – это мощный фотограф скриншотов Screen Capture. Данная утилита позволяет делать снимка произвольной области экрана и даже отдельных элементов интерфейса: панелей инструментов, областей ввода и прочего. Более подробно, в качестве самостоятельного приложения, она описана в статье «Фотографируем окна».

Второй инструмент – это редактор шаблонов Print Manual Designer для будущих файлов в формате PDF. Здесь можно задать разметку страниц и с помощью текстовых переменных определить, как будет выводиться исходный текст в будущем файле. Шаблон, созданный в этом редакторе, сохраняется в файле MNL и в свойствах проекта подключается к настройкам формата PDF.

И последнее приложение, на которое следует обратить внимание, — это графический редактор Impict. Это довольно простой (но не примитивный) и удобный графический редактор, достаточный для нужд написания документации. Оперируя небольшим набором графических примитивов, данная утилита позволяет с легкостью создавать схемы, рисунки и диаграммы, а накладываемые эффекты позволяют сделать каждый объект изображения по-своему уникальным. Из объектов, создаваемых редактором, особо хочется выделить объект «Лупа», позволяющий увеличить изображение, на которое он накладывается. Этот инструмент будет очень полезен при работе со скриншотами с большим количеством мелких деталей.

Компиляция файла помощи

Когда текст справки набран, содержание наполнено, ссылки, якоря и изображения расставлены, можно приступить к компиляции конечного файла. В окне компиляции нужно выбрать формат конечного файла, указать его имя и расположение. После чего нажать кнопку «OK». И все! Через несколько секунд готовый файл будет перед вами.

Окно компиляции

Удобной особенностью режима компиляции является возможность включения в скомпилированный файл опций файлов других форматов. Например, в исходном тексте у вас присутствуют условия, выводящие текстовые блоки только для файлов HLP. Но однажды вам понадобилось собрать файл в формате PDF и включить туда упомянутые текстовые блоки. Для этого вам не понадобится переписывать исходный текст проекта, достаточно в окне компиляции выбрать формат файла PDF и поставить галочку Classic Winhelp (.HLP). Cледует заметить, что для компиляции файлов CHM и HLP понадобятся собственные компиляторы. Если они не установлены в системе, их можно скачать здесь.

Резюме