[ http://jira.codehaus.org/browse/DOXIA-24?page=comments#action_58140 ]
Jose Gonzalez Gomez commented on DOXIA-24: ------------------------------------------ There was some talk a while ago about this issue in the lists. As far as I remember, the conclusion was that a separate docbook plugin would be desirable, and support for Docbook in Doxia should be kept to a minimum. http://www.nabble.com/-M2-Docbook-support-t428441.html Anyway feel free to do whatever you want with my code. > [PATCH] better docbook support through the use of docbook xsl stylesheets > ------------------------------------------------------------------------- > > Key: DOXIA-24 > URL: http://jira.codehaus.org/browse/DOXIA-24 > Project: doxia > Type: Improvement > Reporter: Lars Trieloff > Attachments: docbook-xsl-support.patch > > > The current state of DocBook support in Doxia is still unsatisfactory. It is > now able to handle the most important elements, but there is still an > important problem left out: handling of xref-links. This type of links points > to another docbook element and is expected to be replaced with a text > describing the element by the processing system. For example an xref pointing > to a chapter would be replaced with the text "Chapter N: 'Title of Chapter > N'". Implementing this functionality using the XML Pull Parser currently used > in Doxia is a massive effort because it leads to duplicating a lot of > functionality already available in the DocBook XSL Stylesheets, the standard > solution for processing DocBook XML and involves caching of more or less the > whole DocBook document. > My proposed solution is simple, elegant, but quite heavyweight: I use the > DocBook XSL Stylesheets (which will be bundled with the doxia.jar) and > transform the DocBook input document into a temporary XHTML document. The > stylesheets are driven by a customization layer that turns off any > unnecessary features like autogenerated tables of contents and navigation > graphics. > The temporary XHTML document is processed by the Doxia's XhtmlParser into a > DoxiaModel. The DocBook XSL stylesheets and the XhtmlParser take care of > maintaining the section nesting of the document, so that no important > information will be lost. > If the DocBook DTD changes, no Java programming is neccessary, all you need > to do is updating the enclosed DocBook XSL stylesheets. The system is able to > handle all of the DocBook elements and offers all advanced features of the > DocBook XSL stylesheets like autogenerated texts and so on. > There is only one major drawback: Parsing the DocBook stylesheets takes an > huge amount of memory, but it is still possible to run maven with the default > java heap space. -- This message is automatically generated by JIRA. - If you think it was sent incorrectly contact one of the administrators: http://jira.codehaus.org/secure/Administrators.jspa - For more information on JIRA, see: http://www.atlassian.com/software/jira
