내맘대로의 EPUB 제작 가이드

전자책용 CSS를 편집할 때 가장 먼제 선언하는게 @font-face 룰입니다.

​

@font-face {

font-family : "font-name";

src=url("../Fonts/fontfile.ttf");

}

​

이런 룰이 글꼴 수 만큼 들어갑니다.

항상 똑같은 글꼴을 사용하면 복붙을 하면 되겠지만,

저처럼 책마다 책에 어울리는 글꼴을 찾아 추가하는 편집자들 한테는 아주 귀찮은 작업이지요.

​

저 처럼 폰트 룰을 선언하는게 귀찮았던 사람이 많았나봅니다.

클릭 한번으로 EPUB에 포함시킨 모든 폰트를 CSS 룰로 만들어 주는 플러그인을 만들었네요.

(저도 EPUBCheck 다음으로 많이 사용하는 플러그인이에요.)

https://www.mobileread.com/forums/showpost.php?p=3332590&postcount=17

사용법은 아주 간단합니다.

​

1. 먼저 EPUB에 사용할 글꼴 파일을 추가합니다.

2. CSSFromFonts 플러그인을 실생시킵니다.

플러그인 추가 방법은 :

www.epubguide.net/345 참조하세요.

플러그인이 실행되면 이런 메시지가 표시됩니다.

OK를 눌러 창을 닫습니다.

3. CSS 파일을 확인합니다.

​

4. 확인 사항

- CSS 파일이 없으면 font.css라는 파일을 만들어 @font-family 룰을 추가합니다.

- 사용하는 CSS 파일이 있으면 CSS 파일 제일 위에 룰을 추가합니다. CSS 파일 안에 있는 다른 값은 그대로 있습니다.

- 혿 따옴표 대신 쌍 따옴표를 넣고 싶다면

1) 기본 설정 폴더의 [sigil-ebook\sigil\plugins\CSSFromFonts]로 이동

2) 메모장 같은 텍스트 편집기로 plugin.py 파일 열기

3) 아래 라인을 찾아 수정

# write font family

수정 전: font_css += '@font-face {\n font-family: ' + "'" + font_family + "';\n"

​

수정 후: font_css += '@font-face {\n font-family: ' + '"' + font_family + '";\n'

​

5. font-family는 원하는 이름으로 수정해 사용하면 됩니다.

EPUB 전자책 편집을 위해 Sigil을 사용하는 이유 중 하나가 플러그인입니다.

플러그인을 쓰지 않는다면, Sigil의 기능을 반만 사용하는 것과 같지요.

Sigil 플러그인은 아주 다양합니다.

이 중에 나에게 필요한 플러그인을 찾으려면 어떤 플러그인이 있는지 알아야겠지요?

​

전자책 편집을 하면서 도움이 됐던 플러그인을 하나씩 소개하고, 사용 방법을 설명하겠습니다.

​

먼저, EPUB을 만드는 모든 사람이 반드시 써야하는 것이 EPUBCheck입니다.

EPUBCheck는 EPUB 표준을 만들고 있는 W3C라는 곳에서 배포하는 EPUB 적합성 검사기입니다.

EPUB을 표준에 맞게 만들었는지, 구조적으로 문제는 없는지를 검사해 주고,

문제가 있는 부분을 찾아 어떤 문제인지, 문제를 어떻게 수정해야 하는지를 알려줍니다.

​

EPUBCheck에 대해 자세히 알고 싶다면 여기를 방문해 보세요.

https://github.com/w3c/epubcheck

Sigil에는 W3C의 EPUBCheck를 쉽게 사용할 수 있는 EPUBCheck 플러그인을 제공합니다.

EPUBCheck는 4.2.4 버전이 배포되었고, EPUBCheck 플러그인은 0.4.5.1 버전입니다.

​

여기서 잠깐!!

​

EPUBCheck와 EPUBCheck 플러그인을 혼동하는 분이 많이 있어요.

EPUBCheck는 W3C에서 배포하는 EPUB 적합성 검사 프로그램입니다.

EPUBCheck 플러그인은 EPUBCheck를 Sigil에서 사용하기 쉽게 도와주는 Sigil 전용 프로그램이에요.

EPUBCheck 플러그인은 최신 EPUBCheck를 포함하고 있기 때문에 Sigil에서는 EPUBCheck 플러그인만 추가하면 EPUBCheck를 사용할 수 있습니다.

​

​

1. EPUBCheck 플러그인은 여기서 다운로드 합니다.

https://www.mobileread.com/forums/showthread.php?p=2950625#post2950625

플러그인 파일명은 EpubCheck_vx.x.x.zip입니다.

최신 버전은 EpubCheck_v0.4.5.1.zip이고, EPUBCheck 4.2.4 버전이 포함되어 있습니다.

다운로드 받은 파일은 압축을 풀지 않은 zip 파일 상태로 저장해 둡니다.

​

2. Sigil 메뉴에서 [플러그인 > 플러그인 관리]를 실행합니다.

플러그인 관리를 실행하면 [번들 Python 사용]이 체크되어 있습니다.

체크되어 있지 않다면 체크를 하세요.

참고로, 플러그인 사용하는데 Python이 뭔지 몰라도 됩니다.

파이선 설치를 할 필요도 없습니다.

Sigil 플러그인 목록 페이지에서 제공하는 플러그인은 대부분 번들 파이선으로 실행을 할 수 있습니다.

그리고 플러그인 실행에 필요한 대부분의 라이브러리도 함께 제공합니다.

​

3. [플러그인 추가]를 누른 후 다운로드 받은 EPUBCheck 플러그인 파일을 선택해 플러그인을 추가합니다.

4. EPUBCheck 단축 아이콘을 설정합니다.

플러그인 관리창에 [도구 아이콘 연결]이라는 탭이 있습니다.

도구아이콘을 연결했으면 [확인]을 눌러 플러그인 관리 창을 닫습니다.

도구 아이콘을 연결하면 Sigil 도구 모음에 저렇게 EPUBCheck 아이콘이 표시됩니다.

​

5. EPUBCheck 도구 아이콘을 클릭해 플러그인을 실행합니다.

EPUB에 문제가 있다면 [유효성 검사 결과] 창에 오류에 대한 설명이 표시됩니다.

​

​

6. 오류를 수정하고 싶다면 오류 메시지를 더블클릭 합니다.

오류 메시지를 더블클릭 하면 오류가 있는 위치가 코드보기 창에 표시됩니다.

오류 메시지를 읽어 보면 무슨 오류인지 설명이 나와 있습니다.

'i' 태그는 여기에 사용할 수 없다는 메시지입니다.

​

i 태그는 인라인 태그이기 때문에 블럭태그 안에 사용해야 합니다. 그런데 블럭태그 없이 i 태그를 사용해서 생긴 문제입니다.

오류 메시지에서 i 태그를 감쌀 수 있는 다양한 태그 목록을 같이 보여줍니다. 태그 목록 중 p 태그를 선택해 i 태그를 감싸 오류를 수정합니다.

Duplicate 오류는 ID가 중복되어 생긴 오류입니다.(번역이 안됐네요 ㅜ.ㅜ 찾아서 수정하겠습니다.)

ID가 중복되었으니 중복되지 않게 ID 이름을 수정하면 오류가 해결됩니다.

7. 오류를 수정하고 다시 EPUBCheck 플러그인을 실행하면 문제를 찾지 못했다는 메시지가 표시됩니다.

​

8. EPUBCheck 플러그인 설치시 확인할 사항

- Java가 설치되지 않았거나 1.6 이전 버전인 PC

EPUBCheck는 Java로 실행됩니다. Java가 설치되지 않은 PC에서는 EPUBCheck를 실행할 수 없습니다. EPUBCheck 플러그인이 정상적으로 실행되더라도 아래 같은 오류가 표시됩니다.

W3C에서 배포하는 최신 EPUBCheck는 Java 1.7 이후 버전을 지원하기 때문에

Java 1.6 이전 구 버전이거나 Java가 설치되어 있지 않다면 저런 오류가 표시됩니다.

이 오류는 Java 최신 버전을 설치하면 간단히 해결됩니다.

https://java.com/ko/

만약 피치 못할 사정으로 Java 구 버전을 사용해야 한다면, Java 1.6을 지원하는 EPUBCheck 플러그인을 사용하세요.

EPUBCheck 4.0.2 버전까지 Java 1.6을 지원하고

EPUBCheck 플러그인 0.4.0 버전이 EPUBCheck 4.0.2를 포함하고 있습니다.

플러그인 파일이 필요한 분은 여기서 다운받으세요.

https://www.epubguide.net/341

- 구 버전에서 최신 버전으로 Sigil을 업그레이드 한 경우

Sigil 0.9.5 이후 버전은 이전 버전과 구조적으로 큰 차이가 있습니다.

지속적인 업데이트를 한 분들은 문제가 없지만, 0.9.4 이전 버전에서 1.4 버전으로 업데이트를 하면 오류가 생길 수 있습니다.

​

이때는 [편집 > 설정 > 기본설정 위치열기]를 눌러 이 안에 있는 모든 파일을 삭제하세요.

구 버전 설정파일이 날아가는건 어쩔 수 없습니다.

지속적인 업데이트를 했다면 이런 문제가 생기지 않지만,

잘못된 정보를 보고 업데이트를 하지 않았기 때문에 생긴 문제입니다.

​

다음엔 EPUB에 추가한 폰트를 간단히 CSS 룰로 추가해 주는 CSSFromFonts 플러그인을 소개하겠습니다.

http://jikji.duckdns.org/book/131

Sigil 사용 설명서 - Part2 HTML&CSS : HTML편을 공개합니다.

HTML 기본 문법과 전자책 편집을 할 때 많이 사용하는 태그에 대한 설명을 담았습니다.

기능편은 여기로...

jikji.duckdns.org/book/128

CSS편, 실습편, 예제편은 작업중입니다.

이 책의 모든 내용은 Sigil 1.4.x로 집필 및 편집하고 Sigil 플러그인을 이용해 PDF로 발행했습니다.

EPUB3는 공식적으로 HTML5, JavaScript, CSS3에 대한 제한을 거의 두지 않았습니다.

그러니 EPUB3는 Web에서 표현 가능한 거의 모든 기능을 다 구현할 수 있습니다.

​

Sigil 역시 EPUB3를 완벽히 지원합니다.

제한 없이 JavaScript를 사용할 수 있고, HTML5, CSS3로 자유롭게 기능을 구현할 수 있습니다.

​

단!!!!!

기능 구현에 대한 제한은 두지 않았지만,

뷰어가 지원해야 하는 최소 기준은 아주 아주 관대해요.

EPUB3 뷰어는 비디오나 오디오를 지원하지 않을 수 있습니다.

JavaScript도 지원하지 않을 수 있습니다.

MathML이나 SMIL도 지원하지 않아도 됩니다.

이런 기능들은 MUST가 아닌 MAY나 RECOMMENDED입니다.

그래서 많은 EPUB3 지원 뷰어들이 이런 기능을 지원하지 않지요.

​

D3.js를 사용한 복잡한 기능은 EPUB3에서 제한 없이 구현할 수 있습니다.

다만, 지원하는 뷰어가 많지 않아 구현하지 않는 것 뿐이지요.

​

D3.js가 무엇인지 궁금하신 분들, EPUB3로 어디까지 가능한지 궁금하신 분들은

첨부파일을 다운받아 calibre나 Sigil PageEdit로 열어보세요.

​

Calibre에서는 이렇게 보입니다.

Sigil PageEdit에서는 이렇게 보입니다.

소스 원본은 여기서 확인할 수 있습니다.

http://bl.ocks.org/mbostock/1096355

교보ebook(모바일), iBooks는 jquery는 '거의' 지원을 합니다.

