மின் புத்தக எடிட்டிங் கருவிகளுக்கான API ஆவணங்கள்

மின்-புத்தக எடிட்டிங் கருவிகள் ஒரு: வகுப்பு: calibre.ebooks.ob.polish.container.container பொருள் HTML + வள கோப்புகளின் தொகுப்பாகவும், செயல்பாடுகளைச் செய்ய பயன்படுத்தக்கூடிய பல்வேறு கருவிகளாகவும் இருக்கும் பொருள் கொள்கலன். அனைத்து கருவிகளும் பல்வேறு `` calibre.ebooks.oeb.polish இல் உள்ள தொகுதி நிலை செயல்பாடுகளின் வடிவத்தில் உள்ளன.*`` தொகுதிகள்.

இது போன்ற ஒரு பாதையில் ஒரு புத்தகத்திற்கு ஒரு கொள்கலன் பொருளைப் பெறுகிறீர்கள்

from calibre.ebooks.oeb.polish.container import get_container
container = get_container('Path to book file', tweak_mode=True)

நீங்கள் மின் புத்தக எடிட்டருக்கு ஒரு சொருகி எழுதுகிறீர்கள் என்றால், புத்தகத்திற்கான தற்போதைய கொள்கலனை இப்படி திருத்தியுள்ளீர்கள்

from calibre.gui2.tweak_book import current_container
container = current_container()
if container is None:
    report_error # No book has been opened yet

கொள்கலன் பொருள்

class calibre.ebooks.oeb.polish.container.Container(rootpath, opfpath, log, clone_data=None)[source]

ஒரு கொள்கலன் ஒரு திறந்த மின் புத்தகத்தை கோப்புகள் நிறைந்த கோப்புறையாகவும், OPF கோப்பாகவும் குறிக்கிறது. இரண்டு முக்கியமான கருத்துக்கள் உள்ளன:

  • ரூட் கோப்புறை. இது மின் புத்தகத்தின் அடிப்படை. அனைத்து மின் புத்தகக் கோப்புகளும் இந்த கோப்புறையில் அல்லது அதன் துணை கோப்புறைகளில் உள்ளன.

  • பெயர்கள்: இவை ரூட் கோப்புறையுடன் தொடர்புடைய புத்தகங்களின் கோப்புகளுக்கான பாதைகள். அவை எப்போதும் POSIX பிரிப்பான்களைக் கொண்டிருக்கின்றன மற்றும் அவை அறியப்படாதவை. புத்தகத்தில் உள்ள கோப்புகளுக்கான நியமன அடையாளங்காட்டிகளாக அவை கருதப்படலாம். கொள்கலன் பொருளின் பெரும்பாலான முறைகள் பெயர்களுடன் வேலை செய்கின்றன. பெயர்கள் எப்போதும் NFC யூனிகோட் இயல்பான வடிவத்தில் இருக்கும்.

  • குளோன்கள்: கொள்கலன் பொருள் திறமையான ஆன் வட்டு குளோனிங்கை ஆதரிக்கிறது, இது மின் புத்தக எடிட்டரில் சோதனைச் சாவடிகளை செயல்படுத்த பயன்படுகிறது. இந்த வேலையைச் செய்ய, நீங்கள் ஒருபோதும் கோப்பு முறைமையில் கோப்புகளை நேரடியாக அணுகக்கூடாது. அதற்கு பதிலாக, பயன்படுத்தவும்: METH: RAW_DATA அல்லது: மெத்:` திறந்திருக்கும்` புத்தகத்தில் உள்ள கூறு கோப்புகளைப் படிக்க/எழுத.

HREF மற்றும் பெயருக்கு இடையில் மாற்றும்போது இந்த வகுப்பு வழங்கிய முறைகளைப் பயன்படுத்துங்கள், அனைத்து HREF களும் மேற்கோள் காட்டப்பட்டுள்ளன என்று அவர்கள் கருதுகிறார்கள்.

abspath_to_name(fullpath, root=None)[source]

ஒரு முழுமையான பாதையை தொடர்புடைய நியமன பெயருக்கு மாற்றவும்: ATTR: ரூட்

அளவுருக்கள்:

root -- அடிப்படை கோப்புறை. இயல்பாகவே இந்த கொள்கலன் பொருளுக்கான வேர் பயன்படுத்தப்படுகிறது.

add_file(name, data, media_type=None, spine_index=None, modify_name_if_needed=False, process_manifest_item=None)[source]

இந்த கொள்கலனில் ஒரு கோப்பைச் சேர்க்கவும். கோப்பிற்கான உள்ளீடுகள் தானாகவே OPF மேனிஃபெஸ்ட் மற்றும் முதுகெலும்பில் உருவாக்கப்படுகின்றன (கோப்பு ஒரு உரை ஆவணம் என்றால்)

add_name_to_manifest(name, process_manifest_item=None)[source]

குறிப்பிட்ட பெயருடன் ஒரு கோப்பிற்கான மேனிஃபெஸ்டில் ஒரு உள்ளீட்டைச் சேர்க்கவும். மேனிஃபெஸ்ட் ஐடியை வழங்குகிறது.

add_properties(name, *properties)[source]

பெயரால் அடையாளம் காணப்பட்ட வெளிப்படையான உருப்படிக்கு குறிப்பிட்ட பண்புகளைச் சேர்க்கவும்.

apply_unique_properties(name, *properties)[source]

பெயரால் அடையாளம் காணப்பட்ட வெளிப்படையான உருப்படியில் மட்டுமே குறிப்பிட்ட பண்புகள் அமைக்கப்பட்டிருப்பதை உறுதிசெய்க. எல்லா பொருட்களிலிருந்தும் சொத்தை அகற்ற நீங்கள் பெயராக எதையும் கடந்து செல்ல முடியாது.

book_type = 'oeb'

புத்தகத்தின் வகை (EPUB கோப்புகளுக்கான EPUB மற்றும் AZW3 கோப்புகளுக்கான AZW3)

commit(outpath=None, keep_parsed=False)[source]

கோப்பு முறைமைக்கு அனைத்து அழிந்த பாகுபடுத்தப்பட்ட பொருட்களையும் செய்து, இ-புத்தகக் கோப்பை அவுட்பாத்தில் எழுதுங்கள்.

