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) 처리
- 검색 및 교체
- 구조 탐지
- 목차
- 책 정보
- 디버그
- --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
- 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,
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
입력 옵션
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.
- 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
- 지정된 경우, 출력
플러그인은 사람이
읽을 수 있는 출력을
최대한 생성하려고
시도합니다. 일부
출력 플러그인에
대해서는 영향을
미치지 않을 수
있습니다.
모양새
출력의 모양새를
제어하는
옵션입니다
- --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
- 텍스트 자리 맞춤을
변경합니다.
"왼쪽" 값은
원본의 모든 정렬된
텍스트를 왼쪽
정렬된(즉, 정렬되지
않은) 텍스트로
변환합니다. "양쪽
정렬" 값은 모든
정렬이 안된 본문을
양쪽 정렬하도록
변환합니다.
"원본"(기본값)
값은 원본 파일의
자리 맞춤을 바꾸지
않습니다. 일부 출력
형식만 자리 맞춤을
지원합니다.
- --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.
- 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
- 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.
합리적 추측에
의한(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.
- --sr2-search
- Search pattern (regular expression) to be replaced with sr2-replace.
- --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
- 입력 전자책에서의
첫번째 이미지를
제거합니다. 입력
문서가 실제 표지가
아닌 표지 이미지를
가지고 있는 경우
유용합니다. 이런
경우, 이 옵션을
지정하지 않은
상태에서 캘리버에서
표지를 지정해놓으면
출력 문서는 두개의
표지 이미지를 가지게
되어버립니다.
- --start-reading-at
- 문서에서의 읽기 시작
지점을 탐지하기 위한
XPath 표현식. 몇몇
프로그램(대표적으로
Kindle)은 책을 열 때 이
위치를 사용합니다.
이 특정 기능을
사용하는데 대한 더
많은 도움말은 캘리버
사용자 설명서의 XPath
튜토리얼을
참고하세요.
목차
목차의 자동 생성을
제어합니다.
기본적으로 원본
파일에 목차가 있는
경우, 자동으로 생성된
파일에 대한
환경설정에
사용됩니다.
- --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
- 책의 태그를
지정합니다. 쉼표(,)로
구분된 목록이어야
합니다.
- --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.