गिट रिपॉजिटरी एन्कोडिंग को बदलना

नमस्कार। बारीकियों के कारण, KOI8-R के साथ लिनक्स का उपयोग काम पर किया जाता है, git रिपॉजिटरी में सभी कम्यूट स्थानीय एन्कोडिंग में किए गए थे। कुछ समय बाद, रिपॉजिटरी को UTF-8 में ट्रांसकोड करने का निर्णय लिया गया। इस लेख में मैं एक मौजूदा गिट रिपॉजिटरी के एन्कोडिंग को बदलने के लिए प्रौद्योगिकी पर चर्चा करना चाहता हूं, साथ ही कुछ कमिट में किए गए कुछ त्रुटियों का सुधार भी करना चाहता हूं।

चेतावनी

वास्तव में, एक नया रिपॉजिटरी बनाया जाएगा, तदनुसार, प्रक्रिया से पहले, वर्तमान विकास को निलंबित करना आवश्यक है, सभी परिवर्तनों को एक सशर्त रूप से केंद्रीय रिपॉजिटरी में मर्ज करें, जिसमें हम ट्रांसकोड करेंगे। प्राप्त रिपॉजिटरी की जांच करने के बाद, इसे सभी मशीनों पर फिर से क्लोन करना आवश्यक होगा।

गिट और एन्कोडिंग

Git बाइनरी डेटा के साथ संचालित होता है, इसलिए, यह फ़ाइलों के एन्कोडिंग के साथ बातचीत नहीं करता है, जहां तक ​​प्रतिबद्ध टिप्पणियों का संबंध है, यह उन्हें इस रूप में भी बचाता है कि हमने उन्हें इसे पारित किया था, लेकिन प्रत्येक प्रतिबद्ध के लिए, encoding हेडर भरा हुआ है, जिसे बाद में उपयोग किया जा सकता है टिप्पणियों का अनुरोध करते समय। यदि encoding हेडर खाली है, तो गिट इसे UTF-8 के बराबर मानता है।

कॉन्फ़िगर करने के लिए, [i18n] अनुभाग में दो पैरामीटर स्थित हैं:

 [i18n] commitencoding = UTF-8 logoutputencoding = KOI8-R 

उनमें से पहला सिर्फ git commit और git commit-tree कमांड के लिए एन्कोडिंग हेडर की सामग्री को सेट करता है, दूसरा git log , git show , git blame कमांड को बताता है जिसमें उपयोगकर्ता को दिखाए जाने से पहले टिप्पणी पाठ को एन्कोड किया जाना चाहिए। यदि कोई भी पैरामीटर निर्दिष्ट नहीं है, तो git logoutputencoding UTF-8 मानता है, हालाँकि, यदि केवल पहला पैरामीटर सेट किया गया है, तो git दूसरे के लिए भी इसके मूल्य का उपयोग करता है।

इस वजह से, विभिन्न त्रुटियां हो सकती हैं - उदाहरण के लिए, यदि encoding हेडर टिप्पणी के एन्कोडिंग से मेल नहीं खाता है, लेकिन logoutputencoding पैरामीटर के मूल्य के बराबर है, तो गिट तय करेगा कि ट्रांसकोडिंग की आवश्यकता नहीं है और टिप्पणी पाठ को प्रदर्शित करें, क्रमशः, लोकेल के साथ मशीनों पर उसी पर सेट करें एक टिप्पणी के रूप में एन्कोडिंग, सामग्री को सही ढंग से प्रदर्शित किया जाएगा, हालांकि अन्य सभी पर कचरा होगा।

हेडर encoding टिप्पणियों के मूल्य को देखने के लिए, आप निम्न कमांड का उपयोग कर सकते हैं:

 git log –pretty=”%h - '%e': %s” 

आप यहाँ git log कमांड की विशेषताओं के बारे में अधिक पढ़ सकते हैं।

Git फ़िल्टर-शाखा

तो, हम इस लेख के मुख्य विषय पर आते हैं। मौजूदा रिपॉजिटरी के "इतिहास को फिर से लिखने" के लिए, git filter-branch कमांड का उपयोग किया जाता है। यह आपको विभिन्न फिल्टर के साथ फाइल या मेटा-डेटा को संसाधित करने के द्वारा किए गए सभी कमिट को क्रमिक रूप से दोहराने की अनुमति देता है।