அளவுருக்கள்:
  • output -- சேமித்த மின் புத்தக கோப்பை எழுதும் பாதை. எதுவுமில்லை என்றால், அசல் புத்தகக் கோப்பின் பாதை பயன்படுத்தப்படுகிறது.

  • keep_parsed -- உண்மை என்றால், உறுதியான பொருட்களின் பாகுபடுத்தப்பட்ட பிரதிநிதித்துவங்கள் தற்காலிக சேமிப்பில் வைக்கப்படுகின்றன.

commit_item(name, keep_parsed=False)[source]

வட்டுக்கு ஒரு பாகுபடுத்தப்பட்ட பொருளைச் செய்யுங்கள் (இது வரிசைப்படுத்தப்பட்டு அடிப்படை கோப்பில் எழுதப்பட்டுள்ளது). `` Keep_parsed`` உண்மை என்றால், பாகுபடுத்தப்பட்ட பிரதிநிதித்துவம் தற்காலிக சேமிப்பில் தக்கவைக்கப்படுகிறது. மேலும் காண்க :: மெத்: பாகுபடுத்தப்பட்ட

dirty(name)[source]

பெயருடன் தொடர்புடைய பாகுபடுத்தப்பட்ட பொருளை அழுக்கு எனக் குறிக்கவும். மேலும் காண்க :: மெத்: பாகுபடுத்தப்பட்ட.

exists(name)[source]

உண்மையான iff நியமன பெயருடன் தொடர்புடைய ஒரு கோப்பு/கோப்புறை உள்ளது. இந்த செயல்பாடு அடிப்படை OS கோப்பு முறைமையின் வரம்புகளால் பாதிக்கப்படுகிறது என்பதை நினைவில் கொள்க, குறிப்பாக (இல்) உணர்திறன். எனவே ஒரு விஷயத்தில் உணர்ச்சியற்ற கோப்பு முறைமையில், பெயரின் வழக்கு அடிப்படை கோப்பு முறைமை கோப்பின் விஷயத்திலிருந்து வேறுபட்டிருந்தாலும் கூட இது உண்மையாக இருக்கும். மேலும் காண்க: meth: has_name

filesize(name)[source]

குறிப்பிட்ட நியமன பெயரால் குறிப்பிடப்படும் கோப்பின் பைட்டுகளில் அளவைத் தரவும். அழுக்கு பாகுபடுத்தப்பட்ட பொருட்களை தானாகவே கையாளுகிறது. மேலும் காண்க :: மெத்: பாகுபடுத்தப்பட்ட

generate_item(name, id_prefix=None, media_type=None, unique_href=True)[source]

கொடுக்கப்பட்ட பெயரிலிருந்து பெறப்பட்ட HREF உடன் மேனிஃபெஸ்ட்டுக்கு ஒரு உருப்படியைச் சேர்க்கவும். HREF மற்றும் ID இன் தனித்துவத்தை தானாகவே உறுதி செய்கிறது. வருமானம் உருவாக்கப்பட்ட உருப்படி.

get_file_path_for_processing(name, allow_modification=True)[source]

திறந்த () ஒரு திறந்த கோப்பு பொருளுக்கு பதிலாக ஒரு கோப்பு பாதையை வழங்குவதைத் தவிர.

property guide_type_map

வழிகாட்டி வகையின் மேப்பிங் நியமன பெயருக்கு

has_name(name)[source]

குறிப்பிடப்பட்ட அதே நியமன பெயருடன் ஒரு கோப்பை உண்மையாக மாற்றவும். போலல்லாமல்: மெத்: உள்ளது இந்த முறை எப்போதும் வழக்கு உணர்திறன் கொண்டது.

href_to_name(href, base=None)[source]

ஒரு HREF (தளத்துடன் தொடர்புடைய) ஒரு பெயராக மாற்றவும். அடிப்படை ஒரு பெயராக இருக்க வேண்டும் அல்லது எதுவுமில்லை, இந்த விஷயத்தில் SELF.ROOT பயன்படுத்தப்படுகிறது.

insert_into_xml(parent, item, index=None)[source]

உருப்படியை பெற்றோரில் செருகவும் (அல்லது குறியீட்டு எதுவுமில்லை என்றால் சேர்க்கவும்), உள்தள்ளலை சரிசெய்தல். சுய நிறைவு பொருட்களுடன் மட்டுமே வேலை செய்கிறது.

is_dir = False

இந்த கொள்கலன் ஒரு அவிழ்க்கப்பட்ட புத்தகத்தை (ஒரு அடைவு) குறிக்கிறது என்றால்

பெயரில் உள்ள அனைத்து இணைப்புகளையும் மீண்டும் செயல்படுத்தவும். Get_line_numbers உண்மையாக இருந்தால், படிவத்தின் முடிவுகளை மகசூல் செய்கிறது (இணைப்பு, வரி_நம்பர், ஆஃப்செட்). LINE_NUMBER என்பது வரி_நம்பர் ஆகும், அதில் இணைப்பு நிகழ்கிறது மற்றும் ஆஃப்செட் என்பது வரியின் தொடக்கத்திலிருந்து எழுத்துகளின் எண்ணிக்கை. ஆஃப்செட் உண்மையில் பூஜ்ஜியமாக இல்லாவிட்டால் பல வரிகளை உள்ளடக்கியது என்பதை நினைவில் கொள்க.

make_name_unique(name)[source]

இந்த புத்தகத்தில் பெயர் ஏற்கனவே இல்லை என்பதை உறுதிப்படுத்தவும். அவ்வாறு செய்தால், இல்லாத மாற்றியமைக்கப்பட்ட பதிப்பை திருப்பி விடுங்கள்.

manifest_has_name(name)[source]

மேனிஃபெஸ்டில் பெயருடன் தொடர்புடைய நுழைவு இருந்தால் உண்மையாகத் திரும்புக

property manifest_id_map

மேனிஃபெஸ்ட் ஐடியை நியமன பெயர்களுக்கு மேப்பிங் செய்வது

manifest_items_of_type(predicate)[source]

