내맘대로의 EPUB 제작 가이드

2026년 3월 부터 교보문고, 알라딘 등 일부 유통사 전자책 뷰어에 장애인접근성 기능이 추가되었습니다.

장애인접근성 전자책은 엄밀하게 구분하면 EPUB3로 만들어야 하며 다양한 접근성 정보를 추가해야합니다.

하지만 EPUB2에서도 이미지 대체텍스트 등 간단한 작업으로 접근성을 강화 할 수 있습니다.

대체텍스트는 교보ebook  같이 장애인접근성 전자책을 지원하는 뷰어가 책을 읽을 때 이미지가 나오면 읽어줍니다.

"귀찮아서" 대체텍스트를 파일명으로 삽입하면, 소수의 독서장애인들이 책을 보기 어렵기 때문에 추가 비용을 받지 않고 할 수 있는 선에서 최소한의 노력이라도 해 보려고 합니다.

저에게 고정적으로 책을 맡겨주시는 출판사의 책은 앞으로 EPUB2에서 적용 할 수 있는 범위 내에서 접근성 기능을 강화해 제작해 드리겠습니다.

재미있는 스타일이 있어 간만에 글을 올립니다.

이런 스타일 어떻게 만들면 좋을까요?

별거 없어보이지요? 뭐가 특별한거지 싶을거예요.

글머리기호를 보세요.

안에 노란색, 테두리는 검정색입니다. 이런 약물은 어떻게 표현하면 좋을까요?

약물 뿐 아니라, 글자도 이렇게 다른 색으로 테두리를 그릴 수 있을까요?

이 스타일로 오래전에 올린 글이 있긴 한데, 찾기 힘들어 다시 올려요.

이런 스타일은 text-shadow를 사용하면 만들 수 있어요.

전자책에서는 이렇게 보입니다.

저는 점이 작아 4점 shadow를 썼는데 큰 글자는 4점으로는 각이 져 보일 수 있어요.

그럴 때는 6점이나 8점을 쓰면 돼요.

.txt_message_dot {
	color : #FFEDB3;
	text-shadow: 
		-1px 0 #000000, 
		0 1px #000000, 
		1px 0 #000000, 
		0 -1px #000000;
}

국내에는 Adobe Digital Edition(ADE)을 쓰는 사람이 거의 없습니다.

그런데 ADE를 쓰면서 자신이 앞서가는 사람이라는 듯 한 말을 하는 사람을 봤습니다.

ADE가 세계 표준이라나???

무슨 헛소리인지...

ADE는 2023년 마지막 업데이트를 했습니다.

그 후로는 업데이트를 하지 않습니다. 사실상 업데이트가 끝났다고 봐야합니다.

그리고 Adobe에서 기술지원을 하지 않습니다. 이름 앞에 Adobe라는 단어가 들어가지만 adobe 것도 아닙니다. 하만 카돈이라는 업체로 이관이 되어 더 이상 Adobe와 상관 없습니다.

국내에서는 쓰는 사라이 없지만 해외는 사용자가 의외로 많습니다.

그런데 해외 사용자 역시 울며 겨자먹기로 어쩔 수 없이 사용을 합니다.

구글 Books나 아마존 킨들이 ADE Drm을 사용해 전자책을 다운 받아 파일로 보관 할 수 있기 때문입니다.

파일을 자신의 메모리에 보관하기 위해 어쩔 수 없이 ADE를 쓰긴 하지만,

프로그램이 너무 쓰레기라 쓰고 싶지 않은 것이지요.

ADE의 장점은

아마존 킨들, 구글 Books 등 ADE DRM을 사용하는 플랫폼 간 파일 전송이 가능하다는 것입니다.

킨들에서 책을 구매하고 Kobo에서 책을 볼 수 있다는 것이지요.

그 외에 다른 장점은 없습니다.

대신 단점은 엄청나게 많습니다. Reddit 등에서 'adobe digital edition 문제점'을 검색해 보세요. 끝없이 글이 나옵니다.

ADE의 유일한 장점인 DRM부터 문제가 많습니다. 오류가 많고 사용법이 복잡합니다. 그런데 오류를 보고해도 개선이 되지 않습니다.

프로그램 품질 문제는, 그 어느 전자책 뷰어와 비교해도 압도적인 1위입니다.

