Log In | Users | Register
Welcome, Registration, and other StartingPoints; Foswiki history & Wiki style; All the docs...
Edit | Attach | New | Raw | Diff | Print | Subscribe | Tools

Include Topics and Web Pages Using %INCLUDE{...}% Macro

Use the %INCLUDE{...}% macro to embed the content of another topic or web page inside a topic. The whole content or only parts of a page can be included. If needed, set a proxy server with the {PROXY}{HOST} and {PROXY}{PORT} settings in configure.

Syntax Example

%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 scans from start ('^') to end and contains the text you want to keep in parenthesis, 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.

Note: All text of a topic is included unless it contains a %STARTINCLUDE% and %STOPINCLUDE%, or you specify a section parameter and/or a pattern parameter. A pattern will only search between %STARTINCLUDE% and %STOPINCLUDE%.

Usage Examples

1. Display regression test results

  <pre>
  %INCLUDE{"http://domain/~qa/v1.1/REDTest.log.txt"}%
  </pre>

2. Display foswiki.org's frequently asked questions

  • You type:
  %INCLUDE{"http://foswiki.org/Support/FrequentlyAskedQuestion?skin=text"}%

  • You get:

Frequently Asked Questions

Want to create a new FAQ?

Access

Browser

Configure

Data forms

Debugging

Development

Editing

Email and Notifications

Errors

Extension

Foswiki

Frontend or Javascript or CSS

Help and Support

Installation

Internationalisation or Localisation

Macros or Variables

Operating system

Public websites

Registration or Authentication or Authorisation

Security

Setup

Templates

Upgrading

Usage

User interface

Web server

Other...

Note: Including URLs is disabled by default as it presents a security risk. It may be enabled via configure. Only enable this if you understand the risk.

3. Include a topic

  • You type:
  %INCLUDE{%SYSTEMWEB%.TipsOfTheDayInclude}%

  • You get:

tip Tip of the Day
SmiliesPlugin emoticons
Smilies are common in e mail messages and bulletin board posts. They are used to convey an emotion, such ... Read on Read more

4. Include a topic MyTopic with two parameters

You include the topic with this line

  %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

  • I like apples better than oranges.


Related Topics: VarINCLUDE, UserDocumentationCategory spacer
This site is managed by the Center for Climate Systems Modeling (C2SM).
This site is powered by FoswikiCopyright © by the contributing authors. All material on this site is the property of the contributing authors.
Ideas, requests, problems regarding C2SM Wiki? Send feedback