doc/readme.html

   1 <?xml version="1.0" encoding="utf-8" ?>\r
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">\r
   3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="ja">\r
   4  <head>\r
   5   <title>Lychee</title>\r
   6   <meta http-equiv="content-type" content="application/xhtml+xml; charset=utf-8" />\r
   7   <link rel="stylesheet" href="style.css" type="text/css" />\r
   8  </head>\r
   9  <body>\r
  10   <h1>Lychee</h1>\r
  11 \r
  12   <address style="top:5px">\r
  13    Silky(sirakaba@gmail.com)<br />\r
  14    <a href="http://tpi.sourceforge.jp/">http://tpi.sourceforge.jp/</a>\r
  15   </address>\r
  16 \r
  17   <ul id="menu">\r
  18    <li>Readme</li>\r
  19    <li><a href="files.html">Files</a></li>\r
  20    <li><a href="history.html">History</a></li>\r
  21    <li><a href="api/index.html">TPI spec</a></li>\r
  22   </ul>\r
  23 \r
  24   <h2>About</h2>\r
  25   <p>Lycheeは、TPIという仕様に対応したプラグインを利用することでさまざまな書庫を操作することができるアーカイバです。Lycheeには、統合アーカイバDLLやSusie Plug-in(SPI)などに対応するTPIが同封されています。</p>\r
  26 \r
  27   <h2>Feature</h2>\r
  28   <ul>\r
  29    <li>\r
  30     TPIによる書庫操作。\r
  31     <ul>\r
  32      <li>書庫の作成、ファイルの追加、展開、削除、検査、修復機能。</li>\r
  33      <li>書庫とSFXの相互変換機能。</li>\r
  34     </ul>\r
  35    </li>\r
  36    <li>wxWidgetsを採用することでWindows/Linux双方で動作。</li>\r
  37    <li>Unicodeへの対応。</li>\r
  38    <li>仮想リストビューを用いた高速動作。</li>\r
  39    <li>多言語対応UI。</li>\r
  40   </ul>\r
  41   <div>※但し、実際の動作はTPIの実装に依存します。</div>\r
  42 \r
  43   <h2>TPI(s)</h2>\r
  44   <h3 class="file">7zArc</h3>\r
  45   <p>7z,zip,NSIS,MSIなど、<a href="http://www.7-zip.org/">7-zip</a>で対応している諸形式の処理に対応するTPIです。</p>\r
  46   <p>動作には<span class="file_win">7z.dll</span>か<span class="file_lin">7z.so</span>が必要です。</p>\r
  47   <p>動作の設定については<a href="files.html#bin_lib_7zArc.xml">7zArc.xml</a>を参照してください。また、このファイルに記述することで7zArcで対応する形式を変更することができます。<a href="files.html#bin_lib_cuiWrapper.xml">cuiWrapper.xml</a>には簡単な書式の説明を行っていますので、そちらも参考にしてください。</p>\r
  48 \r
  49   <h3 class="file_win">calLibrary</h3>\r
  50   <p><a href="http://www.madobe.net/archiver/">統合アーカイバライブラリ</a>に対応するTPIです。統合アーカイバ仕様に従う一般的なライブラリに対応しています。</p>\r
  51   <p>対応しているライブラリについては<a href="files.html#bin_lib_calLibrary.xml">calLibrary.xml</a>を参照してください。また、このファイルに記述することで新たなライブラリに対応したり、ライブラリに送るコマンドラインを変更することができます。<a href="files.html#bin_lib_cuiWrapper.xml">cuiWrapper.xml</a>には簡単な書式の説明を行っていますので、そちらも参考にしてください。</p>\r
  52 \r
  53   <h3 class="file">cuiWrapper</h3>\r
  54   <p>コマンドラインベースの実行ファイルにコマンドラインを送信したり、出力を解析したりするTPIです。単に出力を読み込むだけでなく、OSの標準コマンドを利用してデータを加工することもできます。</p>\r
  55   <p>送信するコマンドラインや出力の解析方法については<a href="files.html#bin_lib_cuiWrapper.xml">cuiWrapper.xml</a>に記述されています。このファイルを編集することで、コマンドラインを変更したり、様々な実行ファイルに対応したりすることができます。</p>\r
  56 \r
  57   <h3 class="file_win">eggArc</h3>\r
  58   <p><a href="http://www.altools.co.kr/">ALZip</a>で作成されるegg書庫やalz書庫に対応するTPIです。</p>\r
  59   <p>動作には<a href="http://www.altools.co.kr/Product/ALZip_Intro8.aspx">UnEGG32.dll</a>が必要です。</p>\r
  60 \r
  61   <h3 class="file">rarArc</h3>\r
  62   <p><a href="http://www.rarlab.com/">WinRAR</a>などで作成されるrar書庫に対応するTPIです。</p>\r
  63   <p>動作には<span class="file_win">unrar.dll</span>か<span class="file_lin">libunrar.so</span>が必要です。Linuxでは、unrarsrc-xxx.tar.gzを入手し、makefile.unixの11行目を次のように修正し、次のコマンドを実行してください。</p>\r
  64   <div>\r
  65    修正前:<code>DEFINES=-D_FILE_OFFSET_BITS=64 -D_LARGEFILE_SOURCE</code>\r
  66    修正後:<code>DEFINES=-D_FILE_OFFSET_BITS=64 -D_LARGEFILE_SOURCE -DSILENT -O2</code>\r
  67    コマンド:<kbd>make -f makefile.unix lib</kbd>\r
  68   </div>\r
  69 \r
  70   <h3 class="file_win">spiLibrary</h3>\r
  71   <p><a href="http://www.digitalpad.co.jp/~takechin/">Susie</a>のPlug-inであるSPIに対応するTPIです。</p>\r
  72   <p>00AM形式のSPIにのみ対応しています。<a href="files.html#bin_lib">bin/lib</a>以下にSPIを配置することで認識します。</p>\r
  73   <p>なお、00IN形式のSPIについてはxpiLibraryで対応しています。</p>\r
  74 \r
  75   <h3 class="file_win">xpiLibrary</h3>\r
  76   <p>00IN形式のSPIと、<a href="http://www.asahi-net.or.jp/~kh4s-smz/">AtoB Converter</a>のPlug-inであるXPIに対応するTPIです。</p>\r
  77   <p>画像ファイルを書庫と同じように開き展開することで、SPIで対応している画像ファイルを、XPIで対応している形式に変換します。</p>\r
  78   <p>spiLibraryと同様に、<a href="files.html#bin_lib">bin/lib</a>以下にSPIやXPIを配置することで認識します。</p>\r
  79 \r
  80   <h2>Customize</h2>\r
  81   <h3>Lycheeの設定を変更する。</h3>\r
  82   <p><a href="files.html#bin_lychee.conf">confファイル</a>を編集することで動作を変更できます。</p>\r
  83 \r
  84   <h3>Lycheeを書庫に関連付ける。</h3>\r
  85   <h4>Windows</h4>\r
  86   <p><a href="files.html#bin_association-sample.reg">association-sample.reg</a>を参考にregファイルを編集し、実行してください。association-sample.regはあくまでもサンプルなので、決してそのまま実行しないでください。</p>\r
  87   <h4>Linux</h4>\r
  88   <p><a href="files.html#bin_lychee.desktop">lychee.desktop</a>を参考にdesktopファイルを編集し、~/.local/share/applications/(現在のユーザのみ)または/usr/share/applications/(全ユーザ)のいずれかにコピーしてください。その後、<kbd>update-desktop-database (コピー先フォルダ)</kbd>を実行してください。</p>\r
  89 \r
  90   <h3>LycheeのUIのデザインを変更する。</h3>\r
  91   <p><a href="files.html#share_ico">share/ico</a>以下の画像を差し替えることで、UIで使用するアイコンを変更できます。また、<a href="files.html#share_xrc">share/xrc</a>以下のXRCを編集することで、UIをさまざまに変更できます。</p>\r
  92 \r
  93   <h3>LycheeのUIのテキスト/言語を変更する。</h3>\r
  94   <p><a href="files.html#share_locale">share/locale</a>以下のpoファイルを編集し、moファイルを作成することでテキストを変更できます。また、<a href="files.html#share_locale_lychee.pot">share/locale/lychee.pot</a>から新たなmoファイルを作成することで、UIを別の言語に変更できます。</p>\r
  95 \r
  96   <h2>Tips/FAQ</h2>\r
  97   <h3>Inno Setupのインストーラを展開するには？</h3>\r
  98   <p>innounp.exeを用意した上で、ファイルの拡張子を'.inno'に変更してから開いてください。</p>\r
  99 \r
 100   <h3>Linux上でエラーが表示されて書庫が開けない。</h3>\r
 101   <p>「再配置後にセグメントprotをリストアできません: 許可がありません」あるいは「cannot restore segment prot after reloc: Permission denied.」というエラーの場合、SELinuxが問題の原因となっているようです。エラーが出る.soファイルに対して、<kbd>chcon -v -R -u system_u -r object_r -t textrel_shlib_t XXX.so</kbd>を実行してください。</p>\r
 102 \r
 103   <h2>Notes</h2>\r
 104   <p>LycheeはGNU LGPL 2.1の下で配布されています。再配布、改変などの条件については<a href="files.html#doc_license.txt">license.txt</a>を参照してください。また、Lycheeに使用されている画像は、Crystal Projectの画像を使用しています。Crystal Project はGNU LGPL 2.1で配布されている画像集で、<a href="http://www.everaldo.com/">Everaldo.com</a>から入手できます。</p>\r
 105   <p>Lycheeは正式版ではありません。未完成の部分や欠陥が存在することをご承知の上ご利用ください。また、Lycheeを使用したことにより生じたいかなる損害に対しても、開発者は一切の補償を致しません。しかしながら、バグや要望などが有りましたら、TPI Projectのウェブサイトもしくはメールにてご連絡いただければ対応するかもしれません。</p>\r
 106  </body>\r
 107 </html>