E-book conversion

calibre has a conversion system that is designed to be very easy to use. Normally, you just add a book to calibre, click convert and calibre will try hard to generate output that is as close as possible to the input. However, calibre accepts a very large number of input formats, not all of which are as suitable as others for conversion to e-books. In the case of such input formats, or if you just want greater control over the conversion system, calibre has a lot of options to fine tune the conversion process. Note however that calibre’s conversion system is not a substitute for a full blown e-book editor. To edit e-books, I recommend first converting them to EPUB or AZW3 using calibre and then using the Edit book feature to get them into perfect shape. You can then use the edited e-book as input for conversion into other formats in calibre.

Bu belge çoğunlukla aşağıda resmi olan dönüştürme penceresinde bulunan dönüştürme ayarlarına değinecektir. Tüm bu ayarlar ayrıca ebook-convert belgesinde belgelenen dönüştürme komut satırı arayüzü ile de kullanılabilirdir. Calibre’de, tüm ayarlar için yardım metnini fareyi ayar üzerinde tutarak edinebilirsiniz, ilgili ayarı anlatan bir araç ipucu çıkacaktır.

E-book conversion dialog

Giriş

Dönüşüm sistemi hakkında anlaşılması gereken ilk şey, bunun düz bir hat şeklinde tasarlandığıdır. Sistemin şematik görünüşü şöyledir:

The conversion pipeline

The input format is first converted to XHTML by the appropriate Input plugin. This HTML is then transformed. In the last step, the processed XHTML is converted to the specified output format by the appropriate Output plugin. The results of the conversion can vary greatly, based on the input format. Some formats convert much better than others. A list of the best source formats for conversion is available here.

The transforms that act on the XHTML output are where all the work happens. There are various transforms, for example, to insert book metadata as a page at the start of the book, to detect chapter headings and automatically create a Table of Contents, to proportionally adjust font sizes, et cetera. It is important to remember that all the transforms act on the XHTML output by the Input plugin, not on the input file itself. So, for example, if you ask calibre to convert an RTF file to EPUB, it will first be converted to XHTML internally, the various transforms will be applied to the XHTML and then the Output plugin will create the EPUB file, automatically generating all metadata, Table of Contents, et cetera.

Bu işlemi çalışırken hata ayıklama seçeneği Debug icon ile görebilirsiniz. Hata ayıklama çıktısı için bir dizin belirtmeniz yeterli. Dönüştürme sırasında, calibre, dönüştürmenin bir takım evrelerinde üretilen XHTML’yi değişik alt dizinlere koyar. Dört alt dizi ise şunlardır:

Dönüşüm hattı aşamaları
Klasör Açıklama
girdi This contains the HTML output by the Input plugin. Use this to debug the Input plugin.
çözümlenmiş The result of pre-processing and converting to XHTML the output from the Input plugin. Use to debug structure detection.
yapı CSS düzleme ve yazı tipi boyutu dönüştürmeden önce, yapı sonrası algılama. Yazı tipi ve CSS dönüşümlerindeki hataları ayıklamak için kullanın.
işlenmiş Just before the e-book is passed to the Output plugin. Use to debug the Output plugin.

If you want to edit the input document a little before having calibre convert it, the best thing to do is edit the files in the input sub-directory, then zip it up, and use the ZIP file as the input format for subsequent conversions. To do this use the Edit meta information dialog to add the ZIP file as a format for the book and then, in the top left corner of the conversion dialog, select ZIP as the input format.

This document will deal mainly with the various transforms that operate on the intermediate XHTML and how to control them. At the end are some tips specific to each input/output format.

Görünüm

This group of options controls various aspects of the look and feel of the converted e-book.

Fontlar

E-kitap okuma deneyiminin en güzel özelliklerinden biri kitabın yazı tipi boyutunu kişisel tercih ve aydınlatma koşllarına uygun olarak kolayca ayarlayabilmektir. Calibre, girdi olarak verilen dökümandaki yazı tipi boyutları ne olursa olsun, çıktı olarak ürettiği e-kitaplarda tutarlı yazı tipi boyutları oluşturmak için karmaşık algoritmalara sahiptir.

Bir dökümanın baz yazı tipi boyutu, o dökümandaki en sık kullanılan yazı tipi boyutu ya da diğer bir ifadeyle dökümandaki içeriğin büyük kısmında kullanılan boyuttur. Bir Baz yazı tipi boyutu belirlediğinizde, Calibre otomatik olarak dökümandaki bütün yazı tipi boyutlarını bu değere oransal olarak yeniden ayarlar, böylece en çok kullanılan yazı tipi boyutu belirlenen boyut olur ve diğer yazı tipi büyüklükleri de buna uygun olarak belirlenir. Örneğin daha büyük bir baz font boyutu belirleyerek, dökümandaki tüm yazı tipi boyutlarının büyümesi (Ya da daha küçük baz yazı tipi seçildiğinde tüm yazı tipi boyutlarının küçülmesi) sağlanabilir. En iyi sonuca ulaşabilmek için bir baz yazı tipi büyüklüğü belirlediğinizde yazı tipi boyutu anahtar değerinin de belirlenmesi yerinde olacaktır.

Normally, calibre will automatically choose a base font size appropriate to the output profile you have chosen (see Page setup). However, you can override this here in case the default is not suitable for you.

Yazı tipi boyutu anahtarı opsiyonu baz yazı tipi dışındaki yazı tiplerinin nasıl boyutlandırılacağının kontrol edilmesini sağlar. Bu opsiyon temelde yazı tipi boyutlarının birbirinden virgülle ayrıldığı bir listedir. Anahtar değeri Calibre’ye bir yazı tipinin baz yazı tipine oranla kaç “Adım” büyük ya da küçük olacağını belirtir. Normalde bir dökümanda sınırlı sayıda yazı tipi boyutu kullanılmış olmalıdır. Örneğin “normal metinler için bir boyut, farklı derecedeki başlıklar için birkaç boyut ve dipnot vb. kullanımlar için daha birkaç boyut” gibi. Yazı tipi boyutu anahtarı Calibre’ye, girdi dökümandaki farklı yazı tipi boyutlarını farklı “kategoriler” altında gruplandırma olanağı sağlar.

Bir örnek üzerinden gidecek olursak; Kaynak dökümanımız 8pt. baz yazı tipi boyutuna sahip olsun. Bu durumda dökümandaki metnin büyük kısmı 8pt olacaktır, başlıklar biraz daha büyük (Mesela 10 ve 12 pt) ve dipnotlar da 6pt gibi daha küçük bir boyutta olsun. Eğer bu örnek için aşağıdaki ayarları kullanırsak:

Base font size : 12pt
Font size key  : 7, 8, 10, 12, 14, 16, 18, 20

Çıktı 12pt baz yazı tipi boyutuna sahipken başlıklar 14 ve 16 pt, dipnotlar ise 8pt olacaktır. Şimdi varsayalım ki büyük başlıkların ve dipnotların boyutunu biraz daha büyüterek bunları öne çıkarmak istiyoruz. Bunun için yazı tipi anahtarının değeri şu şekilde güncellenir:

New font size key : 7, 9, 12, 14, 18, 20, 22

Şimdi büyük başlıklar 18pt olurken dipnotlar 9pt olarak boyutlandırılacak. Hangisinin sizin için en uygun olduğunu anlamak için bu değerleri yazı tipi boyutlandırma sihirbazını kullanarak değiştirebilirsiniz. Bu sihirbaza Yazı tipi boyutu anahtarı bölümünün hemen yanındaki küçük buton ile ulaşabilirsiniz.

Girdi belgesindeki yazı tipi boyutlarını korumak isterseniz, tüm yazı tipi yeniden ölçekleme işlemi buradan kapatılabilir.

A related setting is Line height. Line height controls the vertical height of lines. By default, (a line height of 0), no manipulation of line heights is performed. If you specify a non-default value, line heights will be set in all locations that don’t specify their own line heights. However, this is something of a blunt weapon and should be used sparingly. If you want to adjust the line heights for some section of the input, it’s better to use the Extra CSS.

In this section you can also tell calibre to embed any referenced fonts into the book. This will allow the fonts to work on reader devices even if they are not available on the device.

Metin

Text can be either justified or not. Justified text has extra spaces between words to give a smooth right margin. Some people prefer justified text, others do not. Normally, calibre will preserve the justification in the original document. If you want to override it you can use the Text justification option in this section.

You can also tell calibre to Smarten punctuation which will replace plain quotes, dashes and ellipses with their typographically correct alternatives. Note that this algorithm is not perfect so it is worth reviewing the results. The reverse, namely, Unsmarted punctuation is also available.

Finally, there is Input character encoding. Older documents sometimes don’t specify their character encoding. When converted, this can result in non-English characters or special characters like smart quotes being corrupted. calibre tries to auto-detect the character encoding of the source document, but it does not always succeed. You can force it to assume a particular character encoding by using this setting. cp1252 is a common encoding for documents produced using Windows software. You should also read İngiliz alfabesi dışında karakterler, veya akıllı tırnak içeren dosyamı nasıl dönüştürürüm? for more on encoding issues.

Yerleşim

Normalde XHTML’de paragraflar aralarında bir satır boşluk olacak şekilde ve takip eden metin girintisi bulunmadan gerçeklenir. Calibre’nin bunu kontrol etmek için bir takım seçenekleri vardır. Paragraflar arası boşlukları kaldır tüm paragrafların iç paragraf boşluğu olmamasını garantiler. Ayrıca paragrafın başlangıcını işaretlemek için metin girintisini 1.5em olarak ayarlar (değiştirilebilir). :guilabel: Boş satır ekle tam tersini yapar, her paragraf arası bir boş satır olduğundan emin olur. Bu iki seçenek de çok kapsamlıdır, boşlukların kaldırılması, veya tüm paragraflara eklenmesi (teknik olarak <p> ve <div> etiketleri). Bunun sebebi seçeneği ayarladıktan sonra yapacağını söylediği şeyi yaptığından emin olmanızı sağlamaktır, girdi dosyası ne kadar dağınık olsa da. Bir istisna girdi dosyasının iç paragraflar için boşluksuz satır başı yaptığı durumdur.

If you want to remove the spacing between all paragraphs, except a select few, don’t use these options. Instead add the following CSS code to Extra CSS:

p, div { margin: 0pt; border: 0pt; text-indent: 1.5em }
.spacious { margin-bottom: 1em; text-indent: 0pt; }

Sonra, kaynak belgenizde, boşluğa ihtiyaç duyan paragrafları class=”spacious” ile işaretleyin. Girdi belgeniz HTML biçiminde değilse, HTML almak için giriş bölümünde anlatıldığı gibi Hata ayıklama seçeneğini kullanın (input alt dizinini kullanın).

Another useful options is Linearize tables. Some badly designed documents use tables to control the layout of text on the page. When converted these documents often have text that runs off the page and other artifacts. This option will extract the content from the tables and present it in a linear fashion. Note that this option linearizes all tables, so only use it if you are sure the input document does not use tables for legitimate purposes, like presenting tabular information.

Stil

The Extra CSS option allows you to specify arbitrary CSS that will be applied to all HTML files in the input. This CSS is applied with very high priority and so should override most CSS present in the input document itself. You can use this setting to fine tune the presentation/layout of your document. For example, if you want all paragraphs of class endnote to be right aligned, just add:

.endnote { text-align: right }

ya da tüm paragraflardaki girintilemeyi değiştirmek için:

p { text-indent: 5mm; }

Fazladan CSS çok güçlü bir seçenektir, ama tam anlamıyla kullanabilmek için CSS nasıl çalışır iyice anlamış olmalısınız. Girdi belgenizde hangi CSS’lerin mevcut olduğunu öğrenmek için aşağıda belirtilen hata ayıklama boru hattı seçeneğini kullanabilirsiniz.

A simpler option is to use Filter style information. This allows you to remove all CSS properties of the specified types from the document. For example, you can use it to remove all colors or fonts.

Stilleri dönüştür

This is the most powerful styling related facility. You can use it to define rules that change styles based on various conditions. For example you can use it to change all green colors to blue, or remove all bold styling from the text or color all headings a certain color, etc.

Page setup

The Page setup options are for controlling screen layout, like margins and screen sizes. There are options to setup page margins, which will be used by the output plugin, if the selected output format supports page margins. In addition, you should choose an Input profile and an output profile. Both sets of profiles basically deal with how to interpret measurements in the input/output documents, screen sizes and default font rescaling keys.