ஊடக வகை பொருந்தக்கூடிய அனைத்து வெளிப்படையான பொருட்களின் பெயர்களும் முன்னறிவிக்கின்றன. முன்னறிவிப்பு ஒரு தொகுப்பு, ஒரு பட்டியல், ஒரு சரம் அல்லது ஒரு வாதத்தை எடுக்கும் செயல்பாடாக இருக்கலாம், இது மீடியா வகையுடன் அழைக்கப்படும்.

manifest_items_with_property(property_name)[source]

குறிப்பிட்ட சொத்து கொண்ட அனைத்து வெளிப்படையான பொருட்களும்

property manifest_type_map

அந்த மீடியா வகையின் நியமன பெயர்களின் பட்டியலுக்கு மேனிஃபெஸ்ட் மீடியா-வகையின் மேப்பிங்

property mi

இந்த புத்தகத்தின் மெட்டாடேட்டா ஒரு மெட்டாடேட்டா பொருளாக. இந்த சொத்து கோரப்படும் ஒவ்வொரு முறையும் இந்த பொருள் பறக்கும்போது கட்டப்பட்டுள்ளது என்பதை நினைவில் கொள்க, எனவே அதை குறைவாகப் பயன்படுத்துங்கள்.

name_to_abspath(name)[source]

ஒரு நியமன பெயரை ஒரு முழுமையான OS சார்பு பாதையாக மாற்றவும்

name_to_href(name, base=None)[source]

ஒரு பெயரை தளத்துடன் ஒப்பிடும்போது ஒரு பெயரை மாற்றவும், இது ஒரு பெயராக இருக்க வேண்டும் அல்லது எதுவுமில்லை

property names_that_must_not_be_changed

ஒருபோதும் மறுபெயரிடப்படாத பெயர்களின் தொகுப்பு. மின்-புத்தக கோப்பு வடிவமைப்பைப் பொறுத்தது.

property names_that_must_not_be_removed

கொள்கலனில் இருந்து ஒருபோதும் நீக்கப்படாத பெயர்களின் தொகுப்பு. மின்-புத்தக கோப்பு வடிவமைப்பைப் பொறுத்தது.

property names_that_need_not_be_manifested

மேனிஃபெஸ்டிலிருந்து காணாமல் போக அனுமதிக்கப்பட்ட பெயர்களின் தொகுப்பு. மின்-புத்தக கோப்பு வடிவமைப்பைப் பொறுத்தது.

open(name, mode='rb')[source]

நேரடி வாசிப்பு/எழுத பெயரால் சுட்டிக்காட்டப்பட்ட கோப்பைத் திறக்கவும். இது கோப்பை அழுக்குச் செய்தால் அது பார்சே தற்காலிக சேமிப்பிலிருந்து அகற்றும் என்பதை நினைவில் கொள்க. இந்த கோப்பை மீண்டும் பாகுபடுத்தப்பட்ட பதிப்பை அணுகுவதற்கு முன் நீங்கள் முடிக்க வேண்டும், அல்லது மோசமான விஷயங்கள் நடக்கும்.

property opf

பாகுபடுத்தப்பட்ட OPF கோப்பு

opf_get_or_create(name)[source]

முதல் எக்ஸ்எம்எல் உறுப்பை குறிப்பிட்ட பெயருடன் திருப்பித் தரவும் அல்லது OPF: தொகுப்பு உறுப்பின் கீழ் அதை உருவாக்கவும், பின்னர் அது ஏற்கனவே இல்லையென்றால் அதைத் திருப்பித் தரவும் வசதியான முறை.

property opf_version

OPF இன் <caget> உறுப்பில் அமைக்கப்பட்ட பதிப்பு

property opf_version_parsed

OPF இன் <cacket> உறுப்பில் அமைக்கப்பட்ட பதிப்பு முழு எண்களின் டூப்பிள்

opf_xpath(expr)[source]

வசதியான முறை OPF கோப்பில் ஒரு எக்ஸ்பாத் வெளிப்பாட்டை மதிப்பிடுவதற்கான முறை, OPF: மற்றும் DC: பெயர்வெளி முன்னொட்டுகள் முன் வரையறுக்கப்பட்டுள்ளன.

parsed(name)[source]

பெயரால் குறிப்பிடப்பட்ட கோப்பின் பாகுபடுத்தப்பட்ட பிரதிநிதித்துவத்தைத் தரவும். HTML மற்றும் எக்ஸ்எம்எல் கோப்புகளுக்கு எல்எக்ஸ்எம்எல் மரம் திரும்பும். CSS கோப்புகளுக்கு CSS_PARSER SLAYLESHEET திரும்பும். பாகுபடுத்தப்பட்ட பொருள்கள் செயல்திறனுக்காக தற்காலிகமாக சேமிக்கப்படுகின்றன என்பதை நினைவில் கொள்க. பாகுபடுத்தப்பட்ட பொருளில் நீங்கள் ஏதேனும் மாற்றங்களைச் செய்தால், நீங்கள் அழைக்க வேண்டும்: மெத்: அழுக்கு இதனால் கேச் புதுப்பிக்க கொள்கலன் தெரியும். மேலும் காண்க: மெத்: மாற்றவும்.

raw_data(name, decode=True, normalize_to_nfc=True)[source]

பெயரால் குறிப்பிடப்பட்ட கோப்புடன் தொடர்புடைய மூல தரவைத் தரவும்

அளவுருக்கள்:
  • decode -- உண்மை மற்றும் கோப்பில் உரை அடிப்படையிலான மைம் வகை இருந்தால், அதை டிகோட் செய்து மூல பைட்டுகளுக்கு பதிலாக யூனிகோட் பொருளைத் திருப்பித் தரவும்.

  • normalize_to_nfc -- உண்மை என்றால், திரும்பிய யூனிகோட் பொருள் EPUB மற்றும் AZW3 கோப்பு வடிவங்களுக்குத் தேவையான NFC இயல்பான வடிவத்திற்கு இயல்பாக்கப்படுகிறது.

relpath(path, base=None)[source]

ஒரு முழுமையான பாதையை (OS பிரிப்பான்களுடன்) தளத்துடன் தொடர்புடைய பாதைக்கு மாற்றவும் (இயல்புநிலைகள் சுய. ரூட்). உறவினர் பாதை * ஒரு பெயர் அல்ல. பயன்படுத்தவும்: meth: asppath_to_name அதற்காக.

remove_from_spine(spine_items, remove_if_no_longer_in_spine=True)[source]

முதுகெலும்பிலிருந்து குறிப்பிட்ட உருப்படிகளை (நியமன பெயரால்) அகற்றவும். `` Remive_if_no_longer_in_spine`` உண்மையாக இருந்தால், உருப்படிகளும் முதுகெலும்பிலிருந்து மட்டுமல்ல, புத்தகத்திலிருந்து நீக்கப்படுகின்றன.

remove_from_xml(item)[source]

பெற்றோரிடமிருந்து உருப்படியை நீக்குகிறது, உள்தள்ளலை சரிசெய்கிறது (சுய நிறைவு உருப்படிகளுடன் மட்டுமே செயல்படுகிறது)

remove_item(name, remove_from_guide=True)[source]

இந்த கொள்கலனில் இருந்து பெயரால் அடையாளம் காணப்பட்ட உருப்படியை அகற்று. இது OPF மேனிஃபெஸ்ட், வழிகாட்டி மற்றும் முதுகெலும்பு மற்றும் எந்த உள் தற்காலிக சேமிப்புகளிலிருந்தும் உருப்படி பற்றிய அனைத்து குறிப்புகளையும் நீக்குகிறது.

rename(current_name, new_name)[source]

ஒரு கோப்பை Current_name இலிருந்து புதிய_பெயருக்கு மறுபெயரிடுகிறது. கோப்புறை மாற்றங்களில் இருந்தால் அது கோப்பின் உள்ளே உள்ள அனைத்து இணைப்புகளையும் தானாகவே மறுக்கிறது. இருப்பினும், இந்த கோப்பைக் குறிப்பிடக்கூடிய பிற கோப்புகளில் இணைப்புகள் புதுப்பிக்கப்படவில்லை என்பதை நினைவில் கொள்க. இது செயல்திறனுக்காக, அத்தகைய புதுப்பிப்புகள் ஒரு முறை, மொத்தமாக செய்யப்பட வேண்டும்.

replace(name, obj)[source]

OBJ உடன் பெயருடன் தொடர்புடைய பாகுபடுத்தப்பட்ட பொருளை மாற்றவும், இது ஒத்த பொருளாக இருக்க வேண்டும், அதாவது HTML/XML க்கான LXML மரம் அல்லது CSS கோப்பிற்கான CSS_PARSER SLAYLESHEET.

Replace_func ஐப் பயன்படுத்தி பெயரில் உள்ள அனைத்து இணைப்புகளையும் மாற்றவும், இது ஒரு URL ஐ ஏற்றுக்கொண்டு மாற்றப்பட்ட URL ஐ திருப்பித் தரக்கூடிய அழைக்கப்பட வேண்டும். ஏதேனும் உண்மையான மாற்றீடு செய்யப்பட்டால் அது உண்மை என அமைக்கப்பட்ட ஒரு 'மாற்றப்பட்ட' பண்புக்கூறையும் கொண்டிருக்க வேண்டும். அத்தகைய அழைக்கக்கூடியவற்றை உருவாக்குவதற்கான வசதியான வழிகள்: வகுப்பு: linkreplacer மற்றும்: வகுப்பு:` லிங்க்ரெபேசர்` வகுப்புகளைப் பயன்படுத்துகின்றன.

serialize_item(name)[source]

ஒரு பாகுபடுத்தப்பட்ட பொருளை (நியமன பெயரால் அடையாளம் காணப்படுகிறது) ஒரு பைட்டெஸ்ட்ரிங்காக மாற்றவும். காண்க: மெத்: பாகுபடுத்தப்பட்ட.

set_spine(spine_items)[source]

முதுகெலும்புகளை முதுகெலும்பு_இடெம்களாக அமைக்கவும், அங்கு முதுகெலும்பு_இடெம்கள் வடிவத்தின் (பெயர், நேரியல்) ஒரு மறுக்கக்கூடியவை. பெயர்களில் ஒன்று மேனிஃபெஸ்டில் இல்லாவிட்டால் பிழையை உயர்த்தும்.

property spine_items

புத்தகங்களின் முதுகெலும்பில் உள்ள ஒவ்வொரு பொருளுக்கும் பாதையை வழங்கும் ஒரு மறு செய்கை. மேலும் காண்க:: attr: ஸ்பைன்_ஐடிஆர் மற்றும்: attr:` முதுகெலும்பு_இடெம்ஸ்`.

property spine_iter

புத்தகங்களின் முதுகெலும்பில் உள்ள ஒவ்வொரு பொருளுக்கும் உருப்படி, பெயர் IS_LINEAR ஐ வழங்கும் ஒரு மறு செய்கை. உருப்படி எல்எக்ஸ்எம்எல் உறுப்பு, பெயர் என்பது நியமன கோப்பு பெயர் மற்றும் உருப்படி நேரியல் என்றால் ஐஎஸ்_லினேர் உண்மை. மேலும் காண்க:: attr: ஸ்பைன்_பேம்ஸ் மற்றும்: attr:` முதுகெலும்பு_இடெம்ஸ்`.

property spine_names

புத்தகங்களின் முதுகெலும்பில் உள்ள ஒவ்வொரு பொருளுக்கும் ஒரு மறுசீரமைப்பு பெயர் மற்றும் IS_Linear. மேலும் காண்க:: attr: ஸ்பைன்_ஐடிஆர் மற்றும்: attr:` முதுகெலும்பு_இடெம்ஸ்`.

ஒரு கொள்கலனில் கூறு கோப்புகளை நிர்வகித்தல்

கொள்கலனில் உள்ள கோப்புகளுக்கான இணைப்புகளை மாற்றவும். கொள்கலனில் உள்ள எல்லா கோப்புகளையும் மீண்டும் கூறி அவற்றில் உள்ள குறிப்பிட்ட இணைப்புகளை மாற்றும்.

அளவுருக்கள்:
  • link_map -- புதிய நியமன பெயருக்கு பழைய நியமன பெயரை வரைபடம். எடுத்துக்காட்டாக :: குறியீடு: {'படங்கள்/old.png': 'படங்கள்/new.png'}

  • frag_map -- அழைக்கக்கூடிய இரண்டு வாதங்களை எடுத்து (பெயர், நங்கூரம்) `மற்றும் ஒரு புதிய நங்கூரத்தை வழங்குகிறது. HTML கோப்புகளில் உள்ள நங்கூரங்களை மாற்ற வேண்டியிருந்தால் இது பயனுள்ளதாக இருக்கும். இயல்பாக, இது எதுவும் செய்யாது.

  • replace_in_opf -- தவறு என்றால், OPF கோப்பில் இணைப்புகள் மாற்றப்படாது.

calibre.ebooks.oeb.polish.replace.rename_files(container, file_map)[source]

கொள்கலனில் உள்ள கோப்புகளை மறுபெயரிட்டு, அவற்றுக்கான அனைத்து இணைப்புகளையும் தானாகவே புதுப்பிக்கவும்.

அளவுருக்கள்:

file_map -- புதிய நியமன பெயருக்கு பழைய நியமனப் பெயரின் மேப்பிங், எடுத்துக்காட்டாக :: குறியீடு: {'உரை/அத்தியாயம் 1.html': 'பாடம் 1.html'} `.

கொடுக்கப்பட்ட கோப்பு பெயர்களுக்கு பரிந்துரைக்கப்பட்ட கோப்புறைகளைத் திருப்பித் தரவும். ஒரே வகையின் பெரும்பாலான கோப்புகள் கொள்கலனில் அமைந்துள்ள இடத்தை அடிப்படையாகக் கொண்டது. ஒரு குறிப்பிட்ட வகையின் கோப்புகள் எதுவும் இல்லை என்றால், பரிந்துரைக்கப்பட்ட கோப்புறை OPF கோப்பைக் கொண்ட கோப்புறையாக கருதப்படுகிறது.

அழகான அச்சிடுதல் மற்றும் ஆட்டோ சரிசெய்தல் பாகுபடுத்தும் பிழைகள்

calibre.ebooks.oeb.polish.pretty.fix_html(container, raw)[source]

HTML இல் எந்த பாகுபடுத்தும் பிழைகளையும் ராவில் ஒரு சரமாக குறிப்பிடவும். HTML5 பாகுபடுத்தும் வழிமுறையைப் பயன்படுத்தி சரிசெய்தல் செய்யப்படுகிறது.

calibre.ebooks.oeb.polish.pretty.fix_all_html(container)[source]

கொள்கலனில் உள்ள அனைத்து HTML கோப்புகளிலும் எந்த பாகுபடுத்தும் பிழைகளையும் சரிசெய்யவும். HTML5 பாகுபடுத்தும் வழிமுறையைப் பயன்படுத்தி சரிசெய்தல் செய்யப்படுகிறது.

calibre.ebooks.oeb.polish.pretty.pretty_html(container, name, raw)[source]

HTML ஐ மிகவும் அச்சிடுக

calibre.ebooks.oeb.polish.pretty.pretty_css(container, name, raw)[source]

CSS ஐ ஒரு சரம் மூலமாக குறிப்பிடுகிறது

calibre.ebooks.oeb.polish.pretty.pretty_xml(container, name, raw)[source]

எக்ஸ்எம்எல் பச்சையாக ஒரு சரம் என குறிப்பிடப்படுகிறது. `` பெயர்`` என்பது OPF இன் பெயர் என்றால், கூடுதல் OPF- குறிப்பிட்ட அழகானது செய்யப்படுகிறது.

calibre.ebooks.oeb.polish.pretty.pretty_all(container)[source]

அனைத்து HTML/CSS/XML கோப்புகளையும் கொள்கலனில் அச்சிடுக

புத்தக ஜாக்கெட்டுகளை நிர்வகித்தல்

calibre.ebooks.oeb.polish.jacket.remove_jacket(container)[source]

ஏதேனும் இருந்தால், ஏற்கனவே இருக்கும் ஜாக்கெட்டை அகற்றவும். தற்போதுள்ள ஜாக்கெட் எதுவும் கிடைக்கவில்லை என்றால் தவறானது.

calibre.ebooks.oeb.polish.jacket.add_or_replace_jacket(container)[source]

புத்தகத்தின் மெட்டாடேட்டாவிலிருந்து ஒரு புதிய ஜாக்கெட்டை உருவாக்கவும் அல்லது ஏற்கனவே உள்ள ஜாக்கெட்டை மாற்றவும். ஏற்கனவே இருக்கும் ஜாக்கெட் மாற்றப்பட்டால் உண்மை.

கோப்புகளைப் பிரித்தல் மற்றும் ஒன்றிணைத்தல்

calibre.ebooks.oeb.polish.split.split(container, name, loc_or_xpath, before=True, totals=None)[source]

LOC_OR_XPATH ஆல் குறிப்பிடப்பட்ட நிலையில் பெயரால் குறிப்பிடப்பட்ட கோப்பை பிரிக்கவும். பிளவு தானாகவே பாதிக்கப்பட்ட கோப்புகளுக்கான அனைத்து இணைப்புகளையும் குறிப்புகளையும் நகர்த்துகிறது.

அளவுருக்கள்:
  • loc_or_xpath -- // h: div [@id = "split_here"] போன்ற ஒரு XPath வெளிப்பாடாக இருக்க வேண்டும். முன்னோட்டக் குழுவில் பிளவுபடுவதை செயல்படுத்த உள்நாட்டில் பயன்படுத்தப்படும் * லாக் * ஆகவும் இருக்கலாம்.

  • before -- உண்மை என்றால் பிளவு அடையாளம் காணப்பட்ட உறுப்புக்கு முன் நிகழ்கிறது.

  • totals -- உள்நாட்டில் பயன்படுத்தப்படுகிறது

calibre.ebooks.oeb.polish.split.multisplit(container, name, xpath, before=True)[source]

குறிப்பிட்ட கோப்பை பல இடங்களில் பிரிக்கவும் (குறிப்பிட்ட எக்ஸ்பாத் வெளிப்பாட்டுடன் பொருந்தக்கூடிய அனைத்து குறிச்சொற்களும்). மேலும் காண்க :: func: பிளவு. பிளவு தானாகவே பாதிக்கப்பட்ட கோப்புகளுக்கான அனைத்து இணைப்புகளையும் குறிப்புகளையும் நகர்த்துகிறது.

