Build Status

NAME

textconv - optex module to replace document file by its text contents

VERSION

Version 0.11

SYNOPSIS

optex command -Mtextconv

optex command -Mtc (alias module)

optex command -Mtextconv::load=pandoc

DESCRIPTION

This module replaces several sort of filenames by node representing its text information. File itself is not altered.

For example, you can check the text difference between MS word files like this:

$ optex diff -Mtextconv OLD.docx NEW.docx

If you have symbolic link named diff to optex, and following setting in your ~/.optex.d/diff.rc:

option default --textconv
option --textconv -Mtextconv $<move>

Next command simply produces the same result.

$ diff OLD.docx NEW.docx

MICROSOFT DOCUMENTS

Microsoft office document in XML format (.docx, .pptx, .xlsx) is converted to plain text by original code implemented in App::optex::textconv::msdoc module. Algorithm used in this module is extremely simple, and consequently runs fast.

Two module are included in this distribution to use other external converter program, pandoc and tika, those implement much more serious algorithm. They can be invoked by calling load function with module declaration like:

optex -Mtextconv::load=pandoc

optex -Mtextconv::load=tika

INSTALL

CPANM

$ cpanm App::optex::textconv
or
$ curl -sL http://cpanmin.us | perl - App::optex::textconv

GIT

These are sample configurations using App::optex::textconv in git environment.

    ~/.gitconfig
            [diff "msdoc"]
                    textconv = optex -Mtextconv cat
            [diff "pdf"]
                    textconv = optex -Mtextconv cat
            [diff "jpg"]
                    textconv = optex -Mtextconv cat

    ~/.config/git/attributes
            *.docx   diff=msdoc
            *.pptx   diff=msdoc
            *.xlmx   diff=msdoc
            *.pdf    diff=pdf
            *.jpg    diff=jpg

About other GIT related setting, see https://github.com/kaz-utashiro/sdif-tools.

SEE ALSO

https://github.com/kaz-utashiro/optex

https://github.com/kaz-utashiro/optex-textconv

https://qiita.com/kaz-utashiro/items/23fd825bd325240592c2

https://github.com/kaz-utashiro/sdif-tools

AUTHOR

Kazumasa Utashiro

LICENSE

Copyright 2019-2020 Kazumasa Utashiro.

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