Меню
Оставить заявку
Статьи
Свежевыжатые соки для технических писателей

Java Help для Docbook

Поиск  Пользователи  Правила  Войти
Форум » Лаборатория технического писателя » "Единый источник" документации

Внимание! У нас сбои с почтовым сервером! Если не пришло письмо о регистрации или смене пароля напишите нам на info@techwriters.ru! 
@twriters obmen_soobsheniyami.pngчат для технических писателей в Telegram

 Зарегистрируйтесь
Страницы: 1
RSS
Java Help для Docbook
 
#1
Мне нравится0
08.06.2009 15:41:29
Дорогие коллеги и друзья!

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

Я ошибаюсь, или Java Help - это как раз то, что нужно?
Благодарю за любую информацию
 
 
 
#2
Мне нравится0
08.06.2009 16:16:14
А пример можно документации посмотреть? Что-то не пойму как она выглядит.
 
 
 
#3
Мне нравится0
08.06.2009 16:22:47
Цитата
А пример можно документации посмотреть? Что-то не пойму как она выглядит.
Выглядить почти как chm:
[url:1y16nmyv]http://www.techscribe.co.uk/techw/images/webhelp.jpg[/url:1y16nmyv], только открывается в браузере
 
 
 
#4
Мне нравится0
19.06.2009 16:19:42
Так а я не понимаю в чем отличие Вашего примера от WebHelp? Внешне содержание похоже на CHM, только открыто в браузере. А какие еще отличия?
А тут пишу Я - http://fortechwriters.com/
 
 
 
#5
Мне нравится0
19.06.2009 16:57:01
Цитата
Так а я не понимаю в чем отличие Вашего примера от WebHelp? Внешне содержание похоже на CHM, только открыто в браузере. А какие еще отличия?
Отличия есть
Во-первых, внешний вид скина веб-хелпа легко редактировать и подстроить под стиль ствоего приложения.
Во-вторых, в CHM есть свои глюки, обходимые в веб-хелпе.
 
 
 
#6
Мне нравится0
19.06.2009 17:24:34
Так а почему тогда Вас не устраивает стандартный WebHelp?
А тут пишу Я - http://fortechwriters.com/
 
 
 
#7
Мне нравится0
19.06.2009 17:29:00
Цитата
Так а почему тогда Вас не устраивает стандартный WebHelp?
Наверное потому, что Докбук не предусматривает трансформацию исходных файлов в WebHelp.

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

- Может я что не так поняла, но чтобы открыть сие творение, нужно еще и доп. программку-просмотрщик устанавливать (собственно, это скин и есть, куда затем загружается наш контент).
 
 
 
#8
Мне нравится0
19.06.2009 17:35:05
Все...теперь поняла. Даже не могла представить, что есть редакторы, которые не генерят WebHelp :). Поэтому изначально вопрос показался мне странным.
А тут пишу Я - http://fortechwriters.com/
 
 
 
#9
Мне нравится0
19.06.2009 17:37:51
Цитата
Все...теперь поняла. Даже не могла представить, что есть редакторы, которые не генерят WebHelp :). Поэтому изначально вопрос показался мне странным.
Увы,
Это единственный (на мой вкус) недостаток докбук  :(
 
 
 
#10
Мне нравится0
22.06.2009 11:35:31
Не совсем пойму об чём речь. Разве это не то?

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

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

Cделано из семпла докбука 4.0
не тех пис
 
 
 
#11
Мне нравится0
22.06.2009 11:52:50
Цитата
Не совсем пойму об чём речь. Разве это не то?

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 вы его генерили?
- пользовались ли дополнительными инструментами или писали кастомизацию?
- есть ли возможность поиска у документа в первом примере?
 
 
 
#12
Мне нравится0
22.06.2009 16:41:03
Стиль по-умолчанию который лежал в папчке с редактором, я ничего не делал. [code:3k4cf7si]Stylesheet: Default Stylesheet (C:\...\axdocbook\axdocbook.style)[/code:3k4cf7si]

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

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

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

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

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

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

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

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

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

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

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

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

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


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

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

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

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

©2005- 2021 «TechWriters.ru: Все для технического писателя и разработки технической документации»


info@techwriters.ru
-->
г.Москва, Большая Спасская 10/1
Рейтинг@Mail.ru