wiki:IncludeSourcePartialPlugin

Version 6 (modified by figaro, 8 years ago) (diff)

Cosmetic changes

Partial includes of files in wiki pages

Description

This is a modified version of the IncludeSource macro to allow for partial includes of files in Trac wiki pages.

This was originally done as a modification to the IncludeSource macro, but has been brought forward to Trac version 0.11.

Note that the macro in the file is still named IncludeSource because it provides the existing functionality, but titled differently to not conflict with the original. If people like this, it can be merged into the original IncludeSource to minimize confusion.

Bugs/Feature Requests

Existing bugs and feature requests for IncludeSourcePartialPlugin are here.

If you have any issues, create a new ticket.

defect

9 / 9

enhancement

3 / 3

task

2 / 2

Download

Download the zipped source from here.

Source

You can check out IncludeSourcePartialPlugin from here using Subversion, or browse the source with Trac.

Installation

General instructions on installing Trac plugins can be found on the TracPlugins page.

Configuration

In your trac.ini file, edit the components section to add the entry as follows:

[components]
includesource.* = enabled

Example

# include entire file
[[IncludeSource(trunk/proj/file.py)]]

# includes line 20-50 inclusive
[[IncludeSource(trunk/proj/file.py, start=20, end=50)]]

# includes last 30 lines of file at revision 1200
[[IncludeSource(trunk/proj/file.py, start=-30, rev=1200)]]

# include entire file but formatted plain
[[IncludeSource(trunk/proj/file.py, mimetype=text/plain)]]

Recent Changes

17695 by ttressieres on 2020-04-15 21:41:03
add support of regex in "start" and/or "end" parameters (see #5233)
17686 by ttressieres on 2020-03-23 21:44:33
add "framework" tag to publish on PyPI (see #13692)
17685 by ttressieres on 2020-03-22 17:59:00
update setup.py (add license & readme files) to contribute on PyPI (fix 13692)
(more)

Author/Contributors

Author: chrisheller
Maintainer: ttressieres
Contributors: