8.2 Git’i Fərdiləşdirmək - Git Atributları

Bəzi fayllar mətn fayllarına bənzəyir, lakin bütün məqsədlər üçün binary məlumat kimi qəbul edilməlidir. Məsələn, macOS-dakı Xcode layihələri, .pbxproj ilə bitən, əsasən IDE tərəfindən diskə yazılmış bir JSON (düz mətnli JavaScript məlumat formatı) verilənlər bazası olan bir sənəd ehtiva edir və s. Texniki cəhətdən bir mətn faylı olmasına baxmayaraq (hamısı UTF-8 olduğu üçün), həqiqətən lightweight bir verilənlər bazası olduğu üçün bu şəkildə davranmaq istəmirsiniz - iki nəfər dəyişsə məzmunu birləşdirə bilməzsiniz və fərqlər ümumiyyətlə faydalı deyil. Fayl bir maşın tərəfindən istehlak edilməlidir. Əslində, binary bir fayl kimi davranmaq istəyirsiz. Git-ə bütün pbxproj fayllarını binary məlumatlar kimi qəbul etməsini söyləmək üçün .gitattributes faylınıza aşağıdakı sətri əlavə edin:

İndi Git, CRLF problemlərini çevirməyə və ya düzəltməyə çalışmayacaq; proyektinizdə git show və ya git diff işlətdiyiniz zaman bu fayldakı dəyişikliklər üçün bir fərqi hesablamağa və ya çap etməyə çalışmayacaq.

Binary faylları effektiv şəkildə ayırmaq üçün Git atributları funksiyasından da istifadə edə bilərsiniz. Bunu Git-ə binary məlumatlarınızı normal fərq ilə müqayisə edilə bilən bir mətn formatına necə çevirəcəyinizi söyləyərək edirsiniz.

Birincisi, bu texnikanı insana məlum olan ən əsəbi problemlərdən birini həll etmək üçün istifadə edəcəksiniz: Microsoft Word sənədlərinin versiyaya nəzarəti. Hər kəs Word-un ətrafındakı ən qorxunc redaktor olduğunu bilir, amma qəribədir ki, hər kəs hələ də onu istifadə edir. Word sənədlərini versiya ilə idarə etmək istəyirsinizsə, onları Git deposuna saxlaya və bir dəfəyə edə bilərsiniz; bəs bunun nə faydası var? Normal olaraq git diff işlədirsinizsə, yalnız belə bir şey görürsünüz:

Əgər yoxlamamısınız və manual olaraq skan etməmisinizsə, iki versiyanı birbaşa müqayisə edə bilməzsiniz, düzdür? Bunu Git atributlarından istifadə edərək kifayət qədər yaxşı edə biləcəyiniz ortaya çıxdı. Aşağıdakı sətri .gitattributes faylınıza əlavə edin:

Bu, Git-ə, bu pattern ilə (.docx) uyğun gələn hər hansı bir faylın dəyişiklikləri ehtiva edən bir fərqə baxmağa çalışdığınız zaman “word” filterindən istifadə etməsi lazım olduğunu bildirir. “word” filteri nədir? Siz bunu qurmalısınız. Burada Git’i Word sənədlərini oxunaqlı mətn sənədlərinə çevirmək üçün docx2txt proqramından istifadə etmək üçün konfiqurasiya edəcəksiniz, daha sonra düzgün şəkildə fərqlənəcəkdir.

Əvvəlcə docx2txt yükləməlisiniz; https://sourceforge.net/projects/docx2txt saytından yükləyə bilərsiniz. Shell-nizin tapa biləcəyi bir yerə qoymaq üçün INSTALL faylındakı təlimatları izləyin. Sonra çıxışı Git-in gözlədiyi formata çevirmək üçün bir wrapper skript yazacaqsınız. Yolunuzda bir yerdə docx2txt adlı bir sənəd yaradın və bu məzmunu əlavə edin:

