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

= Wrap text blocks to specified width

== Description

This plugin is a [t:WikiProcessors wiki processor] to wrap text 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.

In the following example, the text is constrained to within a 72-character wide text block:

[[Image(email_formatter_example.png, border=2)]]

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:'''