Doc Include
Back to current version Restore this version

Markup for Wiki Includes#

The include markup allows to include a wiki page or a fragment of a wiki page into another page. This can be useful if some content should be presented in different contexts on different pages and should not be duplicated.

%%include...

For an include at least the target of the page or page fragment that should be include needs to be specified in the body of the markup:

%%include
Doc Include Target Example
%

Renders as: (without the lines above and below)


Unable to resolve references in preview mode
Doc Include Target Example


    Including a Chapter of a Page#

    The markup allows to include a specific (sub-)chapter of a wiki page. Therefore the chapter mechanism from the basic wiki markup is used as described on Doc BasicMarkup. After the include page name, the respective header name can be appended using '#'. In the following example only the chapter Contacts of the page Getting Started is included:

    %%include
    Doc Include Target Example#Included text
    %
    

    Renders as: (without the lines above and below)


    Unable to resolve references in preview mode
    Included text


      The Frame Annotation#

      By default the included content is not surrounded by any frame to make the included section look like the actual section referenced by the include. If you want to highlight the included part, you can do this using the annotation @frame.

      The included section will then be highlighted on mouse over and provides a link to the original section in the menu on the top right.

      %%include
      Info Commercial Support#Contact
      @frame: show
      %
      

      Renders as:

      Unable to resolve references in preview mode
      Contact

      • @zoom: 100%
      • @frame: show

      The Zoom Annotation#

      It is also possible to modify the presentation size of the included content by specifying a zoom level be the zoom annotation:

      %%include
      Info Commercial Support#Contact
      @zoom: 150%
      %
      

      Renders as:

      Unable to resolve references in preview mode
      Contact

      • @zoom: 150%
      Note: The zoom attribute is not displayed correctly on all browsers for all zoom levels (Chrome recommended for this feature).