EPUB 3.4

Manifest fallbacks는 package document의 기능이며, reading system이 top-level content document 대신 사용할 수 있는 대체 리소스의 manifest fallback chain을 만들어, 기본 리소스가 spine에서 지원되지 않을 때 렌더링할 수 있는 형식을 선택할 수 있게 합니다.

Fallback chains는 manifest item 요소의 fallback 속성을 사용해 생성됩니다. 이 속성은 현재 item에 대한 fallback인 다른 manifest item의 ID [xml]를 참조합니다. 주어진 item의 fallback 속성에서 시작해 reading system이 도달할 수 있는 모든 참조의 순서가 지정된 목록은 해당 item의 전체 및 선호 fallback chain을 모두 나타냅니다.

foreign content document는 reading system이 spine 항목을 항상 렌더링할 수 있도록, 적어도 하나의 EPUB 콘텐츠 문서를 포함해야 하는 fallback chain을 지정해야 MUST 합니다.

EPUB 콘텐츠 문서는 fallback을 지정할 MAY 있습니다. 예를 들어 scripted content에 대한 fallback을 제공하기 위해서입니다.

Fallback chain에 둘 이상의 EPUB 콘텐츠 문서가 포함되는 경우, properties 속성을 사용해 각각의 목적을 구분할 수 있습니다.

Manifest fallback chains는 chain 안의 item 요소에 대한 자기 참조 또는 순환 참조를 포함해서는 MUST NOT 됩니다.

다음 절들은 [html]의 특정 요소에 대한 내재적 fallback 요건에 관한 설명을 제공합니다.

OCF abstract container의 가상 파일 시스템은 컨테이너의 모든 콘텐츠에 대해 단일 공통 root directory를 가져야 MUST 합니다.

OCF abstract container는 컨테이너의 root directory의 직접 자식인 META-INF라는 구성 파일용 디렉터리를 포함해야 MUST 합니다. 이 디렉터리 콘텐츠에 대한 요건은 4.2.6 META-INF 디렉터리를 참조하세요.

root directory의 파일 이름 mimetype은 OCF ZIP containers가 사용하도록 예약되어 있으며, 이는 4.3 OCF ZIP container에서 설명합니다.

META-INF 디렉터리 안의 파일과 mimetype 파일은 publication resources가 아니므로 manifest에 나열되어서는 MUST NOT 됩니다.

OCF abstract container 안의 다른 모든 파일은 META-INF 디렉터리 안에 있지 않은 한, root directory의 하위 위치 어디에나 저장될 MAY 있습니다. EPUB 출판물은 META-INF 디렉터리 안의 파일에 대한 참조를 포함해서는 MUST NOT 됩니다.

OCF abstract container의 맥락에서, file paths 및 file names는 scalar value strings [infra]입니다(즉, 그 값은 대소문자를 구분합니다).

또한 다음 제한은 대부분의 운영 체제에서 file paths 및 file names를 수정 없이 사용할 수 있도록 설계되었습니다:

• File names는 255바이트를 초과해서는 MUST NOT 됩니다.

• OCF abstract container 안의 모든 디렉터리 또는 파일에 대한 file paths는 65535바이트를 초과해서는 MUST NOT 됩니다.

• 일반적으로 사용되는 운영 체제가 이러한 문자를 일관되게 지원하지 않을 수 있으므로, file names는 다음 [unicode] 문자를 사용해서는 MUST NOT 됩니다:

  • SOLIDUS: / (U+002F)

  • QUOTATION MARK: " (U+0022)

  • ASTERISK: * (U+002A)

  • 마지막 문자로서의 FULL STOP: . (U+002E)

  • COLON: : (U+003A)

  • LESS-THAN SIGN: < (U+003C)

  • GREATER-THAN SIGN: > (U+003E)

  • QUESTION MARK: ? (U+003F)

  • REVERSE SOLIDUS: \ (U+005C)

  • VERTICAL LINE: | (U+007C)

  • DEL (U+007F)

  • C0 범위 (U+0000 … U+001F)

  • C1 범위 (U+0080 … U+009F)

  • Private Use Area (U+E000 … U+F8FF)

  • 모든 Unicode Non Characters, 구체적으로:

    • Basic Multilingual Plane의 32개 연속 문자 (U+FDD0 … U+FDEF)

    • Basic Multilingual Plane의 마지막 두 코드 포인트 (U+FFFE 및 U+FFFF)

    • Supplementary Planes 끝의 마지막 두 코드 포인트 (U+1FFFE, U+1FFFF … U+EFFFE, U+EFFFF)

  • Specials (U+FFF0 … U+FFFF)

  • Supplementary Private Use Area-A (U+F0000 … U+FFFFF)

  • Supplementary Private Use Area-B (U+100000 … U+10FFFF)

  참고

  Unicode Character Database [uax44]에는 폐기된 문자 목록이 포함되어 있습니다. EPUB conformance checkers가 그 사용을 표시할 것으로 예상되므로, 이러한 문자도 피하는 것이 권장됩니다.

• 오래된 reading systems와의 호환성을 위해, file names는 SPACE (U+0020) 문자를 포함하지 않는 것이 SHOULD NOT 좋습니다.

• 동일한 디렉터리 안의 모든 file names는 Unicode canonical normalization [uax15] 후 full case folding [unicode]을 적용했을 때 고유해야 MUST 합니다. (자세한 내용은 Unicode Canonical Case Fold Normalization Step [charmod-norm]를 참조하세요.)

OCF abstract container 안의 파일 또는 디렉터리 file이 주어졌을 때 file path를 도출하려면, 다음 단계를 적용하세요 ([infra]의 용어를 사용해 표현됨):

1. path를 빈 list로 둡니다.
2. current를 file로 둡니다.
3. current가 root directory가 아닌 동안:
   1. current의 file name을 path 앞에 prepend합니다;
   2. current를 current의 부모 디렉터리로 설정합니다.
4. U+002F (/) 문자를 사용해 path를 concatenation한 결과를 반환합니다.

container root URL은 URL [url]이며, root directory의 URL입니다. container root URL은 구현별로 다르지만, 다음 속성을 가져야 MUST 합니다:

• parsing "/"를 container root URL을 base로 사용해 수행한 결과는 container root URL입니다.
• parsing ".."를 container root URL을 base로 사용해 수행한 결과는 container root URL입니다.

OCF abstract container 안의 파일 또는 디렉터리의 content URL은, 해당 파일의 file path를 container root URL을 base로 사용해 parsing한 결과입니다.

문자열 url은 다음 단계가 true를 반환하는 경우 valid-relative-ocf-URL-with-fragment string입니다. 즉, path-relative-scheme-less-url string이고, 선택적으로 U+0023 (#) 및 url-fragment string이 뒤따를 수 있습니다:

1. container root URL을 https://a.example.org/A/로 설정합니다.

   설명

   이 알고리즘의 목표는 url이 컨테이너 밖으로 "leaking"되는 것으로 보일 수 있는지 감지하는 것입니다. 이를 위해 표준 URL parsing algorithm을 인공 root URL과 함께 사용합니다. "leak"의 감지는 parsing 결과와 첫 번째 테스트 경로 세그먼트 (A)의 존재를 비교하여 수행됩니다. (인공 container root URL은 이 알고리즘의 목적상 해당 첫 번째 테스트 경로 세그먼트를 사용함으로써 required properties를 의도적으로 위반한다는 점에 유의하세요.)

2. base를 url이 사용되는 컨텍스트(문서 또는 환경)에서 정의된 대로, 그리고 package document의 content URL에 따라 url을 파싱하는 데 사용되는 base URL로 둡니다 (5.2 package document에서 URLs 파싱 참조).

   설명

   package document 안의 URL의 경우 base 변수는 package document의 content URL로 설정됩니다. META-INF 디렉터리 안의 문서의 경우 base 변수는 container root URL로 설정됩니다(4.2.6.2 META-INF 디렉터리에서 URLs 파싱 참조). XHTML content document 안의 URL의 경우, parsing에 사용되는 base URL은 HTML 표준에서 정의됩니다. 일반적으로 이는 content document의 content URL입니다(단, 권장되지 않는 base 요소가 사용되는 경우는 제외).

3. testURLRecord를 url에 URL parser를 base와 함께 적용한 결과로 둡니다.
4. testURLStringA를 testURLRecord에 URL Serializer를 적용한 결과로 둡니다.

5. container root URL을 https://b.example.org/B/로 설정합니다.

   설명

   container root URL의 서로 다른 인공 설정으로 동일한 단계를 두 번 반복하는 이유는 url 문자열이 /A/도 포함하는 경우 발생할 수 있는 충돌을 피하기 위해서입니다. 예를 들어 url이 ../../A/doc.xhtml인 경우를 고려하세요.

6. base를 url이 사용되는 컨텍스트(문서 또는 환경)에서 정의된 대로, 그리고 package document의 content URL에 따라 url을 파싱하는 데 사용되는 base URL로 설정합니다(5.2 package document에서 URLs 파싱 참조).
7. testURLRecord를 url에 URL parser를 base와 함께 적용한 결과로 설정합니다.
8. testURLStringB를 testURLRecord에 URL Serializer를 적용한 결과로 둡니다.

9. testURLStringA가 https://a.example.org/로 시작하지 않거나 testURLStringB가 https://b.example.org/로 시작하지 않으면, true를 반환합니다.

   설명

   결과 중 하나라도 테스트 URL host를 공유하지 않는다면, url 또는 그 base URL (예: HTML에서 base 요소로 명시적으로 설정된 경우)이 absolute이고 컨테이너 밖을 가리킨다는 뜻입니다. 이는 허용됩니다.

10. testURLStringA가 https://a.example.org/A/로 시작하고 testURLStringB가 https://b.example.org/B/로 시작하면, true를 반환합니다.

    설명

    첫 번째 테스트 경로 세그먼트(A와 각각 B)의 존재는 URL이 컨테이너 밖으로 leak되지 않음을 나타냅니다.

11. false를 반환합니다.

OCF abstract container에서 모든 URL 문자열은 absolute-url-with-fragment string 또는 valid-relative-ocf-URL-with-fragment string이어야 MUST 합니다.

또한 모든 relative-URL-with-fragment strings [url]는 parsing 후 OCF abstract container 안의 기존 파일의 content URL과 같아야 MUST 합니다.

OCF ZIP container는 [zip]에 지정된 ZIP 형식을 사용하지만, 다음 제약과 설명을 따릅니다:

• OCF ZIP container의 콘텐츠는 준수하는 OCF abstract container여야 MUST 합니다.

• OCF ZIP containers는 ZIP 파일을 여러 저장 매체에 걸치게 하거나 여러 파일로 나눌 수 있게 하는 ZIP application note [zip]의 기능을 사용해서는 MUST NOT 됩니다.

• OCF ZIP containers는 ZIP 아카이브 안에 저장된(stored, 압축되지 않은) 항목과 Deflate 압축 ZIP 항목만 포함해야 MUST 합니다.

• OCF ZIP containers는 [zip]의 section 4.3.14 ("Zip64 end of central directory record")에서 "Version 1"로 정의된 ZIP64 extensions를 사용할 MAY 있으며, 콘텐츠가 이를 필요로 할 때만 그러한 extensions를 사용하는 것이 SHOULD 좋습니다.

• OCF ZIP containers는 ZIP 형식이 정의한 암호화 기능을 사용해서는 MUST NOT 됩니다. 대신 암호화는 4.2.6.3.2 Encryption file (encryption.xml)에 설명된 기능을 사용해 수행되어야 MUST 합니다.

• OCF ZIP containers는 파일 시스템 이름을 UTF-8 [unicode]로 인코딩해야 MUST 합니다.

다음 제약은 OCF ZIP container 아카이브의 특정 필드에 적용됩니다:

• local file header table에서 version needed to extract 필드는 주어진 파일에 필요한 최대 version level과 일치하도록 10, 20 또는 45로 설정되어야 MUST 합니다(예: Deflate의 경우 20, ZIP64의 경우 45).

• local file header table에서 compression method field는 0 또는 8로 설정되어야 MUST 합니다.

mimetype 파일은 OCF ZIP container의 첫 번째 파일이어야 MUST 합니다. 또한:

• mimetype 파일의 콘텐츠는 US-ASCII [us-ascii]로 인코딩된 MIME media type [rfc2046] 문자열 application/epub+zip이어야 MUST 합니다.
• mimetype 파일은 선행 또는 후행 padding이나 whitespace를 포함해서는 MUST NOT 됩니다.
• mimetype 파일은 Unicode byte order mark U+FEFF로 시작해서는 MUST NOT 됩니다.
• mimetype 파일은 압축되거나 암호화되어서는 MUST NOT 됩니다.
• mimetype 파일은 ZIP header에 extra field를 포함해서는 MUST NOT 됩니다.

compact URL data type은 URL [url]을 표현하는 간결한 수단이며, colon으로 reference와 분리된 OPTIONAL prefix로 구성됩니다.

이 명세는 [rdfa-core]에 정의된 CURIE data type에서 compact URL data type을 도출합니다. compact URL은 CURIEs의 부분집합을 나타냅니다.

CURIEs와의 두 가지 핵심 차이는 다음과 같습니다:

• 빈 reference는 위 정의에는 유효하더라도 유효한 compact URL을 나타내지 않습니다 (즉, prefix와 colon만으로 구성된 compact URL은 유효하지 않습니다).

• 빈 문자열은 위 정의에는 유효하더라도 유효한 compact URL을 나타내지 않습니다.

compact URL 값에서 prefix가 생략되면, 지정된 term은 해당 속성의 default vocabulary에서 가져온 것으로 간주됩니다.

default vocabulary는 compact URL이 예상될 때 그 terms와 properties가 prefix를 가져서는 MUST NOT 안 되는 vocabulary입니다.

prefix 속성을 사용하여 이러한 vocabularies와 연결된 URLs에 prefix를 할당해서는 MUST NOT 됩니다.

prefix 속성은 compact URLs에서 사용할 prefix mappings를 정의합니다.

prefix 속성의 값은 다음 형식의 하나 이상의 prefix-to-URL mappings로 이루어진 공백으로 구분된 목록입니다:

reserved prefixes를 제외하고, 문서에서 사용되는 모든 prefixes는 선언되어야 MUST 합니다. prefix 속성은 해당 형식의 root element [xml]에만 지정되어야 MUST 합니다.

이 속성은 package document에서 사용될 때 네임스페이스가 없습니다.

이 속성이 EPUB content documents 및 media overlay documents에서 사용될 때는 http://www.idpf.org/2007/ops 네임스페이스에 선언되어야 MUST 합니다.

<html … prefix="…"
        xmlns:epub="http://www.idpf.org/2007/ops"
        epub:prefix="…">   …
</html>

inclusion으로 임베드된 SVG의 경우, prefixes는 [html] root html 요소에 선언되어야 MUST 한다는 점에 유의하세요.

충돌을 피하기 위해, prefix 속성은 default vocabulary에 매핑되는 prefix를 선언하는 데 사용되어서는 MUST NOT 됩니다.

prefix '_'는 선언되어서는 MUST NOT 됩니다. 이 명세는 RDFa [rdfa-core] processing과의 미래 호환성을 위해 이 prefix를 예약합니다.

package document의 대체 serialization과의 미래 호환성을 위해, Dublin Core /elements/1.1/ 네임스페이스 [dcterms]에 대한 prefix를 선언해서는 MUST NOT 됩니다. 오직 [dcterms] elements만 package document metadata에서 허용됩니다.

reserved prefixes는 compact URL을 기대하는 속성에서 prefix 속성에 선언하지 않고 사용할 MAY 있습니다.

reserved prefixes는 prefix 속성에서 override하지 않는 것이 SHOULD NOT 좋습니다.

사용할 수 있는 reserved prefixes는 컨텍스트에 따라 다릅니다:

Package document

다음 prefixes는 선언하지 않고 package document 속성에서 사용할 MAY 있습니다.

Prefix	URL	사용
a11y	http://www.idpf.org/epub/vocab/package/a11y/#	EPUB Accessibility namespace의 properties를 선언하기 위해 사용합니다. 이들은 일반적으로 EPUB Accessibility 1.2 [epub-a11y-12]에 정의되어 있습니다.
dcterms	http://purl.org/dc/terms/	Dublin Core /terms/ namespace [dcterms]의 properties를 선언하기 위해 사용합니다.
marc	http://id.loc.gov/vocabulary/	주로 scheme 속성에서 creator 및 contributor roles가 MARC relators code list에 정의되어 있음을 나타내기 위해 사용됩니다. Library of Congress에서 발행한 다른 vocabularies를 참조하는 데 사용할 수 있습니다.
media	http://www.idpf.org/epub/vocab/overlays/#	Media Overlays vocabulary의 properties를 선언하기 위해 사용합니다.
onix	http://www.editeur.org/ONIX/book/codelists/current.html#	scheme 속성에서 값이 대응하는 ONIX code list를 식별하기 위해 사용됩니다.
rendition	http://www.idpf.org/vocab/rendition/#	Package rendering vocabulary의 properties를 선언하기 위해 사용합니다.
schema	http://schema.org/	Schema.org vocabulary의 properties를 선언하기 위해 사용합니다.

보유 요소와 그 descendants의 textual content 및 attribute values의 base direction [bidi]을 지정합니다.

허용되는 값은 다음과 같습니다:

• ltr — left-to-right base direction;
• rtl — right-to-left base direction; 그리고
• auto — base direction은 Unicode Bidi Algorithm [bidi]을 사용해 결정됩니다.

속성이 없거나 유효하지 않은 값을 가지면, reading systems는 auto 값을 가정합니다.

허용 위치: collection, Dublin Core elements, meta, 그리고 package.

리소스를 참조하는 valid URL string [url]입니다.

URL string은 package document 안의 요소를 통해 리소스를 참조해서는 MUST NOT 됩니다(예: manifest item 또는 spine itemref 선언을 통해).

허용 위치: item 및 link.

요소의 ID [xml]이며, 문서 범위 안에서 고유해야 MUST 합니다.

허용 위치: collection, Dublin Core elements, item, itemref, link, manifest, meta, package, 그리고 spine.

참조된 리소스의 타입과 형식을 지정하는 media type [rfc2046]입니다.

허용 위치: item 및 link.

compact URLs의 공백으로 구분된 목록입니다.

해당 속성의 default vocabulary는 각 요소의 정의를 참조하세요.

허용 위치: item, itemref, 그리고 link.

현재 expression과 그 값으로 식별되는 요소 또는 리소스 사이의 연결을 설정합니다. 이 속성의 값은 path-relative-scheme-less-URL string이어야 MUST 하며, 선택적으로 U+0023 (#) 및 설명되는 리소스 또는 요소를 참조하는 URL-fragment string이 뒤따를 수 있습니다.

refines 속성은 표현된 메타데이터의 유형에 따라 OPTIONAL입니다. 생략되면 요소는 primary expression을 정의합니다.

publication resource에 대한 expressions를 만들 때, refines 속성은 리소스의 manifest entry의 ID [xml]를 참조하는 fragment identifier를 지정하는 것이 SHOULD 좋습니다.

Refinement chains는 circular references 또는 self-references를 포함해서는 MUST NOT 됩니다.

허용 위치: link 및 meta.

보유 요소와 그 descendants의 textual content 및 attribute values의 언어를 [xml]의 2.12 Language Identification 절에 정의된 대로 지정합니다. 각 xml:lang 속성의 값은 well-formed language tag [bcp47]여야 MUST 합니다.

허용 위치: collection, Dublin Core elements, meta, 그리고 package.

metadata 요소는 meta information을 캡슐화합니다.

요소 이름:

metadata

사용:

package의 REQUIRED 첫 번째 자식.

속성:

없음

콘텐츠 모델:

임의의 순서:

• dc:identifier [1개 이상]

• dc:title [1개 이상]

• dc:language [1개 이상]

• Dublin Core Optional Elements [0개 이상]

• meta [1개 이상]

• OPF2 meta [0개 이상] (outdated)

• link [0개 이상]

package document의 metadata 요소에는 두 가지 주요 기능이 있습니다:

1. reading systems가 내부적으로 EPUB publication을 catalogue하고 사용자에게 제공하는 데 사용할 최소한의 meta information을 제공하는 것(예: bookshelf에 표시).

2. 콘텐츠의 layout과 display를 제어하는 데 필요한 모든 rendering metadata에 접근을 제공하는 것 (예: package rendering properties).

package document는 복잡한 metadata encoding 기능을 제공하지 않습니다. 더 자세한 정보를 제공해야 하는 경우, 국제 표준(예: [onix])을 준수하거나 사용자 정의 목적으로 생성된 metadata records를 link 요소를 사용해 EPUB publication과 연결할 수 있습니다. 이 접근 방식은 reading systems가 metadata를 원래 형식으로 처리할 수 있게 하여, 최소 package document 구조를 사용하도록 변환하면서 발생할 수 있는 잠재적 문제와 정보 손실을 피합니다.

이 철학에 따라 package document에는 다음과 같은 최소 metadata requirements만 있습니다. 즉 [dcterms] dc:title, dc:identifier, 및 dc:language 요소와 함께 [dcterms] dcterms:modified property를 포함해야 MUST 합니다. 그 밖의 모든 metadata는 OPTIONAL입니다.

meta 요소는 임의의 vocabulary에서 온 metadata properties를 포함하기 위한 일반적인 메커니즘을 제공합니다. 이 메커니즘은 어떤 metadata 목적에도 사용할 수 있지만, 일반적으로 EPUB 명세에 정의된 rendering 및 accessibility metadata를 포함하는 데 사용됩니다.

Dublin Core elements [dcterms]와 meta 요소는 필수 child text content [dom]를 가집니다. 이 명세는 이러한 요소에 대한 설명에서 이 콘텐츠를 요소의 value라고 부릅니다.

이러한 요소는 leading and trailing ASCII whitespace [infra]를 제거한 후 비어 있지 않은 값을 가져야 MUST 합니다(즉, 적어도 하나의 non-whitespace character로 구성되어야 합니다).

이러한 요소 값 안의 whitespace는 중요하지 않습니다. 하나 이상의 whitespace character 시퀀스는 처리 중에 단일 space로 collapse [infra]됩니다.

meta 요소는 package metadata를 포함하기 위한 일반적인 수단을 제공합니다.

요소 이름:

meta

사용:

metadata 요소의 자식으로 사용. 반복 가능.

속성:

• dir [optional]

• id [optional]

• property [required]

• refines [optional]

• scheme [optional]

• xml:lang [optional]

콘텐츠 모델:

Text

각 meta 요소는 metadata expression을 정의합니다. property 속성은 expression에서 만들어지는 statement를 정의하는 compact URL을 받으며, 요소의 text content는 assertion을 나타냅니다. (자세한 내용은 5.3 어휘 연결 메커니즘을 참조하세요.)

이 명세는 meta 요소를 사용해 정의할 수 있는 두 가지 유형의 metadata expressions를 정의합니다:

• primary expression은 meta 요소에 정의된 expression이 EPUB publication의 어떤 측면을 설정하는 것입니다. refines 속성을 생략한 meta 요소는 primary expression을 정의합니다.
• subexpression은 meta 요소에 정의된 expression이 refines 속성을 사용하여 다른 expression 또는 resource와 연결되어 그 의미를 강화하는 것입니다. 예를 들어 subexpression은 duration을 표현하여 media clip을 refine하거나, 사람의 role을 정의하여 creator 또는 contributor expression을 refine할 수 있습니다.

Subexpressions는 다른 subexpressions의 의미를 refine하여 정보의 chains를 만드는 데 사용될 MAY 있습니다.

Meta Properties Vocabulary는 property 속성과 함께 사용할 default vocabulary입니다.

다른 vocabularies의 terms는 5.3 어휘 연결 메커니즘에 정의된 대로 추가될 MAY 있습니다.

scheme 속성은 요소의 value가 얻어진 system 또는 scheme를 식별합니다. 이 속성의 값은 scheme를 정의하는 리소스로 해석되는 compact URL이어야 MUST 합니다. scheme 속성에는 default vocabulary가 없습니다(즉, 모든 값에는 prefix가 필요합니다).

metadata 절은 last modification date를 포함하는 dcterms:modified property [dcterms]를 정확히 하나 포함해야 MUST 합니다. 이 property의 value는 다음 extended format과 일치하는 날짜와 시각의 [iso8601-1] complete representation이어야 MUST 합니다:

YYYY-MM-DDThh:mm:ssZ

EPUB publication에 변경이 있을 때마다 last modified date를 업데이트하는 것이 권장됩니다.

추가 dcterms:modified properties는 package document metadata에 지정될 MAY 있지만, 서로 다른 subject를 가져야 MUST 합니다(즉, 요소 또는 리소스를 참조하는 refines 속성이 필요합니다).

link 요소는 metadata records와 같은 리소스를 EPUB publication과 연결합니다.

요소 이름:

link

사용:

metadata의 자식으로 사용. 반복 가능.

속성:

• href [required]

• hreflang [optional]

• id [optional]

• media-type [conditionally required]

• properties [optional]

• refines [optional]

• rel [required]

콘텐츠 모델:

비어 있음

metadata 요소는 0개 이상의 link 요소를 포함할 MAY 있으며, 각 요소는 REQUIRED href 속성에서 publication resource 또는 linked resource의 위치를 식별합니다.

link 요소에서 참조된 리소스는 다음 경우에만 publication resources입니다:

• spine에서 참조되는 경우; 또는

• EPUB content document에 포함되거나 임베드되는 경우 (예: RDFa [rdfa-core]로 또는 JSON-LD [json-ld11]로 serialized된 metadata record가 [html] script 요소에 임베드된 경우).

그 밖의 모든 경우(예: standalone [onix] records에 링크하는 경우), 참조된 리소스는 publication resources가 아닙니다(즉, core media type requirements의 적용을 받지 않음). 또한 manifest에 나열되어서는 MUST NOT 됩니다.

linked resources는 EPUB container 밖에 위치할 MAY 있지만, reading systems가 remote resources를 반드시 가져와야 하는 것은 아닙니다. 이를 원격으로 호스팅하기 전에 사용자의 reading experience에 어떤 영향을 줄 수 있는지 고려하는 것이 권장됩니다.

EPUB container 안의 모든 linked resources에는 media-type 속성을 지정해야 MUST 합니다. EPUB container 밖에 위치한 linked resources의 경우 같은 URL [url]에서 둘 이상의 media type이 제공될 수 있으므로 이는 OPTIONAL입니다.

OPTIONAL hreflang 속성은 linked resource의 언어를 식별합니다. 값은 well-formed language tag [bcp47]여야 MUST 합니다.

REQUIRED rel 속성은 linked resource가 EPUB publication과 갖는 관계를 설정하는 compact URLs의 공백으로 구분된 목록을 받습니다.

media-type 속성의 값이 항상 linked resource의 유형을 식별하기에 충분한 것은 아닙니다 (예: 많은 XML 기반 record formats가 media type "application/xml"을 사용함). reading systems가 이러한 generic resources를 식별하는 데 도움을 주기 위해, semantic identifier가 properties 속성에 지정될 MAY 있습니다.

Metadata Link Vocabulary는 rel 및 properties 속성의 default vocabulary입니다.

다른 vocabularies의 relationships와 properties는 5.3 어휘 연결 메커니즘에 정의된 대로 추가될 MAY 있습니다.

하나 이상의 linked metadata records가 제공될 MAY 있습니다.

full records 외에도, link 요소는 대체 형식에서 사용할 수 있는 개별 metadata properties를 식별하는 데 사용될 MAY 있습니다.

manifest 요소는 콘텐츠 렌더링에 사용되는 publication resources의 완전한 목록을 제공합니다.

요소 이름:

manifest

사용:

metadata 다음에 오는 package의 REQUIRED 두 번째 자식.

속성:

id [optional]

콘텐츠 모델:

item [1개 이상]

package document를 제외하고, manifest는 모든 publication resources를, 그것이 container resources이든 remote resources이든 상관없이 나열해야 MUST 합니다.

package document는 이미 container.xml 파일에 의해 식별되므로, manifest는 이에 대한 item 요소를 지정해서는 MUST NOT 됩니다(즉, self-reference는 아무 목적이 없습니다).

item 요소는 publication resource를 나타냅니다.

요소 이름:

item

사용:

manifest의 자식으로 사용. 반복 가능.

속성:

• fallback [conditionally required]

• href [required]

• id [required]

• media-overlay [optional]

• media-type [required]

• properties [optional]

콘텐츠 모델:

비어 있음

각 item 요소는 그 href 속성의 URL [url]로 publication resource를 식별합니다. 값은 absolute- 또는 path-relative-scheme-less-URL string [url]이어야 MUST 합니다. 각 URL은 parsing 후 manifest 범위 안에서 고유해야 MUST 합니다.

item 요소가 식별하는 publication resource는 media-type 속성에 제공된 MIME media type [rfc2046]에서 추론되는 적용 가능한 specification(s)를 준수해야 MUST 합니다. core media type resources의 경우, 3.2 Core media types에 지정된 media type을 사용해야 MUST 합니다.

fallback 속성은 참조된 publication resource의 fallback을 지정합니다. fallback 속성의 IDREF [xml] 값은 manifest 안의 다른 item으로 resolve되어야 MUST 합니다.

하나의 item에 대한 fallback은 다른 item에 대한 fallback을 지정할 MAY 있으며, 이런 식으로 fallback options의 chain을 만들 수 있습니다. fallback chains 사용과 관련된 추가 요구 사항은 3.5.1 Manifest fallbacks를 참조하세요.

media-overlay 속성은 이 item이 설명하는 리소스에 대한 media overlay document를 식별하는 IDREF [xml]를 받습니다. 자세한 내용은 9.3.3.5 Media overlays packaging을 참조하세요.

spine 요소는 기본 reading order를 나타내는 manifest item 참조의 순서 있는 목록을 정의합니다.

요소 이름:

spine

사용:

manifest 뒤에 오는 package의 REQUIRED 세 번째 자식.

속성:

• id [optional]

• page-progression-direction [optional]

• toc [optional] (outdated)

콘텐츠 모델:

itemref [1개 이상]

spine은 최소 하나의 EPUB content document 또는 foreign content document를 지정해야 MUST 합니다.

spine 안의 publication resources에서 hyperlink된 모든 EPUB 및 foreign content documents는 spine에 나열되어야 MUST 하며, 여기서 hyperlinking은 사용자가 현재 resource에서 벗어나 탐색해야 하는 모든 linking mechanism을 포함합니다. 일반적인 hyperlinking mechanisms에는 [html] a 및 area 요소의 href 속성과 scripted links(예: DOM Events 및/또는 form elements 사용)가 포함됩니다. hyperlinked resources를 나열해야 한다는 요구 사항은 재귀적으로 적용됩니다(즉, hyperlinked documents에서 hyperlink된 모든 EPUB 및 foreign content documents도 나열되어야 하며, 계속 이어집니다).

EPUB navigation document에서 hyperlink된 모든 EPUB 및 foreign content documents도, EPUB navigation document가 spine에 포함되어 있는지와 관계없이 spine에 나열되어야 MUST 합니다.

page-progression-direction 속성은 콘텐츠가 흐르는 전역 방향을 설정합니다. 허용되는 값은 ltr(left-to-right), rtl(right-to-left), 그리고 default입니다. default 값이 지정되면 어떤 선호도 표현되지 않으며, reading system이 rendering direction을 선택할 수 있습니다.

page-progression-direction 속성이 전역 flow direction을 설정하더라도, 개별 EPUB content documents 및 EPUB content documents의 일부는 이 설정을 override할 MAY 있습니다(예: writing-mode CSS property를 통해). Reading systems도 기본 방향을 override하는 mechanisms를 제공할 수 있습니다(예: alternate style sheets 적용을 허용하는 buttons 또는 settings).

outdated된 toc 속성은 IDREF [xml]를 받으며, 이는 NCX를 나타내는 manifest item을 식별합니다.

itemref 요소는 기본 reading order 안의 EPUB content document 또는 foreign content document를 식별합니다.

요소 이름:

itemref

사용:

spine의 자식으로 사용. 반복 가능.

속성:

• id [optional]

• idref [required]

• linear [optional]

• properties [optional]

콘텐츠 모델:

비어 있음

각 itemref 요소는 자신의 idref 속성에 있는 IDREF [xml]를 통해 manifest 안의 item의 ID [xml]를 참조해야 MUST 합니다. item 요소 IDs는 한 번을 초과하여 참조되어서는 MUST NOT 됩니다.

참조된 각 manifest item은 a) EPUB content document이거나 b) 자신의 manifest fallback chain에 EPUB content document를 포함하는 foreign content document이어야 MUST 합니다.

linear 속성은 참조된 item이 primary reading order에 기여하고 reading systems가 순차적으로 읽을 것으로 예상되는 콘텐츠 ("yes")를 포함하는지, 아니면 primary content를 향상하거나 보강하고 reading systems가 순서와 관계없이 접근할 수 있는 auxiliary content("no")를 포함하는지를 나타냅니다. auxiliary content의 예에는 notes, descriptions, answer keys가 포함됩니다.

linear 속성은 사용자가 기본 reading order의 일부로 접근해야 하는 콘텐츠와 reading system이 예를 들어 popup window에 표시하거나 aural rendering에서 생략할 수 있는 supplementary content를 구별할 수 있게 합니다.

콘텐츠가 non-linear임을 지정한다고 해서 reading systems가 이를 특정 방식으로 표시해야 하는 것은 아닙니다. 이는 목적에 대한 hint일 뿐입니다. Reading systems는 예를 들어 non-linear content를 spine에서 나타나는 위치에 표시할 수도 있고, 사용자가 spine 끝에 도달할 때까지 건너뛸 수도 있습니다.

linear itemref 요소는 linear 속성 값이 명시적으로 "yes"로 설정되어 있거나 속성을 생략한 요소입니다 — reading systems는 속성이 없는 itemref 요소에 대해 "yes" 값을 가정합니다. spine은 최소 하나의 linear itemref 요소를 포함해야 MUST 합니다.

Reading systems가 spine을 진행하는 동안 non-linear content에 대한 접근을 제공하지 않을 수 있으므로, 모든 non-linear content에 접근할 수 있는 secondary means가 제공되어야 MUST 합니다(예: 콘텐츠 안의 hyperlinks 또는 EPUB navigation document를 통해).

Spine Properties Vocabulary는 properties 속성의 default vocabulary입니다.

다른 vocabularies의 terms는 5.3 어휘 연결 메커니즘에 정의된 대로 추가될 MAY 있습니다.

pre-paginated fixed layout에서는 spine itemref가 참조하는 각 fixed-layout document가 content의 한 페이지를 나타냅니다. Reading systems는 document를 viewport 또는 synthetic spread에 맞게 scale할 것으로 예상됩니다.

EPUB publication이 pre-paginated fixed layout을 사용함을 나타내기 위해, pre-paginated 값을 지정하는 meta 요소에서 rendition:layout property를 선언합니다.

전체 EPUB publication이 pre-paginated를 가진 것으로 설정하는 것 외에도, 일부 spine items가 pre-paginated임을 지정하기 위해 reflowable layout을 override할 수 있습니다. 이를 위해 pre-paginated인 각 spine itemref의 properties attribute에 rendition:layout-pre-paginated spine override를 설정합니다.

