Update userguide

This commit is contained in:
autonielx
2014-04-05 18:48:32 +02:00
parent 1dc78b8c1e
commit e795d95872
636 changed files with 6411 additions and 3537 deletions
+19 -19
View File
@@ -59,33 +59,33 @@
<h1>属性</h1>
<p>属性 (Attribute) とは、ファイルに属するけれどもそのファイルの一部ではないデータフィールドのことです。たとえば、属性はファイルサイズの計算には含まれませんが、属性をコピーしたり、ファイル自体に触れることなく属性に変更を加えたりできます。システムはこれら属性をファイルサイズやファイルタイプ、ファイルが最後に変更された日付などを保存するのに使用します。この仕組みはほかのオペレーティングシステムやそのファイルシステムと似ています。</p>
<p>ほかのオペレーティングシステムとの違いは、任意のファイルに対して任意の種類の属性を追加できること、および、Tracker ウィンドウの中でその属性表示したり編集したりすることが可能であることです。必要なことはファイルタイプに追加する属性の種類 (文字列や整数値、時刻など) を定義し、属性に名前と説明を付けることだけです。</p>
<p>ファイルそのものは中身を含んでいる必要すらまったくありません。たとえば、次の People ファイルをご覧ください:</p>
<p>属性 (Attribute) とは、ファイルに属するけれどもそのファイルの一部ではないデータフィールドです。たとえば、属性はファイルサイズの計算には含まれませんが、属性をコピーしたり、ファイル自体に触れることなく属性に変更を加えたりできます。システムはこれら属性をファイルサイズやファイルタイプ、ファイルが最後に変更された日付などを保存するのに使用します。この仕組みはほかのオペレーティングシステムやそのファイルシステムと似ています。</p>
<p>ほかのオペレーティングシステムとの違いは、任意のファイルに対して任意の種類の属性を追加できること、および、Tracker ウィンドウの中でその属性表示または編集ができることです。必要なことはファイルタイプに追加する属性の種類 (文字列や整数値、時刻など) を定義し、属性に名前と説明を付けることだけです。</p>
<p>ファイルそのものは中身がある必要すらまったくありません。たとえば、次の People ファイルを見てください</p>
<img src="images/attributes-images/people.png" alt="people.png" />
<br />
<p>ご覧のとおり、これらはすべて属性が付与された大きさが 0 のファイルです。Tracker ウィンドウの右側で、"John Nox" の電子メール属性を編集中です。</p>
<p>People ファイル、電子メールファイル、または音声ファイルがデフォルトでそうしているように、これら属性をインデックス化することにより、Haiku の高速クエリシステムを使用して属性を検索することもできます。</p>
<p>見てのとおり、これらはすべて属性が付与された大きさが 0 のファイルです。Tracker ウィンドウの右側で、"John Nox" のメール属性を編集中です。</p>
<p>People ファイル、メールファイル、または音声ファイルがデフォルトでそうしているように、これら属性をインデックス化すれば、Haiku の高速クエリシステムを使て属性を検索できるようになります。</p>
<h2>
<a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="attributes-tracker" name="attributes-tracker">Tracker における属性</a></h2>
<p>属性はデータベースやスプレッドシートと非常によく似た形で表示されます。Tracker を使うことで、どの属性 (列) を表示するのか選択したり、属性にってファイルリストの順番 (行) 並べ替えたりできます。</p>
<p>Tracker で属性を操作するには、Tracker ウィンドウを開いて<span class="menu">属性 (Attributes)</span>メニューをクリックし、表示したい属性を選択します。あるいは単純に列見出しを右クリックし、コンテキストメニューで該当する項目をマークします。また、列見出しをドラッグ&ドロップするだけで、列を再配置できます。列をウィンドウの外に移動させることにより、不要な列をすばやく取り除けます。</p>
<a id="attributes-tracker" name="attributes-tracker">Tracker での属性</a></h2>
<p>属性はデータベースやスプレッドシートと非常によく似た形で表示されます。Tracker を使うことで、どの属性 (列) を表示するのか選択、属性にしたがってファイルリストの順番 (行) 並べ替えできます。</p>
<p>Tracker で属性を操作するには、Tracker ウィンドウを開いて<span class="menu">属性 (Attributes) </span>メニューをクリックし、表示したい属性を選択します。あるいは単純に列見出しを右クリックし、コンテキストメニューで該当する項目をマークします。また、列見出しをドラッグ&ドロップするだけで、列を再配置できます。列をウィンドウの外に移動させることにより、不要な列をすばやく取り除けます。</p>
<p>列見出し中の 2 つの属性の間の線をダブルクリックすると、列幅が自動的に適切なサイズに調整されます。</p>
<p>列見出しをクリックすると、ソートの順序が昇順から降順へ切り替わります。<span class="key">SHIFT</span> を押しながら列見出しをクリックすることで、2 番目のソート順序を決めることができます。たとえば、1 番目のソート順序を会社名、2 番目のソート順序をコンタクト名にして People ファイルを並べ替えることができます。例として上のスクリーンショットをご覧ください。2 番目のソート順序は、列見出しすぐそばの、1 番目のソート順序よりも明るい色の目印でマークされています。</p>
<p>列見出しをクリックすると、並び替えの順序が昇順から降順へ切り替わります。<span class="key">SHIFT</span> を押しながら列見出しをクリックすることで、2 番目の並び替え順を決められます。たとえば、1 番目の並び替え順を会社名、2 番目の並び替え順をコンタクト名にして People ファイルを並べ替えられます。例として上のスクリーンショットを見てください。2 番目の並び替え順は、列見出しすぐそばの、1 番目の並び替え順よりも明るい色の目印でマークされています。</p>
<p>これら属性の編集はファイルのリネームと同様にシンプルです: 項目をクリックするか、<span class="key">ALT</span> <span class="key">E</span> を押します。属性間の移動は <span class="key">TAB</span> および <span class="key">SHIFT</span> <span class="key">TAB</span> で行います。変更を適応せずに編集モードを抜けるには <span class="key">ESC</span> を押します。</p>
<h2>
<a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="attributes-terminal" name="attributes-terminal">ターミナルにおける属性</a></h2>
<a id="attributes-terminal" name="attributes-terminal">ターミナルでの属性</a></h2>
<p>コマンドラインがお好みの場合やスクリプトを使って大量のファイルを処理しようという場合に備えて、ターミナルから属性を制御できるコマンドがいくつか用意されています。</p>
<h3>
<a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="listattr" name="listattr">listattr</a></h3>
<p><span class="cli">listattr</span>個々のファイルの属性一覧表示します。属性の中身については表示しません。</p>
<p><span class="cli">listattr</span> はファイルの属性一覧表示します。属性の内容については表示しません。</p>
<pre>使い方: listattr 'filename' ['filename' ...]</pre>
<p>上のスクリーンショットの例です:
<p>上のスクリーンショットの例です
</p>
<pre class="terminal"> ~/people -&gt;listattr Clara\ Botters
File: Clara Botters
@@ -112,7 +112,7 @@ MIME String 21 "BEOS:TYPE"
Raw Data 20 "_trk/pinfo_le"
131 bytes total in attributes.</pre>
<p>コンタクト情報を保持しているすべての "<tt>META:*</tt>" 属性に加えて、システムによって管理されている次の 2 つの属性が存在します:</p>
<p>コンタクト情報を保持しているすべての "<tt>META:*</tt>" 属性に加えて、システムによって管理されている次の 2 つの属性が存在します</p>
<ul>
<li><p><tt>BEOS:TYPE</tt><acronym title="Multipurpose Internet Mail Extensions">MIME</acronym> 文字列としてファイルタイプを保持しています。この例では "<tt>application/x-person</tt>" です。この属性によりデフォルトのアイコンやファイルをダブルクリックしたときなどにそのファイルを開くアプリケーションが決まります。</p></li>
<li><p>"<tt>_trk/pinfo_le</tt>" は Tracker がファイルのアイコンの位置を記録するために使用する属性です。</p></li></ul>
@@ -123,14 +123,14 @@ MIME String 21 "BEOS:TYPE"
<a id="catattr" name="catattr">catattr</a></h3>
<p><span class="cli">catattr</span> はファイルの指定された属性の内容を表示します。</p>
<pre>使い方: catattr [--raw|-r] attr_name file1 [file2...]</pre>
<p>先のファイルを再例にします:</p>
<p>先のファイルを再例にします</p>
<pre class="terminal"> ~/people -&gt;catattr META:city Clara\ Botters
Clara Botters : string : Whelton</pre>
<h3>
<a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="addattr" name="addattr">addattr</a></h3>
<p><span class="cli">addattr</span> はファイルに属性を追加します。同時に属性の内容を埋めることもできます。</p>
<p><span class="cli">addattr</span> はファイルに属性を追加します。同時に属性の内容を入力することもできます。</p>
<pre>使い方: addattr [-t type] attr value file1 [file2...]
または: addattr [-f value-from-file] [-t type] attr file1 [file2...]
@@ -138,7 +138,7 @@ Clara Botters : string : Whelton</pre>
string, mime, int, llong, float, double, bool, icon, raw
または数値です (例: 0x1234, 42, 'ABCD', ...)
デフォルトは "string" です。</pre>
<p>ではここで、親友の Clara が多国籍企業である Barkelbaer 社で働くことになりました。これまで空であった "Company" 属性 (「文字列」型) をその情報で埋めましょう:</p>
<p>ではここで、親友の Clara が多国籍企業 Barkelbaer 社で働くことになりました。これまで空った "Company" 属性 (「文字列」型) をその情報で入力しましょう</p>
<pre class="terminal"> ~/people -&gt;addattr -t string META:company Barkelbaer\ Inc. Clara\ Botters</pre>
<h3>
@@ -149,16 +149,16 @@ Clara Botters : string : Whelton</pre>
<pre>使い方: rmattr [-p] attr filename1 [filename2...]
'attr' はそのファイル属性の名前です。
'-p' が指定されると、'attr' はパターンとみなされます。</pre>
<p>実用的な観点から見れば、単に "Fax" 属性の内容を埋めないことで十分対応できますが、次のようにタイプすることにより、Clara ファイルから "Fax" 属性を完全に削除できます:</p>
<p>実用的な観点から見れば、単に "Fax" 属性の内容を入力しないことで十分対応できますが、次のようにタイプする、Clara ファイルから "Fax" 属性を完全に削除できます</p>
<pre class="terminal"> ~/people -&gt;rmattr META:fax Clara\ Botters</pre>
<h3>
<a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
<a id="copyattr" name="copyattr">copyattr</a></h3>
<p><span class="cli">copyattr</span> は 1 つ以上のファイルの属性を、ほかのファイルにコピーします。デフォルトでは実際のファイルの中身については<b>コピーされません</b></p>
<p><span class="cli">copyattr</span> は 1 つまたは複数のファイルの属性を、ほかのファイルにコピーします。デフォルトでは実際のファイルの内容については<b>コピーされません</b></p>
<pre>使い方: copyattr &lt;options&gt; &lt;source&gt; [ ... ] &lt;destination&gt;</pre>
<p>属性に加えてファイルの中身そのものもコピーしたい場合は、"<span class="cli">-d</span>" または "<span class="cli">--data</span>" オプションを追加します。</p>
<p>属性に加えてファイルの内容そのものもコピーしたい場合は、"<span class="cli">-d</span>" または "<span class="cli">--data</span>" オプションを追加します。</p>
<p><br /></p>
<p>以上のコマンドに関する情報や各コマンドのオプションに関する情報は、コマンド名のうしろに "<span class="cli">-h</span>" または "<span class="cli">--help</span>" を続けてタイプすることにより見られます。</p>