[Dmil 0]

Обычно документация к программе и устройствам идет в виде chm справки и pdf документа

chm удобна тем, что можно сделать контекстно зависимый хелп, но его неудобно распечатывать.

pdf удобен для печати...

как это совместить???

попробовал несколько прог для автоматической конвертации:

chm2pdf, abc amber chm converter, chm to pdf converter pro..

ни одна полностью не подходит

 

основная разница в том, что в версии для распечатки нужно оглавление, например, а в chm его не сделать...

поддерживать две версии хелпа утомительно

 

кроме того, есть еще один вопрос:

при переводе из doc в pdf с помощью acrobat 7, если в доке используются заголовки и меню на их основе, неправильно формируется иерархия в дереве слева, который отображает акробат. как поправить это не нашел.

как фирмы делают свою документацию? в ней все нормально!

 

кто-нибудь сталкивался с такими задачами?

[MKS 0]

Обычно документация к программе и устройствам идет в виде chm справки и pdf документа

chm удобна тем, что можно сделать контекстно зависимый хелп, но его неудобно распечатывать.

pdf удобен для печати...

как это совместить???

попробовал несколько прог для автоматической конвертации:

chm2pdf, abc amber chm converter, chm to pdf converter pro..

ни одна полностью не подходит

 

основная разница в том, что в версии для распечатки нужно оглавление, например, а в chm его не сделать...

поддерживать две версии хелпа утомительно

 

кроме того, есть еще один вопрос:

при переводе из doc в pdf с помощью acrobat 7, если в доке используются заголовки и меню на их основе, неправильно формируется иерархия в дереве слева, который отображает акробат. как поправить это не нашел.

как фирмы делают свою документацию? в ней все нормально!

 

кто-нибудь сталкивался с такими задачами?

В какомто форуме, уже не помню каком недавно пробегала ссылка на программу AuthorIT.

Trial лежит сдесь _tt_://www.author-it.com/ и он полнофункционален. Сам я с ней пока толком не разобрался, но в двух словах: она позволяет вести документацию, хранит все во внутренем формате, а в нужный момент позволяет сделать экспорт в CHM,PDF,DOC,XML ну и чего то там еще уже не помню. Внешне интерфейс очень похож на ms_Word. Как мне кажется это то что вам нужно.

[Dmil 0]

а кто-нибудь с ней работал?

как она, например, понимает, что в chm не надо оглавление делать, а в pdf надо?

поддерживает она вызовы из приложений для контекстного хелпа?

[sha161 0]

а кто-нибудь с ней работал?

как она, например, понимает, что в chm не надо оглавление делать, а в pdf надо?

поддерживает она вызовы из приложений для контекстного хелпа?

Вам сюда http://authorit.ru/forum/index.php

[Hmm 0]

поддерживать две версии хелпа утомительно

 

С этим поможет 'Help & Manual':

_http://www.helpandmanual.com/

[scheme_ru 0]

Перепробовав различные средства создания документации и help, могу порекомендовать ComponentOne Doc-to-Help. Документ пишется в MS Word, на выходе можно получить HTML (вполне достойный, не такой, как сам word пишет), CHM и прочие форматы. Удобная система создания линков, автоматической индексации, глоссария и т.п. PDF, к сожалению, сам не пишет - приходится плагином от Acrobat 7 пользоваться.

Правда, использую версию 7.2, хотелось бы проапгрейдится до 2005 или даже 2006 - там глюков поменьше и возможностей побольше будет.

 

Help&Manual не понравился - он использует свой формат, а все же привычней писать в Word'е, функционал побогаче, да и написано уже много, не перебивать заново.

 

Еще распространен Robohelp от Macromedia. Впечатления - виснет сам и вешает машину. Посмотрев в процессах, выяснилось, что работает конвертор в режиме эмуляции 16-битной MS DOS. Соответственно, имена файлов длиннее 8 символов не понимает. Видимо, как сто лет назад написали движок, так только обертку правят. Правда, может такая уникальная версия попалась на рассмотрение.

[Andrew2000 0]

Обычно документация к программе и устройствам идет в виде chm справки и pdf документа

1. Если к программе, то пользуюсь Doxygen - автодокументирование по исходным текстам - на выходе .html, .chm, .pdf (внешний TeX нужен), .rtf, ...

2. Если писать ручками, то я подсел на формат DocBook - пишу при пом. плугина к Eclipse - есть конвертаторы в .chm, а вот в .pdf есть, но русские буквы не получаются :( - но, это было пол года назад, теперь может выправилось...

3. Если надо .doc сохранить в .pdf (со всеми оглавлениями), то есть OpenOffice - он открывает MSWord .doc и экспортирует в .pdf v.5

(все это свободные тулзы)

[fantasy 0]

Для конвертации в PDF рекомендую программу pdfFactory Pro (http://www.pdffactory.com/) - отлично понимает русские буквы, умеет создавать и редактировать закладки, интегрирует шрифты в документ, при работе эмулирует принтер, поэтому создать PDF можно из любой программы (лишь бы программа печатать умела :) ). Программа не бесплатная, но всё что нужно к ней минут за 5 находится в сети.

[Dmil 0]

к сожалению, программы, эмулирующие принтер, не подходят, так как они не могут с chm документу создать оглавление, титульную страницу...

попробовал Help & Manual.

понравилось, что она как раз умеет делать оглавление, титульный лист, закрывающий, но...

она почему-то не понимает ссылки внутри старницы из топиков, в результате чего одну и ту же страницу размножает по количеству топиков и почему-то часть ссылок напрочь не видит.

беда прям..