spine item에 대해 property가 pre-paginated로 설정되면, itemref 요소는 fixed layout document를 참조해야 MUST 하거나, manifest fallback chain 안에 하나가 있어야 MUST 합니다.

rendition:layout property가 roll 값을 가진 meta 요소에 선언되면, 이는 content가 roll임을 나타냅니다(즉, reading systems가 각 spine itemref의 너비를 viewport에 맞추고 visible gap 없이 continuous roll로 표시함). roll layout style은 전역적으로 적용되며(즉, 모든 spine items에 대해) override할 수 없습니다.

roll layout이 선언되면, 각 spine item은 fixed-layout document를 참조해야 MUST 합니다. 각 document의 dimensions는 7.3.2 Fixed-layout document dimensions에 정의된 대로 설정되어야 MUST 합니다.

Package rendering vocabulary의 다른 properties 또는 spine overrides는 roll layouts의 rendering을 제어하는 데 사용할 수 없습니다.

XHTML 콘텐츠 문서는 다음을 만족해야 합니다:

• 명시적으로 7.1.4 HTML deviations and constraints에서 override되지 않는 한, [html]이 정의한 모든 document constructs에 대한 conformance criteria를 MUST 준수해야 합니다.

• 7.1.3 HTML extensions에 정의된 대로 [html] grammar에 대한 extensions를 포함할 MAY 있으며, 그 안에 정의된 모든 content conformance constraints를 MUST 준수해야 합니다.

