home *** CD-ROM | disk | FTP | other *** search
/ GameStar 2005 May / Gamestar_73_2005-05_dvd.iso / Programy / amaya / amaya-WinXP-9.1.exe / doc / WX / MakeBook.html < prev    next >
Encoding:
Extensible Markup Language  |  2005-02-23  |  4.1 KB  |  95 lines
  1. <?xml version="1.0" encoding="iso-8859-1"?>
  2. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
  3.        "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
  4. <html xmlns="http://www.w3.org/1999/xhtml">
  5. <head>
  6.   <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
  7.   <title>Using the MakeBook Function</title>
  8.   <style type="text/css">
  9.   </style>
  10.   <link href="style.css" rel="stylesheet" type="text/css" />
  11. </head>
  12.  
  13. <body xml:lang="en" lang="en">
  14.  
  15. <div>
  16. <img alt="Amaya" src="../../resources/icons/22x22/logo.png" class="logo" />
  17.  
  18. <p class="nav"><a href="Numbering.html" accesskey="p"><img alt="previous"
  19. src="../../resources/icons/misc/left.png" /></a> <a href="Manual.html"
  20. accesskey="t"><img alt="top" src="../../resources/icons/misc/up.png" /></a>
  21. <a href="Annotations.html" accesskey="n"><img alt="next"
  22. src="../../resources/icons/misc/right.png" /></a></p>
  23. </div>
  24.  
  25. <div id="page_body">
  26. <h1>Using the Make Book Function</h1>
  27.  
  28. <p>The MakeBook function is used to assemble large document collections into
  29. a single volume.</p>
  30.  
  31. <p>Amaya enables you to handle document collections. Such a collection may,
  32. for example, represent a set of technical documentation made up of several
  33. web pages. One of the web pages contains the title of the entire
  34. documentation set (an <code><h1></code> element), an introduction (some
  35. other elements), and a list <code><ol></code> or
  36. <code><ul></code> whose items <code><li></code> contain links to
  37. each chapter. Chapters are separate documents that can have a similar
  38. structure.</p>
  39.  
  40. <p>This organization is useful for browsing, but has several drawbacks when
  41. the entire documentation set must be printed. Amaya addresses this problem
  42. with the Make book function (<strong>XHTML>Make book</strong>).</p>
  43.  
  44. <p>You use typed links for linking chapters, by associating an attribute
  45. <code>rel="chapter"</code> or <code>rel="subdocument"</code> with the anchor
  46. that refers to a chapter (to do this, select the <code>a</code> element and
  47. use the <strong>Attributes</strong> panel).</p>
  48.  
  49. <p>Each referred chapter or sub-document can be:</p>
  50. <ul>
  51.   <li>an external document</li>
  52.   <li>a subset of a larger external document</li>
  53. </ul>
  54.  
  55. <p>To refer to a document subset, you usually define a <code>div</code>
  56. element to identify the part of the target document you want to include, and
  57. to link to this target element.</p>
  58.  
  59. <p>Then, when you activate the Make book function, all blocks
  60. (<code><li></code> elements in the above example) containing a typed
  61. link to a chapter will be replaced by the corresponding actual web pages (or
  62. web page subsets), and Amaya will display a unique document containing the
  63. whole collection:</p>
  64. <ul>
  65.   <li>If the link refers to a web page, Amaya includes all the
  66.     <code>body</code> content of the target document.</li>
  67.   <li>If the link refers to a target element, Amaya includes this element
  68.     with its content.</li>
  69.   <li>If the link refers to a target anchor, Amaya includes the content of
  70.     the anchor, but not the anchor itself.</li>
  71. </ul>
  72.  
  73. <p>Before each replacement, the Make book function generates a new
  74. <code>div</code> element with an <code>id</code> attribute to clearly
  75. separate each added piece.</p>
  76.  
  77. <p>Pieces of the new generated document can contain normal links, target
  78. anchors, and target elements. During the Make book operation, Amaya ensures
  79. that each <code>name</code>and <code>id</code> attribute value remains unique
  80. in the new document. As needed, Amaya changes these values and updates any
  81. relative links.</p>
  82.  
  83. <p>At the same time, Amaya automatically updates external links from
  84. referring to an external document or document subset, to referring to the
  85. text that is now included. For example, if the link originally pointed to an
  86. external document, the link will now refer to the <code>div</code>-enclosed
  87. element after the Make book operation. This ensures that the new unique
  88. document containing the whole collection remains coherent.</p>
  89.  
  90. <p>This large document can then be numbered and printed with a complete table
  91. of contents and a list of all links.</p>
  92. </div>
  93. </body>
  94. </html>
  95.