Template:Parallel pages sections/doc

Usage
Renders a sequence of pages side-by-side on a section-by-section basis. Useful for long texts presented side-by-side on single pages that otherwise will be challenging to line up.

Internally, this template just produces a sequence of invocations of translation table/2. The text is transcluded in "blocks", each defined by sections on the pages. The meaning of a block varies from work to work since it depends on the style of translation, but it's often a verse or paragraph.

To use this template, each page must have sections set on each page in the form, where   is number starting at 1 on each page, and   matches the prefixes set in the parameters. The sections do not necessarily need to be in order on the page, but must be sequentially numbered.


 * the name of the index file
 * the section prefix for the left side
 * the section prefix for the right side
 * the page offset for the right side, relative to the left side. For works where the text is on the same page, this is  (or omitted) and for works with facing pages (e.g. the Loeb Classical Library), this is.
 * ,, ...: the page number (in the file) and number of sections in the following format:
 * : transclude:
 * sections ending 1,2,3,4,5 from page 66
 * : transclude:
 * sections ending 4,5 from page 66
 * : transclude:
 * sections ending 1,2,3,4,5 from page 66, each in one block, then,
 * the sections ending  from page 66 and 67 as a single block
 * : transclude:
 * sections ending 1,2,3,4,5 from page 66, each in one block,
 * as well as the sections ending  from each of page 66, 67 and 68 as a single block
 * : transclude:
 * only the sections sections ending  from page 66, 67 as a single block

Continuation
To continue a block across a page (e.g. if a page break occurs in the middle of a paragraph and your text is aligned on a paragraph basis), use a syntax like. This will include all the numbered section from 1 to 5 from page 66 as separate "pairs". Finally, it will string together the sections that end  from pages 66 and 67 and place them as a single pair.

Due to how the ProofreadPage extension works, all the "continuation" sections in a single block must have the same name. E.g. in the following case, both pages 100 and 101 need sections that end in :

100/1;101/cont

When a section continues onto the page from the previous page and a section continues onto the next page, the sections comprising the two blocks have to have different names. In the following example, pages 100 and 101 need sections that end in  (i.e. the last section on 100 and the first section on 101) and pages 101 and 102 have sections that end in   (i.e. the last section on 101 and the first section on 102). This is because page 101 can't use  for both the first and last section: 100/1;101/cont 101/1;102/cont-b


 * tl;dr
 * All sections that you want to be in the same section on transclusion need the same name
 * You can't reuse a section name on the same page for two different sections

Hyphenation
If a word is split across pages, use hws and hwe, in the same way as within continued  footnotes.