• XML syntax를 준수하는 [html] document여야 MUST 합니다.

달리 지정되지 않는 한, XHTML 콘텐츠 문서는 [html] specification에서 semantics, structure 및 processing behaviors에 관한 모든 정의를 상속합니다.

이 절은 underlying [html] document model에 대한 EPUB 3 XHTML 콘텐츠 문서 extensions를 정의합니다.

이 절은 EPUB 3 XHTML 콘텐츠 문서에 적용되는 underlying [html] document model로부터의 deviations 및 그에 대한 constraints를 정의합니다.

SVG 콘텐츠 문서는 conforming SVG stand-alone file [svg]이어야 MUST 하며, 7.2.3 Restrictions on SVG에 표현된 모든 content conformance constraints를 준수해야 합니다.

이 specification은 SVG 콘텐츠 문서와 XHTML 콘텐츠 문서 안에 inclusion 방식으로 embedded된 SVG의 content model을 다음과 같이 제한합니다:

• [svg] foreignObject element:

  • [html] flow content 또는 정확히 하나의 [html] body element를 포함해야 MUST 합니다.

    참고

    inclusion 방식으로 embedded된 SVGs의 경우, [html]에 정의된 restrictions on SVG에 따라 body element는 허용되지 않습니다.

  • 7.1.2 XHTML requirements에 정의된 XHTML 콘텐츠 문서 모델을 준수하는 valid document fragment를 포함해야 MUST 합니다.