इस लेख में तीन फ़िल्टर का उपयोग किया गया है:

• --msg-filter - टिप्पणी के पाठ को अधिलेखित करने के लिए उपयोग किया जाता है;
• --env-filter - अगर पर्यावरण को कमिट करने के लिए ज़रूरी है तो इसका इस्तेमाल किया जाता है (लेखक का नाम, ईमेल पता इत्यादि);
• --tag-name-filter - का उपयोग टैग पाठों को अधिलेखित करने के लिए किया जाता है।

प्रत्येक फ़िल्टर के बाद, एक आदेश दिया जाता है कि git filter-branch प्रतिबद्ध लिखने से पहले निष्पादित करेगी।

संपूर्ण रिपॉजिटरी के माध्यम से जाने के लिए, आपको --all पैरामीटर को निर्दिष्ट करने की आवश्यकता है, इसे फिल्टर से अतिरिक्त लोगों के साथ अलग करना, HEAD को लक्ष्य के रूप में निर्दिष्ट करें और नए कमिट के अनुसार टैग को अधिलेखित करें। ऐसा करने के लिए, cat साथ tag-name फ़िल्टर जोड़ें:

 git filter-branch <> --tag-name-filter 'cat' -- --all HEAD 

टिप्पणियों के एन्कोडिंग को बदलने से पहले, i18n.commitencoding निर्देश के सही मूल्य को सेट करना न भूलें - यह रिपॉजिटरी ऑपरेशन पूरा होने के बाद प्राप्त सभी हेडर में लिखा जाएगा।

टिप्पणी एन्कोडिंग को परिवर्तित करने के लिए, निम्नलिखित कमांड का उपयोग करें:

 'iconv -c -s -f KOI8-R -t UTF-8' 

• s - साइलेंट मोड;
• c - ऐसे वर्णों को छोड़ें जिन्हें परिवर्तित नहीं किया जा सकता है।

git filter-branch कमांड निम्न रूप लेता है:

 git filter-branch --msg-filter 'iconv -c -s -f KOI8-R -t UTF-8' \ --tag-name-filter 'cat' -- --all HEAD 

चूंकि "पुनर्लेखन इतिहास" का संचालन मोटे तौर पर वर्कफ़्लो के साथ हस्तक्षेप करता है, यह समझ में आता है (यदि आप अभी भी इसे बनाने का निर्णय लेते हैं) तो अधिकतम त्रुटियों को ठीक करने का प्रयास करें। ये गलत तरीके से पर्यावरण पैरामीटर सेट कर सकते हैं, भंडार में संग्रहीत फाइलें जो कि नहीं होनी चाहिए, एन्कोडिंग या व्यक्तिगत फ़ाइलों के डेटा का हिस्सा, आदि।

विशेष रूप से, मैंने पाया कि लेखक का ई-मेल गलत तरीके से एक-दूसरे के लिए सेट किया गया था। चूँकि उस समय मेरे द्वारा सभी कमिट बनाए गए थे, इस समस्या को सभी कमिटियों में इस पैरामीटर को ओवरराइट करके हल किया गया था:

 git filter-branch --msg-filter 'iconv -c -s -f KOI8-R -t UTF-8' \ --env-filter 'export GIT_AUTHOR_EMAIL="xxx@gmail.com" export GIT_COMMITTER_EMAIL="xxx@gmail.com"' \ --tag-name-filter 'cat' -- --all HEAD 

लेकिन स्वाभाविक रूप से, कोई भी विभिन्न परिस्थितियों, आदि के साथ अधिक जटिल संरचनाओं का उपयोग करने के लिए परेशान नहीं करता है।

सामान्य तौर पर, git filter-branch कमांड git रिपॉजिटरी को संशोधित / ठीक करने के लिए बहुत समृद्ध कार्यक्षमता प्रदान करता है। आप यहां इसकी सभी विशेषताओं के बारे में पढ़ सकते हैं।