##master-page:HelpOnMacros/Include
##master-date:2010-01-18T13:54:59Z
#acl -All:write Default
#format wiki
#language ru

<<Navigation(siblings)>>
<<BR>><<BR>>

Эта макрокоманда включает в страницу предварительно отформатированное содержимое одной или нескольких других страниц той же вики. Допускается вложенное включение страниц друг в друга; если при этом образуется бесконечная рекурсия, действие не выполняется.

'''Синтаксис''' (все параметры, кроме первого, необязательны):
{{{
<<Include(страница, заголовок, уровень, from="regex", to="regex", sort=ascending|descending, items=n, skipitems=n, titlesonly, editlink)>>
}}}

 страница::   Имя включаемой страницы; если в начале стоит символ "`^`", этот параметр понимается как регулярное выражение, в этом случае включается содержимое всех подходящих страниц.
 заголовок::  Если указан, перед включаемым содержимым выведется заголовок-ссылка на включаемую страницу..
 уровень::    Указывает, заголовок какого уровня (1..5) будет показан в предыдущем случае.
 from::       Включать текст частично, начиная со строки, удовлетворяющей регулярному выражению, указанному в значении параметра.
 to::         Включать текст частично, заканчивая строкой, удовлетворяющей регулярному выражению, указанному в значении параметра.
 sort::       Сортировка включаемых страниц (если `страница` — это регулярное выражение, т. е. начинается с "`^`")
 items::      Максимальное число включаемых страниц.
 skipitems::  Количество страниц в начале списка, которые следует пропустить.
 titlesonly:: Оставить от включаемой страницы только заголовок — ссылку на эту страницу.
 editlink::   После включения страницы показать блок со ссылками на эту страницу в режиме просмотра и редактирования.
 
Несмотря на то, что все параметры, кроме `страница`, необязательны, указывать их следует только в приведённом порядке! Если параметры `заголовок` и `уровень` не используются, им соответсвтует ''один'' пустой параметр макрокоманды (см. пример ниже), за которым могут следовать {{{from=}}} и т. п.; соответствующая ссылка не выводится.

<!> Регулярные выражения из `from` и `to` применяются ко всему тексту исходной страницы, в т. ч. и к содержимому комментариев. Это может помочь при оформлении составных страниц, но требует более пристального внимания к комментариям, дабы включаемая часть страницы не началась и не закончилась неожиданно.

'''Примеры:'''
 * `<<Include(ИмяСтраницы)>>` — включить в страницу содержимое страницы `ИмяСтраницы`.
 * `<<Include(ИмяСтраницы,"Имя Страницы" )>>` — перед текстом страницы `ИмяСтраницы` вставить заголовок «Имя Страницы» первого уровня, ссылающийся на эту страницу.
 * `<<Include(ИмяСтраницы, , 2)>>` — вставить заголовок «!ИмяСтраницы» второго уровня.
 * `<<Include(ИмяСтраницы, 'Всё о имени страницы', 3)>>` — вставить заголовок «Всё о имени страницы» третьего уровня.
 * `<<Include(ИмяСтраницы, , from="^----$")>>` — включить только текст ''после'' первой горизонтальной линии
 * `<<Include(ИмяСтраницы, , to="^----$")>>` — включить только текст ''перед'' первой горизонтальной линией
 * `<<Include(^ИмяСтраницы/.*, , sort=descending)>>` — отсортировать включаемые страницы в обратном порядке
 * `<<Include(^ИмяСтраницы/.*, , items=3)>>` — включать не более трёх страниц
 * `<<Include(^СтраницаБлога/.*,, to="^----$", sort=descending, items=7)>>` — показать не более семи записей из блога.
 * `<<Include(^СтраницаБлога/.*,, to="^----$", sort=descending, items=7, skipitems=7, titlesonly)>>` — показать ссылки на предыдущие семь записей в блоге.
 * Блоги, созданные при помощи MoinMoin:MonthCalendar, можно просматривать так (см. ../MonthCalendar):
  * `<<Include(^ИмяФамилия/20..-..-..,,to="^----",sort=descending,items=3)>>` — показать три записи из календаря
  * `<<Include(^ИмяФамилия/20..-..-..,,to="^----",sort=descending,items=4,skipitems=3,titlesonly)>>` — показать в виде заголовков ссылки на предыдущие четыре записи из календаря