Tehnična referenca
Priročnik za wkdoadogit: upravljanje priklopov, oznake, dejanja z naslovi, osebni dostopni žetoni in nastavitve. Zakaj so stvari tako zgrajene, piše v Konceptih; kaj želite narediti, na ADO-Git.
Paket: wkdoadogit · Mesto: lib/plugins/wkdoadogit/
Avtor: Wolfgang van der Stille Wolfgang.van.der.Stille@gmail.com (The White Knight Labs) · Licenca: GPL 2.0-only
Upravljanje priklopov
Zaslon je na naslovu /doku.php?do=admin&page=wkdoadogit_mounts, v meniju pod Skrbništvo > Priklopi repozitorijev ADO-Git. Dosegljiv je samo nadskrbnikom, ker se tu zapisujejo pravice za celotno mesto.
- Registracija poteka v čarovniku s štirimi zasloni: povezava, projekt, repozitoriji (s predlogo imenskega prostora in ravnjo) ter predogled. Projekt in repozitorije prebere povezava; prosto polje se ponudi le, kadar strežnik ne odgovori.
- Predogled je edini zaslon, s katerega se piše. Pokaže vsako vrstico pravic, ki bo zapisana, in opozori, če imenski prostor že nosi strani wikija.
- Sprememba ravni ali imenskega prostora: v meniju vrstice priklopa popravite polje z imenskim prostorom in izbiro ravni, nato izberite Shrani. Oboje se spremeni v enem koraku, stare pravice pa se odstranijo šele po uspešni premestitvi, zato ni trenutka brez pravic.
- Odstranitev: v meniju vrstice priklopa izberite Odstrani.
- Meni vrstice poleg tega ponudi naslov za
clone(po jezikih) in pripravljeni oznaki za prikaz repozitorija na strani.
Vsako dejanje najprej zapiše priklop, nato pravice.
Skladnja
| Oznaka | Zapis | Kaj izriše | Kje deluje |
|---|---|---|---|
{{wk:adogit>…}} | povezava:projekt:repozitorij[:veja[:pot]], neobvezni pripis region=<ime> | drevo map in datotek | samo na strani pod korenom projektov |
{{source>ado:…}} | povezava:projekt:repozitorij:veja:pot, neobvezni pripis #L10-L40 | vsebina ene datoteke | na strani pod korenom projektov ali znotraj imenskega prostora priklopa |
Prvi del je ključ povezave, ne njena številka; povezava se poišče znotraj projekta DWDO, ki mu pripada stran. Pri oznaki {{wk:adogit>…}} izpuščena veja pomeni privzeto vejo, izpuščena pot pa koren. Pri oznaki {{source>ado:…}} je vseh pet delov obveznih.
Oznaka {{source>ado:…}} potrebuje vtičnik wksourceview. Brez njega shema ado ni registrirana in izris pove, da vir ni na voljo. Podrobnosti in nastavitve izrisa opisuje Kako prikazati izvorno kodo na strani wikija.
Dejanja in vstopne točke
| Naslov | Kdo | Namen |
|---|---|---|
do=admin&page=wkdoadogit_mounts | nadskrbnik | priklopi in njihove ravni |
do=admin&page=wkdoadogit_svn | nadskrbnik | povezave Subversion; organizacija v Azure DevOpsu ni potrebna |
do=admin&page=wkdoadogit | upravitelj | dostopni žetoni vseh uporabnikov |
do=wkdoadogit_tokens | vsak prijavljeni | lastni dostopni žetoni |
do=wkdoadogit_archive&ns=…&ref=… | raven 2 ali več | prenos posnetka kot arhiv ZIP |
do=wkdoadogit_diag | – | preglednica razrešenih storitev |
do=wkdoadogit_stepup | – | most za dokaz drugega dejavnika |
lib/plugins/wkdoadogit/git.php/<pot-priklopa> | odjemalec git | posrednik za clone, pull in push |
Povezave se ne urejajo tu, ampak v vtičniku wkdoado, na strani projekta z dejanjem do=wkdoado.
Osebni dostopni žetoni
Zunanji odjemalci git se pri posredniku prijavijo kot uporabnik wikija, in sicer z osebnim žetonom; geslo wikija v odjemalcu git ni potrebno. Vsak prijavljeni uporabnik upravlja svoje žetone na naslovu /doku.php?do=wkdoadogit_tokens, skrbniki pa še v meniju Dostopni žetoni ADO-Git. Shrani se samo zgoščena vrednost, navadno besedilo pa se prikaže natanko enkrat, ob izdaji. Vsak žeton se začne s predpono wkg_.
Za clone je potrebna raven vsaj 2, za push pa vsaj 4. Pri ravneh od 4 do 7 so dovoljene samo veje pod refs/heads/users/<prijavno-ime>/. Postopek opisuje Kako klonirati priklopljen repozitorij.
Nastavitve
| Ključ | Privzeto | Učinek |
|---|---|---|
mount_languages | de,en,hr,it,sl | jezikovni deli, v katere se razširi priklop z nadomestkom {lang} |
Drugih nastavitev ta vtičnik namenoma nima: povezava pride iz vtičnika wkdoado, pravice iz DokuWikija, priklopi pa iz shrambe.
Tehnični zapisi (za upravitelje in razvijalce): Zagon posrednika git na prenosnem strežniku · Od kod registracija priklopa dobi besedišče ravni.
Dodatno: datoteka README v repozitoriju wkdoadogit; pregled paketov je v Pregledu DWE.
Gradi na: wkcore (register storitev) · wkdocore (projekt in vloge) · wkdostorage (priklopi in žetoni) · wkdoado (povezava z Azure DevOpsom) · wksourceview (izvorna koda in predal) · wkfluentui (gradniki in glava dokumenta).
Ne zamenjujte ga z wkdogit, ki streže krajevne repozitorije prek programa git in samo za branje.
wkcore, wkdocore, wkdostorage, wkdoado, wksourceview in wkdogit zaenkrat obstajajo samo v nemščini, zato povezave vodijo tja.
Sorodne teme
- ADO-Git — vstop in pogosta opravila
- Koncepti — priklopi, raven vidnosti, drugi dejavnik, meje
- Vodnik — od povezave do vidne datoteke
- wkdoado — povezava, na kateri ta paket temelji
- Kloniranje repozitorija — ista končna točka z vidika uporabnika