Guides and Sample Code

Developer

Playground Book Format Reference

On This Page

Glossary Property List
グロッサリープロパティリスト

The optional glossary property list contains key-value pairs defining the terms for the glossary of a book. The property list file is called Glossary.plist and is located in the PrivateResources folder of the book at the path:
随意であるグロッサリープロパティリストは、あるブックのグロッサリーのための用語を定義するキー値ペアを含んでいます。プロパティリストファイルは、Glossary.plistと呼ばれます、そしてブックのPrivateResourcesフォルダに以下のパスで位置します:

<book name>.playgroundbook/Contents/PrivateResources/Glossary.plist

Adding a Glossary.plist file to a book adds the Glossary of Terms menu item to the Tools menu. The entry for each glossary term has three parts, as shown in Figure 13-1:
Glossary.plistファイルをブックに加えると、Glossary of TermsメニューがToolsメニューに追加されます。各グロッサリー用語のための登録項目は、図 13-1で示されるように、3つの部分を持ちます:

  • Term: The concept defined by the glossary entry.
    用語:グロッサリー登録項目によって定義される概念。

  • Definition: The definition of the term.
    定義:用語の定義。

  • First-use link: A reference to the playground page introducing the term.
    「使い始め」リンク:その用語を取り入れているプレイグラウンドページへの参照。

Figure 13-1Glossary term
図 13-1 グロッサリー用語
image: ../Art/SP_glossary_entry_2x.png

Key List
キーのリスト

Table 13-1 describes each top-level key in the glossary property list, its type, and whether the key is required.
表 13-1 は、グロッサリープロパティリストでの各トップレベルキー、そしてそのキーが必須かどうかを記述します。

Table 13-1Glossary property list keys
表 13-1 グロッサリープロパティリストキー

Key
キー

Type

Description
説明

Required
必須

Terms

Dictionary

A dictionary of glossary term dictionaries. See Terms Key.
いくらかのグロッサリー用語ディクショナリからなるあるディクショナリ。Termsキーを見てください。

Term Name
用語名

Dictionary

The name of the concept described by the term dictionary. See Term Name Key.
用語ディクショナリによって記述される概念の名前。用語名キーを見てください。

Terms Key
Termsキー

A dictionary of dictionaries. Each dictionary in the Terms dictionary describes a glossary term. The key name for a term dictionary is the glossary term itself.
いくらかのディクショナリからなるあるディクショナリTermsディクショナリの中の各ディクショナリは、1つのグロッサリー用語を記述します。ある用語ディクショナリのためのキー名は、グロッサリー用語それ自身です。

Figure 13-2 shows some of the glossary terms from Learn to Code 1, such as algorithm, arithmetic operator, and argument.
図 13-2 は、「Learn to Code 1」からいくつかのグロッサリー用語を示します、例えばalgorithmarithmetic operator、そしてargumentなど。

Figure 13-2Glossary term names
図 13-2 グロッサリー用語名
image: ../Art/SP_glossary_term_name_2x.png

Term Name Key
用語名キー

A dictionary defining a glossary term. The name of the key for the dictionary is used as the display name for the term in the full glossary and in the glossary term popover. Term name keys can contain spaces. Each term dictionary contains the definition of the term and an optional dictionary defining a link to the first use of the term.
グロッサリー用語を定義しているディクショナリ。ディクショナリのためのキーの名前は、完全なグロッサリーにおけるそしてグロッサリー用語ポップオーバーにおける用語のディスプレイ名が使われます。用語名キーは空白を含むことができます。各用語ディクショナリは、用語の定義と、用語の「使い始め」へのリンクを定義している任意のディクショナリを1つ含みます。

Table 13-2 describes each key for a term dictionary, its type, and whether the key is required.
表 13-2 は、用語ディクショナリのための各キー、それの型、そしてそのキーが必須かどうかを記述します。

Table 13-2Term dictionary keys
表 13-2 用語ディクショナリキー

Key
キー

Type

Description
説明

Required
必須

Definition

String

The definition for the glossary term. See Definition Key.
グロッサリー用語のための定義。Definitionキーを見てください。

FirstUse

Dictionary

