Посоветуйте программу для создания пользовательской документации

Здравствуйте.
Создаю прибор, который совершит следующую техническую революцию. Однако неожиданно встал вопрос о написании руководства пользователя.
Нужна специализированная программа, в которой можно делать аннотации на изображениях. С бесплатной пробной версией.
Кто-нибудь имеет опыт работы с таким софтом? Нужно именно рекомендации тех, кто работал с такими программами.
Собственно, пока требования небольшие, поскольку писать еще не начал и дополнительные вопросы возникнут в процессе:

  1. Экспорт в онлайн формат и в печатный формат.
  2. Создание аннотаций.
  3. Бесплатная.

не знаю таких форматов

на картинках фломастером напиши. Если есть фломастер, то остальное бесплатно.

ЗЫ Мужик, ну ты бы постарался хоть чуть-чуть вьехать в вопрос, прежде чем спрашивать.

что за аннотации? Такие что ли?


В любом самом простеньком графическом редакторе

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

или может то что ТС предлагает уже лет 200 как изобретено :slight_smile:

Предлагаю ему до кучи изобрести текстовой редактор для писания документации и фотошоп для правки картинок.

Это популярные форматы HTML (для веб), DOCX, PDF (для вывода на печать).

хоть чуть-чуть вьехать в вопрос
В какой вопрос вы имеете в виду?

К сожалению, тот же Paint не сможет вывести это в HTML. И это не единственный его недостаток.

Может быть и некому, но вопрос не об этом.

Рад за Вас и всецело поддерживаю :slight_smile:

1 лайк

Я в Либре Офисе пишу, он в ПДФ отлично сбрасывает, с оглавлениями и тп. Картинки (точнее к фоткам аппаратов подрисовываю стрелочки и надписи) рисую в Просмотре, на маке. Без мака что за доки? )) (шутка).
В HTML не было нужды сбрасывать, хз как там.

““Паинт нет”” удобный инструмент во многих случаях.
…руководство пользователя оформит редактор, ваша задача создать и собрать файлы для него. По подобию статьи материалы содержать должны текстовую и графическую информацию, таблицы. Графика, например, так:



Пояснения отдельный файл, например:
…на рис.1 дан внешний вид изделия. Оно состоит из следующих основных элементов…
…монтаж поделки начинают с … (рис.2). Сначала элемент … соединяют с элементом… и т.д.

1 лайк

Может не надо писать то, в чем не разбираетесь? Или вы с ПоверПойнтом перепутали?

HTML - это язык разметки, а не формат картинок или текста. Картинки в ХТМЛ вставляются внешними ссылками, нет никакой проблемы вставить туда картинки из Пайнта.

в вопрос, какие бывают форматы картинок и текста и как они создаются.

Мануалов по созданию технической документации в сети навалом. Это обычная вежливость - сначала чуть приложить усилий и сориентироваться в новой для себя области, а не ждать, что на (непрофильном кстати) форуме вам будут читать лекцию по всем основам.

Поддерживаю, ЛибреОфис (на линуксе) - отличная вещь.
Я в нем китайские даташиты переводил. Текст гуглем или чем еще, а картинки вырезаю из оригинала и вставляю в новый текст. Потом все это в ПДФ.

Вот пример пользовательского руководства в формате HTML:
https://matrixgk.com/education/knowledge_base/modul_et_17_220v_ac.htm
Pain сможет экспортировать фал в такой формат?

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

Если все еще непонятно, с удовольствием поясню.

Спасибо, надо посмотреть. А вот такое нашел, как раз специализированная программа для создания пользовательских документаций https://www.drexplain.ru/
Как-то жирно: и экспорт расширенный, и подписи к картинкам и все такое.
Я так понял, местные вряд ли использовали ее. А хотел именно по функциональности поспрашивать. Ну раз бесплатная, попробую сам затестить.

:slight_smile:
Не, “пеинт нет” не ваш вариант.

1 лайк

Спасибо, то же так считаю. А то некоторые эксперты мне тут его рекомендуют :rofl:

Нет.
Пэйнт это не инструмент для создания документации, это инструмент для обработки картинок.

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

И , кстати, скачайте HTM по вашей ссылке и убедитесь, что картинки - не часть этого документа, они хранятся отдельно.