Source

hgext-textful / README

== Textful Extension ==

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

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

Download site: 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
}}}

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
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.