= Fixed width text blocks = == Description == [t:WikiProcessors Wiki Processor] to wrap a {{{
}}} text block to a specified number of columns, 72 by default.

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

[[Image(email_formatter_example.png)]]

The EmailProcessorMacro is installed on Trac-Hacks, so you can test it out. Please do so only by previewing, not 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&owner=pacopablo new ticket].

== Download and Source ==

Download the [download:emailprocessormacro zipped source], check out [/svn/emailprocessormacro using Subversion], or [source:emailprocessormacro browse the source] with Trac.

== Installation ==
While this is a wiki macro, it is in the new macro format, which is actually a single-file plugin.  As of 0.11, old style macros (those installed in the wiki-macros folder and only consisting of an `execute` function) are no longer supported.  This means that 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`
{{{
[components]
emailprocessor.* = enabled
}}}
 * Restart your server

== Example ==

Invocation:
{{{
 {{{
 #!email
 
 }}}
}}}
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
 
 }}}
}}}
It is important that the `cols:` starts at the beginning of the line and that only a number follows it.


== Recent Changes ==

[[ChangeLog(emailprocessormacro, 3)]]

== Author/Contributors ==

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