EBOOK-CONVERT(1)

calibre

EBOOK-CONVERT(1)

NAME

ebook-convert - ebook-convert

ebook-convert input_file output_file [options]

Convert an e-book from one format to another.

input_file is the input and output_file is the output. Both must be specified as the first two arguments to the command.

The output e-book format is guessed from the file extension of output_file. output_file can also be of the special format .EXT where EXT is the output file extension. In this case, the name of the output file is derived from the name of the input file. Note that the filenames must not start with a hyphen. Finally, if output_file has no extension, then it is treated as a folder and an "open e-book" (OEB) consisting of HTML files is written to that folder. These files are the files that would normally have been passed to the output plugin.

After specifying the input and output file you can customize the conversion by specifying various options. The available options depend on the input and output file types. To get help on them specify the input and output file and then use the -h option.

For full documentation of the conversion system see 전자책 변환

Whenever you pass arguments to ebook-convert that have spaces in them, enclose the arguments in quotation marks. For example: "/some path/with spaces"

The options and default values for the options change depending on both the input and output formats, so you should always check with:

ebook-convert myfile.input_format myfile.output_format -h

Below are the options that are common to all conversion, followed by the options specific to every input and output format.

입력 옵션
출력 옵션
모양새
합리적 추측에 의한(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: The maximum image size (width x height). A value of none means use the screen size from the output profile. A value of profile means no maximum size is specified. For example, a value of 100x200 will cause all images to be resized so that their width is no more than 100 pixels and their height is no more than 200 pixels. Note that this only affects the size of the actual image files themselves. Any given image may be rendered at a different size depending on the styling applied to it in the document.

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

--epub-version: The version of the EPUB file to generate. EPUB 2 is the most widely compatible, only use EPUB 3 if you know you actually need it.

--extract-to: Extract the contents of the generated EPUB file to the specified folder. The contents of the folder are first deleted, so be careful.

--flow-size: Split all HTML files larger than this size (in KB). This is necessary as most EPUB readers cannot handle large file sizes. The default of 260KB is the size required for Adobe Digital Editions. Set to 0 to disable size based splitting.

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

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

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

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

--toc-title: Title for any generated inline table of contents.

모양새

출력의 모양새를 제어하는 옵션입니다

--asciiize: Transliterate Unicode characters to an ASCII representation. Use with care because this will replace Unicode characters with ASCII. For instance it will replace "Pelé" with "Pele". Also, note that in cases where there are multiple representations of a character (characters shared by Chinese and Japanese for instance) the representation based on the current calibre interface language will be used.

--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: By default, calibre will use the shorthand form for various CSS properties such as margin, padding, border, etc. This option will cause it to use the full expanded form instead. Note that CSS is always expanded when generating EPUB files with the output profile set to one of the Nook profiles as the Nook cannot handle shorthand 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 font에 대한 크기입니다. 글꼴 비율 재조정 알고리즘은 지능적으로 글꼴 크기의 비율을 재조정하기 위하여 이 값들을 사용합니다. 기본값으로는 사용자가 선택한 출력 프로필에 근거한 맵핑을 사용합니다.

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

--insert-blank-line-size: 삽입될 빈줄의 높이(em 단위). 문단 사이의 줄 간격은 여기에 지정된 값의 두배가 됩니다.

--keep-ligatures: Preserve ligatures present in the input document. A ligature is a combined character of a pair of characters like ff, fi, fl et cetera. Most readers do not have support for ligatures in their default fonts, so they are unlikely to render correctly. By default, calibre will turn a ligature into the corresponding pair of normal characters. Note that ligatures here mean only unicode ligatures not ligatures created via CSS or font styles. This option will preserve them instead.

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

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

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

--smarten-punctuation: Convert plain quotes, dashes and ellipsis to their typographically correct equivalents. For details, see https://daringfireball.net/projects/smartypants.

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

--transform-css-rules: Path to a file containing rules to transform the CSS styles in this book. The easiest way to create such a file is to use the wizard for creating rules in the calibre GUI. Access it in the "Look & feel->Transform styles" section of the conversion dialog. Once you create the rules, you can use the "Export" button to save them to a file.

--transform-html-rules: Path to a file containing rules to transform the HTML in this book. The easiest way to create such a file is to use the wizard for creating rules in the calibre GUI. Access it in the "Look & feel->Transform HTML" section of the conversion dialog. Once you create the rules, you can use the "Export" button to save them to a file.

--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: Path to a file containing search and replace regular expressions. The file must contain alternating lines of regular expression followed by replacement pattern (which can be an empty line). The regular expression must be in the Python regex syntax and the file must be UTF-8 encoded.

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

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

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

--sr2-search: Search pattern (regular expression) to be replaced with sr2-replace.

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

--sr3-search: Search pattern (regular expression) to be replaced with sr3-replace.

구조 탐지

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

--add-alt-text-to-img: When an <img> tag has no alt attribute, check the associated image file for metadata that specifies alternate text, and use it to fill in the alt attribute. The alt attribute is used by screen readers for assisting the visually challenged.

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

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

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

--insert-metadata: 책의 시작 부분에 책 책정보를 삽입합니다. 전자책 리더가 책정보를 직접적으로 표시/검색하기를 지원하지 않을 경우 유용합니다.

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

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

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

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

메타데이터

출력의 메타데이터를 지정하는 옵션입니다.

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

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

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

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

--cover: 표지에 지정한 파일 또는 URL을 설정합니다

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

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

--pubdate: Set the publication date (assumed to be in the local timezone, unless the timezone is explicitly specified)

--publisher: 책의 발행자를 지정합니다.

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

--read-metadata-from-opf, --from-opf, -m: 지정한 OPF 파일에서 메타데이터를 읽어옵니다. 이 파일에서 읽는 메타데이터는 원본 파일의 모든 메타데이터를 무시합니다.

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

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

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

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

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

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

디버그

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

--debug-pipeline, -d: Save the output from different stages of the conversion pipeline to the specified folder. Useful if you are unsure at which stage of the conversion process a bug is occurring.

--verbose, -v: Level of verbosity. Specify multiple times for greater verbosity. Specifying it twice will result in full verbosity, once medium verbosity and zero times least verbosity.

AUTHOR

Kovid Goyal

COPYRIGHT