Оставить заявку

a7alex (Все сообщения пользователя)

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

 Зарегистрируйтесь
Выбрать дату в календареВыбрать дату в календаре

Страницы: 1
Выбор системы. Выход webhelp/pdf
 
...целый день сегодня читал инет. Так как у нас используется TFS, то пытаюсь придумать как прикрутить подход code review к нему. В любом случае, изучив code review и почитав про инструменты у меня вопрос на который я пока не нашел ответ (читал в соседних ветках устаревшие обсуждения дорогущих cms для dita, но это же не вариант): если мне клиент говорит и я вижу в конечном pdf (например) ошибку, то как мне найти/поправить эту ошибку в исходном файле-топике?

Я пока вижу один вариант, котрый мне очень не нравится (потому что придется бегать два раза между двумя инструментами):
1. Идем в svn/tfs, копируем весь проект себе.
2. Открываем в XMLMind карту, по карте проваливаемся к нужному файлу-топику (так как именно в карте есть разбивка по разделам (topichead)).
3. Возвращаемся в svn и забираем файл на редактирование
4. Открываем XMLMind, правим, возвращаем в svn и т.д.

Как вариант можно создать в svn структуру, близко-аналогичную конечному документу, но тогда все прелести подхода единого источника уходят.... :(

Хочется как-то удобнее. :)

Одновременно с планированием структуры возникло еще несколько вопросов уже по самой dita:
- В описании dita for solo writers есть описание карты как таковой, а в XMLMind есть map (документ) и bookmap (книга)? В чем различие? На оазисе в описании 1.2 я не нашел такого деления.
- Правильно ли я понимаю, что карта может ссылаться (включать в себя) другие карты? [url=http://docs.oasis-open.org/dita/v1.2/os/spec/archSpec/map-to-map-cascading-of-metadata.html#map-to-map-cascading-of-metadata]http://docs.oasis-open.org/dita/v1.2/os ... f-metadata[/url]
Точнее не так. :) Правильный вопрос такой: могу ли я создать, например, карту "Все документы компании" для компиляции в xhtml и включить в неё карты "Руководства" (с вложенными картами для создания pdf "Бухгалтерия", "Закупка") и карты "Функционал" (с вложенными картами для создания pdf "Обработка документов", "Другая ерунда").
Такой подход будет корректен? :)
- В чем принципиальная разница использования разных типов топиков? Почему нельзя всегда использовать, например, concept-топики?
Я вижу разницу только в возможности применении разных стилей оформления. Если этим (разным оформлением) с точки зрения бизнес-потребности можно пренебречь, то можно использовать только concept-топики? Чувствую что я вроде не прав, но не могу понять где... :)

Уф. Владимир, надеюсь, на подсказки. :) Спасибо.
Выбор системы. Выход webhelp/pdf
 
Коллеги, разобрал где и что лежит и как работает в общем, но есть дальнейшие концептуальные вопросы..... Help.  :)  

[QUOTE]- необходима возможность рецензирования. Здесь возможны варианты. Например: писатель правит текст, редактор видит что это правка (корректирует при необходимости) и выпускает "в свет". Или: писатель делает draft-лист, редактор видит что появился draft-лист и Copy&Past его с корректировками в конечный документ. Ну или как-то еще.[/QUOTE]
Каким образом можно сделать такое "рецензирование", порекомендуйте, пожалуйста, схему (подход)?

[QUOTE]
- возможность нормальной(!) совместной работы. То есть, либо топик/раздел/файл/категория (и т.д.) заблокированы при правке одним человеком вообще, например, или открывается в режиме ридонли или что-то в этом роде. Типа SVN-а.  :)  [/QUOTE]
Правильно ли я понимаю, что заталкиваем все в SVN и типа радуемся жизни?

[B]Если да, то каким образом мне, как писателю, проще сопоставить раздел файлу-топику? То есть, я хочу поправить топик "Настройка плагина Idiom", как мне найти в каком файле необходимо сделать правки текста? Лезть каждый раз в карту? [/B]
<-Ага, это я понял, XMLMind позволяет открыв карту проваливаться по ссылкам, гуд. Почему-то в Серне и в XMLPad я такого не нашел.... Ну да Бог с ним, редакторы еще поковыряем. Тем не менее остается вопрос совместной работы.... Надеюсь на помощь и Ваши предложения.


ps. Модератору: перенесите эту тему в подраздел по DITA, плиз.
Установка DITA OT 1.5.3, Установка DITA от версии 1.5.3. Подробное описание установки. Файлы для установки. Шаги установки
 
1.6.2 - согласен, но чуть позже. Понравились предложенные примеры, беру их за основу. Как изучу, проапргрейдимся.
Установка DITA OT 1.5.3, Установка DITA от версии 1.5.3. Подробное описание установки. Файлы для установки. Шаги установки
 
Не знаю, почему 1.5.3. на своих собственных примерах не стал работать, но 1.6.2. свои собственные примеры отработал.
Что касается примеров Олега, то мы же умные, чё нам доки читать.... :)
Вообщем, примеры Олега заработали, после "Для вызова XSLT-преобразования map2cover.xsl напишем специальный таргет generate-cover. Добавим его внуть файла C:\DITA-OT1.5.3\build.xml."

