「kanzip」は「LTsv10kanedit(tsvtool10)」を用いた郵便番号ダウンローダーです。

version(branch):20170119R141608 modify:20170128S130712

目次

⓪-0.ライセンス及びソフト使用の補足ガイドライン

※「MIT License」準拠。

MIT License - Choose a License
http://choosealicense.com/licenses/mit/
licenses/MIT_license - Open Source Group Japan Wiki - Open Source Group Japan - OSDN
https://ja.osdn.net/projects/opensource/wiki/licenses%2FMIT_license
MITライセンスを1行1行読んでいく | プログラミング | POSTD
http://postd.cc/mit-license-line-by-line/

※口語的説明。
・「LICENSE」も含めソースコードの閲覧やコピーに制限を設けない事。
・いかなる場合においても作者または著作権者は一切責任を負わない事。

⓪-1.インストール(ダウンロード・アンインストール)&セットアップ

※Pythonは別途インストールされているものとします(Pythonの導入分からない人は「LTsv10kanedit(tsvtool10)⑩-0.「L:Tsv」のFAQ」を参考)。

※Vimも別途インストールされているものとします(Vimの導入分からない人は「KEV①-0.「KEV(kanedit.vim)」をVimへセットアップ」を参考)。

ダウンロードは「https://github.com/ooblog/LTsv10kanedit」にある「Clone or download」ボタンを押すと出る「Download ZIP」メニューをクリック。
インストールは任意(なるだけユーザーディレクトリ内)のフォルダに「LTsv10kanedit-master.zip」を解凍するだけです(「LTsv10kanedit-master」フォルダが作成されるはずです)。
「*.py」のパーミッションがOFFになってたら実行可能に変更、Wineで使う場合は「wine_sh」フォルダ内の「*.sh」のWineパスを適宜修正。
最初に「kanmap.py」を起動(前バージョンの「LTsv/kanpickle.bin」ある場合は一旦削除してから)。「LTsv/kanpickle.bin」を新規作成してください。
「LTsv/kanpickle.bin」を初期化しない場合グリフ座標データが蓄積するまで起動や動作が重くなるか、バージョン(ブランチ)によってはエラーになる場合があります。
詳細は「kanmap①-0.「kanmap」の使い方(初回起動・表示編)」を参考。

フォント「kan5x5comic.ttf」も用意する場合は「kanfont③-0.「kanfont」のFAQ」を参考。

ooblog/LTsv10kanedit: 「L:Tsv」の読み書きを中心としたモジュール群と漢字入力「kanedit」のPythonによる実装です(準備中)。
https://github.com/ooblog/LTsv10kanedit

アンインストールはインストール時に作成した「LTsv10kanedit-master」フォルダを削除するだけです。

⓪-2.その他現在わかっている不具合や今後の課題

「Tahrpup6.0.5,Python2.7.6,vim.gtk7.4.52(vim-gtk)」および「Wine1.7.18,Python3.4.4,gvim8.0.134(KaoriYa)」で開発しています。Windows,cygwin,darwin,MacOSなどでの動作は確認しておりません。
フォント(グリフ)「kan5x5comic」は半角と全角の幅の比率が約5:3(1024:624)なのでアスキーアートで問題になる場合があります。グリフ不足で表示できない文字などあります。
「kan5x5comic.ttf」と「kan5x5.ttf」を同時に入れると麻雀牌が表示されない(「kan5x5.ttf」の絵文字代替4x5文字が優先される)場合があります。
私用領域と呼ばれる環境に左右される文字コードを漢直鍵盤の制御に用いてます。「kan5x5comic.ttf」を用意しないとソースが見辛い可能性があります。
人名に使える漢字の異体字を漢字配列「LTsv/kanmap.tsv」から単漢字辞書「LTsv/kanchar.tsv」に移管作業中。なので漢直鍵盤の漢字配列「LTsv/kanmap.tsv」が大幅に変更するかも。
マウスボタンの取得は保留。ホイールの取得は放置。tkk方面は手を出さない予定(コンボボックスなどはGTKのみサポート)。
GTKのコールバックから受けとる構造体を扱う方法が不明のため、GUIイベント経由のPCキーボード取得やファイルダイアログからのキャンセル取得などが不明。
「docs/」フォルダ内のドキュメントを「docs/kanedit_etc.tsv」ベースで描き直し中。執筆途中状態の関数一覧タグ解説項目あり。
LTsv/LTsv_doc.py」でタグの順序が厳格という問題があるのでいっその事スクリプト言語ごと新規に作ろうと思います(TSFの開発)。

LTsv版の「kanedit.py」の開発を凍結してTSF版の「kanedit」を作成する予定です。言語の開発には時間が必要なので、平行してVim版「LTsv/kanedit.vim」も開発です。
LTsv/kanedit.vim」と「kanedit.py」とで操作方法が乖離してますがTSF版もVim版の方向になるべく揃える予定です。LTsv版は互換性の維持程度に止まると思います。

TSF版作る前に漢字配列「LTsv/kanmap.tsv」のグリフ圧縮アルゴリズムを「5x10x」から「5x10x20x」に変更したいので、移行ツール作成→一時的に無圧縮→新アルゴリズムのグリフと交換などの間多少の混乱が発生するかと思います。

①-0.「kanzip」の使い方

kanzip

まず「LTsv/kanzip.py」配下に作業用の「kanzip」フォルダが作成されます。
初期状態なら「jigyosyo.zip」「01hokkai.zip」など各都道府県(大口事業所個別番号含む)のボタンがあり、押すと「*.zip」をダウンロード。
「*.zip」ダウンロード同様に「*.csv」から必要事項を取りだして「*.tsv」に変換の手順を、47都道府県で行います。手順は手動でボタンを押します。
全ての「*.tsv」を作成(かつ「kanzip.tsv」が無い状態)すると「都道府県と事業所をダウンロード&コンバートし終えてから[kanzip.tsv]にマージ。」ボタンの封印が解除されるので、
最終的に郵便番号辞書「kanzip.tsv」にマージして完成。

②-0.「kanzip.py」の関数一覧

LTsv/kanzip.py」の解説は準備中です。

③-0.「kanzip」のFAQ

Q.ボタンを手動で1個ずつ押していくのが面倒です。
A.ダウンロードがうまくいかない場合(回線が襲いとかzipの破損など)自動化しづらい箇所があるので手動確認は大事です。
Q.ダウンロードできなくなりました。
A.日本郵便にあるはずのzipファイルのURL変更などが考えられますが、ブラウザでzipをダウンロードして「kanzip」フォルダにコピーすれば作業続行可能なはずです。

④-0.作者について、例えば連絡先。

更新情報はGitHubやブログを確認してください。

ooblog/LTsv10kanedit(GitHub)
https://github.com/ooblog/LTsv10kanedit
[kanedit] - 大風呂ダ敷
http://d.hatena.ne.jp/ooblog/searchdiary?word=*[kanedit]
↑Top