%audience% authors (intermediate)
The [@(:include:)@] directive makes it possible to insert the contents of other pages into the current wiki page.  All of the include directives below perform a straight text inclusion.  In particular, any page [[links]] in the included text are assumed to link to pages in the current [[(wiki) group]] if not otherwise qualified.

:[@(:include PageName:)@]:
:[@(:include Group.PageName:)@]:
: :Includes the entire text of another page into the current page.  

:[@(:include PageName#from#to:)@]:
:[@(:include PageName#from#:)@]:
:[@(:include PageName##to:)@]:
:[@(:include PageName#from:)@]:
: :Includes lines from `PageName between the [@[[#from]]@] and [@[[#to]]@] anchors.  If "to" is omitted (second example), then all of the lines after [@[[#from]]@] are included (and vice-versa if "from" is omitted).  In the last example, include everything between [@[[#from]]@] and the next anchor.

-> %note% Note: do not put whitespace between "#from" "#to"

:[@(:include PageName lines=10:)@]:
:[@(:include PageName lines=5..10:)@]:
:[@(:include PageName lines=5..:)@]:
: :Include the first 10 lines, lines 5-10, or lines 5 and up from `PageName. ''A "line" in this context refers to a line of source. Thus a line may be a paragraph that wraps over several lines on the screen, or a completely blank line.''

:[@(:include Page1 Page2 Page3 lines=1..5:)@]:
: :Include the first five lines from the first available of Page1, Page2, or Page3.  (To include lines from a list of pages, use a separate include for each.)

:[@(:include PageName self=0:)@]:
: :The parameter @@self@@ can be @@0@@ or @@1@@. It tells the include directive if it is allowed to include the current page. This is useful if PageName is a variable like [@{$Name}@] and you want to prevent the directive from including the current page.

!! See Also
* Cookbook:IncludeUrl

!! Styling Note
By default, Included pages or lines cannot be distinguished from other text on the page. To provide a visual indication that this text is special, you can apply [[PmWiki/WikiStyles]]. For example:

(:markup:) [=
%define=leftborder border-left="2px solid #88f" margin-left="2px" padding="1px 0 3px 10px"%

What is PmWiki?

>>leftborder<< (:include PmWiki.PmWiki lines=1..4:) 
>><<

''Have a very nice day!''
=]

!!! Notes
* You can also say [@(:include My/Page#myanchor lines=4:)@] which starts from, and includes, the line with the anchor [@[[#myanchor]]@] for four lines.


%trail%<<|[[DocumentationIndex]]|>>

>>faq<< [[#faq]]

Q: What's the maximum number of includes that can exist in a page?  My site seems to stop including after 48 includes.

A: By default, PmWiki places a limit of 50 include directives for any given page, to prevent runaway infinite loops and other situations that might eat up server resources.  The limit can be modified by the [[wiki administrator]] via the $MaxIncludes variable.