Brzi početak: prikaz datoteke izvornog koda na stranici
Najkraći put od „dodatak je instaliran“ do „datoteka stoji na wiki stranici s isticanjem sintakse i brojevima redaka“. Tri koraka, otprilike pet minuta.
Preduvjeti
wksourceviewje instaliran i uključen u upravitelju proširenja.- Smijete čitati datoteku. Dodatak provjerava pravo čitanja pri svakom pozivu: ono što ne možete otvoriti u upravitelju medija neće se ni ovdje prikazati.
- Smijete uređivati stranicu.
Korak 1: prenesite datoteku
Otvorite upravitelj medija (/doku.php?do=media), stvorite imenski prostor dev i prenesite datoteku izvornog koda, primjerice primjer.php.
Oznaka medija tada glasi dev:primjer.php.
Korak 2: umetnite je
Uredite stranicu i upišite:
{{source>media:dev:primjer.php}}
media: imenuje izvor koji razrješava ostatak navoda. Ugrađeni su media: (medijski arhiv) i page: (izvorni tekst wiki stranice); git: i ado: dolaze s dodacima wkdogit odnosno wkdoadogit.
Korak 3: ograničite se na bitne retke
Cijela datoteka rijetko je poanta. Dodajte raspon redaka:
{{source>media:dev:primjer.php#L10-L40}}
| Navod | Prikazuje |
|---|---|
#L25 | samo redak 25 |
#L10-L40 | retke od 10 do 40, uključivo |
#L10- | od retka 10 do kraja datoteke |
Raspon koji prelazi kraj datoteke ograničava se na zadnji redak — daje dakle ostatak, a ne pogrešku.
Provjera rezultata
- Blok stoji na stranici, istaknut i numeriran. Jezik je prepoznat iz nastavka datoteke.
- Naslov bloka imenuje datoteku i upućuje na nju.
- Svaki redak nosi sidro: kliknite broj retka i dobivate adresu koja pokazuje točno na taj redak.
Vidite li umjesto toga kratku obavijest nedostupno, poveznicu za preuzimanje ili neistaknut tekst, datoteka je pronađena, ali je nešto odbilo prikazati je kao izvorni kod — uzroci i rješenja stoje na stranici paketa.
Sljedeći korak
- wkdoadogit — isti prikaz za datoteke iz Azure DevOps repozitorija.
- wkdogit — isto za lokalni repozitorij na poslužitelju.
- wksourceview (njemački) — stranica paketa: potpuna gramatika reference, načini prikaza i granice
max_bytesimax_lines.