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 directory and an "open e-book" (OEB) consisting of
HTML files is written to that directory. 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 conversion
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) 처리
- 검색과 치환
- 구조 탐지
- 목차
- 책 정보
- 디버그
- --input-profile
- 입력 프로파일을
지정하세요. 입력
프로파일은 변환
시스템에 입력 문서의
다양한 정보를 어떻게
해석할 것인지에 관한
정보를 줍니다. 예를
들어, 해상도는
길이에 영향을
받습니다(즉, 픽셀
단위의 길이를 말함).
선택 가능한 값은
다음과 같습니다:cybookg3,
cybook_opus, default, hanlinv3, hanlinv5, illiad, irexdr1000, irexdr800,
kindle, msreader, mobipocket, nook, sony, sony300, sony900
- --list-recipes
- 내장 레시피 이름을
나열합니다. 다음과
같은 방법으로 내장
레시피에서 eBook을
생성할 수 있습니다:
ebook-convert "레시피
이름.recipe" 출력.epub
- --output-profile
- Specify the output profile. The output profile tells the conversion system
how to optimize the created document for the specified device (such as by
resizing images for the device screen size). In some cases, an output
profile can be used to optimize the output for a particular device, but
this is rarely necessary. Choices are:cybookg3, cybook_opus, default,
generic_eink, generic_eink_hd, generic_eink_large, hanlinv3, hanlinv5,
illiad, ipad, ipad3, irexdr1000, irexdr800, jetbook5, kindle, kindle_dx,
kindle_fire, kindle_oasis, kindle_pw, kindle_pw3, kindle_voyage, kobo,
msreader, mobipocket, nook, nook_color, nook_hd_plus, pocketbook_900,
pocketbook_pro_912, galaxy, sony, sony300, sony900, sony-landscape,
sonyt3, tablet
입력 옵션
mobi 파일 입력의
처리를 제어하는
옵션입니다.
- --input-encoding
- 입력 문서의 문자
인코딩을 지정합니다.
이 옵션이 설정되면
문서 자체에 선언된
인코딩은 무시됩니다.
인코딩 선언이 없거나
인코딩 선언에 오류가
있는 문서에서 특히
유용합니다.
출력 옵션
epub 출력의 처리를
제어하는
옵션입니다.
- --dont-split-on-page-breaks
- 쪽 넘김에서 분할하기
기능을 끕니다.
보통은 입력 파일은
두 개의 파일 내의 쪽
넘김마다 자동으로
분할합니다. 이것은
출력하는 책에 더
빠르게 분석하고 적은
자원을 사용할 수
있게 합니다. 하지만,
분할하기는 느리며
원본 파일이 매우 큰
쪽 넘김 번호를 담고
있다면 쪽 넘김시
분할하기를 꺼야
합니다.
- --epub-flatten
- 이 옵션은 EPUB을 FBReaderJ에서
사용하기 원하는
경우에만 필요합니다.
이 옵션은 EPUB 내부의
파일 시스템 구조를
단순화시켜, 모든
파일을 최상위 레벨에
위치시킵니다.
- --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.
- 지정된 디렉토리에
생성된 EPUB 파일의
내용들을 추출합니다.
해당 디렉토리의
내용들은 먼저 삭제가
되니 주의하세요.
- --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
- 지정된 경우에, 출력
플러그인은 사람이
읽을 수 있는
결과물을 생성합니다.
일부 출력
플러그인에는 영향을
미치지 않을 수
있습니다.
모양새
출력의 모양새를
제어하는
옵션입니다
- --asciiize
- Transliterate Unicode characters to an ASCII representation. Use with care
because this will replace Unicode characters with ASCII. For instance it
will replace "Михаил
Горбачёв"
with "Mikhail Gorbachiov". 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
- 텍스트 맞춤 방식을
변경합니다. "왼쪽
정렬"은 원본의
모든 양쪽 정렬된
본문을 왼쪽 정렬로
변환합니다. "양쪽
정렬"는 모든
정렬이 안된 본문을
양쪽 정렬하도록
변환합니다.
"원본"(기본값)은
원본 파일의 맞춤
방식을 바꾸지
않습니다. 일부 출력
형식만 텍스트 맞춤을
지원한다는 점을
유의하세요.
- --embed-all-fonts
- 입력 문서에서 참조된
모든 글꼴 중 이미
내장되어있지 않은
모든 글꼴을
내장합니다. 이
옵션을 켜면 사용자의
시스템에서 해당
글꼴을 검색하게
되고, 발견된 글꼴은
출력 문서에
내장됩니다. 글꼴
내장 옵션은
변환하려는 형식이 EPUB,
AZW3, DOCX, PDF 처럼 글꼴 내장
기능을 지원하는
경우에만 동작합니다.
이 문서에 사용된
글꼴들에 대하여 글꼴
내장에 필요한 적절한
라이센스를 사용자가
보유하고 있는지
확인하시기
바랍니다.
- --embed-font-family
- 지정된 글꼴 패밀리를
책 안에 내장(embed)합니다.
이 옵션은 책에서
사용될 "기본"
글꼴을 지정합니다.
만일 입력 문서가
자신만의 글꼴을
명시적으로
지정해놓은 경우에는
이 기본 글꼴 설정을
덮어써버릴 수
있습니다. 이런 경우
스타일 정보 필터링
기능을 사용하여
입력문서에서 글꼴
설정들을 제거할 수
있습니다. 글꼴 내장
기능은 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.
- 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에 대한 크기입니다.
글꼴 비율 재조정
알고리즘은
지능적으로 글꼴
크기의 비율을
재조정하기 위하여 이
값들을 사용합니다.
기본값으로는
사용자가 선택한 출력
프로파일에 근거한
맵핑을 사용합니다.
- --keep-ligatures
- 입력문서에 있는
합자(Ligature)들을
보존합니다. 합자란, ff,
fi, fl 등과 같은, 두
문자가 합쳐진 형태의
특별한 렌더링을
뜻합니다. 대부분
기기의 기본
글꼴에서는 이 합자를
지원하지 않기 때문에
이 합자들이 제대로
렌더링되지 않을
가능성이 큽니다.
기본값으로 캘리버는
이 합자들을 해당하는
두 일반 문자 쌍으로
전환합니다. 이
옵션을 켜면,
전환하는 대신 이
합자들을 그냥
보존하게 됩니다.
- --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-indent-size
- 캘리버가 문단 사이의
빈 줄들을 제거할 때,
문단끼리 쉽게
구분되도록 하기
위하여 자동으로
단락에 들여쓰기를
지정합니다. 이
옵션은 그 들여쓰기의
너비를 (em 단위로)
조정합니다. 이 값을
음수로 지정하게
되면, 입력 문서에서
지정된 들여쓰기가
사용됩니다(즉,
캘리버가 들여쓰기를
변경하지 않음).
- --smarten-punctuation
- 평이한 형태의
따옴표, 대시, 생략
부호들을 인쇄상으로
올바른 대체형태로
변환합니다. 자세한
사항은 다음을
참고하세요 ->
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.
합리적 추측에
의한(HEURISTIC) 처리
문서의 텍스트와
구조를 일반 패턴을
사용하여 변경합니다.
기본값으로
꺼져있습니다.
활성화하려면 --enable-heuristics
를 사용하세요. 개별
동작은 --disable-* 를
사용하여 비활성화할
수 있습니다.
- --html-unwrap-factor
- 행 길이의 어느
지점에서 줄바꿈을
합쳐야 할지
결정하는데 사용되는
스케일. 유요한 값은
0과 1사이의 십진수
값입니다. 기본값은
0.4이며, 행 길의
중간에서 약간
아래입니다. 문서에서
단지 몇몇 줄만
줄바꿈 합치기가
필요한 경우라면 이
값이 더 작아져야
합니다
검색과 치환
문서의 텍스트와
구조를 사용자 정의
패턴을 사용하여
변경합니다.
- --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
- Replacement to replace the text found with sr1-search.
- --sr1-search
- Search pattern (regular expression) to be replaced with sr1-replace.
- --sr2-replace
- Replacement to replace the text found with sr2-search.
- --sr2-search
- Search pattern (regular expression) to be replaced with sr2-replace.
- --sr3-replace
- Replacement to replace the text found with sr3-search.
- --sr3-search
- Search pattern (regular expression) to be replaced with sr3-replace.
구조 탐지
문서 구조의 자동
검출을 제어합니다.
- --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
- 책의 시작 부분에 책
책정보를 삽입합니다.
전자책 리더가
책정보를 직접적으로
표시/검색하기를
지원하지 않을 경우
유용합니다.
- --remove-first-image
- 입력 eBook에서의 첫번째
이미지를 제거합니다.
입력 문서가 실제
표지가 아닌 표지
이미지를 가지고 있는
경우 유용합니다.
이런 경우, 이 옵션을
지정하지 않은
상태에서 캘리버에서
표지를 지정해놓으면
출력 문서는 두개의
표지 이미지를 가지게
되어버립니다.
- --start-reading-at
- 문서에서의 읽기 시작
지점을 탐지하기 위한
XPath 표현식. 몇몇
프로그램(대표적으로
Kindle)은 책을 열 때 이
위치를 사용합니다.
이 기능을 사용하는데
대한 더 많은
도움말은 캘리버 사용
설명서의 XPath 입문
설명서를
참고하세요.
목차
목차의 자동 생성을
제어합니다.
기본값으로 원본
파일이 목차를 가지고
있다면, 자동으로
생성된 목차를
우선적으로 사용할
것입니다.
- --duplicate-links-in-toc
- 입력 문서 안의
링크에서 목차를
생성할 때, 중복된
항목을 허용합니다.
즉, 링크들이 서로
다른 위치를
가리키기만 한다면,
같은 텍스트로 된
하나 이상의 항목을
허용한다는
의미입니다.
- --level1-toc
- 목차의 1단계에
추가되어야할 모든
태그를 지정하는 XPath
표현식. 이 칸이
지정되어있다면, 다른
형태의 자동감지를
우선합니다. 예시를
보려면 캘리버 사용
설명서 안의 XPath 입문
설명서를
참조하세요.
- --level2-toc
- 목차의 2단계에
추가되어야할 모든
태그를 지정하는 XPath
표현식. 각 항목은
이전의 1단계 항목
아래에 추가됩니다.
예시를 보려면 캘리버
사용 설명서 안의 XPath
입문 설명서를
참조하세요.
- --level3-toc
- 목차의 3단계에
추가되어야할 모든
태그를 지정하는 XPath
표현식. 각 항목은
이전의 2단계 항목
아래에 추가됩니다.
예시를 보려면 캘리버
사용 설명서 안의 XPath
입문 설명서를
참조하세요.
- --max-toc-links
- 목차에 삽입할 링크의
최대 개수입니다.
비활성화하려면 0을
지정합니다. 기본값: 50.
챕터의 한계치보다
적게 발견할 경우만
링크들을 목차에
추가합니다.
- --toc-filter
- 지정한 정규 표현식과
일치하는 제목을
항목을 목차에서
삭제합니다. 일치하는
항목과 모든
자식(하위) 항목을
삭제합니다.
- --use-auto-toc
- 일반적으로 원본
파일이 이미 목차를
가지고 있다면,
자동으로 생성된
것보다 우선적으로
사용합니다. 이
옵션을 사용하면,
자동으로 생성된 것을
항상 사용합니다.
책 정보
출력의 책 정보를
지정하는
옵션입니다.
- --authors
- 저자를 지정합니다.
다수의 저자들은 &&
기호로 구분해야
합니다.
- --pubdate
- Set the publication date (assumed to be in the local timezone, unless the
timezone is explicitly specified)
- --series-index
- 이 시리즈에서 책의
색인을 지정합니다.
- --tags
- 책의 태그를
지정합니다. 쉼표(,)로
구분된 목록이어야
합니다.
- --timestamp
- Set the book timestamp (no longer used anywhere)
- --title-sort
- 정렬을 위해 사용될
제목의 형태입니다.
디버그
변환 작업에 대한
디버깅을 돕기 위한
옵션입니다
- --debug-pipeline,
-d
- Save the output from different stages of the conversion pipeline to the
specified directory. 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.