Manual что это за программа и нужна ли она

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

Сбор данных не ведется

Разработчик не ведет сбор данных в этом приложении.

Конфиденциальные данные могут использоваться по-разному в зависимости от вашего возраста, задействованных функций или других факторов. Подробнее

Информация

Продавец elero GmbH
Размер 11,6 МБ

Совместимость iPhone Требуется iOS 13.0 или новее. iPad Требуется iPadOS 13.0 или новее. iPod touch Требуется iOS 13.0 или новее. Mac Требуется macOS 11.0 или новее и компьютер Mac с чипом Apple M1 или новее.

Языки английский, испанский, итальянский, немецкий, французский
Цена Бесплатно

• Поддержка приложения
• Политика конфиденциальности

• Поддержка приложения
• Политика конфиденциальности

Источник: apps.apple.com

QA Manual. Что это за профессия? А мне подходит? Чем занимается тестировщик?

Новое в Help and Manual 9

23 ноября 2022 года компания EC Software к 25-летнему юбилею выпустила 9-ю версию программного комплекса Help and Manual (выходит c 1997 года). Комплект шаблонов Premium Pack был обновлен до версии 5. Наряду с HelpXplain, программный комплекс Help and Manual был дополнен приложением Translation Assistant, предназначенным для разработки документации на нескольких языках. Посмотрим на примере сборки 9.0.1 — 6320, что нового приготовили разработчики.

Для пользователей Help+Manual 8

Версия 9 — это бесплатное обновление для всех пользователей Help+Manual 8 с активной поддержкой. В версии 9 используются те же лицензионные ключи, что и в Help+Manual 8. Если срок активной поддержки распространяется на 19 ноября 2022 года включительно, то версия 9 поставляется как бесплатное обновление. Чтобы посмотреть, активна ли поддержка вашей лицензии, выберите Help License and Maintenance.

Лицензия Help and Manual v.9 Professional стоит 798$, обновление с версии 7 — 399$; с версии 8, для которой закончился срок поддержки, — 159,90$.

Приложение Translation Assistant

Программный комплекс Help and Manual был дополнен новым приложением, Help + Manual Translation Assistant (HMTA). Оно предназначено для разработки документации на нескольких языках /перевода документации на иностранные языки. Бета-версия вышла 23 марта 2022 года. 19 октября была выпущена первая версия. До 31 декабря 2022 года приложение будет стоить 98$, далее — 398$.

Подробное описание на английском языке можно посмотреть на сайте разработчика в материале Help + Manual Translation Assistant.

Расширены возможности Help and Manual 9 Basic

В данной версии Help and Manual теперь можно сохранять проект в несжатом формате HMXP. Это сделано для того, чтобы Help and Manual 9 Basic была совместима с новым приложением Translation Assistant.

Новый порядок создания репозитория стилей

В 9-й версии репозиторий стилей (style repository) можно создать из окна создания нового проекта. В предыдущей версии сначала нужно было создать проект, а затем сохранить его как репозиторий стилей.

Предварительный просмотр

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

Поддержка Git

Расширены возможности по работе с системами контроля версий. Добавлена поддержка Git. Начиная с 9-й версии, в Help and Manual используется редактируемый скриптовой интерфейс, поддерживаемый всеми современными системами управления версий. В программном комплексе предусмотрены готовые редактируемые скрипты для Subversion и Git.

Дополнительно предусмотрен шаблон скрипта, вызываемого Help and Manual — его можно использовать для работы с любой системой контроля версий, которой можно управлять из командной строки. Поддержка Subversion, Git или другой пользовательской системы контроля версий включается в настройках Help and Manual.

Стили для рисунков

В Help and Manual 9 реализован пользовательский интерфейс для создания стилей рисунков, аналогично стилям для абзацев или таблиц. Стиль для рисунков обеспечивает единообразное оформление всех рисунков в проекте, к которым применен данный стиль. Можно задать ширину, высоту, границы и выравнивание для подписи к рисунку. Ранее рисунку можно было только присвоить пользовательский CSS — класс (в настоящее время такая возможность также сохранена), либо оформить рисунок в графическом редакторе.

Ссылки на рисунки, таблицы

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

Настраиваемое положение списка рисунков в PDF

В Print Manual Designer в разделе Table of Figures (Tables Tables Section) можно задать настройки, чтобы список рисунков (таблиц и/или др. объектов) располагался до разделов с контентом. По умолчанию он добавляется после блока контента.

Настройки нумерации глав в PDF

В Print Manual Designer для настроек разделов была добавлена дополнительная вкладка с настройками Chapter Numbering (Нумерация разделов).

Внедрение PDF-файлов

В Help+Manual 9 добавлена возможность внедрения PDF-файлов целиком, либо отдельных страниц из них (PDF Snippets). Данный функционал доступен как в проектах, так и в PDF-шаблонах. В выходных PDF-документах внедренные PDF выводятся как PDF страницы, в других форматах – преобразуются в рисунки.

Расширен функционал плагина PDF Review

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

В Print Manual Designer добавлена поддержка прозрачных рисунков в формате PNG. Ранее они поддерживались только в разделах выходных документов.

Поддержка графических форматов SnagIt, PSD, TIFF и др.

Была добавлена в августе 22 года в версии 8.5. Во время установки флажок по умолчанию помечен.

Улучшения в работе плагина DeepL

Добавлена возможность использования собственных терминологических словарей, хранимых на стороне сервера (вкладка API Glossary). Ранее собственные терминологические словари сохранялись локально и не использовались системой машинного перевода. В ходе доработки 8-й версии была добавлена возможность создания собственного списка исключений – терминов, которые переводить не нужно (на вкладке Protected).

Импорт Markdown-файлов