• [svg] title element가 marked-up text를 포함하는 경우, markup은 HTML namespace [infra]에 선언된 elements만 포함해야 MUST 합니다.

  참고

  [svg] title element는 markup elements를 허용하지만, 이 feature에 대한 support는 제한적입니다. 최대 interoperability를 위해 text-only titles 사용이 권장됩니다.

• 지정된 경우, epub:type attribute는 renderable elements [svg]에만 포함되어야 MUST 합니다.

  참고

  SVG content model은 authors가 namespaced attributes를 포함할 수 있게 하므로, 이 specification은 epub:type attribute 또는 vocabulary association mechanisms를 허용할 필요가 없습니다.

  그러나 reference 방식과 inclusion 방식으로 embedded된 SVGs 사이의 한 가지 key difference는, inclusion 방식으로 embedded된 SVGs는 root svg element [svg]에 epub:prefix attribute를 가질 수 없다는 점입니다. 자세한 내용은 5.3.4 The prefix attribute를 참조하세요.

이 절은 fixed-layout documents의 dimensional properties의 expression 및 interpretation에 대한 rules를 정의합니다.

Fixed-layout documents는 자신의 format에 적용되는 방식으로 initial containing block [css2]을 지정합니다:

XHTML에서 표현

XHTML fixed-layout documents의 경우, initial containing block [css2]은 viewport meta tag 안의 REQUIRED height 및 width definitions에서 얻으며, 여기서:

