Технология DocBook существует с 1991 г., проделав за это время значительную эволюцию: XML и XSL пришли на смену SGML и DSSSL, происходит постоянное развитие (а время от времени — и смена) инструментария.
За прошедшие годы на тему DocBook написано огромное количество справочников, учебников, статей и инструкций. Проблема однако заключается в том, что эта документация частью устарела, частью противоречит друг другу. Это следствие того, что развитие DocBook происходит по модели OpenSource, без централизованного контроля. В результате инструкции зачастую ссылаются на инструментарий, который уже не развивается и пользоваться которым нецелесообразно.
Еще одно затруднение, с которым сталкиваешься при первоначальном освоении DocBook — чрезвычайная обширность предмета. DocBook — это открытая и мощная технология, и ее можно приспособить для самых разных вещей. В результате при первоначальном знакомстве нелегко отличить магистральный путь использования DocBook от боковых дорог и живописных, но малохоженных троп.
И наконец, при всем богатстве документации по DocBook, текстов на русском языке мало, а особенно плохо обстоит дело с начальными инструкциями для широкого круга читателей. Есть и специфические проблемы, связанные именно с русским языком, в частности, с кириллицей в выходных документах, ориентированных на печать.
Перечисленные проблемы и послужили стимулом к написанию данной статьи.