]> source.dussan.org Git - xmlgraphics-fop.git/commitdiff
Move content from design/understanding/layout_managers.xml to design/layout.xml.
authorWilliam Victor Mote <vmote@apache.org>
Tue, 22 Apr 2003 03:01:53 +0000 (03:01 +0000)
committerWilliam Victor Mote <vmote@apache.org>
Tue, 22 Apr 2003 03:01:53 +0000 (03:01 +0000)
git-svn-id: https://svn.apache.org/repos/asf/xmlgraphics/fop/trunk@196306 13f79535-47bb-0310-9956-ffa450edef68

src/documentation/content/xdocs/design/book.xml
src/documentation/content/xdocs/design/layout.xml
src/documentation/content/xdocs/design/understanding/book.xml
src/documentation/content/xdocs/design/understanding/layout_managers.xml [deleted file]

index fceab025234e0546b0d7783f5b3bfc2597ebc4c2..d618365980ae9f0d951a9e1f26f6e34ba3cf9b6e 100644 (file)
@@ -27,7 +27,6 @@ understanding/book.xml, WHICH SEE FOR AN EXPLANATION.
       <menu-item label="XML Parsing" href="understanding/xml_parsing.html"/>
       <menu-item label="FO Tree" href="understanding/fo_tree.html"/>
       <menu-item label="Properties" href="understanding/properties.html"/>
-      <menu-item label="Layout Managers" href="understanding/layout_managers.html"/>
     </menu>
     <menu label="Extras">
       <menu-item label="Images" href="understanding/images.html"/>
index 94a657edc8878d3845da5834b20958105a19b9da..4575a17168253f7cd168e3efc84b855c92ccb3ab 100644 (file)
     </header>
 
     <body>
+<p>The role of the layout managers is to build the Area Tree by using the
+information from the FO Tree. The layout managers decide where information
+is placed in the area tree.</p>
+<p>A layout manager is typically associated with an FO Object but not always.</p>
+
+<p>The layout managers are in between the FO Tree and the Area Tree. They get
+information from the FO Tree and create areas and build the pages. They
+hold the state of the layout process as it builds up the areas and pages.
+They also manage the handling of breaks and spacing between areas.</p>
+<p>FO Objects can have two types of properties, ones that relate to the layout and ones that relate to the rendering. THe layout related properties area used by the layout managers to determine how and where to create the areas. The render related properties should be passed through to the renderer in the most efficient way possible.
+</p>
+
 <p>
 The aim of the layout system is to be self contained and allow for
 easy changes or extensions for future development. For example the
@@ -254,6 +266,11 @@ layoutmanger. These regions will handle the addition and removal
 of the separator regions when before floats/footnotes area added
 and removed.
   </p>
+<p>Footnotes and Before Floats are placed in special areas in the body region
+of the page. The size of these areas is determined by the content. This in
+turn effects the available size of the main reference area that contains
+the flow.</p>
+<p>A layout manager handles the adding and removing of footnotes/floats, this in turn effects the available space in the main reference area.</p>
   </section>
 <section>
   <title>Side Floats</title>
@@ -265,9 +282,12 @@ on the clear value of subsequent blocks. The keep status of the block is
 also effected as there must be enough space on the page to fit the
 side float.
   </p>
-  <p>
-<!--img src="float.svg" alt="Diagram of Float"/-->
-  </p>
+<p>Side floats alter the length of the inline progression dimension for the
+current line and following lines for the size of the float.</p>
+<p>This means that the float needs to be handled by the block layout manager
+so that it can adjust the available inline progression dimension for the
+relevant line areas.</p>
+<!--<p>img src="float.svg" alt="Diagram of Float"/>-->
   </section>
 <section>
   <title>Unresolved Areas</title>
@@ -366,6 +386,15 @@ when the value is resolved.
   </section>
 <section>
   <title>Block Areas</title>
+<p>When a block creating element is complete then it is possible to build the
+block area and add it to the paprent.</p>
+<p>A block area will contain either more block areas or line areas, which are
+special block areas. The line areas are created by the LineLayoutManager
+in which the inline areas flow into.</p>
+<p>So a block area manager handles the lines or blocks as its children and
+determines things like spacing and breaks.</p>
+<p>In the case of tables and lists the blocks are stacked in a specific way
+that needs to be handled by the layout manager.</p>
   <p>
 The block area has info about the following:
   </p>
index f2afa5d551bbdcd0de53d1e6b2ee02af71dd5607..dd9c2589d67ced1a73f89c02a1e3b270ba3ce352 100644 (file)
@@ -31,7 +31,6 @@ PARENT DIRECTORY!
       <menu-item label="XML Parsing" href="xml_parsing.html"/>
       <menu-item label="FO Tree" href="fo_tree.html"/>
       <menu-item label="Properties" href="properties.html"/>
-      <menu-item label="Layout Managers" href="layout_managers.html"/>
     </menu>
     <menu label="Extras">
       <menu-item label="Images" href="images.html"/>
diff --git a/src/documentation/content/xdocs/design/understanding/layout_managers.xml b/src/documentation/content/xdocs/design/understanding/layout_managers.xml
deleted file mode 100644 (file)
index 4fb8a58..0000000
+++ /dev/null
@@ -1,61 +0,0 @@
-<?xml version="1.0" standalone="no"?>
-<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.1//EN"
-    "http://cvs.apache.org/viewcvs.cgi/*checkout*/xml-forrest/src/resources/schema/dtd/document-v11.dtd">
-
-<document>
-    <header>
-        <title>Layout Managers</title>
-    </header>
-    <body>
-<p>The role of the layout managers is to build the Area Tree by using the
-information from the FO Tree. The layout managers decide where information
-is placed in the area tree.</p>
-<p>A layout manager is typically associated with an FO Object but not always.</p>
-
-<p>The layout managers are in between the FO Tree and the Area Tree. They get
-information from the FO Tree and create areas and build the pages. They
-hold the state of the layout process as it builds up the areas and pages.
-They also manage the handling of breaks and spacing between areas.</p>
-
-
-<p>FO Objects can have two types of properties, ones that relate to the layout and ones that relate to the rendering. THe layout related properties area used by the layout managers to determine how and where to create the areas. The render related properties should be passed through to the renderer in the most efficient way possible.
-</p>
-
-<section>
-  <title>Block Areas</title>
-
-<p>When a block creating element is complete then it is possible to build the
-block area and add it to the paprent.</p>
-<p>A block area will contain either more block areas or line areas, which are
-special block areas. The line areas are created by the LineLayoutManager
-in which the inline areas flow into.</p>
-<p>So a block area manager handles the lines or blocks as its children and
-determines things like spacing and breaks.</p>
-<p>In the case of tables and lists the blocks are stacked in a specific way
-that needs to be handled by the layout manager.</p>
-</section>
-
-<section>
-  <title>Side Floats</title>
-
-<p>Side floats alter the length of the inline progression dimension for the
-current line and following lines for the size of the float.</p>
-<p>This means that the float needs to be handled by the block layout manager
-so that it can adjust the available inline progression dimension for the
-relevant line areas.</p>
-</section>
-
-<section>
-  <title>Footnotes and Before Floats</title>
-
-<p>Footnotes and Before Floats are placed in special areas in the body region
-of the page. The size of these areas is determined by the content. This in
-turn effects the available size of the main reference area that contains
-the flow.</p>
-<p>A layout manager handles the adding and removing of footnotes/floats, this in turn effects the available space in the main reference area.</p>
-
-</section>
-
-    </body>
-</document>
-