Ubuntu Manpage: ebook-convert

Provided by: calibre_7.6.0+ds-1build1_all

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
생성된 인라인 목차에 사용될 제목입니다.

모양새

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

--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
입력문서에 있는 합자(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
문단 사이에 공백을 지웁니다. 또한 문단에 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.

구조 탐지

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

--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

       Kovid Goyal

7.6.0                                             3월 01, 2024                                  EBOOK-CONVERT(1)