В 9-ю версию добавлена функция автоматического импорта Markdown-файлов в новые и в существующие проекты.

Доработан функционал переменных

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

Проверка путей к файлам и папкам проекта

Нерабочие пути автоматически выделяются красным цветом (Configuration Common Properties Project Search Path).

Google Analytics 4 в WebHelp

В WebHelp добавлена поддержка Google Analytics 4 (старая тоже пока будет работать). Для шаблонов из PP 5 требуется Google Analytics 4.

jQuery 3.6.1. в WebHelp

В CHM и EWriter — jQuery 2.2.4.

ScreenCapture.exe как независимое приложение

Можно создать ярлык, запускать и пользоваться.

Средство просмотра электронных книг eWriter для MacOS 11

26 июля 2022 года вышло средство просмотра электронных книг в формате EWriter для MacOS 11. Таким образом, электронные книги в формате eWriter можно просматривать не только в Windows XP-11, но и на MacOS. Бесплатные средства просмотра, создания, а также комплекты для разработчиков можно загрузить на сайте компании EC Software.

Premium Pack 5

• Добавлены новые шаблоны (всего более 40 шаблонов).
• В 2-х новых шаблонах Cool Max реализована навигация «с клавиатуры» — она будет работать в выходных документах WebHelp.
• Google Analytics 4.

Лицензия на PP 5 стоит 169,80$, обновление с предыдущих версий — 84,90$.

Источник: help-spravka.ru

Cоздание справочной системы или руководства пользователя в Dr.Explain

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

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

Сам иногда занимаюсь help-файлами и не понаслышке знаю, что создание справочной системы занимает время и является кропотливой и нудной работой, особенно документирование интерфейса. Однако пару месяцев назад открыл для себя инструмент, который значительно ускоряет этот процесс. Речь идет о программе Dr.Explain от самарской компании Индиго Байт Системз. Она мне понравилась продуманным интерфейсом и возможностью документировать интерфейс ПО в полуавтоматическом режиме.

Dr.Explain vs. Help and Manual

Итак, Dr.Explain позволяет создавать help-файлы в формате CHM для поставки вместе с приложением, справочные системы в HTML для размещения на сайте продукта, а также руководства пользователя в RTF и в PDF с оглавлениями и ссылками. Справочная система генерируется в разных форматах из единого источника, что позволяет быстро обновлять документацию при выходе новых версий ПО. В этом плане Dr.Explain ничем не отличается от Help and Manual, которой я давно пользуюсь.

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

В дереве задается вся структура help-файла, включая заголовки папок и страниц. Редактор страниц состоит из стандартных инструментов для написания и форматирования текста, а также имеются инструменты для вставки гиперссылок, картинок, таблиц и переменных. Все это есть и в Help and Manual, но панель инструментов в Dr.Explain скомпонована, на мой взгляд, более продуманно.

Рисунок 1. Панель инструментов Dr.Explain

Рисунок 2. Панель инструментов Help and Manual

Главная фишка Dr.Explain – это автоматизация самого трудоемкого процесса документирования – создание аннотаций пользовательского интерфейса. Да, вы правильно меня поняли. Больше не нужно делать снимки экрана самому, рисовать выноски и стрелки, вставлять все это хозяйство в проект вручную – программа сама сделает снимок любой части интерфейса по вашему выбору, проанализирует и найдет (сама!) все значимые элементы (кнопки, элементы управления, списки), вставит снимок в проект справки и автоматически расставит стрелки и пояснительные выноски к изображениям. Пользователю остается всего лишь ввести краткое пояснение к каждой выноске и все.

Кроме того, к выноскам можно добавить и более подробные пояснения. Для всех выносок программа автоматически сгенерирует симпатичную на вид табличку, которая будет размещаться ниже скриншота с выносками и может включать в себя все эти подробные пояснения.

Такое полуавтоматическое документирование интерфейса значительно ускоряет и облегчает создание справочной системы, т.к. разработчику остается всего лишь добавить свои описания в выноски. В Help and Manual я все это тоже могу сделать – правда, придется делать это вручную. Обычно я делаю снимки окон в Snagit, обрабатываю края снимка, добавляю тень, рисую стрелки. А для документирования элементов окна вручную создаю табличку, нарезаю снимки кнопок и контролов, обрабатываю их края и вставляю в проект, а затем пишу описания каждой выноски. На это тратится уйма времени и усилий.

Кое-что еще…

В Dr.Explain есть и другие полезные возможности, которых, к сожалению, нет в Help and Manual. Например, есть удобный режим просмотра проекта – одним кликом по соответствующей кнопке можно быстро посмотреть, как будет выглядеть справка в формате CHM или HTML после компиляции. Превью открывается прямо в окне редактора. Поверьте, это очень удобно. Однако нет PDF-превью – это минус.

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

Также в программе есть возможность интегрировать контекстно-зависимую справку прямо в приложение (F1), управление деревом навигации, набор шаблонов оформления, поддержка CSS, возможность быстрого обновления документации при выходе новой версии программы путем замены иллюстраций, но с сохранением выносок, аннотаций, описаний; функция поиска и индексации в онлайн-справке без программирования (PHP, ASP) или баз данных на стороне сервера.

Резюме

Вот, пожалуй, и все основные моменты, о которых я хотел здесь рассказать. Краткий обзор Dr.Explain я хотел написать еще два месяца назад, когда впервые увидел программу, но потом отложил эту затею на неопределенное время. А недавно снова готовил справку пользователя в Help and Manual и еще раз убедился, что документировать интерфейс все же удобнее в Dr.Explain.

• создание документации
• справка пользователя
• справочная система
• help
• drexplain
• help and manuals

Источник: habr.com