내맘대로의 EPUB 제작 가이드

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로 발행했습니다.

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 말고는 거의 없을거예요)

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

jikji.duckdns.org/book/128

Sigil 사용 설명서 기능편을 공개합니다.

Sigil 1.4.x 버전의 모든 기능을 담았습니다.

Sigil 공식 가이드인 Dave Heiland의 Sigil User Guide 0.9.15+를 뼈대로

부족한 설명을 보완하고 새로 추가된 기능을 포함해 

Sigil 1.4.x 버전으로 개정을 했습니다.

이 책은 최종 완성본이 아닌, 편집 원고 버전입니다.

기능편을 시작으로 HTML&CSS, 실습편, 예제편을 추가할 예정입니다.

이 책은 Sigil로 만들었습니다.

Sigil로 EPUB을 편집하고, Sigil 플러그인으로 PDF 변환을 한 책입니다.

Sigil 긴급 업데이트가 올라왔습니다. 

1.4.1에서 다시 업데이트가 되었습니다.

1.4.0, 1.4.1 쓰는 분들은 꼭 업데이트 하라고 합니다.

Bug Fixes Since Sigil-1.4.0:

• critical bug fix for incorrectly xml encoding of opf metadata attributes that use entities
• fix bug in "Add Existing" files when file names would require percent encoding
• fix bug in multiple language spellchecking dialog word lookup when no language attributes used
• update de, nl, sv, ko, ru translations that missed the Sigil 1.4.0 initial release
• critical bug fix for over xml encoding html used inside metadata in the opf
• revert ctrl-f to it long standing Find and Replace behaviour