pgsrc/Help%2FIncludePagePlugin

   1 Date: Thu, 10 Dec 2015 18:48:03 +0000
   2 Mime-Version: 1.0 (Produced by PhpWiki 1.5.5)
   3 Content-Type: application/x-phpwiki;
   4   pagename=Help%2FIncludePagePlugin;
   5   flags=PAGE_LOCKED%2CEXTERNAL_PAGE;
   6   charset=UTF-8
   7 Content-Transfer-Encoding: binary
   8
   9 The **~IncludePage** [[Help:WikiPlugin|plugin]] will “include” other pages in this wiki. In the language of hypertext this is called //transclusion//.
  10 The pages will render in distinct tables.
  11
  12 == Usage ==
  13
  14 {{{
  15 <<IncludePage page=OtherPage rev=6 quiet=1 words=50 lines=6>>
  16 }}}
  17
  18 == Arguments ==
  19
  20 {| class="bordered"
  21 |-
  22 ! Argument
  23 ! Description
  24 ! Default value
  25 |-
  26 | **page**
  27 | The page to include
  28 | //None// (required argument)
  29 |-
  30 | **rev**
  31 | the revision
  32 | most recent revision
  33 |-
  34 | **quiet**
  35 | if set, inclusion appears as normal content
  36 | false
  37 |-
  38 | **bytes**
  39 | maximum number of bytes to include
  40 | //None// (include all page)
  41 |-
  42 | **words**
  43 | maximum number of words to include
  44 | //None// (include all page)
  45 |-
  46 | **lines**
  47 | maximum number of lines to include
  48 | //None// (include all page)
  49 |-
  50 | **sections**
  51 | maximum number of sections to include
  52 | //None// (include all sections)
  53 |-
  54 | **section**
  55 | include a named section
  56 | //None//
  57 |-
  58 | **sectionhead**
  59 | when including a named section show the heading
  60 | false
  61 |}
  62
  63 == Inclusion ==
  64
  65 ~<noinclude> .. ~</noinclude> is stripped.
  66
  67 ~<includeonly> .. ~</includeonly> is only expanded in included pages.
  68
  69 == Examples ==
  70
  71 === ~IncludePage page=Help/~AllPagesPlugin ===
  72 <<IncludePage page=Help/AllPagesPlugin>>
  73
  74 === ~IncludePage page=Help/~AllPagesPlugin lines=6 ===
  75 <<IncludePage page=Help/AllPagesPlugin lines=6>>
  76
  77 === ~IncludePage page=Help/~AllPagesPlugin section="Arguments" ===
  78 <<IncludePage page=Help/AllPagesPlugin section="Arguments">>
  79
  80 === ~IncludePage page=Help/~AllPagesPlugin section="Arguments" sectionhead=true ===
  81 <<IncludePage page=Help/AllPagesPlugin section="Arguments" sectionhead=true>>
  82
  83 === ~IncludePage page=Help/~AllPagesPlugin sections=2 ===
  84
  85 Does not work in Wikicreole syntax
  86 <!-- <<IncludePage page=Help/AllPagesPlugin sections=2>> -->
  87
  88 == Known bugs ===
  89
  90 * Line and word limit doesn't work if the included page itself includes a plugin.
  91 * "sections" parameter does not work if sections to include are in Wikicreole syntax.
  92 * "section" parameter does not always work if sections to include use both Wikicreole/Mediawiki and classic Phpwiki syntax.
  93
  94 == Authors ==
  95
  96 * Joe Edelman
  97 * bug fixes by [[Help:Reini Urban|Reini Urban]]
  98 * "sections" parameter implemented by Marc-Etienne Vargenau, Alcatel-Lucent
  99
 100 == See Also ==
 101
 102 * [[Help:IncludePagesPlugin]] (to include multiple pages)
 103 * [[Help:TemplatePlugin]] (to include a page with parameters)
 104
 105 <noinclude>
 106 ----
 107 [[PhpWikiDocumentation]] [[CategoryWikiPlugin]]
 108 </noinclude>