1. "ஒரு புத்தகத்தை எளிதாகப் பதிவிறக்குவதற்கான இணைப்பு" என்பது எப்போதும் ஒரு*இலவச* புத்தகத்திற்கான இணைப்பு அல்ல. தயவுசெய்து இலவச உள்ளடக்கத்தை மட்டுமே பங்களிக்கவும். அது இலவசம் என்பதை உறுதிப்படுத்திக் கொள்ளுங்கள். புத்தகங்களைப் பெறுவதற்கு*வேலை செய்யும் மின்னஞ்சல் முகவரிகள் தேவைப்படும்* பக்கங்களுக்கான இணைப்புகளை நாங்கள் ஏற்கவில்லை, ஆனால் அவற்றைக் கோரும் பட்டியல்களை நாங்கள் வரவேற்கிறோம்.
2. நீங்கள் Git ஐ அறிய வேண்டியதில்லை: இந்த ரெப்போவில் ஏற்கனவே இல்லாத ஆர்வமுள்ள ஒன்றை நீங்கள் கண்டால், தயவுசெய்து ஒரு [Issue](https://github.com/EbookFoundation/free-programming-books/issues) உங்கள் இணைப்புகள் முன்மொழிவுகளுடன் உருவாக்கவும்.
3. எங்களிடம் 6 வகையான பட்டியல்கள் உள்ளன. சரியான ஒன்றைத் தேர்ந்தெடுக்கவும்:
- *புத்தகங்கள்*: PDF, HTML, ePub, ஒரு gitbook.io அடிப்படையிலான தளம், ஒரு Git Repo, போன்றவை.
- *பாடநெறிகள்*: ஒரு பாடநெறி என்பது ஒரு கற்றல் பொருள், அது ஒரு புத்தகம் அல்ல. [இது ஒரு பாடநெறி](http://ocw.mit.edu/cours/electrical-engineering-and-computer-science/6-006-introduction-to-algorithms-fall-2011/)
- *ஊடாடும் பயிற்சிகள்*: பயனர் குறியீடு அல்லது கட்டளைகளை தட்டச்சு செய்ய அனுமதிக்கும் ஒரு ஊடாடும் வலைத்தளம் மற்றும் முடிவை மதிப்பீடு செய்கிறது ("மதிப்பீடு" மூலம் நாங்கள் "தரம்" என்று அர்த்தமல்ல). எடுத்துக்காட்டுக்கு: [Haskell ஐ முயற்சிக்கவும்](http://tryhaskell.org), [Try Git](https://learngitbranching.js.org)
- *விளையாட்டு மைதானங்கள்*: நிரலாக்கத்தைக் கற்றுக்கொள்வதற்கான ஆன்லைன் மற்றும் ஊடாடும் வலைத்தளங்கள், விளையாட்டுகள் அல்லது டெஸ்க்டாப் மென்பொருள். குறியீடு துணுக்குகளை எழுதுங்கள், தொகுக்கவும் (அல்லது இயக்கவும்) மற்றும் பகிரவும். விளையாட்டு மைதானங்கள் பெரும்பாலும் குறியீட்டைக் கொண்டு விளையாடுவதன் மூலம் உங்கள் கைகளை அழுக்குபடுத்த அனுமதிக்கின்றன.
- *பாட்காஸ்ட்கள் மற்றும் திரைக்கதைகள்*: பாட்காஸ்ட்கள் மற்றும் திரைக்கதைகள்.
- *சிக்கல் அமைப்புகள் மற்றும் போட்டி நிரலாக்கம்*: குறியீடு மதிப்பாய்வுடன் அல்லது இல்லாமல், மற்ற பயனர்களுடன் முடிவுகளை ஒப்பிடுவதன் மூலமோ அல்லது இல்லாமல், எளிய அல்லது சிக்கலான சிக்கல்களைத் தீர்ப்பதன் மூலம் உங்கள் நிரலாக்க திறன்களை மதிப்பீடு செய்ய உதவும் வலைத்தளம் அல்லது மென்பொருள்.
6. உங்கள் பட்டியல்கள்*வெளியீடு* மற்றும்*வடிவமைத்தல் விதிகள்* பின்பற்றப்படுகின்றன என்பதை உறுதிப்படுத்த கிட்ஹப் செயல்கள் சோதனைகளை இயக்கும். **உங்கள் மாற்றங்கள் சோதனைகளில் தேர்ச்சி பெற்றுள்ளனவா** என்பதை உறுதிப்படுத்திக் கொள்ளுங்கள்.
- ஒரு புத்தகம் இலவசம் என்பதை உறுதிப்படுத்திக் கொள்ளுங்கள். தேவைப்பட்டால் இருமுறை சரிபார்க்கவும். புத்தகம் இலவசம் என்று நீங்கள் ஏன் நினைக்கிறீர்கள் என்று PR இல் கருத்து தெரிவித்தால் அது நிர்வாகிகளுக்கு உதவுகிறது.
- Google Drive, Dropbox, Mega, Scribd, Issuu மற்றும் பிற ஒத்த கோப்பு பதிவேற்ற தளங்களில் ஹோஸ்ட் செய்யப்பட்ட கோப்புகளை நாங்கள் ஏற்க மாட்டோம்.
- [கீழே](#alphabetical-order) விவரிக்கப்பட்டுள்ளபடி உங்கள் இணைப்புகளை அகர வரிசைப்படி செருகவும்.
- மிகவும் அதிகாரப்பூர்வமான மூலத்துடன் இணைப்பைப் பயன்படுத்தவும் (அதாவது, ஆசிரியரின் வலைத்தளம் மூன்றாம் தரப்பு வலைத்தளத்தை விட சிறந்தது).
- கோப்பு ஹோஸ்டிங் சேவைகள் இல்லை (இதில் டிராப்பாக்ஸ் மற்றும் கூகிள் டிரைவ் இணைப்புகள் அடங்கும், ஆனால் அவை மட்டுமல்ல).
- எப்போதும் ஒரு 'http' இணைப்பை விட ஒரு 'https' இணைப்பை விரும்பவும்—அவை ஒரே டொமைனில் இருக்கும் வரை மற்றும் அதே உள்ளடக்கத்தை வழங்கும் வரை.
- ரூட் டொமைன்களில், பின்தங்கிய ஸ்லாஷை அகற்றவும்: 'http://example.com/' என்பதற்கு பதிலாக 'http://example.com'.
- எப்போதும் குறுகிய இணைப்பை விரும்புங்கள்: 'http://example.com/dir/' என்பது 'http://example.com/dir/index.html' ஐ விட சிறந்தது.
- URL குறுக்கு இணைப்புகள் (shortened URLs) இல்லை.
- வழக்கமாக "பதிப்பு" ஒன்றுக்கு மேல் "தற்போதைய" இணைப்பை விரும்புங்கள்: 'http://example.com/dir/book/current/' என்பது 'http://example.com/dir/book/v1.0.0/index.html' ஐ விட சிறந்தது.
- ஒரு இணைப்பில் காலாவதியான சான்றிதழ்/சுய கையொப்பமிடப்பட்ட சான்றிதழ்/SSL பிரச்சினை வேறு ஏதேனும் இருந்தால்:
1.*முடிந்தால்*, அதை 'http' உடன் மாற்றவும் (because accepting exceptions can be complicated on mobile devices).
2. 'http' பதிப்பு கிடைக்கவில்லை என்றால், உலாவியில் ஒரு விதிவிலக்கைச் சேர்ப்பதன் மூலமோ அல்லது எச்சரிக்கையை புறக்கணிப்பதன் மூலமோ 'https' மூலம் இணைப்பை இன்னும் அணுகலாம்.
3.*அதை அகற்றவும்* இல்லையெனில்.
- ஒரு இணைப்பு பல வடிவங்களில் இருந்தால், ஒவ்வொரு வடிவத்தைப் பற்றிய குறிப்புடன் ஒரு தனி இணைப்பைச் சேர்க்கவும்.
- இணையத்தில் வெவ்வேறு இடங்களில் ஒரு வளம் இருந்தால்—மிகவும் அதிகாரப்பூர்வமான மூலத்துடன் இணைப்பைப் பயன்படுத்தவும் (மூன்றாம் தரப்பு வலைத்தளத்தை விட ஆசிரியரின் வலைத்தளம் சிறந்தது).
- அவை வெவ்வேறு பதிப்புகளுடன் இணைக்கப்பட்டிருந்தால், இந்த பதிப்புகள் அவற்றை வைத்திருப்பதற்கு போதுமானதாக இருக்கும் என்று நீங்கள் தீர்மானித்தால், ஒவ்வொரு பதிப்பையும் பற்றிய குறிப்புடன் ஒரு தனி இணைப்பைச் சேர்க்கவும் (பார்க்கவும் [வெளியீடு #2353](https://github.com/EbookFoundation/free-programming-books/issues/2353) வடிவமைத்தல் குறித்த விவாதத்திற்கு பங்களிக்க).
- பெரிய கமிட்களை விட அணு கமிட்களை (ஒன்று கூட்டல்/நீக்குதல்/மாற்றியமைப்பதன் மூலம்) விரும்புங்கள். ஒரு PR சமர்ப்பிப்பதற்கு முன் உங்கள் கடமைகளை squash செய்ய வேண்டிய அவசியமில்லை. (இந்த விதியை நாங்கள் ஒருபோதும் அமல்படுத்த மாட்டோம், ஏனெனில் இது பராமரிப்பாளர்களின் வசதிக்காக மட்டுமே).
- புத்தகம் பழையதாக இருந்தால், வெளியீட்டு தேதியை தலைப்புடன் சேர்க்கவும்.
- பொருத்தமான இடங்களில் ஆசிரியரின் பெயர் அல்லது பெயர்களைச் சேர்க்கவும். நீங்கள் ஆசிரியர் பட்டியல்களை 'மற்றும் பலர்' என்று சுருக்கலாம்.
- புத்தகம் முடிக்கப்படவில்லை என்றால், இன்னும் வேலை செய்யப்பட்டு வருகிறது, [கீழே](#in_process) விவரிக்கப்பட்டுள்ளபடி 'செயல்பாட்டில்' குறியீட்டைச் சேர்க்கவும்.
- [*Internet Archive's Wayback Machine*](https://web.archive.org) (அல்லது ஒத்த) ஐப் பயன்படுத்தி ஒரு வளத்தை மீட்டெடுத்தால், [கீழே](#archived) விவரிக்கப்பட்டுள்ளபடி 'காப்பகப்படுத்தப்பட்ட' குறியீட்டைச் சேர்க்கவும். பயன்படுத்த சிறந்த பதிப்புகள் சமீபத்தியவை மற்றும் முழுமையானவை.
- பதிவிறக்கம் செயல்படுத்தப்படுவதற்கு முன்பு ஒரு மின்னஞ்சல் முகவரி அல்லது கணக்கு அமைப்பு கோரப்பட்டால், அடைப்புக்குறிக்குள் மொழி-பொருத்தமான குறிப்புகளைச் சேர்க்கவும், e.g.: '(மின்னஞ்சல் முகவரி*கோரப்பட்டது*, தேவையில்லை)'.
- அனைத்து பட்டியல்களும் '.md' கோப்புகள். [Markdown](https://guides.github.com/features/mastering-markdown/) தொடரியல் கற்க முயற்சிக்கவும். அது எளிது!
- அனைத்து பட்டியல்களும் ஒரு குறியீட்டுடன் தொடங்குகின்றன. அனைத்து பிரிவுகளையும் உட்பிரிவுகளையும் அங்கு பட்டியலிட்டு இணைப்பதே யோசனை. அதை அகர வரிசைப்படி வைத்திருங்கள்.
- பிரிவுகள் நிலை 3 தலைப்புகளைப் பயன்படுத்துகின்றன ('###') மற்றும் உட்பிரிவுகள் நிலை 4 தலைப்புகள் ('####').
- பல வடிவங்கள் (ஒவ்வொரு வளத்திற்கும் ஒரு இணைப்பை நாங்கள் விரும்புகிறோம். வெவ்வேறு வடிவங்களுக்கு எளிதாக அணுகக்கூடிய ஒற்றை இணைப்பு இல்லாதபோது, பல இணைப்புகள் அர்த்தமுள்ளதாக இருக்கலாம். ஆனால் நாம் சேர்க்கும் ஒவ்வொரு இணைப்பும் பராமரிப்பு சுமையை உருவாக்குகிறது, எனவே அதைத் தவிர்க்க முயற்சிக்கிறோம்):
- உரை நல்லது* [ஒரு வழி ஆதரவு சுவாரஸ்யமான புத்தகம்](https://web.archive.org/web/20211016123456/http://example.com/) - John Doe (HTML) * (: card _ file _ box: archived)
- ஒரே எழுத்தில் தொடங்கி பல தலைப்புகள் இருக்கும்போது, அவற்றை இரண்டாவது வரிசையில் வரிசைப்படுத்துங்கள். எடுத்துக்காட்டாக, 'ஆ' என்பது 'அப்' என்பதற்கு முன்பு வருகிறது.
அடிப்படைகள் ஒப்பீட்டளவில் எளிமையானவை என்றாலும், நாம் பட்டியலிடும் வளங்களில் பெரும் பன்முகத்தன்மை உள்ளது. இந்த பன்முகத்தன்மையை நாம் எவ்வாறு கையாளுகிறோம் என்பதற்கான சில குறிப்புகள் இங்கே.
- கண்டுபிடிக்கப்பட்ட தலைப்புகள் எதுவும் இல்லை. வளங்களிலிருந்தே தலைப்புகளை எடுக்க முயற்சிக்கிறோம்; இதைத் தவிர்க்க முடிந்தால், தலைப்புகளைக் கண்டுபிடிக்கவோ அல்லது தலையங்கமாகப் பயன்படுத்தவோ வேண்டாம் என்று பங்களிப்பாளர்கள் அறிவுறுத்தப்படுகிறார்கள். பழைய படைப்புகளுக்கு ஒரு விதிவிலக்கு உள்ளது; அவை முதன்மையாக வரலாற்று ஆர்வத்தைக் கொண்டிருந்தால், தலைப்புடன் இணைக்கப்பட்ட அடைப்புக்குறிக்குள் ஒரு வருடம் பயனர்களுக்கு அவர்கள் ஆர்வமாக உள்ளார்களா என்பதை அறிய உதவுகிறது.
- ALLCAPS தலைப்புகள் இல்லை. வழக்கமாக தலைப்பு வழக்கு பொருத்தமானது, ஆனால் சந்தேகம் இருக்கும்போது மூலத்திலிருந்து மூலதனத்தைப் பயன்படுத்தவும். ஈமோஜிகள் இல்லை.
- மொழிபெயர்க்கப்பட்ட படைப்புகளுக்கு அசல் எழுத்தாளரைப் பாராட்ட வேண்டும். இந்த எடுத்துக்காட்டில் உள்ளபடி, ஆசிரியர்களைத் தவிர கடன் படைப்பாளர்களுக்கு [MARC ரிலேட்டர்கள்](https://loc.gov/marc/relators/relaterm.html) பயன்படுத்த பரிந்துரைக்கிறோம்.
இங்கே, சிறுகுறிப்பு 'trl. : 'மொழிபெயர்ப்பாளருக்கு MARC ரிலேட்டர் குறியீட்டைப் பயன்படுத்துகிறது.
- ஆசிரியர் பட்டியலில் உள்ள ஒவ்வொரு உருப்படியையும் வரையறுக்க கமா ',' ஐப் பயன்படுத்தவும்.
- நீங்கள் ஆசிரியர் பட்டியல்களை 'மற்றும் பலர்' என்று சுருக்கலாம்.
- படைப்பாளர்களுக்கான இணைப்புகளை நாங்கள் அனுமதிக்கவில்லை.
- தொகுப்பு அல்லது ரீமிக்ஸ் செய்யப்பட்ட படைப்புகளுக்கு, "படைப்பாளருக்கு" ஒரு விளக்கம் தேவைப்படலாம். எடுத்துக்காட்டாக, "கோல்பிக்கர்" அல்லது "ஆர்ஐபி டுடோரியல்" புத்தகங்கள் "ஸ்டேக்ஓவர்ஃப்ளோ ஆவணங்களிலிருந்து தொகுக்கப்பட்டவை" என்று வரவு வைக்கப்படுகின்றன.
- படைப்பாளர்களின் பெயர்களில் "பேராசிரியர்" அல்லது "டாக்டர்" போன்ற கெளரவப் பெயர்களை நாங்கள் சேர்க்கவில்லை.
- படிப்புகள். குறிப்பாக எங்கள் பாடநெறி பட்டியல்களுக்கு, தளம் வள விளக்கத்தின் ஒரு முக்கிய பகுதியாகும். ஏனென்றால், பாடநெறி தளங்கள் வெவ்வேறு செலவுகள் மற்றும் அணுகல் மாதிரிகளைக் கொண்டுள்ளன. பதிவு தேவைப்படும் ஒரு புத்தகத்தை நாங்கள் வழக்கமாக பட்டியலிட மாட்டோம் என்றாலும், பல பாடநெறி தளங்களில் ஒருவித கணக்கு இல்லாமல் வேலை செய்யாத செலவுகள் உள்ளன. எடுத்துக்காட்டு பாடநெறி தளங்களில் Coursera, EdX, Udacity மற்றும் Udemy ஆகியவை அடங்கும். ஒரு பாடத்திட்டம் ஒரு தளத்தை சார்ந்து இருக்கும்போது, தளத்தின் பெயர் அடைப்புக்குறிக்குள் பட்டியலிடப்பட வேண்டும்.
- யூடியூப் யூடியூப் பிளேலிஸ்ட்களைக் கொண்ட பல படிப்புகள் எங்களிடம் உள்ளன. நாங்கள் யூடியூப்பை ஒரு தளமாக பட்டியலிடவில்லை, யூடியூப் படைப்பாளரை பட்டியலிட முயற்சிக்கிறோம், இது பெரும்பாலும் துணை தளமாகும். யூடியூப் வீடியோக்கள். நாங்கள் வழக்கமாக தனிப்பட்ட யூடியூப் வீடியோக்களுடன் இணைக்க மாட்டோம், அவை ஒரு மணி நேரத்திற்கு மேல் நீளம் கொண்டவை மற்றும் ஒரு பாடநெறி அல்லது பயிற்சி போல கட்டமைக்கப்படாவிட்டால். அப்படியானால், பி. ஆர் விளக்கத்தில் அதைக் குறிப்பிடுவதை உறுதிப்படுத்திக் கொள்ளுங்கள்.
- லீன்பப். லீன்பப் பல்வேறு அணுகல் மாதிரிகளுடன் புத்தகங்களை வழங்குகிறது. சில நேரங்களில் ஒரு புத்தகத்தை பதிவு செய்யாமல் படிக்கலாம்; சில நேரங்களில் ஒரு புத்தகத்திற்கு இலவச அணுகலுக்கு லீன்பப் கணக்கு தேவைப்படுகிறது. புத்தகங்களின் தரம் மற்றும் Leanpub அணுகல் மாதிரிகளின் கலவை மற்றும் திரவத்தன்மை ஆகியவற்றைக் கருத்தில் கொண்டு, '* (Leanpub கணக்கு அல்லது செல்லுபடியாகும் மின்னஞ்சல் கோரப்பட்டது) *' என்ற அணுகல் குறிப்புடன் பிந்தையதை பட்டியலிட அனுமதிக்கிறோம்.
ஒரு வளம் எந்த பட்டியலுக்குச் சொந்தமானது என்பதைத் தீர்மானிப்பதற்கான முதல் விதி, வளம் தன்னை எவ்வாறு விவரிக்கிறது என்பதைப் பார்ப்பதாகும். அது தன்னை ஒரு புத்தகம் என்று அழைத்தால், அது ஒரு புத்தகமாக இருக்கலாம்.
- பாடங்கள் அல்லது திரைக்காட்சிகள் அல்லாத வீடியோக்கள்.
- புத்தக அத்தியாயங்கள்
- புத்தகங்களிலிருந்து டீஸர் மாதிரிகள்
- ஐஆர்சி அல்லது டெலிகிராம் சேனல்கள்
- ஸ்லாக்ஸ் அல்லது அஞ்சல் பட்டியல்கள்
எங்கள் போட்டி நிரலாக்க பட்டியல்கள் இந்த விலக்குகளைப் பற்றி அவ்வளவு கண்டிப்பானவை அல்ல. ரெப்போவின் நோக்கம் சமூகத்தால் தீர்மானிக்கப்படுகிறது; நீங்கள் ஒரு மாற்றத்தை அல்லது நோக்கத்துடன் கூடுதலாக பரிந்துரைக்க விரும்பினால், தயவுசெய்து ஆலோசனையைச் செய்ய ஒரு சிக்கலைப் பயன்படுத்தவும்.
சில நேரங்களில் இவற்றை வேறுபடுத்துவது கடினமாக இருக்கலாம்!
படிப்புகள் பெரும்பாலும் தொடர்புடைய பாடப்புத்தகங்களைக் கொண்டுள்ளன, அவற்றை நாங்கள் எங்கள் புத்தகப் பட்டியல்களில் பட்டியலிடுவோம். படிப்புகளில் விரிவுரைகள், பயிற்சிகள், சோதனைகள், குறிப்புகள் அல்லது பிற போதனை உதவிகள் உள்ளன. ஒரு சொற்பொழிவு அல்லது வீடியோ என்பது ஒரு பாடநெறி அல்ல. ஒரு பவர்பாயிண்ட் ஒரு பாடநெறி அல்ல.
- வடிவமைப்பு விதிகள் அமலாக்கம் [GitHub Actions](https://github.com/features/action) வழியாக தானியங்கி செய்யப்படுகிறது [fpb-lint](https://github.com/vhf/free-programming-books-lint) ஐப் பயன்படுத்தி (பார்க்க [`.github/workflows/fpb-lint.yml`](../.github/workflows/fpb-lint.yml)).
- URL சரிபார்ப்பு [amazing_bot](https://github.com/dkamsing/awesome_bot) ஐ பயன்படுத்துகிறது.
- URL சரிபார்ப்பைத் தூண்டுவதற்கு, 'check_urls = file_to_check' ஐக் கொண்ட ஒரு கமிட் செய்தியை உள்ளடக்கிய ஒரு கமிட்டை அழுத்தவும்:
- நீங்கள் ஒன்றுக்கு மேற்பட்ட கோப்புகளைக் குறிப்பிட்டால், கட்டமைப்பின் முடிவுகள் கடைசியாக சரிபார்க்கப்பட்ட கோப்பின் முடிவை அடிப்படையாகக் கொண்டவை. இதன் காரணமாக நீங்கள் பசுமை கட்டமைப்புகளைப் பெறலாம் என்பதை நீங்கள் அறிந்திருக்க வேண்டும், எனவே "அனைத்து காசோலைகளையும் காட்டு" -> "விவரங்கள்" என்பதைக் கிளிக் செய்வதன் மூலம் புல் கோரிக்கையின் முடிவில் உள்ள பில்ட் பதிவை ஆய்வு செய்ய மறக்காதீர்கள்.
