Template:Doc/doc/hr

From Valve Developer Community
Jump to navigation Jump to search
Edit-copy.png

Predložak {{doc}} je osmišljen za dodavanje bloka dokumentacije na različite stranice (uglavnom stranice predložaka). Podstranice određenog jezika bit će učitane u blok dokumentacije ovisno o jeziku korisničkog sučelja. U slučaju engleskog jezika, dokumentacija će biti preuzeta s podstranice /doc. Ali u svim ostalim slučajevima, dokumentacija će biti preuzeta s podstranice /doc/<Jezik kod>

Alati

Glavni alati nalaze se gore desno, iznad bloka za dokumentaciju:

  • Stvori – otvara izradu stranice dokumentacije. Pojavljuje se samo ako stranica dokumentacije ne postoji.
Note.pngBilješka: Ako nema nikakve dokumentacije, gumb će učitati dokumentaciju za prethodno učitavanje, Template:Doc/preload ili Template:Doc/preload/<Jezik kod> (ako jezik korisničkog sučelja nije engleski i postoje prijevodi stranice za prethodno učitavanje), kao sadržaj nove stranice i otvoriti stranicu za uređivanje. Ako postoji dokumentacija na engleskom, gumb će unaprijed učitati englesku dokumentaciju kao sadržaj.
  • Prikaz – otvara stranicu s dokumentacijom.
  • Uredi – otvara stranicu za uređivanje dokumentacije.
  • Povijest – otvara povijest promjena na stranici dokumentacije.
Note.pngBilješka: Ako nema nijednog od gore navedenih alata, tada je tekst dokumentacije napisan pomoću parametra {{{content}}} ili je parametar {{{tools}}} postavljen na 0.

Također, u gornjem desnom kutu nalazi se gumb označen elipsom [ … ]. On proširuje/sažima dodatne alate:

  • Sandbox – otvara stvaranje podstranice /sandbox i kopira kod izvorne stranice ili, ako ta stranica postoji, jednostavno je otvara.
  • Testcases – otvara podstranicu /testcases. Korisno za testiranje predloška u različitim situacijama.
  • Subpages – otvara Special:PrefixIndex i ubacuje naziv stranice za pretraživanje svih podstranica.
  • Purge – otvara prozor s porukom o brisanju stranice.

Jezična traka

U gornjem desnom kutu, ispod alata, nalaze se zastavice koje prebacuju dokumentaciju na drugi jezik. Prebacivanje se provodi umetanjem &uselang=<Jezik kod> u poveznicu stranice, pa ako kliknete na drugi jezik, tada će se zajedno s dokumentacijom promijeniti i jezik sučelja.

Ako ne postoji dokumentacija na određenom jeziku, prikazat će se poruka „Stranica dokumentacije <page> ne postoji“. Ako je {{{pagespace}}} ili stvarni prostor stranice User, tada će se umjesto toga prikazati poruka „<korisnik> nije dao informacije o sebi na ovom jeziku (<stranica>).“. Također, nakon ove poruke prikazat će se dokumentacija na engleskom jeziku, ako postoji.

