## Please edit system and help pages ONLY in the master wiki!
## For more information, please see MoinMoin:MoinDev/Translation.
##master-page:HelpOnMacros/Include
##master-date:2010-05-14T18:25:33Z
#acl -All:write Default
#format wiki
#language ru

= Макрокоманда Include =

<<TableOfContents>>

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

== Использование ==
{{{
<<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)>>
}}}
 * Блоги, созданные при помощи макрокоманды [[../MonthCalendar|MonthCalendar]], можно просматривать следующим образом:
  * Показать три записи из календаря:
  {{{
<<Include(^ИмяФамилия/20..-..-..,,to="^----",sort=descending,items=3)>>
}}}
  * Показать в виде заголовков ссылки на предыдущие четыре записи из календаря:
  {{{
<<Include(^ИмяФамилия/20..-..-..,,to="^----",sort=descending,items=4,skipitems=3,titlesonly)>>
}}}