soo_page_break
Summary:
Pagination within a single article
Page breaks & titles
Again, soo_page_break works from within the standard Txp Write panel. The default delimiter for page breaks is [break]. For example:
"No," said Mr. Prendergast.
[break]
h2. Chapter Eight
If you prefer a different delimiter you’ll have to set the delimiter
attribute of the first soo_article_page
tag you use in your article form.
For Textile-enabled articles be sure to surround the break delimiter with blank lines. Otherwise the break may occur in the middle of an HTML element, producing invalid HTML output. (The tag removes any p
tags around the delimiter, so you don’t need to worry about whether or not the delimiter itself gets the Textile treatment, unless you use HTML special characters as part of the delimiter. Which would be a very silly thing to do.)
Page titles
soo_article_page
simply looks for the first HTML heading element (i.e., h1
, h2
, etc.) in the page, and makes that the title. This title can then be accessed directly with soo_article_page_title
, and indirectly with soo_article_page_link
and soo_article_page_nav
, by using {title}
within certain attribute values. In the example Textile-enabled article above, “Chapter Eight” will be the title for the page following the break.
Posted 2017-03-09 (last modified 2017-03-10)
Page 3 of 6