EBOOK-CONVERT(1)

NAME
ebook-convert - ebook-convert

            ebook-convert input_file output_file [options]

전자책을 한 형식에서 다른 형식으로 변환합니다.

input_file은 입력 파일이고 output_file은 출력 파일입니다. 둘 다 명령의 첫 두 인수로 지정해야 합니다.

출력 전자책 형식은 output_file의 파일 확장자로 추정합니다. output_file은 출력 파일 확장자가 EXT인 특수 형식 .EXT 로도 지정할 수 있습니다. 이 경우 출력 파일 이름은 입력 파일 이름에서 파생됩니다. 파일 이름은 하이픈으로 시작하면 안 됩니다. 마지막으로 output_file에 확장자가 없으면 폴더로 간주하며, HTML 파일들로 이루어진 "오픈 전자책"(OEB)을 그 폴더에 씁니다. 이 파일들은 원래 출력 플러그인에 전달되었을 파일들입니다.

입력 파일과 출력 파일을 지정한 뒤에는 여러 옵션을 지정해 변환을 사용자 지정할 수 있습니다. 사용 가능한 옵션은 입력 및 출력 파일 형식에 따라 달라집니다. 해당 옵션의 도움말을 보려면 입력 파일과 출력 파일을 지정한 다음 -h 옵션을 사용하십시오.

변환 시스템의 전체 문서는 다음을 참조하기 전자책 변환 <#conversion>

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

옵션과 옵션의 기본값은 입력 형식과 출력 형식에 따라 모두 달라지므로 항상 다음 명령으로 확인해야 합니다:

            ebook-convert myfile.input_format myfile.output_format -h

아래에는 모든 변환에 공통으로 적용되는 옵션이 먼저 나오고, 이어서 각 입력 및 출력 형식별 옵션이 나옵니다.

    •   입력 옵션

    •   출력 옵션

    •   모양새

    •   합리적 추측에 의한(Heuristic) 처리

    •   검색 및 교체

    •   구조 탐지

    •   목차

    •   메타데이터

    •   디버그

    --help, -h
        이 도움말 메시지를 표시한 후 종료

    --input-profile
        입력 프로필을 지정합니다. 입력 프로필은 입력 문서의 여러 정보를 변환 시스템이 어떻게 해석할지 알려 줍니다. 예를 들어 해상도에 따라 달라지는 길이(즉, 픽셀 단위 길이) 같은 정보입니다. 선택 가능한 값: cybookg3, cybook_opus, default, hanlinv3, hanlinv5, illiad, irexdr1000, irexdr800, kindle, msreader, mobipocket, nook, sony, sony300, sony900

    --list-recipes
        내장된 레시피 이름을 나열합니다. 다음과 같은 내장된 레시피에서 전자책을 만들 수 있습니다: ebook-convert "레시피 이름.recipe" 출력.epub

    --output-profile
        출력 프로필을 지정합니다. 출력 프로필은 생성된 문서를 지정한 장치에 맞게 어떻게 최적화할지 변환 시스템에 알려 줍니다. 경우에 따라 특정 장치에 맞춰 출력을 최적화할 수 있지만, 대체로 꼭 필요하지는 않습니다. 선택 가능한 값:cybookg3, cybook_opus, default, hanlinv3, hanlinv5, illiad, ipad, ipad3, irexdr1000, irexdr800, jetbook5, kindle, kindle_dx, kindle_fire, kindle_oasis, kindle_pw, kindle_pw3, kindle_scribe, kindle_voyage, kobo, msreader, mobipocket, nook, nook_color, nook_hd_plus, pocketbook_inkpad3, pocketbook_lux, pocketbook_hd, pocketbook_900, pocketbook_pro_912, galaxy, sony, sony300, sony900, sony-landscape, sonyt3, generic_eink, generic_eink_hd, generic_eink_large, tablet

    --version
        프로그램의 버전을 표시한 후 종료함

입력 옵션

mobi 파일 입력의 처리를 제어하는 옵션

    --input-encoding
        입력 문서의 문자 인코딩을 지정합니다. 이 옵션이 설정되면 문서 자체에 선언된 인코딩은 무시됩니다. 인코딩 선언이 없거나 인코딩 선언에 오류가 있는 문서에서 특히 유용합니다.

출력 옵션

