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
  Main#d3web - The Open-Source Diagnostic Platform
%

Renders as: (without the lines above and below)


Unable to resolve references in preview mode
d3web - The Open-Source Diagnostic Platform


    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
    Info Commercial Support#Contact
    %
    

    Renders as: (without the lines above and below)


    Unable to resolve references in preview mode
    Contact

    • @zoom: 100%


    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).