View source for Help:プロパティと型

{{SMW user TOC (ja)}}

'''プロパティと型''' は、[[Semantic MediaWiki - cover page (ja)|Semantic MediaWiki]] で意味的データを入力するための基礎となります。 プロパティは 《Wiki ページ中の値用のカテゴリ》 とよく似ており、[[MediaWiki (ja)|MediaWiki]] におけるリンクによく似た構文の簡単なタグによって記述されます：

: <tt><nowiki>[[</nowiki>''プロパティ名''::''値''<nowiki>]]</nowiki></tt>

この命令文は、<tt>''プロパティ名''</tt> で与えられるプロパティの <tt>''値''</tt> を定義します。 この命令文が記述されたページでは <tt>''値''</tt> テキストのみが表示され、プロパティ指定部分は表示されません。

記事中に記述されているリンクは、このようにプロパティ情報を付加するだけで、簡単に高機能化 （意味化） できます。 その他の '''データ型''' （数値や日付など） の記述を注釈するためには、ちょっとした編集手順が必要となります。

== リンクをプロパティに置き換える<span id="Turning links into properties"></span> ==

ウィキペディアの [[wp:Berlin|ベルリン]] に関する記事について考えて見ましょう。 この記事には他の記事へのリンク （例えば 《ドイツ》、《欧州連合》、《米国》 など） が多数記載されています。 しかしその中でも、《ドイツ》 へのリンクには特別な意味があります。 ベルリンはドイツの首都であるが故に、このリンクがここに置かれているのです。 この知識をコンピュータが活用できるように、この記事テキストのリンク

 <nowiki>[[ドイツ]]</nowiki>

に <タグ> をつけて、《首都属性》 を有するリンクであることを識別できるようにしたいですね。 Semantic MediaWiki でこれを行うには、カッコ内部のリンクテキストの前に、プロパティ名と '''::''' を配置します。

 <nowiki>[[Is capital of::ドイツ]]</nowiki>

この記事では、上記のテキストは元と同じく 《ドイツ》 への単純なハイパーリンクとして表示されています。 付加されたテキスト <tt>capital of</tt> はドイツへのリンクを分類する '''プロパティ''' の名称です。 カテゴリの場合と同様に、ユーザは任意のプロパティ名を使用できますが、Wiki のどこかで既に使用されているプロパティを再利用可能ならそうすべきです。

この再利用を行いやすくするために、各カテゴリがそれぞれ専用の記事ページを持っているのと同様に、全てのプロパティは自分用の記事ページを持ちます。 Wiki で使用されている全てのプロパティは [[Special:Properties]] （[[Special:Properties|全てのプロパティ]]） で確認できます。 カテゴリ記事には接頭辞 <tt>Category:</tt> が付くのと同様に、プロパティ記事を他の記事と区別するために接頭辞 <tt>Property:</tt> が付きます。 従って MediaWiki 標準機能の [[Special:Search]] （[[Special:Search|検索]]） を使用しても既存のプロパティを探すことができます。 カテゴリと同様、プロパティも記事ページを空白のままとすることは可能ですが、プロパティの使用目的と正しい使用方法の記載することを強く推奨します。

ページにプロパティを追加する方法は他にもたくさんあります:

{| border="1" cellpadding="2" cellspacing="0"
 ! 出力 
 ! 記述内容
 |-
 | プロパティ "属性見本" により [[リンク]] を分類する。
 | <pre><nowiki>プロパティ "属性見本" により [[属性見本::リンク]] を分類する。</nowiki></pre>
 |-
 | リンクの代わりに [[リンク|代替テキスト]] が表示されるようにする。
 | <pre><nowiki>リンクの代わりに [[属性見本::リンク|代替テキスト]] が表示されるようにする。</nowiki></pre>
 |-
 | 代替テキストに空白を使用してプロパティ [[リンク| ]] を完全に隠す。
 | <pre><nowiki>代替テキストに空白を使用してプロパティ [[属性見本::リンク| ]] を完全に隠す。</nowiki></pre>

'''備考:''' <nowiki>|</nowiki> の後ろの空白は必要です。 もし取り去ってしまうと MediaWiki [[wp:Help:Pipe trick|パイプトリック]] が働きますが、期待した効果が得られることは希です。 空白があっても SMW は何も出力しません。 これはほとんどの場合に期待される出力といえます （空白を出力させるためには、空白文字に <tt>&amp;nbsp;</tt> を使用してください）。
 |-
 | テキストに :: を含む通常リンクで、プロパティを作らないためには、前にコロンをつけてタグをエスケープします。<br />例: [[:C++ :: 演算子]]
 | <pre><nowiki>例: [[:C++ :: 演算子]]</nowiki></pre>
 |-
 | 一つの値を複数のプロパティに割り当てるには、プロパティ名の間に :: を挿入します。<br />例: [[リンク]] 
 | <pre><nowiki>例: [[属性1::属性2::リンク]]</nowiki></pre>
|}

