%INCLUDE{...}%
Macro Embed topics, or subsections of topics, or other web pages.
The %INCLUDE{...}% macro embeds the content of the specified topic at the place where the INCLUDE is used. The whole content or only parts of of a page can be included.{INCLUDE}{AllowURLs}
.
If your web server connects to the internet via a proxy server, Proxy settings should be set in configure. See: Security and Authentication > Proxies > {PROXY}{HOST}
%INCLUDE{ "page" pattern="reg-exp" rev="2" warn="off" section="clients" PARAMETER1="value" PARAMETER2="Some value" }%The
pattern
parameter is optional and allows you to extract some parts of a web page. Specify a RegularExpression that contains the text you want to keep in parenthesis. It may be helpful for the pattern to match more than just the text you wish to keep, e.g. pattern="Some prefix(Start here.*?to here)"
. If needed, the pattern may even scan from start ('^'
) to end and match the whole topic, e.g. pattern="^.*?(from here.*?to here).*"
.
You need to make sure that the integrity of a web page is not compromised; for example, if you include a table, make sure to include everything including the table end tag.
The example parameters PARAMETER1 and PARAMETER2 will be defined as macros within the scope of the included topic. The example parameters shown will result in %PARAMETER1% and %PARAMETER2% being defined within the included topic.
VarINCLUDE explains the other parameters.section
parameter (see STARTSECTION and ENDSECTION) and/or a pattern
parameter. A pattern will only search between %STARTINCLUDE%
and %STOPINCLUDE%
or within the section
specified.%SET
preferences are evaluated whe macros are expanded, but in a new "context". TopicName
is changed to Web.TopicName
<pre> %INCLUDE{"http://domain/~qa/v1.1/REDTest.log.txt"}% </pre>
%INCLUDE{"https://foswiki.org/Support/FrequentlyAskedQuestion?skin=text"}%
%INCLUDE{"%SYSTEMWEB%.TipsOfTheDayInclude"}%
%INCLUDE{"MyTopic" BETTER="apples" WORSE="Oranges"}%
An example of a very simple MyTopic could contain
* I like %BETTER% better than %WORSE%.
The result would be