Diagnostika

Vsak razdelek opisuje en simptom. Povsod velja ta namestitev DokuWikija z nameščenim in vklopljenim vtičnikom wkdoadogit, razen kjer je navedeno drugače. Izraz priklop pomeni vez med repozitorijem in imenskim prostorom wikija, izraz raven pa raven vidnosti tega priklopa.

Okolje. Na strani je oznaka {{wk:adogit>…}}, ki se izriše kot navadno besedilo.

Vzrok. Vtičnik ni vklopljen ali pa je oznaka razlomljena čez več vrstic. Oznaka mora stati v eni sami izvorni vrstici.

Rešitev. V upravitelju razširitev preverite, ali je vtičnik wkdoadogit vklopljen, in oznako spravite v eno vrstico. Če je bila stran že izrisana, jo enkrat shranite znova.

Okolje. Namesto drevesa se izriše kartica s tem besedilom.

Vzrok. Iskanje ni našlo ne povezave z navedenim ključem ne priklopa za trojico povezava, projekt in repozitorij. Oba primera dasta isto besedilo. Najpogostejši različici sta ti dve: v prvem delu oznake je številka povezave namesto njenega ključa, ali pa se ime projekta oziroma repozitorija razlikuje od registriranega.

Rešitev. Odprite Skrbništvo > Priklopi repozitorijev ADO-Git in v vrstici priklopa preberite stolpec Repozitorij ADO. Tam je zapis projekt/repozitorij natanko tak, kot je registriran. Ključ povezave prikaže isti zaslon v čarovniku, v obliki projekt / ključ. Najhitreje je, da oznako prekopirate iz menija vrstice priklopa, vnos Prikaz tega repozitorija na strani wikija.

Okolje. Oznaka je preverjeno pravilna, stran pa leži zunaj imenskega prostora projektov.

Vzrok. Brskalnik poišče povezavo prek projekta DWDO tiste strani, na kateri stoji. Zunaj korena projektov (v tej namestitvi {lang}:projects:) se projekt ne razreši in nobene povezave ni mogoče najti.

Rešitev. Oznako prestavite na stran znotraj projekta, na primer sl:projects:<projekt>:repos. Za posamezno datoteko velja izjema: oznaka {{source>ado:…}} deluje tudi na strani znotraj imenskega prostora priklopa.

Okolje. Priklop je registriran, bralec je prijavljen ali anonimen.

Vzrok. Raven priklopa tega bralca ne zajema. Raven private zapre vse razen urednikov, readonly zapre anonimne, team pa vse zunaj skupin vlog projekta.

Rešitev. V meniju vrstice priklopa izberite drugo raven in nato Shrani. Sprememba učinkuje takoj, ker se pravice preberejo ob vsaki zahtevi. Pravic ne popravljajte ročno, saj se upravljani blok ob naslednjem zapisu prepiše.

Okolje. Seznam priklopov v skrbništvu.

Vzrok. Priklop je v shrambi, ustrezne pravice v datoteki conf/acl.auth.php pa manjkajo ali se razhajajo. To se zgodi, kadar zapis pravic ni uspel (pravice datoteke) ali kadar je bil upravljani blok spremenjen mimo tega zaslona.

Rešitev. V meniju vrstice priklopa še enkrat izberite raven in nato Shrani. Zapis prepiše samo blok med vrsticama # BEGIN wkdoadogit-managed in # END wkdoadogit-managed in pusti vsa druga pravila nedotaknjena. Če stanje ostane NOT written, preverite pravice pisanja za datoteko conf/acl.auth.php.

Okolje. Priklop, registriran s starejšo različico vtičnika. V seznamu priklopov je raven private, stolpec Pravila pa opozarja na razhajanje.

Vzrok. Registracijski sloj je nekoč poznal samo ravni private, readonly in public ter vsako drugo vrednost tiho nadomestil s private. Pravice so bile kljub temu zapisane po izbrani ravni team, zato sta se shramba in datoteka razšli. Registracija zdaj prevzame vsako raven, ki jo pozna zapisovalnik pravil, zato novi priklopi te napake nimajo.

Rešitev. V meniju vrstice priklopa izberite raven team in nato Shrani. Priklop se zapiše z izbrano ravnjo, pravila pa se osvežijo. Po tem se stolpec Pravila ujema.

Okolje. Namesto drevesa se izriše kartica s tem besedilom ali pa predal javi, da vir ni dosegljiv.

Vzrok. Ena od plasti pod brskalnikom ne odgovori: manjka razširitev curl, nastavitev ado_host_allow je prazna ali napačna, skrivnost ni dosegljiva ali pa je povezava odpovedala.