• height property는 자신의 value로 양의 number [css2] 또는 keyword device-height를 가져야 MUST 합니다; 그리고
• width property는 자신의 value로 양의 number [css2] 또는 keyword device-width를 가져야 MUST 합니다.

device-width 및 device-height 값은 각각 reading system의 viewport의 width 및 height의 100%를 나타냅니다.

height 및 width definitions는 [html] head element에서 document order상 첫 번째 viewport meta tag에 지정되어야 MUST 합니다. Reading systems는 이후의 viewport meta tags를 무시합니다.

EPUB creators는 viewport meta tag 안에 하나를 초과하는 height 또는 width definition을 지정해서는 MUST NOT 됩니다.

SVG에서 표현

SVG fixed-layout documents의 경우, initial containing block [css2] dimensions는 viewBox attribute [svg]를 사용해 표현되어야 MUST 합니다.

image foreign resources에서 표현

spine에서 참조되는 image foreign resources의 경우, initial containing block [css2]은 image의 width 및 height metadata에서 얻습니다. 이 metadata가 저장되는 방식에 대한 정보는 해당 image format의 documentation을 참조하세요.

EPUB publication의 primary navigational hierarchy는 nav element [html] 안에 정의되며, 그 epub:type attribute는 "toc" [epub-ssv-11] 값으로 설정됩니다 (즉, toc nav element). 이 element는 개념적으로 인쇄물의 table of contents에 해당하며, publication의 주요 structural sections로 navigation을 제공합니다.

toc nav element의 references는 다음 둘 모두를 반영하도록 ordered되는 것이 좋습니다 SHOULD:

• referenced EPUB content documents가 spine에 있는 순서; 그리고

• 각각의 EPUB content documents 안에서 target된 elements의 순서.

page list는 content 안의 static page boundaries로 navigation을 제공합니다. 이러한 boundaries는 print 같은 statically paginated source에 해당하거나, EPUB publication 전용입니다.

page list는 nav element [html] 안에 정의되며, 그 epub:type attribute는 "page-list" [epub-ssv-11] 값으로 설정됩니다 (즉, page-list nav element).

page-list nav element는 단일 ol descendant만 포함하는 것이 좋습니다 SHOULD (즉, nested sublists 없음).

Landmarks는 reading systems가 사용자에게 content의 fundamental structural components에 효율적으로 접근할 수 있도록 하기 위해 이를 식별합니다 (예: user interface의 dedicated button을 통해).

Landmarks는 nav element [html] 안에 정의되며, 그 epub:type attribute는 "landmarks" [epub-ssv-11] 값으로 설정됩니다 (즉, landmarks nav element).

landmarks nav element는 단일 ol descendant만 포함하는 것이 좋습니다 SHOULD (즉, nested sublists 없음).

epub:type attribute는 landmarks nav element의 a element descendants에서 REQUIRED입니다. landmarks nav element 안의 각 link target의 structural semantics는 이 attribute의 value에 의해 결정됩니다.

landmarks nav는 같은 resource 또는 그 fragment를 reference하면서 같은 epub:type value를 가진 multiple entries를 포함해서는 MUST NOT 됩니다.

landmarks nav에 정의되는 items의 수는 reading system이 user interface에서 사용할 가능성이 높은 items로만 제한하는 것이 권장됩니다. 이 element는 목차를 반복하기 위한 것이 아닙니다.

사용 가능한 경우 다음 landmarks를 포함하는 것이 권장됩니다:

• bodymatter [epub-ssv-11] — Reading systems는 사용자가 읽기 시작할 때 front matter를 지나 자동으로 이동하도록 이 landmark를 자주 사용합니다.
• toc [epub-ssv-11] — 목차가 spine에서 사용 가능한 경우, reading systems는 사용자를 이를 포함하는 document로 이동시키기 위해 이 landmark를 사용할 수 있습니다.

landmarks nav에 포함할 수 있는 다른 possibilities로는 indexes 및 glossaries 같은 key reference sections가 있습니다.

landmarks nav는 reading system use를 위한 것이지만, landmarks nav의 labels가 사람이 읽을 수 있도록 보장하는 것이 여전히 권장됩니다. Reading systems가 links를 사용자에게 직접 노출할 수도 있습니다.

reading system 처리를 위해 EPUB 탐색 문서에 추가 nav elements가 필요한 경우, 이들은 다음을 만족해야 합니다:

• epub:type attribute를 지정해야 MUST 합니다;
• 8.3 nav 요소: restrictions의 content model restrictions를 준수해야 MUST 합니다.

이 specification은 추가 nav elements의 semantics에 어떤 restrictions도 부과하지 않습니다. 이들은 어떤 information domain에 대한 navigational semantics도 나타낼 MAY 있으며, homogeneous 또는 heterogeneous semantics를 가진 link targets를 포함할 MAY 있습니다.