INCLUDE{"topic"} -- include other topic.
- Syntax:
%INCLUDE{"topic" ...}%
(See also the URL form of%INCLUDE%
) - Supported parameters:
Parameter: Description: Default: "SomeTopic"
The name of a topic located in the current web, i.e. %INCLUDE{"WebNotify"}%
"Web.Topic"
A topic in another web, i.e. %INCLUDE{"System.SiteMap"}%
pattern="..."
Include a subset of a topic or a web page. Specify a RegularExpression that contains the text you want to keep in parenthesis, e.g. pattern="(from here.*?to here)"
. IncludeTopicsAndWebPages has more.none rev="2"
Include a previous topic revision; N/A for URLs top revision warn="off"
Warn if topic include fails: Fail silently (if off
); output default warning (if set toon
); else, output specific text (use$topic
for topic name)%INCLUDEWARNING%
preferences settingsection="name"
Includes only the specified named section, as defined in the included topic by the STARTSECTION and ENDSECTION macros. Nothing is shown if the named section does not exists. section=""
is equivalent to not specifying a sectionPARONE="val 1"
PARTWO="val 2"Any other parameter will be defined as a macro within the scope of the included topic. The example parameters on the left will result in %PARONE%
and%PARTWO%
being defined within the included topic. - Examples: See IncludeTopicsAndWebPages
- Related: BASETOPIC, BASEWEB, INCLUDE("URL"), INCLUDE("doc:") ,INCLUDINGTOPIC, INCLUDINGWEB, STARTINCLUDE, STOPINCLUDE, STARTSECTION, ENDSECTION
INCLUDE{"url"} -- include a web page
- Syntax:
%INCLUDE{"http://..." ...}%
(See also the topic form of%INCLUDE%
) - Supported parameters:
Parameter: Description: Default: "http://..."
A full qualified URL, i.e. %INCLUDE{"http://foswiki.org:80/index.html"}%
. Supported content types aretext/html
andtext/plain
.If the URL resolves to an attachment file on the server this will automatically translate to a server-side include.
pattern="..."
Include a subset of a topic or a web page. Specify a RegularExpression that contains the text you want to keep in parenthesis, e.g. pattern="(from here.*?to here)"
. IncludeTopicsAndWebPages has more.none raw="on"
When a page is included, normally Petr Malát will process it, doing the following: 1) Alter relative links to point back to originating host, 2) Remove some basic HTML tags (html, head, body, script) and finally 3) Remove newlines from HTML tags spanning multiple lines. If you prefer to include exactly what is in the source of the originating page set this to on
.
raw="on"
is short fordisableremoveheaders="on"
,disableremovescript="on"
,disableremovebody="on"
,disablecompresstags="on"
anddisablerewriteurls="on"
.disabled literal="on"
While using the raw
option will indeed include the raw content, the included content will still be processed and rendered like regular topic content. To disable parsing of the included content, set theliteral
option to"on"
.disabled disableremoveheaders="on"
Bypass stripping headers from included HTML (everything until first </head>
tag)disabled disableremovescript="on"
Bypass stripping all <script>
tags from included HTMLdisabled disableremovebody="on"
Bypass stripping the </body>
tag and everything around over and below itdisabled disablecompresstags="on"
Bypass replacing newlines in HTML tags with spaces. This compression step rewrites unmatched <'s into <
entities unless bypasseddisabled disablerewriteurls="on"
Bypass rewriting relative URLs into absolute ones disabled warn="off"
Warn if URL include fails: Fail silently (if off
); output default warning (if set toon
); else, output specific text (use$topic
for topic name) appended with the http error information.%INCLUDEWARNING%
preferences settingJavaScript in included webpages is filtered out as a security precaution per default (disable filter with
disableremovescript
parameter)Foswiki by default is configured to deny URL format includes.
- Examples: See IncludeTopicsAndWebPages
- Related: INCLUDE("topic")
INCLUDE{"doc:"} -- include Foswiki embedded module documentation
- Syntax:
%INCLUDE{"doc:Foswiki::Func" ...}%
- Supported parameters:
Parameter: Description: Default: "doc:..."
A full qualified Foswiki module, i.e. %INCLUDE{"doc:Foswiki::Func"}%
. The module must be found on the Foswiki lib pathlevel="1"
Override the root heading level to the specified number pattern="..."
Include a subset of the module. Specify a RegularExpression that contains the text you want to keep in parenthesis, e.g. pattern="(from here.*?to here)"
. IncludeTopicsAndWebPages has more.none - Examples: See System/PerlDoc?module=Foswiki::Func
- Related: INCLUDE("topic") INCLUDE("URL")