ADO-Git

ADO-Git prikazuje repozitorije git iz Azure DevOpsa neposredno v wikiju: brskanje po drevesu, prikaz izvorne kode, urejanje in commit datoteke ter ukaze clone, pull in push prek posrednika. Paket je namenjen bralcem, ki naj izvorno kodo vidijo brez svoje licence ADO, avtorjem, ki repozitorij pokažejo na strani wikija, in upraviteljem, ki repozitorije povežejo in določijo njihovo vidnost.

Prvi koraki

Ustvarite povezavo → Priklopite repozitorij → Določite vidnost → Pokažite repozitorij na strani

Priklop in oznaka sta dve ločeni dejanji. Priklop zapiše samo pravice in ne ustvari nobene strani; repozitorij postane viden šele z oznako {{wk:adogit>…}} na strani. To je najpogostejši razlog za vtis, da priklop ne deluje.

Pogosta opravila

Kaj želite	Za koga	Kje to naredite	Navodilo
nastaviti povezavo z Azure DevOpsom	upravitelji	`do=wkdoado` na strani projekta	Vodnik: povezava
priklopiti repozitorij	upravitelji	Skrbništvo > Priklopi repozitorijev ADO-Git	Vodnik: priklop
določiti vidnost (`private`, `readonly`, `public` ali `team`)	upravitelji	isti zaslon, izbira ravni	Vodnik: raven vidnosti
pokazati repozitorij na strani	avtorji	stran wikija v projektu, oznaka `{{wk:adogit>…}}`	Vodnik: stran z brskalnikom
odpreti repozitorij brez lastne strani	bralci	`do=wkdoadogit_repo&ns=<imenski prostor priklopa>`	Referenca: zaslon repozitorija (nemško)
odpreti mapo ali datoteko	bralci	drevo na strani	Vodnik: mapa in datoteka
prikazati izvorno kodo na strani	avtorji	oznaka `{{source>ado:…}}`	Kako: prikazati izvorno kodo
urediti datoteko in narediti commit	uredniki	gumb ob datoteki v drevesu	Kako: urediti datoteko
lokalno uporabljati `clone`, `pull` in `push`	razvijalci	naslov posrednika git	Kako: klonirati repozitorij
izdati osebni žeton git	razvijalci	`do=wkdoadogit_tokens`	Kako klonirati: osebni žeton
prenesti posnetek kot arhiv ZIP	bralci od ravni 2	brskalnik repozitorija	Vodnik: mapa in datoteka
ugotoviti vzrok napake	vsi	–	Diagnostika

Potek na kratko

Pot repozitorija iz Azure DevOpsa do vidne datoteke v wikiju:

Korak	Kje	Kaj se zgodi
1	`do=wkdoado` na strani projekta	Nastane povezava: ključ, naslov strežnika in sklic na skrivnost. Brez nje ni mogoče prebrati ničesar
2	Skrbništvo > Priklopi repozitorijev ADO-Git	Nastane priklop: repozitorij se veže na imenski prostor wikija
3	isti zaslon, izbira ravni	Raven vidnosti samodejno zapiše pravice tega imenskega prostora
4	stran wikija znotraj projekta	Avtor vstavi oznako `{{wk:adogit>…}}`. Šele ta stran repozitorij pokaže
5	drevo na tej strani	Bralec odpre mapo in datoteko; datoteka se prikaže v predalu z izvorno kodo
6	`do=wkdoadogit_tokens`	Kdor želi `git clone` zunaj wikija, si izda osebni žeton

Ta namestitev nima izrisovalnika Mermaid, zato tu stoji preglednica korakov namesto diagrama.

Ključne zmožnosti

Brskalnik repozitorija na strani wikija. Oznaka {{wk:adogit>povezava:projekt:repozitorij}} izriše glavo z ravnjo vidnosti in drevo map; podmape se naložijo šele ob odprtju.
Izris posamezne datoteke. Oznaka {{source>ado:…}} prikaže eno datoteko, po želji samo izbrano območje vrstic.
Urejanje in commit posamezne datoteke. Commit se uveljavi proti tisti različici, ki jo je avtor videl; sicer ga strežnik zavrne.
Ustvarjanje veje ali oznake tag neposredno iz brskalnika, za uporabnike s pravico pisanja.
Posrednik git za clone, pull in push z običajnim odjemalcem. Prijava poteka z osebnim žetonom, ne z geslom wikija.
Prenos posnetka kot arhiva ZIP iz brskalnika repozitorija.
Ena sama nastavitev za vidnost: raven priklopa, ki samodejno zapiše pravice.

Ključni pojmi

Povezava opisuje strežnik ADO in pripada projektu DWDO; priklop veže en repozitorij te povezave na imenski prostor wikija in nosi raven vidnosti, ki pravice tega imenskega prostora zapiše. Ena povezava nosi poljubno mnogo priklopov.

Imenski prostor priklopa je navidezen: v njem ni nobene strani, vsak dostop – brskalnik, izris datoteke, posrednik git in prenos arhiva – pa vpraša po pravicah tega imenskega prostora in ne po pravicah strani, na kateri bralec stoji. Pri Azure DevOpsu se vedno prijavi en sam storitveni račun; kdo sme kaj, zato odločajo izključno pravice DokuWikija.

V celoti, s preglednico ravni in dvojnim pomenom stopnje: Tehnična referenca, razdelek »Raven vidnosti in ACL DokuWikija«.

Upravljanje

Skrbništvo > Priklopi repozitorijev ADO-Git (do=admin&page=wkdoadogit_mounts) – povežite repozitorije, spremenite imenski prostor in raven
Skrbništvo > Dostopni žetoni ADO-Git – pregled in preklic izdanih žetonov
Skrbništvo > Povezave Subversion za ADO-Git – končne točke Subversion iste povezave
Nastavitve paketa – vrednosti, privzetki in njihov učinek

Diagnostika

Za razvijalce

Tehnična referenca – upravljanje priklopov, skladnja, dejanja, žetoni, nastavitve
Koncepti – priklopi, raven vidnosti, drugi dejavnik, meje
wkdoado – utrjena povezava ADO, na kateri ta paket stoji
wksourceview – izris izvorne kode, ki ga ta paket oskrbuje
wkcore – register, prek katerega se obe storitvi najdeta

Sorodne teme

Prvi prikaz repozitorija ADO v wikiju – prvi prikaz repozitorija v wikiju, od povezave do datoteke
Kako prikazati izvorno kodo na strani wikija – prikaz izvorne kode na strani wikija
Kako urediti datoteko in narediti commit iz wikija – urejanje datoteke in commit iz wikija
Kako klonirati priklopljen repozitorij – clone, pull in push ter osebni žeton
Diagnostika – simptom, vzrok in rešitev