Include the contents of external URLs and other Trac objects in a wiki page.
This macro lets you include various things.
Currently supported sources:
- HTTP - http: and https:
- FTP - ftp:
- Wiki pages - wiki:
- Repository files - source:
- Ticket comments - ticket:N:comment:M (3.0dev, syntax may be changed before release)
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.
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.
If [wiki] render_unsafe_content is off (the default), any produced HTML will be sanitized.
This is a potential security risk! Please review the implications render_unsafe_content before using this feature.
To enable the plugin:
[components] includemacro.* = enabled
Include another wiki page:
Include a section of a page (the section heading must have an explicit id):
Include the HEAD revision of a reStructuredText file from the repository:
Include a specific revision of a file from the repository:
Include only a subpart of file from the repository (use named arguments : start, end, lineno):
[[Include(source:trunk/docs/README@5, text/x-rst, start=5, end=15)]] [[Include(source:trunk/docs/README@5, text/x-rst, start=5, end=15, lineno=yes)]]
It’s possible to use regular expressions in start and/or end parameters
[[Include(source:trunk/docs/README, start=”[a-z]+”, end=15, lineno=yes)]] [[Include(source:trunk/docs/README, start=”[a-z]+”, end=”[.+]”, lineno=yes)]]
If you set the svn:mime-type property on the file, you can leave off the explicit MIME type.
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size||File type||Python version||Upload date||Hashes|
|Filename, size TracIncludeMacro-3.2.0-py2.7.egg (6.6 kB)||File type Egg||Python version 2.7||Upload date||Hashes View|
|Filename, size TracIncludeMacro-3.2.0-py2-none-any.whl (7.9 kB)||File type Wheel||Python version py2||Upload date||Hashes View|
|Filename, size TracIncludeMacro-3.2.0.tar.gz (7.4 kB)||File type Source||Python version None||Upload date||Hashes View|
Hashes for TracIncludeMacro-3.2.0-py2.7.egg
Hashes for TracIncludeMacro-3.2.0-py2-none-any.whl