5.18. Appendix

LyX offers the possibility to mark a part of the document as being the Appendix: from the top menu, choose Layout -> Start Appendix here. Unfortunately, this will not work when the document is exported to SGML. We are thus left alone and have to implement a workaround. I have implemented the following solution:

• The writer provides an extra LyX file, with the fixed name “appendix.lyx”, in the same directory as the main document.

• The appendix. lyx file must be of type “ DocBook article (SGML)”, to be chosen from the LyX menu: Layout -> Document. A document type of “ DocBook book (SGML)” will NOT work, even if the main document is of book type! This is because if you set the document type to book, you will have to start with Chapters (instead of Sections) and then you will get parsing errors from openjade saying that CHAPTER is not allowed by the DTD at that place.

• The appendix is marked as such, using LyX' menu: Layout -> Start Appendix here, with the cursor at the very start of the Appendix.

That's all! The lyxtox script will check if a file called appendix. lyx is there and will take the aproppriate steps to incorporate it into the document (see Section 7.1.9).

How to insert cross-references to the Appendix

To insert a cross-reference to the Appendix (more precisely to a section, subsection, subsubsection, table, figure or equation in the Appendix), you use the same mechanism in LyX, as you would do for cross-references to labels that exist in a separate file: from the Insert menu, choose "Label", then, from the drop-down list for "Buffer", choose the appendix.lyx file (which you should have already opened in LyX). LyX will then present you with all available labels from the appendix.lyx file to choose for your cross-reference.