Podcasts and RSS feeds - Новости о DocBook по-русски

DocBook V5.0 стал официальным стандартом OASIS.

Технический комитет на своем заседании 7 ноября 2007 принял решение о том, что DocBook v.5.0 достиг стадии Committee Draft. Фаза под названием Candidate Review пройдена, и хотя предстоит еще формальное получение статуса Committee Specification, техническая работа завершена. А значит, разработчки и пользователи могут смело переходить на версию 5.0, не опасаясь изменений спецификации.

У wiki.docbook.org появилась возможность экспорта контента в формат... DocBook. Те, кто пытались внедрить DocBook в качестве стандарта для исходных текстов документации в своей компании, знают как сложно заставить сотрудников пользоваться чем-либо помимо Word. XML-редакторы не спасают: у нормального сотрудника (не технаря) любые тэги вызывают ужас. Возможное решение: внедрите у себя Wiki — штуку не только полезную по очень многим соображениям, но и предельно простую с точки зрения ввода текстов. Вынимайте из нее накопленный контент в формате DocBook и используйте его в качестве «исходного сырья» для документации.

DocBook V4.5 стал официальным стандартом OASIS. Предыдущей официальной версией был DocBook V4.1, опубликованный в декабре 2003. Версия 4.5 по-видимому станет последней в ветке 4.X. Оглядываясь назад, третья версия в свое время завершила эволюцию монолитного DTD и стала началом параметризованного DTD, рассчитанного на интенсивную кастомизацию. Версия 4 ознаменовала конец эры SGML и стандартизацию XML DTD. Версия 5 отмечает завершение эволюции DTD и переход к RELAX NG. Норман Уолш поздравляет все сообщество DocBook с достижением статуса официального стандарта OASIS, являющегося важной вехой в развитии DocBook.

Известный недостаток DocBook Website — полностью статическая навигация. Меню подверстывается к каждой веб-странице; как результат, добавление к сайту одной страницы приводит к перестроению всех остальных. По мере разрастания сайта это становится проблемой. На этой технологии был сделан, в частности, сайт docbook.org. Поддерживающий его Норман Уолш сказал «хватит» и изменил как дизайн, так и технологию сайта. Теперь меню формируется отдельно от контента и пристыковывается к нему при помощи server-side include, а исходники контента форматируются как DocBook V.5 вместо . На наш взгляд, постановка задачи правильная — меню надо отделить от контента. Но вместо SSI для этого можно было бы воспользоваться Javascript. Зависимость от клиента? да, но зато независимость от настроек сервера и снижение трафика. Так что docbook.ru пока останется памятником, копирующим «классический» дизайн docbook.org.

Сравнение DocBook и DITA. Вероятно небеспристрастное, поскольку автор, Норман Уолш, не может не симпатизировать первому. Самое существенное, по версии автора, отличие — DocBook в большей степени ориентирован на последовательное «книжное» изложение, DITA — на стиль разрозненных комментариев («topic-oriented authoring paradigm»). Для тех, кто интересуется проектными решениями и архитектурой систем документирования.

Технический комитет DocBook выпустил первый бета-релиз DocBook V5.0. До официальной версии выйдет еще серия бета- и кандидат-релизов, но главное что процесс стартовал. Те, кто интересуются DocBook 5, на сайте docbook.org найдут соответствующую ему версию книги «DocBook: The Definitive Guide», документ «DocBook V5.0: The Transition Guide», рассматривающий вопросы перехода от 4.x к 5.0, и, естественно, спецификации. XSL-скрипты DocBook V5.0 поддерживают, так что уже сегодня можно начинать его изучать и тестировать.

В журнале Открытые системы вышла статья «DocBook: системный подход к документации». Чем выше корпоративная культура и больше масштаб компании, тем трепетнее в ней отношение к документации. Если компания рассматривает документацию как свой интеллектуальный капитал, то ее написание становится делом многих сотрудников, а в такой ситуации преимущества DocBook неоспоримы.