Alright Jeremias I have created a page for the AT XML Documentation on the FOP wiki:
http://wiki.apache.org/xmlgraphics-fop/AreaTreeXMLDocumentation I have taken the liberty of adding a link to it on the main page to encourage awareness.. Thanks for your help. Tom Jeremias Maerki-2 wrote: > > Tom, that's great, but why don't you just use our main Wiki? > http://wiki.apache.org/xmlgraphics-fop/ > > Another request: Please call this area tree XML rather than intermediate > format. Yes, we called it that in the past but we have two intermediate > formats now, so it's necessary to keep the two apart. > > On 25.08.2009 17:43:16 TomWilcox wrote: >> >> Hi Jeremias and Georg, >> >> Thanks very much. That's really helpful and at least good to know that no >> proper documentation exists. >> >> I have taken the liberty of starting a wiki to share this information >> whilst >> I attempt to accumulate more info about the IF tree. If anyone would like >> to >> contribute please do. It would be great to produce something of use to >> anyone else with similar needs. >> >> I have added the information that you have both provided me to the wiki >> page >> (and cited you both as contributors) please let me know if this is not OK >> and feel free to edit. >> >> http://fop-if-tree.wikispaces.com/ >> >> Thanks, >> Tom >> >> >> >> Jeremias Maerki-2 wrote: >> > >> > There's no formal documentation of the area tree XML format to date. It >> > is something very very few people need to use and the whole thing grew >> > organically over time, so documentation wasn't a top priority. A >> > contribution in this direction would be highly welcome. I'm happy to >> > fill in any blanks if such a documentation is started. I don't have >> time >> > to write the whole thing myself in the short term. >> > >> > bpd = block-progression-dimension of the content rectangle of the area >> > (= height for lr-tb script) >> > bpda = allocated bpd = content bpd + spaces + borders + padding >> > >> > ipd = inline-progression-dimension of the content rectangle of the area >> > (= width for lr-tb script) >> > ipda = allocated ipd = content ipd + spaces + borders + padding >> > >> > Units are millipoints (1000ths of a point) as used in most of FOP (most >> > notably the layout engine). >> > >> > Please note that our area tree is relatively close to the conceptual >> > area tree (with its traits) described in the XSL specification. If you >> > know a bit of the specification, the area tree XML is much easier to >> > read. >> > >> > If you look into our layout engine test suite >> > (test/layoutengine/standard-testcases), you'll find a lot of examples >> of >> > what is expected in the area tree for various situations. >> > >> > HTH >> > >> > On 25.08.2009 16:26:29 TomWilcox wrote: >> >> >> >> Hi Guys, >> >> >> >> Sorry to return your attention to this aging thread! >> >> >> >> I am knee deep in IF and I have a been attempting to divine what each >> of >> >> the >> >> different node attributes represent such as bpd (block progression >> >> dimension?), etc. >> >> >> >> It would be really good to have a definitive description of the >> meaning >> >> and >> >> function of each of the attribute (and nodes) in an IF document. I >> have >> >> been >> >> searching diligently however I have failed to find any document that >> >> completely satisfies this requirement. >> >> >> >> Would be possible for you provide me with a link to a thorough >> >> documentation >> >> of the IF format or, if not, perhaps you might be able to provide an >> >> explanation of the attributes important for reading the dimension of a >> >> given >> >> block from an IF document (I think position is bpd, ipd, .. but ipda? >> and >> >> bpda?) and what are the units (millipoints?). >> >> >> >> I am very grateful for any assistance. >> >> >> >> Thanks in advance, >> >> Tom >> >> -- >> >> View this message in context: >> >> http://www.nabble.com/Area-Tree-Handling-tp24431098p25135373.html >> >> Sent from the FOP - Users mailing list archive at Nabble.com. >> > >> > >> > Jeremias Maerki >> > >> > >> > --------------------------------------------------------------------- >> > To unsubscribe, e-mail: fop-users-unsubscr...@xmlgraphics.apache.org >> > For additional commands, e-mail: fop-users-h...@xmlgraphics.apache.org >> > >> > >> > >> >> -- >> View this message in context: >> http://www.nabble.com/Area-Tree-Handling-tp24431098p25136891.html >> Sent from the FOP - Users mailing list archive at Nabble.com. >> > > > > Jeremias Maerki > > > --------------------------------------------------------------------- > To unsubscribe, e-mail: fop-users-unsubscr...@xmlgraphics.apache.org > For additional commands, e-mail: fop-users-h...@xmlgraphics.apache.org > > > -- View this message in context: http://www.nabble.com/Area-Tree-Handling-tp24431098p25137549.html Sent from the FOP - Users mailing list archive at Nabble.com. --------------------------------------------------------------------- To unsubscribe, e-mail: fop-users-unsubscr...@xmlgraphics.apache.org For additional commands, e-mail: fop-users-h...@xmlgraphics.apache.org