2

Пишу для курсовой программку на java с UI. Встал вопрос о прикручивании help (инструкции, о программе и т.п.). Как это делают вообще? Варианты типа html или .chm вижу, но непонятно как это делают обычно, по канонам. Ну и мануал может у кого есть, гугление ничего не дало.

6
  • Microsoft HTML Help Workshop - микрософтовская софтина для создания CHM 18 дек 2017 в 13:45
  • это сделала, но как его прикрутить к проге? 18 дек 2017 в 13:48
  • Что вы сделали? У вас уже есть готовый CHM файл под вашу программу и вам нужно его показывать при нажатии на Help? 18 дек 2017 в 13:50
  • да. CHM есть. его открытие нужно назначить на кнопку в приложении, как это сделать? как с обычным файлом? 18 дек 2017 в 13:52
  • Ну да, можно попросить ОС открыть его в соответствующем приложении, как это делается с другими зарегистрированными типами файлов 18 дек 2017 в 13:53

3 ответа 3

3

Раз уж вопрос относится к Java, рекомендовал бы отказаться от типично майкрософтовских технологий, т.к. они, в отличии от Java, работают только в Windows. Я имею ввиду CHM файлы. Существует старая стандартная технология JavaHelp - по-моему ранее была частью JDK (или JEE), но Oracle её забросила. Можно найти на GitHub. Например в NetBeans help постоен именно в этой системе. Oracle имеет собственную систему - Oracle Help Technologies. Так же имеется система на базе Eclipse.

Дополнение: В качестве альтернативы можно сделать банальный статический web-сайт и запускать его локально через какой-нибудь Jetty. Eclipse Help примерно так и сделан.

10
  • у меня Идея, туда JavaHelp не прикрутишь( 18 дек 2017 в 14:41
  • При чём тут Идея? Вы свою курсовую программу в Идеи показывать будете? А когда на программиста выучитесь заказчикам свои программы вместе с Идеей отдавать будете? Как заказчику объяснять будете почему ваш CHM help в Linux или на MacOS не работает? 18 дек 2017 в 14:47
  • ну курсач то точно на винде) чтобы добавть help его нужно каким-то образом интегрировать в приложение, а с Явахэлпом и идеей я больше проковыряюсь чем сделаю. Можно и html, если уж кратковременность брать. 18 дек 2017 в 14:58
  • Все предложенные мной варианты в основе документации используют HTML файлы. Просто они позволяю именно интегрировать их в приложение, вызывать контекстную справку, организовывают поиск и индексацию документации, предоставляют GUI для отображения документации. Реализовать это же самое самому дольше будет. 18 дек 2017 в 15:26
  • Oracle Help Technologies -- это, по-моему, тот же самый JavaHelp, только с исправленными багами и за деньги :)
    – m. vokhm
    18 дек 2017 в 16:39
1

Как вариант, можно справочную информацию написать на html, и далее уже из UI открывать ее при помощи WebView

Например, в JavaFX это будет выглядеть так:

WebView webView = new WebView();
WebEngine webEngine = webView.getEngine();
URL url = getClass().getResource("help.html");
webEngine.load(url.toExternalForm());
1
  • спасибо, попробую 18 дек 2017 в 13:55
1

Я в свое время потратил какое-то время на решение этой задачи, см. https://softwarerecs.stackexchange.com/questions/32162/help-system-for-a-desktop-java-application. Вариант с CHM не рассматривался изначально, поскольку по ТЗ программа должна был работать на всех основных платформах (Windows, Linux и Mac). Вариант с открытием браузера мы с заказчиком сочли несерьезным, там нормальный поиск сделать невозможно, и вообще несолидно как-то.

Оставшихся варианов, как я и предполагал, немного:

  • Эклипсовский хелп;
  • Оракловский "Help for Java";
  • Старый бесплатный JavaHelp.

Первый вариант (эклипсовский) -- тяжел и по весу, и в использовании (он должен таскать за собой пол-эклипса, минимальная сборка получается в районе 100 МБ) и содержит много излишеств.

Оракловский хелп -- платный, тоже отпадает.

Остается JavaHelp. Это тоже не блеск -- он содержит ошибки, он выглядит страшно, индекс у него никуда не годный и наполнять надо руками, в нем не предусмотрено изменение шрифта, и он сделан на допотопном AWT. Для меня последнее обстоятельство было очень неприятно, моя прорамма была на SWT, и надо было обмениваться событиями -- программа должна открывать окна справки, при измении шрифта надо использовать FontDialog из SWT, а при изменении размеров окна справки или шрифта программа должна запомнить последнее состояние, чтобы восстановить его при следующем запуске.

Пришлось повозиться и с допиливанием самого JavaHelp (добавить возможность выбора шрифта), и с прокси-методами для обмена событиями между моим SWT-потоком и AWT-потоком, в котором работает JavaHelp.

Но в конце концов получилось более-менее сносно:

введите сюда описание изображения

А недавно я обнаружил, что замечательный графический редактор yEd, написанный на Java, тоже использует слегка подправленный JavaHelp, что меня утвердило во мнении, что это единственный на сегодня вариант, который дает более-менее приличные результаты и при этом не отбирает слишком много ресурсов (включая размер дистрибутива и время разработчика).

1
  • А, для курсовой... Я не заметил. Для курсовой это, пожалуй, слишком сложно.
    – m. vokhm
    18 дек 2017 в 16:37

Ваш ответ

By clicking “Отправить ответ”, you agree to our terms of service and acknowledge you have read our privacy policy.

Всё ещё ищете ответ? Посмотрите другие вопросы с метками или задайте свой вопрос.