== テキストの値をプロパティに置き換える<span id="Turning values in text into properties"></span> ==

Wiki 記事には、他の記事へのリンクの他にも、有用な情報がたくさんあります。 例えば、[[Berlin|ベルリン]] の記事には、人口数の記述があります。 この知識をコンピュータプログラムで処理可能にするには、記事中のテキスト

 3,396,990 

に、この数値が "人口プロパティ" の値であることを示す "タグ" を付加するとよいですね。 Semantic MediaWiki ではこのタグとして、テキストの前にプロパティ名と '''::''' を記述して <nowiki>[[ ]]</nowiki> 括弧で囲みます。 すなわち以下のように記述します:

 <nowiki>[[population::3,396,990]].</nowiki>

これでタグが動作します。 しかしながら、上記のタグはページ ''3,396,990'' へのリンクとして表示されてしまいます。 全ての人口数が専用記事を持つのは、ちょっと変ですね。
また、人口順に並べ替えたドイツの都市一覧を作成したい場合、このままでは記事名のアルファベット順でソートされてしまい、数値順にはなりません。例えばアルファベット順では、"1,000,000" の後に "345" が来てしまいます。  以上の問題を解決するには、"population" が数値であり、Wiki ページへのリンクではないことを Semantic MediaWiki に教えてやればよいわけです。 これは "population" プロパティに "型" を指定することで行います。 その詳細については次のセクションで説明します。

== プロパティのデータ型<span id="Data types for properties"></span> ==

Semantic MediaWiki には、プロパティに使用する組み込み ''データ型'' がいくつかあります。 前述の人口の例では、最もふさわしい型は [[Help:Type Number|Number]] です。 この前置子 "Type:" も "Property:" と同様に、通常記事と異なり、型に関して記述した記事であることを明示する名前空間識別子です。 さてここで我々は "population" に、このプロパティが "Type:Number" を持つことを示す特別なプロパティを設定したいわけです。 この機能をサポートするために Semantic MediaWiki には、[[Property:Has type]] という特別プロパティが組み込まれています。 この特別プロパティを記述する構文は他の通常のプロパティと同様で、Property:Population 記事に以下のように記述します:

 <nowiki>[[Has type::number]]</nowiki>

（ここでは Type: 名前空間を指定する必要はありません。）

Semantic MediaWiki は [[Property:has type]] のような ''特別プロパティ'' がいくつあるか知っています。 Wiki にこれらのプロパティの専用記事があるかどうかにかかわらず、これらのプロパティは既定の意味を持っていて、他のプロパティと同様に評価されます。

データ型はプロパティを評価する上で非常に重要です。 第 1 に、データ型はツールが与えられた値をどのように処理すべきかを指定します。 例えば、検索結果での値の表示方法やソート方法などに関してです。 第 2 に、データ型はどの値が同じ意味をもつか知るために必要です。 例えば、値 "1532” と "1,532”、"1.532e3" は全て同じ値にエンコードされます。 最後に、いくつかのデータ型は、以下に示す特別な挙動を示します。 これらの理由により、全てのプロパティはデータ型を指定した上で使用されるべきなのです。

前述の "capital of" プロパティにデータ型を設定していない理由は、既定のデータ型が [[Help:Type Page|Page]] であり、そのままでリンクとして表示されるためです。 しかしたとえ Type:Page が既定値であっても、将来既定値が別のデータ型に変更される場合や、単にユーザの混乱を防ぐためにも、全てのプロパティにデータ型を明示指定すべきでしょう。

ページリンクで使用したプロパティタグは、他のデータ型においても同様に使用できます。 以下に例をいくつか示します。

