Kako prikazati izvorni kod na wiki stranici

Okolnost

Repozitorij je montiran i sada se treba pojaviti na wiki stranici — bilo cijelo stablo za pregledavanje, bilo jedna datoteka ili raspon redaka uz objašnjenje.

Pregled rješenja

Postoje dvije oznake. Zamjena jedne drugom najčešća je pogreška pri ugradnji.

Oznaka	Što prikazuje	Tko je crta	Gdje djeluje
`{{wk:adogit>…}}`	stablo mapa i datoteka cijelog repozitorija	dodatak `wkdoadogit`	samo na stranici ispod korijena projekata, primjerice `hr:projects:dwplugins:repos`
`{{source>ado:…}}`	sadržaj jedne datoteke	dodatak `wksourceview` preko sheme `ado`	na stranici ispod korijena projekata ili na stranici unutar imenskog prostora montiranja

Obje prolaze kroz ista prava: o pristupu odlučuje imenski prostor montiranja, nikad stranica na kojoj oznaka stoji.

Izvedba

Stablo repozitorija

{{wk:adogit>wvds:DokuWiki-Plugins:wkdoadogit}}

Oblik glasi {{wk:adogit>veza:projekt:repozitorij[:grana[:putanja]]}}. Izostavljena grana znači zadanu granu repozitorija, a izostavljena putanja korijen. Neobvezni dodatak region=<ime> na kraju nudi preglednik bočnom području ljuske:

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

Jedna datoteka

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

Oblik glasi {{source>ado:veza:projekt:repozitorij:grana:putanja}}. Kod ove su oznake svih pet polja obvezna, pa granu uvijek navedite. Prazno polje znači odbijanje, a ne zadanu granu.

Raspon redaka

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

Dopušteni su zapisi #L25, #L10-L40 i otvoreni #L10-. Broji se od 1, a raspon se skraćuje na duljinu datoteke. Raspon djeluje samo na prikaz jer se iz Azure DevOpsa uvijek prenosi cijela datoteka.

Postavke prikaza

Postavke pišete iza razmaka. Vrijede za dodatak wksourceview, a ne za shemu ado.

{{source>ado:wvds:DokuWiki-Plugins:wkdoadogit:main:/README.md#L1-L20 mode=block numbers=1 lang=markdown}}

Postavka	Vrijednosti	Zadano
`mode`	`inline`, `block`, `preview` ili `drawer`	vrijednost postavke `default_mode` dodatka `wksourceview`
`numbers`	`0` ili `1`	vrijednost postavke `default_numbers`
`lang`	ime jezika za isticanje sintakse	prepoznaje se iz nastavka datoteke

Napomene

Prvo je polje ključ veze, a ne njezin broj. Veza se traži po ključu unutar DWDO projekta kojemu stranica pripada; brojčani zapis ne radi.
Svaka je ugradnja mrežni poziv. Stranica s desetak ugradnji plaća desetak poziva, ograničenih vremenskim granicama i granicom bajtova u dodatku wkdoado.
Ugradnja pričvršćena uz granu tiho se pomiče. Tekst koji objašnjava redak 40 i dalje se crta kad je kod otišao na redak 90. Za objašnjenja zato radije pričvrstite commit (40 heksadekadskih znakova) nego granu.
Stranica s ugradnjom ne sprema se u predmemoriju. Obje oznake isključuju predmemoriju stranica, da sadržaj zaštićen pravima ne dođe do pogrešnog čitatelja.
Prevelike i binarne datoteke ne crtaju se. Umjesto sadržaja pojavljuje se kartica sa stanjem; granice postavljaju max_bytes i max_lines dodatka wksourceview.
Odbijanje ne navodi uzrok. Nemontirani repozitorij, nepoznata veza i nedostatak prava odgovaraju namjerno slično.

Povezane teme

Vodič: stranica s preglednikom – prva stranica s preglednikom, s cijelim primjerom
Kako urediti datoteku i napraviti commit iz wikija – uređivanje datoteke i commit iz preglednika
Tehnička referenca: razina vidljivosti – tko smije vidjeti ugrađeni sadržaj
Dijagnostika – što znači koja kartica sa stanjem