Brzi početak: registriranje prvog lokalnog repozitorija

Najkraći put od „dodatak je instaliran“ do „repozitorij na disku poslužitelja javlja u redu i prikazuje grane, oznake i commitove u wikiju“. Četiri koraka, otprilike deset minuta.

Radi razgraničenja: ovaj dodatak čita repozitorije u datotečnom sustavu poslužitelja preko programa git. Repozitorije koji leže u Azure DevOps poslužuje wkdoadogit.

• wkdogit, wkdocore, wkdostorage i wkcore su instalirani i uključeni.
• git je instaliran na poslužitelju, a korisnik pod kojim PHP radi smije ga izvoditi.
• Repozitorij na disku tog poslužitelja, čitljiv istom korisniku.
• Neobvezno: wksourceview, da se datoteke mogu umetati na stranice.

Administracija → Postavke, odjeljak wkdogit, postavka git_binary. Tvornički je prazna, pa ništa ne radi dok se ne postavi.

Upišite apsolutnu putanju — na Linuxu primjerice /usr/bin/git, na Windowsu punu putanju do git.exe.

Puki git oslanja se na put pretraživanja web poslužitelja. To daje dodatak koji radi iz naredbenog retka, a ne iz wikija — nepotrebno zbunjujuće za traženje pogreške.

Postavite git_repo_root na direktorij u kojem leže.

Ta postavka ograničava koje se putanje smiju registrirati i koristiti. Postavite je prije nego što išta registrirate: ona odlučuje znači li „putanja repozitorija“ jednu od vaših ili bilo koju putanju na računalu. Na ovoj je instalaciji prazna, dakle bez ograničenja.

Repozitorij koji vi smijete čitati ne mora smjeti čitati korisnik web poslužitelja. To je najčešća prva smetnja i s dodatkom nema veze.

Provjerite može li korisnik pod kojim PHP radi čitati direktorij repozitorija i njegov sadržaj .git.

Otvorite zaslon repozitorija projekta, primjerice /doku.php?id=hr:projects:acme:repos&do=wkdogit.

Ispunite pod Registriraj repozitorij: Ključ, Naslov, Lokalna putanja (unutar korijena iz koraka 2) i Zadana grana. Potrebna je lokalna putanja ili udaljeni URL; udaljeni URL ne smije sadržavati vjerodajnice.

Odaberite Registriraj, zatim u retku Provjera stanja.

• Stupac Stanje stoji na u redu. Stoji li drukčije — nedostupno, neispravno ili odbijeno — time imenuje razlog, a ne samo neuspjeh: nedostajući program, putanja izvan korijena, nečitljiv direktorij ili nešto što nije repozitorij.
• Otvoreni repozitorij prikazuje Grane, Oznake i commitove.
• Svaki je poziv ograničen na git_timeout_ms, tvornički 5000 milisekundi. Vrlo velik repozitorij može tu granicu dosegnuti već pri prvom popisivanju; odgovor je obično kod repozitorija, a ne kod postavke.

• wksourceview — prikažite datoteku iz njega na wiki stranici, preko izvora git:.
• wkdogit (njemački) — stranica paketa: model čitanja, popis dopuštenih naredbi i svih pet postavki, među njima max_bytes i max_lines, koje namjerno odgovaraju onima prikaza izvornog koda.