Prvi prikaz ADO repozitorija u wikiju

Vodič vodi jedan repozitorij iz Azure DevOpsa od nule do vidljive datoteke na wiki stranici. Sedam odjeljaka slijedi redoslijed kojim radite; posljednji je neobvezan.

Vrijednosti u primjerima potječu iz ove instalacije. Zamijenite ih svojima.

• Za vezu trebate ulogu manage u DWDO projektu. Popis veza smije vidjeti i čitatelj, ali je ne može stvoriti.
• Za montiranje trebate administratorska prava jer montiranje zapisuje prava za cijelo mjesto.
• Instalirani i uključeni moraju biti dodaci wkcore, wkdocore, wkdostorage, wkdoado i wkdoadogit. Bez dodatka wksourceview datoteke se ne otvaraju u ladici.
• DWDO projekt mora postojati dvaput: kao imenski prostor ispod korijena projekata (ovdje {lang}:projects:) i kao zapis u DWDO pohrani. Bez tog zapisa vezu nije moguće spremiti.
• U postavkama dodatka wkdoado ime ADO poslužitelja mora stajati u ado_host_allow. Prazan popis odbija svaki poziv.
• Tajna (PAT) mora ležati izvan baze, kao uputa vault:, file:, env: ili enc:.
• Na poslužitelju mora biti dostupno PHP proširenje curl. Bez njega se preglednik ne učitava, a git posrednik prekida rad.

Veza opisuje ADO poslužitelj i pripada točno jednom DWDO projektu. Ne postavlja se u administraciji, nego na stranici projekta.

1. Otvorite bilo koju stranicu projekta i dodajte joj radnju do=wkdoado, na primjer /doku.php?id=hr:projects:dwplugins:start&do=wkdoado. Isti zaslon otvara naredbena paleta unosom Upravljajte ADO vezama.
2. Ako je veza već na popisu, zabilježite njezin ključ i prijeđite na sljedeći odjeljak.
3. Ispunite obrazac za novu vezu: Ključ (wvds; dopušteni znakovi [A-Za-z0-9_-], najviše 64), Naslov, Postava (services za uslugu dev.azure.com ili server za vlastitu instalaciju), Osnovni URL, po potrebi Organizacija (services) i Collection (server) te Verzija API-ja (zadano 7.0).
4. Odaberite Dodaj.
5. U retku veze odaberite način tajne (vault:, file:, env: ili enc:), unesite vrijednost i spremite. Kod načina vault: vrijednost je oznaka unosa u dodatku wkvault, u ovoj instalaciji adogit-service-pat.
6. Odaberite Testiraj i pričekajte ishod. Test razlikuje četiri uzroka: zabranjen poslužitelj, nedostupan cilj, pogrešku certifikata i pogrešku prijave.

Nastavite tek kad test uspije.

Montiranje veže repozitorij uz imenski prostor wikija i zapisuje prava za njega.

1. Otvorite Administracija > ADO-Git montiranja repozitorija, izravno /doku.php?do=admin&page=wkdoadogit_mounts.
2. Rasklopite Registriraj montiranje.
3. Na zaslonu 1. Veza odaberite vezu. Na popisu je zapisana kao projekt / ključ, na primjer dwplugins / wvds. Odaberite Dalje.
4. Na zaslonu 2. ADO projekt odaberite projekt, na primjer DokuWiki-Plugins. Popis čita veza; kad poslužitelj ne odgovori, zaslon to kaže i nudi slobodno polje.
5. Na zaslonu 3. Repozitoriji označite jedan ili više repozitorija, na primjer wkdoadogit. Po potrebi prilagodite polje Predložak imenskog prostora, odaberite razinu vidljivosti pa zatim Pregled.
6. Pročitajte zaslon 4. Pregled. Prikazuje što razina dodjeljuje, koji će imenski prostor nastati i svaki redak prava koji će biti zapisan. Upozorava i ako imenski prostor već nosi wiki stranice.
7. Odaberite Registriraj.

Najprije se zapisuje montiranje, a zatim prava. Ne uspije li zapis prava, zaslon vas o tome obavještava; tihog međustanja nema.

Predložak imenskog prostora zadano glasi code:{project}:{repo}. Rezervirane riječi {project} i {repo} zamjenjuju se imenima iz Azure DevOpsa, a eventualni {lang} ostaje i širi se po jezicima tek pri zapisu prava.

Razina je jedino mjesto na kojem se uređuje vidljivost. Prava se čitaju pri svakom zahtjevu, pa promjena djeluje odmah.

Što pojedini broj znači u wikiju, a što u ovom dodatku, objašnjava tehnička referenca.

Prava leže u upravljanom bloku datoteke conf/acl.auth.php, između redaka # BEGIN wkdoadogit-managed i # END wkdoadogit-managed. Taj blok nemojte uređivati ručno – umjesto toga postavite razinu montiranja.

Nakon registracije repozitorij stoji na popisu montiranja sa svojim imenskim prostorom:

code:dokuwiki-plugins:wkdoadogit

Stupac Pravila kazuje podudaraju li se zapisana prava s razinom (written), nedostaju li (NOT written) ili se razilaze. Kod razine public u datoteci conf/acl.auth.php nastaju četiri retka:

# mount: code:dokuwiki-plugins:wkdoadogit (public)
code:dokuwiki-plugins:wkdoadogit	@ALL	2
code:dokuwiki-plugins:wkdoadogit:*	@ALL	2
code:dokuwiki-plugins:wkdoadogit	@wvdse	8
code:dokuwiki-plugins:wkdoadogit:*	@wvdse	8

Repozitorij se crta ondje gdje autor postavi oznaku. Ona djeluje samo na stranici unutar DWDO projekta jer preglednik traži vezu preko projekta te stranice.

1. Otvorite stranicu repos svog projekta u uređivaču: /doku.php?id=hr:projects:dwplugins:repos&do=edit.
2. Umetnite oznaku {{wk:adogit>wvds:DokuWiki-Plugins:wkdoadogit}}.
3. Spremite stranicu.

Sada se prikazuju zaglavlje s imenom repozitorija, značkom razine i imenom grane te stablo korijenske mape.

Oblik oznake glasi {{wk:adogit>veza:projekt:repozitorij[:grana[:putanja]]}}:

Želite li preglednik postaviti u bočno područje ljuske, dodajte region=toc: {{wk:adogit>wvds:DokuWiki-Plugins:wkdoadogit region=toc}}.

Kartice Branches i Tags u zaglavlju vidljive su, ali neaktivne. Prikazanu granu birate u oznaci, a ne u sučelju.

Mapu u stablu otvarate tako da je odaberete. Sadržaj se učitava tek pri otvaranju i pravo se pritom provjerava iznova, pa stablo nikad ne dolazi iz zajedničke predmemorije stranica.

Mapu možete odrediti i unaprijed, petim poljem oznake:

{{wk:adogit>wvds:DokuWiki-Plugins:wkdoadogit:main:/Domain}}

Datoteku otvarate tako da je odaberete. Pojavljuje se ladica dodatka wksourceview i datoteka se crta s isticanjem sintakse. Bez tog dodatka nema ladice, stablo ostaje.

Tko ima pravo pisanja, uz svaku datoteku nalazi i gumb za uređivanje, a u zaglavlju gumb Nova grana/oznaka. Postupak opisuje uređivanje datoteke i commit iz wikija.

Iznad stabla stoji rasklopiva ploča Kako doći do ovog repozitorija s adresom za clone, preuzimanjem arhive ZIP i poveznicom na osobne tokene. Pojavljuje se samo onima s razinom 2 ili više; vidi kloniranje repozitorija.

Ovaj je odjeljak neobvezan. Pojedinu datoteku možete nacrtati i izravno na stranici, bez preglednika:

{{source>ado:wvds:DokuWiki-Plugins:wkdoadogit:main:/Domain/MountAclGate.php#L141-L146}}

Razliku između obiju oznaka, postavke prikaza i granice opisuje prikaz izvornog koda na wiki stranici.

• Stranica hr:projects:dwplugins:repos prikazuje zaglavlje repozitorija wkdoadogit sa značkom razine i imenom grane.
• Mape se otvaraju, a datoteke se pojavljuju u ladici s izvornim kodom.
• Čitatelj bez prava čitanja na imenskom prostoru code:dokuwiki-plugins:wkdoadogit na istoj stranici ne vidi ni stablo ni ime repozitorija, nego samo karticu sa stanjem.
• U datoteci conf/acl.auth.php unutar upravljanog bloka stoje četiri retka tog montiranja.

Osobni je token namijenjen git klijentima, a ne wikiju. Unutar wikija nikad nije potreban.

Prema Azure DevOpsu se u svim slučajevima prijavljuje servisni račun. Osobni token govori samo tko u wikiju pita.

Podrobna dijagnostika s postupcima nalazi se u Dijagnostici.

• Kako prikazati izvorni kod na wiki stranici – prikaz izvornog koda na wiki stranici
• Kako urediti datoteku i napraviti commit iz wikija – uređivanje datoteke i commit iz wikija
• Kako klonirati montirani repozitorij – clone, pull i push te osobni token
• Koncepti – razina vidljivosti, prava i granice