Valve Developer Community:Stilski vodič
|
Ovaj članak detaljno opisuje konvencije koje se tiču stiliziranja stranica u zajednici Valve Developer Community. S obzirom da ljudi imaju svoje stilove pisanja, te da različito uče jedni od drugih, to znači da će biti primjetna suprotnost u mišljenjima, kvaliteti članaka i suradnji.
Nadamo se da bi ovaj vodič trebao pomoći u raspršivanju te ideje i stoga standardizirati dosljedan stil pisanja i oblikovanja u cijelom wikiju. Međutim, za pokrivanje svih situacija koje se tiču stiliziranja trebalo bi dulje vrijeme, i kao takav sljedeći sadržaj služi samo kao referenca za sadržaj koji je specifičan za Valve Developer Community.
Naslovi članaka
Naslov članka treba biti kratak i sladak.
Treba izbjegavati suvišne ili suvišne riječi, poput "najvažnije" (most important), "točno" (correct) ili "apsolutno" (absolutely), jer površno povećavaju važnost članka.
Također imajte na umu da naslov članka ne smije biti nejasan jer bi to zamaglilo informacije. Naslov članka treba biti jasno napisan i lako razumljiv na prvi pogled.
Evo nekoliko primjera dobrih naslova:
- Hammer Editor
- Source
- Steam Deck
- Team Fortress 2
- Engine lighting
Evo nekoliko primjera loših naslova:
- My favorite games (Nije neutralno gledište ili treće lice. Također pokazuje favoriziranje)
- Comparison of baked lighting and engine lighting (Nije sažeto; dugotrajan)
- Proper tutorial on how to create a map for the source engine (Nije sažeto. Naslov također sadrži suvišne i pretenciozne formulacije)
- Lorem ipsum (Frfljanje; lažni tekst bez značenja)
- Doom mappers reference (Iako se može uspostaviti tanka veza, ova tema nije od interesa za Valve Developer Community. Bolje se snalazi na drugom wikiju, kao što je Doom Wiki)
Kao iznimka od gornjih smjernica — stranice korisničkog imenskog prostora mogu se imenovati kako vama odgovara, pod uvjetom da nazivi stranica nisu vulgarni, uvredljivi ili maloljetnički. npr.: User:Example/My guide to cubemaps
(Potpuno prihvatljivo ime stranice).
Formulacija
Valve Developer Community
Kada se u člancima spominje naziv wikija, treba ga koristiti na jedan od dva načina:
Stenografija
- VDC, VDC Wiki, ili jednostavno Wiki.
Običan rukopis
- Valve Developer Wiki, Valve Developer Community ili Valve Developer Community Wiki.
Slike
Različite slike koje su učitane na wiki trebale bi imati vlastiti prefiks ili sufiks kako bi se razlikovale od drugih datoteka i kako bi se pomoglo u kategorizaciji i korištenju takvih datoteka na wikiju.
Ispod je popis prefiksa i/ili sufiksa koje treba dodijeliti njihovim povezanim datotekama.
Slike korisnika
- Korisnički avatari: UserAvatar-
- Okviri korisničkih avatara: UserAvatarFrame-
- Korisničke korice: UserCover-
Sufiks za korisničke slike treba biti ime korisnika s kojim su slike povezane, npr.: "-Example"
Slike logotipa i ikona
- Slike logotipa: Logo-
- Slike ikona: Icon-
Slike softvera
- Softver pokriva: Software Cover-
- Snimke zaslona stranice softvera: -Screenshot #
Ostalo
- Slike izvješća o pogrešci (uključujući animirane): Bug-
- Za animirane slike koristite GIF ili APNG (animirani PNG).