If you know that the file you are converting was intended to be used on a particular device/software platform, choose the corresponding input profile, otherwise just choose the default input profile. If you know the files you are producing are meant for a particular device type, choose the corresponding output profile. In particular, for MOBI output files, you should choose the Kindle, for LIT the Microsoft Reader and for EPUB the Sony Reader. In the case of EPUB, the Sony Reader profile will result in EPUB files that will work everywhere. However, it has some side effects, like inserting artificial section breaks to keep internal components below the size threshold, needed for SONY devices. In particular for the iPhone/Android phones, choose the SONY output profile. If you know your EPUB files will not be read on a SONY or similar device, use the default output profile. If you are producing MOBI files that are not intended for the Kindle, choose the Mobipocket books output profile.

The output profile also controls the screen size. This will cause, for example, images to be auto-resized to be fit to the screen in some output formats. So choose a profile of a device that has a screen size similar to your device.

Heuristic processing

Heuristic processing provides a variety of functions which can be used to try and detect and correct common problems in poorly formatted input documents. Use these functions if your input document suffers from poor formatting. Because these functions rely on common patterns, be aware that in some cases an option may lead to worse results, so use with care. As an example, several of these options will remove all non-breaking-space entities, or may include false positive matches relating to the function.

Sezgisel işlemeyi etkinleştir
This option activates calibre’s Heuristic processing stage of the conversion pipeline. This must be enabled in order for various sub-functions to be applied
Satırları kaydırma
Bu seçeneği etkinleştirmek calibre’nin bir belgede bulunan boşluksuz satır başlarını noktalama işaretleri ipuçları ve satır uzunluğu kullanarak algılayıp düzeltmeye çalışmasını sağlar. calibre önce boşluksuz satır başlarının mevcut olup olmadığını algılamaya çalışacak, yok gibi görünüyorsa da calibre satır kaydırmak yapmayacaktır. Satır kaydırma yapmama etmeni calibre’yi satır kaydırma yapmamaya ‘zorlamak’ istiyorsanız düşürülebilir.
Satır-kaydırmama etmeni
Bu seçenek calibre’nin boşluksuz satır başlarının kaldırmak için kullandığı algoritmayı kontrol eder. Örneğin, bu seçeneğin değeri 0.4 ise, calibre satır sonlarındaki boşluksuz satır başlarını o satır belgedeki tüm satırların uzunluğunun 40% ve aşağısı uzunluğunda ise kaldırır. Belgenizde düzeltilmesi gereken bir kaç satır sonu varsa, bu değer 0.1 ile 0.2 arası bir değere düşürülmelidir.
Biçimsiz bölüm başlıkları ve alt başlıkları algıla ve işaretle

Belgenizin metnin geri kalanından farklı biçimlendirilmiş bölüm başlıkları ve konuları yoksa, calibre bu seçeneği kullanarak onları algılamaya ve başlık etiketleriyle çevrelemeye çalışabilir. Bölüm başlıkları için <h2> etiketleri kullanılır; algılanan herhangi diğer konu için <h3> etiketleri kullanılır.

This function will not create a TOC, but in many cases it will cause calibre’s default chapter detection settings to correctly detect chapters and build a TOC. Adjust the XPath under Structure detection if a TOC is not automatically created. If there are no other headings used in the document then setting “//h:h2” under Structure detection would be the easiest way to create a TOC for the document.

Eklenmiş başlıklar biçimlendirilmiş değiller, biçimleme eklemek için Görünüm ve Doku dönüştürme ayarları altındaki Ek CSS seçeneğini kullanın. Örneğin, başlık etiketlerini ortalamak için, şunu kullanın:

h2, h3 { text-align: center }
<h1> veya <h2> etiket serisini yeniden numaralandır
Bazı dağıtımcılar bölüm başlıklarını birden çok <h1> veya <h2> etiketlerini sırayla kullanarak biçimlendirirler. calibre’nin varsayılan dönüştürme ayarları bu gibi konu başlıklarının iki parçaya ayrılmasına sebep olur. Bu seçenek ayrılmayı önlemek için başlık etiketlerini yeniden numaralandırır.
Paragraflar arası boş satırları sil
Bu seçenek calibre’nin belgede bulunan boş satırları analiz etmesine sebep olur. Her paragraf arasında bir boş satır varsa, calibre tüm bu boş paragrafları siler. Birden çok boş satır serisi sahne arası olarak ele alınacaktır ve tek bir paragraf olarak korunacaktır. Bu seçenek ‘Görünüm ve Doku’ altındaki ‘Paragraf Boşluklarını Kaldır’ seçeneğinden farklıdır ve aslında HTML içeriği değiştirir, diğer seçenek ise belge biçemlerini. Bu seçenek ayrıca calibre’nin ‘Boş satır ekle’ seçeneğiyle eklenen paragrafları da kaldırabilir.
Sahne aralarının tutarlı biçimlendirildiğinden emin ol
Bu seçenekle, calibre, sık rastlanan sahne arası işaretçilerini algılamaya ve merkezde hizalandıklarından emin olmaya çalışır. ‘Yumuşak’ sahne arası işaretçilerinin, ör. sadece ek bir boşlukla belirtilen sahne aralarının, sayfa aralarıyla karışmayacak şekilde biçimlendiğinden emin olunur.
Sahne aralarını değiştir

Bu seçenek yapılandırılmışsa, calibre kullanıcı tarafından belirtilen metinle bulduğu sahne arası işaretçilerini değiştirir. Lütfen bazı süsleyici karakterlerin tüm okuma aygıtlarında desteklenmiyor olabileceğini not edin.

In general you should avoid using HTML tags, calibre will discard any tags and use pre-defined markup. <hr /> tags, i.e. horizontal rules, and <img> tags are exceptions. Horizontal rules can optionally be specified with styles, if you choose to add your own style be sure to include the ‘width’ setting, otherwise the style information will be discarded. Image tags can used, but calibre does not provide the ability to add the image during conversion, this must be done after the fact using the ‘Edit book’ feature.

Örnek resim etiketi (Dönüşümden sonra resmi epub içindeki bir ‘Resimler’ dizinine koy):
<img style=”width:10%” src=”../Images/scenebreak.png” />
Biçemi olan örnek yatay kural:
<hr style=”width:20%;padding-top: 1px;border-top: 2px ridge black;border-bottom: 2px groove black;”/>
Gereksiz kısa çizgileri sil
bu seçenek etkinken calibre belgedeki tüm tireli içeriği çözümler. Çözümleme için belgenin kendisi sözlük olarak kullanılır. Bu, calibre’nin herhangi bir dilde herhangi bir kelimedeki tireleri doğru şekilde kaldırmasına izin verir, uydurma ve belirsiz bilimsel kelimeler dahil. Birincil eksikliği belgede yalnızca bir kere geçen kelimelerin değiştirilmeyecek olmasıdır. Çözümleme iki aşamada olur, ilk aşama satır sonlarını inceler. Satırlar yalnızce kelime belgede tireli veya tiresiz mevcutsa kaydırılır. İkinci aşama belgedeki tüm tireli kelimeleri inceler, kelime belgede başka bir yerde eşleşme olmadan mevcutsa tireler kaldırılır.
Yaygın kelime ve kalıpları yatık yap
Etkinleştirildiğinde, calibre yaygın kelime ve kalıpları arayıp yatık yazı ifade edenleri yatık hale getirir. Örnek verecek olursak, ~kelime~ gibi yaygın metinler, veya genel olarak yatık yazılması gereken deyimler, örn. latin kalıplardan ‘etc.’ veya ‘et cetera’.
Birim girintilerini CSS girintileriyle değiştir
Some documents use a convention of defining text indents using non-breaking space entities. When this option is enabled calibre will attempt to detect this sort of formatting and convert them to a 3% text indent using CSS.

Search & replace

Bu seçenekler birincil olarak PDF belgeleri ve OCR dönüşümleri için yararlıdır, tabi bir çok belgeye özel problemi çözmek için de kullanılabilirler. Örnek olarak, bazı dönüşümler metinde sayfa başlıkları ya da altbilgileri bırakabilirler. Bu seçenekler düzenli ifadeler kullanarak başlık, altbilgi veya keyfi metinleri bulmaya çalışır ve bu metinleri kaldırır veya değiştirir. Dönüştürme hattındaki ara XHTML çıktı üzerinde işlem yaptıklarını unutmayın. Belgeniz için düzenli ifadeleri özelleştirmenize yarayan bir sihirbaz da mevcuttur. İfade kutusu yanındaki sihirli değneğe tıklayın ve arama ifadenizi yazdıktan sonra ‘Test’ düğmesine tıklayın. Başarılı eşleşmeler Sarı olarak vurgulanacaktır.

The search works by using a Python regular expression. All matched text is simply removed from the document or replaced using the replacement pattern. The replacement pattern is optional, if left blank then text matching the search pattern will be deleted from the document. You can learn more about regular expressions and their syntax at Calibre’de kurallı ifadelerin kullanımına dair her şey.

Structure detection

Yapı algılama, yapılar tanımlanmadığında calibre’nin girdi belgesinde yapısal elemanları algılamak için elinden geleni yapması işini içerir. Örneğin bölümler, sayfa sonları, başlıklar, altbilgi, vs. Tahmin edeceğiniz gibi, bu işlem kitaptan kitaba farklılık gösterir. Neyse ki calibre bunu kontrol etmek için çok güçlü seçeneklere sahiptir. Bu güçle beraber karmaşıklık gelir, ama bu karmaşıklığı öğrenmek için biraz zaman ayırırsanız, çabanıza deydiğini göreceksiniz.

Bölümler ve sayfa sonları

calibre’nin bölüm algılama ve sayfa sonu ekleme için iki set seçeneği vardır. Bazen biraz kafa karıştırıcı olsa da, calibre varsayılan olarak, algılanan bölümlerden önce olduğu gibi sayfa sonları seçeneği ile algılanan yerlerden önce de sayfa sonu ekler. Bunun sebebi yaygın olarak bölüm sınırlarında olmadığı halde sayfa sonu eklenmesi gereken yerlerin bulunmasıdır. Ayrıca, algılanan bölümler isteğe bağlı olarak otomatik üretilen İçindekilere eklenebilir.

calibre uses XPath, a powerful language to allow the user to specify chapter boundaries/page breaks. XPath can seem a little daunting to use at first, fortunately, there is a XPath tutorial in the User Manual. Remember that Structure detection operates on the intermediate XHTML produced by the conversion pipeline. Use the debug option described in the Giriş to figure out the appropriate settings for your book. There is also a button for a XPath wizard to help with the generation of simple XPath expressions.

Ön tanımlı olarak, calibre bölüm algılama için şu ifadeyi kullanır:

//*[((name()='h1' or name()='h2') and re:test(., 'chapter|book|section|part\s+', 'i')) or @class = 'chapter']

Bu ifade nispeten karmaşık, çünkü bir takım yaygın durumları aynı anda işlemeye çalışıyor. Anlamı ise calibre’nin bölümlerin başını ya içinde (chapter, book, section veya part) kelimelerinden herhangi birini veya class=”chapter” özniteliğini içeren <h1> veya <h2> etiketleri olarak varsayacağıdır.

İlgili bir seçenek de Chapter işareti, calibre’nin bir bölüm algıladığında ne yapacağını kontrol etmenizi sağlayan seçeneği. Ön tanımlı olarak, bölümden önce bir satır sonu ekleyecektir. Bunun yerine veya satır sonundan sonra kurallı bir satır ekleyebilir. Başka bir şey de yaptıramazsınız.

Sayfa sonlarını algılamak için ön tanımlı ayar:

//*[name()='h1' or name()='h2']

bu da calibre’nin ön tanımlı olarak her <h1> ve <h2> etiketinden önce sayfa sonu ekleyeceği demek oluyor.

Not

Varsayılan ifadeler dönüştürdüğünüz girdi biçimine göre değişebilir.

Muhtelif

Bu bölümde bir kaç seçenek daha var.

