| EBOOK-CONVERT(1) | calibre | EBOOK-CONVERT(1) |
نام (NAME)
ebook-convert - تبدیل کتابهای الکترونیکی
ebook-convert input_file output_file [options]
تبدیل یک کتاب الکترونیکی از یک قالب به قالبی دیگر.
input_file فایل ورودی و output_file فایل خروجی است. هر دو باید به عنوان دو آرگومان نخست دستور مشخص شوند.
قالب کتاب الکترونیکی خروجی از پسوند فایل output_file حدس زده میشود. همچنین output_file میتواند به صورت قالب ویژه .EXT باشد که در آن EXT پسوند فایل خروجی است. در این حالت، نام فایل خروجی از نام فایل ورودی مشتق میشود. توجه داشته باشید که نام فایلها نباید با خط تیره شروع شود. در نهایت، اگر output_file فاقد هرگونه پسوند باشد، به عنوان یک پوشه در نظر گرفته شده و یک کتاب الکترونیکی «باز» (OEB) متشکل از فایلهای HTML درون این پوشه نوشته خواهد شد. این فایلها همان فایلهایی هستند که معمولاً به افزونه خروجی فرستاده میشدند.
پس از تعیین فایل ورودی و خروجی، میتوانید تبدیل را با مشخص کردن گزینههای گوناگون سفارشیسازی کنید. گزینههای دردسترس به انواع فایلهای ورودی و خروجی بستگی دارند. برای دریافت راهنما پیرامون آنها، فایل ورودی و خروجی را مشخص کرده و سپس از گزینه -h استفاده کنید.
برای دسترسی به مستندات کامل سامانه تبدیل، رجوع کنید به تبدیل کتابهای الکترونیکی <#conversion>
هنگامی که آرگومانهایی شامل فاصله به ebook-convert ارسال میکنید، آن آرگومانها را درون علامت نقلقول قرار دهید. برای نمونه: "/some path/with spaces"
گزینهها و مقادیر پیشفرض آنها بسته به قالبهای ورودی و خروجی تغییر میکنند، بنابراین همیشه با دستور زیر بررسی کنید:
ebook-convert myfile.input_format myfile.output_format -h
در ادامه گزینههای مشترک برای همه تبدیلات، و پس از آن گزینههای اختصاصی هر قالب ورودی و خروجی آورده شده است.
- گزینههای ورودی (INPUT OPTIONS)
- گزینههای خروجی (OUTPUT OPTIONS)
- ظاهر و احساس (LOOK AND FEEL)
- پردازش اکتشافی (HEURISTIC PROCESSING)
- جستجو و جایگزینی (SEARCH AND REPLACE)
- تشخیص ساختار (STRUCTURE DETECTION)
- فهرست مطالب (TABLE OF CONTENTS)
- فراداده (METADATA)
- اشکالزدایی (DEBUGGING)
- --help, -h
- نمایش این پیام راهنما و خروج
- --input-profile
- مشخص کردن نمایه ورودی. نمایه ورودی اطلاعاتی پیرامون نحوه تفسیر اطلاعات گوناگون درون سند ورودی، مانند ابعاد وابسته به وضوح (یعنی طولها بر حسب پیکسل) را به سامانه تبدیل میدهد. گزینهها عبارتند از: cybookg3, cybook_opus, default, hanlinv3, hanlinv5, illiad, irexdr1000, irexdr800, kindle, msreader, mobipocket, nook, sony, sony300, sony900
- --list-recipes
- فهرست کردن نام دستورالعملهای (recipes) پیشساخته. میتوانید یک کتاب الکترونیکی را از روی دستورالعملهای توکار به این صورت بسازید: ebook-convert "recipe name.recipe" output.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
- نمایش شماره نسخه برنامه و خروج
گزینههای ورودی (INPUT OPTIONS)
گزینههایی برای کنترل پردازش فایل ورودی mobi
- --input-encoding
- مشخص کردن کدگذاری نویسههای سند ورودی. با تعیین این گزینه، هرگونه کدگذاری اعلامشده توسط خود سند لغو و بازنویسی میشود. بهویژه برای اسنادی که کدگذاری اعلام نکردهاند یا کدگذاری نادرستی دارند مفید است.
گزینههای خروجی (OUTPUT OPTIONS)
گزینههایی برای کنترل پردازش خروجی epub
- --dont-split-on-page-breaks
- غیرفعال کردن تقسیم در شکستگیهای صفحه (page breaks). به طور معمول، فایلهای ورودی در هر شکستگی صفحه به طور خودکار به دو فایل تقسیم میشوند. این امر موجب تولید کتاب الکترونیکی میشود که میتوان آن را سریعتر و با مصرف منابع کمتری تجزیه کرد. با این حال، تقسیم روندی زمانبر است؛ بنابراین اگر فایل مبدا شما شکستگیهای صفحه بسیار زیادی دارد، باید تقسیم فایلها در شکستگیهای صفحه را غیرفعال کنید.
- --epub-flatten
- این گزینه تنها زمانی مورد نیاز است که قصد داشته باشید از EPUB در FBReaderJ استفاده کنید. این گزینه ساختار فایل درون EPUB را مسطح کرده و همه فایلها را در سطح ریشه قرار میدهد.
- --epub-inline-toc
- درج یک فهرست مطالب درونمتنی که به عنوان بخشی از محتوای اصلی کتاب نمایان خواهد شد.
- --epub-max-image-size
- حداکثر ابعاد تصویر (عرض × ارتفاع). مقدار profile به معنی استفاده از ابعاد نمایشگر بر پایه نمایه خروجی است. مقدار none به معنای نبود محدودیت حداکثر اندازه است. برای نمونه، مقدار 100x200 باعث تغییر اندازه تمامی تصاویر میشود به طوری که عرض آنها از ۱۰۰ پیکسل و ارتفاع آنها از ۲۰۰ پیکسل فراتر نرود. توجه داشته باشید که این گزینه فقط بر اندازه خود فایلهای تصویری اثر میگذارد؛ ممکن است هر تصویر بر پایه شیوهنامه اعمالشده در سند با اندازه دیگری نمایش داده شود.
- --epub-toc-at-end
- قرار دادن فهرست مطالب درونمتنیِ درجشده در انتهای کتاب به جای ابتدای آن.
- --epub-version
- نسخه فایل EPUB تولیدی. نسخه EPUB 2 بیشترین سازگاری را دارد؛ تنها در صورتی از EPUB 3 استفاده کنید که مطمئن باشید واقعاً به آن نیاز دارید.
- --extract-to
- استخراج محتوای کتاب تولیدشده در پوشه تعیینشده. توجه داشته باشید که محتویات پوشه ابتدا پاک خواهد شد.
- --flow-size
- تقسیم تمام فایلهای HTML با حجم بیشتر از این اندازه (بر حسب کیلوبایت). این امر ضروری است زیرا بیشتر کتابخوانهای EPUB توانایی پردازش فایلهای بزرگ را ندارند. مقدار پیشفرض 260KB است که اندازه مورد نیاز برای Adobe Digital Editions میباشد. برای غیرفعال کردن تقسیمبندی بر پایه اندازه، مقدار را برابر 0 قرار دهید.
- --no-default-epub-cover
- به طور معمول، اگر فایل ورودی فاقد جلد باشد و جلدی نیز مشخص نکرده باشید، یک جلد پیشفرض حاوی عنوان، نویسندگان و موارد دیگر تولید میشود. این گزینه تولید جلد پیشفرض را غیرفعال میکند.
- --no-svg-cover
- عدم استفاده از SVG برای جلد کتاب. اگر فایل EPUB شما در دستگاهی استفاده میشود که از SVG پشتیبانی نمیکند (مانند iPhone یا JetBook Lite)، از این گزینه استفاده کنید. در صورت استفاده نکردن از این گزینه، چنین دستگاههایی جلد را به شکل یک صفحه خالی نشان میدهند.
- --preserve-cover-aspect-ratio
- هنگام استفاده از جلد SVG، این گزینه موجب تغییر ابعاد جلد متناسب با فضای نمایشگر و در عین حال حفظ نسبت تصویر میشود. این بدان معناست که ممکن است حاشیههای سفیدی در طرفین یا بالا و پایین تصویر پدید آید، اما تصویر هرگز دگرگون یا کشیده نمیشود. بدون این گزینه ممکن است تصویر کمی دگرگون شود، ولی حاشیهای وجود نخواهد داشت.
- --pretty-print
- در صورت فعال بودن، افزونه خروجی تلاش میکند تا خروجی تولیدی حتیالامکان برای انسان خوانا باشد. ممکن است روی برخی افزونههای خروجی اثری نداشته باشد.
- --toc-title
- عنوان فهرست مطالب درونمتنی تولیدشده.
ظاهر و حس (LOOK AND FEEL)
گزینههایی برای واپایش ظاهر و حس خروجی
- --asciiize
- تبدیل نویسههای یونیکد به بازنمود ASCII. با احتیاط استفاده کنید زیرا این کار نویسههای یونیکد را با ASCII جایگزین میکند. به عنوان مثال، "Pelé" را با "Pele" جایگزین میکند. همچنین توجه داشته باشید که در مواردی که چندین بازنمود برای یک نویسه وجود دارد (برای نمونه نویسههای مشترک میان چینی و ژاپنی)، بازنمود بر اساس زبان فعلی رابط کاربری Calibre استفاده خواهد شد.
- --base-font-size
- اندازه قلم پایه بر حسب نقطه (pt). اندازه تمام قلمها در کتاب خروجی بر اساس این اندازه مقیاسبندی مجدد خواهد شد. با انتخاب اندازهای بزرگتر، میتوانید قلمها را در خروجی بزرگتر کنید و بالعکس. بهطور پیشفرض، وقتی مقدار صفر است، اندازه قلم پایه بر اساس نمایه خروجی انتخابی شما تعیین میشود.
- --change-justification
- تغییر چینش متن. مقدار "left" تمام متنهای تراز شده (justified) در منبع را به متنی چپچین (یعنی تراز نشده) تبدیل میکند. مقدار "justify" تمام متنهای تراز نشده را به تراز شده تبدیل میکند. مقدار "original" (پیشفرض) چینش را در پرونده منبع تغییر نمیدهد. توجه: تنها برخی از قالبهای خروجی از تراز کردن متن پشتیبانی میکنند.
- --disable-font-rescaling
- غیرفعالسازی تمام عملیات مقیاسبندی مجدد اندازه قلمها.
- --embed-all-fonts
- جاسازی هر قلمی که در سند ورودی ارجاع داده شده اما هنوز جاسازی نشده است. این گزینه سیستم شما را برای یافتن قلمها جستجو کرده و در صورت یافتن، آنها را جاسازی میکند. جاسازی تنها در صورتی کار میکند که قالب خروجی شما از قلمهای جاسازیشده پشتیبانی کند، مانند EPUB، AZW3، DOCX یا PDF. لطفاً اطمینان حاصل کنید که مجوز مناسب برای جاسازی قلمهای استفادهشده در این سند را دارید.
- --embed-font-family
- جاسازی خانواده قلم مشخصشده در کتاب. این گزینه قلم "پایه" مورد استفاده در کتاب را مشخص میکند. اگر سند ورودی قلمهای اختصاصی خود را مشخص کرده باشد، ممکن است آن قلمها بر این قلم پایه ارجحیت یابند. برای حذف قلمها از سند ورودی میتوانید از گزینه پالایش اطلاعات سبک استفاده کنید. توجه داشته باشید که جاسازی قلم تنها با برخی قالبهای خروجی، عمدتاً EPUB، AZW3 و DOCX کار میکند.
- --expand-css
- بهطور پیشفرض، Calibre از شکل خلاصهنویسیشده ویژگیهای مختلف CSS مانند margin، padding، border و غیره استفاده میکند. این گزینه باعث میشود به جای آن از شکل کامل گسترشیافته استفاده کند. توجه داشته باشید هنگام ایجاد پروندههای EPUB با نمایهای از نمایههای Nook، همواره CSS گسترش داده میشود زیرا Nook نمیتواند CSS خلاصهنویسیشده را پردازش کند.
- --extra-css
- مسیر به یک شیوهنامه CSS یا کد خام CSS. این CSS به قواعد سبک پرونده مبدا افزوده خواهد شد و بنابراین میتوان از آن برای بازنویسی و لغو آن قواعد استفاده کرد.
- --filter-css
- فهرستی جداشده با کاما از ویژگیهای CSS که از تمام قواعد سبک CSS حذف خواهند شد. این گزینه زمانی سودمند است که وجود برخی اطلاعات سبک مانع بازنویسی آنها در دستگاه شما شود. برای مثال: font-family,color,margin-left,margin-right
- --font-size-mapping
- نگاشت از نامهای اندازه قلم CSS به اندازههای قلم بر حسب نقطه (pt). یک نمونه تنظیم 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
- حفظ خطنگارهها (ligatures) موجود در سند ورودی. خطنگاره نویسهای ترکیبی از یک جفت نویسه مانند ff، fi، fl و غیره است. بیشتر کتابخوانها از خطنگارهها در قلمهای پیشفرض خود پشتیبانی نمیکنند، بنابراین بعید است به درستی نمایش داده شوند. بهطور پیشفرض، Calibre خطنگاره را به جفت نویسه عادی معادل آن تبدیل میکند. توجه داشته باشید که منظور از خطنگاره در اینجا فقط خطنگارههای یونیکد است نه خطنگارههایی که از طریق CSS یا سبکهای قلم ایجاد شدهاند. این گزینه به جای تبدیل، آنها را حفظ میکند.
- --line-height
- ارتفاع خط بر حسب نقطه (pt). فاصله میان خطوط متوالی متن را واپایش میکند. فقط برای عناصری اعمال میشود که ارتفاع خط اختصاصی تعیین نکردهاند. در بیشتر موارد، گزینه حداقل ارتفاع خط کاربردیتر است. بهطور پیشفرض، هیچ تغییری روی ارتفاع خط اعمال نمیشود.
- --linearize-tables
- برخی اسناد با طراحی نامناسب از جدولها برای واپایش چینش متن در صفحه استفاده میکنند. هنگام تبدیل این اسناد، معمولاً متن از صفحه بیرون میزند و ایرادات دیداری رخ میدهد. این گزینه محتوا را از جدولها استخراج کرده و به صورت خطی ارائه میدهد.
- --margin-bottom
- تنظیم حاشیه پایین بر حسب نقطه (pt). پیشفرض 5.0 است. تنظیم این مقدار به کمتر از صفر باعث میشود هیچ حاشیهای تنظیم نشود (تنظیم حاشیه در سند اصلی حفظ خواهد شد). نکته: قالبهای مبتنی بر صفحه مانند PDF و DOCX تنظیمات حاشیه مختص به خود را دارند که اولویت بالاتری دارد.
- --margin-left
- تنظیم حاشیه چپ بر حسب نقطه (pt). پیشفرض 5.0 است. تنظیم این مقدار به کمتر از صفر باعث میشود هیچ حاشیهای تنظیم نشود (تنظیم حاشیه در سند اصلی حفظ خواهد شد). نکته: قالبهای مبتنی بر صفحه مانند PDF و DOCX تنظیمات حاشیه مختص به خود را دارند که اولویت بالاتری دارد.
- --margin-right
- تنظیم حاشیه راست بر حسب نقطه (pt). پیشفرض 5.0 است. تنظیم این مقدار به کمتر از صفر باعث میشود هیچ حاشیهای تنظیم نشود (تنظیم حاشیه در سند اصلی حفظ خواهد شد). نکته: قالبهای مبتنی بر صفحه مانند PDF و DOCX تنظیمات حاشیه مختص به خود را دارند که اولویت بالاتری دارد.
- --margin-top
- تنظیم حاشیه بالا بر حسب نقطه (pt). پیشفرض 5.0 است. تنظیم این مقدار به کمتر از صفر باعث میشود هیچ حاشیهای تنظیم نشود (تنظیم حاشیه در سند اصلی حفظ خواهد شد). نکته: قالبهای مبتنی بر صفحه مانند PDF و DOCX تنظیمات حاشیه مختص به خود را دارند که اولویت بالاتری دارد.
- --minimum-line-height
- حداقل ارتفاع خط، به صورت درصدی از اندازه قلم محاسبهشده عنصر. نرمافزار Calibre اطمینان حاصل میکند که هر عنصر حداقل ارتفاع خطی برابر با این مقدار داشته باشد، صرف نظر از آنچه سند ورودی مشخص کرده است. برای غیرفعالسازی روی صفر تنظیم کنید. پیشفرض 120% است. به جای تعیین مستقیم ارتفاع خط از این تنظیم استفاده کنید، مگر اینکه دقیقاً بدانید چه میکنید. برای مثال، میتوانید با تنظیم این مقدار روی 240 به متن با "فاصله دوبرابر (double spaced)" دست یابید.
- --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
- استخراج زیرمجموعه از تمام قلمهای جاسازیشده. هر قلم جاسازیشده کاهش مییابد تا فقط شامل نشانههای ترسیمی (گلیفها) استفادهشده در این سند باشد. این کار اندازه پروندههای قلم را کاهش میدهد. زمانی سودمند است که قلم بسیار بزرگی را با تعداد زیادی نویسه استفادهنشده جاسازی میکنید.
- --transform-css-rules
- مسیر پروندهای شامل قواعد برای تبدیل سبکهای CSS در این کتاب. سادهترین روش برای ایجاد چنین پروندهای، استفاده از ویزارد ایجاد قواعد در رابط کاربری گرافیکی Calibre است. در بخش "ظاهر و حس->تبدیل سبکها" از کادر گفتگوی تبدیل به آن دسترسی پیدا کنید. پس از ایجاد قواعد، میتوانید از دکمه "برونبری (Export)" برای ذخیره آنها در پرونده استفاده کنید.
- --transform-html-rules
- مسیر پروندهای شامل قواعد برای تبدیل HTML در این کتاب. سادهترین راه برای ساخت چنین پروندهای، استفاده از ویزارد ایجاد قواعد در رابط کاربری گرافیکی Calibre است. در کادر گفتگوی تبدیل، در بخش "ظاهر و حس->تبدیل HTML" به آن دسترسی داشته باشید. پس از ایجاد قواعد، میتوانید از دکمه "برونبری (Export)" برای ذخیره آنها در پرونده استفاده کنید.
- --unsmarten-punctuation
- تبدیل علامتهای نقلقول تزئینی، خطهای تیره و نشانههای تعلیق به معادلهای ساده آنها.
پردازش اکتشافی (HEURISTIC PROCESSING)
تغییر متن و ساختار سند با استفاده از الگوهای متداول. بهطور پیشفرض غیرفعال است. برای فعالسازی از --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
- فعالسازی پردازش اکتشافی (heuristics). این گزینه باید تنظیم شود تا هرگونه پردازش اکتشافی اعمال گردد.
- --html-unwrap-factor
- مقیاس مورداستفاده برای تعیین طولی که یک سطر باید باز شود. مقادیر معتبر اعشاری بین 0 و 1 هستند. مقدار پیشفرض 0.4 است، کمی پایینتر از طول میانه خط. اگر فقط تعداد کمی از سطرهای سند نیاز به باز شدن دارند، این مقدار باید کاهش یابد.
- --replace-scene-breaks
- جایگزینی نشانگرهای شکست صحنه با متن مشخصشده. بهطور پیشفرض از متن موجود در سند ورودی استفاده میشود.
جستوجو و جایگزینی (SEARCH AND REPLACE)
تغییر متن و ساختار سند با استفاده از الگوهای تعریفشده توسط کاربر.
- --search-replace
- مسیر فایلی شامل عبارتهای باقاعده برای جستوجو و جایگزینی. فایل باید حاوی خطوط متناوبی از عبارت باقاعده و به دنبال آن الگوی جایگزینی (که میتواند یک خط خالی باشد) باشد. عبارت باقاعده باید از نحو عبارتهای باقاعده پایتون پیروی کند و فایل باید با کدگذاری 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.
تشخیص ساختار (STRUCTURE DETECTION)
کنترل تشخیص خودکار ساختار سند.
- --add-alt-text-to-img
- هنگامی که یک برچسب <img> دارای ویژگی alt نباشد، متادیتای فایل تصویر متناظر بررسی شده و در صورت وجود متن جایگزین، برای پر کردن ویژگی alt استفاده میشود. ویژگی alt با ارائه توضیحات متنی برای کاربرانی که قادر به مشاهده کامل محتوای بصری نیستند، دسترسیپذیری را بهبود میبخشد.
- --chapter
- یک عبارت XPath برای تشخیص عناوین فصلها. حالت پیشفرض برچسبهای <h1> یا <h2> را که حاوی کلمات "chapter"، "book"، "section"، "prologue"، "epilogue" یا "part" باشند، به همراه هر برچسبی با خصوصیت class="chapter" بهعنوان عناوین فصل در نظر میگیرد. عبارت استفادهشده باید به فهرستی از عناصر ارزیابی شود. برای غیرفعال کردن تشخیص فصل، از عبارت "/" استفاده کنید. برای اطلاعات بیشتر پیرامون نحوه استفاده از این ویژگی، به آموزش XPath در راهنمای کاربری Calibre مراجعه فرمایید.
- --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) از این مکان برای باز کردن اولیه کتاب استفاده میکنند. برای راهنمایی بیشتر درباره استفاده از این قابلیت، به آموزش XPath در راهنمای کاربری Calibre رجوع کنید.
فهرست مطالب (TABLE OF CONTENTS)
مدیریت ایجاد خودکار فهرست مطالب. بهطور پیشفرض، اگر فایل مبدأ دارای فهرست مطالب باشد، به جای فهرست خودکار ایجادشده از آن استفاده میشود.
- --duplicate-links-in-toc
- هنگام ایجاد فهرست مطالب از پیوندهای سند ورودی، اجازه درج موارد تکراری داده شود؛ یعنی بیش از یک مدخل با متن یکسان مجاز است، به شرطی که به مکان متفاوتی اشاره کنند.
- --level1-toc
- عبارت XPath که تمامی برچسبهایی را که باید در سطح اول به فهرست مطالب اضافه شوند مشخص میکند. در صورت تعیین، بر سایر اشکال تشخیص خودکار اولویت دارد. برای نمونهها به آموزش XPath در راهنمای کاربر Calibre مراجعه کنید.
- --level2-toc
- عبارت XPath که تمامی برچسبهایی را که باید در سطح دوم به فهرست مطالب اضافه شوند مشخص میکند. هر مدخل زیر مدخل سطح اول قبلی اضافه میشود. برای نمونهها به آموزش XPath در راهنمای کاربر Calibre مراجعه کنید.
- --level3-toc
- عبارت XPath که تمامی برچسبهایی را که باید در سطح سوم به فهرست مطالب اضافه شوند مشخص میکند. هر مدخل زیر مدخل سطح دوم قبلی اضافه میشود. برای نمونهها به آموزش XPath در راهنمای کاربر Calibre مراجعه کنید.
- --max-toc-links
- حداکثر تعداد پیوندهایی که در فهرست مطالب درج میشوند. برای غیرفعالسازی مقدار را برابر 0 قرار دهید. مقدار پیشفرض: 50 است. پیوندها تنها در صورتی به فهرست مطالب اضافه میشوند که تعداد فصلهای شناساییشده کمتر از حد آستانه باشد.
- --no-chapters-in-toc
- عدم افزودن خودکار فصلهای شناساییشده به فهرست مطالب.
- --toc-filter
- حذف مدخلهایی از فهرست مطالب که عنوان آنها با عبارت باقاعده (regex) مشخصشده مطابقت دارد. مدخلهای منطبق و تمامی زیرمجموعههای آنها حذف میشوند.
- --toc-threshold
- اگر تعداد فصلهای شناساییشده کمتر از این مقدار باشد، پیوندها به فهرست مطالب اضافه میشوند. پیشفرض: 6
- --use-auto-toc
- بهطور معمول، اگر فایل مبدأ از پیش دارای فهرست مطالب باشد، از آن به جای فهرست ایجادشده بهطور خودکار استفاده میشود. با این گزینه، همواره از فهرست ایجادشده خودکار استفاده خواهد شد.
فراداده (METADATA)
گزینههایی برای تنظیم فراداده در خروجی
- رشته متنی مورد استفاده هنگام مرتبسازی بر اساس نویسنده.
- تنظیم نویسندگان. نویسندگان متعدد باید با علامت (&) از یکدیگر جدا شوند.
- --book-producer
- تنظیم تولیدکننده کتاب.
- --comments
- تنظیم توضیحات کتاب الکترونیکی.
- --cover
- تنظیم جلد روی فایل یا نشانی اینترنتی (URL) مشخصشده.
- --isbn
- تنظیم شماره استاندارد بینالمللی کتاب (ISBN).
- --language
- تنظیم زبان.
- --pubdate
- تنظیم تاریخ انتشار (فرض میشود بر حسب زمان محلی است، مگر اینکه منطقه زمانی به صراحت مشخص شده باشد).
- --publisher
- تنظیم ناشر کتاب الکترونیکی.
- --rating
- تنظیم رتبهبندی. باید عددی بین 1 تا 5 باشد.
- --read-metadata-from-opf, --from-opf, -m
- خواندن فراداده از فایل OPF مشخصشده. فراداده خواندهشده از این فایل بر هرگونه فراداده در فایل منبع برتری خواهد داشت.
- --series
- تنظیم مجموعهای که این کتاب الکترونیکی به آن تعلق دارد.
- --series-index
- تنظیم شماره کتاب در این مجموعه.
- تنظیم برچسبهای کتاب. باید فهرستی جداشده با کاما باشد.
- --timestamp
- تنظیم برچسب زمانی کتاب (دیگر در هیچ کجا استفاده نمیشود).
- --title
- تنظیم عنوان.
- --title-sort
- نسخه عنوان مورد استفاده برای مرتبسازی.
عیبیابی (DEBUGGING)
گزینههایی برای کمک به عیبیابی تبدیل
- --debug-pipeline, -d
- ذخیره خروجی مراحل مختلف خط لوله تبدیل در پوشه مشخصشده. اگر مطمئن نیستید خطا در کدام مرحله از فرایند تبدیل رخ میدهد، مفید است.
- --verbose, -v
- سطح پرگویی (تفصیل). برای افزایش سطح پرگویی این گزینه را چند بار مشخص کنید. تعیین دوبار آن پرگویی کامل، یک بار پرگویی متوسط و صفر بار کمترین پرگویی را در پی خواهد داشت.
نویسنده (AUTHOR)
Kovid Goyal
حق نشر (COPYRIGHT)
Kovid Goyal
| 28 اوت 2026 | 9.14.0 |