காலிபர் மேம்பாட்டு சூழலை அமைத்தல்

காலிபர் முற்றிலும் திறந்த மூலமாகும், குனு ஜிபிஎல் வி 3 <https://www.gnu.org/licenses/gpl.html> _ _ இன் கீழ் உரிமம் பெற்றது. இதன் பொருள் உங்கள் இதயத்தின் உள்ளடக்கத்திற்கு நிரலை பதிவிறக்கம் செய்து மாற்ற நீங்கள் இலவசம். இந்த பிரிவில், நீங்கள் விரும்பும் இயக்க முறைமையில் ஒரு காலிபர் மேம்பாட்டு சூழலை எவ்வாறு பெறுவது என்பதை நீங்கள் கற்றுக் கொள்வீர்கள். காலிபர் முதன்மையாக `பைதான் <https://www.python.org> _ வேகம் மற்றும் கணினி இடைமுகத்திற்கான சில சி/சி ++ குறியீட்டில் எழுதப்பட்டுள்ளது. காலிபருக்கு குறைந்தது பைதான் 3.8 தேவை என்பதை நினைவில் கொள்க.

வடிவமைப்பு தத்துவம்

யூனிக்ஸ் உலகில் காலிபர் அதன் வேர்களைக் கொண்டுள்ளது, அதாவது அதன் வடிவமைப்பு மிகவும் மட்டு. தொகுதிகள் நன்கு வரையறுக்கப்பட்ட இடைமுகங்கள் வழியாக ஒருவருக்கொருவர் தொடர்பு கொள்கின்றன. இது புதிய அம்சங்களைச் சேர்ப்பது மற்றும் பிழைகளை காலிபரில் சரிசெய்வது மிகவும் எளிதானது, இதன் விளைவாக வளர்ச்சியின் வெறித்தனமான வேகத்தை ஏற்படுத்துகிறது. அதன் வேர்கள் காரணமாக, காலிபர் அதன் அனைத்து செயல்பாடுகளுக்கும் ஒரு விரிவான கட்டளை வரி இடைமுகத்தைக் கொண்டுள்ளது, இது ஆவணப்படுத்தப்பட்டுள்ளது: DOC: உருவாக்கப்பட்ட/EN/CLI-Index.

காலிபரின் மட்டு வடிவமைப்பு `` செருகுநிரல்கள்`` வழியாக வெளிப்படுத்தப்படுகிறது. ஒரு: குறிப்பு உள்ளது: டுடோரியல் <தனிப்பயனாக்கு> காலிபர் செருகுநிரல்களை எழுதுவதில். எடுத்துக்காட்டாக, ஒரு புதிய சாதனத்திற்கான ஆதரவை காலிபரில் சேர்ப்பது பொதுவாக சாதன இயக்கி சொருகி வடிவத்தில் 100 வரிகளுக்கும் குறைவான குறியீட்டை எழுதுவதை உள்ளடக்குகிறது. நீங்கள் உள்ளமைக்கப்பட்ட இயக்கிகள் <https://github.com/kovidgoyal/calibre/tree/master/src/calibre/devices> _ ஆகியவற்றை உலாவலாம். இதேபோல், புதிய மாற்று வடிவங்களுக்கு ஆதரவைச் சேர்ப்பது உள்ளீடு/வெளியீட்டு வடிவமைப்பு செருகுநிரல்களை எழுதுவதை உள்ளடக்குகிறது. மட்டு வடிவமைப்பின் மற்றொரு எடுத்துக்காட்டு: ref: செய்முறை அமைப்பு <செய்திகள்> செய்திகளைப் பெறுவதற்கு. காலிபருக்கு அம்சங்களைச் சேர்க்க வடிவமைக்கப்பட்ட செருகுநிரல்களின் கூடுதல் எடுத்துக்காட்டுகளுக்கு, செருகுநிரல்களின் குறியீட்டைப் பார்க்கவும் <https://www.mobileread.com/forums/showthread.php?p=1362767#post1362767> _.

