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

Какая система нужна для "единого источника"?

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

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

 Зарегистрируйтесь
Страницы: 1
RSS
Какая система нужна для "единого источника"?
 
#1
Мне нравится0
12.11.2007 03:44:51
Требования к  системе документации:
Единый источник для формирования документов
Поддержка выходных форматов данных:
" XML
" MS Word
" TXT
" HTML
" PDF
" CHM
Возможность гибкой интеграции с сайтами (экспорт в системы CMS, WIKI)
Поддержка изображений,  flash. (мультимедийные возможности)
Возможность использования удобного  WYSIWYG при написании
Подскажите плиз, что лучше ?
 
 
 
#2
Мне нравится0
12.11.2007 16:15:29
Docbook, H&M, authorit,  но как это работает и какие трудности внедрения,  не знаю.
Работаю по-старинке...
 
 
 
#3
Мне нравится0
12.11.2007 17:04:41
Вот до сих пор не сталкивалась с документацией в формате txt, кроме, пожалуй,  файлов типа info и readme...
 
 
 
#4
Мне нравится0
12.11.2007 18:49:25
Цитата
Вот до сих пор не сталкивалась с документацией в формате txt, кроме, пожалуй,  файлов типа info и readme...
:lol:  :lol:  :lol:  :lol:  :lol:  :lol:  Ха-ха-ха..сам смеялся...даже не посмотрел что отправил...сорри ))))
 
 
 
#5
Мне нравится0
17.04.2009 19:03:45
DITA. Из плюсов:
1. набор инструментов бесплатен и периодически появляются обновления.
2. Запуск из командной строки.
3. Вручную вводится только текст в соответствующие теги в редакторе XML (содержание документации).
Из минусов: требует определенных знаний XSLT, XML для настройки конфигурации.
 
 
 
#6
Мне нравится0
18.04.2009 02:53:59
Цитата
Из минусов: требует определенных знаний XSLT, XML для настройки конфигурации.
Еще минус: отсутствие документации, рускоязычной((
Торопливость в выводах может привести к неприятностям
 
 
 
#7
Мне нравится0
19.04.2009 20:00:02
Это временный минус. И этот минус можно уменьшить требованиями от самой DITA. Извините, но теги и команды в XSLT, XML не перевести, а немного примеров есть на англоязычных ресурсах. translate.google.ru  и вперед...
 
 
 
#8
Мне нравится0
21.04.2009 11:04:26
Что-то когда заходит речь о DITA, постоянно говорят о каких-то XSLT, командных строках и ужасах. Я перестаю понимать о чём речь.
Разве DITA не является типом документа, который предустановлен в XML редакторе, которым вы пользуетесь? Если  вышла новая версия дита - кинули новые файлики в каталог с типами документа и всё.. Специализацию  тоже сделать можно сравнив 2 файлика и проведя изменения по аналогии.  Может когда я смотрел DITA я смотрел поверхностно..

Я бы хотел разобраться с DITA и у меня вопрос. В какую сторону копать? Что обычно требуется знать при работе с DITA? Стоит ли мне копать в сторону создания специализаций на основе имеющихся типов документов или же в сторону создания DITA Мапов для книг, или же чего-то ещё?
не тех пис
 
 
 
#9
Мне нравится0
21.04.2009 17:37:02
MadCap Flare, после Робохелпа просто радует! Много писала про него здесь: http://www.techwriters.ru/forum/viewtopic.php?t=494.
А тут пишу Я - http://fortechwriters.com/
 
 
 
#10
Мне нравится0
21.04.2009 18:21:01
MadCap Flare тоже позволяет работать с "единым источником?"
 
 
 
#11
Мне нравится0
22.04.2009 14:27:51
Да, Flare работает на основе единого источника. Так как создавали его теже люди, что когда-то работали над Robohelp, программы очень похожи, но Флер значительно превосходит RH по возможностям и количеству обновлений :).
А тут пишу Я - http://fortechwriters.com/
 
 
 
#12
Мне нравится0
31.05.2011 23:57:43
Если у Вас очень хитрый шаблон сайта то для полной "визуальной интеграции" может и придется призадуматься, но мы всегда готовы помочь пользователям в решении любых проблем.
В большинстве же случаев трудностей с интеграцией не возникает.
Журавлев Денис
Dr.Explain : Быстрая разработка хелп-файлов и руководств пользователя ПО
 
 
 
#13
Мне нравится0
31.05.2011 12:15:14
Спасибо огромное!
То есть из H&M так красиво не получится?
Есть ли сложности по настройке Dr.Explain и интеграции с сайтом?
 
 
 
#14
Мне нравится0
31.05.2011 13:16:36
Цитата
Есть ли сложности по настройке Dr.Explain и интеграции с сайтом?
Насколько я поняла, интегрируется легко. Вы спросите прямо у разработчиков Dr.Explain http://techwriters.ru/forum/viewforum.php?f=49&sid=fec0a8fda7c464d21001672046feed2d. Отвечают оперативно.
 
 
 
#15
Мне нравится0
26.05.2011 15:11:34
Братья и сестры по разуму!
Есть руководство, около 300 стр. Есть у начальства желание перенести его в он-лайн, чтобы наши пользователи со всех уголков России могли зайти на сайт и ткнуть в нужный им раздел.
Вопрос следующий.
Как я понимаю, мне придется перевести его в систему, работающую с HTML. Каждый раз править HTML страницу и потом ее направлять на публикацию трудоемко. Возможно есть программы, компелирующие в HTML и имеющие какие-то опции, позволяющие автоматически обновлять на сайте?
А еще лучше, может быть есть модули для сайтов, которые позволяют редактировать руководство в он-лайн режиме? Модерировать страницы, расположенные на готовых движках несложно, но у нас сайт сверстанный, а с кодами работать я не умею.
Плюс нужна возможность потом из этого готового размещенного документа  каким-то образом извлечь обратно эти 300 страниц (вдруг потребуется целиком).
Какие варианты есть и какой из них оптимальный?
Заранее спасибо.
 
 
 
#16
Мне нравится0
27.05.2011 16:56:05
Я эту тему, помню, три года назад создал и теперь уже специалист в этом))
Ну во-первых вам нужен будет скорее всего "единый источник документации" - это AuthorIT, HM, Dr.Explain или еще что-то в этом ключе. Та программа, которая позволяет публиковать информацию в HTML , т.е вы исправляете  у себя на сервере, документация изменяется и на сайте и , при публикации документов и т.д

