aboutsummaryrefslogtreecommitdiffstats
path: root/docs/xml-docs/fop/limitations.xml
blob: e56c1a5e4732501efd3ecbeedfa9b1e8168422d9 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
<?xml version="1.0"?>



<!-- Limitations --> 

<s1 title="Limitations">
  <p>FOP implements the fo objects and properties listed 
     in <jump href="implemented.html">features</jump>, sometimes it does so only in a limited way. 
  </p>

  <s2 title="fo:leader">
    <p>Only the property leader-length.optimum is used, so for all purposes you can use 
       "leader-length" instead. leader-length.minimum/maximum should be honored 
       for line-justification, but this does not happen.
    </p>
  </s2>

  <s2 title="page-number-citation">
    <p>Only works for table of contents without any problems. The case where the page number doesn't 
    fit on a line isn't handled, and any text on the same line and after the page-number might not 
    appear exactly where you want it to.
    </p>
  </s2>

  <s2 title="list-block">
    <p>The fo working draft allows describes two ways to markup lists.The list-block must have as 
       children either: 1) pairs of fo:list-item-label and fo:list-item-body formatting objects, or
       2) fo:list-item formatting objects.</p>
    <p>At the moment FOP only implements the second way. Therefore a list has a basic structure like this:</p>
    <p><code>&lt;fo:list-block></code></p>
    <p><code>&lt;fo:list-item></code></p>
    <p><code>&lt;fo:list-item-label>&lt;fo:block>&lt;/fo:block>&lt;/fo:list-item-label></code></p>
    <p><code>&lt;fo:list-item-body>&lt;fo:block>&lt;/fo:block>&lt;/fo:list-item-body></code></p>
    <p><code>&lt;/fo:list-item></code></p>
    <p><code>&lt;/fo:list-block></code></p>
  </s2>
  <s2 title="Padding">
    <p>Padding works in conjunction with indents and spaces. It is only implemented 
       for blocks. At the moment padding can't be used to make extra space (indents+spaces
       must be used), but only to control how much the background-color extends beyond
       the content rectangle.
    </p>  
  </s2>
  <s2 title="Tables">
    <p>There two limitations for tables: 1) FOP needs you to explicitly specify column widths 
       2) Cells have to contain block-level FOs. They can't contain straight character data.
    </p>
    <p>A working basic example of a table looks like this: </p>  
    <p><code>&lt;fo:table></code></p>
    <p><code>&#160;&lt;fo:table-column column-width="150pt"/></code></p>
    <p><code>&#160;&lt;fo:table-column column-width="150pt"/></code></p>
    <p><code>&#160;&lt;fo:table-body font-size="10pt" font-family="sans-serif"></code></p>
    <p><code>&#160;&#160;&lt;fo:table-row></code></p>
    <p><code>&#160;&#160;&#160;&lt;fo:table-cell></code></p>
    <p><code>&#160;&#160;&#160;&#160;&lt;fo:block>text&lt;/fo:block></code></p>
    <p><code>&#160;&#160;&#160;&lt;/fo:table-cell></code></p>
    <p><code>&#160;&#160;&#160;&lt;fo:table-cell></code></p>
    <p><code>&#160;&#160;&#160;&#160;&lt;fo:block>text&lt;/fo:block></code></p>
    <p><code>&#160;&#160;&#160;&lt;/fo:table-cell></code></p>
    <p><code>&#160;&#160;&lt;/fo:table-row></code></p>
    <p><code>&#160;&#160;&lt;fo:table-row></code></p>
    <p><code>&#160;&#160;&#160;&lt;fo:table-cell></code></p>
    <p><code>&#160;&#160;&#160;&#160;&lt;fo:block>text&lt;/fo:block></code></p>
    <p><code>&#160;&#160;&#160;&lt;/fo:table-cell></code></p>
    <p><code>&#160;&#160;&#160;&lt;fo:table-cell></code></p>
    <p><code>&#160;&#160;&#160;&#160;&lt;fo:block>text&lt;/fo:block></code></p>
    <p><code>&#160;&#160;&#160;&lt;/fo:table-cell></code></p>
    <p><code>&#160;&#160;&lt;/fo:table-row></code></p>
    <p><code>&#160;&#160;&lt;fo:table-row></code></p>
    <p><code>&#160;&#160;&#160;&lt;fo:table-cell></code></p>
    <p><code>&#160;&#160;&#160;&#160;&lt;fo:block>text&lt;/fo:block></code></p>
    <p><code>&#160;&#160;&#160;&lt;/fo:table-cell></code></p>
    <p><code>&#160;&#160;&#160;&lt;fo:table-cell></code></p>
    <p><code>&#160;&#160;&#160;&#160;&lt;fo:block>text&lt;/fo:block></code></p>
    <p><code>&#160;&#160;&#160;&lt;/fo:table-cell></code></p>
    <p><code>&#160;&#160;&lt;/fo:table-row></code></p>
    <p><code>&#160;&lt;/fo:table-body></code></p>
    <p><code>&lt;/fo:table></code></p>
  </s2>

  
  <!--<s2 title="display-graphic">
    <p>Which formats are supported? Compression etc. </p>  
  </s2>-->

</s1>