Index Layout

W. Eliot Kimber

The trick for this type of structure is to use leader-length="auto" and text-align-last="justify" on the containing block. This causes the leader to take all the available space on the line between the text before it and the text after it, which is justified to the end edge of the block.

Saying leader-length="100%" means "make the leader as long as the width of my containing region, which is not what you want.

Bob Stayton and Ken Holman

You want to add end-indent="5mm" and last-line-end-indent="-5mm".

These two will cancel each other out if there is only one line. But if there are two lines, the top one is right indented by 5mm, and the page number on the second line reaches the right margin.

Ken adds, I usually also have an outdent on the first line as well as the last line so I do a start-indent to wrap lines other than the first line and a text-indent of an equivalent negative value for the first line to start at the edge of the page.

Ken answers this with:

Use a fixed-width inline-container at the end of the line and then inside of that an end-aligned page number. You'll have to ensure no vertical shifting of the page number by tightening up the line height.

An example below

<?xml version="1.0" encoding="iso-8859-1"?><!--carolyn.fo-->
<root xmlns="http://www.w3.org/1999/XSL/Format"
       font-family="Times" font-size="20pt">

   <layout-master-set>
     <simple-page-master master-name="frame"
                         page-height="297mm" page-width="210mm"
                         margin-top="15mm" margin-bottom="15mm"
                         margin-left="40mm" margin-right="40mm">
       <region-body region-name="frame-body"/>
     </simple-page-master>
   </layout-master-set>

   <page-sequence master-reference="frame">
     <flow flow-name="frame-body" xmlns="http://www.w3.org/1999/XSL/Format">
       <block start-indent="3cm" text-indent="-3cm"
              end-indent="3cm" last-line-end-indent="-3cm"
              text-align-last="justify">
         This is a test of a toc entry that is very long and does not
         use any alignment for the body of the entry
         <leader leader-pattern="dots"/>
         <inline-container line-height="1" width="1.5cm">
           <block text-align-last="end">1</block>
         </inline-container>
       </block>
       <block start-indent="3cm" text-indent="-3cm"
              end-indent="3cm" last-line-end-indent="-3cm"
              text-align-last="justify" text-align="justify">
         This is a second toc entry that is very long but also aligned
         in the body of the entry to get a smooth right edge
         <leader leader-pattern="dots"/>
         <inline-container line-height="1" width="1.5cm">
           <block text-align-last="end">111</block>
         </inline-container>
       </block>
     </flow>
   </page-sequence>
</root>

Nikolai Grigoriev

> 5. I have an index in this manual. I have managed to set it up to
> automatically gett all the appropriate entries and have also managed to
get
> the page references for each word and comma delimit them, but I cannot
seem
> to get rid of the duplicated page references. Is there any way of only
> returning unique page numbers using the fo:page-number-citation element or
> any way of removing the duplications? I have references of the form:
	

One of the toughest problems. No clean solution in XSL FO (unless I am missing something). I know a method to achieve this with our formatter, XEP;

but it relies upon formatter-specific tricks that permit to access the XML representation of the text already laid out.

J.Pietschmann

This appears to be really easy: put it into a variable and use string-length:

<xsl:variable name="page-list">
    <xsl:for-each
     select="document(concat($libname,
       '/index.xml'))//index/index-term[@id = $primary]">
       <xsl:value-of select="."/><xsl:if test="position() !=
      last()">,&nbsp;</xsl:if>
    </xsl:for-each>
</xsl:variable>


<fo:block margin-right="{concat(string-length($page-list)*1.5),'mm')}">
    <xsl:call-template name="process-nodes"/>
    <xsl:if test="not(@no-pg-num)">
        <fo:leader leader-pattern="dots" leader-pattern-width="2.0mm"
         leader-alignment="reference-area"/>
    </xsl:if>
    <xsl:value-of select="$page-list"/>
</fo:block>

If you have any markup in the page number list, like fo:basic-links, use xsl:copy-of instead of xsl:value-of.

Ken Holman

I recommend using outdents on both the first and last line, using indents for the wrap edge positions, thus ensuring your desired gaps in a single formatting object:

For example, the simplest would be:

<fo:block font-size="18pt" font-weight="normal"
          space-before="1em" start-indent="4.5em" text-indent="-4.5em"
          text-align-last="justify" end-indent="4.5em"
          last-line-end-indent="-4.5em">19NOV<fo:inline 
          padding-end="1em"/>PAYMENT,  THANK YOU. Add lots more
          content to 
               make it flow<fo:leader font-size="8pt"
        leader-pattern="use-content">.</fo:leader>600.00</fo:block>
      </fo:block>

Jacques DESEYNE

You could set letter-spacing="0" on the page-number-citation element:

<fo:block text-align="left" 
 text-align-last="justify">Section title
    <fo:leader leader-pattern="dots"/>
    <fo:page-number-citation
      ref-id="div47132" letter-spacing="0"/>
</fo:block>

Alternatively/additionally, you could insert a non-breaking space (0xa0) between leader and page-number-citation to force the leader to keep on the same line as the page number. The leader will be stretched rather than the generated page number. Of course, you will observe a little space between leader and page number. Inserting a zero-width joiner (0x200d) instead of the non-breaking space could solve this, but then the 'text-align-last="justify"' is not always honoured (with XEP 3.8). Setting an additional end-indent on the block save for the last line may improve the result (at least we think so: the last "word" of a title then often wraps as well), e.g. in the following:

<fo:block text-align-last="justify" 
          text-align="left"
          end-indent="12pt"
          last-line-end-indent="-12pt">Section title
 <fo:leader leader-pattern="dots"/>&#xa0;<fo:page-number-citation
ref-id="div47132" letter-spacing="0"/>
</fo:block>