Hitri začetek: registracija prvega lokalnega repozitorija

Najkrajša pot od „vtičnik je nameščen“ do „repozitorij na disku strežnika javlja v redu in v wikiju prikazuje veje, oznake in objave“. Štirje koraki, približno deset minut.

Zaradi razmejitve: ta vtičnik bere repozitorije v datotečnem sistemu strežnika prek programa git. Repozitorije, ki ležijo v Azure DevOps, streže wkdoadogit.

Predpogoji

wkdogit, wkdocore, wkdostorage in wkcore so nameščeni in vklopljeni.
git je nameščen na strežniku, in uporabnik, pod katerim teče PHP, ga sme izvajati.
Repozitorij na disku tega strežnika, berljiv za istega uporabnika.
Neobvezno: wksourceview, da je datoteke mogoče vstavljati na strani.

Korak 1: poimenujte program

Skrbništvo → Nastavitve, razdelek wkdogit, nastavitev git_binary. Tovarniško je prazna, zato nič ne deluje, dokler ni nastavljena.

Vpišite absolutno pot — v Linuxu na primer /usr/bin/git, v Windowsu polno pot do git.exe.

Zgolj git se zanaša na iskalno pot spletnega strežnika. Iz tega nastane vtičnik, ki deluje iz ukazne vrstice in ne iz wikija — nepotrebno zmedeno iskanje napake.

Na tej namestitvi je git_binary nastavljen na git, torej na iskalno pot. To deluje, dokler storitev spletnega strežnika podeduje isto okolje; če se klici nerazložljivo prekinjajo, je absolutna pot prvi ukrep.

Korak 2: omejite, kje smejo ležati repozitoriji

Nastavite git_repo_root na imenik, v katerem ležijo.

Ta nastavitev omejuje, katere poti je dovoljeno registrirati in uporabljati. Nastavite jo preden karkoli registrirate: odloča, ali „pot repozitorija“ pomeni eno od vaših ali katero koli pot na računalniku. Na tej namestitvi je prazna, torej brez omejitve.

Korak 3: preverite, ali spletni strežnik res sme brati

Repozitorij, ki ga vi smete brati, ni nujno berljiv za uporabnika spletnega strežnika. To je najpogostejša prva motnja in z vtičnikom nima nič.

Preverite, ali uporabnik, pod katerim teče PHP, lahko bere imenik repozitorija in njegovo vsebino .git.

Korak 4: registrirajte in preverite

Odprite zaslon repozitorijev projekta, na primer /doku.php?id=sl:projects:acme:repos&do=wkdogit.

Izpolnite pod Registriraj repozitorij: Ključ, Naslov, Lokalna pot (znotraj korena iz koraka 2) in Privzeta veja. Potrebna je lokalna pot ali oddaljeni URL; oddaljeni URL ne sme vsebovati poverilnic.

Izberite Registriraj, nato v vrstici Preverjanje stanja.

Preverjanje rezultata

Stolpec Stanje je na v redu. Kadar kaže drugače — nedosegljivo, neveljavno ali zavrnjeno — s tem poimenuje razlog in ne le neuspeha: manjkajoč program, pot zunaj korena, neberljiv imenik ali nekaj, kar ni repozitorij.
Odprt repozitorij prikazuje Veje, Oznake in objave.
Vsak klic je omejen z git_timeout_ms, tovarniško 5000 milisekund. Zelo velik repozitorij lahko to mejo doseže že ob prvem izpisu; odgovor je običajno pri repozitoriju in ne pri nastavitvi.

Naslednji korak

wksourceview — prikažite datoteko iz njega na wiki strani, prek vira git:.
wkdogit (v nemščini) — stran paketa: bralni model, seznam dovoljenih ukazov in vseh pet nastavitev, med njimi max_bytes in max_lines, ki namenoma ustrezata tistima pri prikazu izvorne kode.