A dictionary defining a link to the page where the term is first used. See FirstUse Key.
用語が最初に使われるところのページへのリンクを定義するディクショナリ。FirstUseキーを見てください。

  

Title

String

The title used for the glossary term. See Title Key.
グロッサリー用語のために使われるタイトル。Titleキーを見てください。

  

Definition Key
Definitionキー

The definition for the glossary term, as a string. The definition is displayed in the full glossary and in the glossary term popover.
グロッサリー用語のための定義、文字列として。定義は、完全なグロッサリーでおよびグロッサリー用語ポップオーバーで定義として表示されます。

FirstUse Key
FirstUseキー

A dictionary that defines a link and title for the first use of a glossary term.
あるグロッサリー用語の「使い始め」に対するリンクとタイトルを定義するディクショナリ。

Table 13-3 describes each key for the FirstUse dictionary, its type, and whether the key is required.
表 13-3 は、FirstUseディクショナリに対する各キー、それの型、そしてそのキーが必須かどうかを記述します。

Table 13-3First use dictionary keys
表 13-3 「使い始め」ディクショナリのキー

Key
キー

Type

Description
説明

Required
必須

PageReference

String

The path to the page where the term is first used. See PageReference Key.
用語が最初に使われるところのページへのバス。PageReferenceキーを見てください。

Title

String

The title shown in the glossary as the first-use link. See Title Key.
グロッサリーにおいて「使い始め」リンクとして表示されるタイトル。Titleキーを見てください。

PageReference Key
PageReferenceキー

The path to the page that contains the first use of the glossary term.
グロッサリー用語の最初の使用を含むページへのパス。

  • chapter Name key value/page Name key value

A page reference is a two-component path specifying the location of a page in the playground book package. chapter Name key value is the value of the Name key of the Manifest.plist file for the chapter. For more information, see Name Key in Chapter Manifest. Similarly, page Name key value is the value of the Name key of the Manifest.plist file for the page. For more information, see Name Key in Playground Page Manifest.
ページ参照は、プレイグラウンドブックパッケージの中のあるページの位置を指定している2コンポーネントバスです。chapter Name key valueは、その章のためのManifest.plistファイルのNameキーの値です。さらなる情報として、Nameキー章マニフェストで見てください。同様に、page Name key valueは、そのページのためのManifest.plistファイルのNameキーの値です。さらなる情報として、Nameキープレイグラウンドページマニフェストで見てください。

The path follows URI rules for encoding spaces and other special characters. For more information, see "Characters" in RFC 3986.
パスは、空白と他の特殊文字をエンコーディングするためのURIルールに従います。さらなる情報として、"Characters"RFC 3986で見てください。

In First-use path, the first use of the term command is in the chapter Document1.playgroundchapter on the page Exercise1.playgroundpage. Commands, the first component of the PageReference for command, is the value of the Name key of the Manifest.plist file for the chapter Document1.playgroundchapter. Issuing%20Commands, the second component of the path, is the value of the Name key of the Manifest.plist file for the page Exercise1.playgroundpage. The space character in Issuing Commands, the name of the playground page, is encoded with the string %20.
First-use pathにおいて、用語commandの最初の利用は、章Document1.playgroundchapterの中でのページExercise1.playgroundpage上においてです。CommandscommandのためのPageReferenceの最初のコンポーネントは、章Document1.playgroundchapterのためのManifest.plistファイルのNameキーです。Issuing%20Commands、パスの第2のコンポーネントは、ページExercise1.playgroundpageのためのManifest.plistファイルのNameキーの値です。プレイグラウンドページの名前、Issuing Commandsの中の空白文字は、文字列%20でエンコードされます。

Title Key
Titleキー

The title displayed for the first-use link in the full glossary.
完全なグロッサリーにおいて「使い始め」リンクに対して表示されるタイトル。

Title Key
Titleキー

The title used for the glossary term. If not specified, the term name key is used. Use this key to customize the display of terminology in a localized glossary.
グロッサリー用語のために使われるタイトル。指定されないならば、用語名キーが使われます。このキーを使って、ローカライズされたグロットリーにおける用語の表示をカスタマイズしてください。