Что сейчас модно использовать для создания справки к программе?
Мы используем RoboHelp — но это такой глюкодром, что больше не хочется. Какие есть альтернативы?
Требования:
— проверка орфографии.
— маппинг для контекстной помощи.
— оглавление, ключевые слова.
— перекрёстные ссылки.
— генерация .chm.
— было бы неплохо иметь вывод в другие форматы (pdf?, html?, rtf?).
— возможность управлять стилями (в RoboHelp есть... но так всё криво!).
— более менее удобная работа с файлами. Например, если файл перемещается/переименовывается, то все ссылки на него из других файлов нужно исправить тоже.
Кто как порекомендует организовать помощь для программы, которая существует в двух видах — стандартная версия и профессиональная версия?
но это не зря, хотя, может быть, невзначай
гÅрмония мира не знает границ — сейчас мы будем пить чай
Здравствуйте, ., Вы писали:
.>Что сейчас модно использовать для создания справки к программе?
.>Мы используем RoboHelp — но это такой глюкодром, что больше не хочется. Какие есть альтернативы? .>Требования: .>- проверка орфографии. .>- маппинг для контекстной помощи. .>- оглавление, ключевые слова. .>- перекрёстные ссылки. .>- генерация .chm. .>- было бы неплохо иметь вывод в другие форматы (pdf?, html?, rtf?). .>- возможность управлять стилями (в RoboHelp есть... но так всё криво!). .>- более менее удобная работа с файлами. Например, если файл перемещается/переименовывается, то все ссылки на него из других файлов нужно исправить тоже.
.>Кто как порекомендует организовать помощь для программы, которая существует в двух видах — стандартная версия и профессиональная версия?
doxygen + LaTeX
или MS Word
С уважением Denys Valchuk
IMHO чем больше мнений тем оптимальней выбор варианта... :)
Здравствуйте, Dj.ValDen, Вы писали:
.>>Что сейчас модно использовать для создания справки к программе? .>>Мы используем RoboHelp — но это такой глюкодром, что больше не хочется. Какие есть альтернативы? .>>Требования: .>>- проверка орфографии. .>>- маппинг для контекстной помощи. .>>- оглавление, ключевые слова. .>>- перекрёстные ссылки. .>>- генерация .chm. .>>- было бы неплохо иметь вывод в другие форматы (pdf?, html?, rtf?). .>>- возможность управлять стилями (в RoboHelp есть... но так всё криво!). .>>- более менее удобная работа с файлами. Например, если файл перемещается/переименовывается, то все ссылки на него из других файлов нужно исправить тоже.
.>>Кто как порекомендует организовать помощь для программы, которая существует в двух видах — стандартная версия и профессиональная версия?
DV>doxygen + LaTeX
Не, документация не к исходникам, а типа user guide по самой программе. Можно, конечно, там всё делать, но всё ручками, и, например, с первым пунктом уже проблемы...
И главное для меня .chm, latex этого не умеет.
И вообще, Latex для печатной продукци. Нафиг это в софте?
DV>или MS Word
Ну это несерьёзно. Думаю не стоит объяснять почему?
но это не зря, хотя, может быть, невзначай
гÅрмония мира не знает границ — сейчас мы будем пить чай
Здравствуйте, ., Вы писали:
.>Что сейчас модно использовать для создания справки к программе?
.>Мы используем RoboHelp — но это такой глюкодром,
хотелось бы знать версию RoboHelp
Здравствуйте, ., Вы писали:
.>Что сейчас модно использовать для создания справки к программе?
.>Мы используем RoboHelp — но это такой глюкодром, что больше не хочется. Какие есть альтернативы? .>Требования: .>- проверка орфографии. .>- маппинг для контекстной помощи. .>- оглавление, ключевые слова. .>- перекрёстные ссылки. .>- генерация .chm. .>- было бы неплохо иметь вывод в другие форматы (pdf?, html?, rtf?). .>- возможность управлять стилями (в RoboHelp есть... но так всё криво!). .>- более менее удобная работа с файлами. Например, если файл перемещается/переименовывается, то все ссылки на него из других файлов нужно исправить тоже.
.>Кто как порекомендует организовать помощь для программы, которая существует в двух видах — стандартная версия и профессиональная версия?
Здравствуйте, geralt_rsdn, Вы писали:
_>Вроде неплохо отзываються о Help & Manual http://www.ec-software.com/.
Не нравится, что всё в одном файле хранится. Фигово для системы контроля версий. Хотя, думаю, некритично.
но это не зря, хотя, может быть, невзначай
гÅрмония мира не знает границ — сейчас мы будем пить чай
Здравствуйте, ., Вы писали:
.>Здравствуйте, geralt_rsdn, Вы писали:
_>>Вроде неплохо отзываються о Help & Manual http://www.ec-software.com/. .>Не нравится, что всё в одном файле хранится. Фигово для системы контроля версий. Хотя, думаю, некритично.
Что-нибудь наши новое для себя? Я тоже этим вопросом давно интересуюсь, хотелось бы узнать чем закончились ваши исследования.
Здравствуйте, Щербатов Евгений, Вы писали:
_>>>Вроде неплохо отзываються о Help & Manual http://www.ec-software.com/. .>>Не нравится, что всё в одном файле хранится. Фигово для системы контроля версий. Хотя, думаю, некритично. ЩЕ>Что-нибудь наши новое для себя? Я тоже этим вопросом давно интересуюсь, хотелось бы узнать чем закончились ваши исследования.
Неа... ничего не решил. Пока не горит...
Пока обратил внимание на docbook. Скачал исходники tsvn и разбираюсь как у них там система помощи устроена, а она там довольно серьёзная, куча доков, переводы на кучу языков, контекстная помощь и т.п. Даже aspell прикручен для проверки орфографии. Одно непонятно, в каком редакторе эти доки пишут? Ведь это требует квалификации, сложно будет дать такое какому-нибудь "специалисту предметной области", который кроме ворда ничего не знает... robohelp более привычен в этом отношении, можно всё мышой щёлкать.
но это не зря, хотя, может быть, невзначай
гÅрмония мира не знает границ — сейчас мы будем пить чай
Здравствуйте, ., Вы писали:
.>Здравствуйте, Щербатов Евгений, Вы писали:
_>>>>Вроде неплохо отзываються о Help & Manual http://www.ec-software.com/. .>>>Не нравится, что всё в одном файле хранится. Фигово для системы контроля версий. Хотя, думаю, некритично. ЩЕ>>Что-нибудь наши новое для себя? Я тоже этим вопросом давно интересуюсь, хотелось бы узнать чем закончились ваши исследования. .>Неа... ничего не решил. Пока не горит... .>Пока обратил внимание на docbook. Скачал исходники tsvn и разбираюсь как у них там система помощи устроена, а она там довольно серьёзная, куча доков, переводы на кучу языков, контекстная помощь и т.п. Даже aspell прикручен для проверки орфографии. Одно непонятно, в каком редакторе эти доки пишут? Ведь это требует квалификации, сложно будет дать такое какому-нибудь "специалисту предметной области", который кроме ворда ничего не знает... robohelp более привычен в этом отношении, можно всё мышой щёлкать.
Мда... У меня вообще последнее время складывается впечатление, что нормального софта для управления требованиями и создания хелпов на рынке пока нет! и что-то не замечаю тенденций к их появлению... Большая просьба, если что-то для себя накопаете — расскажите? Я в свою очередь тоже расскажу, если найду.
Здравствуйте, ., Вы писали:
.>Мы используем RoboHelp — но это такой глюкодром, что больше не хочется. Какие есть альтернативы? .>Требования: .>- проверка орфографии. .>- маппинг для контекстной помощи. .>- оглавление, ключевые слова. .>- перекрёстные ссылки. .>- генерация .chm. .>- было бы неплохо иметь вывод в другие форматы (pdf?, html?, rtf?). .>- возможность управлять стилями (в RoboHelp есть... но так всё криво!). .>- более менее удобная работа с файлами. Например, если файл перемещается/переименовывается, то все ссылки на него из других файлов нужно исправить тоже.
Я использовал BoostBook+QuickBook Это адаптированый docbook, так что chm/pdf есть. Достаточно удобный синтаксис, для которого я сделал несколько удобных макросов для VIMа.
Здравствуйте, ., Вы писали:
.>Пока обратил внимание на docbook. Скачал исходники tsvn и разбираюсь как у них там система помощи устроена, а она там довольно серьёзная, куча доков, переводы на кучу языков, контекстная помощь и т.п. Даже aspell прикручен для проверки орфографии. Одно непонятно, в каком редакторе эти доки пишут? Ведь это требует квалификации, сложно будет дать такое какому-нибудь "специалисту предметной области", который кроме ворда ничего не знает... robohelp более привычен в этом отношении, можно всё мышой щёлкать.