Include Other Pages {PmWiki}

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 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.

(: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 WikiStyles. For example:

  %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.

<< Page directives | DocumentationIndex | InterMap >>