Creating multi-paged articles

One nifty feature in tutorials that sets it apart from simply listing your tutorials as forum topics is the ability to create multi-paged articles. There are 2 bbcodes in tutorials 1.2 that assist with this, the pagebreak bbcode and the pagetitle bbcode. In order to create a multi-paged article, you always have to use the pagebreak bbcode; the pagetitle bbcode is optional, but it grants you a greater level of customization.

To create an article with multiple pages, all you need to do is type the article as per normal, but then whenever you want to break to another page, you merely type the following in where you want this break to occur:

You then just repeat that at each point in which you want a new page break to occur.

When a tutorial has multiple pages, there are 2 effects. The first is the Table of Contents which shows up on the right side:



This links you to each page of the article. This will always show up on multi-paged articles, but the second effect that could occur is optional. It is a page jump feature that shows up in the lower left corner of each article:



You can disable this from appearing in your articles by toggling the application setting "Show page jump?" to No. That way, the only way to navigate between pages will be the Table of Contents.

The Table of Contents is cool and all, but it's pretty boring if it just lists the Page numbers. That's where the pagetitle bbcode comes into play. You can use this bbcode to give each page of your article a distinct title. It is used like this:

[pagetitle="This is my super duper page title"]

You can use this code once per page, additional uses will be ignored. It is optional, so you don't need to use it, but it is recommended to help give your users a better sense of what's on each page. When it is used, that page title automatically shows up as an <h2> tag at that point on the page, and it gets used in the Table of Contents:



Ideally, I would like to set it up so that when creating articles you get buttons that show up on the editor to let you use these bbcodes, but IP.Board currently offers no way to allow you to add buttons to the editor without showing those buttons on every editor in IP.Board, and these bbcodes will only work in the tutorials application.