Pagination within a single article

  1. Background
  2. Page breaks & titles
  3. Navigation, conditionals, & search
  4. Full plugin help text

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.


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