Skip to main content

Include the contents of external URLs and other Trac objects in a wiki page.

Project description

Notes

This macro lets you include various things.

Currently supported sources:

  • HTTP - http: and https:
  • FTP - ftp:
  • Wiki pages - wiki:
  • Repository files - source:

The default source is wiki if only a source path is given.

An optional second argument sets the output MIME type, though in most cases the default will be correct.

Permissions

The three remote sources (http, https, and ftp) require INCLUDE_URL to be rendered.

Anyone can add a call to these, however they will not be shown. This is not a replacement for render_unsafe_content, see below.

Configuration

If [wiki] render_unsafe_content is off (the default), any produced HTML will be sanitized.

Caution!

This is a potential security risk! Please review the implications render_unsafe_content before using this feature.

To enable the plugin:

[components]
includemacro.* = enabled

Example

Include another wiki page:

[[Include(PageName)]]

Include a reStructuredText file from the repository:

[[Include(source:trunk/docs/README, text/x-rst)]]

Tip

If you set the svn:mime-type property on the file, you can leave off the explicit MIME type.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

TracIncludeMacro-2.1.tar.gz (3.6 kB view hashes)

Uploaded source

Built Distributions

TracIncludeMacro-2.1-py2.5.egg (6.0 kB view hashes)

Uploaded 2 5

TracIncludeMacro-2.1-py2.4.egg (6.0 kB view hashes)

Uploaded 2 4

TracIncludeMacro-2.1-py2.3.egg (12.5 kB view hashes)

Uploaded 2 3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page