Hitri začetek: registracija prvega lokalnega repozitorija

Najkrajša pot od »vtičnik je nameščen« do »repozitorij na disku strežnika sporoča v redu in wiki prikazuje njegove veje, oznake in commite«. Štirje koraki, približno deset minut.

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

• 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.

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 vtičnik namenoma ne išče po iskalni poti – sicer bi se zagnalo, kar se tam prvo imenuje git. Datoteke tako ne najde in se javi kot nedosegljiv.

Wiki, ki ima svoj Git s seboj, na primer na ključku USB, vpiše pot glede na mapo wikija: ../server/git/{os}/bin/git. {os} postane windows, linux ali macos.

Nastavite git_repo_root na mapo, v kateri so.

Relativna vrednost velja od podatkovne mape wikija: repositories pomeni istoimensko mapo poleg pages in media. Če mapa ne obstaja, vtičnik ne dovoli nobenega repozitorija – tipkarska napaka torej zapre, namesto da bi mejo odprla.

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.

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.

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.

• 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 zagon programa 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.

• wksourceview – prikažite datoteko iz njega na strani wikija, prek vira git:.
• wkdogit – 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.