Creating marginalia using side floats

Alexander Peshkov Creating marginalia using side floats Creates marginalia (notes on margins synchronized with the main text) using fo:float elements together with margin property. 2003-07-04

Creating marginalia using side floats There is a wide used practice to place some notes on margins synchronized with the reference points in the main text, its known as "marginalia". To create marginalia in XSL FO you can use fo:float elements together with margin property. XSL FO Recommendation, Chapter 6.10.2 "fo:float" There are two page sequences below. First one (pages 2, 3) has a left-aligned marginalia created with 'start' floats. This page sequence utilize 'regular' page-master and it's flow has start-indent value big enought to accomodate float: <fo:flow flow-name="xsl-region-body" padding="6pt" start-indent="120pt"> All fo:float elements in this flow have zero indents and contain fo:block-container with fixed width of 100pt: <fo:float float="start" start-indent="0pt" clear="both"> <fo:block-container width="100pt"> <fo:block>Marginalia float</fo:block> </fo:block-container> </fo:float> As a result we will have a 100pt wide marginalia at the left side of the page. While such a 'one side' marginalia is very usefull indeed, it's a common requirement to place a marginalia on different sides of the page depending on its parity. Unfortunately this cannot be done by the means of strict XSL FO, but RenderX XEP allows you to create such an effect using special values of float property: inside and outside. Former will align floating block to the inner edge of the page (left for odd pages, right for even pages) and latter will align floating block to the outer edge of the page (right for odd pages, left for even pages). Second page sequence below (pages 4, 5) demonstrates creation of "duplex" marginalia aligned to the outer edge of the page, it's created using outside value of float property. This page sequence utilize a special pagemasters with negative margin on the start (left) side for odd pages and negative margin on the end (right) side: <fo:simple-page-master master-name="page-odd" margin="0.2in"> <fo:region-body margin="20pt 20pt 20pt -100pt"/> </fo:simple-page-master> <fo:simple-page-master master-name="page-even" margin="0.2in"> <fo:region-body margin="20pt -100pt 20pt 20pt"/> </fo:simple-page-master> <fo:page-sequence-master master-name="marginalia-duplex"> <fo:repeatable-page-master-alternatives> <fo:conditional-page-master-reference master-reference="page-odd" odd-or-even="odd"/> <fo:conditional-page-master-reference master-reference="page-even" odd-or-even="even"/> </fo:repeatable-page-master-alternatives> </fo:page-sequence-master> and it's flow has an appropriate start-indent and end-indent values: <fo:flow flow-name="xsl-region-body" padding="6pt" start-indent="120pt" end-indent="120pt"> Floats used in this flow look like this: <fo:float float="outside" start-indent="0pt" end-indent="0pt" clear="both"> <fo:block-container width="100pt"> <fo:block>Duplex marginalia float</fo:block> </fo:block-container> </fo:float>

Simplex marginalia Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet.

This is side float with float="start" Duis autem vel eum iriure dolor in hendrerit in vulputate velit esse molestie consequat, vel illum dolore eu feugiat nulla facilisis at vero eros et accumsan et iusto odio dignissim qui blandit praesent luptatum zzril delenit augue duis dolore te feugait nulla facilisi. Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat volutpat.

This is side float with float="start" Ut wisi enim ad minim veniam, quis nostrud exerci tation ullamcorper suscipit lobortis nisl ut aliquip ex ea commodo consequat. Duis autem vel eum iriure dolor in hendrerit in vulputate velit esse molestie consequat, vel illum dolore eu feugiat nulla facilisis at vero eros et accumsan et iusto odio dignissim qui blandit praesent luptatum zzril delenit augue duis dolore te feugait nulla facilisi. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet.

Duplex marginalia Nam liber tempor cum soluta nobis eleifend option congue nihil imperdiet doming id quod mazim placerat facer possim assum. Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat volutpat. Ut wisi enim ad minim veniam, quis nostrud exerci tation ullamcorper suscipit lobortis nisl ut aliquip ex ea commodo consequat.

This is side float with float="outside" Duis autem vel eum iriure dolor in hendrerit in vulputate velit esse molestie consequat, vel illum dolore eu feugiat nulla facilisis.

This is side float with float="outside" At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, At accusam aliquyam diam diam dolore dolores duo eirmod eos erat, et nonumy sed tempor et et invidunt justo labore Stet clita ea et gubergren, kasd magna no rebum. sanctus sea sed takimata ut vero voluptua. est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat.

This is side float with float="outside" Consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Nam liber tempor cum soluta nobis eleifend option congue nihil imperdiet doming id quod mazim placerat facer possim assum. Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat volutpat. Ut wisi enim ad minim veniam, quis nostrud exerci tation ullamcorper suscipit lobortis nisl ut aliquip ex ea commodo consequat.

This is side float with float="outside" Duis autem vel eum iriure dolor in hendrerit in vulputate velit esse molestie consequat, vel illum dolore eu feugiat nulla facilisis.