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

Within the markup, each non-empty line specifies an included section or article. There are two types of includes, a "simple include" and a "normalized header include". To include an article or header, use the normal wiki-like syntax, such as e.g. "~[article~]", "~[article#header~]" or "~[displayed name ~| article~]".

A simple example looks like:

%%prettify
{{{
%%include
  // the minus before the link suppresses the header of the included section, 
  // you may remove it to show the header as well
  - [Main#d3web - The Open-Source Diagnostic Platform]
%
}}}
/%

__Renders as:__ (without the lines above and below)
----

%%include
  // the minus before the link suppresses the header of the included section, 
  // you may remove it to show the header as well
  - [Main#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
Doc Include Target Example#Included text
%
}}}

__Renders as:__ (without the lines above and below)
----

%%include
Doc Include Target Example#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
Doc Include Target Example#Included text
@frame: show
%
}}}

__Renders as:__

%%include
Doc Include Target Example#Included text
@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
Doc Include Target Example#Included image
@zoom: 150%
%
}}}

__Renders as:__(without the lines above and below)
----

%%include
Doc Include Target Example#Included image
@zoom: 150%
%
----

__Note:__ The zoom attribute is not displayed correctly on all browsers for all zoom levels (Chrome recommended for this feature).