Skip to main content

A Trac macro that displays the bodies of wiki pages inside other wiki pages

Project description


TracSubPages is a Trac plugin that supplies a macro allowing full wiki pages to be displayed inside of other wiki pages. This is useful if there is a piece of content (such as a contact table or log) that needs to be displayed in multiple places, as it eliminates the need for each instance of this content to be maintained.


The syntax for the subpage macro is simple:

[[subpage(wiki_page, [show_link])]]

Where wiki_page is the wiki page (No url is needed here, nor ‘wiki/’, just the page). The macro supports pages that aren’t top-level, too (‘BigCategory/SpecificSubject’). The second argument, showlink is an optional argument (true or false) that determines whether or not a link to edit the rendered page will be shown at the bottom of the subpage section (The link reads ‘Edit Section’ and provides a link directly to the edit page of the referenced wiki page).

For example, if a user had created a wiki pages called ‘Minutes’ and wanted to display it inline in another wiki page without a link to edit it, he or she would add the following entry to the wiki page that is intended to display the extra content:

[[subpage(Minutes, False)]]

If the user later decided that he or she wanted a link to be placed at the bottom of the inline section for quick editing, the entry should be changed as follows:


Note that the second boolean argument ‘True’ is not needed, as it is assumed by default.


  • A wiki page needs to exist before you link to it with a subpage macro. This may seem obvious, but the error caused by a broken link isn’t very descriptive (yet).
  • Please use only wiki formatting for subpages. The use of macros can (and probably will) cause errors.

Change History


  • Begin using in the absence of a Subversion repository


  • Fixed unicode bug that caused errors when given non-ASCII characters [jetheis]


  • All code adheres to PEP 8 standards [jetheis]
  • Added to package [jetheis]
  • Changed license to GPLv3 [jetheis]


  • Changed macro syntax to not require true/false argument [jetheis]
  • Cleaned up code to better adhere to PEP 8 [jetheis]


  • Initial release of plugin [jetheis]

Project details

Release history Release notifications

This version
History Node


History Node


History Node


History Node


History Node


Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
TracSubPages-0.5.tar.gz (18.4 kB) Copy SHA256 hash SHA256 Source None Mar 3, 2011

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page