From b18fc5bf4568a80f11a1185536b0a8f8a1562afc Mon Sep 17 00:00:00 2001 From: Ritika Date: Thu, 3 Oct 2024 22:57:25 +0530 Subject: [PATCH 1/3] Add CONTRIBUTING-ta.md --- docs/CONTRIBUTING-ta.md | 231 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 231 insertions(+) create mode 100644 docs/CONTRIBUTING-ta.md diff --git a/docs/CONTRIBUTING-ta.md b/docs/CONTRIBUTING-ta.md new file mode 100644 index 000000000..cfbef51c5 --- /dev/null +++ b/docs/CONTRIBUTING-ta.md @@ -0,0 +1,231 @@ +* [இதை மற்ற மொழிகளில் படிக்கவும்] (README.md #translations) * + + +#பங்களிப்பாளர் உரிம ஒப்பந்தம் + +பங்களிப்பதன் மூலம், இந்த களஞ்சியத்தின் உரிமத்திற்கு (../உரிமம்) நீங்கள் ஒப்புக்கொள்கிறீர்கள். + + +#பங்களிப்பாளர் நடத்தை விதிகள் + +பங்களிப்பதன் மூலம், இந்த களஞ்சியத்தின் [நடத்தை விதிகளை] (CODE_OF_CONDUCT.md) மதிக்க ஒப்புக்கொள்கிறீர்கள். ([மொழிபெயர்ப்புகள்] (README.md #translations)) + + +#சுருக்கமாக + +1. "ஒரு புத்தகத்தை எளிதாகப் பதிவிறக்குவதற்கான இணைப்பு" என்பது எப்போதும் ஒரு * இலவச * புத்தகத்திற்கான இணைப்பு அல்ல. தயவுசெய்து இலவச உள்ளடக்கத்தை மட்டுமே பங்களிக்கவும். அது இலவசம் என்பதை உறுதிப்படுத்திக் கொள்ளுங்கள். புத்தகங்களைப் பெறுவதற்கு * வேலை செய்யும் மின்னஞ்சல் முகவரிகள் தேவைப்படும் பக்கங்களுக்கான இணைப்புகளை நாங்கள் ஏற்கவில்லை, ஆனால் அவற்றைக் கோரும் பட்டியல்களை நாங்கள் வரவேற்கிறோம். + +2. நீங்கள் Git ஐ அறிய வேண்டியதில்லைஃ இந்த ரெப்போவில் ஏற்கனவே இல்லாத ஆர்வமுள்ள ஒன்றை நீங்கள் கண்டால், தயவுசெய்து ஒரு [வெளியீடு] (https://github.com/EbookFoundation/free-programming-books/issues) உங்கள் இணைப்புகள் முன்மொழிவுகளுடன். + - உங்களுக்கு ஜிட் தெரியும் என்றால், தயவுசெய்து ரெப்போவை ஃபோர்க் செய்து புல் கோரிக்கைகளை அனுப்பவும் (PR). + +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/) + - * ஊடாடும் பயிற்சிகள் *: பயனர் குறியீடு அல்லது கட்டளைகளை தட்டச்சு செய்ய அனுமதிக்கும் ஒரு ஊடாடும் வலைத்தளம் மற்றும் முடிவை மதிப்பீடு செய்கிறது ("மதிப்பீடு" மூலம் நாங்கள் "தரம்" என்று அர்த்தமல்ல) e.g. : [Haskell ஐ முயற்சிக்கவும்] (http://tryhaskell.org) [Try Git] (https://learngitbranching.js.org) + - * விளையாட்டு மைதானங்கள் *: நிரலாக்கத்தைக் கற்றுக்கொள்வதற்கான ஆன்லைன் மற்றும் ஊடாடும் வலைத்தளங்கள், விளையாட்டுகள் அல்லது டெஸ்க்டாப் மென்பொருள். குறியீடு துணுக்குகளை எழுதுங்கள், தொகுக்கவும் (அல்லது இயக்கவும்) மற்றும் பகிரவும். விளையாட்டு மைதானங்கள் பெரும்பாலும் குறியீட்டைக் கொண்டு விளையாடுவதன் மூலம் உங்கள் கைகளை முடித்து அழுக்குபடுத்த அனுமதிக்கின்றன. + - * பாட்காஸ்ட்கள் மற்றும் திரைக்கதைகள் *: பாட்காஸ்ட்கள் மற்றும் திரைக்கதைகள். + சிக்கல் அமைப்புகள் மற்றும் போட்டி நிரலாக்கம் *: குறியீடு மதிப்பாய்வுடன் அல்லது இல்லாமல், மற்ற பயனர்களுடன் முடிவுகளை ஒப்பிடுவதன் மூலமோ அல்லது இல்லாமல், எளிய அல்லது சிக்கலான சிக்கல்களைத் தீர்ப்பதன் மூலம் உங்கள் நிரலாக்க திறன்களை மதிப்பிட உதவும் வலைத்தளம் அல்லது மென்பொருள். + +4. கீழே உள்ள [வழிகாட்டுதல்களை] (#guides) பின்பற்றுவதை உறுதிசெய்து, கோப்புகளின் [Markdown formatting] (#formatting) ஐ மதிக்கவும். + +5. உங்கள் பட்டியல்கள் * * மற்றும் * * வடிவமைத்தல் விதிகள் பின்பற்றப்படுகின்றன என்பதை உறுதிப்படுத்த கிட்ஹப் செயல்கள் சோதனைகளை இயக்கும். * * உங்கள் மாற்றங்கள் சோதனைகளில் தேர்ச்சி பெற்றுள்ளனவா என்பதை உறுதிப்படுத்திக் கொள்ளுங்கள். + + +##வழிகாட்டுதல்கள் + +ஒரு புத்தகம் இலவசம் என்பதை உறுதிப்படுத்திக் கொள்ளுங்கள். தேவைப்பட்டால் இருமுறை சரிபார்க்கவும். புத்தகம் இலவசம் என்று நீங்கள் ஏன் நினைக்கிறீர்கள் என்று பி. ஆர். இல் கருத்து தெரிவித்தால் அது நிர்வாகிகளுக்கு உதவுகிறது. +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 குறுக்கு இணைப்புகள் இல்லை +- வழக்கமாக "பதிப்பு" ஒன்றுக்கு மேல் "தற்போதைய" இணைப்பை விரும்புகிறதுஃ 'http://example.com/dir/book/current/' http://example.com/dir/book/v 1.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) வடிவமைத்தல் குறித்த விவாதத்திற்கு பங்களிக்க) +- பெரிய கமிட்களை விட அணு கமிட்களை (ஒன்று கூட்டல்/நீக்குதல்/மாற்றியமைப்பதன் மூலம்) விரும்புகிறது. ஒரு பி. ஆர் சமர்ப்பிப்பதற்கு முன் உங்கள் கடமைகளை நசுக்க வேண்டிய அவசியமில்லை. (இந்த விதியை நாங்கள் ஒருபோதும் அமல்படுத்த மாட்டோம், ஏனெனில் இது பராமரிப்பாளர்களின் வசதிக்காக மட்டுமே) +புத்தகம் பழையதாக இருந்தால், வெளியீட்டு தேதியை தலைப்புடன் சேர்க்கவும். +பொருத்தமான இடங்களில் ஆசிரியரின் பெயர் அல்லது பெயர்களைச் சேர்க்கவும். நீங்கள் ஆசிரியர் பட்டியல்களை 'மற்றும் பலர்' என்று சுருக்கலாம். +- புத்தகம் முடிக்கப்படவில்லை என்றால், இன்னும் வேலை செய்யப்பட்டு வருகிறது, [கீழே] விவரிக்கப்பட்டுள்ளபடி 'செயல்பாட்டில்' குறியீட்டைச் சேர்க்கவும் (#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 தலைப்புகள் ('###') + +யோசனை என்னவென்றால்ஃ + +- கடைசி இணைப்புக்கும் புதிய பகுதிக்கும் இடையில் '2' வெற்று கோடுகள். +அதன் பிரிவின் தலைப்பு மற்றும் முதல் இணைப்புக்கு இடையில் '1' வெற்று கோடு. +- இரண்டு இணைப்புகளுக்கு இடையில் '0' வெற்று கோடு. +md கோப்பின் முடிவில் '1' வெற்று வரி. + +உதாரணம்ஃ + +'உரை [...] * [ஒரு அற்புதமான புத்தகம்] (http://example.com/example.html) (வெற்று வரி) (வெற்று வரி) ##எடுத்துக்காட்டு (வெற்று வரி) * [மற்றொரு அற்புதமான புத்தகம்] (http://example.com/book.html) * [வேறு சில புத்தகங்கள்] (http://example.com/other.html) " + +- ']' மற்றும் '(' க்கு இடையில் இடைவெளிகளை வைக்க வேண்டாம்ஃ + + 'உரை மோசமானதுஃ * [மற்றொரு அற்புதமான புத்தகம்] (http://example.com/book.html) + நல்லதுஃ * [மற்றொரு அற்புதமான புத்தகம்] (http://example.com/book.html) + ``` + +- நீங்கள் எழுத்தாளரைச் சேர்த்தால், '-' ஐப் பயன்படுத்தவும் (ஒற்றை இடங்களால் சூழப்பட்ட கோடு) + + 'உரை மோசமானதுஃ * [மற்றொரு அற்புதமான புத்தகம்] (http://example.com/book.html)- ஜான் டோ நல்லதுஃ * [மற்றொரு அற்புதமான புத்தகம்] (http://example.com/book.html) - ஜான் டோ + ``` +- இணைப்புக்கும் அதன் வடிவமைப்புக்கும் இடையில் ஒரு இடத்தை வைக்கவும்ஃ + + 'உரை மோசமானதுஃ * [மிகவும் அற்புதமான புத்தகம்] (https://example.org/book.pdf)(PDF) + நல்லதுஃ * (https://example.org/book.pdf) (PDF) " + +- ஆசிரியர் வடிவமைப்பிற்கு முன் வருகிறார்ஃ + + 'உரை மோசமானதுஃ * (https://example.org/book.pdf) - (PDF) ஜேன் ரோ நல்லவர்ஃ * [மிகவும் அற்புதமான புத்தகம்] (https://example.org/book.pdf) - ஜேன் ரோ (PDF) ' + +- பல வடிவங்கள் (ஒவ்வொரு வளத்திற்கும் ஒரு இணைப்பை நாங்கள் விரும்புகிறோம். வெவ்வேறு வடிவங்களுக்கு எளிதாக அணுகக்கூடிய ஒற்றை இணைப்பு இல்லாதபோது, பல இணைப்புகள் அர்த்தமுள்ளதாக இருக்கலாம். ஆனால் நாம் சேர்க்கும் ஒவ்வொரு இணைப்பும் பராமரிப்பு சுமையை உருவாக்குகிறது, எனவே அதைத் தவிர்க்க முயற்சிக்கிறோம். ) + + 'உரை மோசமானதுஃ * [மற்றொரு அற்புதமான புத்தகம்] (http://example.com/)- John Doe (HTML) BAD: * [மற்றொரு அற்புதமான புத்தகம்] (https://downloads.example.org/book.html)- ஜான் டோ (download site) + நல்லதுஃ * [மற்றொரு அற்புதமான புத்தகம்] (http://example.com/)-John Doe (HTML) [(PDF, EPUB)](https://downloads.example.org/book.html) + ``` + +பழைய புத்தகங்களின் தலைப்பில் வெளியீட்டு ஆண்டை சேர்க்கவும்ஃ + + 'உரை மோசமானதுஃ * [மிகவும் அற்புதமான புத்தகம்] (https://example.org/book.html) - ஜேன் ரோ-1970 + நல்லதுஃ * [ஒரு மிக அற்புதமான புத்தகம் (1970)](https://example.org/book.html) - ஜேன் ரோ + ``` + + செயல்முறை புத்தகங்கள்ஃ + + 'உரை நல்லதுஃ * [விரைவில் ஒரு அற்புதமான புத்தகமாக இருக்கும்](http://example.com/book2.html) - John Doe (HTML) * (: கட்டுமானம்ஃ செயல்பாட்டில்) * ' + +- காப்பகப்படுத்தப்பட்ட இணைப்புஃ + + 'உரை நல்லதுஃ * [ஒரு வழி ஆதரவு சுவாரஸ்யமான புத்தகம்] (https://web.archive.org/web/20211016123456/http:// example. com/) - John Doe (HTML) * (: card _ file _ box: archived) * ' + +##அகர வரிசை + +- ஒரே எழுத்தில் தொடங்கி பல தலைப்புகள் இருக்கும்போது அவற்றை இரண்டாவது வரிசையில் வரிசைப்படுத்துங்கள், மற்றும் பல. எடுத்துக்காட்டாகஃ 'ஆ' என்பது 'அப்' என்பதற்கு முன்பு வருகிறது. +- 'ஒன் டூ' 'ஒன் டூ' க்கு முன் வருகிறது + +நீங்கள் ஒரு தவறான இணைப்பைக் கண்டால், எந்த வரிகளை மாற்ற வேண்டும் என்பதை அறிய லிண்டர் பிழை செய்தியை சரிபார்க்கவும். + + +##குறிப்புகள் + +அடிப்படைகள் ஒப்பீட்டளவில் எளிமையானவை என்றாலும், நாம் பட்டியலிடும் வளங்களில் பெரும் பன்முகத்தன்மை உள்ளது. இந்த பன்முகத்தன்மையை நாம் எவ்வாறு கையாளுகிறோம் என்பதற்கான சில குறிப்புகள் இங்கே. + + +###மெட்டாடேட்டா + +எங்கள் பட்டியல்கள் குறைந்தபட்ச மெட்டாடேட்டாவை வழங்குகின்றனஃ தலைப்புகள், URL கள், படைப்பாளிகள், தளங்கள் மற்றும் அணுகல் குறிப்புகள். + + +####தலைப்புகள் + +- கண்டுபிடிக்கப்பட்ட தலைப்புகள் எதுவும் இல்லை. வளங்களிலிருந்தே தலைப்புகளை எடுக்க முயற்சிக்கிறோம்; இதைத் தவிர்க்க முடிந்தால், தலைப்புகளைக் கண்டுபிடிக்கவோ அல்லது தலையங்கமாகப் பயன்படுத்தவோ வேண்டாம் என்று பங்களிப்பாளர்கள் அறிவுறுத்தப்படுகிறார்கள். பழைய படைப்புகளுக்கு ஒரு விதிவிலக்கு உள்ளது; அவை முதன்மையாக வரலாற்று ஆர்வத்தைக் கொண்டிருந்தால், தலைப்புடன் இணைக்கப்பட்ட அடைப்புக்குறிக்குள் ஒரு வருடம் பயனர்களுக்கு அவர்கள் ஆர்வமாக உள்ளார்களா என்பதை அறிய உதவுகிறது. +- ALLCAPS தலைப்புகள் இல்லை. வழக்கமாக தலைப்பு வழக்கு பொருத்தமானது, ஆனால் சந்தேகம் இருக்கும்போது மூலத்திலிருந்து மூலதனத்தைப் பயன்படுத்தவும்-ஈமோஜிகள் இல்லை. + + +####URL கள் + +சுருக்கமான URL களை நாங்கள் அனுமதிக்க மாட்டோம். +- கண்காணிப்பு குறியீடுகள் URL இலிருந்து அகற்றப்பட வேண்டும். +- சர்வதேச URL கள் தவிர்க்கப்பட வேண்டும். உலாவிக் கம்பிகள் பொதுவாக இவற்றை யூனிகோடில் வழங்குகின்றன, ஆனால் தயவுசெய்து நகலெடுத்து ஒட்டவும். +HTTPS செயல்படுத்தப்பட்ட பாதுகாப்பற்ற ('http') URL களை விட பாதுகாப்பான ('https') URL கள் எப்போதும் விரும்பப்படுகின்றன. +பட்டியலிடப்பட்ட வளத்தை ஹோஸ்ட் செய்யாத வலைப்பக்கங்களை சுட்டிக்காட்டும் URL களை நாங்கள் விரும்பவில்லை, மாறாக வேறு இடங்களை சுட்டிக்காட்டுகிறோம். + + +####படைப்பாளர்கள் + +- மொழிபெயர்ப்பாளர்கள் உட்பட, பொருத்தமான இடங்களில் இலவச வளங்களை உருவாக்கியவர்களுக்கு நாங்கள் கடன் வழங்க விரும்புகிறோம்! +- மொழிபெயர்க்கப்பட்ட படைப்புகளுக்கு அசல் எழுத்தாளரைப் பாராட்ட வேண்டும். இந்த எடுத்துக்காட்டில் உள்ளபடி, ஆசிரியர்களைத் தவிர கடன் படைப்பாளர்களுக்கு [MARC ரிலேட்டர்கள்] (https://loc.gov/marc/relators/relaterm.html) பயன்படுத்த பரிந்துரைக்கிறோம்ஃ + + 'மார்க்டவுன் * [ஒரு மொழிபெயர்க்கப்பட்ட புத்தகம்] (http://example.com/book.html) - ஜான் டோ, 'டிரில். : 'மைக் தி டிரான்ஸ்லேட்டர்' + + இங்கே, சிறுகுறிப்பு 'trl. : 'மொழிபெயர்ப்பாளருக்கு MARC ரிலேட்டர் குறியீட்டைப் பயன்படுத்துகிறது. +- ஆசிரியர் பட்டியலில் உள்ள ஒவ்வொரு உருப்படியையும் வரையறுக்க கமா ',' ஐப் பயன்படுத்தவும். +- நீங்கள் ஆசிரியர் பட்டியல்களை 'மற்றும் பலர்' என்று சுருக்கலாம். +- படைப்பாளர்களுக்கான இணைப்புகளை நாங்கள் அனுமதிக்கவில்லை. +- தொகுப்பு அல்லது ரீமிக்ஸ் செய்யப்பட்ட படைப்புகளுக்கு, "படைப்பாளருக்கு" ஒரு விளக்கம் தேவைப்படலாம். எடுத்துக்காட்டாக, "கோல்பிக்கர்" அல்லது "ஆர்ஐபி டுடோரியல்" புத்தகங்கள் "ஸ்டேக்ஓவர்ஃப்ளோ ஆவணங்களிலிருந்து தொகுக்கப்பட்டவை" என்று வரவு வைக்கப்படுகின்றன. +- படைப்பாளர்களின் பெயர்களில் "பேராசிரியர்" அல்லது "டாக்டர்" போன்ற கெளரவப் பெயர்களை நாங்கள் சேர்க்கவில்லை. + + +####நேர வரம்புக்குட்பட்ட படிப்புகள் மற்றும் சோதனைகள் + +ஆறு மாதங்களில் அகற்ற வேண்டிய விஷயங்களை நாங்கள் பட்டியலிடவில்லை. +ஒரு பாடத்திட்டத்தில் வரையறுக்கப்பட்ட சேர்க்கை காலம் அல்லது காலம் இருந்தால், நாங்கள் அதை பட்டியலிட மாட்டோம். +- ஒரு குறிப்பிட்ட காலத்திற்கு இலவசமாக இருக்கும் வளங்களை எங்களால் பட்டியலிட முடியாது. + + +####தளங்கள் மற்றும் அணுகல் குறிப்புகள் + +- படிப்புகள். குறிப்பாக எங்கள் பாடநெறி பட்டியல்களுக்கு, தளம் வள விளக்கத்தின் ஒரு முக்கிய பகுதியாகும். ஏனென்றால், பாடநெறி தளங்கள் வெவ்வேறு செலவுகள் மற்றும் அணுகல் மாதிரிகளைக் கொண்டுள்ளன. பதிவு தேவைப்படும் ஒரு புத்தகத்தை நாங்கள் வழக்கமாக பட்டியலிட மாட்டோம் என்றாலும், பல பாடநெறி தளங்களில் ஒருவித கணக்கு இல்லாமல் வேலை செய்யாத செலவுகள் உள்ளன. எடுத்துக்காட்டு பாடநெறி தளங்களில் Coursera, EdX, Udacity மற்றும் Udemy ஆகியவை அடங்கும். ஒரு பாடத்திட்டம் ஒரு தளத்தை சார்ந்து இருக்கும்போது, தளத்தின் பெயர் அடைப்புக்குறிக்குள் பட்டியலிடப்பட வேண்டும். +- யூடியூப் யூடியூப் பிளேலிஸ்ட்களைக் கொண்ட பல படிப்புகள் எங்களிடம் உள்ளன. நாங்கள் யூடியூப்பை ஒரு தளமாக பட்டியலிடவில்லை, யூடியூப் படைப்பாளரை பட்டியலிட முயற்சிக்கிறோம், இது பெரும்பாலும் துணை தளமாகும். +யூடியூப் வீடியோக்கள். நாங்கள் வழக்கமாக தனிப்பட்ட யூடியூப் வீடியோக்களுடன் இணைக்க மாட்டோம், அவை ஒரு மணி நேரத்திற்கு மேல் நீளம் கொண்டவை மற்றும் ஒரு பாடநெறி அல்லது பயிற்சி போல கட்டமைக்கப்படாவிட்டால். அப்படியானால், பி. ஆர் விளக்கத்தில் அதைக் குறிப்பிடுவதை உறுதிப்படுத்திக் கொள்ளுங்கள். +- சுருக்கப்படவில்லை (i.e. youtu.be/xxxx) இணைப்புகள்! +- லீன்பப். லீன்பப் பல்வேறு அணுகல் மாதிரிகளுடன் புத்தகங்களை வழங்குகிறது. சில நேரங்களில் ஒரு புத்தகத்தை பதிவு செய்யாமல் படிக்கலாம்; சில நேரங்களில் ஒரு புத்தகத்திற்கு இலவச அணுகலுக்கு லீன்பப் கணக்கு தேவைப்படுகிறது. புத்தகங்களின் தரம் மற்றும் Leanpub அணுகல் மாதிரிகளின் கலவை மற்றும் திரவத்தன்மை ஆகியவற்றைக் கருத்தில் கொண்டு, '* (Leanpub கணக்கு அல்லது செல்லுபடியாகும் மின்னஞ்சல் கோரப்பட்டது) *' என்ற அணுகல் குறிப்புடன் பிந்தையதை பட்டியலிட அனுமதிக்கிறோம். + + +####வகைகள் + +ஒரு வளம் எந்த பட்டியலுக்குச் சொந்தமானது என்பதைத் தீர்மானிப்பதற்கான முதல் விதி, வளம் தன்னை எவ்வாறு விவரிக்கிறது என்பதைப் பார்ப்பதாகும். அது தன்னை ஒரு புத்தகம் என்று அழைத்தால், அது ஒரு புத்தகமாக இருக்கலாம். + + +####நாங்கள் பட்டியலிடாத வகைகள் + +இணையம் பரந்த அளவில் இருப்பதால், நாங்கள் எங்கள் பட்டியல்களில் சேர்க்கவில்லைஃ + +- வலைப்பதிவுகள்-வலைப்பதிவு பதிவுகள்-கட்டுரைகள்-வலைத்தளங்கள் (except for those that host LOTS of items that we list). +- பாடங்கள் அல்லது திரைக்காட்சிகள் அல்லாத வீடியோக்கள். +- புத்தக அத்தியாயங்கள் +- புத்தகங்களிலிருந்து டீஸர் மாதிரிகள் +- ஐஆர்சி அல்லது டெலிகிராம் சேனல்கள் +- ஸ்லாக்ஸ் அல்லது அஞ்சல் பட்டியல்கள் + +எங்கள் போட்டி நிரலாக்க பட்டியல்கள் இந்த விலக்குகளைப் பற்றி அவ்வளவு கண்டிப்பானவை அல்ல. ரெப்போவின் நோக்கம் சமூகத்தால் தீர்மானிக்கப்படுகிறது; நீங்கள் ஒரு மாற்றத்தை அல்லது நோக்கத்துடன் கூடுதலாக பரிந்துரைக்க விரும்பினால், தயவுசெய்து ஆலோசனையைச் செய்ய ஒரு சிக்கலைப் பயன்படுத்தவும். + + +###புத்தகங்கள் எதிராக பிற பொருட்கள் + +புத்தகத் திறனைப் பற்றி நாங்கள் அவ்வளவு பரபரப்பாக இல்லை. ஒரு வளம் ஒரு புத்தகம் என்பதைக் குறிக்கும் சில பண்புக்கூறுகள் இங்கேஃ + +இதில் ISBN (International Standard Book Number) உள்ளது-இதில் உள்ளடக்க அட்டவணை உள்ளது-பதிவிறக்கம் செய்யக்கூடிய பதிப்பு வழங்கப்படுகிறது, குறிப்பாக ePub கோப்புகள். +- இது பதிப்புகளைக் கொண்டுள்ளது-இது ஊடாடும் உள்ளடக்கம் அல்லது வீடியோக்களைப் பொறுத்தது அல்ல-இது ஒரு தலைப்பை விரிவாக மறைக்க முயற்சிக்கிறது-இது தன்னிறைவு பெற்றது + +இந்த பண்புகளைக் கொண்டிராத நிறைய புத்தகங்களை நாம் பட்டியலிடுகிறோம்; அது சூழலைப் பொறுத்தது. + + +####புத்தகங்கள் எதிராக. படிப்புகள் + +சில நேரங்களில் இவற்றை வேறுபடுத்துவது கடினமாக இருக்கலாம்! + +படிப்புகள் பெரும்பாலும் தொடர்புடைய பாடப்புத்தகங்களைக் கொண்டுள்ளன, அவற்றை நாங்கள் எங்கள் புத்தகப் பட்டியல்களில் பட்டியலிடுவோம். படிப்புகளில் விரிவுரைகள், பயிற்சிகள், சோதனைகள், குறிப்புகள் அல்லது பிற போதனை உதவிகள் உள்ளன. ஒரு சொற்பொழிவு அல்லது வீடியோ என்பது ஒரு பாடநெறி அல்ல. ஒரு பவர்பாயிண்ட் ஒரு பாடநெறி அல்ல. + + +####ஊடாடும் பயிற்சிகள் எதிராக பிற விஷயங்கள் + +நீங்கள் அதை அச்சிட்டு அதன் சாரத்தை தக்க வைத்துக் கொள்ள முடிந்தால், அது ஒரு ஊடாடும் பயிற்சி அல்ல. + + +##ஆட்டோமேஷன் + +- வடிவமைப்பு விதிகள் அமலாக்கம் [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' ஐக் கொண்ட ஒரு கமிட் செய்தியை உள்ளடக்கிய ஒரு கமிட்டை அழுத்தவும்ஃ + + 'பண்புகள் check _ urls = free-programming-books.md free-programming-books-en.md' + +- ஒவ்வொரு உள்ளீட்டையும் பிரிக்க ஒற்றை இடத்தைப் பயன்படுத்தி, சரிபார்க்க ஒன்றுக்கு மேற்பட்ட கோப்புகளை நீங்கள் குறிப்பிடலாம். +- நீங்கள் ஒன்றுக்கு மேற்பட்ட கோப்புகளைக் குறிப்பிட்டால், கட்டமைப்பின் முடிவுகள் கடைசியாக சரிபார்க்கப்பட்ட கோப்பின் முடிவை அடிப்படையாகக் கொண்டவை. இதன் காரணமாக நீங்கள் பசுமை கட்டமைப்புகளைப் பெறலாம் என்பதை நீங்கள் அறிந்திருக்க வேண்டும், எனவே "அனைத்து காசோலைகளையும் காட்டு"-> "விவரங்கள்" என்பதைக் கிளிக் செய்வதன் மூலம் புல் கோரிக்கையின் முடிவில் உள்ள பில்ட் பதிவை ஆய்வு செய்ய மறக்காதீர்கள். From 1a74ba94b2c729d318344c69c196b432ec9bdd9c Mon Sep 17 00:00:00 2001 From: Ritika Kumari <150653433+Ritika-K7@users.noreply.github.com> Date: Wed, 16 Oct 2024 20:15:48 +0530 Subject: [PATCH 2/3] Update CONTRIBUTING-ta.md Changes made to : #11350 --- docs/CONTRIBUTING-ta.md | 282 ++++++++++++++++++++++------------------ 1 file changed, 158 insertions(+), 124 deletions(-) diff --git a/docs/CONTRIBUTING-ta.md b/docs/CONTRIBUTING-ta.md index cfbef51c5..825b3eb2b 100644 --- a/docs/CONTRIBUTING-ta.md +++ b/docs/CONTRIBUTING-ta.md @@ -1,158 +1,181 @@ -* [இதை மற்ற மொழிகளில் படிக்கவும்] (README.md #translations) * +* [இதை மற்ற மொழிகளில் படிக்கவும்](README.md#translations) * #பங்களிப்பாளர் உரிம ஒப்பந்தம் -பங்களிப்பதன் மூலம், இந்த களஞ்சியத்தின் உரிமத்திற்கு (../உரிமம்) நீங்கள் ஒப்புக்கொள்கிறீர்கள். +பங்களிப்பதன் மூலம், இந்த களஞ்சியத்தின் [உரிமம்](../LICENSE) நீங்கள் ஒப்புக்கொள்கிறீர்கள். -#பங்களிப்பாளர் நடத்தை விதிகள் +##பங்களிப்பாளர் நடத்தை விதிகள் -பங்களிப்பதன் மூலம், இந்த களஞ்சியத்தின் [நடத்தை விதிகளை] (CODE_OF_CONDUCT.md) மதிக்க ஒப்புக்கொள்கிறீர்கள். ([மொழிபெயர்ப்புகள்] (README.md #translations)) +பங்களிப்பதன் மூலம், இந்த களஞ்சியத்தின் [நடத்தை விதிகளை](CODE_OF_CONDUCT.md) மதிக்க ஒப்புக்கொள்கிறீர்கள். ([மொழிபெயர்ப்புகள்](README.md#translations)) + +# சுருக்கமாக + +1. "ஒரு புத்தகத்தை எளிதாகப் பதிவிறக்குவதற்கான இணைப்பு" என்பது எப்போதும் ஒரு *இலவச* புத்தகத்திற்கான இணைப்பு அல்ல. தயவுசெய்து இலவச உள்ளடக்கத்தை மட்டுமே பங்களிக்கவும். அது இலவசம் என்பதை உறுதிப்படுத்திக் கொள்ளுங்கள். புத்தகங்களைப் பெறுவதற்கு *வேலை செய்யும் மின்னஞ்சல் முகவரிகள் தேவைப்படும்* பக்கங்களுக்கான இணைப்புகளை நாங்கள் ஏற்கவில்லை, ஆனால் அவற்றைக் கோரும் பட்டியல்களை நாங்கள் வரவேற்கிறோம். + +2. நீங்கள் Git ஐ அறிய வேண்டியதில்லை: இந்த ரெப்போவில் ஏற்கனவே இல்லாத ஆர்வமுள்ள ஒன்றை நீங்கள் கண்டால், தயவுசெய்து ஒரு [Issue](https://github.com/EbookFoundation/free-programming-books/issues) உங்கள் இணைப்புகள் முன்மொழிவுகளுடன் உருவாக்கவும். + - உங்களுக்கு Git தெரிந்தால், ரெப்போவை Fork செய்து Pull Requests (PR) அனுப்பவும். + +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) +- *விளையாட்டு மைதானங்கள்*: நிரலாக்கத்தைக் கற்றுக்கொள்வதற்கான ஆன்லைன் மற்றும் ஊடாடும் வலைத்தளங்கள், விளையாட்டுகள் அல்லது டெஸ்க்டாப் மென்பொருள். குறியீடு துணுக்குகளை எழுதுங்கள், தொகுக்கவும் (அல்லது இயக்கவும்) மற்றும் பகிரவும். விளையாட்டு மைதானங்கள் பெரும்பாலும் குறியீட்டைக் கொண்டு விளையாடுவதன் மூலம் உங்கள் கைகளை அழுக்குபடுத்த அனுமதிக்கின்றன. +- *பாட்காஸ்ட்கள் மற்றும் திரைக்கதைகள்*: பாட்காஸ்ட்கள் மற்றும் திரைக்கதைகள். +- *சிக்கல் அமைப்புகள் மற்றும் போட்டி நிரலாக்கம்*: குறியீடு மதிப்பாய்வுடன் அல்லது இல்லாமல், மற்ற பயனர்களுடன் முடிவுகளை ஒப்பிடுவதன் மூலமோ அல்லது இல்லாமல், எளிய அல்லது சிக்கலான சிக்கல்களைத் தீர்ப்பதன் மூலம் உங்கள் நிரலாக்க திறன்களை மதிப்பீடு செய்ய உதவும் வலைத்தளம் அல்லது மென்பொருள். + +5. கீழே உள்ள [வழிகாட்டுதல்களை](#guides) பின்பற்றுவதை உறுதிசெய்து, கோப்புகளின் [Markdown formatting](#formatting) ஐ மதிக்கவும். + +6. உங்கள் பட்டியல்கள் *வெளியீடு* மற்றும் *வடிவமைத்தல் விதிகள்* பின்பற்றப்படுகின்றன என்பதை உறுதிப்படுத்த கிட்ஹப் செயல்கள் சோதனைகளை இயக்கும். **உங்கள் மாற்றங்கள் சோதனைகளில் தேர்ச்சி பெற்றுள்ளனவா** என்பதை உறுதிப்படுத்திக் கொள்ளுங்கள். -#சுருக்கமாக +## வழிகாட்டுதல்கள் -1. "ஒரு புத்தகத்தை எளிதாகப் பதிவிறக்குவதற்கான இணைப்பு" என்பது எப்போதும் ஒரு * இலவச * புத்தகத்திற்கான இணைப்பு அல்ல. தயவுசெய்து இலவச உள்ளடக்கத்தை மட்டுமே பங்களிக்கவும். அது இலவசம் என்பதை உறுதிப்படுத்திக் கொள்ளுங்கள். புத்தகங்களைப் பெறுவதற்கு * வேலை செய்யும் மின்னஞ்சல் முகவரிகள் தேவைப்படும் பக்கங்களுக்கான இணைப்புகளை நாங்கள் ஏற்கவில்லை, ஆனால் அவற்றைக் கோரும் பட்டியல்களை நாங்கள் வரவேற்கிறோம். - -2. நீங்கள் Git ஐ அறிய வேண்டியதில்லைஃ இந்த ரெப்போவில் ஏற்கனவே இல்லாத ஆர்வமுள்ள ஒன்றை நீங்கள் கண்டால், தயவுசெய்து ஒரு [வெளியீடு] (https://github.com/EbookFoundation/free-programming-books/issues) உங்கள் இணைப்புகள் முன்மொழிவுகளுடன். - - உங்களுக்கு ஜிட் தெரியும் என்றால், தயவுசெய்து ரெப்போவை ஃபோர்க் செய்து புல் கோரிக்கைகளை அனுப்பவும் (PR). - -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/) - - * ஊடாடும் பயிற்சிகள் *: பயனர் குறியீடு அல்லது கட்டளைகளை தட்டச்சு செய்ய அனுமதிக்கும் ஒரு ஊடாடும் வலைத்தளம் மற்றும் முடிவை மதிப்பீடு செய்கிறது ("மதிப்பீடு" மூலம் நாங்கள் "தரம்" என்று அர்த்தமல்ல) e.g. : [Haskell ஐ முயற்சிக்கவும்] (http://tryhaskell.org) [Try Git] (https://learngitbranching.js.org) - - * விளையாட்டு மைதானங்கள் *: நிரலாக்கத்தைக் கற்றுக்கொள்வதற்கான ஆன்லைன் மற்றும் ஊடாடும் வலைத்தளங்கள், விளையாட்டுகள் அல்லது டெஸ்க்டாப் மென்பொருள். குறியீடு துணுக்குகளை எழுதுங்கள், தொகுக்கவும் (அல்லது இயக்கவும்) மற்றும் பகிரவும். விளையாட்டு மைதானங்கள் பெரும்பாலும் குறியீட்டைக் கொண்டு விளையாடுவதன் மூலம் உங்கள் கைகளை முடித்து அழுக்குபடுத்த அனுமதிக்கின்றன. - - * பாட்காஸ்ட்கள் மற்றும் திரைக்கதைகள் *: பாட்காஸ்ட்கள் மற்றும் திரைக்கதைகள். - சிக்கல் அமைப்புகள் மற்றும் போட்டி நிரலாக்கம் *: குறியீடு மதிப்பாய்வுடன் அல்லது இல்லாமல், மற்ற பயனர்களுடன் முடிவுகளை ஒப்பிடுவதன் மூலமோ அல்லது இல்லாமல், எளிய அல்லது சிக்கலான சிக்கல்களைத் தீர்ப்பதன் மூலம் உங்கள் நிரலாக்க திறன்களை மதிப்பிட உதவும் வலைத்தளம் அல்லது மென்பொருள். - -4. கீழே உள்ள [வழிகாட்டுதல்களை] (#guides) பின்பற்றுவதை உறுதிசெய்து, கோப்புகளின் [Markdown formatting] (#formatting) ஐ மதிக்கவும். - -5. உங்கள் பட்டியல்கள் * * மற்றும் * * வடிவமைத்தல் விதிகள் பின்பற்றப்படுகின்றன என்பதை உறுதிப்படுத்த கிட்ஹப் செயல்கள் சோதனைகளை இயக்கும். * * உங்கள் மாற்றங்கள் சோதனைகளில் தேர்ச்சி பெற்றுள்ளனவா என்பதை உறுதிப்படுத்திக் கொள்ளுங்கள். +- ஒரு புத்தகம் இலவசம் என்பதை உறுதிப்படுத்திக் கொள்ளுங்கள். தேவைப்பட்டால் இருமுறை சரிபார்க்கவும். புத்தகம் இலவசம் என்று நீங்கள் ஏன் நினைக்கிறீர்கள் என்று 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.: '(மின்னஞ்சல் முகவரி *கோரப்பட்டது*, தேவையில்லை)'. -##வழிகாட்டுதல்கள் +## வடிவமைப்பு -ஒரு புத்தகம் இலவசம் என்பதை உறுதிப்படுத்திக் கொள்ளுங்கள். தேவைப்பட்டால் இருமுறை சரிபார்க்கவும். புத்தகம் இலவசம் என்று நீங்கள் ஏன் நினைக்கிறீர்கள் என்று பி. ஆர். இல் கருத்து தெரிவித்தால் அது நிர்வாகிகளுக்கு உதவுகிறது. -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 குறுக்கு இணைப்புகள் இல்லை -- வழக்கமாக "பதிப்பு" ஒன்றுக்கு மேல் "தற்போதைய" இணைப்பை விரும்புகிறதுஃ 'http://example.com/dir/book/current/' http://example.com/dir/book/v 1.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) வடிவமைத்தல் குறித்த விவாதத்திற்கு பங்களிக்க) -- பெரிய கமிட்களை விட அணு கமிட்களை (ஒன்று கூட்டல்/நீக்குதல்/மாற்றியமைப்பதன் மூலம்) விரும்புகிறது. ஒரு பி. ஆர் சமர்ப்பிப்பதற்கு முன் உங்கள் கடமைகளை நசுக்க வேண்டிய அவசியமில்லை. (இந்த விதியை நாங்கள் ஒருபோதும் அமல்படுத்த மாட்டோம், ஏனெனில் இது பராமரிப்பாளர்களின் வசதிக்காக மட்டுமே) -புத்தகம் பழையதாக இருந்தால், வெளியீட்டு தேதியை தலைப்புடன் சேர்க்கவும். -பொருத்தமான இடங்களில் ஆசிரியரின் பெயர் அல்லது பெயர்களைச் சேர்க்கவும். நீங்கள் ஆசிரியர் பட்டியல்களை 'மற்றும் பலர்' என்று சுருக்கலாம். -- புத்தகம் முடிக்கப்படவில்லை என்றால், இன்னும் வேலை செய்யப்பட்டு வருகிறது, [கீழே] விவரிக்கப்பட்டுள்ளபடி 'செயல்பாட்டில்' குறியீட்டைச் சேர்க்கவும் (#in_process) -- [* Internet Archive 's Wayback Machine *] (https://web.archive.org) (அல்லது ஒத்த) ஐப் பயன்படுத்தி ஒரு வளத்தை மீட்டெடுத்தால், [கீழே] விவரிக்கப்பட்டுள்ளபடி' காப்பகப்படுத்தப்பட்ட 'குறியீட்டைச் சேர்க்கவும் (#archived) பயன்படுத்த சிறந்த பதிப்புகள் சமீபத்தியவை மற்றும் முழுமையானவை. -- பதிவிறக்கம் செயல்படுத்தப்படுவதற்கு முன்பு ஒரு மின்னஞ்சல் முகவரி அல்லது கணக்கு அமைப்பு கோரப்பட்டால், அடைப்புக்குறிக்குள் மொழி-பொருத்தமான குறிப்புகளைச் சேர்க்கவும், e.g. : '(மின்னஞ்சல் முகவரி * கோரப்பட்டது *, தேவையில்லை)'. - - -##வடிவமைப்பு - -- அனைத்து பட்டியல்களும் '. md' கோப்புகள். [Markdown] (https://guides.github.com/features/mastering-markdown/) தொடரியல் கற்க முயற்சிக்கவும். அது எளிது! +- அனைத்து பட்டியல்களும் '.md' கோப்புகள். [Markdown](https://guides.github.com/features/mastering-markdown/) தொடரியல் கற்க முயற்சிக்கவும். அது எளிது! - அனைத்து பட்டியல்களும் ஒரு குறியீட்டுடன் தொடங்குகின்றன. அனைத்து பிரிவுகளையும் உட்பிரிவுகளையும் அங்கு பட்டியலிட்டு இணைப்பதே யோசனை. அதை அகர வரிசைப்படி வைத்திருங்கள். -- பிரிவுகள் நிலை 3 தலைப்புகளைப் பயன்படுத்துகின்றன ('##') மற்றும் உட்பிரிவுகள் நிலை 4 தலைப்புகள் ('###') +- பிரிவுகள் நிலை 3 தலைப்புகளைப் பயன்படுத்துகின்றன ('###') மற்றும் உட்பிரிவுகள் நிலை 4 தலைப்புகள் ('####'). -யோசனை என்னவென்றால்ஃ +### யோசனை: -- கடைசி இணைப்புக்கும் புதிய பகுதிக்கும் இடையில் '2' வெற்று கோடுகள். -அதன் பிரிவின் தலைப்பு மற்றும் முதல் இணைப்புக்கு இடையில் '1' வெற்று கோடு. -- இரண்டு இணைப்புகளுக்கு இடையில் '0' வெற்று கோடு. -md கோப்பின் முடிவில் '1' வெற்று வரி. +- கடைசி இணைப்புக்கும் புதிய பகுதிக்கும் இடையில் *2 வெற்று கோடுகள்*. +- அதன் பிரிவின் தலைப்பு மற்றும் முதல் இணைப்புக்கு இடையில் *1 வெற்று கோடு*. +- இரண்டு இணைப்புகளுக்கு இடையில் *0 வெற்று கோடு*. +- .md கோப்பின் முடிவில் *1 வெற்று வரி*. -உதாரணம்ஃ +**உதாரணம்:** -'உரை [...] * [ஒரு அற்புதமான புத்தகம்] (http://example.com/example.html) (வெற்று வரி) (வெற்று வரி) ##எடுத்துக்காட்டு (வெற்று வரி) * [மற்றொரு அற்புதமான புத்தகம்] (http://example.com/book.html) * [வேறு சில புத்தகங்கள்] (http://example.com/other.html) " -- ']' மற்றும் '(' க்கு இடையில் இடைவெளிகளை வைக்க வேண்டாம்ஃ +- ']' மற்றும் '(' க்கு இடையில் இடைவெளிகளை வைக்க வேண்டாம்: - 'உரை மோசமானதுஃ * [மற்றொரு அற்புதமான புத்தகம்] (http://example.com/book.html) - நல்லதுஃ * [மற்றொரு அற்புதமான புத்தகம்] (http://example.com/book.html) - ``` + - *மோசமானது:* ```[மற்றொரு அற்புதமான புத்தகம்] (http://example.com/book.html)``` + - *நல்லது:* ```[மற்றொரு அற்புதமான புத்தகம்](http://example.com/book.html)``` -- நீங்கள் எழுத்தாளரைச் சேர்த்தால், '-' ஐப் பயன்படுத்தவும் (ஒற்றை இடங்களால் சூழப்பட்ட கோடு) +- நீங்கள் எழுத்தாளரைச் சேர்த்தால், '-' ஐப் பயன்படுத்தவும் (ஒற்றை இடங்களால் சூழப்பட்ட கோடு): - 'உரை மோசமானதுஃ * [மற்றொரு அற்புதமான புத்தகம்] (http://example.com/book.html)- ஜான் டோ நல்லதுஃ * [மற்றொரு அற்புதமான புத்தகம்] (http://example.com/book.html) - ஜான் டோ - ``` -- இணைப்புக்கும் அதன் வடிவமைப்புக்கும் இடையில் ஒரு இடத்தை வைக்கவும்ஃ + - *மோசமானது:* + ``` + உரை [...] * [மற்றொரு அற்புதமான புத்தகம்](http://example.com/book.html) - ஜான் டோ + ``` + - *நல்லது:* + ``` + உரை [...] * [மற்றொரு அற்புதமான புத்தகம்](http://example.com/book.html) - ஜான் டோ + ``` - 'உரை மோசமானதுஃ * [மிகவும் அற்புதமான புத்தகம்] (https://example.org/book.pdf)(PDF) - நல்லதுஃ * (https://example.org/book.pdf) (PDF) " +- இணைப்புக்கும் அதன் வடிவமைப்புக்கும் இடையில் ஒரு இடத்தை வைக்கவும்: -- ஆசிரியர் வடிவமைப்பிற்கு முன் வருகிறார்ஃ + - *மோசமானது:* + ``` + உரை [...] * [மிகவும் அற்புதமான புத்தகம்](https://example.org/book.pdf)(PDF) + ``` + - *நல்லது:* + ``` + உரை [...] * [மிகவும் அற்புதமான புத்தகம்](https://example.org/book.pdf) (PDF) + ``` - 'உரை மோசமானதுஃ * (https://example.org/book.pdf) - (PDF) ஜேன் ரோ நல்லவர்ஃ * [மிகவும் அற்புதமான புத்தகம்] (https://example.org/book.pdf) - ஜேன் ரோ (PDF) ' +- ஆசிரியர் வடிவமைப்பிற்கு முன் வருகிறான்: -- பல வடிவங்கள் (ஒவ்வொரு வளத்திற்கும் ஒரு இணைப்பை நாங்கள் விரும்புகிறோம். வெவ்வேறு வடிவங்களுக்கு எளிதாக அணுகக்கூடிய ஒற்றை இணைப்பு இல்லாதபோது, பல இணைப்புகள் அர்த்தமுள்ளதாக இருக்கலாம். ஆனால் நாம் சேர்க்கும் ஒவ்வொரு இணைப்பும் பராமரிப்பு சுமையை உருவாக்குகிறது, எனவே அதைத் தவிர்க்க முயற்சிக்கிறோம். ) + - *மோசமானது:* + ``` + உரை [...] * [மிகவும் அற்புதமான புத்தகம்](https://example.org/book.pdf) - (PDF) ஜேன் ரோ + ``` + - *நல்லது:* + ``` + உரை [...] * [மிகவும் அற்புதமான புத்தகம்](https://example.org/book.pdf) - ஜேன் ரோ (PDF) + ``` - 'உரை மோசமானதுஃ * [மற்றொரு அற்புதமான புத்தகம்] (http://example.com/)- John Doe (HTML) BAD: * [மற்றொரு அற்புதமான புத்தகம்] (https://downloads.example.org/book.html)- ஜான் டோ (download site) - நல்லதுஃ * [மற்றொரு அற்புதமான புத்தகம்] (http://example.com/)-John Doe (HTML) [(PDF, EPUB)](https://downloads.example.org/book.html) - ``` +- பல வடிவங்கள் (ஒவ்வொரு வளத்திற்கும் ஒரு இணைப்பை நாங்கள் விரும்புகிறோம். வெவ்வேறு வடிவங்களுக்கு எளிதாக அணுகக்கூடிய ஒற்றை இணைப்பு இல்லாதபோது, பல இணைப்புகள் அர்த்தமுள்ளதாக இருக்கலாம். ஆனால் நாம் சேர்க்கும் ஒவ்வொரு இணைப்பும் பராமரிப்பு சுமையை உருவாக்குகிறது, எனவே அதைத் தவிர்க்க முயற்சிக்கிறோம்): -பழைய புத்தகங்களின் தலைப்பில் வெளியீட்டு ஆண்டை சேர்க்கவும்ஃ + - *மோசமானது:* + ``` + உரை [...] * [மற்றொரு அற்புதமான புத்தகம்](http://example.com/) - ஜான் டோ (HTML) + BAD: * [மற்றொரு அற்புதமான புத்தகம்](https://downloads.example.org/book.html) - ஜான் டோ (download site) + ``` + - *நல்லது:* + ``` + உரை [...] * [மற்றொரு அற்புதமான புத்தகம்](http://example.com/) - ஜான் டோ (HTML) [(PDF, EPUB)](https://downloads.example.org/book.html) + ``` - 'உரை மோசமானதுஃ * [மிகவும் அற்புதமான புத்தகம்] (https://example.org/book.html) - ஜேன் ரோ-1970 - நல்லதுஃ * [ஒரு மிக அற்புதமான புத்தகம் (1970)](https://example.org/book.html) - ஜேன் ரோ - ``` +## பழைய புத்தகங்களின் தலைப்பில் வெளியீட்டு ஆண்டை சேர்க்கவும் - செயல்முறை புத்தகங்கள்ஃ +- *மோசமானது:* + உரை மோசமானது * [மிகவும் அற்புதமான புத்தகம்](https://example.org/book.html) - ஜேன் ரோ-1970 - 'உரை நல்லதுஃ * [விரைவில் ஒரு அற்புதமான புத்தகமாக இருக்கும்](http://example.com/book2.html) - John Doe (HTML) * (: கட்டுமானம்ஃ செயல்பாட்டில்) * ' +- *நல்லது:* + உரை நல்லது * [ஒரு மிக அற்புதமான புத்தகம் (1970)](https://example.org/book.html) - ஜேன் ரோ -- காப்பகப்படுத்தப்பட்ட இணைப்புஃ +## செயல்முறை புத்தகங்கள் - 'உரை நல்லதுஃ * [ஒரு வழி ஆதரவு சுவாரஸ்யமான புத்தகம்] (https://web.archive.org/web/20211016123456/http:// example. com/) - John Doe (HTML) * (: card _ file _ box: archived) * ' +- உரை நல்லது * [விரைவில் ஒரு அற்புதமான புத்தகமாக இருக்கும்](http://example.com/book2.html) - John Doe (HTML) * (: கட்டுமானம் * செயல்பாட்டில்) -##அகர வரிசை +## காப்பகப்படுத்தப்பட்ட இணைப்புகள் -- ஒரே எழுத்தில் தொடங்கி பல தலைப்புகள் இருக்கும்போது அவற்றை இரண்டாவது வரிசையில் வரிசைப்படுத்துங்கள், மற்றும் பல. எடுத்துக்காட்டாகஃ 'ஆ' என்பது 'அப்' என்பதற்கு முன்பு வருகிறது. -- 'ஒன் டூ' 'ஒன் டூ' க்கு முன் வருகிறது +- உரை நல்லது * [ஒரு வழி ஆதரவு சுவாரஸ்யமான புத்தகம்](https://web.archive.org/web/20211016123456/http://example.com/) - John Doe (HTML) * (: card _ file _ box: archived) + +## அகர வரிசை + +- ஒரே எழுத்தில் தொடங்கி பல தலைப்புகள் இருக்கும்போது, அவற்றை இரண்டாவது வரிசையில் வரிசைப்படுத்துங்கள். எடுத்துக்காட்டாக, 'ஆ' என்பது 'அப்' என்பதற்கு முன்பு வருகிறது. +- 'ஒன் டூ' 'ஒன் டூ' க்கு முன்பு வருகிறது. நீங்கள் ஒரு தவறான இணைப்பைக் கண்டால், எந்த வரிகளை மாற்ற வேண்டும் என்பதை அறிய லிண்டர் பிழை செய்தியை சரிபார்க்கவும். -##குறிப்புகள் +## குறிப்புகள் அடிப்படைகள் ஒப்பீட்டளவில் எளிமையானவை என்றாலும், நாம் பட்டியலிடும் வளங்களில் பெரும் பன்முகத்தன்மை உள்ளது. இந்த பன்முகத்தன்மையை நாம் எவ்வாறு கையாளுகிறோம் என்பதற்கான சில குறிப்புகள் இங்கே. +### மெட்டாடேட்டா -###மெட்டாடேட்டா +எங்கள் பட்டியல்கள் குறைந்தபட்ச மெட்டாடேட்டாவை வழங்குகின்றன: தலைப்புகள், URL கள், படைப்பாளிகள், தளங்கள் மற்றும் அணுகல் குறிப்புகள். -எங்கள் பட்டியல்கள் குறைந்தபட்ச மெட்டாடேட்டாவை வழங்குகின்றனஃ தலைப்புகள், URL கள், படைப்பாளிகள், தளங்கள் மற்றும் அணுகல் குறிப்புகள். - - -####தலைப்புகள் +#### தலைப்புகள் - கண்டுபிடிக்கப்பட்ட தலைப்புகள் எதுவும் இல்லை. வளங்களிலிருந்தே தலைப்புகளை எடுக்க முயற்சிக்கிறோம்; இதைத் தவிர்க்க முடிந்தால், தலைப்புகளைக் கண்டுபிடிக்கவோ அல்லது தலையங்கமாகப் பயன்படுத்தவோ வேண்டாம் என்று பங்களிப்பாளர்கள் அறிவுறுத்தப்படுகிறார்கள். பழைய படைப்புகளுக்கு ஒரு விதிவிலக்கு உள்ளது; அவை முதன்மையாக வரலாற்று ஆர்வத்தைக் கொண்டிருந்தால், தலைப்புடன் இணைக்கப்பட்ட அடைப்புக்குறிக்குள் ஒரு வருடம் பயனர்களுக்கு அவர்கள் ஆர்வமாக உள்ளார்களா என்பதை அறிய உதவுகிறது. -- ALLCAPS தலைப்புகள் இல்லை. வழக்கமாக தலைப்பு வழக்கு பொருத்தமானது, ஆனால் சந்தேகம் இருக்கும்போது மூலத்திலிருந்து மூலதனத்தைப் பயன்படுத்தவும்-ஈமோஜிகள் இல்லை. +- ALLCAPS தலைப்புகள் இல்லை. வழக்கமாக தலைப்பு வழக்கு பொருத்தமானது, ஆனால் சந்தேகம் இருக்கும்போது மூலத்திலிருந்து மூலதனத்தைப் பயன்படுத்தவும். ஈமோஜிகள் இல்லை. -####URL கள் +#### URL கள் சுருக்கமான URL களை நாங்கள் அனுமதிக்க மாட்டோம். - கண்காணிப்பு குறியீடுகள் URL இலிருந்து அகற்றப்பட வேண்டும். - சர்வதேச URL கள் தவிர்க்கப்பட வேண்டும். உலாவிக் கம்பிகள் பொதுவாக இவற்றை யூனிகோடில் வழங்குகின்றன, ஆனால் தயவுசெய்து நகலெடுத்து ஒட்டவும். -HTTPS செயல்படுத்தப்பட்ட பாதுகாப்பற்ற ('http') URL களை விட பாதுகாப்பான ('https') URL கள் எப்போதும் விரும்பப்படுகின்றன. -பட்டியலிடப்பட்ட வளத்தை ஹோஸ்ட் செய்யாத வலைப்பக்கங்களை சுட்டிக்காட்டும் URL களை நாங்கள் விரும்பவில்லை, மாறாக வேறு இடங்களை சுட்டிக்காட்டுகிறோம். +- HTTPS செயல்படுத்தப்பட்ட பாதுகாப்பற்ற ('http') URL களை விட பாதுகாப்பான ('https') URL கள் எப்போதும் விரும்பப்படுகின்றன. +- பட்டியலிடப்பட்ட வளத்தை ஹோஸ்ட் செய்யாத வலைப்பக்கங்களை சுட்டிக்காட்டும் URL களை நாங்கள் விரும்பவில்லை, மாறாக வேறு இடங்களை சுட்டிக்காட்டுகிறோம். - -####படைப்பாளர்கள் +#### படைப்பாளர்கள் - மொழிபெயர்ப்பாளர்கள் உட்பட, பொருத்தமான இடங்களில் இலவச வளங்களை உருவாக்கியவர்களுக்கு நாங்கள் கடன் வழங்க விரும்புகிறோம்! -- மொழிபெயர்க்கப்பட்ட படைப்புகளுக்கு அசல் எழுத்தாளரைப் பாராட்ட வேண்டும். இந்த எடுத்துக்காட்டில் உள்ளபடி, ஆசிரியர்களைத் தவிர கடன் படைப்பாளர்களுக்கு [MARC ரிலேட்டர்கள்] (https://loc.gov/marc/relators/relaterm.html) பயன்படுத்த பரிந்துரைக்கிறோம்ஃ +- மொழிபெயர்க்கப்பட்ட படைப்புகளுக்கு அசல் எழுத்தாளரைப் பாராட்ட வேண்டும். இந்த எடுத்துக்காட்டில் உள்ளபடி, ஆசிரியர்களைத் தவிர கடன் படைப்பாளர்களுக்கு [MARC ரிலேட்டர்கள்](https://loc.gov/marc/relators/relaterm.html) பயன்படுத்த பரிந்துரைக்கிறோம். - 'மார்க்டவுன் * [ஒரு மொழிபெயர்க்கப்பட்ட புத்தகம்] (http://example.com/book.html) - ஜான் டோ, 'டிரில். : 'மைக் தி டிரான்ஸ்லேட்டர்' + 'மார்க்டவுன் * [ஒரு மொழிபெயர்க்கப்பட்ட புத்தகம்](http://example.com/book.html) - ஜான் டோ, 'டிரில். : 'மைக் தி டிரான்ஸ்லேட்டர்' இங்கே, சிறுகுறிப்பு 'trl. : 'மொழிபெயர்ப்பாளருக்கு MARC ரிலேட்டர் குறியீட்டைப் பயன்படுத்துகிறது. - ஆசிரியர் பட்டியலில் உள்ள ஒவ்வொரு உருப்படியையும் வரையறுக்க கமா ',' ஐப் பயன்படுத்தவும். @@ -162,32 +185,34 @@ HTTPS செயல்படுத்தப்பட்ட பாதுகாப - படைப்பாளர்களின் பெயர்களில் "பேராசிரியர்" அல்லது "டாக்டர்" போன்ற கெளரவப் பெயர்களை நாங்கள் சேர்க்கவில்லை. -####நேர வரம்புக்குட்பட்ட படிப்புகள் மற்றும் சோதனைகள் +#### நேர வரம்புக்குட்பட்ட படிப்புகள் மற்றும் சோதனைகள் ஆறு மாதங்களில் அகற்ற வேண்டிய விஷயங்களை நாங்கள் பட்டியலிடவில்லை. ஒரு பாடத்திட்டத்தில் வரையறுக்கப்பட்ட சேர்க்கை காலம் அல்லது காலம் இருந்தால், நாங்கள் அதை பட்டியலிட மாட்டோம். - ஒரு குறிப்பிட்ட காலத்திற்கு இலவசமாக இருக்கும் வளங்களை எங்களால் பட்டியலிட முடியாது. - -####தளங்கள் மற்றும் அணுகல் குறிப்புகள் +#### தளங்கள் மற்றும் அணுகல் குறிப்புகள் - படிப்புகள். குறிப்பாக எங்கள் பாடநெறி பட்டியல்களுக்கு, தளம் வள விளக்கத்தின் ஒரு முக்கிய பகுதியாகும். ஏனென்றால், பாடநெறி தளங்கள் வெவ்வேறு செலவுகள் மற்றும் அணுகல் மாதிரிகளைக் கொண்டுள்ளன. பதிவு தேவைப்படும் ஒரு புத்தகத்தை நாங்கள் வழக்கமாக பட்டியலிட மாட்டோம் என்றாலும், பல பாடநெறி தளங்களில் ஒருவித கணக்கு இல்லாமல் வேலை செய்யாத செலவுகள் உள்ளன. எடுத்துக்காட்டு பாடநெறி தளங்களில் Coursera, EdX, Udacity மற்றும் Udemy ஆகியவை அடங்கும். ஒரு பாடத்திட்டம் ஒரு தளத்தை சார்ந்து இருக்கும்போது, தளத்தின் பெயர் அடைப்புக்குறிக்குள் பட்டியலிடப்பட வேண்டும். -- யூடியூப் யூடியூப் பிளேலிஸ்ட்களைக் கொண்ட பல படிப்புகள் எங்களிடம் உள்ளன. நாங்கள் யூடியூப்பை ஒரு தளமாக பட்டியலிடவில்லை, யூடியூப் படைப்பாளரை பட்டியலிட முயற்சிக்கிறோம், இது பெரும்பாலும் துணை தளமாகும். -யூடியூப் வீடியோக்கள். நாங்கள் வழக்கமாக தனிப்பட்ட யூடியூப் வீடியோக்களுடன் இணைக்க மாட்டோம், அவை ஒரு மணி நேரத்திற்கு மேல் நீளம் கொண்டவை மற்றும் ஒரு பாடநெறி அல்லது பயிற்சி போல கட்டமைக்கப்படாவிட்டால். அப்படியானால், பி. ஆர் விளக்கத்தில் அதைக் குறிப்பிடுவதை உறுதிப்படுத்திக் கொள்ளுங்கள். + +- யூடியூப் யூடியூப் பிளேலிஸ்ட்களைக் கொண்ட பல படிப்புகள் எங்களிடம் உள்ளன. நாங்கள் யூடியூப்பை ஒரு தளமாக பட்டியலிடவில்லை, யூடியூப் படைப்பாளரை பட்டியலிட முயற்சிக்கிறோம், இது பெரும்பாலும் துணை தளமாகும். யூடியூப் வீடியோக்கள். நாங்கள் வழக்கமாக தனிப்பட்ட யூடியூப் வீடியோக்களுடன் இணைக்க மாட்டோம், அவை ஒரு மணி நேரத்திற்கு மேல் நீளம் கொண்டவை மற்றும் ஒரு பாடநெறி அல்லது பயிற்சி போல கட்டமைக்கப்படாவிட்டால். அப்படியானால், பி. ஆர் விளக்கத்தில் அதைக் குறிப்பிடுவதை உறுதிப்படுத்திக் கொள்ளுங்கள். + - சுருக்கப்படவில்லை (i.e. youtu.be/xxxx) இணைப்புகள்! + - லீன்பப். லீன்பப் பல்வேறு அணுகல் மாதிரிகளுடன் புத்தகங்களை வழங்குகிறது. சில நேரங்களில் ஒரு புத்தகத்தை பதிவு செய்யாமல் படிக்கலாம்; சில நேரங்களில் ஒரு புத்தகத்திற்கு இலவச அணுகலுக்கு லீன்பப் கணக்கு தேவைப்படுகிறது. புத்தகங்களின் தரம் மற்றும் Leanpub அணுகல் மாதிரிகளின் கலவை மற்றும் திரவத்தன்மை ஆகியவற்றைக் கருத்தில் கொண்டு, '* (Leanpub கணக்கு அல்லது செல்லுபடியாகும் மின்னஞ்சல் கோரப்பட்டது) *' என்ற அணுகல் குறிப்புடன் பிந்தையதை பட்டியலிட அனுமதிக்கிறோம். - -####வகைகள் +#### வகைகள் ஒரு வளம் எந்த பட்டியலுக்குச் சொந்தமானது என்பதைத் தீர்மானிப்பதற்கான முதல் விதி, வளம் தன்னை எவ்வாறு விவரிக்கிறது என்பதைப் பார்ப்பதாகும். அது தன்னை ஒரு புத்தகம் என்று அழைத்தால், அது ஒரு புத்தகமாக இருக்கலாம். +#### நாங்கள் பட்டியலிடாத வகைகள் -####நாங்கள் பட்டியலிடாத வகைகள் +இணையம் பரந்த அளவில் இருப்பதால், நாங்கள் எங்கள் பட்டியல்களில் சேர்க்கவில்லை: -இணையம் பரந்த அளவில் இருப்பதால், நாங்கள் எங்கள் பட்டியல்களில் சேர்க்கவில்லைஃ - -- வலைப்பதிவுகள்-வலைப்பதிவு பதிவுகள்-கட்டுரைகள்-வலைத்தளங்கள் (except for those that host LOTS of items that we list). +- வலைப்பதிவுகள் +- வலைப்பதிவு பதிவுகள் +- கட்டுரைகள் +- வலைத்தளங்கள் (except for those that host LOTS of items that we list). - பாடங்கள் அல்லது திரைக்காட்சிகள் அல்லாத வீடியோக்கள். - புத்தக அத்தியாயங்கள் - புத்தகங்களிலிருந்து டீஸர் மாதிரிகள் @@ -197,35 +222,44 @@ HTTPS செயல்படுத்தப்பட்ட பாதுகாப எங்கள் போட்டி நிரலாக்க பட்டியல்கள் இந்த விலக்குகளைப் பற்றி அவ்வளவு கண்டிப்பானவை அல்ல. ரெப்போவின் நோக்கம் சமூகத்தால் தீர்மானிக்கப்படுகிறது; நீங்கள் ஒரு மாற்றத்தை அல்லது நோக்கத்துடன் கூடுதலாக பரிந்துரைக்க விரும்பினால், தயவுசெய்து ஆலோசனையைச் செய்ய ஒரு சிக்கலைப் பயன்படுத்தவும். -###புத்தகங்கள் எதிராக பிற பொருட்கள் +### புத்தகங்கள் எதிராக பிற பொருட்கள் -புத்தகத் திறனைப் பற்றி நாங்கள் அவ்வளவு பரபரப்பாக இல்லை. ஒரு வளம் ஒரு புத்தகம் என்பதைக் குறிக்கும் சில பண்புக்கூறுகள் இங்கேஃ +புத்தகத் திறனைப் பற்றி நாங்கள் அவ்வளவு பரபரப்பாக இல்லை. ஒரு வளம் ஒரு புத்தகம் என்பதைக் குறிக்கும் சில பண்புக்கூறுகள் இங்கே: -இதில் ISBN (International Standard Book Number) உள்ளது-இதில் உள்ளடக்க அட்டவணை உள்ளது-பதிவிறக்கம் செய்யக்கூடிய பதிப்பு வழங்கப்படுகிறது, குறிப்பாக ePub கோப்புகள். -- இது பதிப்புகளைக் கொண்டுள்ளது-இது ஊடாடும் உள்ளடக்கம் அல்லது வீடியோக்களைப் பொறுத்தது அல்ல-இது ஒரு தலைப்பை விரிவாக மறைக்க முயற்சிக்கிறது-இது தன்னிறைவு பெற்றது +- இதில் ISBN (International Standard Book Number) உள்ளது +- இதில் உள்ளடக்க அட்டவணை உள்ளது +- பதிவிறக்கம் செய்யக்கூடிய பதிப்பு வழங்கப்படுகிறது, குறிப்பாக ePub கோப்புகள் +- இது பதிப்புகளைக் கொண்டுள்ளது +- இது ஊடாடும் உள்ளடக்கம் அல்லது வீடியோக்களைப் பொறுத்தது அல்ல +- இது ஒரு தலைப்பை விரிவாக மறைக்க முயற்சிக்கிறது +- இது தன்னிறைவு பெற்றது இந்த பண்புகளைக் கொண்டிராத நிறைய புத்தகங்களை நாம் பட்டியலிடுகிறோம்; அது சூழலைப் பொறுத்தது. - -####புத்தகங்கள் எதிராக. படிப்புகள் +#### புத்தகங்கள் எதிராக. படிப்புகள் சில நேரங்களில் இவற்றை வேறுபடுத்துவது கடினமாக இருக்கலாம்! படிப்புகள் பெரும்பாலும் தொடர்புடைய பாடப்புத்தகங்களைக் கொண்டுள்ளன, அவற்றை நாங்கள் எங்கள் புத்தகப் பட்டியல்களில் பட்டியலிடுவோம். படிப்புகளில் விரிவுரைகள், பயிற்சிகள், சோதனைகள், குறிப்புகள் அல்லது பிற போதனை உதவிகள் உள்ளன. ஒரு சொற்பொழிவு அல்லது வீடியோ என்பது ஒரு பாடநெறி அல்ல. ஒரு பவர்பாயிண்ட் ஒரு பாடநெறி அல்ல. - -####ஊடாடும் பயிற்சிகள் எதிராக பிற விஷயங்கள் +#### ஊடாடும் பயிற்சிகள் எதிராக பிற விஷயங்கள் நீங்கள் அதை அச்சிட்டு அதன் சாரத்தை தக்க வைத்துக் கொள்ள முடிந்தால், அது ஒரு ஊடாடும் பயிற்சி அல்ல. -##ஆட்டோமேஷன் +## ஆட்டோமேஷன் -- வடிவமைப்பு விதிகள் அமலாக்கம் [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' ஐக் கொண்ட ஒரு கமிட் செய்தியை உள்ளடக்கிய ஒரு கமிட்டை அழுத்தவும்ஃ +- வடிவமைப்பு விதிகள் அமலாக்கம் [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' ஐக் கொண்ட ஒரு கமிட் செய்தியை உள்ளடக்கிய ஒரு கமிட்டை அழுத்தவும்: - 'பண்புகள் check _ urls = free-programming-books.md free-programming-books-en.md' + ```bash + சிறப்பு check_urls = free-programming-books.md free-programming-books-en.md + ``` - ஒவ்வொரு உள்ளீட்டையும் பிரிக்க ஒற்றை இடத்தைப் பயன்படுத்தி, சரிபார்க்க ஒன்றுக்கு மேற்பட்ட கோப்புகளை நீங்கள் குறிப்பிடலாம். -- நீங்கள் ஒன்றுக்கு மேற்பட்ட கோப்புகளைக் குறிப்பிட்டால், கட்டமைப்பின் முடிவுகள் கடைசியாக சரிபார்க்கப்பட்ட கோப்பின் முடிவை அடிப்படையாகக் கொண்டவை. இதன் காரணமாக நீங்கள் பசுமை கட்டமைப்புகளைப் பெறலாம் என்பதை நீங்கள் அறிந்திருக்க வேண்டும், எனவே "அனைத்து காசோலைகளையும் காட்டு"-> "விவரங்கள்" என்பதைக் கிளிக் செய்வதன் மூலம் புல் கோரிக்கையின் முடிவில் உள்ள பில்ட் பதிவை ஆய்வு செய்ய மறக்காதீர்கள். + +- நீங்கள் ஒன்றுக்கு மேற்பட்ட கோப்புகளைக் குறிப்பிட்டால், கட்டமைப்பின் முடிவுகள் கடைசியாக சரிபார்க்கப்பட்ட கோப்பின் முடிவை அடிப்படையாகக் கொண்டவை. இதன் காரணமாக நீங்கள் பசுமை கட்டமைப்புகளைப் பெறலாம் என்பதை நீங்கள் அறிந்திருக்க வேண்டும், எனவே "அனைத்து காசோலைகளையும் காட்டு" -> "விவரங்கள்" என்பதைக் கிளிக் செய்வதன் மூலம் புல் கோரிக்கையின் முடிவில் உள்ள பில்ட் பதிவை ஆய்வு செய்ய மறக்காதீர்கள். + From 66cae25b1c2f43e1883440cab496cefabf85a162 Mon Sep 17 00:00:00 2001 From: Ritika Date: Fri, 18 Oct 2024 20:51:12 +0530 Subject: [PATCH 3/3] Hindi Translation of CONTRIBUTING.md --- docs/CONTRIBUTING-hi.md | 259 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 259 insertions(+) create mode 100644 docs/CONTRIBUTING-hi.md diff --git a/docs/CONTRIBUTING-hi.md b/docs/CONTRIBUTING-hi.md new file mode 100644 index 000000000..571f1c45c --- /dev/null +++ b/docs/CONTRIBUTING-hi.md @@ -0,0 +1,259 @@ +*[इसे अन्य भाषाओं में पढ़ें](README.md#translations)* + +## योगदानकर्ता लाइसेंस अनुबंध + +योगदान देकर, आप इस रिपॉजिटरी के [LICENSE](../LICENSE) से सहमत हैं। + +## योगदानकर्ता आचार संहिता + +योगदान देकर, आप इस रिपॉजिटरी के [आचार संहिता](CODE_OF_CONDUCT.md) का सम्मान करने के लिए सहमत हैं। ([translations](README.md#translations)) + +## संक्षेप में + +1. "किसी पुस्तक को आसानी से डाउनलोड करने के लिए लिंक" हमेशा *मुफ़्त* पुस्तक का लिंक नहीं होता। कृपया केवल मुफ़्त सामग्री का योगदान दें। सुनिश्चित करें कि यह मुफ़्त हो। हम उन पृष्ठों के लिंक स्वीकार नहीं करते हैं जिनके लिए पुस्तकें प्राप्त करने के लिए कार्यशील ईमेल पते की *आवश्यकता* होती है, लेकिन हम उन लिस्टिंग का स्वागत करते हैं जो उनका अनुरोध करती हैं। + +2. आपको Git जानने की ज़रूरत नहीं है: अगर आपको कोई ऐसी चीज़ मिली है जो *इस रिपो में पहले से मौजूद नहीं है*, तो कृपया अपने लिंक प्रस्तावों के साथ एक [इश्यू](https://github.com/EbookFoundation/free-programming-books/issues) खोलें। + - अगर आप Git जानते हैं, तो कृपया रिपो को फ़ॉर्क करें और पुल रिक्वेस्ट (PR) भेजें। + +3. हमारे पास 6 तरह की सूचियाँ हैं। सही चुनें: + + - *पुस्तकें*: PDF, HTML, ePub, gitbook.io आधारित साइट, Git रिपो, आदि। + - *कोर्स*: कोर्स एक शिक्षण सामग्री है जो किताब नहीं है। [यह एक कोर्स है](http://ocw.mit.edu/courses/electrical-engineering-and-computer-science/6-006-introduction-to-algorithms-fall-2011/). + - *इंटरैक्टिव ट्यूटोरियल*: एक इंटरैक्टिव वेबसाइट जो उपयोगकर्ता को कोड या कमांड टाइप करने देती है और परिणाम का मूल्यांकन करती है ("मूल्यांकन" से हमारा मतलब "ग्रेड" नहीं है)। उदाहरण: [हास्केल आज़माएँ](http://tryhaskell.org), [गिट आज़माएँ](https://learngitbranching.js.org). + - *प्लेग्राउंड*: प्रोग्रामिंग सीखने के लिए ऑनलाइन और इंटरैक्टिव वेबसाइट, गेम या डेस्कटॉप सॉफ़्टवेयर हैं। कोड स्निपेट लिखें, संकलित करें (या चलाएँ), और साझा करें। प्लेग्राउंड अक्सर आपको कोड के साथ खेलकर फ़ॉर्क करने और अपने हाथों को गंदा करने की अनुमति देते हैं। + - *पॉडकास्ट और स्क्रीनकास्ट*: पॉडकास्ट और स्क्रीनकास्ट। + - *समस्या सेट और प्रतिस्पर्धी प्रोग्रामिंग*: एक वेबसाइट या सॉफ़्टवेयर जो आपको कोड समीक्षा के साथ या उसके बिना, अन्य उपयोगकर्ताओं के साथ परिणामों की तुलना के साथ या उसके बिना, सरल या जटिल समस्याओं को हल करके अपने प्रोग्रामिंग कौशल का आकलन करने देता है। + +4. [नीचे दिए गए दिशा-निर्देशों](#दिशा-निर्देशों) का पालन करना सुनिश्चित करें और फ़ाइलों के [मार्कडाउन फ़ॉर्मेटिंग](#फ़ॉर्मेटिंग) का सम्मान करें। + +5. GitHub क्रियाएँ यह सुनिश्चित करने के लिए परीक्षण चलाएँगी कि **आपकी सूचियाँ वर्णानुक्रम में हैं** और **फ़ॉर्मेटिंग नियमों का पालन किया जाता है**। **सुनिश्चित करें** कि आपके परिवर्तन परीक्षणों में सफल होते हैं। + +### दिशा-निर्देश + +- सुनिश्चित करें कि पुस्तक मुफ़्त है। यदि आवश्यक हो तो दोबारा जाँच करें। यदि आप PR में टिप्पणी करते हैं कि आपको क्यों लगता है कि पुस्तक मुफ़्त है, तो यह व्यवस्थापकों की मदद करता है। +- हम Google Drive, Dropbox, Mega, Scribd, Issuu और अन्य समान फ़ाइल अपलोड प्लेटफ़ॉर्म पर होस्ट की गई फ़ाइलों को स्वीकार नहीं करते हैं। +- अपने लिंक को वर्णानुक्रम में डालें, जैसा कि [नीचे](#alphabetical-order) वर्णित है। +- सबसे अधिक आधिकारिक स्रोत वाले लिंक का उपयोग करें (जिसका अर्थ है कि लेखक की वेबसाइट संपादक की वेबसाइट से बेहतर है, जो किसी तीसरे पक्ष की वेबसाइट से बेहतर है)। +- कोई फ़ाइल होस्टिंग सेवाएँ नहीं (इसमें ड्रॉपबॉक्स और Google ड्राइव लिंक शामिल हैं (लेकिन इन्हीं तक सीमित नहीं हैं)। +- हमेशा `http` लिंक की तुलना में `https` लिंक को प्राथमिकता दें -- जब तक कि वे एक ही डोमेन पर हों और एक ही सामग्री प्रदान करते हों। +- रूट डोमेन पर, अंतिम स्लैश हटाएँ: `http://example.com/` के बजाय `http://example.com`। +- हमेशा सबसे छोटे लिंक को प्राथमिकता दें: `http://example.com/dir/` `http://example.com/dir/index.html` से बेहतर है। +- कोई URL शॉर्टनर लिंक नहीं। +- आमतौर पर "संस्करण" लिंक की तुलना में "वर्तमान" लिंक को प्राथमिकता दें: `http://example.com/dir/book/current/` `http://example.com/dir/book/current/` से बेहतर है `http://example.com/dir/book/v1.0.0/index.html`। +- यदि किसी लिंक में कोई समाप्त प्रमाणपत्र/स्व-हस्ताक्षरित प्रमाणपत्र/किसी अन्य प्रकार की SSL समस्या है: + 1. यदि संभव हो तो *इसे इसके `http` समकक्ष से बदलें* (क्योंकि मोबाइल डिवाइस पर अपवादों को स्वीकार करना जटिल हो सकता है)। + 2. यदि कोई `http` संस्करण उपलब्ध नहीं है, लेकिन ब्राउज़र में अपवाद जोड़कर या चेतावनी को अनदेखा करके लिंक अभी भी `https` के माध्यम से सुलभ है, तो *इसे छोड़ दें*। + 3. अन्यथा *इसे हटा दें*। +- यदि कोई लिंक कई प्रारूपों में मौजूद है, तो प्रत्येक प्रारूप के बारे में एक नोट के साथ एक अलग लिंक जोड़ें। +- यदि कोई संसाधन इंटरनेट पर अलग-अलग स्थानों पर मौजूद है। +- सबसे अधिक आधिकारिक स्रोत के साथ लिंक का उपयोग करें (जिसका अर्थ है कि लेखक की वेबसाइट संपादक की वेबसाइट से बेहतर है, तीसरे पक्ष की वेबसाइट से बेहतर है)। +- यदि वे अलग-अलग संस्करणों से लिंक करते हैं, और आपको लगता है कि ये संस्करण रखने लायक होने के लिए पर्याप्त रूप से अलग हैं, तो प्रत्येक संस्करण के बारे में एक नोट के साथ एक अलग लिंक जोड़ें (फ़ॉर्मेटिंग पर चर्चा में योगदान देने के लिए [अंक #2353](https://github.com/EbookFoundation/free-programming-books/issues/2353) देखें)। +- बड़े कमिट्स की तुलना में एटॉमिक कमिट्स (जोड़/हटाने/संशोधन द्वारा एक कमिट) को प्राथमिकता दें। PR सबमिट करने से पहले अपने कमिट्स को स्क्वैश करने की आवश्यकता नहीं है। (हम इस नियम को कभी लागू नहीं करेंगे क्योंकि यह केवल अनुरक्षकों की सुविधा का मामला है)। +- यदि पुस्तक पुरानी है, तो शीर्षक के साथ प्रकाशन तिथि शामिल करें। +- जहाँ उपयुक्त हो, वहाँ लेखक का नाम या नाम शामिल करें। आप "`et al.`" के साथ लेखक सूचियों को छोटा कर सकते हैं। + +- यदि पुस्तक पूरी नहीं हुई है, और अभी भी उस पर काम चल रहा है, तो "`प्रक्रिया में`" संकेत जोड़ें, जैसा कि [नीचे](#in_process) वर्णित है। + +- यदि कोई संसाधन [*इंटरनेट आर्काइव की वेबैक मशीन*](https://web.archive.org) (या समान) का उपयोग करके पुनर्स्थापित किया जाता है, तो "`संग्रहीत`" संकेत जोड़ें, जैसा कि [नीचे](#संग्रहीत) वर्णित है। उपयोग करने के लिए सबसे अच्छे संस्करण हाल ही के और पूर्ण हैं। + +- यदि डाउनलोड सक्षम करने से पहले ईमेल पता या खाता सेटअप का अनुरोध किया जाता है, तो कोष्ठक में भाषा-उपयुक्त नोट जोड़ें, उदाहरण के लिए: `(ईमेल पता *अनुरोधित*, आवश्यक नहीं)`। + +### स्वरूपण + +- सभी सूचियाँ `.md` फ़ाइलें हैं। [Markdown](https://guides.github.com/features/mastering-markdown/) सिंटैक्स सीखने का प्रयास करें। यह सरल है! + +- सभी सूचियाँ एक इंडेक्स से शुरू होती हैं। विचार यह है कि सभी अनुभागों और उप-अनुभागों को सूचीबद्ध और लिंक किया जाए। इसे वर्णानुक्रम में रखें। +- अनुभाग स्तर 3 शीर्षकों (`###`) का उपयोग कर रहे हैं, और उप-अनुभाग स्तर 4 शीर्षकों (`####`) का उपयोग कर रहे हैं। + +विचार यह है कि: + +- अंतिम लिंक और नए अनुभाग के बीच `2` खाली लाइनें हों। + +- शीर्षक और उसके अनुभाग के पहले लिंक के बीच `1` खाली लाइन हो। + +- दो लिंक के बीच `0` खाली लाइन हो। + +- प्रत्येक `.md` फ़ाइल के अंत में `1` खाली लाइन हो। + +उदाहरण: + +* [एक शानदार किताब](http://example.com/example.html) + + + +### उदाहरण + + + +* [एक और शानदार किताब](http://example.com/book.html) +* [कुछ दूसरी किताब](http://example.com/other.html) + + +- `]` और `(` के बीच में स्पेस न डालें: + +खराब: * [एक और शानदार किताब] (http://example.com/book.html) + +अच्छा: * [एक और शानदार किताब](http://example.com/book.html) + + +- अगर आप लेखक को शामिल करते हैं, तो ` - ` (एकल स्पेस से घिरा डैश) का उपयोग करें: + +खराब: * [एक और शानदार किताब पुस्तक](http://example.com/book.html)- जॉन डो + +अच्छा: * [एक और शानदार पुस्तक](http://example.com/book.html) - जॉन डो + + +- लिंक और उसके प्रारूप के बीच एक ही स्थान रखें: + +खराब: * [एक बहुत बढ़िया पुस्तक](https://example.org/book.pdf)(PDF) + +अच्छा: * [एक बहुत बढ़िया पुस्तक](https://example.org/book.pdf) (PDF) + + +- लेखक प्रारूप से पहले आता है: + +खराब: * [एक बहुत बढ़िया पुस्तक](https://example.org/book.pdf)- (PDF) जेन रो + +अच्छा: * [एक बहुत बढ़िया पुस्तक](https://example.org/book.pdf) - जेन रो (PDF) + + +- एकाधिक प्रारूप (हम प्रत्येक संसाधन के लिए एक ही लिंक पसंद करते हैं। जब अलग-अलग प्रारूपों तक आसान पहुँच के साथ कोई एकल लिंक नहीं होता है, तो कई लिंक समझ में आ सकते हैं। लेकिन हम जो भी लिंक जोड़ते हैं, वह रखरखाव का बोझ पैदा करता है, इसलिए हम इससे बचने की कोशिश करते हैं।): + +खराब: * [एक और शानदार पुस्तक](http://example.com/)- जॉन डो (HTML) + +खराब: * [एक और शानदार पुस्तक](https://downloads.example.org/book.html)- जॉन डो (डाउनलोड साइट) + +अच्छा: * [एक और शानदार पुस्तक](http://example.com/) - जॉन डो (HTML) [(PDF, EPUB)](https://downloads.example.org/book.html) + + +- पुरानी पुस्तकों के शीर्षक में प्रकाशन वर्ष शामिल करें: + +```पाठ +खराब : * [एक बहुत ही शानदार पुस्तक](https://example.org/book.html) - जेन रो - 1970 +अच्छा: * [एक बहुत ही शानदार पुस्तक (1970)](https://example.org/book.html) - जेन रो +``` + +- प्रक्रियाधीन पुस्तकें: + +```text +अच्छा: * [जल्द ही एक बेहतरीन किताब होगी](http://example.com/book2.html) - जॉन डो (HTML) *(:construction: in process)* +``` + +- संग्रहीत लिंक: + +```text +अच्छा: * [एक दिलचस्प किताब](https://web.archive.org/web/20211016123456/http://example.com/) - जॉन डो (HTML) *(:card_file_box: archived)* +``` + +### वर्णानुक्रम + +- जब एक ही अक्षर से शुरू होने वाले कई शीर्षक हों, तो उन्हें दूसरे अक्षर से क्रमित करें, और इसी तरह आगे भी। उदाहरण के लिए: `aa` `ab` से पहले आता है। +- `one two`, `onetwo` से पहले आता है। + +यदि आपको कोई गलत लिंक दिखाई देता है, तो लिंटर त्रुटि संदेश की जाँच करें ताकि पता चल सके कि किन पंक्तियों को बदला जाना चाहिए। + +### नोट्स + +जबकि मूल बातें अपेक्षाकृत सरल हैं, हमारे द्वारा सूचीबद्ध संसाधनों में बहुत विविधता है। यहाँ कुछ नोट्स दिए गए हैं कि हम इस विविधता से कैसे निपटते हैं। + +#### मेटाडेटा + +हमारी सूचियाँ मेटाडेटा का एक न्यूनतम सेट प्रदान करती हैं: शीर्षक, URL, निर्माता, प्लेटफ़ॉर्म और एक्सेस नोट्स। + +##### शीर्षक + +- कोई आविष्कृत शीर्षक नहीं। हम संसाधनों से ही शीर्षक लेने का प्रयास करते हैं; योगदानकर्ताओं को सलाह दी जाती है कि वे शीर्षकों का आविष्कार न करें या यदि ऐसा किया जा सकता है तो उन्हें संपादकीय रूप से उपयोग न करें। अपवाद पुराने कार्यों के लिए है; यदि वे मुख्य रूप से ऐतिहासिक रुचि के हैं, तो शीर्षक में कोष्ठक में एक वर्ष जोड़ने से उपयोगकर्ताओं को यह पता चलता है कि वे रुचि के हैं या नहीं। +- कोई ALLCAPS शीर्षक नहीं। आमतौर पर शीर्षक केस उपयुक्त होता है, लेकिन जब संदेह हो तो स्रोत से कैपिटलाइज़ेशन का उपयोग करें। +- कोई इमोजी नहीं। + +##### URL + +- हम संक्षिप्त URL की अनुमति नहीं देते हैं। +- URL से ट्रैकिंग कोड हटाए जाने चाहिए। +- अंतर्राष्ट्रीय URL को एस्केप किया जाना चाहिए। ब्राउज़र बार आमतौर पर इन्हें यूनिकोड में प्रस्तुत करते हैं, लेकिन कृपया कॉपी और पेस्ट का उपयोग करें। +- सुरक्षित (`https`) URL हमेशा गैर-सुरक्षित (`http`) URL से बेहतर होते हैं, जहाँ HTTPS लागू किया गया है। +- हमें ऐसे URL पसंद नहीं हैं जो सूचीबद्ध संसाधन को होस्ट न करने वाले वेबपेजों की ओर इशारा करते हैं, बल्कि इसके बजाय कहीं और इंगित करते हैं। + +##### निर्माता + +- हम जहाँ उचित हो, अनुवादकों सहित मुफ़्त संसाधनों के रचनाकारों को श्रेय देना चाहते हैं! +- अनुवादित कार्यों के लिए मूल लेखक को श्रेय दिया जाना चाहिए। हम लेखकों के अलावा अन्य रचनाकारों को श्रेय देने के लिए [MARC रिलेटर](https://loc.gov/marc/relators/relaterm.html) का उपयोग करने की सलाह देते हैं, जैसा कि इस उदाहरण में है: + +```markdown +* [एक अनुवादित पुस्तक](http://example.com/book.html) - जॉन डो, `trl.:` माइक द ट्रांसलेटर + + +##### समय-सीमित पाठ्यक्रम और परीक्षण + +- हम उन चीज़ों को सूचीबद्ध नहीं करते हैं जिन्हें हमें छह महीने में हटाना होगा। +- यदि किसी पाठ्यक्रम की नामांकन अवधि या अवधि सीमित है, तो हम उसे सूचीबद्ध नहीं करेंगे। +- हम उन संसाधनों को सूचीबद्ध नहीं कर सकते जो सीमित अवधि के लिए निःशुल्क हैं। + +##### प्लेटफ़ॉर्म और एक्सेस नोट्स + +- **पाठ्यक्रम**: खास तौर पर हमारे कोर्स लिस्ट के लिए, प्लेटफ़ॉर्म संसाधन विवरण का एक महत्वपूर्ण हिस्सा है। ऐसा इसलिए है क्योंकि कोर्स प्लेटफ़ॉर्म में अलग-अलग एफोर्डेंस और एक्सेस मॉडल होते हैं। जबकि हम आम तौर पर ऐसी किताब को लिस्ट नहीं करेंगे जिसके लिए रजिस्ट्रेशन की ज़रूरत होती है, कई कोर्स प्लेटफ़ॉर्म में ऐसे एफोर्डेंस होते हैं जो किसी तरह के अकाउंट के बिना काम नहीं करते। उदाहरण के लिए कोर्स प्लेटफ़ॉर्म में कोर्सेरा, एडएक्स, उदासिटी और यूडेमी शामिल हैं। जब कोई कोर्स किसी प्लेटफ़ॉर्म पर निर्भर करता है, तो प्लेटफ़ॉर्म का नाम कोष्ठक में सूचीबद्ध किया जाना चाहिए। + +- **YouTube**: हमारे पास कई कोर्स हैं जिनमें YouTube प्लेलिस्ट शामिल हैं। हम YouTube को प्लेटफ़ॉर्म के तौर पर लिस्ट नहीं करते, हम YouTube क्रिएटर को लिस्ट करने की कोशिश करते हैं, जो अक्सर एक सब-प्लेटफ़ॉर्म होता है। + +- **YouTube वीडियो**: हम आम तौर पर अलग-अलग YouTube वीडियो को तब तक लिंक नहीं करते जब तक कि वे एक घंटे से ज़्यादा लंबे न हों और कोर्स या ट्यूटोरियल की तरह संरचित न हों। अगर ऐसा है, तो PR विवरण में इसका नोट ज़रूर करें। + +- कोई छोटा लिंक नहीं (यानी youtu.be/xxxx)! + +- **Leanpub**: Leanpub कई तरह के एक्सेस मॉडल के साथ पुस्तकों को होस्ट करता है। कभी-कभी कोई पुस्तक बिना पंजीकरण के पढ़ी जा सकती है; कभी-कभी किसी पुस्तक को निःशुल्क एक्सेस के लिए Leanpub खाते की आवश्यकता होती है। पुस्तकों की गुणवत्ता और Leanpub एक्सेस मॉडल के मिश्रण और तरलता को देखते हुए, हम एक्सेस नोट `*(Leanpub खाता या वैध ईमेल अनुरोधित)*` के साथ उत्तरार्द्ध को सूचीबद्ध करने की अनुमति देते हैं। + +#### शैलियाँ + +किसी संसाधन को किस सूची में शामिल किया जाना है, यह तय करने का पहला नियम यह देखना है कि संसाधन खुद को कैसे वर्णित करता है। अगर यह खुद को एक पुस्तक कहता है, तो शायद यह एक पुस्तक है। + +##### शैलियाँ जिन्हें हम सूचीबद्ध नहीं करते + +चूँकि इंटरनेट बहुत बड़ा है, इसलिए हम अपनी सूचियों में शामिल नहीं करते: + +- ब्लॉग +- ब्लॉग पोस्ट +- लेख +- वेबसाइटें (उन लोगों को छोड़कर जो हमारे द्वारा सूचीबद्ध बहुत सारी वस्तुओं को होस्ट करते हैं)। +- वीडियो जो पाठ्यक्रम या स्क्रीनकास्ट नहीं हैं। +- पुस्तक अध्याय +- पुस्तकों से टीज़र नमूने +- IRC या टेलीग्राम चैनल +- स्लैक्स या मेलिंग सूचियाँ + +हमारी प्रतिस्पर्धी प्रोग्रामिंग सूचियाँ इन बहिष्करणों के बारे में उतनी सख्त नहीं हैं। रेपो का दायरा समुदाय द्वारा निर्धारित किया जाता है; यदि आप दायरे में कोई बदलाव या अतिरिक्त सुझाव देना चाहते हैं, तो कृपया सुझाव देने के लिए किसी समस्या का उपयोग करें। + +##### पुस्तकें बनाम अन्य सामग्री + +हम पुस्तक-पन के बारे में इतने ज़्यादा चिंतित नहीं हैं। यहाँ कुछ विशेषताएँ दी गई हैं जो दर्शाती हैं कि संसाधन एक पुस्तक है: + +- इसमें ISBN (अंतर्राष्ट्रीय मानक पुस्तक संख्या) है। +- इसमें विषय-सूची है। +- एक डाउनलोड करने योग्य संस्करण पेश किया जाता है, विशेष रूप से ePub फ़ाइलें। +- इसमें संस्करण हैं। +- यह इंटरैक्टिव सामग्री या वीडियो पर निर्भर नहीं करता है। +- यह किसी विषय को व्यापक रूप से कवर करने का प्रयास करता है। +- यह स्व-निहित है। + +ऐसी बहुत सी पुस्तकें हैं जिन्हें हम सूचीबद्ध करते हैं जिनमें ये विशेषताएँ नहीं हैं; यह संदर्भ पर निर्भर कर सकता है। + +##### पुस्तकें बनाम पाठ्यक्रम + +कभी-कभी इन्हें अलग करना मुश्किल हो सकता है! + +पाठ्यक्रमों में अक्सर संबंधित पाठ्यपुस्तकें होती हैं, जिन्हें हम अपनी पुस्तकों की सूची में सूचीबद्ध करेंगे। पाठ्यक्रमों में व्याख्यान, अभ्यास, परीक्षण, नोट्स या अन्य शिक्षाप्रद सहायक सामग्री होती है। एक व्याख्यान या वीडियो अपने आप में एक पाठ्यक्रम नहीं है। पावरपॉइंट एक पाठ्यक्रम नहीं है। + +##### इंटरैक्टिव ट्यूटोरियल बनाम अन्य सामान + +यदि आप इसे प्रिंट कर सकते हैं और इसका सार बनाए रख सकते हैं, तो यह एक इंटरैक्टिव ट्यूटोरियल नहीं है। + +### स्वचालन + +- स्वरूपण नियम प्रवर्तन [GitHub क्रियाएँ](https://github.com/features/actions) के माध्यम से [fpb-lint](https://github.com/vhf/free-programming-books-lint) का उपयोग करके स्वचालित है (देखें [`.github/workflows/fpb-lint.yml`](../.github/workflows/fpb-lint.yml)) +- URL सत्यापन [awesome_bot](https://github.com/dkhamsing/awesome_bot) का उपयोग करता है। +- URL सत्यापन को ट्रिगर करने के लिए, एक कमिट पुश करें जिसमें `check_urls=file_to_check` युक्त कमिट संदेश शामिल हो: + + ```properties + check_urls=free-programming-books.md free-programming-books-en.md + ``` + +- आप जाँच करने के लिए एक से अधिक फ़ाइल निर्दिष्ट कर सकते हैं, एक का उपयोग करके प्रत्येक प्रविष्टि को अलग करने के लिए एकल स्थान। +- यदि आप एक से अधिक फ़ाइल निर्दिष्ट करते हैं, तो बिल्ड के परिणाम अंतिम जाँच की गई फ़ाइल के परिणाम पर आधारित होते हैं। आपको पता होना चाहिए कि इसके कारण आपको पासिंग ग्रीन बिल्ड मिल सकते हैं, इसलिए "सभी जाँच दिखाएँ" -> "विवरण" पर क्लिक करके पुल अनुरोध के अंत में बिल्ड लॉग का निरीक्षण करना सुनिश्चित करें।