Parametri

  • {{{1}}}: parametar za promjenu dodjele predloška:
    • Ako vam je potreban standardni blok dokumentacije, nemojte ništa unositi u ovaj parametar.
    • 0 – prikazat će poruku „Ovo je podstranica dokumentacije za <stranicu>“.
    • 1 – prikazat će poruku „Ovo je podstranica sandboxa za <stranicu>“.
    • 2 – prikazat će poruku „Ova stranica nije sandbox“.
    • 3 – prikazat će poruku „Ovo je podstranica s informacijama o <stranici>“. Korisno za korisničke podstranice.
    • 4 – prikazat će poruku „Ovo je podstranica dokumentacije za korištenje na više stranica“. Ako se koristi parametar {{{list}}}, tada će tekst biti: „Ovo je podstranica dokumentacije za korištenje na više stranica navedenih u <stranica popisa>“.
  • {{{list}}}: određuje stranicu ili kategoriju koja navodi stranice koristeći određenu stranicu dokumentacije. Koristi se samo ako je parametar {{{1}}} postavljen na 4.
  • {{{docpage}}}: stranica koja će se koristiti kao dokumentacija.
  • {{{DocParam1}}} do {{{DocParam5}}}: Neobavezni parametri proslijeđeni stranici dokumentacije.
    • Ako dokumentacija koristi {{{DocParam1}}}, tada će prosljeđivanje {{{DocParam1}}} u uključivanju predloška (npr. {{Doc|DocParam1=Hello World!}}) utjecati na način prikaza dokumenta, što je dobro za stranice dokumentacije kojima je potrebna samo drugačija vrijednost.
  • {{{content</jezik kod>}}}: sadržaj koji će se koristiti kao dokumentacija, umjesto zasebne stranice. Prilikom korištenja, glavni alati su skriveni.
  • {{{pagespace}}}: Prostor na stranici određuje se automatski, ali možete unijeti i svoj vlastiti. Tekst u zaglavlju ovisi o ovom parametru:
    • Predložak → “Dokumentacija predloška”
    • Datoteka → “Sažetak”
    • Korisnik → “O nama”
    • U svim ostalim slučajevima bit će “Dokumentacija”
Note.pngBilješka: Ako je {{{pagespace}}} ili stvarni prostor stranice "User", tada će se tekst preuzeti s podstranice /about, a ne s /doc.
  • {{{tools}}}: kontrolira koje će se tipke alata prikazivati:
    • 0 – nema gumba.
    • 1 – samo gumbi „Izradi“, „Prikaži“, „Uredi“ i „Povijest“.
    • U svim ostalim slučajevima bit će svi gumbi

Izrada dokumentacije

Warning.pngWarning: Ako želite dodati simbol “|” negdje u tekstu (predlošci i ostali MediaWiki elementi nisu pogođeni), upotrijebite &#124;.

Za početak izrade dokumentacije kliknite gumb „Izradi“ u gornjem desnom kutu. Gumb učitava unaprijed učitani dokument (ili kao unaprijed učitani dokument ako postoji dokument na engleskom jeziku). Zatim se piše sam tekst dokumentacije. Prvo slijedi kratki opis, a zatim - ovisno o tome za što je dokumentacija napisana. Ako želite dodati kategorije, samo ih dodajte tamo gdje je naznačeno u unaprijed učitanoj dokumentaciji.

Podstranice

Na {{Doc}} postoje neke podstranice i podpredlošci. Napravljeni su kako bi olakšali stvari.

{{Doc/subpage}}

Ovaj predložak je zamjena za <noinclude>{{doc|0}}</noinclude>. Može biti umjesto <noinclude>{{doc|0}}</noinclude>.

Njegova je svrha ista kao i {{Documentation subpage}}.

Može izbjeći problem da se stranica za prethodno učitavanje ne učitava <noinclude>{{doc|0}}</noinclude>.

{{Doc/Sandbox other}}

Ovaj predložak dodaje sadržaj zasebno glavnom predlošku i njegovim podstranicama (dokumentima). Koristan je za dodavanje kategorija.

Njegova je svrha ista kao i kod {{Sandbox other}}.

Template:Doc/preload

Ovo je stranica koja se prethodno učitava kada kliknete gumb za izradu. Možete joj dodati prijevode.

Template:Doc/doc
Icon-template-orange.png
Summary
Uključuje podstranicu dokumentacije
Type
Predložak omotača
Contributors
N/B
Creation date
22.08.2022.
(22. kolovoza 2022.)
Notes
N/B
Subpages
Documentation
N/B
Preload
N/B
Sandbox
N/B
Strings
N/B
Testcases
N/B
Revision information
Latest editor
N0one
Last edited
10/05/2026
20260510025028
Revision size
7320 bytes
7.32 kilobytes
0.00732 megabytes
Technical information
Page identifier
73546
Contains translations
Da
Uses parser functions?
Da
Uses variables?
Da