epub 출력의 처리를 제어하는 옵션

    --dont-split-on-page-breaks
        쪽 넘김에서 분할하기 기능을 끕니다. 보통은 입력 파일은 두 개의 파일 내의 쪽 넘김마다 자동으로 분할합니다. 이것은 출력하는 책에 더 빠르게 분석하고 적은 자원을 사용할 수 있게 합니다. 하지만, 분할하기는 느리며 원본 파일이 매우 큰 쪽 넘김 번호를 담고 있다면 쪽 넘김시 분할하기를 꺼야 합니다.

    --epub-flatten
        이 옵션은 EPUB을 FBReaderJ에서 사용하기 원하는 경우에만 필요합니다. 이 옵션은 EPUB 내부의 파일 시스템 구조를 단순화시켜, 모든 파일을 최상위 레벨에 위치시킵니다.

    --epub-inline-toc
        책 내용의 일부분으로 나타나게 될 인라인 목차를 삽입합니다.

    --epub-max-image-size
        최대 이미지 크기(너비 x 높이)입니다. 값 profile은 출력 프로필의 화면 크기를 사용한다는 뜻입니다. 값 none은 최대 크기를 지정하지 않는다는 뜻입니다. 예를 들어 값 100x200를 지정하면 모든 이미지의 너비가 100픽셀, 높이가 200픽셀을 넘지 않도록 조정됩니다. 이는 실제 이미지 파일 자체의 크기에만 영향을 줍니다. 문서에 적용된 스타일에 따라 렌더링 크기는 달라질 수 있습니다.

    --epub-toc-at-end
        삽입된 인라인 목차를 책의 첫 부분 대신 끝 부분에 넣습니다.

    --epub-version
        생성할 EPUB 파일의 버전입니다. EPUB 2가 가장 호환성이 높으므로, 실제로 필요하다는 것을 아는 경우에만 EPUB 3를 사용하십시오.

    --extract-to
        이미지에 사용되는 색 수를 줄입니다. PNG 출력 형식을 선택했을 때만 동작합니다. 파일 크기를 줄이는 데 유용합니다. 끄려면 0으로 설정하십시오. 최대값은 256이며 기본적으로 꺼져 있습니다.

    --flow-size
        이 크기(KB)보다 큰 모든 HTML 파일을 분할합니다. 대부분의 EPUB 리더는 큰 파일 크기를 처리하지 못하므로 필요합니다. 기본값 260KB 는 Adobe Digital Editions 에 필요한 크기입니다. 크기 기준 분할을 비활성화하려면 0으로 설정하십시오.

    --no-default-epub-cover
        보통은, 입력 파일에 표지가 없고 이 옵션을 선택하지 않을 경우, 기본 표지는 제목, 저자 등과 함께 생성됩니다. 이 옵션을 비활성화하면 표지를 생성하지 않습니다.

    --no-svg-cover
        책 표지에 SVG를 사용하지 않습니다. EPUB가 iPhone이나 JetBook Lite처럼 SVG를 지원하지 않는 장치에 사용할 예정이면 이 옵션을 사용하세요. 이 옵션을 사용하지 않으면, 앞에서 명시한 장치들은 표지를 빈 면으로 표시하게 됩니다.

    --preserve-cover-aspect-ratio
        SVG 표지를 사용할 때 이 옵션을 사용하면 표지가 사용 가능한 화면 영역을 덮도록 크기가 조정되지만 종횡비(너비 대 높이 비율)은 유지됩니다. 즉, 이미지의 측면 또는 상단과 하단에 흰색 테두리가 있을 수 있지만 이미지는 왜곡되지 않습니다. 이 옵션이 없으면 이미지가 약간 왜곡될 수 있지만 테두리는 없습니다.

    --pretty-print
        지정된 경우, 출력 플러그인은 사람이 읽을 수 있는 출력을 최대한 생성하려고 시도합니다. 일부 출력 플러그인에 대해서는 영향을 미치지 않을 수 있습니다.

    --toc-title
        생성된 인라인 목차의 제목.

모양새

