https://lib.custis.ru/index.php?action=history&feed=atom&title=Darwin_Information_Typing_Architecture 2026-05-05T17:32:28Z История изменений этой страницы в вики MediaWiki 1.26.4 https://lib.custis.ru/index.php?title=Darwin_Information_Typing_Architecture&diff=10778&oldid=prev 2009-04-07T00:00:26Z

<p>1 версия</p> <table class='diff diff-contentalign-left'> <tr style='vertical-align: top;' lang='ru'> <td colspan='1' style="background-color: white; color:black; text-align: center;">← Предыдущая</td> <td colspan='1' style="background-color: white; color:black; text-align: center;">Версия 00:00, 7 апреля 2009</td> </tr><tr><td colspan='2' style='text-align: center;' lang='ru'><div class="mw-diff-empty">(нет различий)</div> </td></tr></table>

BenderBot https://lib.custis.ru/index.php?title=Darwin_Information_Typing_Architecture&diff=10777&oldid=prev 2009-04-06T15:53:20Z

<p>+{{replicate-from-custiswiki-to-lib}}, стилевые правки, орфография/пунктуация</p> <p><b>Новая страница</b></p><div>Darwin Information Typing Architecture (DITA) — способ написание технической документации<br /> на основе [[XML]] разработанный в компании IBM.<br /> Данная статья написана в результате исследования технологии DITA, как возможного стандарта документирования в компании.<br /> <br /> Используется в компаниях:<br /> * IBM<br /> * Oracle<br /> * Adobe<br /> * Autodesk<br /> * EMC<br /> * Nokia<br /> * McAfee, Inc.<br /> * Sybase, Inc.<br /> * и другими, полный список тут http://dita.xml.org/deployments<br /> * так же используется для документирования в проекте Apache Derby (база данных)<br /> * существует ряд коммерческих CMS систем поддерживающих DITA<br /> <br /> Основные преимущества:<br /> * ориентация на темы при написании текста;<br /> * ориентация на повторное использование текста;<br /> * специализация;<br /> * обработка на основе свойств;<br /> * использование существующих тегов и инструментов.<br /> <br /> Основные свойства:<br /> * основана на плоской [[XML]]-разметке;<br /> * поддерживает произвольные теги разметки;<br /> * возможность преобразования в форматы:<br /> ** wordrtf<br /> ** pdf<br /> ** html<br /> ** xhtml<br /> ** eclipsehelp<br /> ** eclipsecontent<br /> ** javahelp<br /> ** htmlhelp<br /> ** xml docbook<br /> ** troff<br /> <br /> == Основные преимущества ==<br /> <br /> === Ориентация на темы ===<br /> <br /> При написании текста на DITA используются короткие файлы описывающие что-то простое: одну тему, одну операцию, какое-то понятие в приложении, термин и т. д.<br /> <br /> На этом рисунке изображена схема основных тем DITA:<br /> [[Image:basediag.gif]]<br /> * topic<br /> * concept<br /> * task<br /> * reftopic<br /> <br /> Далее все эти короткие тексты собираются воедино при помощи специального файла-карты.<br /> В этом файле описано в каком порядке и как по уровням иерархии темы связаны между собой.<br /> <br /> === Ориентация на переиспользование ===<br /> <br /> Таких файлов-карт может быть несколько, таким образом на основе одних и тех же текстов можно создавать различные документы.<br /> Эти документы могут быть предназначены для разных людей («руководство пользователя», «руководство администратора» и т. д.),<br /> но при этом содержать одинаковые куски информации.<br /> <br /> Таким образом исключается ситуация, когда одно и тоже необходимо писать<br /> в разных документах несколько раз разными словами, или проводить копирование (''copy-paste'') текста.<br /> <br /> Итоговая документация собирается из маленьких кусков, законченных по смыслу, в единый документ.<br /> <br /> === Специализация ===<br /> <br /> Одной из проблем которую компания IBM хотела решить при создании DITA была проблема различных разметок XML.<br /> Разные команды технических писателей хотели использовать различные наборы тегов.<br /> Эта проблема решена в DITA при помощи механизма специализации.<br /> <br /> На основе существующего набора разметок можно создать новые теги, которые можно использовать при создании текста.<br /> Отображение новых тегов можно создать дополнив описание существующих («наследовав») и\или немного изменив его.<br /> Так можно создать дополнительную разметку, лучше отражающую предметную область или более удобную для написания.<br /> <br /> Так же можно расширять стандартный набор тем, при помощи «наследования», как показано на рисунке ниже:<br /> <br /> [[Image:DITA-manydiag.gif]]<br /> <br /> === Обработка на основе свойств ===<br /> <br /> Для тегов в XML-тексте можно задавать различные свойства, например:<br /> xml:lang=&quot;ru-ru&quot;<br /> В результате можно проводить обработку текста на основе этих свойств.<br /> В данном случае будет изменен стандартный набор строк для подстановки (chapter-глава и т. д.).<br /> Можно указывать и другие свойств, такие как «аудитория, которой предназначен текст» и т. д.<br /> При помощи механизма специализации для новых тегов можно создавать свои свойства и проводить обработку на их основе.<br /> <br /> === Использование существующих тегов и инструментов ===<br /> <br /> Поскольку DITA основана на XML, можно использовать широкий набор существующих инструментов для написания текста.<br /> Так же можно, используя существующий текст на произвольной разметке, преобразовать его в XML при помощи DITA.<br /> <br /> == Проблемы ==<br /> <br /> === Русский язык ===<br /> При преобразовании в RTF или PDF русские символы преобразуются неправильно.<br /> <br /> В случае RTF это связано с тем, что при преобразовании в результирующем файле символы оказываются в кодировке UTF-8.<br /> <br /> Для PDF вероятно причина в том, что необходимы шрифты с кириллическими символами.<br /> <br /> == Резюме ==<br /> <br /> Несмотря на всю продвинутость и удобство технологии как таковой не обнаружено существенных преимуществ<br /> по сравнению с [[SGML Docbook]], которые могли бы способствовать переходу на нее.<br /> <br /> Со временем по мере развития DITA возможно эту позицию стоит пересмотреть.<br /> <br /> Идеальная технология документирования должна удовлетворять требованиям:<br /> * имеет достаточно простую разметку;<br /> * отделяет содержание от представления;<br /> * позволяет вести текст в плоской разметке;<br /> * есть механизм предпросмотра текста с возможность перехода от представления к тексту и обратно;<br /> * возможна генерация различных форматов из единого источника (имеются ввиду как форматы файлов, так и стили текста);<br /> * распространенная<br /> * open-source<br /> <br /> == Ссылки ==<br /> <br /> === Инструменты ===<br /> <br /> * http://sourceforge.net/projects/dita-ot/ — DITA open toolkit, открытая реализация стандарта DITA<br /> * http://www.alphaworks.ibm.com/tech/taskmodeler — приложение на основе Eclipse, которое в том числе позволяет создавать карты DITA<br /> * http://xmlbuddy.com/ — плагин к Eclipse для редактирования XML, есть платная и бесплатная версии<br /> <br /> === Статьи ===<br /> <br /> * http://www.google.com/search?hl=en&amp;q=darwin+dita&amp;btnG=Google+Search<br /> * http://www.ibm.com/developerworks/xml/library/x-dita1/ — статья вкратце описывающая DITA<br /> * http://xmlhack.ru/texts/06/dita/dita.html — перевод статьи выше на русский язык<br /> * http://www.comtech-serv.com/workshops/dita.shtml<br /> * http://edutechwiki.unige.ch/en/DITA<br /> * http://xml.coverpages.org/dita.html<br /> * http://idealliance.org/proceedings/xtech05/papers/04-02-02/<br /> * http://en.wikipedia.org/wiki/DITA<br /> * http://dita.xml.org/wiki<br /> * http://www.ditaopentoolkit.org/<br /> * http://www.ditausers.org/tools/web_editors/<br /> * http://www.ibm.com/developerworks/xml/library/x-dita2/index.html<br /> * http://docs.oasis-open.org/dita/v1.1/CS01/langspec/langref/topic.html<br /> <br /> [[Категория:Документирование]]<br /> {{replicate-from-custiswiki-to-lib}}</div>

StasFomin