%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 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.
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!'' |
%define=leftborder border-left="2px solid #88f" margin-left="2px" padding="1px 0 3px 10px"% What is PmWiki? >>leftborder<< PmWiki is a wiki-based system for collaborative creation and maintenance of websites. PmWiki pages look and act like normal web pages, except they have an "Edit" link that makes it easy to modify existing pages and add new pages into the website, using basic editing rules. You do not need to know or use any HTML or CSS. Page editing can be left open to the public or restricted to small groups of authors. >><< Have a very nice day!
|
(:include My/Page#myanchor lines=4:) which starts from, and includes, the line with the anchor [[#myanchor]] for four lines.
%trail%<<|DocumentationIndex|>>
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.