tailieunhanh - DocBox the Definitive Guide-Chapter 5. Customizing DocBook

Tham khảo tài liệu 'docbox the definitive guide-chapter 5. customizing docbook', công nghệ thông tin, kỹ thuật lập trình phục vụ nhu cầu học tập, nghiên cứu và làm việc hiệu quả | Chapter 5. Customizing DocBook For the applications you have in mind DocBook out of the box may not be exactly what you need. Perhaps you need additional inline elements or perhaps you want to remove elements that you never want your authors to use. By design DocBook makes this sort of customization easy. This chapter explains how to make your own customization layer. You might do this in order to Add new elements Remove elements Change the structure of existing elements Add new attributes Remove attributes Broaden the range of values allowed in an attribute Narrow the range of values in an attribute to a specific list or a fixed value You can use customization layers to extend DocBook or subset it. Creating a DTD that is a strict subset of DocBook means that all of your instances are still completely valid DocBook instances which may be important to your tools and stylesheets and to other people with whom you share documents. An extension adds new structures or changes the DTD in a way that is not compatible with DocBook. Extensions can be very useful but might have a great impact on your environment. Customization layers can be as small as restricting an attribute value or as large as adding an entirely different hierarchy on top of the inline elements. . Should You Do This Changing a DTD can have a wide-ranging impact on the tools and stylesheets that you use. It can have an impact on your authors and on your legacy documents. This is especially true if you make an extension. If you rely on your support staff to install and maintain your authoring and publishing tools check with them before you invest a lot of time modifying the DTD. There may be additional issues that are outside your immediate control. Proceed with caution. That said DocBook is designed to be easy to modify. This chapter assumes that you are comfortable with SGML XML DTD syntax but the examples presented should be a good springboard to learning the syntax if it s not already familiar to .