Copyright © 2022 W3C® (MIT, ERCIM、Keio, Beihang). W3C liability, trademark and permissive document license rules apply.
本用語集為EPUB® 3標準的一部分,定義了一組特性用於描述文字作品的結構性語意。
本章節描述了本文件在其發表時的狀態。目前W3C出版品及此技術報告的最新改版之列表皆列於W3C技術報告索引,網址為:https://www.w3.org/TR/
本文件由EPUB 3工作小組按照備忘流程,發布為小組備忘。
小組備忘不受W3C及其會員背書。
本文件為草稿,而且可能會隨時更新,被其他文件所取代或淘汰。編輯作業尚未完成前,不適宜引用本文件。
W3C專利政策不對此文件做任何授權需求與承諾。
本文件受2021年11月2日W3C流程文件所規範。
結構語意能為HTML(或SVG)元素添加指定結構目的相關的額外意義。透過epub:type
屬性[epub-33]在EPUB內容文件以及媒體層疊文件[epub-33]中使用,以表述該領域專屬的語意,這些用語能夠補足結構性資訊。
元素添加這些語意,能精緻化其意義,同時不會改變供輔助技術使用的性質,若使用類似的role
屬性[html]就會產生影響。這些屬性不會增進內容的無障礙輔助性,換句話說,只為提供提示目的使用。
語意後設資料能豐富化內容,供出版工作流程或者作者定義的用途所用。也能讓閱讀系統對文件的內容以及結構有更多理解(像是能在媒體層疊文件中啟動可跳過性(skippability)和可跳出性(escapability))。
[epub-33]規格定義了使用屬性軸線來添增結構語意的方法:而不添加新元素。EPUB製作者可以在現成的元素中透過附加epub:type
屬性來添加想要的語意。本文件定義了一系列的特性與值,也就是用語集,能供本目的使用。
EPUB結構語意用語集與所依附的語言無關,但主要用於為HTML中各元素增加語意變化。
「HTML用法脈絡(HTML usage context)」欄位用來指示:該特性在脈絡上與HTML文件的哪些部分相關。EPUB製作者可以將這些特性用於沒被列舉的HTML標記元素上,但必須確認所表達的語意為該元素語意的子集,且不能將既有元素的意義附加在一個語意中立的元素上。
「DPUB-ARIA角色(DPUB-ARIA role)」欄位用來指示:[dpub-aria-1.0]可以額外為[html]添加role
屬性以提升無障礙輔助性。這些role可能有更多使用脈絡上的限制,也就是說,在可以使用epub:type
屬性[epub-33]之地方使用role可能會不合規。請參考[html-aria]以獲得更多關於role使用方式的資訊。
當處理HTML文件時,除非其用法脈絡被明確更新,或者從主規格進行延伸,不然閱讀系統可以忽略這類不合規的特性。
當有「用法細節(Usage details)」欄位時,其用途為指出定義、使用這些特性的規格。除非規則適用於所有EPUB出版品,作者若不遵從這些用法細節,所製作的內容就無法合乎指定規格中的規定。除此之外,特性可以在需要時任意使用。
在一本出版品的主要內容之後的補充性內容,像是索引、附錄等。
一本出版品的主要內容。
用於介紹該作品的區塊,通常包含一張行銷用的影像、書名、作者以及出版社,和挑選的摘要及評論。
DPUB-ARIA角色(DPUB-ARIA role): doc-cover(僅允許用於cover image標籤)
在一本出版品的主要內容之前的材料,像是目次、獻詞等。
一部作品中內容的主要主題區塊。
DPUB-ARIA角色: doc-chapter
作為主要結構用的區塊,也可以作為一部(Part)的子結構(特別用於法律條文)。
一個章節(Chapter)的主要子區塊。
一部作品中的主要結構區塊,其包含了一組相關的區塊用於處理特定主題、故事線或者對相似主題做集結。
DPUB-ARIA角色: doc-part
組成彙編(Collection)的一部分。
章節與元件一般出現在出版品的bodymatter中。
對於作品或者一章節或者內容摘錄之主要想法、概念以及結論的短摘要。
HTML用法脈絡: section、群組內容(grouping content)
DPUB-ARIA角色: doc-abstract
由作者或者重要人物書寫的結尾敘述,主要提供解析說明作品是怎麼被寫下的、其重要性,以及透露其時間線上的相關事件。
DPUB-ARIA角色: doc-afterword
總結性的章節或者聲明,用於對作品做出摘要或者結束故事敘述。
DPUB-ARIA角色: doc-conclusion
在作品或者一章節開始處的一組引言,用於建構主題或者鋪陳氣氛。
DPUB-ARIA角色: doc-epigraph
用於結束故事敘述的結論章節,或者對該作品的事件或者行動提出說明,一般從未來的角度敘述。
DPUB-ARIA角色: doc-epilogue
在作品之前的介紹性章節,一般不由該作品的作者所書寫。
DPUB-ARIA角色: doc-foreword
前導章節,一般介紹該作品的特性或者目的。
DPUB-ARIA角色: doc-introduction
作品開始的章節,一般包含了介紹及/或說明文字,關於該作品內容的特性或者目的。
在作品之前的介紹性章節,一般由作品作者所書寫。
DPUB-ARIA角色: doc-preface
介紹性章節,用於設定作品的背景,一般為故事敘述的一部分。
DPUB-ARIA角色: doc-prologue
補充資訊的區塊,其位於主要內容之後。目的用於提供非主要的資訊。
HTML用法脈絡: 區塊內容
DPUB-ARIA角色: doc-appendix
用於提供該版本製作資訊的短區塊(例如,說明使用的字體),通常位於作品最末。
DPUB-ARIA角色: doc-colophon
貢獻者(credit)的集合。
DPUB-ARIA角色: doc-credits
關鍵字(keyword)的集合。
在書目(bibliography)中參照外部來源的一個項目。biblioentry一般來說,比在內容中提及時提供了更多的細節資訊(例如,書名全名、作者、出版社、出版日期等)。
必需的母脈絡(Required parent context): bibliography
HTML用法脈絡: 群組內容
DPUB-ARIA角色: doc-biblioentry (不再推薦)
作品中引述到的外部參考資料列表,可為印刷或者數位來源。
HTML用法脈絡: 區塊內容
DPUB-ARIA角色: doc-bibliography
一組詞彙,每一項都有一個對立或者近似對立意義的詞語或者俚語。
必需的上層脈絡(Required ancestor context): dictentry
HTML用法脈絡: 流動內容(flow content)
用法細節: Antonym Groups [epub-dict-10]
壓縮的字典詞條,設計於顯示區域受限的環境使用。
必需的母脈絡: dictentry
HTML用法脈絡: aside
用法細節: The Condensed Entry [epub-dict-10]
一個詞語或者俚語專屬意義的定義。
必需的上層脈絡: dictentry
HTML用法脈絡: 流動內容(Flow Content)
用法細節: Definitions [epub-dict-10]
一則字典詞條。
必需的母脈絡: dictionary
HTML用法脈絡: article
用法細節: The Dictionary Entry [epub-dict-10]
一組字典詞條。
用法細節: The Dictionary Container [epub-dict-10]
解釋詞語之歷史來源。
必需的上層脈絡: dictentry
HTML用法脈絡: 流動內容
用法細節: Etymologies [epub-dict-10]
說明定義術語或者片語使用方式的範本。
必需的上層脈絡: dictentry
HTML用法脈絡: 流動內容
用法細節: Examples [epub-dict-10]
與詞語相關的補充文法資訊,修改詞性或指出特殊意義。
必需的上層脈絡: dictentry
HTML用法脈絡: 流動內容
定義片語的實例。
必需的母脈絡: dictentry或phrase-group
HTML用法脈絡: dfn
用法細節: Idioms [epub-dict-10]
詞語的文法功能。
必需的上層脈絡: dictentry
HTML用法脈絡: 流動內容
用法細節: The Dictionary Container [epub-dict-10]
一個字典詞條中的詞性群組列表。
必需的上層脈絡: dictentry
HTML用法脈絡: ol
用法細節: Part of Speech Lists [epub-dict-10]
與詞性相關的單位,內有關聯的意義與片語群組。
必需的上層脈絡: dictentry
HTML用法脈絡: 流動內容
用法細節: Part of Speech Groups [epub-dict-10]
一個字典詞條中的詞語或其他元素發音的音標。
HTML用法脈絡: 流動內容
用法細節: Phonetic Transcriptions [epub-dict-10]
一則字典詞條中的片語群組列表。
必需的上層脈絡: dictentry
用法細節: Phrase Lists [epub-dict-10]
用於組織從屬於一個俚語或範例之資訊的單位。
必需的上層脈絡: dictentry
HTML用法脈絡: 流動內容
用法細節: Phrase Groups [epub-dict-10]
一個字典詞條中意義群組的列表。
必需的上層脈絡: dictentry
HTML用法脈絡: ol
用法細節: Sense Lists [epub-dict-10]
用於組織從屬於一個詞語或俚語之特殊意義資訊的單位。
必需的上層脈絡: dictentry
HTML用法脈絡: 流動內容
用法細節: Sense Groups [epub-dict-10]
一組詞彙,每一項都有一個一致或者近似的意義的詞語或者俚語。
必需的上層脈絡: dictentry
HTML用法脈絡: 流動內容
用法細節: Synonym Groups [epub-dict-10]
將來源語言詞語、俚語或者範例之特殊意義轉換到目標語言的翻譯。
必需的上層脈絡: dictentry
HTML用法脈絡: 流動內容
用法細節: Translations [epub-dict-10]
與翻譯相關的文法或者用法資訊。
必需的上層脈絡: tran
HTML用法脈絡: 流動內容
簡要的詞彙表,包含內容中出現過之新穎、罕見、特殊的術語。
DPUB-ARIA角色: doc-glossary
用法細節: The Glossary Container [epub-dict-10]
詞彙表中術語的定義。
必需的母脈絡: glossary
詞彙表中的一個術語。
必需的母脈絡: glossary
一組供導覽目的使用,有詳細資料的連結列表,其指向關鍵主題、名稱以及其他作品所涵蓋的重點。
用法細節: index property [epub-indexes-10]
DPUB-ARIA角色: doc-index
與單一條目有關的編輯說明。
必需的母脈絡: index-entry
HTML用法脈絡: 流動內容
一個術語,伴隨著附屬的子條目、位址、相互參照,及/或編輯說明。
必需的母脈絡: index-entry-list
HTML用法脈絡: li;套用此特性時,母ul元素類別需為index-entry-list (內隱或者外顯)
用法細節: index-entry property [epub-indexes-10]
一組連續主條目或次條目之集合。
必需的母脈絡: index-entry 、 index-group、及 index
HTML用法脈絡: ul; 套用此特性時,其原型需為index,卻不該在index-headnotes中。
一組連續的主條目,其具備相同的特徵,例如以同一個字母開頭的主條目。
必需的母脈絡: index
HTML用法脈絡: 區塊內容
用法細節: index-group property [epub-indexes-10]
敘述性或者其他種類的內容,用於協助使用者使用本索引。
必需的母脈絡: index
索引中使用的符號、縮寫或特別格式及其意義的列表。
必需的母脈絡: index-headnotes
用法細節: index-legend property [epub-indexes-10]
出版品中被索引內容出現位址的參照。
必需的母脈絡: index-entry 、 index-locator-list 、及 index-locator-range
HTML用法脈絡: a; 套用此特性時,其上層脈絡需為index-locator-list或index-locator-range。
序列位址或位址範圍的集合。
必需的母脈絡: index-entry
HTML用法脈絡: ul
一組位址連結術語到一段內容範圍,而非單一定點。
必需的母脈絡: index-locator-list and index-entry
HTML用法脈絡: 流動內容
單字、片語、字串、字形或者圖像,用於表達可被索引的內容。
必需的母脈絡: index-xref-related 、 index-entry 及 index-xref-preferred
HTML用法脈絡: 片語內容(phrasing content); 一般為 span
用法細節: index-term property [epub-indexes-10]
索引內術語分類列表的外包裝。
必需的母脈絡: index-xref-related 及 index-xref-preferred
HTML用法脈絡: a
單字、片語、字串、字形或者圖像,用於表達索引內的術語分類。
必需的母脈絡: index-xref-related 及 index-xref-preferred
HTML用法脈絡: a
讓索引內一個術語能夠參照一或多個偏好的術語或者術語分類(等同於「請見xxx」)。
必需的母脈絡: index-entry
HTML用法脈絡: 流動內容
讓索引內一個術語能夠參照一或多個相關的術語或者術語分類(等同於「也請參照xxx」)。
必需的母脈絡: index-entry
HTML用法脈絡: 流動內容
正文前的章節以及元件,一般出現在出版品中的frontmatter。
一章節或者一份聲明用於對該作品問世有明顯貢獻的個人、組織、政府以及其他實體組織。
DPUB-ARIA角色: doc-acknowledgments
對該作品有貢獻者的列表。
作品的版權頁。
作品前的獻詞,一般用來稱頌與作者親近的一或多人。
DPUB-ARIA角色: doc-dedication
在作品最初發表後發現錯誤的各項更正,通常稱為「勘誤表(corrigenda)」。
DPUB-ARIA角色: doc-errata
作品的半扉頁(譯注:僅包含書名的頁面)。
正式授權作品出版的聲明。
與作品出版發行相關的資訊。
對作品先前發表部分的致謝、像插畫或圖片作者致敬,以及摘要有版權內容的許可。
作品改版紀錄。
用於表列相關出版品的行銷區塊。
作品的標題扉頁。
對特定主題的詳細分析。
繼承於(Inherits from): xhv:complementary
HTML用法脈絡: 區塊內容
用於釐清內容某些面向或者輔助理解的有用資訊。
繼承於: xhv:complementary
被以下取代(Replaced by): tip
跨出邊界(譯註:即為出血)的內容,不分文字還是圖像。
繼承於: xhv:complementary
被以下取代: aside
告知使用者某個動作或者事件會引起的後果。例如包含警告、提醒以及危險事項。
DPUB-ARIA角色: doc-notice
由目前內容摘出語句,以顯著的方式排設或者強調,目的是為了引起對主題的注意或者對重點進行強調。
繼承於: xhv:complementary
HTML用法脈絡: aside
DPUB-ARIA角色: doc-pullquote
次要或補充性的內容,一般以盒狀或者插頁格式呈現。
繼承於: xhv:complementary
HTML用法脈絡: aside
被以下取代: aside
用於釐清內容某些面向或者輔助理解的有用資訊。
繼承於: xhv:complementary
DPUB-ARIA角色: doc-tip
警告。
被以下取代: notice
結構上明確的標題,但不供作品樹狀架構內容使用。
作品的標題,如作品封面所呈現。
繼承於: title
HTML用法脈絡: 標題內容(Heading Content)。本特性在文件範圍內應該只出現一次。
繼承於: title
等同於(Same as): http://purl.org/dc/terms/title
HTML用法脈絡: 標題內容。本特性在文件範圍內應該只出現一次。
在作品第一頁或者在文字之前出現的標題。
繼承於: title
HTML用法脈絡: 標題內容。本特性在文件範圍內應該只出現一次。
用來處理部件標題順序(ordinal)的文字標籤(也就是「章(chapter)」、「部(Part)」、「圖片(Figure)」、「表格(Table)」)。
繼承於: title
HTML用法脈絡: 片語內容、標題內容的子項、li及figcaption
在一系列元件中用於指示順序的識別(也就是「1」、「4」、「B-1」)。
繼承於: title
HTML用法脈絡: 片語內容、標題內容的子項、li及figcaption
作品解釋性或者另外的標題,或者其中的一章節或者元件。
繼承於: title
HTML用法脈絡: heading content、片語內容、標題內容的子項、paragraphs、divs
DPUB-ARIA角色: doc-subtitle
文件元件的主要名稱,像是一份列表、表格或者圖片。
學習目標的明確項目或者描述,或者對明確學習目標的參照。
一組學習目標(learning-objectives)。
課程或者活動後,學生預期能達成的能力或者理解結果。
HTML用法脈絡: 流動內容
一組學習成果(learning-outcomes)。
供協助學習使用的資源,或者對這樣資源的參照。
HTML用法脈絡: 流動內容
一組學習資源(learning-resources)。
一般由政府或者標準制定機關所提出的正式需求或者期望。
一組學習標準(learning-standards)。
自我評價問題的組件,用於提供問題的答案。
一組答案(answers)。
一項測驗、考試、或者其他有助於評量學生對剛教導內容理解的活動。
HTML用法脈絡: 區塊內容
一組測驗(assessments)。
HTML用法脈絡: 區塊內容
給讀者基於測驗結果的程序。
要求讀者輸入文字答案來完善句子、文章之類的問題。
以自由形式提供答案的問題。
要求讀者從一份列表中的內容,選出與另一項列表中相呼應項目的問題。
提供一系列可能的答案供挑選,其中部分、全部,或者都不是正確答案的問題。
複習用的習題或者範例。
請參見: practices
一組練習題(practices)。
HTML用法脈絡: 區塊內容
內容的一章節,由一系列問題與答案所構成,像是訪談或者常見問題列表。
HTML用法脈絡:lists or 區塊內容
DPUB-ARIA角色: doc-qna
自我評價問題的組件,提出要被解決的問題。
HTML用法脈絡: 群組內容
答案為是或非的問題。
對作品中段落的解釋性資訊。
繼承於: xhv:complementary
被以下取代: Open Annotation in EPUB
一組註釋的集合,其位於作品或者章節末,用於對對應的文字段落提供額外的脈絡。
請參見(See also): endnotes
HTML用法脈絡:用於aside元素作為單一尾註,或者區塊內容的子項作為群組中的個別尾註(請參考footnotes與endnotes)。
DPUB-ARIA角色: doc-endnote (不再推薦)
一組尾註的集合,其位於作品或者章節末。
請參見: endnote
HTML用法脈絡: 區塊內容
DPUB-ARIA角色: doc-endnotes
補充性資訊,像是摘要或者補述,用於對對應的文字段落提供額外的脈絡。
請參見: footnotes
HTML用法脈絡:用aside元素作為單一腳註,或者區塊內容的子項作為群組中的個別腳註(請參考footnotes與endnotes)。
DPUB-ARIA角色: doc-footnote
一組腳註(footnotes)的集合。
請參見: footnote
HTML用法脈絡: 區塊內容
註,此特性不包含空間定位語意,不像footnote與endnote特性。可以用於識別註解、尾註、旁註、行內註以及其他傳統命名無法對應的註解。
HTML用法脈絡:HTML用法脈絡: 用於aside元素作為單一註,或者區塊內容的子項作為群組中的個別註(請參考footnotes與endnotes)。
出現在章節結束或者作品後方(backmatter)的註解。
請參見: rearnotes
HTML用法脈絡:用於 aside元素作為單一後註,或者區塊內容的子項作為群組中的個別後註(請參考footnotes與rearnotes)。
被以下取代: endnote
一組出現在章節結束或者作品後方(backmatter)的註解。
請參見: rearnote
HTML用法脈絡: 區塊內容
被以下取代: endnotes
一則註釋的參照。
繼承於: xhv:link
請參見: annotation
HTML用法脈絡: a
被以下取代: Open Annotation in EPUB
一個允許使用者回到內容相關位置的連結(例如,從腳註(footnote)回到參照的位置,或者詞彙表定義從(glossary definition)回到該術語出現的位置)。
繼承於: xhv:link
HTML用法脈絡: a
DPUB-ARIA角色: doc-backlink
一筆書目資料( bibliography entry)的參照。
繼承於: xhv:link
HTML用法脈絡: a
DPUB-ARIA角色: doc-biblioref
一項詞彙表定義(glossary definition)的參照。
繼承於: xhv:link
HTML用法脈絡: a
DPUB-ARIA角色: doc-glossref
一則註解的參照,一般以上標數字或者符號出現在內文之中。
繼承於: xhv:link
請參見: note
HTML用法脈絡: a
DPUB-ARIA角色: doc-noteref
用於說明片語層級元件的術語。
片語或者句子,用於對所包含段落做出結論性摘要。
HTML用法脈絡: 片語內容
對整體內容來自第三方來源之素材,像是照片,的致謝。一般用來識別作者、著作權,以及任何再利用的的限制。
HTML用法脈絡: 片語內容
DPUB-ARIA角色: doc-credit
一個關鍵字或者片語。
HTML用法脈絡: 片語內容
片語或者句子,用於對所包含段落做出介紹性摘要。
HTML用法脈絡: 片語內容
一組有詳細資料的連結列表供導覽目的使用,其指向內容中的分頁點(pagebreaks)。
HTML用法脈絡: 區塊內容
DPUB-ARIA角色: doc-pagelist
用法細節:
page-list nav
元素 [epub-33]
一個分隔點,用於指示在固定分頁的內容版本中,該位址為連續兩頁面的換頁點。
換頁位址也常用來在純數位出版品(也就是沒有固定翻頁的版本存在)提供固定標記。這些標記,無論字體或者螢幕尺寸等會影響動態內容分頁的因素變化,都能提供恆定的導覽。
EPUB製作者必須確保分頁點名稱為終端使用者能使用的頁碼,與開始的頁碼相同。
DPUB-ARIA角色: doc-pagebreak
本章節為非規範性。
以下EPUB 3工作小組的成員對本規格的產製有所貢獻: