Разработка технической документации и технические писатели Технические писатели и разработка технической документации технические писатели в Телеграм 

 obmen_soobsheniyami.png Чат для технических писателей 
 Зарегистрируйтесь
Страницы: 1
RSS
Java Help для Docbook
 
Дорогие коллеги и друзья!

Подскажите, пожалуйста, генерил ли кто-нибудь Java Help для Docbook? Сейчас ищем возможность создания выходного хелпа в формате, похожем на робохелповский WebHelp - с поиском, индексом и фреймовой структурой.

Я ошибаюсь, или Java Help - это как раз то, что нужно?
Благодарю за любую информацию
 
А пример можно документации посмотреть? Что-то не пойму как она выглядит.
 
Цитата
А пример можно документации посмотреть? Что-то не пойму как она выглядит.
Выглядить почти как chm:
[url:1y16nmyv]http://www.techscribe.co.uk/techw/images/webhelp.jpg[/url:1y16nmyv], только открывается в браузере
 
Так а я не понимаю в чем отличие Вашего примера от WebHelp? Внешне содержание похоже на CHM, только открыто в браузере. А какие еще отличия?
А тут пишу Я - http://fortechwriters.com/
 
Цитата
Так а я не понимаю в чем отличие Вашего примера от WebHelp? Внешне содержание похоже на CHM, только открыто в браузере. А какие еще отличия?
Отличия есть
Во-первых, внешний вид скина веб-хелпа легко редактировать и подстроить под стиль ствоего приложения.
Во-вторых, в CHM есть свои глюки, обходимые в веб-хелпе.
 
Так а почему тогда Вас не устраивает стандартный WebHelp?
А тут пишу Я - http://fortechwriters.com/
 
Цитата
Так а почему тогда Вас не устраивает стандартный WebHelp?
Наверное потому, что Докбук не предусматривает трансформацию исходных файлов в WebHelp.

UPD:
С горем пополам удалось сгенерить джава хелп, но
- Скин в хелпе довольно-таки уродливенький, без слез смотреть нельзя. В сравнении с ним CHM - просто песня и произведение искусств.

- Может я что не так поняла, но чтобы открыть сие творение, нужно еще и доп. программку-просмотрщик устанавливать (собственно, это скин и есть, куда затем загружается наш контент).
 
Все...теперь поняла. Даже не могла представить, что есть редакторы, которые не генерят WebHelp :). Поэтому изначально вопрос показался мне странным.
А тут пишу Я - http://fortechwriters.com/
 