அளவுருக்கள்:

before -- உண்மை என்றால், அடையாளம் காணப்பட்ட உறுப்புக்கு முன் பிளவுகள் நிகழ்கின்றன.

calibre.ebooks.oeb.polish.split.merge(container, category, names, master)[source]

குறிப்பிட்ட கோப்புகளை ஒற்றை கோப்பில் ஒன்றிணைத்து, பாதிக்கப்பட்ட கோப்புகளுக்கு எல்லா இணைப்புகளையும் குறிப்புகளையும் தானாக நகர்த்தும். கோப்பு அனைத்தும் HTML அல்லது CSS கோப்புகளாக இருக்க வேண்டும்.

அளவுருக்கள்:
  • category -- HTML கோப்புகளுக்கான `` 'உரை'` அல்லது CSS கோப்புகளுக்கு ``' ஸ்டைல்கள்'` ஆக இருக்க வேண்டும்

  • names -- இணைக்கப்பட வேண்டிய கோப்புகளின் பட்டியல்

  • master -- இணைக்கப்பட்ட கோப்புகளில் எது * மாஸ்டர் * கோப்பு, அதாவது, ஒன்றிணைந்த பிறகு இருக்கும் கோப்பு.

மேலாண்மை கவர்கள்

calibre.ebooks.oeb.polish.cover.set_cover(container, cover_path, report=None, options=None)[source]

கவர்_பாத் சுட்டிக்காட்டிய படத்திற்கு புத்தகத்தின் அட்டையை அமைக்கவும்.

அளவுருக்கள்:
  • cover_path -- படக் கோப்பிற்கான முழுமையான பாதை அல்லது புத்தகத்தில் உள்ள ஒரு படத்தின் நியமன பெயர். புத்தகத்தில் ஒரு படத்தைப் பயன்படுத்தும் போது, நீங்கள் விருப்பங்களையும் அமைக்க வேண்டும், கீழே காண்க.

  • report -- ஒற்றை வாதத்தை எடுக்கும் விருப்பமான அழைக்கக்கூடியது. செயலாக்கப்படும் பணிகள் பற்றிய தகவல்களுடன் இது அழைக்கப்படும்.

  • options -- கவர் எவ்வாறு அமைக்கப்படுகிறது என்பதைக் கட்டுப்படுத்தும் அகராதி எதுவும் இல்லை. அகராதி உள்ளீடுகளைக் கொண்டிருக்கலாம்: ** கீப்_எஸ்பெக்ட் **: உண்மை அல்லது பொய் (எபபில் அட்டைகளின் விகித விகிதத்தைப் பாதுகாக்கவும்) ** No_SVG **: உண்மை அல்லது பொய் (எபப் தலைப்புப் பெட்டியில் ஒரு எஸ்.வி.ஜி கவர் ரேப்பரைப் பயன்படுத்தவும்) ** இருக்கும் **: உண்மை அல்லது பொய் (`` கவர்_பாத்`` புத்தகத்தில் இருக்கும் படத்தைக் குறிக்கிறது)

calibre.ebooks.oeb.polish.cover.mark_as_cover(container, name)[source]

குறிப்பிட்ட படத்தை கவர் படமாகக் குறிக்கவும்.

calibre.ebooks.oeb.polish.cover.mark_as_titlepage(container, name, move_to_start=True)[source]

குறிப்பிட்ட HTML கோப்பை EPUB இன் தலைப்புப் பெட்டியாகக் குறிக்கவும்.

அளவுருக்கள்:

move_to_start -- உண்மை என்றால் HTML கோப்பு முதுகெலும்பின் தொடக்கத்திற்கு நகர்த்தப்படும்

CSS உடன் பணிபுரிதல்

calibre.ebooks.oeb.polish.fonts.change_font(container, old_name, new_name=None)[source]

ஒரு எழுத்துரு குடும்பத்தை பழைய_பெயரிலிருந்து புதிய_பெயராக மாற்றவும். எழுத்துரு குடும்பத்தின் அனைத்து நிகழ்வுகளையும் ஸ்டைல்ஷீட்கள், பாணி குறிச்சொற்கள் மற்றும் பாணி பண்புகளில் மாற்றுகிறது. பழைய_ பெயர் உட்பொதிக்கப்பட்ட எழுத்துருவைக் குறிக்கும் என்றால், அது அகற்றப்படும். எழுத்துரு குடும்பத்தை மாற்றுவதற்குப் பதிலாக அதை அகற்ற புதிய_பெயரை யாரும் அமைக்கலாம்.

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)[source]

பயன்படுத்தப்படாத அனைத்து CSS விதிகளையும் புத்தகத்திலிருந்து அகற்றவும். பயன்படுத்தப்படாத CSS விதி என்பது உண்மையான உள்ளடக்கத்துடன் பொருந்தாத ஒன்றாகும்.

அளவுருக்கள்:
  • report -- ஒற்றை வாதத்தை எடுக்கும் விருப்பமான அழைக்கக்கூடியது. இது செய்யப்படும் செயல்பாடுகள் பற்றிய தகவல்களுடன் அழைக்கப்படுகிறது.

  • remove_unused_classes -- உண்மை என்றால், எந்த CSS விதிகளும் பொருந்தாத HTML இல் வகுப்பு பண்புகளும் அகற்றப்படும்.

  • merge_rules -- உண்மை என்றால், ஒரே மாதிரியான தேர்வாளர்களுடனான விதிகள் ஒன்றிணைக்கப்படுகின்றன.

  • merge_rules_with_identical_properties -- உண்மை என்றால், ஒரே மாதிரியான பண்புகளைக் கொண்ட விதிகள் ஒன்றிணைக்கப்படுகின்றன.

  • remove_unreferenced_sheets -- உண்மை என்றால், எந்தவொரு உள்ளடக்கத்தாலும் குறிப்பிடப்படாத ஸ்டைல்ஷீட்கள் அகற்றப்படும்

calibre.ebooks.oeb.polish.css.filter_css(container, properties, names=())[source]

புத்தகத்தில் உள்ள அனைத்து CSS விதிகளிலிருந்தும் குறிப்பிட்ட CSS பண்புகளை அகற்றவும்.

