Oblikovanje razvijalskih elementov besedila
Dosledno oblikovanje pomaga bralcu najti in razumeti informacije. Za elemente, ki se pogosto pojavljajo v razvijalski vsebini, veljajo spodnje konvencije. Imena elementov, ključne besede in koda ohranijo izvirno pisavo (velike/male črke po API-ju); ne prevajamo in ne spreminjamo jih.
Glej tudi: Velika in mala začetnica, Oblikovanje besedila v navodilih
| Element | Oblika | Primer |
|---|---|---|
| Razredi, strukture, člani, metode, lastnosti, polja, dogodki | krepko; velike začetnice po API-ju | BitArray, OpenForm, AbsolutePosition |
| Koda, ključne besede, spremenljivke v besedilu | enotni razmik (monospace) | #include <iostream.h> |
| Ukazi ukazne vrstice | krepko, vse z malo | copy |
| Stikala/možnosti ukazov | krepko, natanko kot se vtipkajo | /a |
| Konstante, vrednosti, registri, vrata, ročniki | vse z veliko (po API-ju) | INT_MAX, LPT1, HWND |
| Podatkovni tipi, direktive, makri | krepko | DWORD, #include, LOWORD |
| Logični operatorji | krepko, vse z veliko | AND, XOR |
| Nastavitve registra | prva raven vse z veliko, ločeno s podčrtajem, krepko | HKEY_LOCAL_MACHINE |
| Parametri, ograde, spremenljivke | ležeče | hdc, version, file_name |
| Matematične spremenljivke | ležeče | a + b = c |
| Sporočila o napakah | stavčna začetnica; v besedilu v narekovajih | »Med obdelavo poročila je prišlo do napake.« |
| Pripone datotek | vse z malo, s piko | .pdf, .docx |
| Imena datotek in map (vzorčna) | kot dejansko ime; brez vsiljene naslovne rabe | Obracun2026.xlsx, mapa Dokumenti |
| Oznake (HTML/XML), elementi sheme | krepko | <img>, element ElementType |
| Besedilo/nizi vmesnika | stavčna začetnica | Uvozi iz datoteke |
| Izdelki in blagovne znamke | uradni zapis | Visual Studio Code |
| Novi izrazi (ob prvi rabi) | ležeče, takoj pojasnjeno | Storitev ima strežniški in odjemalski del. |
| Naslovi URL | vse z malo | example.com |
| Uporabnikov vnos | krepko; velikost črk ohranite, kadar je pomembna | Vnesite hello world |
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.
sl/wiki/help/style-guide/developer-content/formatting-developer-text-elements.txt · Zadnja sprememba: uporabnika 127.0.0.1