வலைபெயர்ப்பு தொகுதிகளுக்கு பங்களிக்கிறது¶
முக்கிய களஞ்சியத்தைத் தவிர, வலைபெயர்ப்பு பல பைத்தான் தொகுதிகளைக் கொண்டுள்ளது. இவை அனைத்தும் ஒரே கட்டமைப்பைப் பின்பற்றுகின்றன, மேலும் இந்த ஆவணம் அவை அனைத்தையும் உள்ளடக்கியது.
எடுத்துக்காட்டாக, இது பின்வருவனவற்றை உள்ளடக்குகிறது:
wlc, பைதான் கிளையன்ட் லைப்ரரி, பார்க்க வலைபெயர்ப்பு கிளையன்ட்
translation-finder, களஞ்சியத்தில் மொழிபெயர்க்கக்கூடிய கோப்புகளைக் கண்டறியப் பயன்படுகிறது
language-data, Weblateக்கான மொழி வரையறைகள், பார்க்க மொழி வரையறைகள்
translate-toolkit, மொழிபெயர்ப்பு கோப்புகளை கையாளும் நூலகம், முதலில் மூன்றாம் தரப்பு நூலகம் ஆனால் இப்போது Weblate மூலம் பராமரிக்கப்படுகிறது.
உள்ளமைக்கப்பட்ட மொழி வரையறைகளை விரிவுபடுத்துதல்¶
மொழி வரையறைகள் மொழி-தரவு களஞ்சியத்தில் உள்ளன.
விடுபட்ட மொழி வரையறைகளை languages.csv இல் சேர்க்க நீங்கள் வரவேற்கப்படுகிறீர்கள், அந்தக் கோப்பிலிருந்து பிற கோப்புகள் உருவாக்கப்படுகின்றன. காபிம கோப்பில் உள்ள நெடுவரிசைகள் மொழி வரையறைகள் உடன் ஒத்திருக்கும்.
உரிமம் மற்றும் பதிப்புரிமை¶
When contributing project code, you agree to put your changes and new code under the repository license, GPL-3.0-or-later, unless stated and agreed otherwise. New source files should follow the existing copyright and SPDX license header style.
Use a different license only when there is a deliberate reason, such as files shared with repositories using more permissive licenses.
See also
வலைபெயர்ப்பு உரிமம் கூடுதல் விவரங்களில் உரிமத்தை விளக்குகிறது.
ஒரு நல்ல இணைப்பு எழுதுதல்¶
தனி மாற்றங்களை எழுதுங்கள்¶
11 ஒற்றைப்படை சிக்கல்களை சரிசெய்வதாகக் கூறப்படும் ஒரு பெரிய பேட்சைப் பெறும்போது அது எரிச்சலூட்டுகிறது, ஆனால் விவாதங்களும் கருத்துக்களும் அவர்களில் 10 பேருடன் உடன்படவில்லை அல்லது அவர்களில் 9 பேர் ஏற்கனவே வித்தியாசமாக சரி செய்யப்பட்டுள்ளனர். இந்த மாற்றத்தை ஒன்றிணைக்கும் நபர் ஒற்றை சுவையான இணைப்பை எங்காவது இருந்து பிரமாண்டமான ஆதாரங்களின் குவியலுக்குள் பிரித்தெடுக்க வேண்டும், மேலும் இது நிறைய கூடுதல் வேலைகளை உருவாக்குகிறது.
முன்னுரிமை, ஒரு சிக்கலை நிவர்த்தி செய்யும் ஒவ்வொரு பிழைத்திருத்தமும் அதன் சொந்த விளக்கில் இருக்க வேண்டும்/அதன் சொந்த விளக்கத்துடன்/செய்திகளை அவர்கள் சரிசெய்ததை சரியாகக் குறிப்பிட வேண்டும், இதனால் அனைத்து மாற்றங்களும் பராமரிப்பாளர் அல்லது பிற ஆர்வமுள்ள தரப்பினரால் தேர்ந்தெடுக்கப்பட்டதாகப் பயன்படுத்தப்படலாம்.
மேலும், தனித்தனி மாற்றங்கள் எதிர்காலத்தில் சிக்கல்களையும் பின்னடைவையும் கண்காணிக்க மிகவும் சிறப்பாக பிரிக்க உதவுகின்றன.
ஆவணப்படுத்துதல்¶
ஆவணங்கள் ஒரு கடினமான பணியாக இருக்கலாம்; இருப்பினும், யாராவது அதை முடிக்க வேண்டியது தேவை. குறியீடு மாற்றங்களுடன் ஆவணங்களை நீங்கள் சமர்ப்பித்தால் அது விசயங்களை மிகவும் எளிதாக்குகிறது. ஆவண முறைகள், சிக்கலான குறியீடு தொகுதிகள் அல்லது பயனர் காணக்கூடிய அம்சங்களுக்கு நினைவில் கொள்க.
சோதனை வழக்குகள்¶
சோதனைகள் நற்பொருத்தங்கள் அவை செயல்படுகின்றன என்பதை விரைவாக சரிபார்க்க அனுமதிக்கின்றன. இந்த சூழ்நிலையை பராமரிக்கவும், அதை மேம்படுத்தவும், சேர்க்கப்பட்ட அனைத்து புதிய நற்பொருத்தங்கள் மற்றும் செயல்பாடுகள் சோதனை தொகுப்பில் சோதிக்கப்பட வேண்டும். சேர்க்கப்பட்ட ஒவ்வொரு அம்சமும் குறைந்தது ஒரு செல்லுபடியாகும் சோதனை வழக்கைப் பெற வேண்டும், அது ஆவணப்படுத்தப்பட்டதாக செயல்படுகிறது என்பதை சரிபார்க்கிறது.
செய்திகளைச் செய்யுங்கள்¶
Git கமிட்கள் Conventional Commits விவரக்குறிப்பைப் பின்பற்ற வேண்டும்.
வகை சரிபார்த்தல்¶
Any new code should utilize PEP 484 type hints. We are using mypy to check them because it has a Django plugin that makes type checking of Django apps practical.
New and changed code should not introduce new mypy failures where current Django typing support makes that practical. The code base is not yet completely covered by type annotations, and some Django constructs are difficult to annotate precisely. CI therefore enforces mypy only for selected modules and reports other findings separately.
குறியீட்டு மற்றும் குறியீட்டைக் குறைத்தல்¶
குறியீடு PEP 8 குறியீட்டு வழிகாட்டுதல்களைப் பின்பற்ற வேண்டும் மற்றும் ruff குறியீடு வடிவமைப்பைப் பயன்படுத்தி வடிவமைக்கப்பட வேண்டும்.
குறியீட்டின் தரத்தை சரிபார்க்க, நீங்கள் ruff ஐப் பயன்படுத்தலாம், அதன் கட்டமைப்பு pyproject.toml இல் சேமிக்கப்படும்.
இவை அனைத்தையும் செயல்படுத்த எளிதான அணுகுமுறை prek ஐ நிறுவுவது. இது வலைபெயர்ப்பு பயன்படுத்தும் pre-commit கருவியின் மூன்றாம் தரப்பு மறுசீரமைப்பு ஆகும். இது pyproject.toml இல் அறிவிக்கப்பட்ட வளர்ச்சி சார்புகளில் சேர்க்கப்பட்டுள்ளது, எனவே அந்த சார்புகளை நிறுவுவது prek கிடைக்கும்.
எல்லா கோப்புகளையும் கைமுறையாக சரிபார்க்க, இயக்கவும்:
uv run prek run --all-files
அசல் pre-commit கிளையண்டை நீங்கள் விரும்பினால், அது .pre-commit-config.yaml இலிருந்து அதே உள்ளமைவைப் பயன்படுத்துகிறது.
பாதுகாப்பாக குறியீட்டு¶
Weblateக்கான எந்தக் குறியீடும் வடிவமைப்புக் கோட்பாடுகளின் பாதுகாப்பு என்பதை மனதில் வைத்து எழுத வேண்டும்.
AI வழிகாட்டுதல்கள்¶
திட்டத்திற்கு உள்ளடக்கத்தை பங்களிக்கும்போது, அதைப் பயன்படுத்த எங்களுக்கு இசைவு அளிக்கிறீர்கள், அதை எங்களுக்கு விநியோகிக்க நீங்கள் அனுமதிக்கப்படுவதை உறுதிசெய்கிறீர்கள். எங்களுக்கு ஒரு மாற்றத்தை சமர்ப்பிப்பதன் மூலம், மாற்றங்கள் திட்டத்தால் ஏற்றுக்கொள்ளப்படலாம் மற்றும் ஏற்றுக்கொள்ளப்பட வேண்டும் என்பதை ஒப்புக்கொள்கிறீர்கள் மற்றும் திட்ட உரிமத்தின் கீழ் மறுபகிர்வு செய்யப்பட வேண்டும். உரிமம் பெறாத குறியீடு எதுவும் திட்டத்திற்கு சமர்ப்பிக்கப்படவில்லை என்பதை உறுதிப்படுத்த சுமை அவர்கள் மீது உள்ளது என்பதை ஆசிரியர்கள் வெளிப்படையாக அறிந்திருக்க வேண்டும்.
இது AI பயன்படுத்தப்படுகிறதா இல்லையா என்பதிலிருந்து சுயாதீனமாக உள்ளது.
ஒரு இழுப்பு கோரிக்கையை பங்களிக்கும்போது, நிச்சயமாக, முன்மொழிவு நல்ல தகுதி வாய்ந்தது என்பதையும், எங்கள் வழிகாட்டுதல்களைப் பின்பற்றும் சிறந்த முயற்சி என்பதையும் நீங்கள் எப்போதும் உறுதிப்படுத்த வேண்டும். கட்டைவிரல் ஒரு அடிப்படை விதி என்னவென்றால், AI இன் உதவியுடன் பங்களிப்பு செய்யப்பட்டது என்பதை யாராவது கண்டுபிடிக்க முடிந்தால், உங்களுக்கு அதிக வேலை இருக்கிறது.
திட்டத்தில் AI உதவியுடன் எழுதப்பட்ட குறியீட்டை நாங்கள் ஏற்றுக்கொள்ளலாம், ஆனால் குறியீடு இன்னும் குறியீட்டு தரங்களைப் பின்பற்ற வேண்டும், தெளிவாக எழுதப்பட வேண்டும், ஆவணப்படுத்தப்பட வேண்டும், அம்ச சோதனை வழக்குகள் மற்றும் நம்மிடம் உள்ள அனைத்து சாதாரண தேவைகளையும் பின்பற்ற வேண்டும்.