Dijagnostika

Svaki odjeljak opisuje jedan simptom. Posvuda vrijedi ova instalacija DokuWikija s instaliranim i uključenim dodatkom wkdoadogit, osim ako je navedeno drukčije. Izraz montiranje znači vezu između repozitorija i imenskog prostora wikija, a izraz razina razinu vidljivosti tog montiranja.

Okruženje. Na stranici stoji {{wk:adogit>…}} i crta se kao običan tekst.

Uzrok. Dodatak nije uključen ili je oznaka prelomljena preko više redaka. Oznaka mora stajati u jednom jedinom izvornom retku.

Rješenje. U upravitelju proširenja provjerite je li wkdoadogit uključen i dovedite oznaku u jedan redak. Ako je stranica već bila nacrtana, spremite je još jednom.

Okruženje. Umjesto stabla crta se kartica s tim tekstom.

Uzrok. Pretraga nije našla ni vezu s navedenim ključem ni montiranje za trojku veza, projekt i repozitorij. Oba slučaja daju isti tekst. Najčešće su dvije inačice: u prvom polju oznake stoji broj veze umjesto njezina ključa ili se ime projekta odnosno repozitorija razlikuje od registriranog.

Rješenje. Otvorite Administracija > ADO-Git montiranja repozitorija i u retku montiranja pročitajte stupac ADO repozitorij. Ondje stoji projekt/repozitorij točno onako kako je registrirano. Ključ veze prikazuje isti zaslon u čarobnjaku, u obliku projekt / ključ. Najbrže je da oznaku kopirate iz izbornika retka montiranja, unos Prikaz ovog repozitorija na wiki stranici.

Okruženje. Oznaka je dokazano ispravna, a stranica leži izvan imenskog prostora projekata.

Uzrok. Preglednik traži vezu preko DWDO projekta stranice na kojoj stoji. Izvan korijena projekata (ovdje {lang}:projects:) projekt se ne razrješava i nijednu vezu nije moguće naći.

Rješenje. Premjestite oznaku na stranicu unutar projekta, primjerice hr:projects:<projekt>:repos. Za pojedinu datoteku vrijedi iznimka: oznaka {{source>ado:…}} djeluje i na stranici unutar imenskog prostora montiranja.

Okruženje. Montiranje je registrirano, čitatelj je prijavljen ili anoniman.

Uzrok. Razina montiranja tog čitatelja ne obuhvaća. Razina private zatvara sve osim urednika, readonly zatvara anonimne, a team sve izvan grupa uloga projekta.

Rješenje. U izborniku retka montiranja odaberite drugu razinu pa Spremi. Promjena djeluje odmah jer se prava čitaju pri svakom zahtjevu. Prava nemojte ispravljati ručno jer se upravljani blok pri sljedećem zapisu prepisuje.

Okruženje. Popis montiranja u administraciji.

Uzrok. Montiranje je u pohrani, a odgovarajuća prava u datoteci conf/acl.auth.php nedostaju ili se razilaze. To se događa kad zapis prava nije uspio (prava datoteke) ili kad je upravljani blok promijenjen mimo ovog zaslona.

Rješenje. U izborniku retka montiranja još jednom odaberite razinu pa Spremi. Prepisuje se samo blok između redaka # BEGIN wkdoadogit-managed i # END wkdoadogit-managed; sva ostala pravila ostaju netaknuta. Ostane li stanje NOT written, provjerite prava pisanja na datoteci conf/acl.auth.php.

Okruženje. Montiranje registrirano starijom inačicom dodatka. Na popisu stoji razina private, a stupac Pravila upozorava na razilaženje.

Uzrok. Registracijski je sloj nekoć poznavao samo razine private, readonly i public te je svaku drugu vrijednost tiho zamijenio s private. Prava su ipak bila zapisana prema odabranoj razini team, pa su se pohrana i datoteka razišle. Registracija sada preuzima svaku razinu koju poznaje zapisivač pravila, pa nova montiranja tu pogrešku nemaju.

Rješenje. U izborniku retka montiranja odaberite razinu team pa Spremi. Montiranje se pohranjuje s odabranom razinom, a pravila se osvježavaju. Nakon toga se stupac Pravila podudara.

Okruženje. Umjesto stabla crta se kartica s tim tekstom ili ladica javlja da izvor nije dostupan.

Uzrok. Jedan od slojeva ispod preglednika ne odgovara: nedostaje proširenje curl, postavka ado_host_allow prazna je ili pogrešna, tajna nije dostupna ili je veza otkazala.