அளவுருக்கள்:
  • properties -- அகற்ற வேண்டிய பண்புகளின் தொகுப்பு. எடுத்துக்காட்டாக :: குறியீடு: {'எழுத்துரு-குடும்பம்', 'வண்ணம்'}.

  • names -- பண்புகளை அகற்ற வேண்டிய கோப்புகள். புத்தகத்தில் உள்ள அனைத்து HTML மற்றும் CSS கோப்புகளுக்கும் இயல்புநிலை.

உள்ளடக்க அட்டவணையுடன் பணிபுரிதல்

calibre.ebooks.oeb.polish.toc.from_xpaths(container, xpaths, prefer_title=False)[source]

எக்ஸ்பாத் வெளிப்பாடுகளின் பட்டியலிலிருந்து உள்ளடக்க அட்டவணையை உருவாக்குங்கள். பட்டியலில் உள்ள ஒவ்வொரு வெளிப்பாடும் உருவாக்க TOC இன் நிலைக்கு ஒத்திருக்கிறது. எடுத்துக்காட்டாக :: குறியீடு: ['// // h: h1', '// h: h2', '// h: h3'] `` <h1> `` இலிருந்து மூன்று நிலை உள்ளடக்க அட்டவணையை உருவாக்கும் , `` <H2> `` மற்றும் `` <H3> `` குறிச்சொற்கள்.

புத்தகத்தில் உள்ள இணைப்புகளிலிருந்து உள்ளடக்க அட்டவணையை உருவாக்குங்கள்.

calibre.ebooks.oeb.polish.toc.from_files(container)[source]

புத்தகத்தில் உள்ள கோப்புகளிலிருந்து உள்ளடக்க அட்டவணையை உருவாக்குங்கள்.

calibre.ebooks.oeb.polish.toc.create_inline_toc(container, title=None)[source]

ஏற்கனவே உள்ள NCX உள்ளடக்க அட்டவணையில் இருந்து இன்லைன் (HTML) உள்ளடக்க அட்டவணையை உருவாக்கவும்.

அளவுருக்கள்:

title -- இந்த உள்ளடக்க அட்டவணைக்கான தலைப்பு.

புத்தக திருத்த கருவி

class calibre.gui2.tweak_book.plugin.Tool[source]

தளங்கள் :: py: வகுப்பு: பொருள்

ஒரு திருத்து புத்தக சொருகியில் தனிப்பட்ட கருவிகளுக்கான அடிப்படை வகுப்பு. பயனுள்ள உறுப்பினர்கள் பின்வருமாறு:

  • `` self.plugin``: ஒரு குறிப்பு: வகுப்புக்கு: calibre.customize.plugin இந்த கருவி சொந்தமான பொருள்.

  • சுய. : attr: முதலாளி

  • சுய. : attr: gui

துணை வகுப்புகளில் மீறப்பட வேண்டிய முறைகள்:

  • : மெத்: create_action

  • : மெத்: register_shortcut

name = None

இதை ஒரு தனித்துவமான பெயராக அமைக்கவும், இது ஒரு விசையாகப் பயன்படுத்தப்படும்

allowed_in_toolbar = True

உண்மை என்றால் பயனர் இந்த கருவியை செருகுநிரல்கள் கருவிப்பட்டியில் வைக்க தேர்வு செய்யலாம்

allowed_in_menu = True

உண்மை என்றால் பயனர் இந்த கருவியை செருகுநிரல்கள் மெனுவில் வைக்க தேர்வு செய்யலாம்

toolbar_button_popup_mode = 'delayed'

கருவிப்பட்டி பொத்தானின் மெனுவுக்கான பாப்அப் பயன்முறை (ஏதேனும் இருந்தால்). சாத்தியமான மதிப்புகள் 'தாமதமானது', 'உடனடி', 'பொத்தான்'

property boss

தி: வகுப்பு: calibre.gui2.tweak_book.boss.boss பொருள். பயனர் இடைமுகத்தைக் கட்டுப்படுத்தப் பயன்படுகிறது.

property gui

பயனர் இடைமுகத்தின் முக்கிய சாளரம்

property current_container

மின்னோட்டத்தைத் திருப்பி: வகுப்பு: calibre.ebooks.oeb.polish.container.container பொருள் திருத்தப்பட்ட புத்தகத்தைக் குறிக்கும் பொருள்.

register_shortcut(qaction, unique_name, default_keys=(), short_text=None, description=None, **extra_data)[source]

குறிப்பிட்ட `` Qaction`` ஐத் தூண்டும் விசைப்பலகை குறுக்குவழியை பதிவு செய்யுங்கள். இந்த விசைப்பலகை குறுக்குவழி எடிட்டர் விருப்பங்களின் விசைப்பலகை குறுக்குவழிகள் பிரிவில் பயனரால் தானாகவே தனிப்பயனாக்கப்படும்.

அளவுருக்கள்:
  • qaction -- ஒரு Qaction பொருள், கட்டமைக்கப்பட்ட விசை சேர்க்கை பயனரால் அழுத்தும்போது அது தூண்டப்படும்.

  • unique_name -- இந்த குறுக்குவழி/செயலுக்கான தனித்துவமான பெயர். இது உள்நாட்டில் பயன்படுத்தப்படும், இந்த சொருகி வேறு எந்த செயல்களாலும் இது பகிரப்படக்கூடாது.

  • default_keys -- இயல்புநிலை விசைப்பலகை குறுக்குவழிகளின் பட்டியல். குறிப்பிடப்படவில்லை என்றால் இயல்புநிலை குறுக்குவழிகள் அமைக்கப்படாது. இங்கே குறிப்பிடப்பட்டுள்ள குறுக்குவழிகள் பயனர் உள்ளமைவு/பிற செருகுநிரல்களிலிருந்து பில்டின் குறுக்குவழிகள் அல்லது குறுக்குவழிகளுடன் முரண்பட்டால், அவை புறக்கணிக்கப்படும். அவ்வாறான நிலையில், பயனர்கள் குறுக்குவழிகளை விருப்பத்தேர்வுகள் வழியாக கைமுறையாக உள்ளமைக்க வேண்டும். எடுத்துக்காட்டாக: `` default_keys = ('ctrl+j', 'f9') ``.

  • short_text -- இந்த செயலின் விருப்பமான குறுகிய விளக்கம். குறிப்பிடப்படாவிட்டால் QACTION இலிருந்து உரை பயன்படுத்தப்படும்.

  • description -- இந்த செயலின் விருப்பமான நீண்ட விளக்கம், இந்த குறுக்குவழிக்கான விருப்பத்தேர்வுகள் உள்ளீட்டில் இது பயன்படுத்தப்படும்.

