Grubby boş Git repozitoriyalarından statik saytlar yaradır

Boş Git repozitoriyalarından statik saytlar

Grubby Git repozitoriyaları üçün Ruby ilə yazılmış statik saytlar generatorudur. O, RepoRat-dan fork edilib və böyük dərəcədə ondan ilham alıb. Grubby hər boş Git repozitoriyası üçün veb sayt yaradır və əsas repozitoriyalar indeksini hazırlayır.

Layihə Git, Ruby 3.0 və ya daha yeni versiya ilə Kramdown tələb edir. O, minimal konfiqurasiya ilə öz baxışına uyğun qurulmuş həll kimi yaradılıb. Kramdown standart Markdown parserdir, lakin onun əvəz olunması mümkündür, yalnız alternativ parserlərin səhvsiz işləyəcəyinə zəmanət yoxdur.

Konfiqurasiya və çıxış

Grubby boş Git repozitoriyalarının qovluqlarının .git uzantısı ilə bitdiyini güman edir. Onun əsas repozitoriyalar indeksini yaradılması bu adlandırma qaydası olmadan düzgün işləməyə bilər. Əsas konfiqurasiya faylı _config.yml-dir və əsas domen və yolların qurulması üçün istifadə olunur.

Standart olaraq repozitoriyalar indeksi əsas kataloğun kökdə yerləşir və index.html adlanır. Onun çıxış faylının adı _config.yml-də dəyişdirilə bilər. Yaradılmış saytların görünüşünü və ya naviqasiyasını dəyişdirmək istəyən istifadəçilər style.css, _header.html və _footer.html fayllarını dəyişə bilər.

Git hook-ları ilə saytların yaradılması

İstifadə təlimatı işin NearlyFreeSpeech.NET paylaşılan hostinq ilə olduğunu güman edir, lakin proses şəxsi VPS-də kimi təsvir edilib. Onun nümunəsində boş repozitoriyalar /home/public/git.sitename.org qovluğunda saxlanılır. Grubby özü şəxsi kataloğa klonlanır, proses isə boş repozitoriyanın dərinindən işə salınır.

Repozitoriyanın hooks qovluğunda post-update hook yaradılır və ona icazə verilir. Skript GIT_DIR-i ləğv edir, git update-server-info işə salır, cari repozitoriyanı müvəqqəti kataloğa klonlayır, onun description faylını kopyalayır və Ruby generatoru müvəqqəti checkout-də işə salır. Sonra müvəqqəti kataloğ silinir.

Hook işə salınması hər repozitoriya üçün müvafiq kataloğda ayrıca sayt yaradır və kökdə index.html-i yeniləyir. Eyni çağırış post-receive hook-də də yerləşdirilə bilər. Global post-update hook prosesi bütün repozitoriyalara yerləşdirmədən işə salmaq üçün istifadə edilə bilər.

Hazırki məhdudiyyətlər

Grubby ayrıca commit-lar, branch-lar və ya repozitoriyanın digər ayrıca dəyişiklikləri üçün ayrıca səhifələr yaratmır. Onun yaradılmış nəticəsi repozitoriya saytlarına və əsas repozitoriyalar indeksə yönəlidir.