내맘대로의 EPUB 제작 가이드

실시간 바탕화면 구름사진 프로그램입니다.

http://jikji.duckdns.org:8085/cloud/EarthWallpaper_v0.3.zip

DesktopEarth라는 프로그램을 쓰다가, 새로 만들어 봤습니다.

https://www.epubguide.net/551

DesktopEarth는 더 이상 업데이트를 하지 않고, 구름 소스를 제공하지 않아 약간의 변칙을 사용했지요.

구름사진 업데이트를 하기 위해 별도 스크립트를 만들고, 작업 스케쥴러에 추가해 업데이트를 시키는 불편한 방법이었습니다.

그래서 이런 부분을 개선해 새로운 앱을 만들어 봤습니다.

완성도는 DesktopEarth보다 떨어지지만, 사용성은 더 좋아졌습니다.

그리고, 몇가지 개선점도 있습니다.

1. 지구 사진을 1월 부터 12월까지 12개를 사용합니다. NASA 사이트에 들어가니 계절 별로 지구 모습이 다르더라구요. 그래서 매월 다른 지구 사진을 사용하도록 수정했습니다. 미묘한 차이지만 북극과 남극의 하얀 부분이 달라져요.

2. 운이 좋다면 ISS를 볼 수 있습니다. 업데이트 할 때 ISS가 반구 내로 들어온다면 작게 보일거예요. 저도 아직 본 적은 없어요.

[[사용법]]

상단 링크의 파일을 다운받아 적당한 곳에 압축을 풀어요. 설치 같은건 없습니다. 그냥 압축만 풀면 돼요.

실행 파일을 실행합니다.

중요!!! 실행을 하면 아이콘 트레이에 들어갑니다.

앱이 뜨지 않으니 아이콘 트레이를 확인하세요.

아이콘 트레이의 지구 아이콘을 더블클릭 하면 관리창이 실행됩니다.

1. 구름 소스

* SSEC API Key를 발급 받았다면

- SSEC에서 직접 가져올 수 있습니다. : http://realearth.ssec.wisc.edu/products/

- SSEC의 API를 발급 받아 [Key 입력] 창에 넣으면 SSEC에서 구름사진을 받아옵니다.

- 네트워크 상태에 따라 시간이 오래 걸릴 수 있습니다. 저는 1분 정도 걸리네요.

* 다른 구름 사진 소스가 있다면 URL로 가져 올 수 있습니다. 제 서버에서 SSEC를 통해 받아온 구름사진을 기본값으로 넣어놨습니다. 단, 제 서버는 언제든죽을 수 있습니다. 그리고 1시간 주기로 구름사진을 업데이트 합니다. 기본 소스를 사용한다면, 업데이트 주기를 10분으로 맞춰도 구름 사진은 1시간에 동안 변하지 않습니다.

- 위도/경도 : 위도와 경도 값을 조절해 지구의 원하는 위치를 표시 할 수 있습니다. 기본값은 당연히 대한민국!

- Zoom : 지구의 크기를 조절합니다.

- 구름 투명도 : 구름의 opacity 값을 설정합니다. 투명하게 하면 구름이 덮여있는 부분의 지구를 볼 수 있습니다.

- 구름 선명도 : 구름의 진하기를 조절합니다. 투명도와 비슷하게 보이겠지만, 투명과 선명의 단어 차이를 아실테니 추가 설명은 생략.

- 주기 : 구름사진 업데이트 주기입니다. 구름사진 기본 URL은 1시간 주기로 업데이트 하기 때문에 1시간 보다 짧게 잡아도 소용 없습니다. 1시간 보다 짧게 잡으려면 다른 구름사진 소스를 사용하거나 SSEC에서 직접 받아오세요.

- 시작 시 실행 : 윈도우 실행되면 자동으로 실행됩니다.

- 자전축 : 자전축을 조절합니다.

