194. Annotazioni sulle scelte stilistiche e sul DTD di Appunti Linux

Definizioni: termini e concetti nuovi

Nel momento in cui si introduce una definizione nuova, questa viene evidenziata attraverso una qualche forma di enfatizzazione. Nel DTD si utilizza l'elemento « c o n ».

Termini tecnici stranieri, in sospeso

In generale, i termini tecnici vanno scritti senza enfatizzazioni, a meno che si tratti del momento in cui vengono introdotti e spiegati. Tuttavia, alcuni di questi sono segnalati continuamente quando si tratta di qualcosa che è «in sospeso», cioè in attesa di stabilire quale sia il modo migliore di esprimere il concetto relativo, oppure quando si tratta di qualcosa che non si intende usare in generale. L'elemento relativo nel DTD è « t e c ».

Parole chiave

Quando si devono inserire nel testo normale (esclusi i titoli) delle parole chiave, oppure delle stringhe legate al funzionamento del sistema o di un programma, compresi i nomi degli eseguibili, si utilizza un carattere dattilografico nero. A questa regola ci sono delle eccezioni, in particolare nel caso di valori numerici, qualunque sia il sistema di numerazione relativo. L'elemento relativo nel DTD è « d a t ».

Valori numerici

I valori numerici di qualunque sistema di numerazione non vengono enfatizzati. In particolare, i numeri esadecimali si indicano con la notazione 0x... e le lettere alfabetiche sono minuscole.

Classi di indirizzi IPv4

Le classi di indirizzi IPv4 sono definite da lettere alfabetiche maiuscole che qui non vengono enfatizzate.

Comandi del modem

I comandi AT e gli altri comandi dei modem vengono indicati utilizzando lettere maiuscole e senza enfatizzazioni. Ci possono essere eccezioni a questa regola, per esempio quando il contesto fa riferimento a una stringa che in quel caso particolare corrisponde proprio a un comando da inviare al modem.

Nomi

I nomi degli applicativi (non degli eseguibili), e qualunque altro nome importante, oltre che essere scritti con l'iniziale maiuscola (salvo eccezioni), sono contenuti nell'elemento « n o m e », il cui scopo pratico è quello di impedire la separazione in sillabe.

Termine tecnico straniero non enfatizzato

I termini tecnici stranieri per i quali si è persa ogni speranza di traduzione, anche se non devono essere enfatizzati, sono racchiusi all'interno dell'elemento « t t s c », che in particolare serve a impedire la suddivisione in sillabe.

Termine tecnico italiano

I termini tecnici italiani che non sono diffusi a sufficienza sono racchiusi all'interno dell'elemento « t t i d ». Questo serve in particolare per riconoscere una forma che dovrebbe essere mantenuta coerentemente nel documento.