내맘대로의 EPUB 제작 가이드

Sigil은 opf 파일을 자동으로 관리합니다. 그래서 opf 파일을 수정 할 일은 거의 없습니다.

하지만 고급 편집자는 opf 파일의 구조를 정확히 알고 있습니다.

opf 파일이 EPUB이다 라고 해도 될 정도로 중요한 파일이기 때문이지요. 

EPUBCheck를 실행해 보면 가끔식 opf 파일 오류가 표시됩니다.

그 중에 속성이 선언되지 않았다는 오류가 있습니다.

이런 오류지요.

error(opf-014): "scripted" 속성은 opf 파일에 선언되어야합니다.

error(opf-014): "***" 속성은 opf 파일에 선언되어야합니다.

이 오류는 특정 파일의 속성(properties)을 제대로 선언하지 않았을 때 발생합니다.

script 연결 기능으로 스크립트 파일을 연결하면, Sigil은 알아서 scripted 속성을 opf 파일에 선언합니다.

하지만 스크립트 작업을 하다 보면 직접 삽입 할 때도 많이 있습니다.

편집자가 직접 스크립트 링크를 연결했다면 Sigil은 자동으로 opf 파일에 선언을 할 수 없습니다.

이럴 때 opf 파일을 열어 속성을 지정해 줘야 합니다.

scripted 속성 외에도 mathml, svg, nav, remote-resource 등 다양한 속성이 있습니다.

자세한 내용은 epub 기술 문서를 참고하세요.

CSS에 (오류: ...)에 해당하는 오류가 있을 때 표시됩니다.

(오류: ...) 내용은 CSS의 오류 종류에 따라 달라집니다.

이 오류가 표시되는 이유의 90%는 오타입니다.

수업이나 블로그 통해 이 오류 문의를 가끔 받는데, 지금까지 모두 오타 때문에 생긴 오류였습니다.

이런 오류가 보인다면 해당 부분 또는 앞뒤에 오타가 있는지 확인하시기 바랍니다.

이 오류는 EPUB에서 사용할 수 없는 HTML 태그를 사용했을 때 표시됩니다.

Col: 10: ERROR(RSC-005): "ruby" 요소는 어디에도 사용할 수 없습니다.; end-tag 요소, text 또는 "a", "abbr", "acronym", "applet", "b", "bdo", "big", "br", "cite", "code", "del", "dfn", "em", "i", "iframe", "img", "ins", "kbd", "map", "noscript", "ns:svg", "object", "q", "samp", "script", "small", "span", "strong", "sub", "sup", "tt" 또는 "var" (with xmlns:ns="http://www.w3.org/2000/svg") 요소이(가) 예상됨 파일을 분석하는 동안 "오류"가 발견되었습니다.

ruby, aside, mark, header, footer, section 같은 태그를 EPUB2.0 버전에서 사용했을 때 이런 오류가 표시됩니다.

HTML5.0 이후 버전에서 추가된 태그를 EPUB2에서 사용할 때 이런 오류가 표시될 가능성이 높습니다.

u 태그는 구 버전에서 밑줄(underline)을 표시하기 위해 사용하였으나 HTML5.0 이후 버전에서 비텍스트 주석(non-textual annotation) 처리를 위한 태그로 변경되었고, 더 이상 밑줄을 긋기 위한 태그로 사용하지 않습니다. 그래서 EPUB2에서는 u 태그를 사용하면 이 오류가 표시됩니다.

이 오류를 해결하려면 EPUB에서 사용할 수 없는 html 태그를 파악하고 사용을 피해야합니다.

EPUB2에서 이런 오류가 자주 발생을 하기 때문에 아래와 같은 태그는 EPUB2 편집을 할 때 사용을 하지 않아야 합니다.

● ruby: 루비 문자를 표현하는 데 사용됩니다. (예: 한자 위에 발음을 표기)
● mark: 텍스트의 특정 부분을 강조하는 데 사용됩니다.
● section, footer, header: 문서의 구조를 나타내는 데 사용됩니다.
● aside: 본문 내용과 관련된 추가 정보를 제공하는 데 사용됩니다.
● figure: 이미지, 다이어그램 등을 포함하는 데 사용됩니다.

