О да, сколько настроек XSLT шаблонов для генерации из DocBook чего-либо вменяемого я перепробовал, но в конце концов капитулировал и отправил полученный XHTML на валидацию. Валидация не прошла - "то-то же", - думаю, "еще бы прошла, когда там такая хрень". В числе хреней были шедевры типа

<a href="re01.html"><span><a id="API-module-init"></a>Текст который должен быть ссылкой но ниразу ей не стал</span></a>
......
<a href="re01.html" id="API-module-init">Next</a>=

Мало того, что вложенные ссылки запрещены стандартом, так они еще и два элемента с одинаковым id на одной странице сгенерировали!
( fix-ящий diff )