Соответственно, непонятно зачем вы используете help формат. Он вам не нужен, его конечно можно будет прикурутить при желании к сайту, но будет это выглядеть вне дизайна, вот как на сайте техписов, да простит меня админ, посмотрите раздел госты http://www.techwriters.ru/gost/index.html
Вам это нужно?
 
 
 
#17
Мне нравится0
30.05.2011 15:05:24
Dr.Explain - по моему они еще не работают с "единым источником".
Работаю по-старинке...
 
 
 
#18
Мне нравится0
30.05.2011 19:59:42
Цитата
Dr.Explain - по моему они еще не работают с "единым источником".

Т.е.? В Dr.Explain из одного проекта генерируются различные форматы: Word, CHM, PDF, HTML.
Поменяете один раз в проекте и перезапустите экспорт - получите изменения во всех форматах.

Причем настроив шаблоны в HTML вы можете полностью интегрировать онлайн справку в дизайн Вашего сайта. Например,
http://www.dean3.com/softbox/help/
http://www.drexplain.com/help/
http://www.trueboxshot.com/CEGuide/index.htm
Журавлев Денис
Dr.Explain : Быстрая разработка хелп-файлов и руководств пользователя ПО
 
 
 
#19
Мне нравится0
31.05.2011 10:48:32
Цитата
Т.е.? В Dr.Explain из одного проекта генерируются различные форматы: Word, CHM, PDF, HTML.
упс...  точно.
Работаю по-старинке...
 
 
 
#20
Мне нравится0
09.08.2011 10:51:50
Latex
А что вы можете посоветовать? Шеф хочет красивое руководство он лайн, причем такое, чтобы можно было ставить ссылки на отдельные разделы. Chm для этого не слишком красив. Какие еще есть варианты?
Ваш пример с ГОСТами (да простит меня админ) правда печален...:)
 
 
 
#21
Мне нравится0
05.11.2011 16:18:35
спасибо за помощь..
 
 
 
#22
Мне нравится0
07.11.2011 13:52:04
Попробуйте dr.exsplain на примере выглядит нормально.
 
 
 
#23
Мне нравится0
23.07.2012 21:05:38
Цитата
Цитата
Вот до сих пор не сталкивалась с документацией в формате txt, кроме, пожалуй,  файлов типа info и readme...
:lol:  :lol:  :lol:  :lol:  :lol:  :lol:  Ха-ха-ха..сам смеялся...даже не посмотрел что отправил...сорри ))))
Я недавно сталкивался  :)  

Нужно было экспортировать часть исходников из Dita в TXT для последующей миграции в TracWiki ([url:1dd639fm]http://trac.edgewall.org/wiki/TracWiki/[/url:1dd639fm]).
 
 
 
Страницы: 1
Читают тему

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


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