[successivo] [precedente] [inizio] [fine] [indice generale] [violazione GPL] [translators] [docinfo] [indice analitico] [volume] [parte]
Questo capitolo raccoglie alcune convenzioni importanti relative all'opera Appunti di informatica libera. Le annotazioni sulla terminologia sono separate in un altro capitolo.
In informatica si utilizzano delle unità di misura e dei moltiplicatori ben conosciuti, ma senza uno standard simbolico ben definito. Nel testo di questo documento si usano le convenzioni elencate nel seguito.
In particolare è bene distinguere tra il nome di un'unità di misura e il simbolo che la rappresenta: quando si parla dell'unità si usa il nome esteso, minuscolo; quando si indica un valore si deve usare il simbolo. In altri termini, si può parlare di hertz in generale, ma poi si indicano n Hz per indicarne una quantità precisa.
Quando si nominano i prefissi moltiplicatori, come «mega», «giga» e «tera», si usano le iniziali minuscole anche se il simbolo corrispondente è dato dalla loro iniziale maiuscola.
byte, Kibyte, Mibyte, Gibyte
bit, Kibit, Mibit, Gibit
l'unità byte viene indicata al minuscolo, di seguito al suo moltiplicatore eventuale. In particolare: «Ki» sta per 210 = 1 024; «Mi» sta per 220 = 1 048 576; «Gi» sta per 230 = 1 073 741 824. L'unità di misura, con il suo moltiplicatore, viene indicata dopo e staccata dalla quantità a cui si riferisce.
bit/s, kbit/s, Mbit/s
l'unità bit/s (nota comunemente come bps, ovvero Bit per second) viene indicata al minuscolo, di seguito al suo moltiplicatore eventuale. In questo caso si utilizzano i moltiplicatori standard del SI: «k» sta per 103 = 1 000; «M» sta per 106 = 1 000 000; «G» sta per 109 = 1 000 000 000. È importante ricordare che la lettera «k» deve essere minuscola.
In generale, è preferibile la notazione bit/s rispetto a bps, perché la seconda è in realtà un'abbreviazione e come tale sconsigliabile secondo il SI. A questo proposito, si può leggere Guide for the Use of the International System of Units (SI) edito dal NIST (National institute of standards and technology), <http://physics.nist.gov/cuu/pdf/sp811.pdf>, in particolare la sezione 6.1.8: Unacceptability of abbreviations for units.
Hz, kHz, MHz, GHz, THz
l'unità «hertz», il cui simbolo è «Hz», viene indicata nel modo che si vede, di seguito al suo moltiplicatore eventuale. In questo caso si utilizzano i moltiplicatori tradizionali: «k» sta per 103 = 1 000; «M» sta per 106 = 1 000 000; «G» sta per 109 = 1 000 000 000; «T» sta per 1012 = 1 000 000 000 000. È importante ricordare che la lettera «k» deve essere minuscola.(1)
Ex
La grandezza Ex rappresenta l'altezza di una lettera «x», nell'ambito del sistema di composizione tipografica utilizzato. Viene indicata nel testo in questo modo, con l'iniziale maiuscola, per evitare confusione. Nel caso della misura relativa alla lettera «M» maiuscola, si usa il termine quadratone.
Alle volte verrebbe da enfatizzare di tutto. Qui si annotano le cose che per regola non vengono enfatizzate.
Valori numerici
I valori numerici di qualunque sistema di numerazione non vengono enfatizzati. In particolare, i valori espressi in base diversa da 10, si indicano come si vede qui: 11 = 0B16 = 138 = 10112. In particolare, le lettere alfabetiche utilizzate per le basi di numerazione superiori a 10, sono maiuscole.
Classi di indirizzi IPv4
Le classi di indirizzi IPv4 sono definite da lettere alfabetiche maiuscole che qui non vengono enfatizzate.
Indirizzi IPv4
Gli indirizzi numerici IPv4, a ottetti, vengono rappresentati così come sono, senza enfatizzazioni, utilizzando eventualmente il simbolo * per rappresentare l'indifferenza del valore di uno o più ottetti.
Indirizzi IPv6
Gli indirizzi numerici IPv6 vengono rappresentati così come sono, senza enfatizzazioni, utilizzando lettere minuscole.
Denominazione dei record di risorsa nel DNS
Le sigle usate nel DNS per identificare i record di risorsa dei file di definizione delle zone, sono scritti usando lettere maiuscole, senza enfatizzazioni.
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.
I valori numerici da zero a nove vengono rappresentati preferibilmente in lettere, soprattutto per evitare ambiguità nella lettura, a meno che si presentino le condizioni seguenti:
il numero è seguito da un simbolo (secondo il SI o anche altre convenzioni), per cui si preferisce lasciarlo espresso in cifre;
il numero fa parte di un intervallo, dove l'altro valore è composto da due o più cifre, così si lascia in cifra anche il primo, dal momento che non ci possono essere ambiguità.
In generale, in questo documento, i nomi riferiti a degli «eseguibili», ovvero i programmi e gli script, sono indicati in modo evidenziato, esattamente come si utilizzano nel sistema operativo, senza cambiamenti nella collezione alfabetica delle lettere maiuscole e minuscole. Quando però il programma riveste un'importanza particolare, può assumere una denominazione diversa da quella che si usa nel nome del file eseguibile, oppure semplicemente si può decidere di trattarlo come qualcosa di più importante.
Per fare un esempio pratico, quando si parla di shell si fa riferimento alla shell Bash, alla shell Korn, alla shell C,... mentre l'eseguibile vero e proprio potrebbe essere bash, ksh, csh,... Lo stesso vale per i programmi che meritano questa attenzione anche se il loro nome (verbale) non cambia.
In generale, il nome di un programma applicativo, di un pacchetto o di altre situazioni analoghe, viene indicato con l'iniziale maiuscola, salvo eccezioni che possono derivare dall'uso acquisito in una qualche forma differente, escludendo a ogni modo l'uso di sole lettere minuscole.
La tabella 276.1 elenca alcune delle scelte di stile nell'uso dei nomi dei programmi distinguendo tra «eseguibile» e qualcosa di diverso: applicativo, pacchetto, servizio, sistema e simili, riferite a forme che costituiscono un'eccezione rispetto alla regola generale.(2)
Tabella 276.1. Stile nell'uso dei nomi dei programmi distinguendo tra «eseguibile» e «applicativo», limitatamente ad alcune eccezioni.
Gli acronimi non sono sempre ottenuti con le sole iniziali delle parole che compongono il nome di qualcosa; inoltre, non c'è alcuna necessità pratica nell'evidenziare la corrispondenza tra le lettere usate e la frase corrispondente. In questo senso, la descrizione degli acronimi che si fa con l'elemento dacronym ha un aspetto uniforme: l'iniziale maiuscola e il resto del testo in minuscolo, tranne nel caso in cui si tratti di termini che rappresentano dei nomi importanti o degli altri acronimi, oppure quando la lingua di origine impone l'uso della maiuscola. Seguono alcuni esempi:
MTA, Mail transfer agent;
XML, Extensible markup language;
ORF, Österreichischer Rundfunk (perché nella lingua tedesca i sostantivi hanno l'iniziale maiuscola);
MIME, Multipurpose Internet mail extentions (perché il nome che contiene si scrive comunemente con l'iniziale maiuscola).
Il problema della costruzione di un indice analitico è già trattato nel capitolo sullo stile letterario in generale. All'interno dell'opera Appunti di informatica libera ci sono delle particolarità che è bene precisare.
In particolare, l'indice analitico realizzato con il sistema di composizione di Appunti di informatica libera consente l'uso di un carattere dattilografico attraverso l'uso dell'elemento code, oppure assegnando il valore code all'attributo emph:
<indexentry>Perl: <code>print</code></indexentry> |
<indexentry><code>/etc/profile</code></indexentry> |
I termini inseriti nell'indice analitico vanno scritti usando lettere minuscole, a meno che si tratti di nomi particolari che vanno sempre scritti in un modo prestabilito.
La descrizione di un acronimo, inserita per esteso, si scrive con le stesse regole usate per l'elemento dacronym, per cui l'iniziale è maiuscola.
Il nome di un applicativo, di un pacchetto, di un servizio, di un sistema e simili, va scritto nello stesso modo usato nel testo normale, senza cambiare lo stato delle lettere maiuscole e minuscole.
Il nome di file e directory va scritto esattamente come appare nel sistema operativo, utilizzando un carattere dattilografico, tenendo conto che i file eseguibili vanno indicati senza percorso, mentre gli altri dovrebbero contenerlo.
Il nome delle variabili di ambiente va scritto esattamente come appare nel sistema operativo (generalmente si tratta di nomi scritti con lettere maiuscole), usando un carattere dattilografico, lasciando il dollaro come prefisso.
Quando si inserisce il nome di un applicativo che possiede un eseguibile con lo stesso nome, non si annota anche il nome dell'eseguibile. In pratica, se si inserisce la voce «Pippo» senza enfatizzazione, non si annota anche la voce «pippo», corrispondente all'eseguibile omonimo, in modo dattilografico; al massimo, si inserisce un'altra volta la stessa voce «Pippo». Infatti, chi cerca notizie sul programma Pippo, o sull'eseguibile pippo, si troverebbe in difficoltà nello scegliere tra l'una e l'altra voce. Quando invece un applicativo si articola in programmi eseguibili differenti, è sensato annotare sia il nome dell'applicativo, sia i nomi degli eseguibili, quando descritti in modo particolare.
Quando la voce «Pippo» è comunque una cosa diversa da «pippo», le due voci vanno annotate esattamente e separatamente. Per esempio, si può fare riferimento al protocollo FTP e poi al programma eseguibile ftp. Il lettore può sentirsi confuso dalla distinzione, ma in tal caso è evidentemente necessaria.
Si utilizza il singolare, salvo eccezioni dovute al fatto che il termine al singolare possa intendersi come una cosa differente da ciò che si vuole realmente.
La prima parola dovrebbe essere un sostantivo, o comunque è necessario sostantivare l'inizio della voce da inserire nell'indice analitico.
Non si inizia una voce dell'indice analitico con un verbo; nel caso si può sostantivare il verbo. Per esempio, al posto di «salvare i dati» si può inserire la voce «salvataggio dei dati».
Il sistema di composizione non consente l'indicazione di sottoclassificazioni nell'indice analitico, per cui si usa la tecnica seguente:
voce: sottoclassificazione
Questo fatto implica che i due punti vadano usati solo per questo scopo nelle voci dell'indice analitico; inoltre, diventa inopportuno l'inserimento di una sottoclassificazione ulteriore.
Una sottoclassificazione non è sottoposta all'obbligo di essere formulata usando il singolare; tuttavia, in caso di conflitto, si deve preferire la forma al singolare.
Una sottoclassificazione inizia con un sostantivo, così come iniziano le voci normali. Per esempio, «salvataggio: recuperare i dati» va sostituito con «salvataggio: recupero dei dati».
Non si usa il trattino per indicare una sottoclassificazione. Per esempio, «salvataggio -- recupero dei dati» va sostituto con «salvataggio: recupero dei dati».
Quando si inserisce una voce in una sezione, non si inserisce nuovamente nelle sottosezioni relative. In pratica, se si inserisce la voce «Pippo» in corrispondenza dell'inizio di un capitolo, non si inserisce nuovamente la stessa voce in altre sezioni inferiori dello stesso capitolo.
Le voci dell'indice analitico vanno inserite in riferimento alle sezioni opportune. Per esempio, la parola «file» potrebbe trovarsi in quasi tutte le pagine di un testo di informatica, mentre dovrebbe essere fatto un richiamo solo a quelle sezioni in cui si spiega di cosa si tratta (ammesso che ci sia).
I riferimenti per la generazione dell'indice analitico vanno posti preferibilmente nel titolo della sezione a cui fanno riferimento, come nell'esempio seguente:
<H3> Copie di sicurezza <indexentry>salvataggio: copia di sicurezza</indexentry> <indexentry>salvataggio: recupero dei dati</indexentry> </H3> |
Come si vede, viene indicato prima il titolo e subito dopo l'elenco dei riferimenti da inserire nell'indice, che riguardano la sezione.
Inserendo le voci dell'indice analitico nell'ambito del titolo di una sezione, si comprende che non abbia senso ripetere la stessa voce nelle sottosezioni relative.
La gestione corretta delle «enfatizzazioni» è sempre un problema serio di coerenza, soprattutto se si considera il fatto che l'enfatizzazione non implica solo la composizione finale con un aspetto particolare, ma anche la classificazione dell'oggetto per qualche fine. In particolare, l'elemento special non genera alcuna enfatizzazione, ma serve a dare una classificazione al termine inserito, per qualche ragione. L'opera Appunti di informatica libera usa le convenzioni che vengono sintetizzate in questa sezione.
<samp>stringa</samp>
Si usa all'interno di un testo normale per delimitare delle stringhe che hanno un valore letterale e si riferiscono in qualche modo a un'informazione tecnica. In particolare, si indicano in questo modo:
i nomi degli eseguibili;
gli esempi di opzioni di una riga di comando;
i nomi delle variabili di ambiente (senza il dollaro iniziale);
i nomi di elementi SGML (compreso XML e altre applicazioni);
gli esempi di istruzioni, comandi e direttive di qualunque tipo;
tutte le informazioni tecniche letterali che non ricadono in situazioni differenti.
<code>nome</code>
Si tratta di una forma di enfatizzazione molto simile a quella dell'elemento samp, riservata a situazioni particolari:
può essere usata per ottenere un carattere dattilografico nelle voci dell'indice analitico;
l'elemento code può essere usato come unico elemento contenuto all'interno di dt, quando in condizioni normali questo sarebbe stato rappresentato con l'elemento samp;
l'elemento code può essere usato come unico elemento contenuto all'interno di faqh3, quando in condizioni normali questo sarebbe stato rappresentato con l'elemento samp.
<indexentry>...<code>stringa</code>...</indexentry>
Nell'ambito delle voci dell'indice analitico, si può usare solo l'elemento code per indicare qualunque cosa che debba essere annotata in modo dattilografico. In pratica, tutto ciò che nel testo normale dovrebbe essere inserito usando elementi che generano in qualche modo una composizione dattilografica va scritto nell'indice analitico usando l'elemento code.
<file>file</file>
Nel testo normale, i nomi di file e directory, con o senza percorsi, vanno inseriti nell'elemento file. In generale, il nome di un file o di una directory dovrebbe sempre contenere l'informazione del percorso, salvo che si tratti implicitamente della directory corrente, oppure che non si possa stabilire una posizione precisa.
In un percorso del genere si può inserire l'elemento var, per descrivere una parte variabile dello stesso; inoltre è ammesso l'uso di caratteri jolly elementari, ovvero asterisco e punto interrogativo, per fare riferimento a più file.
I nomi delle directory terminano sempre con la barra finale: / o \ a seconda del sistema operativo a cui si fa riferimento.
Quando si vuole fare riferimento a un file contenente un documento che dovrebbe essere raggiungibile in ogni sistema che abbia installato un certo applicativo, si può usare eventualmente l'elemento uri, indicando un URI di tipo file:, allo scopo di consentire l'accesso ipertestuale al file stesso. Naturalmente, ciò ha senso se l'URI che si indica è valido; quindi non è il caso di indicare caratteri jolly in un indirizzo del genere.
<var>metavariabile</var>
L'elemento var serve a delimitare una metavariabile, ovvero qualcosa che descrive ciò che va sostituito al suo posto. Non si indicano con questo elemento altri tipi di variabili, come potrebbero essere le variabili di ambiente o quelle di un programma scritto con un certo linguaggio. In tal caso, si userebbe piuttosto l'elemento samp.
L'elemento var va usato prevalentemente all'interno dell'elemento syntax, nei modelli sintattici, ma può essere usato utilmente anche dentro un elemento samp, quando una parte della stringa non è fissa, così come in un elemento file, per lo stesso motivo.
Eccezionalmente, si può indicare un comando con l'inserzione di un elemento var all'interno del testo da digitare, ovvero l'elemento type. Tuttavia, in condizioni normali, si preferisce fare questo in un elemento syntax, se il contesto lo consente.
È consentita l'inserzione dell'elemento var anche all'interno di un elemento pre, quando non è opportuno l'uso di un elemento syntax al suo posto.
Il nome di una metavariabile dovrebbe descrivere ciò che rappresenta, mentre non deve essere un esempio del contenuto. |
Per evitare confusione, il nome va scritto usando possibilmente lettere minuscole, dove le varie parti possono essere separate da un trattino basso, come nel caso di mia_variabile. Naturalmente si possono usare anche i numeri, purché sia chiaro che servono solo a individuare la metavariabile, come nel caso di nome_1, nome_2,... nome_n. È da escludere l'uso di altri segni, perché creerebbero confusione, dal momento che i nomi delle variabili non appaiono delimitati. Se possibile è meglio evitare l'uso dell'apostrofo.
Se possibile, è meglio comporre il nome delle metavariabili usando termini normali (non abbreviati o fusi assieme), in modo da non doverli inserire inutilmente nel vocabolario del controllo ortografico.
<dfn>definizione</dfn>
L'elemento dfn serve a delimitare una definizione, ovvero un termine che viene introdotto in riferimento a un contesto particolare. Va usato solo quando viene introdotto e non ha altro scopo che quello di generare una forma di evidenziamento uniforme.
In contesti differenti, un termine può apparire come definizione avendo anche significati differenti.
In generale, è bene evitare la proliferazione di evidenziamenti del genere, che vanno limitati alle situazioni in cui si vuole cogliere l'attenzione del lettore.
<strdfn>definizione_straniera</strdfn>
L'elemento strdfn serve a delimitare un termine o una definizione in lingua straniera, che non si intende utilizzare nel testo come terminologia normale, ma solo per spiegare, eventualmente, a cosa si sta facendo riferimento.
<em>testo</em>
<strong>testo</strong>
<small>testo</small>
<big>testo</small>
Le forme di evidenziamento generico vanno usate con molta parsimonia, perché non esiste una regola generale per il loro utilizzo. In particolare, un carattere ingrandito ottenuto con l'elemento big è utile nella realizzazione di presentazioni (lucidi per lavagna luminosa).
<bibref>titolo</bibref>
Si usa l'elemento bibref, nel testo normale, per delimitare il titolo di un documento o di un'opera di qualunque tipo.
<kerneloption>opzione_del_kernel</kerneloption>
Si usa l'elemento kerneloption, nel testo normale, per delimitare la voce corrispondente a un'opzione del kernel.
<dacronym>descrizione_acronimo</dacronym>
Si usa l'elemento dacronym, nel testo normale, per delimitare la descrizione di un acronimo.
<acronym>acronimo</acronym>
Questo elemento dovrebbe servire per delimitare un acronimo, secondo la logica del sistema di composizione, ma attualmente gli acronimi non vengono delimitati in alcun modo.
<kbd>combinazione_tasti</kbd>
L'elemento kbd viene usato per indicare tasti (della tastiera) o combinazioni di tasti da premere. I nomi dei tasti vanno indicati come previsto (tabella 277.3, nel capitolo 277) e le combinazioni si ottengono inserendo il segno + tra i vari nomi o tra i simboli corrispondenti.
Nelle tabelle, quando si elencano tasti e combinazioni di tasti, non si usa questa forma di enfatizzazione, perché inutile e perché servirebbe solo a creare problemi di spazio ulteriori.
<button>pulsante_grafico</button>
L'elemento button viene usato per indicare il nome di pulsanti grafici, anche in presenza di terminali a caratteri, che si selezionano attraverso un cursore o un puntatore grafico. Non si usa questo elemento per indicare l'uso della tastiera normale.
<menuitem>voce_di_menù</menuitem>
Si delimitano in questo modo le voci di un programma grafico o di uno per terminali a caratteri che abbia un comportamento simile a quelli grafici, che siano riconducibili a scelte di un menù di funzioni. Rientrano in questa situazione i menù a tendina, i nomi delle etichette dei lembi di una sistema di cartelle, oppure il nome di un tipo di selezione che non sia riconducibile a un pulsante.
Questo elemento può essere usato anche per evidenziare le voci che rappresentano un tipo di casella di selezione, oppure anche le etichette dei campi in cui deve essere inserito qualche tipo di informazione.
<asciicode>nome_ascii</asciicode>
Si delimitano in questo modo i nomi di caratteri speciali ASCII, che secondo la tradizione sono rappresentati da abbreviazioni con lettere maiuscole. La tabella 276.2 elenca tutti i caratteri che possono essere rappresentati in questo modo, mostrando anche il risultato dell'utilizzo dell'elemento.
Tabella 276.2. Elenco dei caratteri speciali che si possono inserire nell'elemento asciicode.
Binario | Esadecimale | Ottale | Decimale | Carattere |
000000002 | 0016 | 0008 | 00010 | <NUL> |
000000012 | 0116 | 0018 | 00110 | <SOH> |
000000102 | 0216 | 0028 | 00210 | <STX> |
000000112 | 0316 | 0038 | 00310 | <ETX> |
000001002 | 0416 | 0048 | 00410 | <EOT> |
000001012 | 0516 | 0058 | 00510 | <ENQ> |
000001102 | 0616 | 0068 | 00610 | <ACK> |
000001112 | 0716 | 0078 | 00710 | <BEL> |
000010002 | 0816 | 0108 | 00810 | <BS> |
000010012 | 0916 | 0118 | 00910 | <HT> |
000010102 | 0A16 | 0128 | 01010 | <LF> |
000010112 | 0B16 | 0138 | 01110 | <VT> |
000011002 | 0C16 | 0148 | 01210 | <FF> |
000011012 | 0D16 | 0158 | 01310 | <CR> |
000011102 | 0E16 | 0168 | 01410 | <SO> |
000011112 | 0F16 | 0178 | 01510 | <SI> |
000100002 | 1016 | 0208 | 01610 | <DLE> |
000100012 | 1116 | 0218 | 01710 | <DC1> |
000100102 | 1216 | 0228 | 01810 | <DC2> |
000100112 | 1316 | 0238 | 01910 | <DC3> |
000101002 | 1416 | 0248 | 02010 | <DC4> |
000101012 | 1516 | 0258 | 02110 | <NAK> |
000101102 | 1616 | 0268 | 02210 | <SYN> |
000101112 | 1716 | 0278 | 02310 | <ETB> |
000110002 | 1816 | 0308 | 02410 | <CAN> |
000110012 | 1916 | 0318 | 02510 | <EM> |
000110102 | 1A16 | 0328 | 02610 | <SUB> |
000110112 | 1B16 | 0338 | 02710 | <ESC> |
000111002 | 1C16 | 0348 | 02810 | <FS> |
000111012 | 1D16 | 0358 | 02910 | <GS> |
000111102 | 1E16 | 0368 | 03010 | <RS> |
000111112 | 1F16 | 0378 | 03110 | <US> |
001000002 | 2016 | 0408 | 03210 | <SP> |
011111112 | 7F16 | 1778 | 12710 | <DEL> |
La sequenza di più caratteri del genere si ottiene semplicemente mettendo a contatto più elemento asciicode, come per esempio nel caso di <CR><LF>.
<uristr>uri_non_ipertestuale</uristr>
L'elemento uristr si affianca all'elemento uri, con lo scopo di rappresentare degli indirizzi URI per i quali non si vuole realizzare un riferimento ipertestuale. Ciò si rende necessario quando si scrive un indirizzo di fantasia o un indirizzo che si vuole conservare pur non essendo più valido. Si usa questo elemento anche quando si tratta di nomi di dominio, senza l'indicazione di una risorsa precisa.
<special special="name">nome</special>
Serve a delimitare, senza evidenziare, un nome. Si ottiene l'elenco dei nomi usati con l'inserzione del marcatore <printindex index="name">, allo scopo di verificare di avere usato sempre lo stesso modo. Ciò si rende necessario per mantenere coerenza nell'uso delle maiuscole e di altri simboli eventuali (come il trattino normale, il trattino basso e altre inserzioni che potrebbero fare parte del nome in qualche modo).
In generale si utilizza questo elemento per i nomi dei programmi e dei pacchetti di programmi. Per tutte le altre situazioni conviene controllare se nel sorgente è già stato usato un elemento del genere per il nome che si inserisce.
<special special="ttid">termine</special>
Serve a delimitare, senza evidenziare, un termine particolare, espresso in italiano, per il quale si vuole avere un controllo. In generale ciò serve a seguire delle definizioni che non sono comuni ed è bene mantenere coerenti, per non confondere il lettore. Un'altra ragione per questo utilizzo è quello di facilitare la ricerca di tali definizioni nel momento in cui si decidesse di sostituirle con altre. Ciò si rende necessario perché un termine può avere quel certo significato speciale solo in un contesto particolare; pertanto, solo in questi casi va delimitato così.
I termini delimitati in questo modo sono evidenziati nel capitolo 277 con l'aggiunta di un asterisco.
<special special="ttsc">termine</special>
Serve a delimitare, senza evidenziare, un termine particolare, espresso in inglese (o in un'altra lingua straniera), che per qualche ragione non sia traducibile, ma che non sia ancora stato acquisito completamente nella lingua italiana. L'elenco di questi termini si trova nella tabella 277.2 (capitolo 277).
In generale, il contenuto di un file o quanto emesso da un programma attraverso standard output e standard error, viene rappresentato in un elemento per il testo preformattato. Tuttavia, si manifestano dei problemi estetici, dovuti alla suddivisione del testo in pagine e al riconoscimento del contesto.
Per controllare la possibilità o meno di spezzare il testo tra più pagine, si inserisce l'elemento che lo contiene in un listato (l'elemento listing) fisso, che, a seconda di ciò che si preferisce, possa essere spezzato o meno:
<listing pos="fixed" split="0"> ... ... </listing> |
In questo caso, evidentemente, si tratta di un listato che non si può spezzare; la scelta se mantenere unito o consentire la divisione in più pagine dipende naturalmente dalla lunghezza del testo.
In particolare, il listato riferito al contenuto di un file su disco (che può essere anche uno script), viene delimitato con una linea orizzontale, all'inizio e alla fine, anche quando si tratta di una sola riga di testo; mentre quanto emesso attraverso lo standard output o standard error non viene delimitato. Tuttavia, se il comportamento è molto simile a quello di un programma interattivo che usa delle schermate intere, o comunque se il contesto lo suggerisce, si può usare un listato bordato, ma ciò deve avvenire in modo coerente con la sezione in cui è contenuto.
La coerenza in ciò che poi si traduce in forme di enfatizzazione del testo è la cosa più importante da definire e anche la più difficile da mantenere. Tuttavia, ci sono altre considerazioni da fare su elementi che potrebbero sembrare più ovvi.
I titoli della serie tomeheading, h0, h1, h2, h3, h4, slideh1, sheeth1 e faqh2, vanno scritti senza inserire enfatizzazioni di alcun genere. Tuttavia, si possono e si devono inserire gli elementi special. In caso di necessità, si può delimitare qualche termine particolare solo usando le parentesi angolari uncinate standard.
Come si vede, a questa regola fa eccezione faqh3 che invece può contenere le enfatizzazioni comuni di un testo normale.
Le tabelle vanno realizzate nel modo più semplice possibile, cercando di evitare contorsioni, allo scopo di facilitare la lettura anche a un utente che si limiti a scorrere il documento in forma di testo puro e semplice. Solo eccezionalmente è utile la realizzazione di tabelle HTML, racchiuse nell'elemento html, per rappresentare schemi particolari, come nel caso delle schede riepilogative.
Quando una figura può essere realizzata facilmente utilizzando semplicemente caratteri ASCII, conviene evitare la grafica, per consentire la visualizzazione della stessa anche in forma di testo puro. Si ottiene facilmente una figura del genere con l'elemento verbatimpre.
A seconda dei tipi di composizione si possono avere pagine che hanno altezze molto diverse. Quando si realizza una tabella o una figura, occorre verificare che la composizione A4 normale avvenga correttamente; di conseguenza saranno corrette anche le altre forme.
Vengono usate delle sezioni marcate per inserire delle annotazioni da ottenere solo nella stampa di bozze. Queste sezioni marcate fanno riferimento all'entità parametrica ANNOTAZIONI. Di solito si fanno queste annotazioni utilizzando delle note a piè pagina, usando l'elemento blockfootnote, che permette di non intaccare un blocco di testo normale. Si distinguono due tipi di segnalazioni: un'informazione da ricordare e un problema non risolto, da sistemare in un secondo momento. Si osservino i due esempi seguenti:
<![%ANNOTAZIONI;[ <blockfootnote><strong>ATTENZIONE</strong> --- questa notizia proviene da una ricerca fatta... così e così...</blockfootnote> ]]><!--%ANNOTAZIONI;--> |
<![%ANNOTAZIONI;[ <blockfootnote><strong>SISTEMARE</strong> --- manca da analizzare la questione relativa alla...</blockfootnote> ]]><!--%ANNOTAZIONI;--> |
A differenza delle altre sezioni marcate normali, queste vengono incolonnate come i blocchi di testo:
<ul> <li> <p>Bla bla bla bla...</p> <![%ANNOTAZIONI;[ <blockfootnote><strong>SISTEMARE</strong> --- manca da analizzare la questione relativa alla...</blockfootnote> ]]><!--%ANNOTAZIONI;--> <p>Bla bla bla bla...</p> </li> <li> ... </li> </ul> |
daniele @ swlibero.org
1) Le unità di misura del SI, si nominano senza iniziale maiuscola. Tuttavia, il simbolo attribuito all'unità di misura è stato espresso con un'iniziale maiuscola quando questo derivava dal nome di una persona. Per esempio, questo è il caso di Hertz, di Alessandro Volta e di altri.
2) Un elenco più completo di come sono stati scritti i nomi degli applicativi può essere ottenuto dalla sezione 414, che contiene il riepilogo delle licenze.
Dovrebbe essere possibile fare riferimento a questa pagina anche con il nome convenzioni_di_laquo_appunti_di_informatica_libera_raquo.html
[successivo] [precedente] [inizio] [fine] [indice generale] [violazione GPL] [translators] [docinfo] [indice analitico]