OPDS カタログとは何か
What are OPDS Catalogs?
OPDS カタログは、本やジャーナルやその他のデジタルコンテンツを、あらゆるユーザが、あらゆる場所から、あらゆる電子化されたフォーマットで、あらゆるデバイスに、集約、配信、発見できるようにする。
OPDS Catalogs enable the aggregation, distribution, and discovery of books, journals, and
other digital content by any user, from any source, in any
electronic format, on any device. The OPDS Catalogs specification
is based on the Atom syndication format and prioritizes
simplicity and speed.
原文表示
OPDS カタログの仕様は開発が続けられており、われわれ専門グループはどんなアイデア、提案、フィードバックも歓迎する。
The OPDS Catalog specification is continually in development, so any ideas, suggestions, or
feedback are welcomed on our dedicated group.
原文表示
ナビゲーションフィードと取得フィード
Navigation Feeds and Acquisition Feeds
OPDS カタログには、用途の異なる二種類のフィードがある。
In an OPDS catalog, we define two
different uses for feeds:
原文表示
-
カタログによってクライアントをナビゲートするナビゲーションフィード
Navigation feeds, used by a client to navigate through the catalog
原文表示
-
出版物を一覧化して取得可能にする取得フィード
Acquisition feeds, where publications are listed and can be acquired
原文表示
いずれのフィードも妥当な Atom フィードであり、一般的な Atom クライアントによって読み込める。
Both feeds are valid Atom feeds and can be consumed by a generic Atom client.
原文表示
カタログ制作者はナビゲーションフィードと取得フィードを別々にすることが期待される。つまり両者は併存できない。
Catalog producers are expected to separate navigation feeds
from acquisition feeds: a feed can't be both at the same
time.
原文表示
取得リンク
Acquisition Links
取得リンクは、取得できるリソースへのリンクだ。
An Acquisition link is a link to a resource that you can acquire.
原文表示
Atom の中での取得リンクは、基本的に “http://opds-spec.org/acquisition” によって始まるリレーションを（rel 属性に）持った link タグとなる。
In Atom, it's basically a link tag using a relationship (a rel attribute) starting with “http://opds-spec.org/acquisition”.
原文表示
OPDS は予め定義された様々な取得シナリオあらわすリレーションを持つ。
OPDS provides predefined relationships for various acquisition scenarios:
原文表示
-
どんなクライアントでも自由に利用できるリソースへのオープンアクセス
Open Access for resources that are freely available without any constraint,
原文表示
-
独自のトランザクションを必要とするリソースの販売では、価格はそのリンクの中で示される
Sale for resources that require a transaction to own them, pricing is
indicated in the link,
原文表示
-
一定の期間だけ借りることのできる、リソースの貸し出し
Lending for resources that can only be borrowed for a limited amount of time,
原文表示
-
定期的に発行されるリソースの購読
Subscription for resources that are periodically published,
原文表示
-
（本の最初の章のような）出版物の一部を表示したリソースのサンプル
Sampling for resources that represents a fragment of the publication (ex : the first chapter of a book).
原文表示
これらの取得シナリオが適さない場合には、汎用的な取得リレーションを利用することもできる。
A Generic Acquisition relation is also available when the acquisition doesn't fit in any of the acquisition scenarios.
原文表示
関連する rel 属性の値：
The associated rel values are:
原文表示
| 取得シナリオ |
属性の値 |
| 汎用的な取得 |
http://opds-spec.org/acquisition |
| オープンアクセス |
http://opds-spec.org/acquisition/open-access |
| 販売 |
http://opds-spec.org/acquisition/buy |
| 貸し出し |
http://opds-spec.org/acquisition/borrow |
| 購読 |
http://opds-spec.org/acquisition/subscribe |
| サンプル |
http://opds-spec.org/acquisition/sample |
| Acquisition Scenario |
rel attribute value |
| Generic Acquisition |
http://opds-spec.org/acquisition |
| Open Access |
http://opds-spec.org/acquisition/open-access |
| Sale |
http://opds-spec.org/acquisition/buy |
| Lending |
http://opds-spec.org/acquisition/borrow |
| Subscription |
http://opds-spec.org/acquisition/subscribe |
| Sampling |
http://opds-spec.org/acquisition/sample |
原文表示
フルエントリ
Full Entries
カタログ制作者には出版物のエントリに詳細なメタデータを入れることが推奨される。帯域と速度の問題を避けるために、OPDS では AtomPub で最初に導入された仕組みであるフルエントリを推奨する。
Catalog producers are encouraged to provide extensive metadata and links in their publications’ entries. To avoid bandwidth and speed issues, OPDS recommends a feature first introduced in AtomPub: full entries.
原文表示
あらゆる出版物は rel="alternate" と type="application/atom+xml;type=entry" の属性を追加したlink タグを追加することで、エントリの内容を再定義した別の文書を示すことができる。
Any publication can point to a separate document, where the entry is redefined with additional elements using a link tag with the following attributes: rel="alternate" and type="application/atom+xml;type=entry".
原文表示
<entry>
<title>On the Origin of Species</title>
<id>http://www.example.com/42</id>
<author>
<name>Charles Darwin</name>
</author>
<updated>2010-01-02T15:27:07Z</updated>
<link type="application/epub+zip"
href="http://www.example.com/42.epub" rel="http://opds-spec.org/acquisition/open-access"/>
<link type="application/atom+xml;type=entry"
href="http://www.example.com/42.atom" rel="alternate" title="Full entry"/>
</entry>
エントリの部分的な例
原文表示
フルエントリの最も一般的な利用ケースは、出版物について詳細な説明を行う場合だ。この部分的なエントリでは summary 要素の中で短い説明を行なう一方、フルエントリでは content 要素の中で完全な説明を行う。
The most common use case for full entries is for publication with an extensive description. The
partial entry can provide a shorter description in its summary element, while the full entry contains the complete description in a
content element.
原文表示
またフルエントリは OPDS に、カタログが特定のドメインに固有のメタデータやリンク関係を利用できるようにする、シンプルな拡張の仕組みを与える。
Full entries also provide a simple extension mechanism for OPDS, where catalogs can use
metadata and link relationships that are specific to a given domain.
原文表示
検索
Search
ナビゲーションフィードによるナビゲーションの他に、クライアントは検索によっても出版物にアクセスできる。
Aside from navigating through a series of navigation feeds, a client can also access publications through a search.
原文表示
OPDS の検索はOpen Search フォーマットに基づいており、クライアントがカタログを検索する方法を Open Search Description Document と呼ばれる別の文書に記述する。
Search in OPDS is based on the Open Search format, where a separate
document called an Open Search Description Document describes how a client can search in the catalog.
原文表示
検索は OPDS のオプショナルな機構となっている。
Search is an optional OPDS feature.
原文表示
例
Examples
ボブは、OPDS に対応したデバイスを使っており、新しい本を手に入れたいと思っている。
Bob would like to get a new book and uses an OPDS enabled device.
原文表示
彼はデバイスで OPDS カタログを開いて、利用できる様々なセクションを持ったリストを取得する。
He points it to an OPDS catalog and gets a list of the different sections available.
原文表示
このカタログがナビゲーションフィードだ。
This catalog is a Navigation Feed
原文表示
彼は一つのセクション、例えば “Scientific books” を選び、利用できる出版物のリストを取得する。
He chooses a section, called for example “Scientific books”, and gets a list of available publications.
原文表示
このリストが取得フィードだ。このタイトルのリストは、出版物のリストから全ての title 要素を取り出すことによって作られている。
This list is an Acquisition Feed. The title list is created by getting all the title elements in the publication list
原文表示
彼はある一冊の本（On the Origin of Species）に要約があるか調べてみたいと思う。彼がその本を選ぶと、クライアントはその本の要約と出版日、そしてこの本に関するユーザのレビューを表示する。
He would like to see if one of the book (On the Origin of Species) has a summary. He selects it and his client provides him with a summary, the publication date and
a link to user reviews of this book.
原文表示
ボブが出版物を選ぶと、リーディングシステムはフルエントリへのリンクを探し、その内容を取り出してボブに見せる。
When Bob selected the publication the reading system looked for a full entry link,
retrieved it and presented its content to Bob.
原文表示
要約を読んだボブはこの本を手に入れることに決め、ダウンロードボタンをクリックする。
After reading the summary Bob
decides to acquire the book and clicks on the download
button.
原文表示
クライアントが本をダウンロードできるアドレスは、取得リンクによってわかる。
The acquisition link provided
the address where the client can download the book.
原文表示
これは OPDS の一般的な利用法を解説したシナリオだ。次にやや高度な利用法を見てみよう。
This first scenario describes a
common usage of OPDS. Here are some more advanced
uses.
原文表示
ボブは取得フィードに辿り着く前に、幾つものナビゲーションフィードを経由することもある。例えば、Books > Scientific Books > XIX century Books >
High School Classics （それぞれの ‘>’ はリンクが続くことを表す。)
Before getting the Acquisition
Feed Bob could traverse any number of Navigation Feeds. For
example : Books > Scientific Books > XIX century Books >
High School Classics (Each ‘>’ indicates a link followed)
原文表示
OPDS カタログフィードは、取得フィードをいう葉を持ったツリーと見なすことができる。
OPDS catalogs can be viewed as trees where the leaves are Acquisition Feeds
原文表示
ボブは新しい本を読みたいのではなく、単に On the Origin of Species が読みたかったのかもしれない。彼はクライアントでカタログを開き、検索機能を使って “the origin of species” とタイプする。カタログプロバイダから条件にマッチした On the Origin of Species、Species of the Origin、Original spätzel cooking が直接彼に返される。彼はその中から目的の本を選んで取得するだけでよい。
Maybe Bob didn't want to discover new books to read, maybe he only wanted to read
On the Origin of Species. He points the client to the catalog and uses the search
facility and type in “the origin of species”. He is
directly provided with matches from the catalog provider
On the Origin of Species,Species of the Origin,
Original spätzel cooking.
He then only has to choose the desired book and acquires it.
原文表示
この例では、クライアントはマッチするはずの出版物を探すのに Open Search Description Document を利用する。カタログプロバイダは問い合わせに対して取得フィードを直接返す。
In this example, the client
uses an Open Search Description Document to look for potential
matches. The Catalog provider responds to the query directly with
an Acquisition feed.
原文表示
この On the Origin of Species の特定の版は無料では手に入れられなかったもしれない。カタログプロバイダは Buy のリレーションを利用し、リンクの中に価格を提示することができる。この本を取得しようとすれば、ボブはコンテンツを手に入れる前に必要な支払いを要求されただろう。
This particular edition of On the Origin of Species
might not be available freely. The catalog provider could
use a Buy relationship and indicate a price for it in the link.
Upon choosing to acquire this book Bob would have been asked to
give due payment before getting the desired content.
原文表示
パブリケーションのエントリは複数の取得リンクを持つことができる。カタログプロバイダは 二番目のリンクを、Sample のリレーションを利用して、本のサンプル用の章に使うこともできる。
Multiple acquisition links can be provided in publications’ entries. The catalog
provider could also have offered a second link with the Sample
relationship pointing to a sample chapter from the book.
原文表示