Metadata’yı kitabın başına bir sayfa olarak ekle
One of the great things about calibre is that it allows you to maintain very complete metadata about all of your books, for example, a rating, tags, comments, etc. This option will create a single page with all this metadata and insert it into the converted e-book, typically just after the cover. Think of it as a way to create your own customised book jacket.
İlk resmi kaldır
Bazen, dönüştürdüğünüz kaynak belge kapağı ayrı bir kapak olarak değil, kitabın bir parçası olarak bulundurur. Calibre’de ayrıca bir kapak belirtirseniz, dönüştürülen kitabın iki kapak sayfası olur. Bu seçenek basitçe belgedeki ilk resmi kaldırır, dönüştürülen kitabın tek bir kapağı, calibre tarafından belirtilen kapağı olmasını sağlar.

İçindekiler

When the input document has a Table of Contents in its metadata, calibre will just use that. However, a number of older formats either do not support a metadata based Table of Contents, or individual documents do not have one. In these cases, the options in this section can help you automatically generate a Table of Contents in the converted e-book, based on the actual content in the input document.

Not

Using these options can be a little challenging to get exactly right. If you prefer creating/editing the Table of Contents by hand, convert to the EPUB or AZW3 formats and select the checkbox at the bottom of the Table of Contents section of the conversion dialog that says Manually fine-tune the Table of Contents after conversion. This will launch the ToC Editor tool after the conversion. It allows you to create entries in the Table of Contents by simply clicking the place in the book where you want the entry to point. You can also use the ToC Editor by itself, without doing a conversion. Go to Preferences → Interface → Toolbars and add the ToC Editor to the main toolbar. Then just select the book you want to edit and click the ToC Editor button.

İlk seçenek Otomatik oluşturulmuş İçindekileri kullanmaya zorla. Bunu işaretleyerek calibre’nin girdi belgesinde bulunan herhangi bir İçindekiler bölümü yerine otomatik üretileni kullanmaya zorlamasını sağlayabilirsiniz.

Otomatik üretilen İçindekiler bölümünün çalışma şekli, calibre’nin algılanan tüm bölümleri üretilen içindekiler bölümüne eklemeye çalışması iledir. Bölüm algılamayı nasıl özelleştirebileceğinizi yukarıdaki Structure detection kısmı ile öğrenebilirsiniz. Algılanan bölümlerin üretilen içindekiler bölümünde yer almasını istemiyorsanız, Algılanan bölümleri ekleme seçeneğini işaretleyin.

Eğer Bölüm eşiği sayısından az sayıda bölüm algılanırsa, calibre girdi belgesinde bulduğu köprüleri İçindekilere ekler. Bu genellikle düzgün çalışır bir çok girdi belgesi başında köprülenmiş bir İçindekiler içerir. Bağlantı sayısı seçeneği bu davranışı kontrol etmek için kullanılabilir. Sıfıra ayarlanırsa, hiçbir bağlantı eklenmez. Sıfırdan büyük bir rakam ayarlanırsa, en fazla o kadar bağlantı eklenir.

calibre otomatik olarak kopya girdileri İçindekiler bölümünden çıkarır. Fakat istenmeyen başka girdiler de varsa, TOC Filtresi seçeneği ile filtreleyebilirsiniz. Bu, üretilen içindekilerdeki girdi başlıklarıyla eşleşecek bir düzenli ifadedir. Bulunan her eşleşme kaldırılacaktır. Örneğin, tüm “Sonraki” veya “Önceki” girdi başlıklarını kaldırmak için şunu kullanabilirsiniz:

Next|Previous

Seviye 1,2,3 TOC`seçenekleri gelişmiş çok seviyeli bir İçindekiler oluşturmanıza izin verir. Bunlar dönüştürme hattınca üretilen ara XHTML’de eşleşen XPath ifadeleridir. Bu XHTML’ye nasıl erişeceğinizi öğrenmek için :ref:`conversion-introduction a göz atın. Her seçeneğin yanında temel XPath ifadeleri oluşturmanıza yardım edecek bir sihirbaz açan düğmeler bulunur. Şu basit örnek bu seçenekleri nasıl kullanacağınızı gösterir.

Aşağıdakine benzer bir XHTML üreten bir girdi belgeniz olduğunu farz edin:

<html xmlns="http://www.w3.org/1999/xhtml">
    <head>
        <title>Sample document</title>
    </head>
    <body>
        <h1>Chapter 1</h1>
        ...
        <h2>Section 1.1</h2>
        ...
        <h2>Section 1.2</h2>
        ...
        <h1>Chapter 2</h1>
        ...
        <h2>Section 2.1</h2>
        ...
    </body>
</html>

Seçenekleri şu şekilde ayarlıyoruz:

Level 1 TOC : //h:h1
Level 2 TOC : //h:h2

Bu işlem aşağıdaki gibi görünen, otomatik üretilmiş iki seviyeli bir İçindekilere sebep olur:

Chapter 1
    Section 1.1
    Section 1.2
Chapter 2
    Section 2.1

Uyarı

Not all output formats support a multi level Table of Contents. You should first try with EPUB output. If that works, then try your format of choice.

HTML girdi belgelerini dönüştürürken resimler bölüm başlığı olarak kullanılıyor

Bir resmi bölüm başlığı olarak kullanmak istediğinizi var sayalım, ama yine de calibre’nin İçindekileri bölüm başlıklarından sizin için otomatik üretmesini istiyorsunuz. Bunu elde etmek için aşağıdaki HTML biçimlemesini kullanın

<html>
    <body>
        <h2>Chapter 1</h2>
        <p>chapter 1 text...</p>
        <h2 title="Chapter 2"><img src="chapter2.jpg" /></h2>
        <p>chapter 2 text...</p>
    </body>
</html>

Seviye 1 TOC ayarını //h:h2 yapın. İkinci bölüm için, calibre başlığı etiketin metni olmadığından <h2> etiketindeki title özniteliğinden alır.

İçindekiler bölümündeki girdilere metin temin etmek için etiket öznitelikleri kullanılıyor

Kısmen uzun bölüm başlıklarınız varsa ve İçindekiler bölümünde kısaltılmış hallerini istiyorsanız, bu iş için başlık özniteliğini kullanabilirsiniz, örneğin:

<html>
    <body>
        <h2 title="Chapter 1">Chapter 1: Some very long title</h2>
        <p>chapter 1 text...</p>
        <h2 title="Chapter 2">Chapter 2: Some other very long title</h2>
        <p>chapter 2 text...</p>
    </body>
