Scroll to navigation

CALIBRE-DEBUG(1) calibre CALIBRE-DEBUG(1)

NAME

calibre-debug - calibre-debug

calibre-debug [옵션]


calibre 디버깅에 유용한 다양한 명령줄 인터페이스입니다. 옵션 없이 실행하면 내장된 Python 인터프리터를 시작합니다. 또한 calibre 기본 GUI, calibre 전자책 뷰어, calibre 편집기를 디버그 모드로 실행할 수도 있습니다.

이 명령에는 전용 명령줄 도구가 없는 calibre 기능들, 예를 들면 글꼴 서브셋 생성, 전자책 비교 도구 같은 기능에 대한 인터페이스도 포함되어 있습니다.

또한 calibre-debug 를 사용해 독립 실행형 스크립트를 실행할 수도 있습니다. 사용 방법은 다음과 같습니다:

calibre-debug -e myscript.py -- --option1 --option2 file1 file2 ...


-- 뒤의 모든 내용은 스크립트로 전달됩니다. 스크립트에서 calibre-debug 를 shebang 으로 사용할 수도 있습니다. 예를 들면 다음과 같습니다:

#!/usr/bin/env -S calibre-debug -e -- --


:command:

`
calibre-debug`에 공백이 포함된 인수를 전달할 때는 항상 인수를 따옴표로 묶으십시오. 예: "/some path/with spaces"

[옵션]

플러그인 코드가 담긴 py 파일에 대한 경로를 지정해서, 간단한 플러그인(즉, .py 파일로만 구성된 플러그인)을 추가합니다.

Python 코드를 실행합니다.

장치 감지 디버그

캘리버를 Windows 기본 프로그램에 등록/제거 합니다. --default-programs = (register|unregister)

캘리버의 diff 도구를 실행합니다. 예: calibre-debug --diff 파일1 파일2

캘리버 "책 편집" 도구를 디버그 모드로 실행합니다. -g와 마찬가지로 명령줄 인수를 전달하려면 --를 사용하세요.

파일의 Python 코드를 실행합니다.

책을 지정된 폴더로 분해합니다. 사용법: -x file.epub output_dir 표준 HTML 편집 도구를 사용하여 편집할 수 있는 HTML 파일 및 메타데이터 모음으로 책을 내보냅니다. EPUB, AZW3, HTMLZ 및 DOCX 파일과 함께 작동합니다.

모든 calibre 데이터(책/설정/플러그인)를 내보냅니다. 보통은 내보내기 폴더와 내보낼 라이브러리를 묻습니다. 질문을 건너뛰려면 명령줄 인수로 직접 지정할 수도 있습니다. 내보내기 폴더와 라이브러리에는 절대 경로를 사용하십시오. 특수 키워드 "all" 을 사용하면 모든 라이브러리를 내보낼 수 있습니다. 예: calibre-debug --export-all-calibre-data # 대화형 사용 calibre-debug --export-all-calibre-data /path/to/empty/export/folder /path/to/library/folder1 /path/to/library2 calibre-debug --export-all-calibre-data /export/folder all # 알려진 모든 라이브러리 내보내기

디버깅을 활성화한 상태로 GUI를 실행합니다. 디버그 출력은 stdout과 stderr로 표시됩니다. 명령줄 인수를 전달하려면 -- 뒤에 인수를 붙여 사용하십시오. 예: calibre-debug -g -- /path/to/ebook

지정한 경로에 로그를 기록하면서 GUI를 디버그 콘솔과 함께 실행합니다. 내부 용도 전용이며, GUI를 디버그 모드로 실행하려면 -g 옵션을 사용하십시오.

이 도움말 메시지를 표시한 후 종료

이전에 분해한 책을 다시 합칩니다. 사용법: -i output_dir file.epub 이전의 --explode-book 호출로 생성된 output_dir 의 파일들로부터 책을 가져옵니다. 분해할 때 사용한 것과 같은 파일 형식을 지정해야 합니다.

이전에 내보낸 캘리버 데이터 가져오기

지정된 경로의 MOBI 파일을 검사합니다.

전체 변환을 수행하지 않고 지정한 EPUB 파일을 KEPUB로 변환합니다. Kobo 드라이버가 파일을 장치로 보낼 때 수행하는 방식입니다.

캘리버 환경을 설정하는데 필요한 경로들을 출력합니다.

명령줄 인터페이스를 제공하는 플러그인을 실행합니다. 예: calibre-debug -r "플러그인 이름" -- file1 --option1 -- 뒤의 모든 내용은 인수로 플러그인에 전달됩니다.

디버깅을 활성화한 상태로 GUI를 실행합니다. 디버그 출력은 stdout과 stderr에 기록됩니다. 명령줄 인수를 전달하려면 -- 뒤에 인수를 붙이십시오. 예: calibre-debug -g -- /path/to/ebook

DEBUG 플래그를 설정한 채 실행하지 마세요

실행 중인 캘리버 인스턴스가 있다면 종료시킵니다. 만일 실행 중인 작업이 있다면 조용히 처리가 중단되니 조심해서 사용하도록 하십시오.

지정된 글꼴에서 실제 사용된 문자만 취합니다. Font subsetting 프로그램에 옵션을 전달하려면 이 옵션 다음에 -- 를 사용하세요.

빌드 시 바이너리 모듈을 검사합니다.

전체 변환을 수행하지 않고 지정한 KEPUB 파일을 EPUB로 변환합니다. Kobo 드라이버가 장치에서 파일을 가져올 때 수행하는 방식입니다.

프로그램의 버전을 표시한 후 종료합니다.

전자책 뷰어를 디버그 모드로 실행합니다. -g와 마찬가지로 명령줄 인수를 전달하려면 --를 사용하세요.

Author

Kovid Goyal

Copyright

Kovid Goyal

5월 01, 2026 9.8.0