create_action(for_toolbar=True)[source]

`` For_toolbar`` ஐப் பொறுத்து செருகுநிரல்கள் கருவிப்பட்டி அல்லது செருகுநிரல்கள் மெனுவில் சேர்க்கப்படும் ஒரு QACTION ஐ உருவாக்கவும். உதாரணத்திற்கு:

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

See also

முறை: மெத்: register_shortcut.

எடிட்டரின் பயனர் இடைமுகத்தை கட்டுப்படுத்துதல்

மின் புத்தக எடிட்டரின் பயனர் இடைமுகம் ஒற்றை உலகளாவிய * முதலாளி * பொருளால் கட்டுப்படுத்தப்படுகிறது. இது பொதுவான பணிகளைச் செய்ய சொருகி குறியீட்டில் பயன்படுத்தக்கூடிய பல பயனுள்ள முறைகளைக் கொண்டுள்ளது.

class calibre.gui2.tweak_book.boss.Boss(parent, notify=None)[source]
add_savepoint(msg)[source]

`` Msg`` என குறிப்பிடப்பட்ட பெயருடன் மீட்டமை சோதனைச் சாவடியை உருவாக்கவும்

apply_container_update_to_gui(mark_as_modified=True)[source]

தற்போதைய புத்தகக் கொள்கலனில் சமீபத்திய தரவைப் பிரதிபலிக்க பயனர் இடைமுகத்தின் அனைத்து கூறுகளையும் புதுப்பிக்கவும்.

அளவுருக்கள்:

mark_as_modified -- உண்மை என்றால், புத்தகம் மாற்றியமைக்கப்பட்டதாகக் குறிக்கப்படும், எனவே வெளியேறும்போது அதை சேமிக்க பயனர் கேட்கப்படுவார்.

close_editor(name)[source]

`` பெயர்`` ஆல் குறிப்பிடப்பட்ட கோப்பைத் திருத்தும் எடிட்டரை மூடு

commit_all_editors_to_container()[source]

கொள்கலனுக்கு எடிட்டரில் திறக்கப்பட்ட கோப்புகளை பயனர் செய்த எந்த மாற்றங்களையும் செய்யுங்கள். தற்போதைய கொள்கலனில் எந்தவொரு செயலையும் செய்வதற்கு முன் இந்த முறையை நீங்கள் அழைக்க வேண்டும்

property currently_editing

தற்போது திருத்தப்பட்ட கோப்பின் பெயரைத் திருப்பித் தரவில்லை அல்லது எந்த கோப்பையும் திருத்தவில்லை என்றால் எதுவும் இல்லை

edit_file(name, syntax=None, use_template=None)[source]

பெயரால் குறிப்பிடப்பட்ட கோப்பை ஒரு எடிட்டரில் திறக்கவும்

அளவுருக்கள்:
  • syntax -- கோப்பின் ஊடக வகை, எடுத்துக்காட்டாக, `` 'உரை/html'```. குறிப்பிடப்படாவிட்டால் அது கோப்பு நீட்டிப்பிலிருந்து யூகிக்கப்படுகிறது.

  • use_template -- திறந்த எடிட்டரைத் தொடங்க ஒரு வார்ப்புரு

open_book(path=None, edit_file=None, clear_notify_data=True, open_folder=False, search_text=None)[source]

எடிட்டிங் செய்ய மின் புத்தகத்தைத் திறக்கவும். மின் புத்தகம் ஆதரிக்கப்பட்ட வடிவத்தில் இல்லாவிட்டால் அல்லது தற்போதைய புத்தகத்தில் நேர்மையற்ற மாற்றங்கள் இருந்தால் பிழையைக் காண்பிக்கும்.

அளவுருக்கள்:

edit_file -- எடிட்டிங் தொடங்க புதிதாக திறக்கப்பட்ட புத்தகத்திற்குள் ஒரு கோப்பின் பெயர். பெயர்களின் பட்டியலாகவும் இருக்கலாம்.

rewind_savepoint()[source]

மீட்டெடுப்பு சோதனைச் சாவடியின் முந்தைய உருவாக்கத்தை செயல்தவிர்க்கவும், நீங்கள் ஒரு சோதனைச் சாவடியை உருவாக்கினால் பயனுள்ளதாக இருக்கும், பின்னர் எந்த மாற்றமும் இல்லாமல் செயல்பாட்டை நிறுத்துங்கள்

save_book()[source]

புத்தகத்தை சேமிக்கவும். சேமிப்பு பின்னணியில் செய்யப்படுகிறது

set_modified()[source]

புத்தகத்தை மாற்றியமைத்ததாகக் குறிக்கவும்

show_current_diff(allow_revert=True, to_container=None)[source]

புத்தகத்தின் கடைசி சோதனைச் சாவடி நிலையிலிருந்து மாற்றங்களைக் காட்டுங்கள்

அளவுருக்கள்:
  • allow_revert -- உண்மை என்றால், டிஃப் உரையாடலில் பயனரை அனைத்து மாற்றங்களையும் மாற்ற அனுமதிக்க ஒரு பொத்தானைக் கொண்டிருக்கும்

  • to_container -- தற்போதைய கொள்கலனை ஒப்பிட்டுப் பார்க்க ஒரு கொள்கலன் பொருள். எதுவுமில்லை என்றால், முன்னர் சோதனைச் சாவடி கொள்கலன் பயன்படுத்தப்படுகிறது

show_editor(name)[source]

`` பெயர்`` ஆல் குறிப்பிடப்பட்ட கோப்பைத் திருத்தும் எடிட்டரைக் காட்டு

sync_preview_to_editor()[source]

தற்போதைய எடிட்டரில் தற்போதைய கர்சர் நிலைக்கு முன்னோட்டக் குழுவின் நிலையை ஒத்திசைக்கவும்