NAME
    Template::Plugin::TruncateByWord - A Template Toolkit filter to truncate
    not the number of bytes but characters

SYNOPSIS
      # result is 'ab'
      [% USE TruncateByWord %]
      [% 'abcdefg' | truncate_by_word(2) %]

      # result is 'abc....'
      [% USE TruncateByWord %]
      [% FILTER truncate_by_word(3,'....') %]
      abcdefg
      [% END %]

      # default charset = 'utf8'. you can change this.
      # result is 'abcd'
      [% USE TruncateByWord 'euc-jp' %]
      [% FILTER truncate_by_word(4) %]
      abcdefg
      [% END %]

DESCRIPTION
    Template::Plugin::TruncateByWord is a filter plugin for Template Toolkit
    which truncate text not the number of bytes but the number of
    characters.

BUGS
    If found, please Email me. I tested utf8, euc-jp, shiftjis, 7bit-jis,
    big5, and euc-kr. Please send me more test cases.

SEE ALSO
    Template, Template::Plugin::Filter, and t/*.t

AUTHOR
    User & KAWABATA Kazumichi (Higemaru) <kawabata@cpan.org>

COPYRIGHT AND LICENSE
    Copyright (C) 2008- KAWABATA Kazumichi

    This library is free software; you can redistribute it and/or modify it
    under the same terms as Perl itself.