pgsrc/Help%2FIncludePagePlugin

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