Rješenje.

1. Otvorite /doku.php?do=wkdoadogit_diag. Tablica pokazuje koja se usluga razrješava, a koja ne.
2. Na stranici projekta otvorite do=wkdoado i kod veze odaberite Testiraj. Test razlikuje zabranjen poslužitelj, nedostupan cilj, pogrešku certifikata i pogrešku prijave.
3. Provjerite stoji li u ado_host_allow točno ime poslužitelja. Zamjenske znakove taj popis ne poznaje, a prazan popis odbija sve.
4. Provjerite proširenje curl. Bez njega se konektor javlja kao neaktivan.

Okruženje. Veza vrste server prema vlastitoj instalaciji Azure DevOpsa.

Uzrok. Zbirka je navedena dvaput, u osnovnoj adresi (https://devops.wvds.it/Me) i u polju Collection (server). Graditelj adresa dodaje je još jednom.

Rješenje. Ispraznite polje Collection (server) ili uklonite zbirku iz osnovne adrese pa ponovite test.

Okruženje. Git posrednik na poslužitelju Apache.

Uzrok. Apache prema zadanome odbija putanje oblika …/git.php/code/projekt/repozitorij/info/refs jer je mogućnost AcceptPathInfo isključena. Zahtjev završava prije nego što se PHP pokrene.

Rješenje. Poslužite se priloženom datotekom .htaccess u mapi dodatka, koja tu mogućnost uključuje samo za git.php. Priložena datoteka web.config vrijedi isključivo za IIS i na Apacheu ne čini ništa.

Okruženje. Git posrednik, prijava protokolom HTTP Basic.

Uzrok. Token je opozvan, istekao je ili je izdan prije preimenovanja prefiksa. Pohranjena je samo raspršena vrijednost, pa stari token nije moguće prenijeti na novi prefiks. Druga je mogućnost da razina montiranja anonimnom čitatelju ne dopušta clone, a prijava uopće nije poslana.

Rješenje. Izdajte novi token na adresi /doku.php?do=wkdoadogit_tokens i pohranite ga u klijent. Provjerite i putuje li token kao lozinka; korisničko je ime vaše prijavno ime u wikiju.

Okruženje. Naredba clone radi, a push ne.

Uzrok. Za push je potrebna barem razina 4, a za clone dovoljna je već 2. Ako imate razinu između 4 i 7, dopuštene su samo grane ispod vašeg prefiksa.

Rješenje. Gurajte u refs/heads/users/<prijava>/ ili zatražite razinu koja dodjeljuje 8. Pojedinosti opisuje kloniranje repozitorija.

Okruženje. Uređivač pojedine datoteke u pregledniku.

Uzrok. Datoteka se promijenila nakon otvaranja uređivača. Commit se uvijek primjenjuje na inačicu koju je autor vidio; drukčiju podlogu poslužitelj odbija umjesto da pregazi tuđu promjenu.

Rješenje. Zatvorite uređivač, otvorite datoteku ponovno i ponovite promjenu na novoj podlozi.

Okruženje. Poziv adrese /doku.php?id=code:dokuwiki-plugins:wkdoadogit.

Uzrok. Imenski je prostor montiranja virtualan. Nosi prava, ali ne i stranice, i montiranje nijednu ne stvara.

Rješenje. To nije pogreška. Repozitorij prikazuje stranica s oznakom {{wk:adogit>…}} unutar projekta; vidi vodič, stranica s preglednikom.

Okruženje. Hrvatsko korisničko sučelje, bilo koji zaslon dodatka.

Uzrok. DokuWiki najprije učitava engleske tekstove i preko njih polaže odabrani jezik. Ključ koji hrvatska datoteka nema zato ostaje engleski. To je namjerno ponašanje, a ne pogreška instalacije; tako sučelje nikad ne prikazuje prazan natpis.

Rješenje. U ovoj su inačici svi natpisi dodataka wkdoadogit i wkdoado prevedeni, pa engleski natpis upućuje na stariju instaliranu inačicu. Usporedite datoteku lib/plugins/wkdoadogit/lang/hr/lang.php s istoimenom engleskom: ključ koji hrvatska nema jest prijevod koji nedostaje.

• Prvi prikaz ADO repozitorija u wikiju – cijeli put od veze do datoteke
• Kako prikazati izvorni kod na wiki stranici – obje oznake i njihove granice
• Kako klonirati montirani repozitorij – git posrednik i osobni token
• Koncepti – razina vidljivosti, prava i granice