Ponazarjanje omrežnega prometa
Pri grafičnem prikazu tokov omrežnega prometa (s panožnimi ali lastniškimi protokoli) veljajo spodnje smernice. Diagramu vedno dodajte legendo, ki pojasni uporabljene vizualne konvencije. Notacija protokolov in vrat je jezikovno neodvisna in ostane v izvirni tehnični obliki.
Barve
Za pomembne elemente uporabljajte dosledno barvo (bela, siva ali svetla poudarjena), z dodatnimi barvami le za poudarke. Besedilo, grafika in črte naj imajo dovolj kontrasta z ozadjem – za bralce s slabšim vidom in za črno-bel tisk. Glej Barve in vzorci.
Besedilo
Uporabljajte stavčno rabo velikih začetnic (glej Velika in mala začetnica).
Puščice, črte in oznake
- Puščice označujejo, kdo sproži komunikacijo: enosmerna puščica en pobudnik, dvosmerna oba konca; ko je povezava vzpostavljena, poteka komunikacija v obeh primerih v obe smeri.
- Različni slogi črt razlikujejo posamezne tokove; barve naj bodo razločljive tudi v črno-belem.
- Konkreten promet označite – oznako po možnosti položite na črto, sicer dodajte oblaček z napisom.
- Varnostne meje prikažite s polno navpično črto; črte prometa čez mejo narišite ustrezno.
Standardna skladnja
Za oznako toka uporabite naslednjo (jezikovno neodvisno) skladnjo:
SUBSUBPROT/SUBPROT/PROT/TCP IzvornaVrata->CiljnaVrata,UDP IzvornaVrata->CiljnaVrata
- PROT – protokoli s standardno kratico, od najvišjega do najnižjega v skladu (npr.
XMPP/MTLS). - /TCP, /UDP, /TCP&UDP – vrsta prometa; če oba uporabljata ista vrata,
/TCP&UDP./TCPse sme izpustiti pri izključno prometu TCP;/UDPse navede vedno. - IzvornaVrata→CiljnaVrata – izvorna in ciljna vrata; za dinamično dodeljena izvorna vrata oznaka
dyn. Številke vrat pišite brez ločil tisočic (41239).
| S protokoli in vrati | Skrajšano |
|---|---|
| HTTP/TCP dyn→80 | HTTP |
| HTTP/TCP dyn→443 | HTTPS |
| SRTP/TCP&UDP dyn→50000-59999 | SRTP/TCP&UDP 50000-59999 |
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.