EPUBCheck는 오류 내용에 이 태그 대산 사용할 수 있는 태그 목록을 보여줍니다.

"a", "abbr", "acronym", "applet", "b", "bdo", "big", "br", "cite", "code", "del", "dfn", "em", "i", "iframe", "img", "ins", "kbd", "map", "noscript", "ns:svg", "object", "q", "samp", "script", "small", "span", "strong", "sub", "sup", "tt" 또는 "var"

이 태그는 모두 EPUB3에서 사용 할 수 있습니다.

따라서 이 태그를 반드시 사용해야 한다면 EPUB3로 제작을 해야합니다.

이 중 몇몇 태그는 국내 주요 유통사(교보문고, 예스24, 알라딘, 리디북스)에서 EPUB2에 사용할 수 있도록 하고 있습니다.

EPUBCheck에서 오류가 나면 유통사에 등록을 할 수 없으나 ruby, aside 등 일부 태그에 한해서 등록을 허용합니다.

유통사 별로 이용 가능한 태그 목록은 유통사 담당자에게 확인하시기 바랍니다.

이 오류는 링크 또는 링크 기능을 이용한 주석/팝업 주석을 편집할 때 종종 볼 수 있습니다.

이 오류가 생기는 이유는 ID와 관련되어 있습니다.

ID 오류와 함께 생기는 경우가 많으니 이 글도 참고하세요.

https://www.epubguide.net/574

이 오류를 제대로 해결하려면 프래그먼트 식별자가 무엇인지 알아야합니다.

EPUB에서 말하는 프래그먼트 식별자는 웹주소 또는 링크에서 사용하는 식별자를 의미합니다.

웹 주소(URL)에서 # 기호 뒤에 오는 부분을 프래그먼트 식별자라고 합니다. 마치 책의 목차에서 특정 페이지를 가리키는 쪽번호처럼, 웹 페이지 내의 특정 위치를 가리키는 역할을 합니다.

https://example.com/page#FragmentID

EPUB에서 주석 링크를 연결하거나 특정 페이지를 참조하도록 링크를 연결할 때 Fragment 식별자를 이용하지요.

오류 메시지를 잘 읽어보면 왜 오류가 생겼는지 알 수 있습니다.

Col: 26: ERROR(RSC-012): Fragment 식별자가 정의되지 않았습니다.

식별자가 정의되지 않았다는 것은, 식별자에 사용한 ID를 찾을 수 없다는 의미입니다. 식별자는 사용했는데 ID가 없으니 정의되지 않았다고 오류메시지를 표시하는것이지요.

Fragment 식별자를 사용하려면 본문의 특정 위치를 가리키는 ID가 있어야합니다. 본문 내 주석 번호라면 이 번호가 가리키는 주석 설명에 ID가 반드시 있어야합니다. 그래야 링크를 클릭할 때 그 위치로 넘어가겠지요?

ID가 없으면 EPUBCheck는 Fragment 식별자가 정의되지 않았다는 오류메시지를 표시합니다.

오류가 생겼다면 ID가 없거나, ID 이름에 오타가 있거나 둘 중 하나입니다.

ID도 대소문자를 구분하기 때문에 footnoteID01과 footnoteid01은 서로 다른 식별자입니다.

<p>...<a href="#footnoteid01">1)</a>...</p>

...

<p class="footnoteID01">...</p>

이렇게 대소문자를 틀리게 입력해도 EPUBCheck는 식별자가 정의됮 않았다고 메시지를 보냅니다.

링크 파일 경로를 잘못 지정해도 이런 오류가 생길 수 있으니 파일 경로, ID 이름이 정확한지 확인해 보시기 바랍니다.

이 오류는 추가 설명이 필요 없습니다.

오류 메시지만 읽어 봐도 문제의 원인과 해결 방법을 쉽게 알 수 있습니다.

Col: -1: WARNING(PKG-010): 파일명 "***"에 공백이 포함되어 있습니다. 구형 판독 시스템과 상호 운용성 문제가 발생할 수 있습니다.

