이 챕터는 위키독스에서 전자책을 판매 중인 저자들을 위한 내용을 다루고 있습니다.
전자책 버전 관리 소개
2024년 12월 6일부터 위키독스 전자책에 버전 관리 기능이 도입되었습니다. 이 기능은 다음과 같은 문제점들을 해결하기 위해 도입되었습니다:
- 실시간 전자책 생성 과정에서 발생할 수 있는 오류
- 저자가 책을 수정 중이거나 잘못 수정한 경우의 문제
- 전자책 발송 과정에서의 오류
이제 저자는 검증된 특정 버전의 전자책만 판매할 수 있도록 버전 관리 체계가 도입되었습니다.
버전 관리 사용 방법
1. 전자책 탭 확인
[책 수정] 화면에서 새롭게 추가된 [전자책] 탭을 통해 버전 관리 기능을 사용할 수 있습니다.
현재 위키독스에서 판매 중인 모든 전자책은 기본적으로 버전 1로 설정되어 있습니다.
2. 버전 정보 확인
[전자책] 탭에서 다음 정보를 확인할 수 있습니다:
- 현재 버전
- 생성 일시
구매자는 항상 현재 버전의 책을 받게 되며, 이후 책의 내용을 수정하더라도 구매자에게는 수정된 내용이 반영되지 않습니다.
3. 전자책 개정
구매자에게 수정된 내용을 전달하려면 다음 단계를 따르세요:
- "전자책 개정 신청" 버튼 클릭
- 위키독스가 현재 책 내용을 기준으로 새로운 버전의 전자책 생성
- 개정 작업 완료 (약 10분 소요)
- [전자책] 탭의 "현재 버전"과 "생성 일시" 업데이트
- 결과 이메일 수신
오류 해결 가이드
오류 발생 시 확인사항
전자책 개정 시 오류가 발생하면, 이메일로 다음 정보가 전달됩니다:
- 오류 내역
- 오류가 발생한 LaTeX 파일
예시 오류 메시지:
오류가 발생했습니다.
책 제목: 점프 투 자바
명령어: cd /root/wikidocs/pandoc/ebook/31/4; pandoc jump2java.md -o jump2java.pdf --from markdown --template "eisvogel.tex" --listings --pdf-engine "xelatex" --top-level-division="chapter" --filter pandoc-latex-environment
오류 메시지:
Command failed with error code - [43]
Command: cd /root/wikidocs/pandoc/ebook/31/4; pandoc jump2java.md -o jump2java.pdf --from markdown --template "eisvogel.tex" --listings --pdf-engine "xelatex" --top-level-division="chapter" --filter pandoc-latex-environment
Stdout:
Stderr: Error producing PDF.
! Undefined control sequence.
[[MARK]]l.888 C:\program [[/MARK]]
오류 해결 단계
-
오류 위치 확인
- 이메일의 노란색 표시 부분 확인 (
l.888은 888번째 줄에서 오류 발생을 의미) - 첨부된 LaTeX 파일에서 해당 줄 확인
- 이메일의 노란색 표시 부분 확인 (
-
내용 수정
- 확인된 오류를 기반으로 위키독스 책 내용 수정
-
재시도
- 수정 완료 후 전자책 개정 신청 재시도
주요 오류 유형과 해결방법
-
이스케이프 문자 오류
- 문제: 파일명에 역슬래시(
\) 사용 - 해결: 역슬래시 이스케이프 처리 또는 슬래시(
/)로 변경
- 문제: 파일명에 역슬래시(
-
수식 오류
- 문제: LaTeX 수식 문법 오류
- 해결: 수식 문법 점검 및 수정
-
이미지 오류
- 문제: 이미지 파일 누락 또는 외부 이미지 사용
- 해결: 이미지 파일 경로 확인, 외부 이미지는 다운로드 후 업로드
-
HTML 태그 오류
- 문제: 지원되지 않는 HTML 태그 사용
- 해결: HTML 태그 제거 또는 LaTeX 스타일로 변환
참고 자료
- 전자책 작성 시 주의할 점: https://wikidocs.net/198723