Rešitev.

1. Odprite /doku.php?do=wkdoadogit_diag. Preglednica pokaže, katera storitev se razreši in katera ne.
2. Na strani projekta odprite do=wkdoado in pri povezavi izberite Preizkusi. Preizkus loči prepovedan strežnik, nedosegljiv cilj, napako potrdila in napako prijave.
3. Preverite, ali je v ado_host_allow natanko ime strežnika. Nadomestnih znakov ta seznam ne pozna, prazen seznam pa zavrne vse.
4. Preverite razširitev curl. Brez nje se konektor javi kot nedejaven.

Okolje. Povezava vrste server proti lastni namestitvi Azure DevOpsa.

Vzrok. Zbirka je navedena dvakrat, v osnovnem naslovu (https://devops.wvds.it/Me) in v polju Collection. Graditelj naslovov jo pripne še enkrat.

Rešitev. Izpraznite polje Collection ali pa zbirko odstranite iz osnovnega naslova, nato ponovite preizkus.

Okolje. Posrednik git na strežniku Apache.

Vzrok. Apache privzeto zavrne poti oblike …/git.php/code/projekt/repozitorij/info/refs, ker je možnost AcceptPathInfo izklopljena. Zahteva se konča, še preden se PHP zažene.

Rešitev. Uporabite priloženo datoteko .htaccess v mapi vtičnika, ki to možnost vklopi samo za git.php. Priložena datoteka web.config velja izključno za IIS in na Apacheju ne stori ničesar.

Okolje. Posrednik git, prijava po protokolu HTTP Basic.

Vzrok. Žeton je bil preklican, je potekel ali pa je bil izdan pred preimenovanjem predpone. Shranjena je samo zgoščena vrednost, zato starega žetona ni mogoče prenesti na novo predpono. Druga možnost je, da raven priklopa anonimnemu bralcu ne dovoli ukaza clone, prijava pa sploh ni bila poslana.

Rešitev. Izdajte nov žeton na naslovu /doku.php?do=wkdoadogit_tokens in ga shranite v odjemalca. Preverite tudi, ali žeton potuje kot geslo; uporabniško ime je vaše prijavno ime v wikiju.

Okolje. Ukaz clone deluje, ukaz push pa ne.

Vzrok. Za push je potrebna raven vsaj 4, za clone pa zadošča že 2. Če imate raven med 4 in 7, so dovoljene samo veje pod vašo predpono.

Rešitev. Potiskajte v refs/heads/users/<prijavno-ime>/ ali zaprosite za raven, ki podeli 8. Podrobnosti opisuje kloniranje repozitorija.

Okolje. Urejevalnik posamezne datoteke v brskalniku.

Vzrok. Datoteka se je po odprtju urejevalnika spremenila. Commit se vedno uveljavi proti tisti različici, ki jo je avtor videl; drugačno podlago strežnik zavrne, namesto da bi tujo spremembo povozil.

Rešitev. Zaprite urejevalnik, datoteko odprite znova in spremembo ponovite na novi podlagi.

Okolje. Klic naslova /doku.php?id=code:dokuwiki-plugins:wkdoadogit.

Vzrok. Imenski prostor priklopa je navidezen. Nosi pravice, ne pa strani, in priklop nobene strani ne ustvari.

Rešitev. To ni napaka. Repozitorij prikaže stran z oznako {{wk:adogit>…}} znotraj projekta; glejte vodnik, stran z brskalnikom.

Okolje. Slovenski uporabniški vmesnik, poljuben zaslon vtičnika.

Vzrok. DokuWiki najprej naloži angleška besedila in čeznje položi izbrani jezik. Ključ, ki ga slovenska datoteka nima, zato ostane angleški. To je namerno vedenje in ne napaka namestitve; tako vmesnik nikoli ne pokaže prazne oznake.

Rešitev. V tej različici so vsi napisi vtičnikov wkdoadogit in wkdoado prevedeni, zato angleški napis pomeni starejšo nameščeno različico. Primerjajte datoteko lib/plugins/wkdoadogit/lang/sl/lang.php z istoimensko angleško: ključ, ki ga slovenska nima, je manjkajoči prevod.

• Prvi prikaz repozitorija ADO v wikiju – celoten postopek od povezave do datoteke
• Kako prikazati izvorno kodo na strani wikija – obe oznaki in njune meje
• Kako klonirati priklopljen repozitorij – posrednik git in osebni žeton
• Koncepti – raven vidnosti, pravice in meje