Added support for processing the 'xref' elements #60
Conversation
There was a problem hiding this comment.
This <ulink> element looks genuinely useful, and I think it could make the job of maintaining documentation easier. And it's supported in DocBook 4, which the documentation is still written in. There seem to be some unintended changes in the commit, though - removing CDATA blocks and escaping the XML that had been inside this. I feel bad that your commit has been waiting so long, so we could accept as is - but Claudius, if it's not too hard, could you switch the CDATA blocks back? They make it much easier to maintain the sample code.
Update: I just realized I now have commit access, so I will make the CDATA changes.
Update: The code samples elsewhere in this document all used escaped XML, so Claudius's decision to remove CDATA actually made the document more consistent. I approve the PR.
|
@wolfgangmm Just awaiting your approval? |
4 participants
Description of 'xref' element: http://docbook.org/tdg5/en/html/xref.html.
This element makes easier to maintain the pages, compared to 'ulink' element, as the content of the generated HTML 'a' element is generated automatically from the text content of the 'title' child element of the referenced element (which can be, for instance, a 'section' element).