출력물의 모양과 느낌을 제어하는 ​​옵션

    --asciiize
        유니코드 문자를 ASCII 표기로 변환합니다. 이 작업은 유니코드 문자를 ASCII 로 바꾸므로 주의해서 사용하십시오. 예를 들어 "Pelé" 는 "Pele" 로 바뀝니다. 또한 하나의 문자를 여러 방식으로 표기할 수 있는 경우(예: 중국어와 일본어가 공유하는 문자) 현재 calibre 인터페이스 언어를 기준으로 한 표기가 사용됩니다.

    --base-font-size
        기본 글꼴 크기(pts 단위)입니다. 생성된 책의 모든 글꼴 크기는 이 값을 기준으로 다시 조정됩니다. 값을 크게 하면 출력물의 글꼴이 커지고, 작게 하면 반대로 작아집니다. 기본값인 0이면 선택한 출력 프로필을 기준으로 기본 글꼴 크기가 정해집니다.

    --change-justification
        텍스트 자리 맞춤을 변경합니다. "왼쪽" 값은 원본의 모든 정렬된 텍스트를 왼쪽 정렬된(즉, 정렬되지 않은) 텍스트로 변환합니다. "양쪽 정렬" 값은 모든 정렬이 안된 본문을 양쪽 정렬하도록 변환합니다. "원본"(기본값) 값은 원본 파일의 자리 맞춤을 바꾸지 않습니다. 일부 출력 형식만 자리 맞춤을 지원합니다.

    --disable-font-rescaling
        글꼴 크기의 모든 크기 조정을 비활성화합니다.

    --embed-all-fonts
        입력 문서에서 참조되지만 아직 포함되지 않은 모든 글꼴을 포함합니다. 그러면 시스템에서 글꼴을 검색하고 발견하면 포함됩니다. 포함은 변환하려는 형식이 EPUB, AZW3, DOCX 또는 PDF와 같은 포함 글꼴을 지원하는 경우에만 작동합니다. 이 문서에 사용된 글꼴을 포함할 수 있는 적절한 라이선스가 있는지 확인하십시오.

    --embed-font-family
        지정된 글꼴 모음을 책에 포함합니다. 책에 사용되는 "기본" 글꼴을 지정합니다. 입력 문서가 자체 글꼴을 지정하는 경우 이 기본 글꼴을 재정의할 수 있습니다. 필터 스타일 정보 옵션을 사용하여 입력 문서에서 글꼴을 제거할 수 있습니다. 글꼴 포함은 주로 EPUB, AZW3 및 DOCX와 같은 일부 출력 형식에서만 작동합니다.

    --expand-css
        기본적으로 calibre는 margin, padding, border 같은 다양한 CSS 속성에 축약형을 사용합니다. 이 옵션을 사용하면 대신 완전히 펼친 형식을 사용합니다. Nook은 축약형 CSS를 처리하지 못하므로, 출력 프로필이 Nook 계열일 때 EPUB 파일을 생성하면 CSS는 항상 펼친 형식으로 저장됩니다.

    --extra-css
        CSS 스타일시트 또는 원시 CSS에 대한 경로입니다. 이 CSS는 소스 파일의 스타일 규칙에 추가되므로 해당 규칙을 재정의하는 데 사용할 수 있습니다.

    --filter-css
        CSS 스타일 규칙에서 제외시킬, 쉼표로 구분된, CSS 속성들 목록. 사용자의 장치에서 기존의 특정 스타일 정보를 덮어쓰는 것이 막혀져 있는 경우에 유용합니다. 예시: font-family, color, margin-left, margin-right

    --font-size-mapping
        CSS 글꼴 크기 이름을 pts 단위의 글꼴 크기에 매핑합니다. 예: 12,12,14,16,18,20,22,24. 이는 xx-small부터 xx-large까지의 크기에 대한 매핑이며, 마지막 값은 huge 글꼴에 해당합니다. 글꼴 재조정 알고리즘은 이 값들을 사용해 글꼴 크기를 적절히 다시 조정합니다. 기본값은 선택한 출력 프로필에 기반한 매핑입니다.

    --insert-blank-line
        문단 사이에 빈 줄을 삽입합니다. 원본 파일이 문단(<p>, <div> 태그)을 사용하지 않으면 작동하지 않습니다.

    --insert-blank-line-size
        삽입된 빈 줄의 높이를 (em 단위로) 지정합니다. 문단 사이의 줄 높이는 여기에 설정된 값의 두 배가 됩니다.

    --keep-ligatures
        입력 문서에 있는 합자(ligature)를 보존합니다. 합자는 ff, fi, fl처럼 두 문자가 결합된 문자입니다. 대부분의 리더는 기본 글꼴에서 합자를 지원하지 않으므로 제대로 렌더링되지 않을 가능성이 큽니다. 기본적으로 calibre는 합자를 해당하는 일반 문자 쌍으로 바꿉니다. 여기서의 합자는 CSS나 글꼴 스타일로 만든 합자가 아니라 유니코드 합자만을 의미합니다. 이 옵션을 사용하면 이를 그대로 보존합니다.

    --line-height
        pt 단위의 줄 높이입니다. 연속적인 텍스트 줄 간의 간격을 조절합니다. 자체 줄 높이를 정의하지 않은 요소에만 적용됩니다. 대부분의 경우, 최소 줄 높이 옵션이 더 유용합니다. 기본적으로 줄 높이 조작은 수행되지 않습니다.

    --linearize-tables
        몇몇 잘못 디자인된 문서들은 페이지 안의 텍스트 배치를 조정하기 위하여 표를 사용합니다. 이러한 문서들을 변환하였을 때, 때때로 텍스트가 페이지를 벗어나거나 다른 영역을 침범하기도 합니다. 이 옵션은 표 안의 내용들을 추출한 뒤 일직선으로 늘어 놓아져 있는 형태로 만듭니다.

    --margin-bottom
        하단 여백을 pt 단위로 지정합니다. 기본값은 5.0입니다. 0보다 작게 설정하면 여백이 아예 지정되지 않습니다(원본 문서의 여백 설정이 보존됨). 참고: PDF나 DOCX와 같은 페이지 기반 양식들은 자신들이 갖고 있는 여백 설정이 우선합니다.

    --margin-left
        왼쪽 여백을 pt 단위로 설정합니다. 기본값은 5.0입니다. 0보다 작게 설정하면 여백이 아예 지정되지 않습니다(원본 문서의 여백 설정이 보존됨). 참고: PDF나 DOCX와 같은 페이지 기반 양식들은 자신들이 갖고 있는 여백 설정이 우선합니다.

    --margin-right
        오른쪽 여백을 pt 단위로 설정합니다. 기본값은 5.0입니다. 0보다 작게 설정하면 여백이 아예 지정되지 않습니다(원본 문서의 여백 설정이 보존됨). 참고: PDF나 DOCX와 같은 페이지 기반 양식들은 자신들이 갖고 있는 여백 설정이 우선합니다.

    --margin-top
        상단 여백을 pt 단위로 설정합니다. 기본값은 5.0입니다. 0보다 작게 설정하면 여백이 아예 지정되지 않습니다(원본 문서의 여백 설정이 보존됨). 참고: PDF나 DOCX와 같은 페이지 기반 양식들은 자신들이 갖고 있는 여백 설정이 우선합니다.

    --minimum-line-height
        해당 요소의 계산된 글꼴 크기에 대한 백분율로 표시되는 최소 줄 높이입니다. calibre는 입력 문서가 지정하는 것과 상관없이 모든 요소가 최소한 이 설정의 줄 높이를 갖도록 합니다. 비활성화하려면 0으로 설정하십시오. 기본값은 120%입니다. 현재 수행 중인 작업을 모르는 경우가 아니면 직접 라인 높이 사양에 대해 우선적으로 이 설정을 사용하십시오. 예를 들어, 이것을 240으로 설정하여 "이중 간격" 텍스트를 얻을 수 있습니다.

    --remove-paragraph-spacing
        문단 사이에 공백을 지웁니다. 또한 문단에 1.5em의 들여쓰기를 지정합니다. 공백 지우기는 원본 파일이 문단(<p>, <div> 태그)을 사용하지 않으면 작동하지 않습니다.

    --remove-paragraph-spacing-indent-size
        calibre가 문단 사이의 빈 줄들을 제거할 때, 문단끼리 쉽게 구분되도록 하기 위하여 자동으로 단락에 들여쓰기를 지정합니다. 이 옵션은 그 들여쓰기의 너비를 (em 단위로) 조정합니다. 이 값을 음수로 지정하게 되면, 입력 문서에서 지정된 들여쓰기가 사용됩니다(즉, calibre가 들여쓰기를 변경하지 않음).

    --smarten-punctuation
        일반 따옴표, 대시, 말줄임표를 올바른 조판용 문자로 변환합니다. 자세한 내용: <https://daringfireball.net/projects/smartypants>.

    --subset-embedded-fonts
        모든 내장된 글꼴(embedded font)에 대하여 실제 사용된 문자만 취합니다. 내장된 모든 글꼴은 이 문서에서 사용된 문자들만 포함하도록 글꼴 파일 크기가 줄어들게 됩니다. 사용되지 않은 문자가 많으면서 파일의 크기가 큰 글꼴을 내장하는 경우 특히 유용합니다.

    --transform-css-rules
        이 책의 CSS 스타일을 변환하는 규칙이 포함된 파일의 경로입니다. 이러한 파일을 만드는 가장 쉬운 방법은 Calibre GUI에서 규칙 생성 마법사를 사용하는 것입니다. 변환 대화 상자의 "디자인 및 느낌->스타일 변환" 섹션에서 마법사에 액세스할 수 있습니다. 규칙을 생성한 후에는 "내보내기" 버튼을 사용하여 파일에 저장할 수 있습니다.

    --transform-html-rules
        이 책의 HTML을 변환하는 규칙이 포함된 파일의 경로입니다. 이러한 파일을 만드는 가장 쉬운 방법은 Calibre GUI에서 규칙 생성 마법사를 사용하는 것입니다. 변환 대화 상자의 "디자인->HTML 변환" 섹션에서 마법사에 액세스할 수 있습니다. 규칙을 생성한 후에는 "내보내기" 버튼을 사용하여 파일에 저장할 수 있습니다.

    --unsmarten-punctuation
        꾸밈 따옴표, 대시, 생략부호들을 그것들의 평이한 형태로 대체하여 변환합니다.

