Tehnička referenca
Priručnik za wkdoadogit: upravljanje montiranjima, oznake, svaka radnja sa svojom adresom, osobni pristupni tokeni i sve postavke. Zašto su stvari tako građene, piše u Konceptima; što želite učiniti, na ADO-Git.
Paket: wkdoadogit · Mjesto: lib/plugins/wkdoadogit/
Autor: Wolfgang van der Stille Wolfgang.van.der.Stille@gmail.com (The White Knight Labs) · Licencija: GPL 2.0-only
Upravljanje montiranjima
Zaslon je na adresi /doku.php?do=admin&page=wkdoadogit_mounts, u izborniku pod Administracija > ADO-Git montiranja repozitorija. Dostupan je samo administratorima jer se ovdje zapisuju prava za cijelo mjesto.
- Registracija teče u čarobnjaku od četiri zaslona: veza, projekt, repozitoriji (s predloškom imenskog prostora i razinom) te pregled. Popis projekata i repozitorija čita veza; slobodno polje pojavljuje se samo kad poslužitelj ne odgovori.
- Pregled je jedini zaslon koji zapisuje. Prikazuje svaki redak prava koji će nastati i upozorava ako imenski prostor već nosi wiki stranice.
- Promjena razine ili imenskog prostora: u izborniku retka montiranja ispravite polje imenskog prostora i odabir razine, zatim odaberite Spremi. Oboje se mijenja u jednom koraku, a stara se pravila uklanjaju tek nakon uspješnog preseljenja.
- Uklanjanje: u izborniku retka odaberite Ukloni.
- Izbornik retka uz to donosi adresu za
clonepo jeziku i gotove oznake za prikaz repozitorija na wiki stranici.
Svaka radnja najprije zapisuje montiranje, a zatim prava.
Sintaksa
| Oznaka | Oblik | Što prikazuje | Gdje djeluje |
|---|---|---|---|
{{wk:adogit>…}} | veza:projekt:repozitorij[:grana[:putanja]], neobvezni dodatak region=<ime> | stablo mapa i datoteka | samo na stranici ispod korijena projekata |
{{source>ado:…}} | veza:projekt:repozitorij:grana:putanja, neobvezni dodatak #L10-L40 | sadržaj jedne datoteke | na stranici ispod korijena projekata ili unutar imenskog prostora montiranja |
Prvo je polje ključ veze, a ne njezin broj; traži se unutar DWDO projekta kojemu stranica pripada. Kod oznake {{wk:adogit>…}} izostavljena grana znači zadanu granu, a izostavljena putanja korijen. Kod oznake {{source>ado:…}} svih je pet polja obvezno.
Oznaka {{source>ado:…}} treba dodatak wksourceview. Bez njega shema ado nije registrirana i prikaz javlja da izvor nije dostupan. Pojedinosti i postavke prikaza opisuje Prikaz izvornog koda na wiki stranici.
Radnje i ulazne točke
| Adresa | Tko | Svrha |
|---|---|---|
do=admin&page=wkdoadogit_mounts | administrator | montiranja i njihove razine |
do=admin&page=wkdoadogit_svn | administrator | Subversion veze; organizacija u Azure DevOpsu nije potrebna |
do=admin&page=wkdoadogit | upravitelj | pristupni tokeni svih korisnika |
do=wkdoadogit_tokens | svaki prijavljeni | vlastiti pristupni tokeni |
do=wkdoadogit_archive&ns=…&ref=… | razina 2 ili više | preuzimanje snimke kao arhive ZIP |
do=wkdoadogit_diag | – | tablica razriješenih usluga |
do=wkdoadogit_stepup | – | most za dokaz drugog faktora |
lib/plugins/wkdoadogit/git.php/<putanja-montiranja> | git klijent | posrednik za clone, pull i push |
Veze se ne uređuju ovdje, nego u dodatku wkdoado, na stranici projekta s radnjom do=wkdoado.
Osobni pristupni tokeni
Vanjski se git klijenti kod posrednika prijavljuju kao korisnik wikija, i to osobnim tokenom; lozinka wikija ne ide u git klijent. Svaki prijavljeni korisnik upravlja svojim tokenima na adresi /doku.php?do=wkdoadogit_tokens, a administratori i u izborniku ADO-Git pristupni tokeni. Pohranjuje se samo raspršena vrijednost, a obični se tekst prikazuje točno jednom, pri izdavanju. Svaki token počinje prefiksom wkg_.
Za clone je potrebna razina 2, za push razina 4. Na razinama od 4 do 7 dopuštene su samo grane ispod refs/heads/users/<prijava>/. Postupak opisuje Kloniranje montiranog repozitorija.
Postavke
| Ključ | Zadano | Učinak |
|---|---|---|
mount_languages | de,en,hr,it,sl | jezični dijelovi u koje se širi montiranje s rezerviranom riječi {lang} |
Drugih postavki paket namjerno nema: veza dolazi iz dodatka wkdoado, prava iz DokuWikija, a montiranja iz pohrane.
Tehnički zapisi (za operatere i razvijatelje): Puštanje git posrednika u rad na prijenosnom poslužitelju · Odakle registracija montiranja uzima rječnik razina.
Dodatno: datoteka README u repozitoriju wkdoadogit; pregled paketa nalazi se u Pregledu DWE.
Gradi na: wkcore (registar usluga) · wkdocore (projekt i uloge) · wkdostorage (montiranja i tokeni) · wkdoado (veza s Azure DevOpsom) · wksourceview (izvorni kod i ladica) · wkfluentui (gradivni elementi i zaglavlje dokumenta).
Nemojte ga zamijeniti s wkdogit, koji poslužuje mjesne repozitorije preko programa git, isključivo za čitanje.
wkcore, wkdocore, wkdostorage, wkdoado, wksourceview, wkfluentui i wkdogit zasad postoje samo na njemačkom, pa poveznice vode onamo.
Povezane teme
- ADO-Git — ulaz i česti zadatci
- Koncepti — montiranja, razina vidljivosti, drugi faktor, granice
- Vodič — od veze do vidljive datoteke
- wkdoado (de) — veza na kojoj ovaj paket počiva
- Kloniranje repozitorija — ista krajnja točka iz korisničke perspektive