[[PageOutline(2-5,Contents,pullout)]]

= Insert word-wrapped text blocks

== Description

This plugin is a [t:WikiProcessors Wiki Processor] to wrap a {{{<pre></pre>}}} text block to a specified number of columns, 72 by default.

This is especially useful for pasting emails and getting blocks of text that don't scroll horizontally.

[[Image(email_formatter_example.png)]]

Please see the following example:

The email processor is invoked by wrapping the `#!email`-processor around the body content of the email in your wiki page: 
{{{
 {{{#!email
 <email stuff here>
 }}}
}}}

To wrap to a specified length, the line immediately following the invocation should contain `cols: ` followed by the number of columns at wich we wrap. For example:
{{{
 {{{#!email
 cols: 40
 <email stuff here>
 }}}
}}}

It is important that the `cols:` starts at the beginning of the line and that only a number follows it.

The EmailProcessorMacro is installed on Trac-Hacks, so you can test it out. Please do so only by previewing, not by submitting tickets.

== Bugs/Feature Requests

Existing bugs and feature requests for EmailProcessorMacro are [query:status!=closed&component=EmailProcessorMacro&order=priority here]. If you have any issues, create a 
[/newticket?component=EmailProcessorMacro new ticket].

[[TicketQuery(component=EmailProcessorMacro&group=type,format=progress)]]

== Download

Download the zipped source from [export:emailprocessormacro here].

== Source

Check out EmailProcessorMacro from [/svn/emailprocessormacro here] using Subversion, or [source:emailprocessormacro browse the source] with Trac.

== Installation

This `macro` needs to be installed in the global plugin directory, or in the Trac environment's `plugins` directory:

 * Copy `emailprocessor.py` into the environment's `plugins` directory.
 * Add the following to the environment's `trac.ini` file:
{{{#!ini
[components]
emailprocessor.emailmacro = enabled
}}}
 * Restart your web server.

== Recent Changes

[[ChangeLog(emailprocessormacro, 3)]]

== Author/Contributors

'''Author:''' [wiki:pacopablo] [[BR]]
'''Maintainer:''' [[Maintainer]] [[BR]]
'''Contributors:'''