업데이트를 하지 않아 인터페이스부터 문제가 많고,

속도가 느려 책을 보기 불편합니다.

대용량 도서는 제대로 열리지 않고

최신 CSS는 제대로 표현을 하지 못합니다.

아니, 최신 CSS가 아니라 가장 기본적인 CSS 정도만 제대로 표현을 합니다.

그런데 표현을 하지 못하는 것에서 끝나지 않고 표현 못하는 CSS 하나만 있어도 전체 CSS를 무시하는 오류가 있습니다.

그러니 EPUB이 편집한 대로 보이지 않고

페이지 이동 할 때 점프를 하는문제

한글 폰트를 제대로 표시하지 못하고 일부 유니코드는 아예 표현하지 못하는 문제도 있습니다.

보안 역시 문제가 많습니다.

아마존이나 구글 Books에 등록된 책은 전부 유출됐다고 해도 될 정도로 DRM에 구멍이 크게 뚤려있습니다.

그래서 킨들이나 애플 등 ADE를 사용하던 업체들이 ADE를 버리고 자체  DRM으로 옮겨가는 중입니다.

이런 뷰어를 이용하면서 기술 선도자인 듯 얘기하는 사람이라니...

Sigil 0.8.x 버전이 가장 좋다고 주장하는 스스로 자타공인 전문가나

윈도우 7을 쓰면서  가장 좋은 윈도우라느니 하며 우기는

새로운 기술에 적응 못하는 부적응자와 같은 부류라는 생각이 들어요.

자신이 부적응자라 새로운 기술로 나아가지 못하는 것은 이해합니다.

그런데 자신의 부적응을 숨기기 위해 타인에게 "구 버전이 최고야"라는 거짓말은 하지 않았으면 좋겠어요.

상용 LLM은 비용이 비싸 저처럼 취미 + 업무활용 수준으로 개발을 하기엔 부담이 큽니다.

