* What's this

It's automation tool for a document localization project using po4a.

  it's automation for:
    + get/update/generate source(s)
    + generate/update po4 file(s)
    + generate translated file(s)
    + git pull/add/commit

* Dependancy

  (must)
    po4a, nkf, cmp

  (optional; but need for general)
    wget|curl|aria2c

  (optional)
    git

  (optional; for an alternative scheme if you need)
    perl|runhaskell|python|...

* How to use

1. deploy the bin/* to your environment
  
  e.g.)
    % cp -al bin ~
    
      note:
        you don't forget through the path to ~/bin

2. create a some directory and run `auto-po4a` in the directory

  e.g.)
    % mkdir /tmp/some-dir
    % cd /tmp/some-dir
    % auto-po4a

3. configure "etc/auto-po4a.configure" as you like

  note:
    some special scheme is enabled at the sources
      a. "null" scheme
        it's not do anything for get the get a file.
        but, afford .po generate/update and translate.
      b. "alternative" scheme
        you can use an original script as you like.
        create "bin" directory. and deply your script.
        align the script filename to source URL with a few rule:
          source: alternative://alternative/test/hoge.txt
          script: bin/alternative-test
        the script must generate ot get the "hoge.txt".

        note: comment out a source line if need nothing to do.

* How to Uninstall

remove "auto-po4a*" in your deployed place.

  note:
    use `which` or `find` with "auto-po4" if you need.

* Licence

MIT/X11 License
http://www.opensource.org/licenses/mit-license


* Contacts

[email protected]
http://www.WonderRabbitProject.net/


* Copyright

(C) 2012 Usagi Ito @ Wonder Rabbit Project.


* Change log

new

[1a77525e4f6c3f8121b7308a2714d4c715c9ac03]

bug fix; auto_git. add default configure function,and you can compactize for your etc/auto-po4a.configure. see also the README.L10N/etc/auto-po4a.configure is a sample. :)

[71ec2a1b50d748c443c4b9c06db43d8999f6b942]

new feature; check the source update, and pass update po if needn't.

  note) current process flow; the new feature
    
    0. git pull if need
    1. ### backup old source if available ###
    2. get new source
    3. check update
    4. ### remove old source if available ###
    5. update po ### if need ###
    6. translate using po
    7. git add/commit if need

[76a7855d90a8f40a84353ac770f00e3c833d3a89]

bug fix; fix translated filename from no-extension file.

  old) README --> README.ja.po --> README.ja.README
  new) README --> README.ja.po --> README.ja

[96d863a0dfeec1585c4596e3201d367c4c3e2980]

add flag auto_git in configure and implement switching the function.

  configure)
    enabling auto git pull/add/commit: auto_git=TRUE
    disabling it: auto_git=FALSE

      note) this function is disable if you don't define auto_git

[52c3d18585e0df198d5949c5bc0df492053c9190]

bug fix; don't automation git add and commit functions.

[99c5475d6825baabf024b55edde75e6262b15ef9]

bug fix; can't insertion language code to translated file.

[900744021acf246499f08f525390b7e2b24011b5]

add translate keep ratio. default is 0.

[628b0f57aa2a3a94481e212ac98a641f982ec8c6]

change to insertion from addition for the position of a language code extension.

  new) abc.txt --> abc.txt.ja.po --> abc.ja.txt
  old) abc.txt --> abc.txt.ja.po --> abc.txt.ja

[e20e1aad10a76da74778938e0869ea0d9767af08]

the first commit