குறியீடு தளவமைப்பு

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

  • சாதனங்கள் - அனைத்து சாதன இயக்கிகளும். அவர்கள் எவ்வாறு செயல்படுகிறார்கள் என்பதற்கான யோசனையைப் பெற சில உள்ளமைக்கப்பட்ட ஓட்டுனர்களைப் பாருங்கள்.

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

  • மின்-புத்தகங்கள்-அனைத்து மின் புத்தக மாற்றம்/மெட்டாடேட்டா குறியீடு. ஒரு நல்ல தொடக்கப் புள்ளி `` calibre.ebooks.conversion.cli`` இது இயக்கும் தொகுதி: கட்டளை: மின்புத்தக-கான்வர்ட் கட்டளை. மாற்று செயல்முறை `` Converst.plumber`` வழியாக கட்டுப்படுத்தப்படுகிறது. வடிவமைப்பு சுயாதீன குறியீடு அனைத்தும் `` ebooks.oeb`` மற்றும் வடிவமைப்பு சார்ந்த குறியீடு `` ebooks.format_name`` இல் உள்ளது.

    • மெட்டாடேட்டா வாசிப்பு, எழுதுதல் மற்றும் பதிவிறக்கம் அனைத்தும் `` ebooks.metadata``

    • மாற்றம் ஒரு குழாய்வழியில் நிகழ்கிறது, குழாய்த்திட்டத்தின் கட்டமைப்பிற்கு, காண்க: குறிப்பு: மாற்று-அறிமுகம். குழாய் ஒரு உள்ளீட்டு சொருகி, பல்வேறு உருமாற்றங்கள் மற்றும் வெளியீட்டு சொருகி ஆகியவற்றைக் கொண்டுள்ளது. குழாய்த்திட்டத்தை உருவாக்கி இயக்கும் குறியீடு உள்ளது: கோப்பு: plumber.py. வெளிப்படையான, முதுகெலும்பு, TOC, வழிகாட்டி, HTML உள்ளடக்கம் போன்றவற்றைக் கொண்ட ஒரு மின் புத்தகத்தின் பிரதிநிதித்துவத்தில் இந்த குழாய் செயல்படுகிறது. இந்த பிரதிநிதித்துவத்தை நிர்வகிக்கும் வர்க்கம் `` ebooks.base`` . மாற்றங்களின் போது புத்தகத்திற்குப் பயன்படுத்தப்படும் பல்வேறு மாற்றங்கள் வாழ்க: கோப்பு: OEB/உருமாற்றங்கள்/*. Py. உள்ளீடு மற்றும் வெளியீட்டு செருகுநிரல்கள் வாழ்கின்றன: கோப்பு: மாற்று/செருகுநிரல்கள்/*. Py.

    • மின் புத்தக எடிட்டிங் வேறு கொள்கலன் பொருளைப் பயன்படுத்தி நிகழ்கிறது. இது ஆவணப்படுத்தப்பட்டுள்ளது: ref: Polish_api.

  • டி.பி. - தரவுத்தள பின் -இறுதி. காண்க: குறிப்பு: காலிபர் நூலகத்திற்கான இடைமுகத்திற்கு db_api.

  • உள்ளடக்க சேவையகம்: `` எஸ்.ஆர்.வி`` என்பது காலிபர் உள்ளடக்க சேவையகம்.

  • GUI2 - வரைகலை பயனர் இடைமுகம். GUI துவக்கம் `` gui2.main`` மற்றும் `` gui2.ui`` இல் நிகழ்கிறது. மின்-புத்தக-பார்வையாளர் `` gui2.viewer`` இல் உள்ளது. மின் புத்தக எடிட்டர் `` gui2.tweak_book`` இல் உள்ளது.

அனைத்து பல்வேறு காலிபர் இயங்குதல்களுக்கான நுழைவு புள்ளிகளைக் கண்டுபிடிக்க விரும்பினால், `` Entry_Points`` கட்டமைப்பை `linux.py <https://github.com/kovidgoyal/calibre/blob/master/src/calibre/ இல் பாருங்கள் linux.py> `_.

குறியீட்டைப் புரிந்துகொள்ள உங்களுக்கு உதவி தேவைப்பட்டால், மேம்பாட்டு மன்றத்தில் <https://www.mobileered.com/forums/forumdisplay.php?f=240> _ இல் இடுகையிடவும் .

குறியீட்டைப் பெறுதல்

பதிப்பு கட்டுப்பாட்டு முறையைப் பயன்படுத்தி அல்லது நேரடியாக ஒரு: வலைத்தளம்_பேஸ்: டார்பால் <dist/src> என்ற காலிபர் மூலக் குறியீட்டை இரண்டு வழிகளில் பெறலாம்.

காலிபர் கிட் <https://www.git-scm.com/> _, விநியோகிக்கப்பட்ட பதிப்பு கட்டுப்பாட்டு முறையைப் பயன்படுத்துகிறது. காலிபர் ஆதரவு அனைத்து தளங்களிலும் கிட் கிடைக்கிறது. கிட் நிறுவிய பிறகு, நீங்கள் கட்டளையுடன் காலிபர் மூலக் குறியீட்டைப் பெறலாம்

git clone https://github.com/kovidgoyal/calibre.git

விண்டோஸில் உங்களுக்கு முழுமையான பாதை பெயர் தேவைப்படும், அது போன்றதாக இருக்கும்: கோப்பு: சி: \ நிரல் கோப்புகள் \ git \ git.exe.

காலிபர் என்பது மிக நீண்ட மூலக் கட்டுப்பாட்டு வரலாற்றைக் கொண்ட மிகப் பெரிய திட்டமாகும், எனவே மேற்கூறியவை சிறிது நேரம் ஆகலாம் (உங்கள் இணைய வேகத்தைப் பொறுத்து 10 நிமிடங்கள் முதல் ஒரு மணி நேரம் வரை).

நீங்கள் குறியீட்டை விரைவாகப் பெற விரும்பினால், சமீபத்திய வெளியீட்டிற்கான மூலக் குறியீடு எப்போதும் ஒரு: வலைத்தளம்_பேஸ்: காப்பகம் <dist/src> ஆகக் கிடைக்கும்.

சமீபத்திய குறியீட்டிற்கு ஒரு கிளையைப் புதுப்பிக்க, கட்டளையைப் பயன்படுத்தவும்

git pull --no-edit

நீங்கள் `github <https://github.com/kovidgoyal/calibre> _ _ இல் குறியீட்டை உலாவலாம்.

சேர்க்கப்பட வேண்டிய உங்கள் மாற்றங்களை சமர்ப்பித்தல்

சில சிறிய மாற்றங்களைச் செய்ய மட்டுமே நீங்கள் திட்டமிட்டால், நீங்கள் உங்கள் மாற்றங்களைச் செய்து "ஒன்றிணைக்கும் உத்தரவை" உருவாக்கலாம், பின்னர் நீங்கள் காலிபரில் ஒரு டிக்கெட்டுடன் இணைக்கலாம் `பிழை டிராக்கர் <https://bugs.launchpad.net/calibre> `_. இதைச் செய்ய, உங்கள் மாற்றங்களைச் செய்யுங்கள், பின்னர் இயக்கவும்

git commit -am "Comment describing your changes"
git format-patch origin/master --stdout > my-changes

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

git format-patch HEAD~1 --stdout > my-changes

கடைசி *n *கமிட்டுகளை அனுப்ப, *1 *ஐ *n *உடன் மாற்றவும், எடுத்துக்காட்டாக, கடைசி 3 கமிட்டுகளுக்கு

git format-patch HEAD~3 --stdout > my-changes

`` தலை ~ n`` ஐப் பயன்படுத்தும் போது ஒன்றிணைவுகளைச் சேர்க்காமல் கவனமாக இருங்கள்.

காலிபரில் நிறைய வளர்ச்சியைச் செய்ய நீங்கள் திட்டமிட்டால், `கிட்ஹப் <https://github.com> __ __ கணக்கை உருவாக்குவதே சிறந்த முறை. முக்கிய காலிபர் களஞ்சியத்தில் சேர்ப்பதற்கான இழுப்பு கோரிக்கைகளை சமர்ப்பிக்க உங்களை அனுமதிக்கும் வகையில் உங்கள் சொந்த காலிபர் காலிபர் அமைப்பதற்கான ஒரு அடிப்படை வழிகாட்டி கீழே உள்ளது:

  • இந்த கட்டுரையில் விவரிக்கப்பட்டுள்ளபடி உங்கள் கணினியில் அமைவு git: setup git <https://help.github.com/articles/set-up-git> _

  • இங்கே விவரிக்கப்பட்டுள்ளபடி, கிட்ஹப்பிற்கான அங்கீகாரத்திற்கான SSH விசைகளை அமைக்கவும்: SSH விசைகளை உருவாக்குதல் <https://help.github.com/articles/generating-sh-keys> _

  • Https://github.com/kovidgoyal/calibre க்குச் சென்று: கிலாபெல்: ஃபோர்க் பொத்தானைக் கிளிக் செய்க.

  • ஒரு முனையத்தில்

    git clone git@github.com:<username>/calibre.git
git remote add upstream https://github.com/kovidgoyal/calibre.git

    மேலே <பயனர்பெயர்> ஐ உங்கள் கிதுப் பயனர்பெயருடன் மாற்றவும். அது உங்கள் முட்கரண்டி உள்நாட்டில் சரிபார்க்கப்படும்.

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

    git push

    ஒன்றிணைக்கக்கூடிய இழுப்பு கோரிக்கையை உருவாக்க `` https://github.com/ <பயனர்பெயர்>/காலிப்ரே`` க்குச் சென்று: கிலாபெல்: கோரிக்கை பொத்தானை இழுக்கவும்.

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

    git pull upstream

காலிபர் மேம்பாட்டு மன்றம் <https://www.mobileered.com/forums/forumdisplay.php?f=240> _ ஆகியவற்றிலும் நீங்கள் ஒரு கண் வைத்திருக்க வேண்டும். பெரிய மாற்றங்களைச் செய்வதற்கு முன், நீங்கள் அவற்றை மன்றத்தில் விவாதிக்க வேண்டும் அல்லது கோவிட் நேரடியாக தொடர்பு கொள்ள வேண்டும் (அவரது மின்னஞ்சல் முகவரி மூலக் குறியீட்டில் உள்ளது).

விண்டோஸ் மேம்பாட்டு சூழல்

Note

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

`விண்டோஸ் நிறுவி <https://calibre-ebook.com/download_windows> __ __ ஐப் பயன்படுத்தி காலிபரை சாதாரணமாக நிறுவவும். பின்னர் ஒரு கட்டளை வரியில் திறந்து முன்னர் சரிபார்க்கப்பட்ட காலிபர் குறியீடு கோப்புறைக்கு மாற்றவும். உதாரணத்திற்கு:

cd C:\Users\kovid\work\calibre

காலிபர் என்பது எஸ்.ஆர்.சி மற்றும் வளங்கள் துணை கோப்புறைகளைக் கொண்ட கோப்புறை.

அடுத்த கட்டம் சுற்றுச்சூழல் மாறியை `` calibre_develove_from`` ஐ SRC கோப்புறையின் முழுமையான பாதைக்கு அமைப்பது. எனவே, மேலே உள்ள உதாரணத்தைப் பின்பற்றி, இது `` சி: பயனர்கள் கோவிட் வேலை காலிபர் src``. இங்கே ஒரு குறுகிய வழிகாட்டி <https://docs.python.org/using/windows.html#excursus-setting- entronment-variables> _ விண்டோஸில் சுற்றுச்சூழல் மாறிகளை அமைப்பதற்கு.

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

echo %CALIBRE_DEVELOP_FROM%

இந்த சூழல் மாறியை அமைப்பது என்பது காலிபர் இப்போது அதன் அனைத்து பைதான் குறியீட்டையும் குறிப்பிட்ட இடத்திலிருந்து ஏற்றும்.

அவ்வளவுதான்! காலிபர் குறியீட்டை ஹேக்கிங் செய்ய நீங்கள் இப்போது தயாராக உள்ளீர்கள். எடுத்துக்காட்டாக, கோப்பைத் திறக்கவும்: கோப்பு: src \ caliber __ init __. Py உங்களுக்கு பிடித்த எடிட்டரில் மற்றும் வரியைச் சேர்க்கவும்

print("Hello, world!")

கோப்பின் மேற்புறத்திற்கு அருகில். இப்போது கட்டளையை இயக்கவும்: கட்டளை: calibredb. வெளியீட்டின் முதல் வரி `` ஹலோ, உலகமாக இருக்க வேண்டும்! ``.

இலவச மைக்ரோசாஃப்ட் விஷுவல் ஸ்டுடியோவுக்குள் ஒரு காலிபர் மேம்பாட்டு சூழலை நீங்கள் அமைக்கலாம், நீங்கள் விரும்பினால், இங்கே <https://www.mobileered.com/forums/showthread.php?t=251201> `_.

MACOS மேம்பாட்டு சூழல்

Note

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

`வழங்கப்பட்ட .dmg <https://calibre-ebook.com/download_osx> __ __ ஐப் பயன்படுத்தி பொதுவாக காலிபரை நிறுவவும். பின்னர் ஒரு முனையத்தைத் திறந்து, முன்னர் சரிபார்க்கப்பட்ட காலிபர் குறியீடு கோப்புறையில் மாற்றவும், எடுத்துக்காட்டாக

cd /Users/kovid/work/calibre

காலிபர் என்பது எஸ்.ஆர்.சி மற்றும் வளங்கள் துணை கோப்புறைகளைக் கொண்ட கோப்புறை. காலிபர் கட்டளை வரி கருவிகள் காலிபர் பயன்பாட்டு மூட்டைக்குள் காணப்படுகின்றன, இல்: கோப்பு: //////calibre.app/பொருளடக்கம்/மேகோஸ் இந்த கோப்புறையை உங்கள் பாதை சூழல் மாறியில் சேர்க்க வேண்டும், நீங்கள் கட்டளை வரி கருவிகளை எளிதாக இயக்க விரும்பினால் .

அடுத்த கட்டம், பிழைத்திருத்த பயன்முறையில் காலிபரை இயக்கும் போது சுற்றுச்சூழல் மாறியை `` calibre_develove_from`` ஐ SRC கோப்புறையின் முழுமையான பாதைக்கு அமைக்கும் ஒரு பாஷ் ஸ்கிரிப்டை உருவாக்குவது.

எளிய உரை கோப்பை உருவாக்கவும்

#!/bin/sh
export CALIBRE_DEVELOP_FROM="/Users/kovid/work/calibre/src"
calibre-debug -g

இந்த கோப்பை இவ்வாறு சேமிக்கவும்: கோப்பு: //usr/local/bin/calibre-develop, பின்னர் அதன் அனுமதிகளை அமைக்கவும், அதை செயல்படுத்த முடியும்

chmod +x /usr/local/bin/calibre-develop

நீங்கள் இதைச் செய்தவுடன், ஓடு

calibre-develop

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

லினக்ஸ் மேம்பாட்டு சூழல்

Note

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

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

`பைனரி நிறுவி <https://calibre-ebook.com/download_linux> _ _ ஐப் பயன்படுத்தி காலிபரை நிறுவவும். பின்னர் ஒரு முனையத்தைத் திறந்து, முன்னர் சரிபார்க்கப்பட்ட காலிபர் குறியீடு கோப்புறையில் மாற்றவும், எடுத்துக்காட்டாக

cd /home/kovid/work/calibre

காலிபர் என்பது எஸ்.ஆர்.சி மற்றும் வளங்கள் துணை கோப்புறைகளைக் கொண்ட கோப்புறை.

அடுத்த கட்டம் சுற்றுச்சூழல் மாறியை `` calibre_develove_from`` ஐ SRC கோப்புறையின் முழுமையான பாதைக்கு அமைப்பது. எனவே, மேலே உள்ள உதாரணத்தைப் பின்பற்றி, அது /வீட்டு/கோவிட்/வேலை/காலிபர்/எஸ்.ஆர்.சி. சுற்றுச்சூழல் மாறிகளை எவ்வாறு அமைப்பது என்பது உங்கள் லினக்ஸ் விநியோகம் மற்றும் நீங்கள் எந்த ஷெல் பயன்படுத்துகிறீர்கள் என்பதைப் பொறுத்தது.

Note

அப்ஸ்ட்ரீமில் இருந்து வழங்கப்பட்ட பைனரி நிறுவியைப் பயன்படுத்த பரிந்துரைக்கப்படுகிறது. உங்கள் விநியோகத்தால் வழங்கப்பட்ட ஒரு தொகுப்பைப் பயன்படுத்த நீங்கள் வற்புறுத்த வேண்டுமா, அதற்கு பதிலாக `` calibre_python_path`` மற்றும் `` calibre_resources_path`` ஆகியவற்றைப் பயன்படுத்தவும்.

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

echo $CALIBRE_DEVELOP_FROM

இந்த சூழல் மாறியை அமைப்பது என்பது காலிபர் இப்போது அதன் அனைத்து பைதான் குறியீட்டையும் குறிப்பிட்ட இடத்திலிருந்து ஏற்றும்.

அவ்வளவுதான்! காலிபர் குறியீட்டை ஹேக்கிங் செய்ய நீங்கள் இப்போது தயாராக உள்ளீர்கள். எடுத்துக்காட்டாக, கோப்பைத் திறக்கவும்: கோப்பு: src/caliber/__ init __. Py உங்களுக்கு பிடித்த எடிட்டரில் மற்றும் வரியைச் சேர்க்கவும்

print("Hello, world!")

கோப்பின் மேற்புறத்திற்கு அருகில். இப்போது கட்டளையை இயக்கவும்: கட்டளை: calibredb. வெளியீட்டின் முதல் வரி `` ஹலோ, உலகமாக இருக்க வேண்டும்! ``.

ஒரே கணினியில் தனி "இயல்பான" மற்றும் "மேம்பாட்டு" காலிபர் நிறுவுகிறது

காலிபர் மூல மரம் மிகவும் நிலையானது மற்றும் அரிதாகவே உடைகிறது, ஆனால் ஒரு தனி சோதனை நூலகத்தில் மூலத்திலிருந்து ஓடி வெளியிடப்பட்ட காலிபர் பதிப்பை உங்கள் அன்றாட நூலகத்துடன் இயக்க வேண்டிய அவசியத்தை நீங்கள் உணர்ந்தால், இதை எளிதாகப் பயன்படுத்தி .bat கோப்புகள் அல்லது ஷெல் ஸ்கிரிப்ட்களை நீங்கள் எளிதாக அடையலாம் காலிபரைத் தொடங்கவும். .BAT கோப்புகளைப் பயன்படுத்தி விண்டோஸில் இதை எவ்வாறு செய்வது என்பதை கீழே உள்ள எடுத்துக்காட்டு காட்டுகிறது (பிற தளங்களுக்கான வழிமுறைகள் ஒரே மாதிரியானவை, .BAT கோப்பிற்கு பதிலாக ஷெல் ஸ்கிரிப்டைப் பயன்படுத்தவும்)

உங்கள் அன்றாட நூலகத்துடன் காலிபரின் வெளியீட்டு பதிப்பைத் தொடங்க:

calibre-normal.bat

calibre.exe "--with-library=C:\path\to\everyday\library folder"

calibre-dev.bat

set CALIBRE_DEVELOP_FROM=C:\path\to\calibre\checkout\src
calibre.exe "--with-library=C:\path\to\test\library folder"

பிழைத்திருத்த உதவிக்குறிப்புகள்

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

அச்சு அறிக்கைகளைப் பயன்படுத்துதல்

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

calibre-debug -g

இதேபோல், நீங்கள் மின் புத்தக பார்வையாளரைத் தொடங்கலாம்

calibre-debug -w /path/to/file/to/be/viewed

மின் புத்தக எடிட்டரைத் தொடங்கலாம்

calibre-debug --edit-book /path/to/be/edited

ஊடாடும் பைதான் மொழிபெயர்ப்பாளரைப் பயன்படுத்துதல்

அந்த நேரத்தில் ஒரு ஊடாடும் பைதான் அமர்வைத் தொடங்க பின்வரும் இரண்டு வரிகளை நீங்கள் செருகலாம்

from calibre import ipython
ipython(locals())

கட்டளை வரியிலிருந்து இயங்கும் போது, இது உள்நாட்டில் வரையறுக்கப்பட்ட அனைத்து மாறிகள் (உள்ளூர் நோக்கத்தில் மாறிகள்) அணுகலுடன் ஒரு ஊடாடும் பைதான் மொழிபெயர்ப்பாளரைத் தொடங்கும். ஊடாடும் வரியில் கூட: KBD: தாவல் பொருள் பண்புகளுக்கான நிறைவு மற்றும் நீங்கள் பல்வேறு பைதான் வசதிகளை உள்நோக்கத்திற்கு பயன்படுத்தலாம்: func:` dir`,: func: type,: func:` repr`, போன்றவை .

பைதான் பிழைத்திருத்தியை தொலை பிழைத்திருத்தியாகப் பயன்படுத்துதல்

கட்டளை வரியிலிருந்து தொலைநிலை பிழைத்திருத்தியாக பில்டின் பைதான் பிழைத்திருத்தியை (பி.டி.பி) பயன்படுத்தலாம். முதலில், நீங்கள் ஆர்வமுள்ள காலிபர் குறியீட்டின் புள்ளியில் தொலை பிழைத்திருத்தியைத் தொடங்கவும், இது போன்றது

from calibre.rpdb import set_trace
set_trace()

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

இப்போது ஒரு முனையம் அல்லது கட்டளை வரியில் திறந்து பிழைத்திருத்த அமர்வைத் தொடங்க பின்வரும் கட்டளையைப் பயன்படுத்தவும்

calibre-debug -c "from calibre.rpdb import cli; cli()"

PDB தொகுதிக்கான `பைதான் ஸ்ட்ட்லிப் டாக்ஸில் பைதான் பிழைத்திருத்தியை எவ்வாறு பயன்படுத்துவது என்பது பற்றி நீங்கள் படிக்கலாம்

Note

இயல்பாக, தொலை பிழைத்தவர் போர்ட் 4444 இல் இணைக்க முயற்சிக்கும். போர்ட் அளவுருவை SET_TRACE () மற்றும் மேலே உள்ள CLI () செயல்பாடுகள் இரண்டிற்கும் அனுப்புவதன் மூலம் அதை மாற்றலாம்: `` set_trace (போர்ட் = 1234) ` மற்றும் கிளீ (போர்ட் = 1234) `.

Note

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

உங்களுக்கு பிடித்த பைதான் IDE இல் பிழைத்திருத்தத்தைப் பயன்படுத்துதல்

தொலைநிலை பிழைத்திருத்தத்தை ஆதரித்தால், உங்களுக்கு பிடித்த பைதான் ஐடிஇயில் பில்டின் பிழைத்திருத்தியைப் பயன்படுத்த முடியும். முதல் படி, உங்கள் IDE இல் `` பைதன்பாத்`` இல் காலிபர் எஸ்.ஆர்.சி புதுப்பித்தலைச் சேர்ப்பது. வேறு வார்த்தைகளில் கூறுவதானால், மேலே உள்ள `` calibre_developer_from`` என நீங்கள் அமைத்த கோப்புறை, உங்கள் IDE இன் `` பைதன்பாத்`` இல் இருக்க வேண்டும்.

பின்னர் IDE இன் ரிமோட் பிழைத்திருத்த தொகுதியை: கோப்பு: SRC காலிபர் மூலக் குறியீடு புதுப்பித்தலின் துணை நட்பாளர். தொலைதூர பிழைத்திருத்தியை ஆர்வமுள்ள நேரத்தில் திறந்து வைப்பதற்குத் தேவையான குறியீட்டைச் சேர்க்கவும், எடுத்துக்காட்டாக முக்கிய செயல்பாட்டில். பின்னர் காலிபரை சாதாரணமாக இயக்கவும். உங்கள் ஐடிஇ இப்போது காலிபருக்குள் இயங்கும் தொலை பிழைத்திருத்தத்துடன் இணைக்க முடியும்.

காலிபர் பைதான் சூழலில் தன்னிச்சையான ஸ்கிரிப்ட்களை இயக்குதல்

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

calibre-debug -c "some Python code"

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

calibre-debug myscript.py

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

calibre-debug myscript.py -- --option1 arg1

`` --`` உங்கள் ஸ்கிரிப்டுக்கு அடுத்தடுத்த அனைத்து வாதங்களையும் அனுப்புகிறது.

உங்கள் திட்டங்களில் திறனைப் பயன்படுத்துதல்

உங்கள் பைதான் திட்டத்தில் காலிபர் செயல்பாடுகள்/குறியீட்டை நேரடியாகப் பயன்படுத்த முடியும். இதைச் செய்ய இரண்டு வழிகள் உள்ளன:

காலிபரின் பைனரி நிறுவல்

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

calibre-debug /path/to/your/python/script.py -- arguments to your script

லினக்ஸில் மூல நிறுவல்

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

import init_calibre
import calibre

print(calibre.__version__)

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

காலிபரின் பல்வேறு பகுதிகளுக்கான ஏபிஐ ஆவணங்கள்