중급 정도의 복잡한 인터렉션 까지는 js로 구현해 유통할 수 있습니다.

EPUBCheck는 W3C에서 관리/배포하는 EPUB 적합성 검사 프로그램입니다.

github.com/w3c/epubcheck/releases/

현재 4.2.4 버전이 최신인데, 이 버전에 약간의 문제가 있습니다.

EPUB에 첨부하는 파일은 한글명, 띄어쓰기 등을 사용할 수 없습니다.

파일명은 영문, 숫자, 특수문자 몇개 뿐이에요.

그래서 이미지 파일에 띄어쓰기나 한글 파일명이 있으면 EPUBCheck에서 오류가 생깁니다.

EPUBCheck 플러그인은 Sigil에서 EPUBCheck를 쉽게 사용할 수 있도록 도와주는 프로그램입니다.

EPUBCheck 0.4.5.1버전이 최신입니다.

www.mobileread.com/forums/showthread.php?p=2950625#post2950625

EPUBCheck와 EPUBCheck 플러그인을 혼동하지 마세요.

EPUBCheck 플러그인 최신버전에는 EPUBCheck 4.2.4가 포함되어 있습니다.

한글 파일명 오류를 제대로 체크하지 못합니다.

그래서 오류가 없는 버전으로 바꿔야합니다.

EPUBCheck 4.2.2 버전에는 이 오류가 없습니다.

EPUBCheck 플러그인 최신 버전을 설치한 후

EPUBCheck 4.2.2로 수정을 하면 문제를 해결할 수 있습니다.

오류가 수정된 버전이 나오기 전까지는 4.2.2 버전을 쓰는게 좋지요.

1. Sigil에서 최신 버전 EPUBCheck 플러그인을 설치합니다.

2. EPUBCheck 4.2.2 버전을 다운로드합니다.

     github.com/w3c/epubcheck/releases/tag/v4.2.2

3. Sigil 설정 폴더로 이동합니다.

[편집>설정>기본 설정 위치 열기]를 누르면 쉽게 이동할 수 있습니다.

4. [Sigil>Plugins>EpubCheck] 폴더로 이동합니다.

5. EPUBCheck 4.2.2 압축을 풀고

     - lib 폴더, epubcheck.jar 파일을 [Sigil>Plugins>EpubCheck] 폴더에 복사합니다.

6. [Sigil>plugins_prefs>EpubCheck] 폴더로 이동합니다.

     - EpubCheck.json파일을 메모장이나 텍스트 편집기로 엽니다.

     - update_check를 false로 수정합니다.

    {
  "update_check": false,
  "clipboard_copy": false,
  "usage": false,
  "github": true,
  "last_time_checked": "2021-01-05 22:15:58.495676",
  "check_interval": 7,
  "java_path": "java",
  "is32bit": false
}

이제 EPUBCheck로 검사를 하면 한글 파일명을 제대로 찾아 줄 거예요.

맥 OS Sierra는 Java 1.6버전만 사용할 수 있습니다.

Java 1.7 버전은 설치를 할 수 없지요.

그런데 EPUBCheck 최신 버전은 Java 1.7 이상 설치돼야 실행이 가능합니다.

Sigil EPUBCheck 플러그인 최신버전도 당연히 Java 1.7 이상 설치돼야겠지요.

맥 OS X Sierra처럼 구 버전 Java를 써야만 하는 상황이면

EPUBCheck를 실행할 수 업겠지요?

EPUBCheck_v0.4.0 플러그인은 Java 1.6 버전에서 돌아가는 EPUBCheck(4.0.2) 버전이 포함돼 있습니다.

Java 1.6버전을 사용해야 하는 환경이라면 이 플러그인을 사용하세요.

Sigil에서 EPUBCheck 오류가 나면 Java를 설치하면 됩니다.

java.com/ko/

Java 최신 버전을 설치할 수 없을 때(맥 OSX Sierra 말고는 거의 없을거예요)

첨부한 플러그인을 다운받아 실행해 보세요.