ВСЕМ СПАСИБО! :) Пошел изучать дальше.
Установка DITA OT 1.5.3, Установка DITA от версии 1.5.3. Подробное описание установки. Файлы для установки. Шаги установки
 
[quote="ADVANCED":2vrog4kn][quote="ADVANCED":2vrog4kn]Найти там файл build.xml
Открыть CMD и перейти в директорию файла build.xml
Выполнить ant -f build.xml
[/quote:2vrog4kn]Вру.
Надо перейти в директорию [b:2vrog4kn]\ditaot\samples\ant_sample[/b:2vrog4kn] и выполнить [i:2vrog4kn]ant -f sample_all.xml[/i:2vrog4kn] (или какой-либо другой файл-пример из имеющихся)[/quote:2vrog4kn]

А если сделать так, то результат иной:
[code:2vrog4kn]BUILD FAILED
C:\dita-ot1.5.3\samples\ant_sample\sample_odt.xml:24: The following error occurr
ed while executing this line:
C:\dita-ot1.5.3\build.xml:28: The following error occurred while executing this
line:
C:\dita-ot1.5.3\build_dita2odt.xml:50: The following error occurred while execut
ing this line:
C:\dita-ot1.5.3\build_dita2odt.xml:93: Fatal error during transformation

Total time: 32 seconds[/code:2vrog4kn]
Установка DITA OT 1.5.3, Установка DITA от версии 1.5.3. Подробное описание установки. Файлы для установки. Шаги установки
 
Коллеги, помогите, плиз.
D:\DITA_OT_Tuning>ant -f "DITA_OT_Tuning.xml"
Buildfile: build.xml does not exist!
Build failed

Доп. информация:
D:\DITA_OT_Tuning>ant -version
Apache Ant version 1.7.1 compiled on June 27 2008

D:\DITA_OT_Tuning>set ANT_HOM
ANT_HOME=C:\dita-ot1.5.3\tools\ant

До этого поставил jdk1.7.0_06. Добавил пути "C:\Program Files\Java\jdk1.7.0_06;" в PATH в системные пути и создал переменную JAVA_HOME=C:\Program Files\Java\jdk1.7.0_06 в startcmd.bat.

...добавка. А если прописными буквами указать, то вот так:
[code:3gfkiex3]D:\DITA_OT_Tuning>ant -f dita_ot_tuning.xml
Buildfile: dita_ot_tuning.xml

all:

htmlhelp:
    [copy] Copying 12 files to D:\DITA_OT_Tuning\Output\htmlhelp\img

BUILD FAILED
D:\DITA_OT_Tuning\dita_ot_tuning.xml:31: The following error occurred while exec
uting this line:
D:\DITA_OT_Tuning\dita_ot_tuning.xml:153: The following error occurred while exe
cuting this line:
Target "generate-cover" does not exist in the project "DOST".

Total time: 0 seconds[/code:3gfkiex3]
Web Help для Docbook?
 
ok, убедили. :)
Был в отпуске, читал, теперь принял решение ставить диту.
Установка DITA OT 1.5.3, Установка DITA от версии 1.5.3. Подробное описание установки. Файлы для установки. Шаги установки
 
Коллеги, а выложите, плиз, еще раз DITA_OT_Tuning.rar.
Спасибо. :)
Web Help для Docbook?
 
А так?
[url=http://blog.kasunbg.org/2010/08/docbook-webhelp-project.html]http://blog.kasunbg.org/2010/08/docbook ... oject.html[/url]
Выбор системы. Выход webhelp/pdf
 
Коллеги, позвольте создать новую тему, так как много похожих веток с годами на форуме устарели.

Посоветуйте, пожалуйста, систему (один продукт или набор) под такие исходные данные:
- конечная документация - пользовательская
- команда разработчиков (5-10 человек) программного продукта, они же будущие писатели + 2-3 сотрудника, выступающих еще в роли выпускающих редакторов.
- необходима возможность рецензирования. Здесь возможны варианты. Например: писатель правит текст, редактор видит что это правка (корректирует при необходимости) и выпускает "в свет". Или: писатель делает draft-лист, редактор видит что появился draft-лист и Copy&Past его с корректировками в конечный документ. Ну или как-то еще.
- возможность нормальной(!) совместной работы. То есть, либо топик/раздел/файл/категория (и т.д.) заблокированы при правке одним человеком вообще, например, или открывается в режиме ридонли или что-то в этом роде. Типа SVN-а. :)
- все редактирование хочется выполнять в формате максимально приближенном к WYSIWYG. То есть, правки в чистом виде wiki, где картику надо сначала залить на сервер, потом ручками набить тег и путь к картинке и в итоге потратить на вставку одной картинки одну минуту.... нежелательны. То есть вопрос не удобства визуализации в общепринятом формате WYSIWYG, а скорости работы. :)
- конечный формат: web с возможностью поиска по всему пакету и pdf.
- система или бесплатная или недорогая. Последний критерий... ну 30 000 - 50 000. Руб. Российских. :)

Заранее спасибо!

P.s. сечас документация есть в word, но устаревшая от 3 до 6 месяцев, к сожалению. Поэтому её будем и переносить и актуализировать. Кстати, разброс всего и всех в word-файлах сейчас не позволяет и нам самим (разработчикам) найти... "А где это у нас описано?"-"А Х... его знает". :)
Страницы: 1

Рейтинг@Mail.ru