합리적 추측에 의한(HEURISTIC) 처리

문서의 텍스트와 구조를 일반 패턴을 사용하여 변경합니다. 기본값으로 꺼져있습니다. 활성화하려면 --enable-heuristics 를 사용하세요. 개별 동작은 --disable-* 를 사용하여 비활성화할 수 있습니다.

    --disable-dehyphenate
        문서 전반에 걸쳐 하이픈 처리된 단어들을 분석합니다. 하이픈이 유지되어야 할지 제거되어야 할지를 결정하기 위한 사전으로 문서 그 자체를 사용합니다.

    --disable-delete-blank-paragraphs
        다른 단락들 사이에 빈 단락이 있는 경우 문서에서 이 빈 단락들을 삭제

    --disable-fix-indents
        여러 개의 공란으로 처리된 들여쓰기를 CSS 들여쓰기로 바꾸어 처리합니다.

    --disable-format-scene-breaks
        왼쪽 정렬된 장면 구분 표식을 중앙 정렬합니다. 여러 행의 빈 줄을 사용한 약식의 장면 구분 표시를 가로 구분선으로 대체합니다.

    --disable-italicize-common-cases
        기울임체를 나타내는 패턴과 일반 용어를 찾아 기울임체 처리를 합니다.

    --disable-markup-chapter-headings
        형식이 지정되지 않은 장(章) 제목과 부제목을 감지합니다. h2 및 h3 태그로 변경합니다. 이 설정은 목차를 만들지 않지만 구조 감지 옵션과 함께 사용하여 목차를 만들 수 있습니다.

    --disable-renumber-headings
        연달아 있는 <h1> 또는 <h2> 태그를 찾습니다. 이러한 태그들은 장 제목의 중간에서 분리되는 것을 막기 위하여 다시 번호 매겨집니다.

    --disable-unwrap-lines
        구두점과 다른 형식요소들을 근거로 줄바꿈을 합칩니다.

    --enable-heuristics
        합리적 추측에 의한 처리를 활성화합니다. 어떤 합리적 추측에 의한 처리가 발생하려면 반드시 이 옵션이 켜져 있어야 합니다.

    --html-unwrap-factor
        행 길이의 어느 지점에서 줄바꿈을 합쳐야 할지 결정하는데 사용되는 스케일. 유요한 값은 0과 1사이의 십진수 값, 기본값 0.4이며, 행 길의 중간에서 약간 아래입니다. 문서에서 단지 몇몇 줄만 한줄로 합치기가 필요한 경우라면 이 값이 더 작아져야 함

    --replace-scene-breaks
        장면 구분 표시를 지정된 텍스트로 교체합니다. 기본값으로, 입력 문서에 사용된 텍스트가 사용됩니다.

