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    <li><a href="schema.xsd">XML spec</a></li>\r
  23    <li><a href="license.txt">License</a></li>\r
  24    <li><br /></li>\r
  25    <li>Readme:</li>\r
  26    <li><a href="#about">About</a></li>\r
  27    <li><a href="#feature">Feature</a></li>\r
  28    <li><a href="#tpi">TPI(s)</a></li>\r
  29    <li><a href="#customize">Customize</a></li>\r
  30    <li><a href="#tips">Tips/FAQ</a></li>\r
  31    <li><a href="#notes">Notes</a></li>\r
  32   </ul>\r
  33 \r
  34   <h2 id="about">About</h2>\r
  35   <p>Lycheeは、TPIという仕様に対応したプラグインを利用することでさまざまな書庫を操作することができるアーカイバです。Lycheeには、統合アーカイバDLLやSusie Plug-in(SPI)などに対応するTPIが同封されています。</p>\r
  36 \r
  37   <h2 id="feature">Feature</h2>\r
  38   <ul>\r
  39    <li>\r
  40     TPIによる書庫操作。\r
  41     <ul>\r
  42      <li>書庫の作成、ファイルの追加、展開、削除、検査、修復機能。</li>\r
  43      <li>書庫とSFXの相互変換機能。</li>\r
  44     </ul>\r
  45    </li>\r
  46    <li>wxWidgetsを採用することでWindows(32bit)/Linux(64bit)双方で動作。</li>\r
  47    <li>Unicodeへの対応。</li>\r
  48    <li>仮想リストビューを用いた高速動作。</li>\r
  49    <li>多言語対応UI。</li>\r
  50   </ul>\r
  51   <div>※但し、実際の動作はTPIの実装に依存します。</div>\r
  52 \r
  53   <h2 id="tpi">TPI(s)</h2>\r
  54   <h3 class="file">7zArc</h3>\r
  55   <p>7z,zip,NSIS,MSIなど、<a href="http://www.7-zip.org/">7-zip</a>で対応している諸形式の処理に対応するTPIです。</p>\r
  56   <p>動作には<span class="file_win">7z.dll</span>か<span class="file_lin">7z.so</span>が必要です。</p>\r
  57   <p>動作の設定については<a href="files.html#bin_lib_7zArc.xml">7zArc.xml</a>を参照してください。また、このファイルに記述することで7zArcで対応する形式を変更することができます。書式については<a href="files.html#doc_schema.xsd">schema.xsd</a>で説明を行っています。</p>\r
  58 \r
  59   <h3 class="file_win">calLibrary</h3>\r
  60   <p><a href="http://www.madobe.net/archiver/">統合アーカイバライブラリ</a>に対応するTPIです。統合アーカイバ仕様に従う一般的なライブラリに対応しています。</p>\r
  61   <p>対応しているライブラリについては<a href="files.html#bin_lib_calLibrary.xml">calLibrary.xml</a>を参照してください。また、このファイルに記述することで新たなライブラリに対応したり、ライブラリに送るコマンドラインを変更することができます。書式については<a href="files.html#doc_schema.xsd">schema.xsd</a>で説明を行っています。</p>\r
  62 \r
  63   <h3 class="file">cuiWrapper</h3>\r
  64   <p>コマンドラインベースの実行ファイルにコマンドラインを送信したり、出力を解析したりするTPIです。単に出力を読み込むだけでなく、OSの標準コマンドを利用してデータを加工することもできます。</p>\r
  65   <p>送信するコマンドラインや出力の解析方法については<a href="files.html#bin_lib_cuiWrapper.xml">cuiWrapper.xml</a>に記述されています。このファイルを編集することで、コマンドラインを変更したり、様々な実行ファイルに対応したりすることができます。書式については<a href="files.html#doc_schema.xsd">schema.xsd</a>で説明を行っています。</p>\r
  66 \r
  67   <h3 class="file_win">eggArc</h3>\r
  68   <p><a href="http://www.altools.co.kr/">ALZip</a>で作成されるegg書庫やalz書庫に対応するTPIです。</p>\r
  69   <p>動作には<a href="http://www.altools.co.kr/Product/ALZip_Intro8.aspx">UnEGG32.dll</a>が必要です。</p>\r
  70 \r
  71   <h3 class="file">rarArc</h3>\r
  72   <p><a href="http://www.rarlab.com/">WinRAR</a>などで作成されるrar書庫に対応するTPIです。</p>\r
  73   <p>動作には<span class="file_win">unrar.dll</span>か<span class="file_lin">libunrar.so</span>が必要です。Linuxでは、最新のunrarsrc-xxx.tar.gzを入手して次のコマンドを実行してください。</p>\r
  74   <div>\r
  75    <kbd>make -f makefile.unix lib</kbd>\r
  76   </div>\r
  77 \r
  78   <h3 class="file_win">spiLibrary</h3>\r
  79   <p><a href="http://www.digitalpad.co.jp/~takechin/">Susie</a>のPlug-inであるSPIに対応するTPIです。</p>\r
  80   <p>00AM形式のSPIにのみ対応しています。<a href="files.html#bin_lib">bin/lib</a>以下にSPIを配置することで認識します。</p>\r
  81   <p>なお、00IN形式のSPIについてはxpiLibraryで対応しています。</p>\r
  82 \r
  83   <h3 class="file_win">sqxArc</h3>\r
  84   <p><a href="http://www.speedproject.de/enu/">Squeeze</a>などで作成されるsqx書庫に対応するTPIです。</p>\r
  85   <p>動作には<span class="file_win"><a href="http://www.sqx-archiver.org/">sqx20u.dll</a></span>が必要です。</p>\r
  86 \r
  87   <h3 class="file_win">xpiLibrary</h3>\r
  88   <p>00IN形式のSPIと、<a href="http://www.asahi-net.or.jp/~kh4s-smz/">AtoB Converter</a>のPlug-inであるXPIに対応するTPIです。</p>\r
  89   <p>画像ファイルを書庫と同じように開き展開することで、SPIで対応している画像ファイルを、XPIで対応している形式に変換します。</p>\r
  90   <p>spiLibraryと同様に、<a href="files.html#bin_lib">bin/lib</a>以下にSPIやXPIを配置することで認識します。</p>\r
  91 \r
  92   <h2 id="customize">Customize</h2>\r
  93   <h3>Lycheeの設定を変更する。</h3>\r
  94   <p><a href="files.html#bin_lychee.conf">confファイル</a>を編集することで動作を変更できます。設定項目は次のとおりです。</p>\r
  95   <dl>\r
  96    <dt>Window-Height/Width</dt><dd>メインウインドウの高さと幅です。</dd>\r
  97    <dt>Window-X/Y</dt><dd>メインウインドウの横軸/縦軸方向の表示位置です。</dd>\r
  98    <dt>Window-SplitterPos</dt><dd>メインウインドウのツリービューの幅です。</dd>\r
  99    <dt>Window-StatusBar/ToolBar</dt><dd>ステータスバー/ツールバーを表示する場合は1を、表示しない場合は0です。</dd>\r
 100    <dt>ListView-ShowMode</dt><dd>リストビューの表示形式です。</dd>\r
 101    <dt>ListView-C-*</dt><dd>リストビューの各列の幅です。</dd>\r
 102    <dt>ListView-SortColumn</dt><dd>リストビューでソート対象となる列です。</dd>\r
 103    <dt>ListView-SortAscend</dt><dd>リストビューで昇順ソートを行うなら1、降順ソートを行うなら0です。</dd>\r
 104    <dt>DefaultExt</dt><dd>書庫内のファイルを開く際、関連付けが見つからなかった場合にここで指定された拡張子とみなしてファイルを開きます。</dd>\r
 105    <dt>DefaultPath</dt><dd>書庫を作成/展開する際、デフォルトの処理先としてパスを登録できます。</dd>\r
 106    <dt>History-PathN/NameN/FullN</dt><dd>N回前に開いた書庫のパス/ファイル名/フルパスです。</dd>\r
 107    <dt>History-Count</dt><dd>履歴の保存数です。</dd>\r
 108    <dt>Process-Dialog</dt><dd>処理中に専用のダイアログを表示する場合は1を指定します。</dd>\r
 109   </dl>\r
 110 \r
 111   <h3>Lycheeを書庫に関連付ける。</h3>\r
 112   <h4>Windows</h4>\r
 113   <p><a href="files.html#bin_association-sample.reg">association-sample.reg</a>を参考にregファイルを編集し、実行してください。association-sample.regはあくまでもサンプルなので、決してそのまま実行しないでください。</p>\r
 114   <h4>Linux</h4>\r
 115   <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
 116 \r
 117   <h3>LycheeのUIのデザインを変更する。</h3>\r
 118   <p><a href="files.html#share_ico">share/ico</a>以下の画像を差し替えることで、UIで使用するアイコンを変更できます。また、<a href="files.html#share_xrc">share/xrc</a>以下のXRCを編集することで、UIをさまざまに変更できます。</p>\r
 119 \r
 120   <h3>LycheeのUIのテキスト/言語を変更する。</h3>\r
 121   <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
 122 \r
 123   <h2 id="tips">Tips/FAQ</h2>\r
 124   <h3>Inno Setupのインストーラを展開するには？</h3>\r
 125   <p>innounp.exeを用意した上で、ファイルの拡張子を'.inno'に変更してから開いてください。</p>\r
 126 \r
 127   <h3>Linux上でエラーが表示されて書庫が開けない。</h3>\r
 128   <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
 129 \r
 130   <h2 id="notes">Notes</h2>\r
 131   <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
 132   <p>Lycheeは正式版ではありません。未完成の部分や欠陥が存在することをご承知の上ご利用ください。また、Lycheeを使用したことにより生じたいかなる損害に対しても、開発者は一切の補償を致しません。しかしながら、バグや要望などが有りましたら、TPI Projectのウェブサイトもしくはメールにてご連絡いただければ対応するかもしれません。</p>\r
 133  </body>\r
 134 </html>