Принципы разбивки статьи на страницы и продолжения

1. Страницы

Статья состоит:

• обложки (необязательно);

• отображаемых страниц (необязательно);

• теневых страниц (необязательно).

Под обложкой понимается текст в статье, который предшествует первой странице формируемой тегом [newpage].

В общем случае статья состоит из обложки и страниц. Обращение к обложке идет по номеру статьи id (или al - алиасу):

http://www.my_site/page.php?id=3

Обращение к странице производится с указанием ее номера страницы (pg):

http://www.my_site/page.php?al=title&pg=2

Страница с номером 0 (pg=0) эквивалента обложки или статье без тегов разбивки на страницы. В том случае, если при обращении в ссылке не задан параметр pg , считается, что воспроизводится вначале обложка, а в случае отсутствии обложки первая не теневая страница.

В пределах статьи страницы имеют оглавление (сводка, содержание). Оглавление может быть нумерованным (или иметь иконки). Текущая страница (отображаемая на экране) имеет свою отдельную иконку. Внешний вид оглавления формируется соответствующим плагином. Модуль формирует список наименований страниц. В оглавлении отображаются только наименования отображаемых (не теневых) страниц. Однако, если существует обложка, то она считается как страница с номером 0.

Оглавление состоящее из одной страницы не формируется.

Сами страницы могут быть как отображаемые в оглавлении, так и быть «теневыми» — не отображаемые в оглавлении.

Страницы не могут быть вложены одна в другую (хотя, теоретически такая задача может быть поставлены и быть решенной). Страницы в статье располагаются последовательно, одна за другой.

Для образования страниц служит конструкция тегов:

[newpage]

[title]Наименование страницы[/title]

Следовательно, если теперь рассмотреть всю статью с тегами она будет выглядеть в исходном, в не интерпретированном виде так:

Текст обложки

[newpage]

[title]Наименование страницы №1[/title]

текст страницы №1

[newpage]

[title]Наименование страницы №2[/title]

текст страницы №2

….....................................

[newpage]

[title]Наименование страницы №N[/title]

текст страницы №N

Страницы могут быть как именованными (с отображением наименования в оглавлении) так и не наименованными, т.е. такими, у которых отсутствует значение в обрамляющих тегах

[title][/title], так и вовсе с их отсутствием.

Наименование страницы или наименование абзаца-продолжения не может иметь вложенных одноименных тегов — они просто не обрабатываются (хотя теоретически это возможно).

Для обложки наименование берется из константы $L['Home']. Наименование обложки может быть изменено (или отменено) размещением в начале обложки конструкции:

[title]Наименование обложки[/title]

Количество страниц в статье не может превышать 99.

2. Абзацы-продолжение

Страница в своих пределах может иметь абзацы-продолжение. Для образования абзацев-продолжение служит конструкция тегов:

[more]

[title]Наименование продолжения[/title]

В пределах страницы может быть несколько абзацев -продолжения, расположенных последовательно. Абзацы-продолжение не могут быть вложенными (хотя теоретически это возможно).

Расположение абзацев-продолжение на странице выглядит:

[newpage]

[title]Наименование страницы [/title]

вводный текст страницы

[more]

[title]Наименование продолжения №1[/title]

Текст продолжения №1

[more]

[title]Наименование продолжения №2[/title]

Текст продолжения №2

…......................................

[more]

[title]Наименование продолжения №N[/title]

Текст продолжения №N

Абзацы-продолжение могут быть как именованными (с отображением наименования в оглавлении) так и не наименованными, т.е. такими, у которых отсутствует значение в обрамляющих тегах [title][/title], так и вовсе с отсутствием тегов. Отсутствующие наименование заменяется предопределенной последовательностью взятой из $L['More']. Наименование абзаца-продолжение служит в качестве ссылки-продолжение в пределах отображаемой части страницы. Всегда на странице может отображаться только одна ссылка-продолжение. По клику на ссылку-продолжение происходит отображение абзаца-продолжение. Отображаться может только один абзаца-продолжение. Каждый абзац-продолжение, это есть теневая страница, и, следовательно, к нему можно обратиться по ссылке, как для отдельной страницы. Обложка может содержать свои абзацы-продолжение.

Структура наименований

Наименование может как содержать любые директивы HTML, так и не содержать их. Тег [title] должен располагаться сразу после тегов [newpage] или [more] в первых $char_wait_ title знаках. Это сделано специально для возможности помещения конструкции тегов [title] и [/title] как обычного текста.

Формирующие структуры тегов темплейтов

Блок MAIN теги:

PAGE_TEXT - содержит отображаемый в статье текст;
PAGE_MORE - содержит наименование и ссылку на абзац-продолжение

Блок MAIN.PAGE_MULTI теги:

PAGE_MULTI_TABNAV - содержит список номеров отображаемый в статье страниц; Список формируется горизонтальной колонкой.

PAGE_MULTI_TABTITLES - содержит нумерованный список наименований отображаемых страниц. Список формируется вертикальной колонкой.

PAGE_MULTI_CURTAB - номер отображаемой страница.

PAGE_MULTI_MAXTAB — число отображаемых страниц. Обложка это страница с номером 0.

Теневые страницы и абзацы продолжение

Теневые страницы и теневые абзацы-продолжение формируются указанием символа знака минус, который пишется в начале наименование тега:

[-newpage] - теневая страница;

[-more] - теневой абзац-продолжение.