검색 및 교체

문서의 텍스트와 구조를 사용자 지정 패턴을 사용하여 변경합니다.

    --search-replace
        검색 및 바꾸기 정규식을 담은 파일의 경로입니다. 파일에는 정규식 줄과 치환 패턴 줄이 번갈아 있어야 하며(치환 패턴 줄은 빈 줄일 수 있음), 정규식은 Python 정규식 문법이어야 하고 파일은 UTF-8로 인코딩되어 있어야 합니다.

    --sr1-replace
        sr1-search로 찾은 텍스트를 바꾸려면 교체를 선택합니다.

    --sr1-search
        sr1-replace로 교체할 검색 패턴(정규식)입니다.

    --sr2-replace
        sr2-search로 찾은 텍스트를 바꾸려면 교체를 선택합니다.

    --sr2-search
        sr2-replace로 바꿀 검색 패턴(정규식)입니다.

    --sr3-replace
        sr3-search로 찾은 텍스트를 바꾸려면 교체를 선택합니다.

    --sr3-search
        sr3-replace로 바꿀 검색 패턴(정규식)입니다.

구조 탐지

문서 구조의 자동 검출을 제어합니다.

    --add-alt-text-to-img
        <img> 태그에 alt 속성이 없으면 연결된 이미지 파일의 메타데이터에 대체 텍스트가 지정되어 있는지 확인하고, 있으면 이를 alt 속성에 채웁니다. alt 속성은 시각 콘텐츠를 보지 못하거나 완전히 해석하지 못하는 사용자에게 텍스트 설명을 제공하여 접근성을 높입니다.

    --chapter
        장(章)제목을 탐지하기 위한 XPath 표현식. 기본값은 "chapter", "book", "section", "prologue", "epilogue", 또는 "part"란 단어를 장 제목으로 포함하는 <h1> 또는 <h2> 태그와 class="chapter" 속성을 가지고 있는 태그들입니다. 사용된 표현식은 요소들의 목록을 평가할 수 있어야 합니다. 장 탐지를 비활성화 하려면 표현식 "/"을 사용하세요. 이 특정 기능에 대한 더 자세한 도움말을 보려면 calibre 사용자 설명서의 XPath 튜토리얼을 참조하세요.

    --chapter-mark
        탐지한 장을 표시할 방법을 지정합니다. "pagebreak" 값은 장 이전에 쪽 넘김을 삽입합니다. "rule" 값은 장 이전에 줄을 삽입합니다. "none" 값은 장 표시를 하지 않고, "both" 값은 쪽 넘김과 줄을 함께 사용합니다.

    --disable-remove-fake-margins
        어떤 문서들은 쪽 여백을 지정하기 위해 각 단락마다 매번 좌우 여백을 지정하는 경우가 있습니다. calibre는 이러한 여백을 탐지하여 제거하려고 시도합니다. 어떤 경우에는 제거되지 말아야할 여백이 제거되는 경우가 있습니다. 그런 경우에는 이 옵션을 비활성화 하세요.

    --insert-metadata
        책의 시작 부분에 메타데이터를 삽입합니다. 전자책 리더가 메타데이터를 직접 표시하거나 검색하는 기능을 지원하지 않을 때 유용합니다.

    --page-breaks-before
        XPath 표현식. 지정된 요소의 앞에 쪽 넘김이 삽입됩니다. 비활성화하려면 다음 표현식을 사용하세요: /

    --prefer-metadata-cover
        지정된 표지보다 우선적으로 원본 파일에서 감지된 표지를 사용합니다.

    --remove-first-image
        입력 전자책에서의 첫번째 이미지를 제거합니다. 입력 문서가 실제 표지가 아닌 표지 이미지를 가지고 있는 경우 유용합니다. 이런 경우, 이 옵션을 지정하지 않은 상태에서 calibre에서 표지를 지정해놓으면 출력 문서는 두개의 표지 이미지를 가지게 되어버립니다.

    --start-reading-at
        문서에서의 읽기 시작 지점을 탐지하기 위한 XPath 표현식. 몇몇 프로그램(대표적으로 Kindle)은 책을 열 때 이 위치를 사용합니다. 이 특정 기능을 사용하는데 대한 더 많은 도움말은 calibre 사용자 설명서의 XPath 튜토리얼을 참고.

