1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
|
#use wml::debian::template title="Uso delle Pagine Web HTML Debian" BARETITLE=true
#use wml::debian::common_tags
#use wml::debian::acronyms
#use wml::debian::toc
#use wml::debian::translation-check translation="648de6ad5bea60540e41a5733da0b761a34c7927" maintainer="Francesca Ciceri"
# Collaboratively translated during an online sprint, thanks to all
# contributors!
<p>
Questa pagina è ancora una bozza.
</p>
<toc-display/>
<toc-add-entry name="preface">Prefazione</toc-add-entry>
<p>Questa pagina è stata creata per aiutare autori e traduttori a comporre
pagine con i corretti tag. Contiene suggerimenti circa l'uso dei tag e su
come creare nuove pagine e renderle più facili da tradurre.</p>
<toc-add-entry name="general">Alcuni suggerimenti generali</toc-add-entry>
<p>Ecco un elenco di consigli generali per nuove pagine o traduzioni</p>
<dl>
<dt>non utilizzare righe lunghe</dt>
<dd>
I file wml e altri file dovrebbero essere costituiti da righe che entrano
in una normale finestra di terminale, in modo tale da essere più facilmente
modificabili in vi nonché più semplici da cercare e da tradurre. Questo è un
aspetto importante anche perché è più
difficile risolvere conflitti in righe lunghe.
</dd>
<dt>mantenere i tag in linee separate, ove possibile</dt>
<dd>
La maggior parte dei tag HTML può essere tenuta in righe separate. Tra questi, ad esempio,
vi sono: <div>, <p>, <table>, <ul>. Per rendere il lavoro più facile
ai traduttori si possono mantenere questi tag in righe a parte. Altrimenti alcuni tag potrebbero
essere fortuitamente cancellati dai traduttori e non ripristinati dopo la traduzione.
</dd>
<dt>non usare spazi o interruzioni di riga nei tag inline</dt>
<dd>Alcuni tag producono uno spazio, se sono tenuti in linee separate. Uno di questi
è il tag <q> per piccole citazioni o virgolette. Vanno quindi mantenuti in una sola riga,
insieme al relativo contenuto. Altrimenti risulterebbe uno spazio tra il contenuto e il tag,
nella pagina HTML che verrà creata. Il testo racchiuso tra questi tag può contenere
spazi e interruzioni di riga senza problemi.
</dd>
</dl>
<toc-add-entry name="abbreviations">Abbreviazioni ed acronimi</toc-add-entry>
<p>
Per le abbreviazioni e gli acronimi si deve utilizzare il tag HTML <acronym>.
Ci sono due motivi per cui l'uso del tag <abbr> non è raccomandabile:
innanzitutto, non tutti i browser supportano questo tag e inoltre vi sono differenti
definizioni, non uguali tra loro, riguardo cosa sia un acronimo e cosa sia un'abbreviazione.
</p>
<p>
Per aggiungere un acronimo alla pagina si usa la seguente sintassi:
<code><acronym lang="language code" title="Definizione completa
dell'acronimo">ACRONIMO</acronym></code>. Il titolo contiene il testo
dell'acronimo scritto per esteso. Se l'acronimo è formato dalle iniziali di alcune parole,
queste lettere devono essere in maiuscolo nel titolo. L'attributo lang è necessario solo
se l'acronimo o l'abbreviazione è in una lingua straniera.
</p>
<p>
Esiste un insieme di acronimi di uso comune già inclusi nei template wml.
Per usarli nella propria pagina, si deve aggiungere una riga <code>acronyms</code>
nel file wml. Per esempio il tag wml per DD è <acronym_DD />.
</p>
<toc-add-entry name="citations">Citazioni</toc-add-entry>
<p>
Esistono regole molto variegate per definire cosa sia una citazione nelle diverse lingue.
Se la citazione è breve si deve utilizzare i tag <q>. La resa visiva del contenuto
è gestita dal linguaggio CSS. I tag <q> non devono presentare spazi o interruzioni
di linea tra i tag di apertura e chiusura ed il contenuto.
</p>
<p>
Per citazioni più lunghe va utilizzato il tag <blockquote>. <blockquote>
racchiude uno o più paragrafi di testo, che sono segnalati con <p>. Si prega
di non utilizzare i tag <blockquote> per centrare qualsiasi blocco di testo che non
sia una citazione. I blocchi di citazione sono esclusivamente riservati per le citazioni
ed in futuro saranno resi visivamente tramite codice CSS specifico per linguaggio.
</p>
<p>
Esiste, nel codice HTML, anche un tag <cite>. Il tag <cite> non è usato per citare il testo
stesso ma per riferire la fonte della citazione. Può essere il nome della persona da cui
proviene la citazione ed è aggiunto come attributo a <blockquote> come URL.
</p>
<toc-add-entry name="code">Nomi dei programmi e codice</toc-add-entry>
<p>
Per i nomi dei programmi e il codice sorgente c'è un tag chiamato <code>. I
browser normalmente sanno come mostrare codice e nomi dei programmi, ma la
visualizzazione può anche essere cambiata dal CSS. Non è una buona idea usare
<tt> al suo posto perché non rivela nulla a proposito del contenuto.
</p>
<toc-add-entry name="samp">Esempi di output</toc-add-entry>
<p>
Per i messaggi del computer sullo schermo esiste un tag speciale detto
<samp>. Se si deve inserire un blocco di messaggi più largo, si
dovrebbe controllare nel file CSS se è stata creata una classe speciale per definirlo.
</p>
<toc-add-entry name="kbd">Input da tastiera</toc-add-entry>
<p>Se ci sono casi in cui l'utente deve inserire qualcosa da tastiera, vengono usati i tag
<kbd> per l'input. Fare anche riferimento al capitolo <a href="#var">variabili</a> per
sapere che tag applicare all'input variabile.
</p>
<toc-add-entry name="var">Variabili</toc-add-entry>
<p>
A volte è necessario enfatizzare un input variabile come ad esempio un indirizzo IP
speciale o il nome utente usato in una riga di comando. Per questi input variabili è usato il tag <var>.
</p>
<toc-add-entry name="pre">Contenuti preformattati</toc-add-entry>
<p>
Il tag <pre> è utilizzato esclusivamente per il testo preformattato. Lunghezza di riga,
spazi e altre cose saranno preservate. Ovviamente questo tag non può contenere la
maggior parte degli altri tag HTML.
</p>
<toc-add-entry name="img">Immagini</toc-add-entry>
<p>
Se ci sono immagini all'interno della pagina, non c'è bisogno di aggiungere l'attributo
border=0. Se possibile, però, dovrebbero essere aggiunti la dimensione dell'immagine e
l'attributo <code>alt</code>. La dimensione, se non presente, viene aggiunta da wml ma
questo comporta un incremento del tempo di compilazione. L'attributo <code>alt</code>
dovrebbe contenere qualcosa che dica a chi naviga con lynx o alle persone non vedenti
a cosa si riferisce l'immagine.
</p>
# <toc-add-entry name=""></toc-add-entry>
|