</html>

Seviye 1 TOC ayarını //h:h2/@title yapın. calibre etiket içindeki metni kullanmak yerine, başlığı <h2> etiketlerindeki title değerinden alacaktır. XPath ifadesinde sondaki /@title a dikkat edin, bu biçimi kullanarak calibre’ye metni istediğiniz öznitelikten almasını söyleyebilirsiniz.

Dönüştürme için seçeneklerin nasıl ayarlanıp/kaydedileceği

Calibre’de dönüştürme işlemlerinin ayarlanabileceği iki yer vardır. Birincisi Seçenekler->Dönüştürme. Bu seçenekler dönüştürme için varsayılan ayarlardır. Her kitap dönüştürmek istediğinizde, ön tanımlı olarak burada bulunan ayarlar kullanılır.

You can also change settings in the conversion dialog for each book conversion. When you convert a book, calibre remembers the settings you used for that book, so that if you convert it again, the saved settings for the individual book will take precedence over the defaults set in Preferences. You can restore the individual settings to defaults by using the Restore defaults button in the individual book conversion dialog. You can remove the saved settings for a group of books by selecting all the books and then clicking the Edit metadata button to bring up the bulk metadata edit dialog, near the bottom of the dialog is an option to remove stored conversion settings.

Bir grup kitabı Toplu Dönüştürdüğünüzde, ayarlar aşağıdaki sırayla alınır (son gelen kazanır):

  • Seçenekler->Dönüştürme menüsünde ayarlanan varsayılanlardan
  • Dönüştürülen her kitaptaki (eğer varsa) kayıtlı dönüştürme ayarlarından. Bu ayar Toplu Dönüştürme iletişim penceresinin sol üstündeki seçenekle kapatılabilir.
  • Toplu dönüştürme iletişim penceresindeki ayarlardan

Toplu Dönüştürmedeki her kitap için son ayarlar kaydedilir ve kitap tekrar dönüştürülürse tekrar kullanılır. Toplu Dönüştürmede en yüksek öncelik Toplu Dönüştürme iletişim penceresindeki ayarlara verildiğinden, bu ayarlar kitaba özel olanları ezer. Yani yalnızca benzer ayarlara ihtiyacı olan kitapları topluca dönüştürmelisiniz. Metadata ve girdi biçimine özel ayarlar istisnadır. Toplu Dönüştürme iletişim penceresi bu iki kategoride ayarları içermediğinden, bu ayarlar kitaba özel ayarlardan (eğer varsa) veya varsayılanlardan alınır.

Not

Herhangi bir dönüştürmede kullanılan ayarları görmek için aşağı sağ köşedeki dönen simgeye tıklayıp dönüştürme işine çift tıklayabilirsiniz. Bu işlem kullanılan ayarları üst kısma yakın bir yerde gösteren dönüştürme kaydını getirecektir.

Biçime özel ipuçları

Here you will find tips specific to the conversion of particular formats. Options specific to particular format, whether input or output are available in the conversion dialog under their own section, for example TXT input or EPUB output.

Microsoft Word belgelerini dönüştür

calibre Microsoft Word 2007 ve üzeri tarafından oluşturulan .docx dosyalarını otomatik dönüştürebilir. Dosyayı calibre’ye ekleyin ve dönüştüre tıklayın (.docx dosyaları için destek çok yeni olduğundan calibre’nin son sürümünü çalıştırdığınızdan emin olun).

Not

Calibre dönüştürme motorunun yeteneklerini gösteren bir .docx tanıtım dosyası mevcuttur. Calibre’nin yeteneklerini görmek için bu dosyayı indirin ve EPUB veya AZW3 biçimine dönüştürün.

calibre will automatically generate a Table of Contents based on headings if you mark your headings with the Heading 1, Heading 2, etc. styles in Microsoft Word. Open the output e-book in the calibre E-book viewer and click the Table of Contents button to view the generated Table of Contents.

Eski .doc dosyaları

Eski .doc dosyalarıyla çalışırken belgeyi Microsoft Word ile HTML olarak kaydedebilir, sonra bu HTML dosyasını calibre ile dönüştürebilirsiniz. HTML olarak kaydederken “Web Sayfası olarak kaydet, Filtrelenmiş” seçeneğini kullanmayı unutmayın, bu seçenek iyi dönüşebilen temiz HTML üretir. Word gerçekten karman çorman HTML üretir, dönüştürme uzun sürebileceğinden sabırlı olun. Word’un yeni bir sürümüne sahipseniz, doğrudan docx olarak kaydedebilirsiniz.

Bir diğer seçenek de açık kaynaklı ve ücretsiz OpenOffice kullanmak. .doc dosyasınız OpenOffice ile açın ve OpenOffice’in .odt biçiminde kaydedin. calibre .odt dosyalarını doğrudan dönüştürebilir.

TXT belgelerini dönüştür

TXT belgelerinin kalın, yatık yazı vs. gibi iyi tanımlanmış biçimleme şekilleri ya da paragraflar, başlıklar, kısımlar gibi belge yapıları yoktur, ama çoğunlukça kullanılan bir takım genellemeler kullanılmaktadır. Varsayılan olarak calibre doğru biçimleme ve işaretlemeleri bu genellemelere bakarak otomatik yapmaya çalışır.

TXT girdisi paragrafların nasıl algılanacağı ayrımına varmak için bir takım seçeneği destekler.

Paragraph style: Auto
Paragrafların nasıl tanımlandığını otomatik olarak anlamak için metin dosyalarını analiz eder. Bu seçeneke çoğunlukla iyi çalışır, beklenmedik sonuçlarla karşılaşırsanız elle ayarlanan seçeneklerden birini deneyin.
Paragraph style: Block

Bir ya da fazla boş satırın paragraf sınırı olduğunu varsayar:

This is the first.

This is the
second paragraph.
Paragraph style: Single

Her satırın bir paragraf olduğunu varsayar:

This is the first.
This is the second.
This is the third.
Paragraph style: Print

Her paragrafın bir girintiyle başladığını varsayar (bir tab veya 2+ boşluk). Paragraflar sonraki satır girintiyle başladığında sona erer:

  This is the
first.
  This is the second.

  This is the