목차

목차의 자동 생성을 제어합니다. 기본적으로 원본 파일에 목차가 있는 경우, 자동으로 생성된 파일에 대한 환경설정에 사용됩니다.

    --duplicate-links-in-toc
        입력 문서의 링크에서 목차를 만들 때, 중복 항목을 허용합니다. 즉, 동일한 텍스트가 있는 항목이 다른 위치를 가리키는 경우 둘 이상의 항목을 허용합니다.

    --level1-toc
        목차의 1단계에 추가되어야할 모든 태그를 지정하는 XPath 표현식. 이 칸이 지정되어있다면, 다른 형태의 자동감지를 우선합니다. 예시를 보려면 calibre 사용자 설명서 안의 XPath 튜토리얼을 참조하세요.

    --level2-toc
        목차의 2단계에 추가되어야할 모든 태그를 지정하는 XPath 표현식. 각 항목은 이전의 1단계 항목 아래에 추가됩니다. 예시를 보려면 calibre 사용자 설명서 안의 XPath 튜토리얼을 참조하세요.

    --level3-toc
        목차의 3단계에 추가되어야할 모든 태그를 지정하는 XPath 표현식. 각 항목은 이전의 2단계 항목 아래에 추가됩니다. 예시를 보려면 calibre 사용자 설명서 안의 XPath 튜토리얼을 참조하세요.

    --max-toc-links
        목차에 삽입할 링크의 최대 개수입니다. 비활성화하려면 0을 지정합니다. 기본값: 50. 챕터의 한계치보다 적게 발견할 경우만 링크들을 목차에 추가합니다.

    --no-chapters-in-toc
        자동 감지된 장(章)들을 목차에 추가하지 않습니다.

    --toc-filter
        지정한 정규 표현식과 일치하는 제목을 항목을 목차에서 삭제합니다. 일치하는 항목과 모든 자식(하위) 항목을 삭제합니다.

    --toc-threshold
        발견된 장(章)의 갯수가 이 숫자보다 적으면, 링크들을 목차에 추가합니다. 기본값: 6

    --use-auto-toc
        일반적으로 원본 파일이 이미 목차를 가지고 있다면, 자동으로 생성된 것보다 우선적으로 사용합니다. 이 옵션을 사용하면, 자동 생성된 항목이 항상 사용됩니다.