{| border="1" cellpadding="2" cellspacing="0"
 ! 目的 
 ! 記述内容
 |-
 | プロパティ "example" に値 1,234,567 を指定する。
 | <pre><nowiki>このページには "example" の値 [[example::1,234,567]] があります。"</nowiki></pre>
 |-
 | 数値を指定するが、記事には別のテキストを表示する。
 | <pre><nowiki>このページには "example" の値 [[example::999,331|約 100 万]] があります。</nowiki></pre>
 |-
 | プロパティ記事でデータ型を指定する。例: このプロパティは [[Help:Type Number|Number]] 型です。
 | <pre><nowiki>このプロパティは [[has type::number]] 型です。</nowiki></pre>
 |- 
 | プロパティ値に MediaWiki タグを使用する。 例: ジョンのユーザ名は [mailto:john@example.com john] です。 ''これは推奨されません。 [[Help:Semantic templates|テンプレートを]] を代用すべきです。''
 | <pre><nowiki>ジョンのユーザ名は [[username::john|[mailto:john@example.com john]]] です。</nowiki></pre>
|}

=== データ型の一覧<span id="List of data types "></span> ===

プロパティを型で区別することで、プロパティは全く異なる種類の値を表すことができます。 使用可能な全ての型の一覧は [[Special:Types]] （[[Special:Types|型]]） にあります。 使用可能な型は以下の通りです:

{{documentation itemlist/begin}}
{{documentation itemlist
| name = [[Help:Type Page]]
| desc = ページへのリンク （既定）。
}}
{{documentation itemlist
| name = [[Help:Type String]]
| desc = 255 文字以下のテキスト文字列。
}}
{{documentation itemlist
| name = [[Help:Type Number]]
| desc = 整数および十進数 （指数表現も可）。
}}
{{documentation itemlist
| name = [[Help:Type Boolean]]
| desc = プロパティ値は true/false （もしくは 1/0 または yes/no） に制限される。
}}
{{documentation itemlist
| name = [[Help:Type Date]]
| desc = 時刻 （時間中の指定する時点）。
}}
{{documentation itemlist
| name = [[Help:Type Text]]
| desc = Type:String と同様だが、文字長が制限されない。 その代わり、この型の値をキーにしてクエリで選択したり、ソートできない。
}}
{{documentation itemlist
| name = [[Help:Type Code]]
| desc = Type:Text と同様だが、技術文書に使用される特殊な書式が維持されるよう配慮される。 その他の表示場所 （クエリ結果、概括ボックス、"このプロパティを使用するページ" 等） では、通常のテキストと同様に表示される。
}}
{{documentation itemlist
| name = [[Help:Type Temperature]]
| desc = Type:Number の応用型で、温度単位がサポートされる （温度の変換は単なる乗数変換より多少複雑なため、ユーザが型を作成することはできない）。
}}
{{documentation itemlist
| name = [[Help:Type Telephone number]]
| desc = [http://www.ietf.org/rfc/rfc3966.txt RFC 3966] 標準に基いて国際電話番号を検証し、保存する。
}}
{{documentation itemlist
| name = [[Help:Type Record]]
| desc = 決まった型と順序で記述された、値の短い一覧からなる複合プロパティ値を示す型
}}
{{documentation itemlist/end}}

URL と E メールアドレスを指定するための、特別な文字列型の応用型がいくつかあります:
{{documentation itemlist/begin}}
{{documentation itemlist
| name = [[Help:Type URL]]
| desc = 指定する URL オブジェクトへの外部リンクを表示します。
}}
{{documentation itemlist
| name = [[Help:Type Email]]
| desc = E メールアドレスをリンクとして表示します （<nowiki>mailto:</nowiki> が付加されます）。
}}
{{documentation itemlist
| name = [[Help:Type Annotation URI]]
| desc = Type:URL と同様ですが、SMW の [[Help:RDF export|RDF エクスポート]] 時の処理に違いがあります。
}}
{{documentation itemlist/end}}

いくつかの機能拡張はデータ型を追加します:
{{documentation itemlist/begin}}
{{documentation itemlist
| name = [[Help:Type Geographic coordinate]]<br />(provided by [[Extension:Maps|Maps (formerly Semantic Maps)]])
| desc = 経緯度を記述します。 複数の経緯度書式がサポートされます。
}}
{{documentation itemlist/end}}

=== 一覧表と "Allows value"<span id="Enumerations and &quote;Allows value&quote;"></span> ===

SMW には "列挙型"、すなわち取り得る値の有限集合を持つデータ型はありません。 その代わりどのプロパティにおいても、特別プロパティ [[Property:Allows value]] を使用して許可値を列挙することで、取り得る値を限定することができます。 この機能は全てのデータ型で動作します。

=== 単位<span id="Units"></span> ===

[[Help:Type Number|数値型]] では数値の後に単位を記述して、値を区別することができます （例: "30.3 mpg" と "47 km/liter" は区別されます）が、これらを換算することはできません。 複数の単位書式および自動換算をサポートするには、
[[Help:Custom units|追加単位]] を持つ独自のデータ型を定義します。 この追加データ型では、標準表記された値を相互に自動的に換算できます。 従ってユーザは、各記事やクエリでそれぞれ指定された単位に揃えたり、他の記事のプロパティ値を比較する作業から開放されます。

== 特別プロパティ<span id="Special properties"></span> ==

本ページでは、プロパティのデータ型を定義する特別プロパティ [[Property:Has type]] について既に言及しました。 SMW には他にも、特別な意味を持つ定義済み特別プロパティがあります （Wiki 上にこれらのプロパティ用のプロパティページが作成されていなくても、です）。 これらの名前をプロパティ名として使用することは ''できません'' が、[[SMW 1.4.0]] より閲覧ツールおよびクエリツールでこれらの名前を他のプロパティ名と同様に使用できるようになりました。 より詳細な情報については [[:Category:Special property]] および左記中の個々のプロパティページを参照してください。

== #set を使用した非表示注釈<span id="Silent annotations using #set"></span> ==
通常の二重大括弧タグを使用する代わりに、#set パーサ関数を使用しても意味的データを定義できます。 この関数は、一組のプロパティ名と値を受け取って意味的データとして保存しますが、画面には何も表示しません。 例えば以下のようになります:

<pre>{{#set:Has population=3,396,990|Has country=Germany}}</pre>

<nowiki>#</nowiki>set 呼び出しは、Wiki リンク等の大括弧の中にある文字列やテキスト値を保存したい場合に特に有効です。 この場合には、通常の SMW タグは動作しないことが多々あります。

== 反復イベントの定義<span id="Defining recurring events"></span> ==

別の複合型として、反復イベント型があります。 これは、あらかじめ指定された規則 （週例会議等） に従って定められる、複数日時を持つイベントを示します。 これらのプロパティの値は #set_recurring_event パーサ関数を使用して定義します。 この関数は #set と同じ "沈黙" 関数で、画面に何も表示しません。 この関数の呼び出し方法の例は以下の通りです:

<pre>{{#set_recurring_event:property=Has date|start=January 4, 2010|end=June 8, 2011
|unit=week|period=1|include=March 16, 2010;March 23, 2010|exclude=March 15, 2010;March 22, 2010}}</pre>

より詳細な情報に関しては [[Help:Recurring events]] を参照してください。

== 旧バージョンでの取り扱い<span id="Handling in earlier versions"></span> ==

SMW の初期バージョンでは、[[Help:Type Page|Page]] 型プロパティは ''関係'' と呼び、この型のプロパティのみプロパティ名をリンク文字列を二重コロン （<tt>::</tt>） で区切る構文を使用していました。 他のプロパティ （数値、文字列等） は ''属性'' と呼び、コロン等号 （<tt>:=</tt>） で区切っていました。

SMW 1.0 における他の変更点については、[[Help:Upgrading from 0.7 to 1.0|Upgrading from SMW 0.7 to SMW 1.0]] を参照してください。 SMW の初期バージョンを現在でも使用している場合は、バージョン 0.7 での注釈について説明する文書として [[semweb:Help:Annotation (SMW0.7)]] を参照してください。 

{{docinfo
| master page = Help:Properties and types
| master rev  = 8222
| master link = internal
| status   = effective
| progress = 100
| priority = 2
| category =
| author = Dick6809
| editor = {{REVISIONUSER}}
| support = Dick6809
| minversion = 1.5.0
| lang = ja
| desc = A Japanese translation of [[Help:Properties and types]].
| return =
| nowarn
}}