third.
Paragraph style: Unformatted
Belgenin bir biçimi olmadığı, ama alt satır sonu kullandığı varsayılır. Noktalama işaretleri ve ortalama satır uzunluğu kullanılarak paragraflar tekrar oluşturulmaya çalışılır.
Formatting style: Auto
Kullanılan biçimlendirme işaretçileri türü algılanmaya çalışılır. İşaretçi kullanılmamışsa sezgisel biçimleme uygulanır.
Formatting style: Heuristic
Analyzes the document for common chapter headings, scene breaks, and italicized words and applies the appropriate HTML markup during conversion.
Formatting style: Markdown
calibre also supports running TXT input though a transformation preprocessor known as Markdown. Markdown allows for basic formatting to be added to TXT documents, such as bold, italics, section headings, tables, lists, a Table of Contents, etc. Marking chapter headings with a leading # and setting the chapter XPath detection expression to “//h:h1” is the easiest way to have a proper table of contents generated from a TXT document. You can learn more about the Markdown syntax at daringfireball.
Formatting style: None
Applies no special formatting to the text, the document is converted to HTML with no other changes.

PDF belgelerini dönüştür

PDF belgesi dönüştürülebilecek en kötü biçimlerden birisidir. Sabit sayfa boyutlu ve sabit yerleştirilmiş metin biçimlidirler. Bunun anlamı, bir paragrafın nerede bitip nerede başladığını anlamanın çok zor olduğudur. calibre paragrafları yapılandırılabilir bir Satır Kaydırmama Etmeni ile kaydırmamaya çalışacaktır. Bu, bir satırın kaydırılmaması gereken satır uzunluğunun belirlenmesinde kullanılan bir ölçüdür. Geçerli değerler 0 ve 1 arasında bir ondalık sayıdır. Varsayılanı 0.45’dir, ortalama satır uzunluğunun biraz altı. Kaydırılmayan daha çok metin için bu değeri küçültün. Daha az içermesi için de artırın. Bu değeri PDF Girdisi altındaki dönüştürme ayarlarından ayarlayabilirsiniz.

Ayrıca, genellikle belgenin bir parçası olarak metin içeriğine eklenecek başlık ve altbilgileri vardır. Bu sorunu azaltmak için Ara ve Değiştir panelini kullanarak başlık ve altbilgileri kaldırın. Başlık ve altbilgi metinden çıkarılmazsa, paragraf kaydırmamayı bir kenara atabilir. Başlık ve altbilgi kaldırma seçeneklerinin nasıl kullanılacağını öğrenmek için Calibre’de kurallı ifadelerin kullanımına dair her şey okuyun.

PDF girdisinin bazı kısıtlamaları:

  • Karmaşık, çok-sütunlu, ve resim temelli belgeler desteklenmez.
  • Belgeden vektör resim ve tablo çıkarma işlemi de desteklenmez.
  • Bazı PDF’ler ll veya ff veya fi vs. temsil etmek için özel kabartmalar kullanırlar. Bunların dönüştürülmesinin çalışıp çalışmayacağı PDF içinde nasıl temsil edildiklerine bağlıdır.
  • Bağlantılar ve İçindekiler desteklenmiyor
  • İngilizce dışındaki karakterleri temsil için gömülü olarak evrensel kod dışında yazı tipi içeren PDF’ler bu karakterler için bozuk çıktı alacaklardır
  • Bazı PDF’ler arkasında OCRed metin bulunan o sayfanın fotoğrafından yapılmışlardır. Böyle durumlarda calibre PDF’i görüntülediğinizde göreceğinizden çok farklı sonuç verecek olan OCRed metni kullanır
  • Sağdan sola yazılan diller ve matematik karakter dizisi gibi karmaşık metin görüntülemek için kullanılan PDF’ler düzgün dönüştürülmeyecektir

Tekrar üstünden geçelim PDF gerçekten, ama gerçekten kötü bir girdi formatıdır. İlla PDF kullanmanız gerekiyorsa, girdi PDF’ine bağlı olarak idare eder ile kullanılamaz arasında bir çıktı için hazırlıklı olun.

Comic book collections

A comic book collection is a .cbc file. A .cbc file is a ZIP file that contains other CBZ/CBR files. In addition the .cbc file must contain a simple text file called comics.txt, encoded in UTF-8. The comics.txt file must contain a list of the comics files inside the .cbc file, in the form filename:title, as shown below:

one.cbz:Chapter One
two.cbz:Chapter Two
three.cbz:Chapter Three

Böylece .cbc dosyası şunu içerecektir:

comics.txt
one.cbz
two.cbz
three.cbz

calibre will automatically convert this .cbc file into a e-book with a Table of Contents pointing to each entry in comics.txt.

EPUB gelişmiş biçimleme tanıtımı

Various advanced formatting for EPUB files is demonstrated in this demo file. The file was created from hand coded HTML using calibre and is meant to be used as a template for your own EPUB creation efforts.

The source HTML it was created from is available demo.zip. The settings used to create the EPUB from the ZIP file are:

ebook-convert demo.zip .epub -vv --authors "Kovid Goyal" --language en --level1-toc '//*[@class="title"]' --disable-font-rescaling --page-breaks-before / --no-default-epub-cover

Bu dosya EPUB’ın potansiyelini araştırdığından, calibre’nin yerleşik okuyucusu dışındaki bir çok okuyucuda burdaki gelişmiş biçimlemeler çalışmayacaktır.

ODT belgelerini dönüştür

calibre ODT (OpenDocument Metni) dosyalarını doğrudan dönüştürebilir. Belgenizi biçimlendirmek için biçemler kullanmalı ve doğrudan biçimleme kullanmaktan kaçınmalısınız. Belgenize resim eklerken, resimleri paragrafa bağlamalısınız, bir sayfaya bağlanmış resimlerin hepsi dönüştürmenin başında yer alacaktır.