메타데이터

출력의 메타데이터를 지정하는 옵션

    --author-sort
        저자 순으로 정렬할 때 사용되어질 문자열입니다.

    --authors
        저자를 지정합니다. 다수의 저자들은 && 기호로 구분해야 합니다.

    --book-producer
        책 제작자를 지정합니다.

    --comments
        전자책의 설명을 지정합니다.

    --cover
        표지에 지정한 파일 또는 URL을 설정

    --isbn
        책의 ISBN을 지정합니다.

    --language
        언어를 지정합니다.

    --pubdate
        출판 날짜를 설정합니다(시간대를 명시하지 않으면 로컬 시간대로 간주)

    --publisher
        책의 출판사를 지정합니다.

    --rating
        평점을 지정합니다. 1과 5 사이의 숫자여야 합니다.

    --read-metadata-from-opf, --from-opf, -m
        지정한 OPF 파일에서 메타데이터를 읽습니다. 이 파일에서 읽은 메타데이터가 원본 파일의 메타데이터를 덮어씁니다.

    --series
        이 책이 속하게 될 시리즈를 지정합니다.

    --series-index
        이 시리즈에서 책의 색인을 지정합니다.

    --tags
        책의 태그를 지정합니다. 쉼표(,)로 구분된 목록이어야 합니다.

    --timestamp
        책 타임스탬프 지정하기(더 이상 어디에도 사용되지 않음)

    --title
        제목을 지정합니다.

    --title-sort
        정렬을 위해 사용될 제목의 형태입니다.

디버그

변환 디버깅에 도움이 되는 옵션

    --debug-pipeline, -d
        변환 파이프라인의 각 단계 출력을 지정한 폴더에 저장합니다. 변환 과정의 어느 단계에서 버그가 발생하는지 확실하지 않을 때 유용합니다.

    --verbose, -v
        자세한 출력 수준입니다. 더 자세한 출력을 원하면 여러 번 지정하십시오. 두 번 지정하면 전체 상세 출력, 한 번 지정하면 중간 상세 출력, 지정하지 않으면 최소 상세 출력이 됩니다.

Author
Kovid Goyal

Copyright
Kovid Goyal