home *** CD-ROM | disk | FTP | other *** search
/ PC World 2001 April / PCWorld_2001-04_cd.bin / Komunik / Amaya / WinNT2000 / amaya-WindowsNT-4.3.exe / _SETUP.1 / MakeBook.html < prev    next >
Encoding:
Extensible Markup Language  |  2001-02-22  |  4.6 KB  |  103 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.   <title>Making Book</title>
  7.   <meta name="GENERATOR" content="amaya V4.2.2" />
  8.   <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
  9. </head>
  10.  
  11. <body xml:lang="en" lang="en">
  12.  
  13. <table border="0" width="100%" summary="toc">
  14.   <tbody>
  15.     <tr>
  16.       <td><p><img border="0" alt="W3C" src="../../Icons/WWW/w3c_home" /> <img
  17.         border="0" alt="Amaya" src="../Icons/amaya.gif" /></p>
  18.       </td>
  19.       <td><p align="right"><a href="Numbering.html" accesskey="p"><img
  20.         alt="previous" border="0" src="../Icons/left.gif" /></a> <a
  21.         href="Manual.html" accesskey="t"><img alt="top" border="0"
  22.         src="../Icons/up.gif" /></a> <a href="Annotations.html"
  23.         accesskey="n"><img alt="next" border="0" src="../Icons/right.gif"
  24.         /></a></p>
  25.       </td>
  26.     </tr>
  27.   </tbody>
  28. </table>
  29.  
  30. <div id="Assembling">
  31. <h2><a name="L1065">Assembling large document collections</a></h2>
  32.  
  33. <p>Amaya allows you to handle document collections. Such a collection may, for
  34. instance, represent a technical documentation constituted by several web
  35. pages. One of these pages contains the title of the whole documentation (an
  36. <code>H1</code> element), an introduction (some other elements), and a list
  37. (<code>OL</code> or <code>UL</code>) whose items contain links to each
  38. chapter. Chapters are separate documents which can also have the same type of
  39. structure.</p>
  40.  
  41. <p>Such an organization is useful for browsing, but it has a number of
  42. drawbacks when the whole documentation has to be printed.
  43. <strong>Amaya</strong> addresses this problem with the "make book" function.
  44. You just have to use typed links for linking chapters: associate a
  45. <code>rel="chapter"</code> or <code>rel="subdocument</code>" attribute with
  46. the anchor that refers to a chapter (select the <code>A</code> element and use
  47. the <strong><a href="Attributes.html#L1073">Attributes</a></strong> menu).</p>
  48.  
  49. <p>Each referred chapter or sub-document can be:</p>
  50. <ul>
  51.   <li>either a whole external document,</li>
  52.   <li>or just a subset of a larger external document.</li>
  53. </ul>
  54.  
  55. <p>To refer to a document subset, the usual manner is to define a DIV element.
  56. which delimits the part of the target document you want to include and to link
  57. to this <a href="Links.html#target1">target element</a>.</p>
  58.  
  59. <p>Then, when activating the "make book" function, all blocks (<code>LI</code>
  60. elements in the above example) containing a typed link to a chapter will be
  61. replaced by the corresponding actual web pages (or web page subsets), and you
  62. will get a unique document containing the whole collection:</p>
  63. <ul>
  64.   <li><p>when the link refers to a web page, all the BODY content of the
  65.     target document is included.</p>
  66.   </li>
  67.   <li><p>if the link refers to a target element, this element with its content
  68.     is included.</p>
  69.   </li>
  70.   <li><p>if the link refers to a target anchor, the content of the anchor is
  71.     included, but not the anchor itself.</p>
  72.   </li>
  73. </ul>
  74.  
  75. <p>Before each replacement, the "make book" function generates a new DIV
  76. element with an ID attribute. So each added pieces are clearly separated.</p>
  77.  
  78. <p>Previous pieces of the new generated document could contain normal links,
  79. target anchors and target elements. During this operation, Amaya checks to
  80. ensure that each NAME and ID attribute values remain unique in the new
  81. document. If needed, Amaya changes these values and updates relative links. At
  82. the same time, external links are automatically updated when they referred an
  83. external document or document subset which is now included. For example, if
  84. the link point to a whole external document, this link will refer the DIV
  85. enclosing element after the operation. So the new unique document containing
  86. the whole collection is still coherent.</p>
  87.  
  88. <p>This large document can then be <a href="Numbering.html#L1064">numbered</a>
  89. and <a href="Printing.html#L1062">printed</a> with a complete table of
  90. contents and a list of all links.</p>
  91.  
  92. <p>To activate this tool, choose the <strong>Make Book</strong> item from the
  93. <strong>Special</strong> menu.</p>
  94. </div>
  95.  
  96. <p align="right"><a href="Numbering.html"><img alt="previous" border="0"
  97. src="../Icons/left.gif" /></a> <a href="Manual.html"><img alt="top" border="0"
  98. src="../Icons/up.gif" /></a> <a href="Annotations.html"><img alt="next"
  99. border="0" src="../Icons/right.gif" /></a></p>
  100. <hr />
  101. </body>
  102. </html>
  103.