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: 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
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!''
|
What is PmWiki?
Even if there are less valued employees in the firm, the highly-valued ones will drive the choice of a health plan. ,
Have a very nice day!
|
Notes
- You can also say
(:include My/Page#ananchor lines=4:) which starts from, and includes, the line with the anchor [[#myanchor]] for four lines.
<< Page directives | DocumentationIndex | InterMap >>
What's the maximum number of includes that can exist in a page? My site seems to stop including after 48 includes.
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.
