Slovenski slogovni priročnik

The White Knight Labs · hišni slogovni priročnik za pisanje, prevajanje in lokalizacijo slovenske tehnične vsebine: dokumentacije, uporabniških vmesnikov, navodil, opozoril in spletnih besedil.

Priročnik je izvirno napisan za slovenščino in za potrebe The White Knight Labs. Upošteva Slovenski pravopis, slovnico, ustaljeno strokovno rabo in naravno sodobno slovenščino. Ni prevod angleškega vodnika. Za razdelitev na razdelke je vzet zgled Microsoftovega slogovnega vodnika (glej opombo o viru na dnu), vsebina pa je samostojna. Kjer se slovenščina od angleščine bistveno razlikuje (velika začetnica, ločila, števila, nagovor, tvorba besed), veljajo slovenska pravila, ne angleška.

Za vsakogar, ki v slovenščini piše o programski opremi in tehnologiji: razvijalce, tehnične pisce, prevajalce, lokalizatorje, oblikovalce vmesnikov in urednike. Posebno jezikoslovno predznanje ni potrebno – priročnik podaja neposredno uporabna pravila in slovenske primere.

1. Jasnost pred vsem. Bralec naj besedilo razume že ob prvem branju. Kratke povedi, konkreten glagol, en pojem naenkrat.
2. Naravna slovenščina. Slovenska stavčna zgradba, ne kalkiranje angleščine. Kjer obstaja dober domač izraz, ima prednost pred anglicizmom.
3. Spoštljiv, nevtralen ton. Dosledno vikanje ali brezosebni nagovor; brez ukazovalnosti in brez pretiranega trženja.
4. Doslednost. Isti pojem = isti izraz skozi vso dokumentacijo.
5. Dostopnost in vključenost. Besedilo naj deluje za vse uporabnike in nikogar ne izključuje.

• Dobrodošli v priročniku
• Novosti in različice

• Glas: preprosto in človeško
• 10 nasvetov za dober slog
• Vključujoče in nepristransko izražanje
• Militaristični jezik

• Slovnica in besedne vrste
• Ločila
• Velika in mala začetnica
• Števila, datumi, enote
• Izbira besed in terminologija
• Kratice in okrajšave

• Oblikovanje besedila
• Pregledna vsebina
• Navodila po korakih
• Prilagodljiva vsebina

• Dostopnost
• Pisanje za mednarodno občinstvo
• Razvijalska vsebina
• Klepetalni roboti in virtualni agenti

• Načrtovanje vsebine
• Načrtovanje oblike
• Pisanje za iskalnike
• Spletni naslovi
• Končni pregled pred objavo

• Pregled vseh kontrolnih seznamov

Pri dvomih preverite uveljavljene slovenske vire:

• Fran (ISJ ZRC SAZU) – vstopna točka do SSKJ, Slovenskega pravopisa in terminoloških slovarjev
• SSKJ – pomen in raba besed
• Slovenski pravopis – zapis, velika začetnica, ločila, sklanjanje
• Islovar – terminološki slovar informatike
• Jezikovna svetovalnica (ISJ ZRC SAZU) – razlage spornih primerov
• Microsoftov terminološki portal – uveljavljene ustreznice za programsko opremo

The White Knight Labs – Slovenski slogovni priročnik · avtor: Wolfgang van der Stille
Vsebina je izvirno napisana za slovenščino po Slovenskem pravopisu, SSKJ in Fran. Za zgradbo (razdelitev na razdelke) je vzet zgled dela Microsoft Writing Style Guide (© Microsoft Corporation, CC BY 4.0). Ta priročnik ni Microsoftov dokument in ni povezan z Microsoftom.

DISCUSSION:off