Bu faylı chmod a+x etməyi unutmayın. Nəhayət, Git’i bu skriptdən istifadə etmək üçün konfiqurasiya edə bilərsiniz:

İndi Git bilir ki, iki snapshot arasında bir fərq yaratmağa çalışarsa və hər hansı bir sənəd .docx ilə bitərsə, bu sənədləri docx2txt proqramı olaraq təyin olunan “word” filterindən keçirməlidir. Bu, onları fərqləndirməyə çalışmadan əvvəl Word sənədlərinizin gözəl mətn əsaslı versiyalarını effektiv şəkildə hazırlayır.

Nümunə: Bu kitabın 1-ci fəsli Word formatına çevrildi və Git deposunda hazırlandı. Sonra yeni bir abzas əlavə edildi. git diff nəyi göstərdiyinə baxaq:

Git uğurla və qısaca olaraq bizə “Testing: 1, 2, 3.” string-i əlavə etdiyimizi söyləyir, bu düzgündür. Bu təbii ki mükəmməl deyil — formatlaşdırma dəyişiklikləri burada görünməyəcək - amma əlbəttə ki, işləyir.

Bu şəkildə həll edə biləcəyiniz bir başqa maraqlı problem, şəkil sənədlərinin diffing edilməsidir. Bunu etmək üçün bir üsul, şəkil sənədlərini EXIF məlumatlarını çıxaran bir filtrdən keçirməkdir - əksər şəkil formatları ilə qeyd olunan metadata. exiftool proqramını yüklədiyiniz və yüklədiyiniz təqdirdə, şəkillərinizi metadata aid mətnə çevirmək üçün istifadə edə bilərsiniz, beləliklə ən azı fərq sizə baş verən bütün dəyişikliklərin mətn şəklində göstərilməsini göstərəcəkdir. Aşağıdakı sətri .gitattributes faylınıza qoyun:

Bu aləti istifadə etmək üçün Git’i konfiqurasiya edin:

Layihənizdəki bir şəkli əvəz edib git diff işlədirsinizsə, belə bir şey görürsünüz:

Fayl ölçüsünün və şəkil ölçülərinin hər ikisinin dəyişdiyini asanlıqla görə bilərsiniz.

Arxiv yaradan zaman Git-ə müəyyən faylları və ya qovluqları ixrac etməməsini deyə bilərsiniz. Arxiv sənədinizə daxil etmək istəmədiyiniz, ancaq layihənizə baxılmasını istədiyiniz bir subdirectory və ya bir sənəd varsa, bu faylları export-ignore atributu ilə təyin edə bilərsiniz.

Məsələn, bir test/ subdirectory-da bəzi test sənədləriniz olduğunu və bunları layihənizin tarball ixracatına daxil etməyin mənasız olduğunu söyləyin. Git atributları sənədinizə aşağıdakı sətri əlavə edə bilərsiniz:

İndi layihənizin bir tarball-unu yaratmaq üçün git archive işə saldığınız zaman, bu qovluq arxivə daxil edilməyəcəkdir.

Deployment üçün faylları ixrac edərkən, export-subst atributu ilə işarələnmiş seçilmiş fayl hissələrinə git log formatlaşdırma və keyword-expansion işləmə tətbiq edə bilərsiniz.

Məsələn, layihənizə LAST_COMMIT adlı bir sənəd əlavə etmək və git archive işə salındıqda avtomatik olaraq ona enjekte edilmiş son commit barədə metadata sahib olmaq istəyirsinizsə, məsələn, .gitattributes and LAST_COMMIT qura bilərsiniz:

git archive işlədiyiniz zaman arxivləşdirilmiş sənədin məzmunu belə görünür:

Əvəzetmələrə, məsələn, commit mesajı və hər hansı bir git notes daxil ola bilər və git log sadə word wrapping edə bilər:

Nəticədə yaradılan arxiv yerləşdirmə işləri üçün əlverişlidir, lakin ixrac olunan hər hansı bir arxiv kimi uyğundur, daha da inkişaf etdirmək üçün uyğun deyil.