ADO-Git
ADO-Git prikaže repozitorije git iz Azure DevOps neposredno v wikiju: po drevesu lahko brskate, si ogledate izvorno kodo, uredite datoteko in spremembo potrdite s commitom ter prek posrednika uporabljate clone, pull in push. Paket je namenjen bralcem, ki naj izvorno kodo vidijo brez lastne licence ADO, avtorjem, ki repozitorij pokažejo na strani wikija, in upraviteljem, ki repozitorije povežejo in določijo, kdo jih vidi.
Delovni prostor repozitorija: na levi izberete repozitorij in vejo ter se pomikate po drevesu datotek, na desni je odprta datoteka. Vrstica stanja na dnu ves čas navaja repozitorij, vidnost, vejo in vašo vlogo.
Na vrhu stranske vrstice z izbirnima poljema zamenjate repozitorij in vejo. Uporabnikom, ki smejo repozitorij klonirati ali prenesti, se pod njima prikaže še ukaz Kako dobiti ta repozitorij, ki odpre naslov za kloniranje. Posnetek zgoraj je narejen brez prijave, zato tega ukaza na njem ni.
Prvi koraki
Hitri začetek: prvi repozitorij ADO viden v wikiju – najkrajša pot do prvega rezultata, v treh korakih.
Ustvarite povezavo → Priklopite repozitorij → Določite vidnost → Pokažite repozitorij na strani
{{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 DevOps | upravitelji | do=wkdoado na strani projekta | Vadnica: povezava |
| priklopiti repozitorij | upravitelji | Skrbništvo > Priklopi repozitorijev | Vadnica: priklop |
določiti vidnost (private, readonly, showcase, library, public ali team) | upravitelji | isti zaslon, izbira ravni vidnosti | Vadnica: raven vidnosti |
| pokazati repozitorij na strani | avtorji | stran wikija v projektu, oznaka {{wk:adogit>…}} | Vadnica: stran z brskalnikom |
| odpreti repozitorij brez lastne strani | bralci | do=wkdoadogit_repo&ns=<imenski-prostor-priklopa> | Referenca: zaslon repozitorija |
| odpreti mapo ali datoteko | bralci | drevo na strani | Vadnica: mapa in datoteka |
| prikazati izvorno kodo na strani | avtorji | oznaka {{source>ado:…}} | Kako: prikazati izvorno kodo |
| urediti datoteko in jo potrditi s commitom | uredniki | gumb ob datoteki v drevesu | Kako: urediti datoteko |
| ustvariti novo datoteko | uredniki | gumb Nova datoteka v glavi delovnega prostora | Kako: ustvariti novo datoteko |
| preklopiti na drug repozitorij ali drugo vejo | bralci | izbira v glavi delovnega prostora | Referenca: izbira obsega |
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 s stopnjo ACL 2 ali več | brskalnik repozitorija | Vadnica: mapa in datoteka |
| ugotoviti vzrok napake | vsi | – | Diagnostika |
Potek na kratko
Pot repozitorija iz Azure DevOps 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 | Nastane priklop: repozitorij se veže na imenski prostor wikija |
| 3 | isti zaslon, izbira ravni vidnosti | 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 | Za git clone zunaj wikija si uporabnik izda osebni žeton |
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, ko jih odprete. - Prikaz posamezne datoteke. Oznaka
{{source>ado:…}}prikaže eno datoteko, po želji samo izbrane vrstice. - Urejanje in commit posamezne datoteke. Commit velja za različico, ki jo je avtor videl; če se je datoteka medtem spremenila, ga strežnik zavrne.
- Nova besedilna datoteka neposredno iz delovnega prostora. Če na poti že kaj obstaja, strežnik zahtevo zavrne in ne zapiše ničesar.
- Ustvarjanje veje ali oznake (tag) neposredno iz brskalnika, za uporabnike s pravico pisanja.
- Izbira repozitorija in veje v delovnem prostoru, brez ovinka prek seznama repozitorijev.
- Posrednik git za
clone,pullinpushz običajnim odjemalcem. Prijava poteka z osebnim žetonom, ne z geslom wikija. - Posnetek kot arhiv ZIP za prenos iz brskalnika repozitorija.
- Ena sama nastavitev za vidnost: raven vidnosti priklopa, ki pravice zapiše samodejno.
Ključni pojmi
Povezava opisuje strežnik ADO in pripada projektu DWDO (projektu, ki ga upravlja paket wkdocore); priklop veže repozitorij te povezave na imenski prostor wikija in ima raven vidnosti, ki zapiše pravice tega imenskega prostora. Ena povezava ima lahko poljubno število priklopov.
Imenski prostor priklopa je navidezen: v njem ni nobene strani, vsak dostop – brskalnik, prikaz datoteke, posrednik git in prenos arhiva ZIP – pa preveri pravice tega imenskega prostora, ne pravic strani, ki jo bralec bere. Azure DevOps vedno vidi en sam storitveni račun; kdo sme kaj, zato odločajo izključno pravice DokuWikija.
V celoti, s preglednico ravni vidnosti in dvojnim pomenom stopnje ACL: Koncepti, razdelek »Raven vidnosti in ACL DokuWikija«.
Upravljanje
- Skrbništvo > Priklopi repozitorijev (
do=admin&page=wkdoadogit_mounts) – povezovanje repozitorijev, sprememba imenskega prostora in ravni vidnosti - Skrbništvo > Dostopni žetoni ADO-Git – pregled in preklic izdanih žetonov
- Nastavitve paketa – vrednosti, privzete vrednosti 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 temelji
- wksourceview – prikaz izvorne kode, ki ga ta paket oskrbuje z vsebino
- 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 ustvariti novo datoteko v brskalniku – ustvarjanje datoteke, ki še ne obstaja
- Diagnostika – simptom, vzrok in rešitev