- 구름 업데이트 : 구름 이미지를 즉시 업데이트 합니다. 

- 배경화면 적용 : 수정한 설정을 즉시 반영해 확인 할 수 있습니다.

- 설정 초기화 : 모든 설정을 기본값으로 돌립니다.

빈 줄을 추가 할 때

<p><br/></p>와 <p>&#160;</p>

이 두 가지 코드를 쓸 수 있습니다.

저는 그동안<p><br/></p>를 선호했는데, 의미론적으로 <p>&#160;</p>가 더 적합한 것 같습니다.

<br/>은 빈 줄이지만 아무 것도 포함하지 않기 때문에 무시를 할 수 있는 반면

&#160;은 빈 공백이 하나 들어가기 때문에 줄과 줄 사이 빈 공백이 포함되어 있음을 명확히 한다.

그래서 <br/>을 쓰는 것 보다는 공백이 더 좋다고... gemini와 gpt가 얘기를 합니다.

사소한 것이지만, 중요하기도 하니 알고 넘어가야겠습니다.

대학생이면 퍼플렉시티를 1년간 무료로 사용 할 수 있습니다.

하지만, 대학을 졸업한 사람도 대학 포털 로그인 계정이 있으면 1년 무료 사용을 할 수 있습니다.

중앙대학교 졸업생은 확실하게 1년 무료 사용이 가능합니다.

https://plex.it/referrals/YSIJ13FT

이 링크를 통해 퍼플렉시티에 로그인하세요.

로그인 주소는 본인이 사용하는 계정을 이용하면 됩니다. 

대학교 계정일 필요 없어요.

https://www.perplexity.ai/students

로그인을 했다면 학생 무료 프로모션 페이지로 이동합니다.

이 곳에서 요청하는 정보를 입력합니다.

요청 정보를 입력하면 대학 포털 로그인 페이지로 이동합니다.

거기서 대학 포털 로그인 계정에 로그인을 합니다.

그럼 끝~~

대학 포털은 졸업생도 이용할 수 있습니다.

졸업 증명서 같은 서류를 온라인으로 발급받기 위해 졸업생도 대학 포털 계정이 살아있습니다.

본인이 졸업한 대학에 포털 계정이 살아있는지 확인해 보세요.

그럼 퍼플렉시티 1년 무료 이용이 가능합니다.

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

헤르만 헤세 데미안 무료 전자책입니다. 

누구나 자유롭게 무료로 볼 수 있습니다.

web 뷰어를 지원해 서재에서 바로 볼 수 있고,

EPUB으로 다운로드 받을 수 있습니다.

Image file header may be corrupted.

이 오류는 EPUB에 포함된 이미지 파일이 깨졌거나 손상되어, 전자책 뷰어가 해당 파일을 인식하거나 열 수 없다는 심각한 문제입니다.

## '이미지 파일 헤더'란?

모든 파일의 시작 부분에는 해당 파일이 어떤 종류의 파일인지(예: '나는 JPEG 이미지 파일이다'), 크기는 얼마인지, 색상은 어떻게 표현되는지 등의 중요한 정보가 담긴 'ID 카드'와 같은 부분이 있습니다. 이것을 **'헤더(header)'**라고 부릅니다.

수프 캔의 겉면에 붙어있는 라벨을 생각하면 쉽습니다. 🥫 라벨이 찢어지거나 망가져서 '토마토 수프'인지 '옥수수 수프'인지 알 수 없다면, 내용물을 제대로 사용할 수 없습니다. 이 오류는 이미지 파일의 라벨(헤더)이 손상되어, 전자책 뷰어가 이 파일을 어떻게 열어야 할지 알 수 없는 상황임을 의미합니다.

## 해결 방법

해결책은 손상된 파일을 건강한 원본 파일로 교체하는 것입니다.

