Средства просмотра Javahelp (или альтернативы) - PullRequest
5 голосов
/ 28 марта 2012

Я пытаюсь интегрировать поисковую справку в свое приложение Java (Swing). Я сейчас использую docbook для создания справки в формате pdf, и я знаю, что она может генерировать JavaHelp. Я думаю, что просмотрщик по умолчанию для JavaHelp довольно непривлекателен (особенно в Windows, даже при использовании Windows L & F). Я не смог найти симпатичных зрителей, но мне было бы любопытно, знаете ли вы о них, или есть ли лучшие альтернативы для помощи в приложении.

Ответы [ 2 ]

5 голосов
/ 10 апреля 2012

Средство просмотра содержимого по умолчанию (средство визуализации HTML) в JavaHelp равно HTMLEditorKit . Этот компонент не очень впечатляет; он поддерживает только HTML 3.2 и имеет ограниченные возможности CSS. В JavaHelp .

можно подключить альтернативные средства просмотра контента.

Возможно, вы захотите попробовать

Справка Oracle . Это очень похоже на JavaHelp, но более активно поддерживается. Средство просмотра содержимого по умолчанию, входящее в состав справки Oracle, также более функционально. Для создания таблиц стилей DocBook-XSL JavaHelp может потребоваться некоторая настройка для создания выходных данных, которые работают со справкой Oracle (см. эта страница ).

Трудно найти точную информацию о состоянии и планах на будущее для этих технологий. Последняя версия JavaHelp была выпущена в октябре 2007 года, а справка Oracle 11.1.2.1.0 была выпущена в сентябре 2011 года. Есть форумы ( здесь и здесь ), но активность низкая.

Возможно, вас заинтересует веб-браузерная справочная система. В этом случае взгляните на WebHelp , один из более новых форматов вывода для содержимого DocBook.

2 голосов
/ 28 марта 2012

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

  1. Вы пишете документацию с использованием синтаксиса ReST, который похож на вики.
  2. Красивые HTML-шаблоны /
  3. Возможность создавать другие форматы, такие как epub, pdf и т. Д.
  4. Versionable
...