Grubby ստատիկ կայքեր է գեներացնում միայն Git պահոցներից

Ստատիկ կայքեր միայն Git պահոցներից

Grubby-ն Ruby-ով գրված ստատիկ կայքերի գեներատոր է Git պահոցների համար: Այն RepoRat-ից fork է և նրանով մեծապես ոգեշնչված: Grubby-ն յուրաքանչյուր միայն Git պահոցի համար ստեղծում է վեբկայք և գեներացնում է գլխավոր պահոցների ինդեքսը:

Նախագծին անհրաժեշտ են Git, Ruby 3.0 կամ ավելի նոր տարբերակ և Kramdown: Այն ստեղծված է որպես սեփական տեսությամբ կազմակերպված լուծում մինիմալ կոնֆիգուրացիայով: Kramdown-ը լռելյայն Markdown վերլուծիչ է, սակայն դրա փոխարինումը հնարավոր է, բայց երաշխիք չկա, որ այլընտրանքային վերլուծիչները աշխատեննեն առանց սխալների:

Կոնֆիգուրացիա և արտահանում

Grubby-ն ենթադրում է, որ միայն Git պահոցների պանակները ավարտվում են .git ընդլայնմամբ: Դրա հիմնական պահոցների ինդեքսի գեներացիան կարող է ճիշտ չաշխատել այս անվանման կանոնից դուրս: Հիմնական կոնֆիգուրացիայի ֆայլը _config.yml է, որը օգտագործվում է հիմնական դոմենը և ուղիները տեղադրելու համար:

Լռելյայն պահոցների ինդեքսը գտնվում է հիմնական դիրեկտորիայի արմատում և կոչվում է index.html: Նրա արտահանված ֆայլի անունը կարող է փոխվել _config.yml-ում: Օգտատերերը, ովքեր են ցանկանում փոխել գեներացված կայքերի տեսքը կամ նավիգացիան, կարող են փոխել style.css, _header.html և _footer.html:

Կայքերի գեներացիա Git հուքներով

Օգտագործման ուղեցույցը ենթադրում է, որ գործը կապված է NearlyFreeSpeech.NET-ի ընդհանրական հոսթինգի հետ, սակայն գործընթացը նկարագրված է նույնպես ինձնական VPS-ում: Նրա օրինակում միայն պահոցները պահվում են /home/public/git.sitename.org-ում: Ինքը Grubby-ն կլոնավորվում է ինձնական դիրեկտորիայում, իսկ գործընթացը գործարկվում է միայն պահոցի ներսից:

Պահոցի hooks պանակում ստեղծվում է post-update հուք և նրան շնորհվում է կատարման իրավունք: Սկրիպտը չեղարկում է GIT_DIR-ը, գործարկում է git update-server-info-ը, կլոնավորում է ընթացիկ պահոցը ժամանակավոր դիրեկտորիայում, պատճենում է նրա description ֆայլը և ժամանակավոր checkout-ում գործարկում է Ruby գեներատորը: Այնուհետև ժամանակավոր դիրեկտորիան ջնջվում է:

Հուքի գործարկումը յուրաքանչյուր պահոցի համար ստեղծում է առանձին կայք համապատասխան դիրեկտորիայում և թարմացնում է արմատում գտնվող index.html-ը: Նույն կանչը կարող է տեղադրվել նաև post-receive հուքում: Գլոբալ post-update հուքը կարող է օգտագործվել գործընթացը գործարկելու համար առանց դրա տեղադրման բոլոր պահոցներում:

Ընթացիկ սահմանափակումներ

Grubby-ն չի ստեղծում առանձին էջեր առանձին commit-ների, branch-ների կամ պահոցի այլ առանձին փոփոխությունների համար: Նրա գեներացված արդյունքը ուղղված է պահոցների կայքերին և գլխավոր պահոցների ինդեքսին: