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

Установка и инсталляция DITA

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

 Зарегистрируйтесь
   RSS
Установка и инсталляция DITA
 
Ссылки
IBM передала DITA под ведомство организации OASIS в марте 2004 г., и теперь эта архитектура поддерживается Техническим Комитетом OASIS DITA ( http://www.oasis-open.org/committees/dita/). В апреле 2005 г. OASIS утвердила Версию 1.0 спецификации DITA, состоящую из следующих документов:

Спецификация языка OASIS DITA: http://xml.coverpages.org/DITAv10-OS-La ... 050509.pdf
Архитектурная спецификация OASIS DITA: http://xml.coverpages.org/DITAv10-OS-Ar ... 050509.pdf
Сводный zip-файл со всеми спецификациями, DTD и схемами, открыто доступный в разделе документов на сайте Технического Комитета OASIS DITA: http://www.oasis-open.org/committees/do ... 91/cd2.zip
Опорная реализация набора инструментов для обеих версий DITA (developerWorks и OASIS 1.0) доступна на сайте проекта DITA Open Toolkit: http://dita-ot.sourceforge.net. Этот набор инструментов заменяет все предыдущие версии, опубликованные на developerWorks; последняя из них была известна под названием «dita132».

Узнайте больше о DITA из смежной статьи « Специализация типов тем в DITA», объясняющей, как реализовать специализацию в DITA (developerWorks, дополнено в сентябре 2005)
Прочитайте статью Эрика Хеннема « Специализация словарей в DITA», показывающую, как при помощи расширяемых DTD в DITA возможно определить новые области знаний (developerWorks, дополнено в сентябре 2005)
Узнайте, как присоединиться к обсуждению в форуме DITA (модераторы Дон Дэй и Майкл Пристли)
Заходите на сам форум DITA (модераторы Дон Дэй и Майкл Пристли)
Загрузите последние версии DTD, таблиц стилей и примеров документов для DITA.
Загляните в DITA FAQ (developerWorks, дополнено в сентябре 2005)
Ознакомьтесь с обзорами информационной архитектуры на сайтах Центра информационной архитектуры Argus и 10 вопросов об информационной архитектуре.
Страницы: Пред. 1 2
Ответы
 
Цитата
Добавили таргет cover.xhtml ....
В таргет dita2htmlhelp+ добавили вызов таргета cover.xhtml
В папке C:\DITA-OT1.5_M11\xsl поменяли содержимое файла map2hhp.xsl
Строку 162 закоментировали
После строки 194 добавили новую строку с содержимым cover.html
В папке C:\DITA-OT1.5_M11\demo\htmlsearch\css подредактировали search.css
В папке C:\DITA-OT1.5_M11\demo\htmlsearch\basefiles заменили файлы frameset.html и searchbox.html
В папке C:\DITA-OT1.5_M11\demo\tocjs\basefiles заменили файл tocnav.html
В папке C:\DITA-OT1.5_M11\demo\tocjs\basefiles\css заменили файл screen.css
В папку C:\DITA-OT1.5_M11\css добавили файл bercut.css
Мне кажется, что столько изменений через чур привязывает инструмент к одному рабочему месту и к одной версии Dita. При появлении новой версии Dita, нужно будет изменять столько же файлов. Для таких задач сделали возможность кастомизации. Для разных проектов/версий/форматов могут быть разные кастомизации. Можно написать скрипты так, что все само будет "делаться" на любом диске, на любой операционке для разных кастомизаций...
Цитата

Рекомендации по работе с редактром XML-Mind
Что бы длинные слова (например длинные имена переменных) не залазили на соседние ячейки таблицы и не выходили за пределы страницы в PDF предлагается использовать специальный символ пробела нулевой длины  (zero width spaces, U+200B или ​).
Разве переносами проблема не решается ? Ранее писалось, что FOP тоже настраивается
Цитата
Настройка FOP
В папку C:\DITA-OT1.5_M11\demo\fo\fop\conf добавили файл fop.xconf, старый переименовали в !OLDfop.xconf
В папку C:\DITA-OT1.5_M11_\demo\fo\fop\lib добавили файл fop-hyph.jar
В CLASSPATH startcmd.bat добавили %DITA_DIR%demo\fo\fop\lib\fop-hyph.jar; старый переименовали в !OLDstartcmd.bat.xconf
fop-hyph.jar занимается переносами и выравниванием.
 
Цитата
Мне кажется, что столько изменений через чур привязывает инструмент к одному рабочему месту и к одной версии Dita. При появлении новой версии Dita, нужно будет изменять столько же файлов. Для таких задач сделали возможность кастомизации. Для разных проектов/версий/форматов могут быть разные кастомизации. Можно написать скрипты так, что все само будет "делаться" на любом диске, на любой операционке для разных кастомизаций...
Да, при выходе нового тулкита приходится повторить описанные шаги - именно для этого и делал это описание -дабы без меня могли настроить  
Руками требуется настроить только один тулкит и потом копировать его на другую машину (может понадобиться только указать другой путь к яве в стартовом скрипте), т.е. на каждой иашине повторять шаги совсем не обязательно


Скрипт автонастройки - конечно можно было и написать - но руки не дошли - наш отдел документации больше интересовали конвертеры из наших внутренних форматов и ORACLE сразу в DITA - чем я и занялся.
Некоторые из наших внутренних форматов были XML, вначале думал написать XSLT использовать но потом написал некоторые на полноценных язаках - некоторые на  Ява, некоторые на C++ (хотелось нормальный пользовательский интерфейс реализовать) - это позволило сэкономить просто десятки человекомесяцев работы типа копи-паст

Да и где гарантия что в новом тулките не изменится что нить так что они уже не отработают...
Некоторые изменения фиксят баги в плагинах - если их в новой версии таки пофиксят сами разработчики то мои изменения просто не понадобятся вообще...

В основном много изменений связано с тем что бы получался корректный PDF, XHTML и HTMLHelp и все в рамках одного тулкита и билда...
Более того у нас клиенты (сотовые операторы) иногда просят представить документацию с их лого, реквизитами и т.д. для это в билде (см. файл DITA_OT_Tuning.xml внутри архива DITA_OT_Tuning.rar) создано свойство document.style (можно указать как "bercut", "tele2", "mts", "beeline" "megafon") и соответственно в выводе меняется под этого заказчика...

Цитата
Разве переносами проблема не решается ? Ранее писалось, что FOP тоже настраивается
fop-hyph.jar занимается переносами и выравниванием.
Переносы для русского языка настроенны, но у нас в русской документации фигурируют длинные (как правило составные)  названия переменных на английском - вот когда они попадают в таблицу то получается некрасиво  - не удалось заставить работать переносы на русском и английском одновременно...
 
Цитата
В основном много изменений связано с тем что бы получался корректный PDF, XHTML и HTMLHelp и все в рамках одного тулкита и билда...
Более того у нас клиенты (сотовые операторы) иногда просят представить документацию с их лого, реквизитами и т.д. для это в билде (см. файл DITA_OT_Tuning.xml внутри архива DITA_OT_Tuning.rar) создано свойство document.style (можно указать как "bercut", "tele2", "mts", "beeline" "megafon") и соответственно в выводе меняется под этого заказчика...
Ну это и есть Кастомизация Customization. Я имел ввиду, что папка кастомизации может быть совершенно на другом сервере и для каждого заказчика своя. У тебя она называется document.style, у меня custom. В оригинальных файлах Dita эта папка задана в виде переменной и по умолчанию подразумевается "если не задан пользовательский, то использовать оригинал". Это уже предусмотрели разработчики Dita open toolkit. В идеале, по этой задумке параметр должен передаваться через bat файл (если нужно могу описать как передавать из bat разные команды Анту).

Таким образом, можно ничего не делать с оригинальной версией Ditaot, а все настройки (pdf, chm, html...), стили (для каждого заказчика), локализации (en, ru, fr ...) хранить в совершенно сторонней (-их) папке (-ах) на другом диске, сервере и т.п. Даже по каждому проекту может требоваться разное оформление, как например корп.стандарт и ГОСТ. Я делал много кастомизаций и 1 кнопкой задаю что мне надо получить.

Также может потребоваться разграничение прав на изменение тех или иных стилей. Например, когда стиль утвержден официально и документация должна соответствовать ему. В этом случае вся dita и кастомизации были под моим контролем, а запускать публикацию я разрешал только после ввода логина и пароля писателя или тестировщика.

Повторюсь, это задумка разработчиков Dita. При появлении новой версии dita-ot она всего лишь распаковывается "куда-нибудь" на диске и всего в одном bat указывается этот путь.
 
Цитата
Ну это и есть Кастомизация Customization. Я имел ввиду, что папка кастомизации может быть совершенно на другом сервере и для каждого заказчика своя. У тебя она называется document.style, у меня custom. В оригинальных файлах Dita эта папка задана в виде переменной и по умолчанию подразумевается "если не задан пользовательский, то использовать оригинал". Это уже предусмотрели разработчики Dita open toolkit. В идеале, по этой задумке параметр должен передаваться через bat файл (если нужно могу описать как передавать из bat разные команды Анту).

Таким образом, можно ничего не делать с оригинальной версией Ditaot, а все настройки (pdf, chm, html...), стили (для каждого заказчика), локализации (en, ru, fr ...) хранить в совершенно сторонней (-их) папке (-ах) на другом диске, сервере и т.п. Даже по каждому проекту может требоваться разное оформление, как например корп.стандарт и ГОСТ. Я делал много кастомизаций и 1 кнопкой задаю что мне надо получить.

Также может потребоваться разграничение прав на изменение тех или иных стилей. Например, когда стиль утвержден официально и документация должна соответствовать ему. В этом случае вся dita и кастомизации были под моим контролем, а запускать публикацию я разрешал только после ввода логина и пароля писателя или тестировщика.

Повторюсь, это задумка разработчиков Dita. При появлении новой версии dita-ot она всего лишь распаковывается "куда-нибудь" на диске и всего в одном bat указывается этот путь.
Вообще эта идеалогия появилась с вводом плагина Idiom в состав тулкита - и для него папка кастомизации существует - можно ее перенести куда либо и указать в тулките ссылку на него...

Но для вывода в XHTML и HTMLHelp - в особенности при использовании плагинов Plus и TOC Navigation Plugin, HTMLSearch Plugin каталога кастомизации не существует  - например при интеграции плагинов "Plus" происходит просто добавление новых таргетов в файл build.xml тулкита - т.о. уже ковыряется тулкит... некоторые вещи тоже не работают пока не подкавыряешь тулкит

Плагин HTMLSearch Plugin уже предлагает фреймовую структуру в которой есть заголовочная страница - так что теперь приходится ковырять тулкит и сам плагин дабы она менялась из инфа в метаданных карты документа

Идеологоя полной кастомизации весчь хорошая - но когда пользуем плагины да и Css уже приходится ковырять тулкит - во всяком случае твк было когда я настраивал - может теперь разработчики тулкита и перенесли эту идеалогию и для других (кроме pdf) выводов - но как быть с плагинами...
Плагинами "Plus" пришлось пользоваться ради указателя на русском в HtmlHelp
Да и заглавочные страницы без ковыряния скриптов тулкита настроить не получалось
 
Цитата
Цитата
может теперь разработчики тулкита и перенесли эту идеалогию и для других (кроме pdf) выводов - но как быть с плагинами...
Плагинами "Plus" пришлось пользоваться ради указателя на русском в HtmlHelp
Да и заглавочные страницы без ковыряния скриптов тулкита настроить не получалось
:shock:
Без плагинов справляемся. Есть папка \dita-ot\resource в которой лежат нужные css, шаблон страницы html, иконки,  скрипты и т.п. Эта папка указывается в стартовом билд-скрипте   [code:3qxd6m3l] <property name="dita.resource.dir" value="${builder.dir}\custom\newsite\resource" /> [/code:3qxd6m3l]В процессе генерации CHM, HTML содержимое именно этой папки используется в создании output.

Согласен, для решения проблемы кириллицы надо "влезть" в оригинальный код. Но там 2 строки добавить. больше изменять не нужно ничего.
 
Цитата

Без плагинов справляемся. Есть папка \dita-ot\resource в которой лежат нужные css, шаблон страницы html, иконки,  скрипты и т.п. Эта папка указывается в стартовом билд-скрипте   [code:3mn6jqoj] <property name="dita.resource.dir" value="${builder.dir}\custom\newsite\resource" /> [/code:3mn6jqoj]В процессе генерации CHM, HTML содержимое именно этой папки используется в создании output.
Согласен, для решения проблемы кириллицы надо "влезть" в оригинальный код. Но там 2 строки добавить. больше изменять не нужно ничего.
Думаю можно и так
Просто в свое время встала задача быстро реализовать русский поиск, указатель, JS TOC-навигацию в XHTML и были использованы эти плагины - если их не пользовать придется это все сделать самому и сложить в папку resource.
Если у вас это сделано - исходники в студию
 
Цитата
Плагинами "Plus" пришлось пользоваться ради указателя на русском в HtmlHelp
Разберу по кусочкам:
1. СHM не отображает индекс и не позволяет осуществлять поиск по страницам, файлы которых до компиляции были в кодировке UTF-8. HtmlHelpWorkshop прекрасно работает с кириллицей, у Майкрософта есть русская версия, локализхации и т.п. Кроме того, различные ПЛАТНЫЕ инструменты уже имеют в своем дистрибутиве утилиту hhc.exe, которая запускается в командной строке.

2. Редактор XML в windows позволяет сохранять файлы в разных кодировках, но FOP не воспринимает ничего кроме UTF-8, но ничего страшного в этом нет. Если у нас проект с двумя и более форматами (PDF, CHM, HTML...) то кастомизировать нужно каждый. Либо настраивай, либо плати бабло и сиди на всем готовом

3. Если кто делал CHM, то должны знать, что HtmlHelpWorkshop берет hhc, hhk, hhp и разные css.
У нас есть исходники в UTF-8. Получается, что для компиляции PDF нам с кодировками делать ничего не надо. Для решения проблемы в CHM нам нужно получить файлы HHC и HHK в кодировке windows-1251 ПЕРЕД их компиляцией в CHM.
Для этого открываем файл /ditaot/build_dita2htmlhelp.xml и ищем таргет [b:2ym8vfj3]dita.out.map.htmlhelp.hhc"[/b:2ym8vfj3]
После описания параметров таргета добавляем следующие строки:
[code:2ym8vfj3]
           <move filtering="yes" file="${output.dir}${file.separator}${dita.map.filename.root}.hhc"
                 tofile="${output.dir}${file.separator}${dita.map.filename.root}.hhc.encoded"
                 encoding="utf-8" outputencoding="windows-1251"/>
     
           <move file="${output.dir}${file.separator}${dita.map.filename.root}.hhc.encoded"
                 tofile="${output.dir}${file.separator}${dita.map.filename.root}.hhc"/>
[/code:2ym8vfj3]
[u:2ym8vfj3]Новый, только что полученный файл ditamapname.hhc пересохраняем в нужную кодировку с другим имененм, потом переименовываем обратной в исходное имя.[/u:2ym8vfj3]

Тоже самое добавляем в таргет [b:2ym8vfj3]dita.out.map.htmlhelp.hhk[/b:2ym8vfj3], соответственно изменив расширения файлов.

Далее все выполняется как задано сценарием: compile.HTML.Help, подключается компилятор HtmlHelpWorkshop и выдает готовый CHM с поиском на русском и оглавлением. BUILD_SUCCESSFUL и т.п.  :D
С плагинами, мне кажется дольше возиться.
 
У мну тоже происходит преобразование в windows-1251 - но другим способом

Как быть с поиском и TOC-навигацией в XHTML
 
Цитата
Если у вас это сделано - исходники в студию
Какие именно исходники? Как реализовано в оригинальной Dita написал в предыдущем комментарии. Больше там ничего не менялось вообще. Остальные скрипты самописные и толку от них вам будет мало. Лучше спрашивайте как сделать что-то конкретное.
 
Цитата
У мну тоже происходит преобразование в windows-1251 - но кажись русский указатель все равно не работал...
В CHM ? Тут 2 момента надо уловить. Есть кодировка HTML страницы, а есть кодировка файла.
В Linux все файлы по умолчанию сохранены в utf-8 и Linux не знает других кодировок.
В Windows каждому файлу присваивается код, который редакторы и интерпретаторы считывают чтобы понять как далее обрабатывать файл.
Цитата
Многие программы Windows (включая Блокнот) добавляют байты 0xEF, 0xBB, 0xBF в начале любого документа, сохраняемого как UTF-8. Это метка порядка байтов Юникода (англ. Byte Order Mark, BOM), также её часто называют сигнатурой (соответственно, UTF-8 и UTF-8 with Signature). По наличию сигнатуры программы могут автоматически определить, является ли файл закодированным в UTF-8, однако файлы с такой сигнатурой могут некорректно обрабатываться старыми программами, в частности xml-анализаторами. Такие редакторы, как Notepad++, Notepad2 и Kate позволяют явно указывать, следует ли добавлять сигнатуру при сохранении UTF-файлов.
HTMLHelpworkshop как раз работает под Win и считывает этот  код. Для удачной (для нас) компиляции ему нужно, чтобы 2 файла HHC (это ТОС, оглавление) и HHK (это индекс) были именно в кодировке windows-1251. С HHP все проще, в нем содержатся все страницы с текстом и поиск там работает нормально. Если нет, то также можно перекомпилировать в 1251. Тут еще может влиять язык операционки.

[b:3h9k993o]Следует различать кодировку файла 0xEF, 0xBB, 0xBF и кодировку кода[/b:3h9k993o] <?xml version="1.0" encoding="UTF-8"?>.
Уверен, что плагины и "дорогие" инструменты делают тоже самое, только за спиной пользователя. Не позволяя ему видеть что и как работает. Тем самым оправдывая свою цену. Поставил флажок, нажал ОК, получил результат.

Я пробовал вручную собирать утилитой из 3 файлов в разных кодировках, экспериментировал пока не "допер" как, что и вкаком виде требуется компилятору. Все тоже самое потом поручил делать Ant автоматически.
 
По поводу указателя на русском языке в CHM - тут в действительности мы делаем одно и тоже (установка кодировки) только несколько разными способами.
Основная проблема в том что оригинальное тулкитовское преобразование в HTMLHelp, которое вызывается как
[code:y955ey0n]<ant antfile="${dita.dir}${file.separator}build.xml" target="init">
<property name="transtype" value="htmlhelp"/>
       ...
</ant>[/code:y955ey0n]
не позволяет задать кодировку напрямую в стартовом билд-файле документа  - приходится ковыряться в тулките - как сделали вы в примере выше...

Выяснилось что есть некий бесплатный набор плагинов "Plus" Plugins, который представляет из себя не более чем набор XSLT-преобразований и билд-скриптов (в синтаксисе ANT) специально написанных для интеграции в тулкит (не какой-то там закрытый бинарный код)...  Интеграция этого набора расширяет возможности тулкита для форматов html, xhtml, htmlhelp, eclipsehelp....
В частности появляется возможность  задавать кодировку файла в стартовом билде документа путем указания следующих свойств
[list:y955ey0n]
[*:y955ey0n]plus.htmlhelp.encoding[/*:m:y955ey0n]
[*:y955ey0n]plus.topics.encoding[/*:m:y955ey0n][/list:u:y955ey0n]
вот как вызывается сборка HTMLHelp с использованием "Plus" Plugins. Заметьте что в отличии от вызова оригинальной тулкитовской сборки HTMLHelp свойство transtype задано как htmlhelp+ (добавляется "+"), а не  htmlhelp.
[code:y955ey0n]
<ant antfile="${dita.dir}${file.separator}build.xml" target="init">

<property name="transtype" value="htmlhelp+"/>


<property name="output.dir" value="${com.output.dir}${file.separator}htmlhelp"/>


<property name="args.css" value="${dita.dir}${file.separator}css${file.separator}${document.style}.css"/>


<property name="args.copycss" value="yes"/>


<property name="args.csspath" value="css"/>


<property name="plus.topics.class" value="basic"/>


<property name="disableRelatedLinks" value="no" />


<property name="plus.htmlhelp.encoding" value="windows-1251"/>


<property name="plus.topics.encoding" value="windows-1251"/>
</ant>
[/code:y955ey0n]
Надо сказать что возможности "Plus" Plagins не ограничиваются возможностью установки кодировки (напрямую в стартовом билде документа), этот набор еще много чего умеет - например поддержка XML-форматов для векторной графики - SVG и математических выражений - MATHML.
В моем стартовом билде документа имеются соответствующие глобальные свойства проекта
[code:y955ey0n]














[/code:y955ey0n]
Я их закоментировал т.к. с этим не играился - хотя реализовать автоматическую подстановку подписей на картинках на нужном языке в зависимости от локали документа для форматов XHTML и HTMLHelp было бы интересно... думается SVG это должен позволить...
Цитата
Цитата
Если у вас это сделано - исходники в студию
Какие именно исходники? Как реализовано в оригинальной Dita написал в предыдущем комментарии. Больше там ничего не менялось вообще. Остальные скрипты самописные и толку от них вам будет мало. Лучше спрашивайте как сделать что-то конкретное.
Ну исходники еще одной реализации TOC-навигации и поиска в XHTML в этом форуме не помешают... Чтобы был поиск, алфавитный указатель наверное в гипертексте не имеет смысла, заглавная страница формировалась сама, лого подставлялся, оглавление (TOC) было реализовано на каком нить скриптовом языке и вообще все выглядело красиво, да еще и так что бы тулкит особо не ковырять... В соседней ветке это уже спрашивали...
Например для версии тулкита 1.4 я выдернул реализацию XHTML от комерческой XML CMS SiberSafe, тамко всему и реализация Breadcrumbs была, но покупать их CMS мы не стали, а использовать их реализацию было бы нарушением авторских прав.
Просто оригинальная тулкитовская TOC-навигация в XHTML (в виде plain-текста) выглядит убого... поиска насколько помню тоже нет... указателя тоже -  что бы получить что-то лучшее надо самому написать их более красивую реализацию...
Либо юзать бесплатные (просто кто-то уже поделился своей версией) варианты  - TOC Navigation Plugin и HTMLSearch Plugin (со своими плюсами и минусами). Я сделал используя их, но это потребовало модификации тулкита так как они интегрируются в основной билд тулкита и их допиливания дабы отображалась на заглавной странице метаинформация из карты документа... а также наше лого... + менял CSS

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

Я поделился тем как сделано у нас - т.е. вот тулкит, вот билд, вот пример документа - вот последовательность шагов для сборки... И описал вкратце что менял в своем тулките по сравнению со скачанным и для чего...
В каких-то моментах (указатель CHM) как оказывается можно сделать подругому... по другим моментам я так и не понял как у вас реализуется поиск и навигация в XHTML...
 
Здравствуйте, Уважаемые:))
Простите за тупость, но чего то не могу найти в какую папку и какие файлы нужно складывать, чтобы получился один единый документ.

я взял за основу вот этот комплект - http://www.getzilla.net/files/1346712/dita_ot1.5.2.zip.html
порывшись там, нашел как можно сменить логотип.
но не смог найти файлы топиков:((

подскажите где рыть....
заранее спасибо
С уважением, Максим!
 
Цитата
Здравствуйте, Уважаемые:))
Простите за тупость, но чего то не могу найти в какую папку и какие файлы нужно складывать, чтобы получился один единый документ.

я взял за основу вот этот комплект - http://www.getzilla.net/files/1346712/dita_ot1.5.2.zip.html
порывшись там, нашел как можно сменить логотип.
но не смог найти файлы топиков:((

подскажите где рыть....
заранее спасибо

Не совсем понятен вопрос - какие файлы топиков вы ищите
Если ищите пример  документа в формате DITA - DITA_OT_Tuning.rar  (DITA-сорцы гайда по настройке тулкита и файл билда) - то старая ссылка походу устарела
Еще сюда положил [u:t38xnt4b]http://rghost.ru/18876221[/u:t38xnt4b] (На 30 дней выложил 22.08.11)

как провести сборку описано в этой ветке
 
я имею ввиду разделы из которых состоит документ:
"Настройка вывода PDF"
"Настройка HTMLHelp"

в каждом разделе заголовки и текстовка.
вот именно текстовую часть куда (в какой файл) пихать, чтобы потом получить один сводный pdf или html?
просмотрел  папки, нашел в папке Task файлики
ANT_config.dita
Batik_install.dita
Cover_adjust.dita
Eng_Rus.dita
FOP_config.dita
HTMLHelpWsh_pluginPLUS_install.dita
HTMLSearch_plugin_install.dita
Idiom_plugin_config.dita
Template_for_pdf.dita
TOC_JS_install.dita
Zero_space.dita

получается это разделы с текстовкой.
если так, то потихоньку начинаю въезжать:)
============================================================­========================
скачал новый архив, на который Вы указали. при попытке создать доки выдает ошибку:
последняя часть сообщения:
"publish.map.pdf:
    [echo] current target:publish.map.pdf

transform.topic2pdf:

copyCoreArtwork:

transform.topic2fo:
[dita-version] Search finished
    [echo] Using document.locale=ru_RU
    [echo]
    [echo] Java maximum memory=500m
    [java] [ERROR] Topic reference (href : #null) not found !
    [java] [ERROR] Reference may be incorrect. Please correct your ditamap or b
ookmap file.
    [java] Processing terminated by xsl:message at line 110 in root-processing.
xsl
    [java] Java Result: 1
[i18n-preprocess] [Fatal Error] :-1:-1: Premature end of file.

BUILD FAILED
D:\DITA_OT_Tuning_1\DITA_OT_Tuning.xml:49: The following error occurred while ex
ecuting this line:
D:\DITA_OT_Tuning_1\DITA_OT_Tuning.xml:171: The following error occurred while e
xecuting this line:
C:\DITA-OT1.5.2\build.xml:68: The following error occurred while executing this
line:
C:\DITA-OT1.5.2\build.xml:142: The following error occurred while executing this
line:
C:\DITA-OT1.5.2\demo\fo\build.xml:177: The following error occurred while execut
ing this line:
C:\DITA-OT1.5.2\demo\fo\build.xml:363: The following error occurred while execut
ing this line:
C:\DITA-OT1.5.2\demo\fo\build.xml:338: org.xml.sax.SAXParseException: Premature
end of file.

Total time: 9 seconds"
============================================================­=============================
С уважением, Максим!
 
А почему у вас каталог задан как DITA_OT_Tuning_1 а не DITA_OT_Tuning
я же писал -  Распаковываем пример документа DITA_OT_Tuning.rar на диск D:
соответственно и ошибка
 
спасибо .. исправился.
А скажите где создается титульный лист?

посмотрел  odt файлик.. как то мне не очень понравился. почему то все разбито, заголовок на одной странице, а текст на другой.. хотя мож и у меня чего в настройках OOо сделано
С уважением, Максим!
 
Цитата
спасибо .. исправился.
А скажите где создается титульный лист?

посмотрел  odt файлик.. как то мне не очень понравился. почему то все разбито, заголовок на одной странице, а текст на другой.. хотя мож и у меня чего в настройках OOо сделано

Титутульный лист в каком формате? Перечитайте эту ветку полностью...

В этом тулките я не настраивал ODT.
Вывод в ODT был добавлен чтобы посмотреть что получается - дополнительные настройки не осуществлялись...
 
интересует титульный для pdf..

прочитал.. везде даются ссылки на настроечный файл.. map2cover.xsl
С уважением, Максим!
 
Цитата
интересует титульный для pdf..

прочитал.. везде даются ссылки на настроечный файл.. map2cover.xsl

Начиная с версии тукита кажется 1.5 в его составе уже идет плагин Idiom предназначенный для получения PDF. Соответственно идеология этого плагина подразумевает что вся кастомизация, осуществляется в каталоге Customization.
Делается это с помощью XSLT-преобразования в промежуточный формат XSL FO (уже из этого формата FOP делает PDF) - смотрите темплейт  createFrontMatter в файле  C:\DITA-OT1.5.2\demo\fo\Customization\fo\xsl\custom.xsl. Этот темплейт берет данные из карты документа и кладет в XSL FO.

Есть неплохой док про настройку PDF (Customizing PDF output in the DITA Open Toolkit) - [u:1106pbd0]http://www.scriptorium.com/whitepapers/ditaotpdf/DITA-PDF-tweaks.pdf[/u:1106pbd0]

P.S. Ссылку на тулкит обновил... [u:1106pbd0]http://rghost.ru/18975961[/u:1106pbd0] т.к. в том что у вас - интерфейс навигации и поиска в формате XHTML статический (т.е. не выбирается автоматом в зависимости от свойства локали в стартовом билде документа)
 
спасибо.. большое
пошел учитьcя дальше:))
С уважением, Максим!
 
Добрый день, o_alekseev

P.S. Ссылку на тулкит обновил... [u:2x2wwdm1]http://rghost.ru/18975961[/u:2x2wwdm1] т.к. в том что у вас - интерфейс навигации и поиска в формате XHTML статический (т.е. не выбирается автоматом в зависимости от свойства локали в стартовом билде документа)[/quote]


Взял Вашу ссылку. попробовал построить  доки.
в окне ДОСа выдается сообщение: BUILD FAILED
D:\DITA_OT_Tuning\DITA_OT_Tuning.xml:47: The following error occurred while executing this line:
D:\DITA_OT_Tuning\DITA_OT_Tuning.xml:85: The following error occurred while executing this line:
C:\DITA-OT1.5.2\build.xml:421: C:\DITA-OT1.5.2\demo\htmlsearch\images not found.

но доки формируются и pdf, и odt и chm.
Это нормально?
С уважением, Максим!
 
Цитата
Добрый день, o_alekseev

в окне ДОСа выдается сообщение: BUILD FAILED
D:\DITA_OT_Tuning\DITA_OT_Tuning.xml:47: The following error occurred while executing this line:
D:\DITA_OT_Tuning\DITA_OT_Tuning.xml:85: The following error occurred while executing this line:
C:\DITA-OT1.5.2\build.xml:421: C:\DITA-OT1.5.2\demo\htmlsearch\images not found.

но доки формируются и pdf, и odt и chm.
Это нормально?
Не удалась сборка в формат XHTML
Может вы грохнули
C:\DITA-OT1.5.2\demo\htmlsearch\images

Надо либо создать такую папку (пустая), либо закоментировать в таргете web2search в файле C:\DITA-OT1.5.2\build.xml этот код
[code:w7bn0fo6]
<copy todir="${htmlrootdir}${file.separator}images">
       
<fileset dir="${dita.dir}${file.separator}demo${file.separator}htmlsearch${file.separator}images">
           
<include name="*.*">
</include>
       
</fileset>
   
</copy>
[/code:w7bn0fo6]
 
Вот новый уже настроенный тулкит 1.5.3
http://techwriters.ru/forum/viewtopic.php?f=47&t=1142&sid=1e9bf49557e4e2d795b362e0aa5368ee
Страницы: Пред. 1 2
Читают тему

Рейтинг@Mail.ru