내맘대로의 EPUB 제작 가이드

시길 사용 설명서 배포합니다.

시길 2.3.1 버전 내용까지 포함했습니다.

https://bit.ly/3ZnPU1d

Sigil로 전자책 만드는걸 공부할 분들은 이 책으로 시작하세요.

이 오류는 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 이름이 정확한지 확인해 보시기 바랍니다.