EPUB에 포함된 파일 명에 공백이 포함되어 있을 때 표시되는 오류입니다.

file name.jpg

file name.xhtml

file name.otf

이렇게 파일 명 중간에 공백이 있으면 오류가 표시됩니다.

EPUB은 파일 명 사이에 공백을 허용하지 않습니다.

해결 방법은 설명 안해도 되겠지요?

링크(팝업) 주석, 또는 내부 링크를 연결한 책에서 이런 오류가 생길 수 있습니다.

인디자인 같은 조판 프로그램에서 EPUB으로 추출한 후 파일을 합치거나 해도 이런 오류가 생길 수 있지요.

Col: 18: ERROR(RSC-005): Duplicate "IDname" 파일을 분석하는 동안 "오류"가 발견되었습니다.

이 오류는 HTML의 ID 생성 규칙을 알아야 해결 할 수 있습니다.

ID는 프래그먼트 식별자를 이용해 다른 위치를 가리키기 위한 고유 식별자입니다.

말이 어렵지요?

프래그먼트 식별자는 URL 또는 소스의 경로(파일 위치 표시할 때 src="../path/file.xhtml"로 쓰는)를 지정할 때 사용하는 규칙이에요. html 파일은 수백 줄 이상 내용이 들어갈 때가 많습니다. 링크를 걸면서 특정 위치, 예를 들어 특정 소제목이나 본문 중간 어디쯤에 있는 단어나 이미지를 가리키고 싶을 때 쓰는 것이지요.

홈페이지 주소라면 이렇게 표시합니다.

https://example.com/content.html#fragmentID

EPUB에서 내부 링크를 걸었다면 이렇게 되지요.

<a href="../Content/Conteht.xhtml#fragmentID">

경로 뒤에 붙은 #fragmentID를 프래그먼트 식별자라고 합니다.

그리고 프래그먼트 식별자가 가리키는 곳에 고유 식별자, ID가 있습니다.

'고유'란 단어의 뜻을 아시지요? 국어시간이 아니니 설명은 넘어가고...

고유식별자는 HTML 태그에 id="fragmentID" 처럼 붙입니다.

<p id="fragmentID ">.....</p>

만약 content.xhtml 파일에 fragmentID가 두개라면 어떻게 될까요?

<p id="fragmentID">여기에 링크를 걸어야 합니다.</p>

....

<p>id="fragmentID">여기에도 링크를 걸어야 합니다.</p>

이렇게 되어 있다면 <a href="../Content/Conteht.xhtml#fragmentID">이 링크는 어디로 이동할까요?

같은 파일 안에 동일한 ID가 두개 이상 있을 경우 링크로 연결을 할 수 없습니다. 둘 중 어디를 가리키는지 확인할 수 없으니까요.

그래서 같은 파일 안에 ID 이름은 반드시 하나만 존재해야 합니다.

fragmentID01, fragmentID02, fragmentID03...이렇게요.

그런데 편집을 하다 몇 번까지 만들었는지 잊고 같은 ID를 썼다면

fragmentID01, fragmentID02, fragmentID03, fragmentID03, fragmentID04

EPUBCheck가

Duplicate "fragmentID03" 파일을 분석하는 동안 "오류"가 발견되었습니다.

Duplicate "fragmentID03" 파일을 분석하는 동안 "오류"가 발견되었습니다.

라는 오류를 표시합니다.

이 오류는 항상 2개 이상 표시가 됩니다. fragmentID03이 최소 2개가 있는데 둘 중 어느 ID가 제대로 된 값인지 EPUBCheck는 알 수 없거든요. 그래서 두개(혹은 그 이상) 위치를 모두 오류메시지에 표시를 합니다. 

수정 방법은 간단합니다. ID 이름을 바꾸면 돼요.

단, ID 이름을 바꾼 후 프래그먼트 식별자의 ID도 함께 수정을 해 줘야돼요.

그렇지 않으면 Col: 37: ERROR(RSC-012): Fragment 식별자가 정의되지 않았습니다.라는 오류가 표시되거든요.이 오류는 다음 글에서 설명하겠습니다.