forked from w3c/css-validator
-
Notifications
You must be signed in to change notification settings - Fork 0
/
manual.html.it
370 lines (311 loc) · 15.8 KB
/
manual.html.it
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
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="it" lang="it">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<title>Manuale utente per il validatore CSS</title>
<link rev="made" href="mailto:www-validator-css@w3.org" />
<link rev="start" href="./" title="Pagina iniziale" />
<style type="text/css" media="all">
@import "style/base.css";
@import "style/docs.css";
</style>
<meta name="revision"
content="$Id$" />
<!-- SSI Template Version: $Id$ -->
<meta name="translator" content="Roberto Scano - International Webmasters Association / The HTML Writers Guild" />
</head>
<body>
<div id="banner">
<h1 id="title"><a href="http://www.w3.org/"><img alt="W3C" width="110" height="61" id="logo" src="./images/w3c.png" /></a>
<a href="./"><span>Servizio di validazione CSS</span></a></h1>
<p id="tagline">
Check Cascading Style Sheets (CSS) and (X)HTML documents with style sheets
</p>
</div>
<div id="main">
<!-- This DIV encapsulates everything in this page - necessary for the positioning -->
<div class="doc">
<h2>Manuale utente per il validatore CSS</h2>
<h3 id="TableOfContents">Indice dei contenuti</h3>
<div id="toc">
<ul>
<li><a href="#use">Come utilizzare il validatore CSS</a>
<ul>
<li><a href="#url">Validazione tramite URL</a></li>
<li><a href="#fileupload">Validazione tramite trasferimento file</a></li>
<li><a href="#directinput">Validazione tramite immissione diretta</a></li>
<li><a href="#basicvalidation">Cosa fa la validazione base?</a></li>
</ul>
</li>
<li><a href="#advanced">Validazione avanzata</a>
<ul>
<li><a href="#paramwarnings">Parametro: Avvisi</a></li>
<li><a href="#paramprofile">Parametro: Profilo</a></li>
<li><a href="#parammedium">Parametro: Media</a></li>
</ul>
</li>
<li><a href="#expert">Per gli esperti</a>
<ul>
<li><a href="#requestformat">Formato richiesto per la validazione</a></li>
<li><a href="#api">Web Service API per il validatore CSS</a></li>
</ul>
</li>
</ul>
</div>
<p id="skip"></p>
<h3 id="use">Come utilizzare il validatore CSS</h3>
<p>
Il metodo più semplice per verificare un documento è quello di utilizzare l'interfaccia base. In questa pagina troverai tre moduli corrispondenti a tre differenti possibilità:
</p>
<h4 id="url">Validazione tramite URL</h4>
<p>
E' sufficiente digitare l'URL del documento che si desidera verificare. Il documento può essere HTML oppure CSS.
</p>
<img style="display: block; margin-left:auto; margin-right: auto;"
src="./images/uri_basic_it.png" alt="Modulo di validazione tramite URI" />
<h4 id="fileupload">Validazione tramite trasferimento file</h4>
<p>
Questa modalità consente di trasferire e di verificare un documento locale. Seleziona il pulsante "Sfoglia..." e verifica il documento che desideri verificare.
</p>
<img style="display: block; margin-left:auto; margin-right: auto;"
src="./images/file_upload_basic_it.png"
alt="Modulo di Validazione tramite trasferimento file" />
<p>
In questo caso, sono consentiti solamente documenti CSS. Questo significa che non puoi trasferire documenti (X)HTML. Devi inoltre porre attenzione con le regole di @import che possono essere seguite solamente se riferite esplicitamente ad un URL pubblico (pertanto, scordarsi di usare i percorsi relativi per questa modalità di verifica).
</p>
<h4 id="directinput">Validazione tramite immissione diretta</h4>
<p>
Questa modalità è perfetta per verificare porzioni di CSS. Per utilizzarla è sufficiente scrivere il tuo CSS nell'area di immissione testo.
</p>
<img style="display: block; margin-left:auto; margin-right: auto;"
src="./images/direct_input_basic_it.png"
alt="Modulo di Validazione tramite immissione diretta" />
<p>
Anche in questo caso si possono applicare i commenti precedenti. Nota che questa soluzione è molto utile se riscontri dei problemi e necessiti il supporto dalla comunità. E' utile anche per segnalare un problema tecnico, in quanto puoi inviare il collegamento all'URL del risultato della verifica per segnalare un caso di test.
</p>
<h4 id="basicvalidation">Cosa fa la validazione base?</h4>
<p>
Quando si utilizza l'interfaccia base, il validatore effettuerà la verifica di conformità rispetto alla specifica <a href="http://www.w3.org/TR/CSS2.1">CSS 2.1</a>, ossia la raccomandazione attuale per i CSS.<br />
Tale visualizzazione produrrà una pagina XHTML senza nessun avviso (saranno visibili solamente gli errori).<br />
Il tipo di media selezionato è "all", ossia un tipo di media adatto per tutte le periferiche (consulta <a href="http://www.w3.org/TR/CSS2/media.html">
http://www.w3.org/TR/CSS2/media.html</a> per ottenere una descrizione completa sui diversi media).
</p>
<h3 id="advanced">Validazione avanzata</h3>
<p>
Se necessiti una verifica più specifica, puoi utilizzare l'interfaccia avanzata che consente di specificare tre parametri. Di seguito si riporta una breve guida per i tre parametri.
</p>
<h4 id="paramwarnings">Avvisi</h4>
<p>
Questo parametro è utile per attivare la rigorosità del validatore dei CSS. In ogni caso il validatore restituirà due tipi di messaggi: errori ed avvisi. Gli errori vengono segnalati quando il foglio di stile CSS oggetto di verifica non rispetta le specifiche CSS. Gli avvisi sono differenti dagli errori in quanto questi non rientrano in problematiche relative alla violazione della specifica. Il loro compito è di avvisare lo sviluppatore di CSS che alcuni punti potrebbero essere pericolori e potrebbero causare strani effetti in alcuni browser e/o programmi di navigazione.
</p>
<p>
Un avviso tipico riguarda font-family: se non viene fornito un tipo di carattere generico, si otterrà un avviso che suggerirà di aggiungerne uno alla fine della regola, altrimenti il programma di navigazione che non riconosce alcun carattere di quelli elencati utilizzerà il suo carattere predefinito, che potrebbe causare quindi problematiche nella visualizzazione dei contenuti.
</p>
<h4 id="paramprofile">Profilo</h4>
<p>
Il validatore CSS può verificare differenti profili CSS. Un profilo elenca tutte le caratteristiche che ci si aspetta di implementare in un'implementazione in una particolare piattaforma. Questa definizione è tratta dal
<a href="http://www.w3.org/Style/2004/css-charter-long.html#modules-and-profiles0">
sito sui CSS
</a>. La scelta predefinita corrisponde a quella più utilizzata:
<a href="http://www.w3.org/TR/CSS2">CSS 2</a>.
</p>
<h4 id="parammedium">Media</h4>
<p>
Il parametro media è l'equivalente della regola @media rule, applicata a tutto il documento. Troverai maggiori informazioni riguardo i media all'indirizzo
<a href="http://www.w3.org/TR/CSS2/media.html">
http://www.w3.org/TR/CSS2/media.html
</a>.
</p>
<h3 id="expert">Per gli esperti</h3>
<h4 id="requestformat">Formato richiesto per la validazione</h4>
<p>Di seguito è riportata una tabella di parametri che puoi utilizzare quando invii delle richieste al validatore CSS del W3C.</p>
<p>Se desideri utilizzare il server pubblico di validazione del W3C, utilizza i parametri di seguito riportati assieme al seguente indirizzo di base:<br />
<kbd>http://jigsaw.w3.org/css-validator/validator</kbd><br />
(sostituiscilo con l'indirizzo del tuo server se desideri chiamare una versione locale del validatore).</p>
<p><strong>Note</strong>: Se desideri richiamare il validatore in modalità automatizzata per una serie di documenti, ti preghiamo di verificare che il tuo script <code>blocchi</code> l'esecuzione <strong>per almeno 1 secondo</strong> tra le diverse richieste.
Il servizio di validazione CSS è un servizio gratuito, pubblico e per tutti e pertanto il tuo rispetto per gli altri è apprezzato. Grazie.</p>
<table class="refdoc">
<tbody>
<tr>
<th>Parametro</th>
<th>Descrizione</th>
<th>Valore predefinito</th>
</tr>
<tr>
<th>uri</th>
<td>L'indirizzo (<acronym title="Universal Resource Locator" xml:lang="en" lang="en">URL</acronym>) del documento da verificare. Sono consentiti documenti HTML e CSS.</td>
<td>Nessuno, ma questo parametro oppure il parametro <code>text</code> devono essere valorizzati.</td>
</tr>
<tr>
<th>text</th>
<td>Il documento da verificare, sono consentiti solo i CSS.</td>
<td>Nessuno, ma questo parametro oppure il parametro <code>uri</code> devono essere valorizzati.</td>
</tr>
<tr>
<th>usermedium</th>
<td>Il tipo di <a href="http://www.w3.org/TR/CSS2/media.html">media</a> utilizzato per la validazione, ad esempio <code>screen</code>,
<code>print</code>, <code>braille</code>...</td>
<td><code>all</code></td>
</tr>
<tr>
<th>output</th>
<td>Definisce le varie tipologie di visualizzazione del risultato del validatore. I possibili formati sono
<code>text/html</code> e <code>html</code> (documenti XHTML,
Content-Type: text/html),
<code>application/xhtml+xml</code> e <code>xhtml</code> (documenti XHTML, Content-Type: application/xhtml+xml),
<code>application/soap+xml</code> e <code>soap12</code> (documenti SOAP 1.2, Content-Type: application/soap+xml),
<code>text/plain</code> e <code>text</code> (documento di testo, Content-Type: text/plain),
altre tipologie (documento XHTML, Content-Type: text/plain)
</td>
<td>html</td>
</tr>
<tr>
<th>profile</th>
<td>Il profilo CSS utilizzato per la validzione. Può essere
<code>css1</code>, <code>css2</code>, <code>css21</code>,
<code>css3</code>, <code>svg</code>, <code>svgbasic</code>,
<code>svgtiny</code>, <code>mobile</code>, <code>atsc-tv</code>,
<code>tv</code> oppure <code>none</code></td>
<td>La raccomandazione W3C più recente: CSS 2</td>
</tr>
<tr>
<th>lang</th>
<td>La lingua utilizzata per la risposta, attualmente <code>en</code>,
<code>fr</code>, <code>it</code>, <code>ko</code>, <code>ja</code>, <code>es</code>,
<code>zh-cn</code>, <code>nl</code>, <code>de</code>.</td>
<td>Inglese (<code>en</code>).</td>
</tr>
<tr>
<th>warning</th>
<td>Il livello di avvisi, <code>no</code> per nessun avviso, <code>0</code>
per pochi avvisi, <code>1</code> oppure <code>2</code> per più avvisi.
</td>
<td>2</td>
</tr>
</tbody>
</table>
<h4 id="api">Web Service API per il validatore CSS: documentazione per l'interfacciamento alla validazione tramite SOAP 1.2</h4>
<p>
Per maggiori informazioni tecniche, in particolare riguardo la visualizzazione dati tramite SOAP 1.2 e tutte le possibili modalità di richiamo alle funzionalità del validatore, consultare le <a href="./api.html">Web Service API per il validatore CSS</a>.
</p>
</div>
</div>
<!-- End of "main" DIV. -->
<ul class="navbar" id="menu">
<li><strong><a href="./" title="Pagina iniziale del servizio di validazione CSS del W3C">Pagina iniziale</a></strong> <span class="hideme">|</span></li>
<li><a href="about.html" title="Informazioni sul servizio">Informazioni</a> <span class="hideme">|</span></li>
<li><a href="documentation.html" title="Documentazione per il servizio di validazione CSS del W3C">Documentazione</a> <span class="hideme">|</span></li>
<li><a href="DOWNLOAD.html" title="Scarica il Validatore CSS" xml:lang="en" lang="en">Download</a> <span class="hideme">|</span></li>
<li><a href="Email.html" title="Come fornire commenti al servizio">Commenti</a> <span class="hideme">|</span></li>
<li><a href="thanks.html" title="Crediti e ringraziamenti">Riconoscimenti</a><span class="hideme">|</span></li>
</ul>
<div id="footer">
<p id="activity_logos">
<a href="http://www.w3.org/QA/" title="Attività di garanzia di qualità del W3C, che ti fornisce strumenti di qualità gratuiti per il Web e molto altro"><img src="http://www.w3.org/QA/2002/12/qa-small.png" alt="QA" /></a><a href="http://www.w3.org/Style/CSS/learning" title="Maggiori informazioni sui fogli di stile a cascata"><img src="images/woolly-icon" alt="CSS" /></a>
</p>
<ul id="lang_choice">
<li><a href="manual.html.bg"
lang="bg"
xml:lang="bg"
hreflang="bg"
rel="alternate">Български</a></li>
<li><a href="manual.html.de"
lang="de"
xml:lang="de"
hreflang="de"
rel="alternate">Deutsch</a>
</li>
<li><a href="manual.html.en"
lang="en"
xml:lang="en"
hreflang="en"
rel="alternate">English</a>
</li>
<li><a href="manual.html.es"
lang="es"
xml:lang="es"
hreflang="es"
rel="alternate">Español</a>
</li>
<li><a href="manual.html.fr"
lang="fr"
xml:lang="fr"
hreflang="fr"
rel="alternate">Français</a>
</li>
<li><a href="manual.html.ko"
lang="ko"
xml:lang="ko"
hreflang="ko"
rel="alternate">한국어</a>
</li>
<li><a href="manual.html.it"
lang="it"
xml:lang="it"
hreflang="it"
rel="alternate">Italiano</a>
</li>
<li><a href="manual.html.nl"
lang="nl"
xml:lang="nl"
hreflang="nl"
rel="alternate">Nederlands</a>
</li>
<li><a href="manual.html.ja"
lang="ja"
xml:lang="ja"
hreflang="ja"
rel="alternate">日本語</a>
</li>
<li><a href="manual.html.pl-PL"
lang="pl-PL"
xml:lang="pl-PL"
hreflang="pl-PL"
rel="alternate">Polski</a>
</li>
<li><a href="manual.html.pt-BR"
lang="pt-BR"
xml:lang="pt-BR"
hreflang="pt-BR"
rel="alternate">Português</a>
</li>
<li><a href="manual.html.ru"
lang="ru"
xml:lang="ru"
hreflang="ru"
rel="alternate">Русский</a>
</li>
<li><a href="manual.html.sv"
lang="sv"
xml:lang="sv"
hreflang="sv"
rel="alternate">Svenska</a>
</li>
<li><a href="manual.html.zh-cn"
lang="zh-cn"
xml:lang="zh-cn"
hreflang="zh-cn"
rel="alternate">简体中文</a>
</li>
</ul>
<p id="support_logo">
<a href="http://www.w3.org/QA/Tools/Donate">
<img src="http://www.w3.org/QA/Tools/I_heart_validator" alt="I heart Validator logo" title=" Validators Donation Program" />
</a>
</p>
<p class="copyright">
<a rel="Copyright" href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a> © 1994-2009
<a href="http://www.w3.org/"><acronym title="World Wide Web Consortium">W3C</acronym></a>®
(<a href="http://www.csail.mit.edu/"><acronym title="Massachusetts Institute of Technology">MIT</acronym></a>,
<a href="http://www.ercim.eu/"><acronym title="European Research Consortium for Informatics and Mathematics">ERCIM</acronym></a>,
<a href="http://www.keio.ac.jp/">Keio</a>),
Tutti i diritti riservati.
Si applicano le regole del W3C riguardanti la <a href="http://www.w3.org/Consortium/Legal/ipr-notice#Legal_Disclaimer">responsabilità</a>,
<a href="http://www.w3.org/Consortium/Legal/ipr-notice#W3C_Trademarks">marchi depositati</a>,
<a rel="Copyright" href="http://www.w3.org/Consortium/Legal/copyright-documents">l'utilizzo dei documenti</a>
e le <a rel="Copyright" href="http://www.w3.org/Consortium/Legal/copyright-software">licenze software</a>. L'interazione con i contenuti di questi siti è in accordo con le nostre definizioni di <a href="http://www.w3.org/Consortium/Legal/privacy-statement#Public">pubblico</a> e <a href="http://www.w3.org/Consortium/Legal/privacy-statement#Members">privato</a> per quanto riguarda la riservatezza delle informazioni.
</p>
</div>
</body>
</html>