== Textful Extension ==

'''This extension is not distributed with Mercurial.'''

''Author: [[YuyaNishihara|Yuya Nishihara]]''

Repository: http://bitbucket.org/yuja/hgext-textful/

=== Overview ===

This extension tries to convert unreadable binary content to plain text when displaying,
so that you can see decent diff of binary files.

Currently supports the following conversions:

 * `textful.encoding`: convert character encoding
 * `textful.msexcel`: Microsoft Excel (*.xls), requires xlrd or pyExcelerator
 * `textful.pipe`: filter by external command, e.g. `catdoc` for Microsoft Word (*.doc)

=== Configuration ===

Configure your .hgrc to enable the extension by adding following lines:

{{{
[extensions]
textful = /path/to/hgext/textful
#textful.encoding = /path/to/hgext/textful/encoding.py
#textful.msexcel = /path/to/hgext/textful/msexcel.py
#textful.pipe = /path/to/hgext/textful/pipe.py
}}}

To enable conversion of character encoding for Japanese:

{{{
[extensions]
textful = /path/to/hgext/textful
textful.encoding = /path/to/hgext/textful/encoding.py

[textful]
encoding = utf-8, euc-jp, cp932, iso-2022-jp
# specify 'utf-8-sig' for UTF-8 with BOM, which is commonly used in Microsoft applications
}}}

To add textful `cat` command without breaking original `cat`:

{{{
[alias]
scat = cat

[textful]
attend = annotate, diff, glog, log, qdiff, scat
}}}

To textize Microsoft Word document (*.doc):

{{{
[extensions]
textful = /path/to/hgext/textful
textful.pipe = /path/to/hgext/textful/pipe.py

[textful]
pipe.doc = antiword -w0 $<
# or
# pipe.doc = catdoc -w $<
}}}

----
CategoryExtensionsByOthers