API documentation for the e-book editing tools¶
The e-book editing tools consist of a
calibre.ebooks.oeb.polish.container.Container
object that represents a
book as a collection of HTML + resource files, and various tools that can be
used to perform operations on the container. All the tools are in the form of
module level functions in the various calibre.ebooks.oeb.polish.*
modules.
Bir kitap için sahip olduğunuz bir kapsayıcı nesnenin yolu bunun gibidir:
from calibre.ebooks.oeb.polish.container import get_container
container = get_container('Path to book file', tweak_mode=True)
If you are writing a plugin for the E-book editor, you get the current container for the book being edited like this:
from calibre.gui2.tweak_book import current_container
container = current_container()
if container is None:
report_error # No book has been opened yet
Kapsayıcı nesne¶
- class calibre.ebooks.oeb.polish.container.Container(rootpath, opfpath, log, clone_data=None)[kaynak]¶
A container represents an open e-book as a folder full of files and an OPF file. There are two important concepts:
The root folder. This is the base of the e-book. All the e-books files are inside this folder or in its sub-folders.
Names: These are paths to the books’ files relative to the root folder. They always contain POSIX separators and are unquoted. They can be thought of as canonical identifiers for files in the book. Most methods on the container object work with names. Names are always in the NFC Unicode normal form.
Clones: the container object supports efficient on-disk cloning, which is used to implement checkpoints in the e-book editor. In order to make this work, you should never access files on the filesystem directly. Instead, use
raw_data()
oropen()
to read/write to component files in the book.
Href ve isimler arasında dönüştürme yaparken bu sınıf tarafından sağlanan yöntemleri kullanın, bunlar tüm href’lerin tırnağa alındığını varsayar.
- abspath_to_name(fullpath, root=None)[kaynak]¶
Bir mutlak yolu :attr:`root`a göre kurallanan bir isme dönüştür
- Parametreler:
root – The base folder. By default the root for this container object is used.
- add_file(name, data, media_type=None, spine_index=None, modify_name_if_needed=False, process_manifest_item=None)[kaynak]¶
Bu kapsayıcıya bir dosya ekle. Dosya için girdiler otomatik olarak OPF manifestosu ve omurgaya eklenir (dosya bir metin belgeyse)
- add_name_to_manifest(name, process_manifest_item=None)[kaynak]¶
Manifestoya belirtilen isme sahip bir dosya için girdi ekle. Manifesto kimliğini döndürür.
- add_properties(name, *properties)[kaynak]¶
Add the specified properties to the manifest item identified by name.
- apply_unique_properties(name, *properties)[kaynak]¶
Ensure that the specified properties are set on only the manifest item identified by name. You can pass None as the name to remove the property from all items.
- book_type = 'oeb'¶
Kitabın türü (EPUB dosyalar için epub ve AZW3 dosyalar için azw3)
- commit(outpath=None, keep_parsed=False)[kaynak]¶
Commit all dirtied parsed objects to the filesystem and write out the e-book file at outpath.
- Parametreler:
output – The path to write the saved e-book file to. If None, the path of the original book file is used.
keep_parsed – If True the parsed representations of committed items are kept in the cache.
- commit_item(name, keep_parsed=False)[kaynak]¶
Ayrıştırılmış bir nesneyi diske gönder (serileştirilir ve altında yatan dosyaya yazılır). Eğer
keep_parsed
Doğru ise, ayrıştırılmış temsil zulada tutulur. Ayrıca bknz:parsed()
- dirty(name)[kaynak]¶
İsme karşılık gelen ayrıştırılmış nesneyi kirli olarak işaretle. Ayrıca bknz:
parsed()
.
- exists(name)[kaynak]¶
True iff a file/folder corresponding to the canonical name exists. Note that this function suffers from the limitations of the underlying OS filesystem, in particular case (in)sensitivity. So on a case insensitive filesystem this will return True even if the case of name is different from the case of the underlying filesystem file. See also
has_name()
- filesize(name)[kaynak]¶
Belirtilen kuralsal isimle temsil edilen dosyanın boyutunu bayt cinsinden döndür. Kirli ayrıştırılmış nesneleri otomatik olarak halleder. Ayrıca bknz:
parsed()
- generate_item(name, id_prefix=None, media_type=None, unique_href=True)[kaynak]¶
Bir öğeyi manifestoya, verilen isimden türetilen href ile ekle. Href ve kimliğin benzersiz olduğunu otomatik olarak garantiler. Üretilen öğeyi döndürür.
- get_file_path_for_processing(name, allow_modification=True)[kaynak]¶
Similar to open() except that it returns a file path, instead of an open file object.
- property guide_type_map¶
Kılavuz türden kuralsal isme harita
- has_name(name)[kaynak]¶
Belirtilen ile aynı kuralsal isme sahip bir dosya mevcutsa Doğru döndür. :meth:`exists`in aksine, bu yöntem her zaman büyük küçük harf duyarlıdır.
- href_to_name(href, base=None)[kaynak]¶
Bir href’i (tabana göre) isme dönüştür. taban bir isim veya None olmalıdır, ki bu durumda self.root kullanılır.
- insert_into_xml(parent, item, index=None)[kaynak]¶
Öğeyi girintilemeyi düzelterek üst öğeye ekle (ya da indis None ise ekle). Yalnızca kendine kapanan öğeler ile çalışır.
- is_dir = False¶
Eğer kapsayıcı ziplenmemiş kitabı betimliyorsa(bir dizin)
- iterlinks(name, get_line_numbers=True)[kaynak]¶
İsimdeki tüm bağlantılar üzerinde dön. Eğer get_line_numbers Doğru ise (bağlantı, satır_numarası, uzaklık) biçiminde sonuçlar üretir. Burda satır numarası bağlantının bulunduğu satır, uzaklık ise satır başından kaç karakter uzakta olduğudur. Uzaklığın, uzaklık sıfır değilse bir çok satırı kapsayabileceğini unutmayın.
- make_name_unique(name)[kaynak]¶
Ensure that name does not already exist in this book. If it does, return a modified version that does not exist.
- property manifest_id_map¶
Manifesto kimliğinin kuralsal isimlere haritası
- manifest_items_of_type(predicate)[kaynak]¶
The names of all manifest items whose media-type matches predicate. predicate can be a set, a list, a string or a function taking a single argument, which will be called with the media-type.
- manifest_items_with_property(property_name)[kaynak]¶
All manifest items that have the specified property
- property manifest_type_map¶
Manifesto ortam türünün bu ortam türünde kuralsal isimlerin listesine haritası
- property mi¶
Bu kitabın metadata’sının Metadata nesnesi. Bu nesnenin bu özellik her istendiğinde oluşturulduğunu unutmayın, tutumlu kullanın.
- name_to_href(name, base=None)[kaynak]¶
Bir ismi tabana göre yapılmış bir href’e çevir, base bir isim veya None olabilir ki bu durumda self.root kullanılır
- property names_that_must_not_be_changed¶
Set of names that must never be renamed. Depends on the e-book file format.
- property names_that_must_not_be_removed¶
Set of names that must never be deleted from the container. Depends on the e-book file format.
- property names_that_need_not_be_manifested¶
Set of names that are allowed to be missing from the manifest. Depends on the e-book file format.
- open(name, mode='rb')[kaynak]¶
İsmin gösterdiği dosyayı doğrudan okuma/yazma için aç. Bunun dosyayı kirli ise göndereceğini, ve ayrıştırma zulasından sileceğini unutmayın. Ayrıştırılmış sürümüne tekrar erişmeden önce bu dosyayla işinizi bitirmelisiniz, yoksa kötü şeyler olur.
- property opf¶
Ayrıştırılmış OPF dosyası
- opf_get_or_create(name)[kaynak]¶
Belirtilen isme sahip ilk XML öğesini döndüren veya mevcut değilse opf:package öğesi altında oluşturarak döndüren kolaylaştırıcı yöntem.
- property opf_version¶
OPF’nin <package> öğesinde ayarlanmış sürüm
- property opf_version_parsed¶
The version set on the OPF’s <package> element as a tuple of integers
- opf_xpath(expr)[kaynak]¶
XPath ifadesini OPF dosyasında değerlendiren kolaylık sağlayıcı yöntem, opf: ve dc: isim uzayı ön ekleri önceden tanımlanmıştır.
- parsed(name)[kaynak]¶
Return a parsed representation of the file specified by name. For HTML and XML files an lxml tree is returned. For CSS files a css_parser stylesheet is returned. Note that parsed objects are cached for performance. If you make any changes to the parsed object, you must call
dirty()
so that the container knows to update the cache. See alsoreplace()
.
- raw_data(name, decode=True, normalize_to_nfc=True)[kaynak]¶
İsimle belirtilen dosyayla ilişkili ham veriyi döndürür
- Parametreler:
decode – If True and the file has a text based MIME type, decode it and return a unicode object instead of raw bytes.
normalize_to_nfc – True ise döndürülen evrensel kodda nesne EPUB ve AZW3 dosya biçimlerinin gerektirdiği şekilde NFC normal biçimine normelleştirilir.
- relpath(path, base=None)[kaynak]¶
Bir mutlak yolu (işletim sistemi ayraçlarıyla) tabana göre bir yola dönüştür (varsayılan self.root).Göreceli yol bir isim değildir. Bunun için
abspath_to_name()
kullanın.
- remove_from_spine(spine_items, remove_if_no_longer_in_spine=True)[kaynak]¶
Belirtilen öğeleri (kuralsal isme göre) omurgadan çıkar. Eğer
remove_if_no_longer_in_spine
True ise, öğeler kitaptan da silinir, sadece omurgadan değil.
- remove_from_xml(item)[kaynak]¶
Öğeyi üstünden ayırır, girintiyi düzeltir (yalnızca kendi kendine kapanan öğelerde çalışır)
- remove_item(name, remove_from_guide=True)[kaynak]¶
İsimle belirtilen öğeyi bu kapsayıcıdan çıkar. Bu, öğeye tüm başvuruları OPF manifestosundan, kılavuzdan ve omurgadan, ayrıca dahili zulalardan çıkarır.
- rename(current_name, new_name)[kaynak]¶
Renames a file from current_name to new_name. It automatically rebases all links inside the file if the folder the file is in changes. Note however, that links are not updated in the other files that could reference this file. This is for performance, such updates should be done once, in bulk.
- replace(name, obj)[kaynak]¶
Replace the parsed object corresponding to name with obj, which must be a similar object, i.e. an lxml tree for HTML/XML or a css_parser stylesheet for a CSS file.
- replace_links(name, replace_func)[kaynak]¶
İsimdeki tüm bağlantıları replace_func kullanarak, ki bu URL alan ve değiştirilen URL’yi döndüren bir çağrılabilir olmalıdır, değiştir. Ayrıca gerçekten değişiklik yapıldıysa True olarak ayarlanacak bir ‘replace’ özniteliği olmalıdır. Bu gibi çağrılabilirler oluşturmanın uygun yolu
LinkReplacer
veLinkRebaser
sınıflarını kullanmaktır.
- serialize_item(name)[kaynak]¶
Ayrıştırılmış bir nesneyi (kuralsal isimle tanımlanan) bayt karakter dizisine çevir. Bknz
parsed()
.
- set_spine(spine_items)[kaynak]¶
Omurgayı spine_items olacak şekilde ayarla, öyle ki spine_items (isim, doğrusal) biçiminde bir yinelenebilir olsun. İsimlerden biri manifestoda yoksa hata yükseltir.
- property spine_items¶
An iterator yielding the path for every item in the books’ spine. See also:
spine_iter
andspine_items
.
- property spine_iter¶
Kitabın omurgasındaki her öğe için item, name is_linear döndüren bir yinelenebilir. item lxml öğesidir, name kuralsal dosya ismidir ve is_linear öğe doğrusalsa True’dir. Ayrıca bknz:
spine_names
vespine_items
.
- property spine_names¶
name döndüren bir yinelenebilir ve kitap omurgasındaki her öğe için is_linear. Ayrıca bknz:
spine_iter
vespine_items
.
Bir kapsayıcıdaki bileşen dosyalarının yönetimi¶
- calibre.ebooks.oeb.polish.replace.replace_links(container, link_map, frag_map=<function <lambda>>, replace_in_opf=False)[kaynak]¶
Bağlantıları kapsayıcıda dosyalarla değiştir. Kapsayıcıdaki tüm dosyaların üzerinden geçerek içlerinde belirtilen bağlantıları değiştirir.
- Parametreler:
link_map – Eski kuralsal isimden yeni kuralsal isme harita. Örneğin:
{'images/old.png': 'images/new.png'}
frag_map – İki bağımsız değişken
(isim, çapa)
alan ve yeni bir çapa döndüren bir çağrılabilir. HTML dosyalarındaki çapaları değiştirme ihtiyacınız varsa faydalıdır. Öntanımlı olarak, hiçbir şey yapmaz.replace_in_opf – False ise, OPF dosyasında bağlantılar değiştirilmez.
- calibre.ebooks.oeb.polish.replace.rename_files(container, file_map)[kaynak]¶
Kapsayıcı içindeki dosyaları yeniden adlandır, onlara olan tüm bağlantıları da güncelle.
- Parametreler:
file_map – Eski kuralsal isimden yeni kuralsal isme harita, örneğin:
{'text/chapter1.html': 'chapter1.html'}
.
- calibre.ebooks.oeb.polish.replace.get_recommended_folders(container, names)[kaynak]¶
Verilen dosya isimleri için tavsiye edilen dizinleri döndür. Tavsiye aynı türde dosyaların kapsayıcı içinde nerede olduklarını temel alır. Belirli türde hiç dosya yoksa, tavsiye edilen dizin OPF dosyasını içeren dizin olarak varsayılır.
Güzel yazdırma ve ayrıştırma hatalarının otomatik düzeltilmesi¶
- calibre.ebooks.oeb.polish.pretty.fix_html(container, raw)[kaynak]¶
Ham karakter dizisi olarak temsil edilen HTML’deki ayrıştırma hatalarını düzelt. Düzeltme HTML5 ayrıştırma algoritması ile yapılır.
- calibre.ebooks.oeb.polish.pretty.fix_all_html(container)[kaynak]¶
Kapsayıcıdaki tüm HTML dosyalarındaki ayrıştırma hatalarını düzelt. Düzeltme HTML5 ayrıştırma algoritmasıyla yapılır.
- calibre.ebooks.oeb.polish.pretty.pretty_html(container, name, raw)[kaynak]¶
Ham karakter dizisi olarak temsil edilen HTML’yi güzel yazdır
- calibre.ebooks.oeb.polish.pretty.pretty_css(container, name, raw)[kaynak]¶
Ham karakter dizisi olarak temsil edilen CSS’yi güzel yazdır
Kitap ceketlerinin yönetimi¶
Dosyaların ayrılması ve birleştirilmesi¶
- calibre.ebooks.oeb.polish.split.split(container, name, loc_or_xpath, before=True, totals=None)[kaynak]¶
name ile belirtilen dosyayı loc_ veeya _xpath ile belirtilen konumdan ayır. Ayırma otomatik olarak etkilenen dosyalardaki tüm bağlantı ve başvuruları günceller.
- Parametreler:
loc_or_xpath – //h:div[@id=”burayı_ayır”] gibi bir XPath ifadesi olmalıdır. Ayrıca önizleme panelinde dahili olarak ayırmayı uygulayan loc da olabilir.
before – True ise ayırma tanımlanan öğeden önce olur, aksi halde sonra.
totals – Dahili olarak kullanılır
- calibre.ebooks.oeb.polish.split.multisplit(container, name, xpath, before=True)[kaynak]¶
Split the specified file at multiple locations (all tags that match the specified XPath expression). See also:
split()
. Splitting automatically migrates all links and references to the affected files.- Parametreler:
before – True ise ayırma tanımlanan öğeden önce yapılır, aksi halde sonra.
- calibre.ebooks.oeb.polish.split.merge(container, category, names, master)[kaynak]¶
Belirtilen dosyaları tek bir dosya olarak birleştir, etkilenen dosyalardaki tüm bağlantı ve başvuruları otomatik olarak güncelle. Dosyalar ya tamamen HTML ya da CSS olmalıdır.
- Parametreler:
category – Ya HTML dosyalar için
'text'
ya da CSS dosyalar için'styles'
olmalıdır.names – Birleştirilecek dosyaların listesi
master – Birleştirilen dosyalardan hangisinin ana dosya olduğu, yani, birleştirme sonrası kalacak olan dosya.
Kapakların yönetimi¶
- calibre.ebooks.oeb.polish.cover.set_cover(container, cover_path, report=None, options=None)[kaynak]¶
Kitabın kapağını cover_path ile gösterilen resim olarak ayarla.
- Parametreler:
cover_path – Ya bir resim dosyasına mutlak yol ya da kitap içindeki bir resmin kuralsal ismi. Kitaptaki bir resim kullanılırken, ayrıca seçenekleri de belirtmelisiniz, aşağıya göz atın.
report – Tek bir bağımsız değişken alan isteğe bağlı çağrılabilir. İşlenen görevlerle ilgili bilgi ile çağrılacaktır.
options – None veya kapağın nasıl ayarlandığını kontrol eden bir sözlük. Sözlüğün girdileri olabilir:keep_aspect: True veya False (EPUB kapaklarının en-boy oranlarını korur) no_svg: True veeya False (EPUB başlık sayfasında bir SVG kapak sargısı kullanır) existing: True veya False (
cover_path
kitaptaki mevcut bir resmi gösterir)
CSS ile Çalışmak¶
- calibre.ebooks.oeb.polish.fonts.change_font(container, old_name, new_name=None)[kaynak]¶
Bir yazı tipi ailesini old_name’den new_name’ye değiştir. Yazı tipinin biçim sayfaları, biçim etiketleri ve biçim özniteliklerinde tamamen değişmesini sağlar. old_name gömülü bir yazı tipini gösteriyorsa, kaldırılır. Yazı tipi ailesini değiştirmek yerine kaldırmak için new_name’yi None olarak ayarlayabilirsiniz.
- calibre.ebooks.oeb.polish.css.remove_unused_css(container, report=None, remove_unused_classes=False, merge_rules=False, merge_rules_with_identical_properties=False, remove_unreferenced_sheets=False)[kaynak]¶
Kullanılmayan tüm CSS kurallarını kitaptan çıkar. Kullanılmayan bir CSS kuralı herhangi bir içerikle eşleşmeyen kuraldır.
- Parametreler:
report – Tek bir bağımsız değişken alan isteğe bağlı çağrılabilir. Gerçekleştirilen işlemler hakkındaki bilgi ile çağrılır.
remove_unused_classes – True ise, HTML’deki herhangi bir CSS kuralıyla eşleşmeyen sınıf öznitelikleri de kaldırılır.
merge_rules – If True, rules with identical selectors are merged.
merge_rules_with_identical_properties – If True, rules with identical properties are merged.
remove_unreferenced_sheets – If True, stylesheets that are not referenced by any content are removed
- calibre.ebooks.oeb.polish.css.filter_css(container, properties, names=())[kaynak]¶
Belirtilen CSS özelliklerini kitaptaki tüm CSS kurallarından çıkar.
- Parametreler:
properties – Kaldırılacak özellikler kümesi. Örneğin:
{'font-family', 'color'}
.names – Özelliklerin çıkarılacağı dosyalar. Öntanımlı olarak kitaptaki tüm HTML ve CSS dosyalardır.
İçindekiler ile Çalışmak¶
- calibre.ebooks.oeb.polish.toc.from_xpaths(container, xpaths, prefer_title=False)[kaynak]¶
Generate a Table of Contents from a list of XPath expressions. Each expression in the list corresponds to a level of the generate ToC. For example:
['//h:h1', '//h:h2', '//h:h3']
will generate a three level Table of Contents from the<h1>
,<h2>
and<h3>
tags.
- calibre.ebooks.oeb.polish.toc.from_links(container)[kaynak]¶
Kitaptaki bağlantılardan bir İçindekiler üret.
Kitap düzenleme aracı¶
- class calibre.gui2.tweak_book.plugin.Tool[kaynak]¶
Bases:
object
Bir Kitap Düzenle eklentisindeki araçlar için taban sınıf. Kullanışlı üyelerden bazıları:
self.plugin
: bu aracı ait olduğucalibre.customize.Plugin
nesnesine başvuru.self.
boss
self.
gui
Alt sınıflarda ezilmesi gereken metodlar:
- name = None¶
Bunu benzersiz bir isim olarak ayarlayın anahtar olarak kullanılacaktır
- allowed_in_toolbar = True¶
True ise kullanıcı bu aracı eklenti araç çubuğuna koymayı seçebilir
True ise kullanıcı bu aracı eklenti menüsüne koymayı seçebilir
- toolbar_button_popup_mode = 'delayed'¶
Menü (eğer varsa) için açılır pencere kipi. Muhtemel değerler ‘delayed’, ‘instant’, ‘button’
- property boss¶
calibre.gui2.tweak_book.boss.Boss
nesnesi. Kullanıcı arayüzünü kontrol etmek için kullanılır.
- property gui¶
Kullanıcı arayüzünün ana penceresi
- property current_container¶
Düzenlenen kitabı temsil eden
calibre.ebooks.oeb.polish.container.Container
nesnesini döndür.
- register_shortcut(qaction, unique_name, default_keys=(), short_text=None, description=None, **extra_data)[kaynak]¶
Register a keyboard shortcut that will trigger the specified
qaction
. This keyboard shortcut will become automatically customizable by the user in the Keyboard shortcuts section of the editor preferences.- Parametreler:
qaction – Bir QAction nesnesi, kullanıcı tarafından ayarlanmış tuş kombinasyonuna basıldığında tetiklenecektir.
unique_name – Bu kısayol/eylem için benzersiz bir isim. Dahili olarak kullanılacaktır, bu eklentideki diğer eylemlerde kullanılmamalıdır.
default_keys – Öntanımlı klavye kısayollarının listesi. Belirtilmezse öntanımlı kısayol ayarlanmaz. Burada belirtilen kısayollar dahili kısayollarla ya da kullanıcı yapılandırmasıyla/diğer eklentilerle kesişirse, göz ardı edilirler. Bu durumda, kullanıcılar kısayolları elle Tercihler yardımıyla yapılandırmak zorundadırlar. Örneğin:
default_keys=('Ctrl+J', 'F9')
.short_text – Bu eylemin isteğe bağlı kısa bir tanımı. Belirtilmezse QAction’daki metin kullanılır.
description – Bu eylem için isteğe bağlı uzun tanım, bu kısayol için tercihler girdisinde kullanılacaktır.
- create_action(for_toolbar=True)[kaynak]¶
``for_toolbar``a bağlı olarak, ya eklenti araç çubuğuna, ya da eklentiler menüsüne eklenecek olan bir QAction oluştur. Örneğin:
def create_action(self, for_toolbar=True): ac = QAction(get_icons('myicon.png'), 'Do something') if for_toolbar: # We want the toolbar button to have a popup menu menu = QMenu() ac.setMenu(menu) menu.addAction('Do something else') subaction = menu.addAction('And another') # Register a keyboard shortcut for this toolbar action be # careful to do this for only one of the toolbar action or # the menu action, not both. self.register_shortcut(ac, 'some-unique-name', default_keys=('Ctrl+K',)) return ac
Ayrıca bakınız
Metod
register_shortcut()
.
Düzenleyicinin kullanıcı arayüzünün kontrolü¶
The e-book editor’s user interface is controlled by a single global Boss object. This has many useful methods that can be used in plugin code to perform common tasks.
- class calibre.gui2.tweak_book.boss.Boss(parent, notify=None)[kaynak]¶
-
- apply_container_update_to_gui(mark_as_modified=True)[kaynak]¶
Mevcut kitap kapsayıcısındaki son veriyi yansıtması için kullanıcı arayüzünün tüm bileşenlerini güncelle.
- Parametreler:
mark_as_modified – True ise, kitap değiştirildi olarak işaretlenir, böylece kullanıcıya çıkışta kaydetmek isteyip istemediği sorulur.
- commit_all_editors_to_container()[kaynak]¶
Kullanıcının düzenleyicilerde açık dosyalarda yaptığı değişiklikleri kapsayıcılara kaydet. Bu metodu mevcut kapsayıcıda herhangi bir eylem gerçekleştirmeden çağırmalısınız
- property currently_editing¶
Şu an düzenlenen dosya ismini veya herhangi bir dosya düzenlenmiyorsa None döndür
- edit_file(name, syntax=None, use_template=None)[kaynak]¶
name ile belirtilen dosyayı bir düzenleyicide aç
- Parametreler:
syntax – Dosyanın ortam türü, örneğin,
'text/html'
. Belirtilmemişse dosya uzantısından tahmin edilir.use_template – Açılan düzenleyiciyi ilklendirmek için bir şablon
- open_book(path=None, edit_file=None, clear_notify_data=True, open_folder=False, search_text=None)[kaynak]¶
Open the e-book at
path
for editing. Will show an error if the e-book is not in a supported format or the current book has unsaved changes.- Parametreler:
edit_file – Düzenlemeye başlamak için yeni açılmış kitap içindeki bir dosyanın ismi. İsim listesi de olabilir.
- rewind_savepoint()[kaynak]¶
Geriye alma kontrol noktasının önceki oluşumundan vazgeç, bir kontrol noktası yarattınız, ama işlemi değişiklik yapmadan iptal ettiyseniz kullanışlıdır
- show_current_diff(allow_revert=True, to_container=None)[kaynak]¶
Kitabın son kontrol noktasındaki durumuyla farkını göster
- Parametreler:
allow_revert – True ise fark iletişim penceresi kullanıcının tüm değişiklikleri geri almasını sağlayan bir düğme içerir
to_container – Mevcut kapsayıcıyı karşılaştıracak bir kapsayıcı nesnesi. None ise, daha önce kontrol noktasına alınan kapsayıcı kullanılır