1. 손상 여부 확인 먼저, EPUB 프로젝트 폴더에서 오류가 발생한 이미지 파일을 찾아 직접 열어보세요. 윈도우 사진 뷰어나 Mac의 미리보기 등에서 파일이 열리지 않거나, 이미지가 깨져 보인다면 파일이 손상된 것이 확실합니다.
2. 원본 파일 찾기 EPUB에 추가하기 전의 원본 이미지 파일을 컴퓨터에서 찾습니다. 대부분의 경우 원본 파일은 손상되지 않았을 가능성이 높습니다.
3. 파일 교체 및 재생성 (권장) ① 원본 이미지 파일을 포토샵, GIMP, 그림판 등의 이미지 편집 프로그램으로 엽니다. ② '다른 이름으로 저장' 또는 '내보내기' 기능을 사용하여 새로운 파일(PNG 또는 JPG 형식 추천)로 다시 저장합니다. 이 과정에서 손상된 헤더 정보가 복구될 수 있습니다. ③ EPUB 프로젝트에 있던 손상된 파일을 삭제하고, 새로 저장한 건강한 파일로 교체합니다.
4. EPUB 다시 빌드하기 파일을 교체한 후 EPUB을 다시 생성하여 오류가 사라졌는지 확인합니다.

만약 원본 파일마저 손상되었다면, 백업 파일을 찾거나 이미지를 새로 만들어야 합니다.

Picture "img" elements must reference core media type resources, but found resource "%1$" of type "%2$s".

이 오류는 <img> 태그를 사용해 이미지를 표시하려고 했지만, 그 이미지 파일의 형식이 EPUB 표준에서 공식적으로 지원하지 않는 형식일 때 발생합니다.

EPUB은 모든 전자책 단말기에서 책이 동일하게 보이도록 하기 위해, 모든 뷰어가 반드시 지원해야 하는 '코어 미디어 타입(Core Media Type)' 즉, '공식 이미지 형식'을 지정해 두었습니다. 🖼️

## EPUB 공식 지원 이미지 형식

EPUB 3 표준에서 공식적으로 지원하는 이미지 형식은 다음과 같습니다. 이 네 가지 형식 중 하나를 사용해야 합니다.

• JPEG (.jpg, .jpeg) - 사진에 적합
• PNG (.png) - 투명 배경이나 선명한 그래픽에 적합
• GIF (.gif) - 간단한 애니메이션이나 색상이 적은 이미지에 적합
• SVG (.svg) - 확대/축소해도 깨지지 않는 벡터 그래픽에 적합

오류 메시지에 나온 %1$s는 위 목록에 없는 형식(예: image/bmp, image/tiff, image/webp)일 가능성이 높습니다.

## 해결 방법

해결책은 지원되지 않는 형식의 이미지 파일을 지원되는 공식 형식(주로 JPEG 또는 PNG)으로 변환하는 것입니다.

1. 이미지 변환: 포토샵, GIMP, 미리보기(macOS), 그림판(Windows) 등 이미지 편집 프로그램을 사용하여 오류가 발생한 이미지 파일(%2$s)을 엽니다.
2. 다른 이름으로 저장/내보내기: '다른 이름으로 저장' 또는 '내보내기(Export)' 기능을 사용하여 파일 형식을 PNG나 JPEG로 선택하여 새로 저장합니다.
3. EPUB 파일 교체: EPUB 프로젝트 폴더에 있는 기존의 비표준 이미지 파일을 새로 변환한 파일로 교체합니다.
4. 코드 수정 (필요시): 만약 파일의 확장자가 변경되었다면(예: .bmp → .png), 이미지를 사용한 HTML 파일의 <img> 태그와 .opf 파일의 <manifest> 목록에 있는 파일 이름과 media-type도 그에 맞게 수정해야 합니다.

• 수정 예시:
  • chart.bmp 파일을 chart.png로 변환했다면,
  • HTML 코드의 <img src="../images/chart.bmp" ... />를 <img src="../images/chart.png" ... />로 수정해야 합니다.