그래서 구글 제미나이 프로 요금제로 Antigravity(https://antigravity.google/)를 사용하고있습니다.

개발자들의 리뷰를 보면 클로드가 베스트로 보이지만, 개발 이외에 검색, 번역, 문서작성 등 다양한 목적으로 사용하기엔 부족한 점이 많습니다. 개발만 100점인 후임과, 개발은 80점 검색은 100점 번역은 90점.... 이런 후임 중 하나를 골라야 하는 문제이기 때문에 개발자가 아니라면 제미나이나 GPT가 더 적합해 보입니다.

$20달러짜리 요금제는 토큰 제한이 있습니다. 뭔가 만들려고 하다 보면 토큰 제한에 걸려 며칠을 기다려야 합니다. 이 문제를 해결하려면 더 비싼 요금제를 사용해야 하지만 부담이 큽니다. 그래서 로컬 LLM을 사용해 보기로 했습니다. 그런데 로컬 LLM의 개발 실력이 형편 없다면 쓸 이유가 없지요. 궁금했습니다. 로컬 LLM의 개발 실력이 얼마나 좋은지.

저같은 초보에게는 Ollama가 편하고 좋습니다. 그런데 인터넷을 뒤져보니 Ollama와 llama.cpp의 속도 차이가 30%까지 난다고 하네요. 복잡한 요청 하나 하면 1시간 이상 걸리는데 30%면 아주 큰 차이입니다. 그래서 llama.cpp로 갈아타려니 여러가지 문제가 있습니다. 가장 큰 문제는 서버 하나에 모델 하나씩 밖에 올리지 못한다는 것입니다. 2개 이상 모델을 사용하려면 모델을 2개 올려야 하는데 메모리가 하나도 겨우 받아들이니... 이 문제를 해결해 보기로 했습니다. 

1. api로 요청을 하면 모델을 메모리에 올리고 요청을 실행한다.

2. api로 모델을 변경하면 기존 모델을 내리고 새로 요청한 모델을 올린다.

이게 핵심 요구사항입니다. 물론, 이것 보다 더 복잡한 요구사항이 있습니다. 모델 폴더를 지정하면 알아서 불러오고, 메모리 관리도 해야하고...

Antigravity와 Ollama를 연결한 Opencode로 Qewn3-coder-next:q8 모델에게 똑같은 요구사항을 제시하고 앱을 만들도록 시켰습니다. 그 결과는 이렇습니다.

main_a는 Antigravity가 만든 코드입니다. main_o는 Qwen3입니다. 코드의 평가는 ChatGPT에게 요청을 했습니다. GPT의 평가는 Antigravity : 9/10, Qwen3 : 6:10입니다. 무료 모델은 10점 중 6점입니다. 그래도 코드는 제대로 작동을 합니다. 혼자 쓸 코드인데 돈 안내고 토큰 걱정 없이 10점 중 6점이라면... "못 쓸 정도는 아니다" 입니다.

하지만 이정도로 만족이 되지 않아 개선 할 방법을 찾아봤습니다.

Opencode에 Oh-My-Opencode라는 게 있는데 뭔 소리인지 몰라 설치를 안했어요. 그런데 Oh-My-God 수준으로 극찬을 하기에 설치를 해 봤습니다. 오케스트레이션이니 시지프스니 하는게 뭔 소리인지는 모르겠지만, 좋은거 같아 보였어요.

설치를 하고, 로컬 모델을 연결(gemma-3-27b, Qwen-3-coder, Qwen-3.5, gpt-oss, glm4.7)했습니다.

물론 저 모델을 동시에 다 올리지 못합니다. 필요 할 때 올리고, 쓰면 내립니다. 올리고 내리는 시간이 오래 걸리지만, 일 하나 시키고 창을 내려 놓으면 알아서 일을 하는 구조라 느리지만 일을 제대로 합니다.

이번엔 main_o.py "코드의 문제점을 분석하여 개선" 하라고 시켰습니다.

알아서 모델을 바꾼다고 하더니, 그냥 Qwen-3-coder 모델 하나만 쓰네요. 왜 그런지는 모르겠습니다. 어째든, 코드 개선 하라는 지시를 2번 내렸습니다. 그리고 다시 main_a.py 코드와 비교해 봤습니다.

Oh-My-Opencode는 AI가 자기 일을 제대로 할 때 까지 반복해서 일을 한다네요. 작업 내역을 보면 분석하고 수정하기를 수십번 반복을 했습니다. 그 결과 이런 반전이 생겼습니다. GPT가 가끔 헛소리를 해서 Gemini에게도 물어봤습니다. Gemini도 Opencode 손을 들어 줬습니다.

이정도면 비싼 돈 내지 않고 로컬 모델을 돌릴만해 보입니다.

물론 컴퓨터는 MSI Edgexpert를 쓰고, 큰 모델은 gpt-oss-120b, qwen3.5-122b까지 돌아갑니다. 저 컴퓨터 가격이면 $200짜리 모델을 2년은 쓸 수 있다는....

이미지의 대체텍스트를 자동으로 생성해 주는 플러그인입니다.

ollama 같은 로컬 LLM을 사용해 이미지의 대체텍스트를 생성하고 삽입 할 수 있습니다.

EPUB2는 이미지 대체텍스트만 삽입하고,

EPUB3는 opf 파일에 접근성 메타데이터 삽입, 이미지 대체텍스트와 role을 삽입합니다.

교보문고와 알라딘 전자책 뷰어에 장애인접근성 전자책 기능을 적용했습니다. 대체텍스트가 들어가면 시각장애인들이 책을 보는 데 도움을 받을 수 있습니다. 

https://www.news1.kr/life-culture/book/6111273

하지만 대체텍스트 입력하는 작업은 시간이 오래 걸리기 때문에 대부분 파일명으로 대체텍스트를 넣습니다.

이 플러그인을 이용하면 대체텍스트를 쉽게 입력 할 수 있습니다.

1. 앱을 실행하면 이미지 경로와 섬네일, 현재 삽입되어 있는 대체텍스트를 볼 수 있습니다.

2. LLM 설정을 하고 [Alt 자동 생성] 버튼을 누르면 대체텍스트 생성을 시작합니다.

프롬프트가 아주 중요합니다. 프롬프트를 꼭 새로 편집하세요!!!

3. 대체텍스트 셀을 더블클릭 하면 텍스트를 수정 할 수 있고, role을 수정 할 수 있습니다.

4. 대체텍스트 생성 후 [OK]를 루르면 이미지 태그에 대체텍스트를 업데이트 합니다.

EPUB2는 대체텍스트만 입력합니다.

EPUB3는 role과  opf의 접근성 메타데이터를 추가합니다.