http://docbook.ru/ ru Copyright © 2005-2007 www.docbook.ru 180 http://lists.oasis-open.org/archives/docbook-tc/200911/msg00001.html 2009-11-05 DocBook DocBook V5.0 стал официальным стандартом OASIS. http://norman.walsh.name/2007/11/07/docbook50 2007-11-29 DocBook Технический комитет на своем заседании 7 ноября 2007 принял решение о том, что DocBook v.5.0 достиг стадии Committee Draft. Фаза под названием Candidate Review пройдена, и хотя предстоит еще формальное получение статуса Committee Specification, техническая работа завершена. А значит, разработчки и пользователи могут смело переходить на версию 5.0, не опасаясь изменений спецификации. http://norman.walsh.name/2006/11/28/dbwiki 2006-11-28 DocBook У wiki.docbook.org появилась возможность экспорта контента в формат... DocBook. Те, кто пытались внедрить DocBook в качестве стандарта для исходных текстов документации в своей компании, знают как сложно заставить сотрудников пользоваться чем-либо помимо Word. XML-редакторы не спасают: у нормального сотрудника (не технаря) любые тэги вызывают ужас. Возможное решение: внедрите у себя Wiki — штуку не только полезную по очень многим соображениям, но и предельно простую с точки зрения ввода текстов. Вынимайте из нее накопленный контент в формате DocBook и используйте его в качестве «исходного сырья» для документации. http://norman.walsh.name/2006/10/04/docbook45 2006-10-04 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. http://norman.walsh.name/2006/07/28/docbookOrgRedesign 2006-08-01 DocBook Известный недостаток DocBook Website — полностью статическая навигация. Меню подверстывается к каждой веб-странице; как результат, добавление к сайту одной страницы приводит к перестроению всех остальных. По мере разрастания сайта это становится проблемой. На этой технологии был сделан, в частности, сайт docbook.org. Поддерживающий его Норман Уолш сказал «хватит» и изменил как дизайн, так и технологию сайта. Теперь меню формируется отдельно от контента и пристыковывается к нему при помощи server-side include, а исходники контента форматируются как DocBook V.5 <article> вместо <webpage>. На наш взгляд, постановка задачи правильная — меню надо отделить от контента. Но вместо SSI для этого можно было бы воспользоваться Javascript. Зависимость от клиента? да, но зато независимость от настроек сервера и снижение трафика. Так что docbook.ru пока останется памятником, копирующим «классический» дизайн docbook.org. http://norman.walsh.name/2006/03/24/dita2006 2006-05-22 DocBook Сравнение DocBook и DITA. Вероятно небеспристрастное, поскольку автор, Норман Уолш, не может не симпатизировать первому. Самое существенное, по версии автора, отличие — DocBook в большей степени ориентирован на последовательное «книжное» изложение, DITA — на стиль разрозненных комментариев («topic-oriented authoring paradigm»). Для тех, кто интересуется проектными решениями и архитектурой систем документирования. http://norman.walsh.name/2005/10/28/docbook50b1 2005-11-01 DocBook Технический комитет 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 поддерживают, так что уже сегодня можно начинать его изучать и тестировать. http://docbook.ru/doc/ 2005-04-28 DocBook В журнале Открытые системы вышла статья «DocBook: системный подход к документации». Чем выше корпоративная культура и больше масштаб компании, тем трепетнее в ней отношение к документации. Если компания рассматривает документацию как свой интеллектуальный капитал, то ее написание становится делом многих сотрудников, а в такой ситуации преимущества DocBook неоспоримы.