Bölümleri otomatik algılamak için, onları yerleşik biçim ‘Heading 1’, ‘Heading 2’, …, ‘Heading 6’ (‘Heading 1’ HTML etiketi <h1> e denktir, ‘Heading 2’ <h2> ye vs.) ile işaretlemelisiniz. Dönüştürme yaparken calibre’de kullandığınız biçimi ‘Bölümleri algıla’ kutusunda girebilirsiniz. Örneğin:

  • Bölümleri ‘Heading 2’ biçimi ile işaretlerseniz, ‘Bölümleri algıla’ kutusunu //h:h2 olarak ayarlamalısınız
  • Kısımların ‘Heading 2’ ile, Bölümlerin ‘Heading 3’ ile işaretlendiği iç içe bir TOC için``//h:h2|//h:h3`` girmelisiniz. TOC - Dönüştürme sayfasında ‘Seviye 1 TOC’ kutusunu //h:h2 ve ‘Seviye 2 TOC’ kutusunu //h:h3 olarak ayarlayın.

İyi bilinen belge özellikleri (Başlık, Anahtar kelimeler, Açıklama, Oluşturan) tanınır ve calibre ilk resmi (çok küçük olmayan, iyi en boy oranına sahip) kapak resmi yapar.

Ayrıca ODT belgenizde Evet olarak ayarladığınızda (Dosya->Özellikler->Özel Özellikler) etkinleşen özel bir özellik olan opf.metadata (‘Evet veya Hayır’ biçimli) gelişmiş özellik dönüştürme kipi bulunmaktadır. Bu özellik calibre tarafından algılanırsa, aşağıdaki özellikler tanınır (opf.authors belgeyi oluşturanı ezer):

opf.titlesort
opf.authors
opf.authorsort
opf.publisher
opf.pubdate
opf.isbn
opf.language
opf.series
opf.seriesindex

Buna ek olarak, ODT’de kapak resmi olmasını istediğiniz resmi opf.cover olarak isimlendirebilirsiniz (sağ tık, Resim->Seçenekler->Ad). Bu isimde bir resim bulunmazsa, ‘zeki’ kipi kullanılır. Bazı çıktı biçimlerinde kapak algılama iki kapakla sonlanabileceğinden, işlem paragrafı belgeden çıkaracaktır (yalnızca tek içerik kapak ise!). Ama bu yalnızca adlandırılan resimle çalışır!

Kapak algılamayı kapatmak için opf.nocover (‘Evet veya Hayır’ türünde) gelişmiş kipte Evet olarak ayarlayabilirsiniz.

PDF’e dönüştürme

The first, most important, setting to decide on when converting to PDF is the page size. By default, calibre uses a page size of “U.S. Letter”. You can change this to another standard page size or a completely custom size in the PDF Output section of the conversion dialog. If you are generating a PDF to be used on a specific device, you can turn on the option to use the page size from the output profile instead. So if your output profile is set to Kindle, calibre will create a PDF with page size suitable for viewing on the small kindle screen.

Başlıklar ve Altbilgiler

Başlık ve altbilgi şablonları belirleyerek PDF’in her sayfasına keyfi başlık ve alt bilgi ekleyebilirsiniz. Şablonlar başlık ve altbilgi alanlarında gerçeklenen HTML kodlarından başka bir şey değildir. Örneğin her sayfanın altında ortalanmış olarak sayfa numaraları göstermek için, aşağıdaki altbilgi şablonunu kullanın:

<p style="text-align:center; color:green">Page _PAGENUM_</p>

calibre _PAGENUM_ u otomatik olarak mevcut sayfa numarasıyla değiştirir. Hatta tek ve çift sayfalar için değişik içerik bile koyabilirsiniz, örneğin aşağıdaki başlık şablonu tek sayfalarda başlığı, çift sayfalarda yazarı gösterir:

<p style="text-align:right"><span class="even_page">_AUTHOR_</span><span class="odd_page"><i>_TITLE_</i></span></p>

calibre _TITLE_ ve _AUTHOR_ kelimelerini otomatik olarak dönüştürülen belgenin başlığı ve yazarı ile değiştirir. Aynı zamanda aşağıdaki başlık şablonunda gösterildiği gibi metni sol ve sağ köşelerde gösterebilir, yazı tipi boyutunu değiştirebilirsiniz:

<div style="font-size:x-small"><p style="float:left">_TITLE_</p><p style="float:right;"><i>_AUTHOR_</i></p></div>

Bu başlığı solda, yazarı sağda ana metinden küçük bir boyutta gösterir.

Mevcut kısmı da şablonlarda aşağıda gösterildiği gibi kullanabilirsiniz:

<p style="text-align:right">_SECTION_</p>

_SECTION_ mevcut kısmın adı neyse onunla değiştirilir. Bu isimler belgenin İçindekiler metadatasından alınır (PDF Özeti). Belgenin İçindekileri yoksa boş metinle değiştirilir. Tek bir PDF sayfasının birden çok bölümü varsa, sayfadaki ilk bölüm kullanılacaktır. Benzer bir şekilde, _TOP_LEVEL_SECTION_ adında, mevcut en üst bölümün adını almak için kullanılabilen bir değişken vardır.

Başlık ve altbilgi içinde javascript bile kullanabilirsiniz, örneğin, aşağıdaki şablon sayfa numaralarının 1 yerine 4 den başlamasını sağlar:

<p id="pagenum" style="text-align:center;"></p><script>document.getElementById("pagenum").innerHTML = "" + (_PAGENUM_ + 3)</script>

Not

When adding headers and footers make sure you set the page top and bottom margins to large enough values, under the Page setup section of the conversion dialog.

Yazdırılabilir İçindekiler

Ayrıca PDF sonuna her kısmın sayfa numaralarını içeren y azdırılabilir bir İçindekiler ekleyebilirsiniz. PDF’i sayfaya yazdırmaya niyetiniz varsa çok faydalıdır. PDF’i elektronik cihazda kullanacaksanız, PDF Özeti bu işlevselliği sağlar ve ön tanımlı olarak üretilir.

You can customize the look of the generated Table of contents by using the Extra CSS conversion setting under the Look & feel part of the conversion dialog. The default css used is listed below, simply copy it and make whatever changes you like.

.calibre-pdf-toc table { width: 100%% }

.calibre-pdf-toc table tr td:last-of-type { text-align: right }

.calibre-pdf-toc .level-0 {
    font-size: larger;
}

.calibre-pdf-toc .level-1 td:first-of-type { padding-left: 1.4em }
.calibre-pdf-toc .level-2 td:first-of-type { padding-left: 2.8em }