Цитата
Все...теперь поняла. Даже не могла представить, что есть редакторы, которые не генерят WebHelp :). Поэтому изначально вопрос показался мне странным.
Увы,
Это единственный (на мой вкус) недостаток докбук  :(
 
Не совсем пойму об чём речь. Разве это не то?

Html Help
http://img25.imageshack.us/img25/4812/22110754.jpg

Chm
http://img41.imageshack.us/img41/638/22111738.jpg

Cделано из семпла докбука 4.0
не тех пис
 
Цитата
Не совсем пойму об чём речь. Разве это не то?

Html Help
http://img25.imageshack.us/img25/4812/22110754.jpg

Chm
http://img41.imageshack.us/img41/638/22111738.jpg

Cделано из семпла докбука 4.0
HTMLHelp, если я не ошибаюсь - хелп в формате CHM. С этим у докбук все в порядке.

А вот по поводу вашего первого примера, позвольте пару вопросов:
- с помощью какой stylesheet вы его генерили?
- пользовались ли дополнительными инструментами или писали кастомизацию?
- есть ли возможность поиска у документа в первом примере?
 
Стиль по-умолчанию который лежал в папчке с редактором, я ничего не делал. [code:3k4cf7si]Stylesheet: Default Stylesheet (C:\...\axdocbook\axdocbook.style)[/code:3k4cf7si]

Я просто выбрал Новый документ > Докбук [галочка sample document] > сохранить в Web. Всё по дефолту выглядит так.
Можно, наверное, было поменять картинки как-нибудь, но я ничего не делал и никакие инструменты не использовал - просто сгенерил вам для скриншота дефолтовый пример.
Вообще я пользуюсь постоянно визуальным редактором стилей для XML, но стиль должен влиять только на содержимое правого фрейма. Остальное как раз - кастомизация, которой мне не приходилось заниматься никогда, так как не было повода.

У меня сложилось впечатление, что поиск работает только по левому фрейму.
не тех пис
 
Цитата
Стиль по-умолчанию который лежал в папчке с редактором, я ничего не делал. [code:cly68s87]Stylesheet: Default Stylesheet (C:\...\axdocbook\axdocbook.style)[/code:cly68s87]

Я просто выбрал Новый документ > Докбук [галочка sample document] > сохранить в Web. Всё по дефолту выглядит так.
Можно, наверное, было поменять картинки как-нибудь, но я ничего не делал и никакие инструменты не использовал - просто сгенерил вам для скриншота дефолтовый пример.
Вообще я пользуюсь постоянно визуальным редактором стилей для XML, но стиль должен влиять только на содержимое правого фрейма. Остальное как раз - кастомизация, которой мне не приходилось заниматься никогда, так как не было повода.

У меня сложилось впечатление, что поиск работает только по левому фрейму.
Мммм, а подскажите, каким редактором вы пользуетесь для работы с исходниками?
Подозреваю, что у вас с этим редактором и идет кастомизация.
 
Конечно, с ним :)

Пользуюсь Arbortext Editor + Styler ( http://philosoft.ru/arbor.zhtml )
Кстати, если интересно, могу дать вам попробовать.
не тех пис
 
Цитата
Конечно, с ним :)

Пользуюсь Arbortext Editor + Styler ( http://philosoft.ru/arbor.zhtml )
Кстати, если интересно, могу дать вам попробовать.
:) Спасибо, большое, но боюсь, этим вы можете нарушить лицензионный договор с поставщиком продукта.

Если не сложно, и это не является секретной информацией, подскажите, пожалуйста, вот что:

1) Сколько приблизительно стоит Editor + Styler?

2) Можно ли задать правила трансформации один раз (создав набор stylesheet"ов), а потом использовать этот набор для автоматической сборки документации отдельно от инструмента? Насколько это удобно и имеет смысл?
 
Не волнуйтесь, ничего не нарушим, считайте что я и есть поставщик продукта.

1) Editor стоит порядка 1000$ лицензия фиксированная. Но к ней можно докупить home use за 200$ - усреднённая цена будет порядка 600$.

Styler стоит порядка ~5700$. В общем, недешево. Но, это плавающая лицензия и её можно купить одну на всех, да и не нужна она на каждое место Editor.

2) Внутри Styler вы работаете со стилями ня языке Fosi, но можно сделать ловкое движение и вытащить этот стиль, например, в виде XSL. Теоретически, если у вас есть XSL стиль, то ничего вам не мешает сделать то, что вы хотели. Не приходилось с этим сталкиваться, у нас есть кое-какие доки, которые содержат данные по этому поводу. Сейчас точно вам ответить не берусь.

Насколько это вообще удобно. Это зависит от объёмов документации которые вы хотите таким пакетным образом выпускать. Возможно проще публиковать из программы.


Вообще в этом семействе есть специальная программа для того что вы задумали, но она стоит ОЧЕНЬ дорого и я её даже не упомянаю.
не тех пис
 
Цитата
Наверное потому, что Докбук не предусматривает трансформацию исходных файлов в WebHelp.

UPD:
С горем пополам удалось сгенерить джава хелп, но
- Скин в хелпе довольно-таки уродливенький, без слез смотреть нельзя. В сравнении с ним CHM - просто песня и произведение искусств.

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

Добрый день!
Подскажите пожалуйста, каким образом генерировали javahelp. Никак не могу с этим разобраться...
Страницы: 1
Читают тему