aboutsummaryrefslogtreecommitdiff
path: root/documentation/content/it/books/handbook/l10n/_index.adoc
blob: 4b8d633ac1393611c5aa89fdf16c015dd6ba5282 (plain) (blame)
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
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
---
title: Capitolo 22. Localizzazione - Uso e Impostazione dell'I18N/L10N
part: Parte II. Compiti Ordinari
prev: books/handbook/virtualization
next: books/handbook/cutting-edge
showBookMenu: true
weight: 26
path: "/books/handbook/l10n/"
---

[[l10n]]
= Localizzazione - Uso e Impostazione dell'I18N/L10N
:doctype: book
:toc: macro
:toclevels: 1
:icons: font
:sectnums:
:sectnumlevels: 6
:sectnumoffset: 22
:partnums:
:source-highlighter: rouge
:experimental:
:images-path: books/handbook/l10n/

ifdef::env-beastie[]
ifdef::backend-html5[]
:imagesdir: ../../../../images/{images-path}
endif::[]
ifndef::book[]
include::shared/authors.adoc[]
include::shared/mirrors.adoc[]
include::shared/releases.adoc[]
include::shared/attributes/attributes-{{% lang %}}.adoc[]
include::shared/{{% lang %}}/teams.adoc[]
include::shared/{{% lang %}}/mailing-lists.adoc[]
include::shared/{{% lang %}}/urls.adoc[]
toc::[]
endif::[]
ifdef::backend-pdf,backend-epub3[]
include::../../../../../shared/asciidoctor.adoc[]
endif::[]
endif::[]

ifndef::env-beastie[]
toc::[]
include::../../../../../shared/asciidoctor.adoc[]
endif::[]

[[l10n-synopsys]]
== Sinossi

FreeBSD è un progetto di larga diffusione con utenti e collaboratori in ogni parte del mondo. Questo capitolo affronta quegli aspetti tipici di FreeBSD relativi all'internazionalizzazione e localizzazione del sistema che permettono agli utenti non di lingua inglese di operare in maniera più confortevole. Ci sono molti aspetti da considerare dell'implementazione I18N sia a livello utente che di sistema, perciò, ove necessario, si rinvierà il lettore a fonti di informazione più specifiche.

Dopo aver letto questo capitolo, saprai:

* Come i vari linguaggi e nazioni sono codificati nei moderni sistemi operativi.
* Come impostare la localizzazione per la tua shell di login.
* Come configurare la tua console per una lingua che non sia l'inglese.
* Come usare concretamente X Window System con differenti lingue.
* Dove reperire ulteriori informazioni su come scrivere applicazioni I18N compatibili.

Prima di leggere questo capitolo, dovresti:

* Sapere come installare applicazioni aggiuntive di terze parti (crossref:ports[ports,Installazione delle Applicazioni. Port e Package]).

[[l10n-basics]]
== Principi di Base

=== Cosa significano le sigle I18N/L10N?

Gli sviluppatori hanno abbreviato la parola "internationalization" in I18N, contando il numero di lettere che costituiscono la parola "internationalization", escludendo la prima e l'ultima. Lo stesso è stato fatto per l'acronimo L10N, che deriva appunto da "localization". Combinando insieme i metodi, i protocolli e le applicazioni che rispettano gli standard I18N/L10N si permette agli utenti di utilizzare una qualsiasi lingua di propria scelta.

Le applicazioni I18N sono realizzate mediante appositi kit, disponibili tramite specifiche librerie. Questo permette agli sviluppatori di scrivere in un normale file di testo i menù e i messaggi da visualizzare nel programma e di tradurlo poi nelle varie lingue. Si raccomandano vivamente i programmatori di seguire questa convenzione.

=== Perché Dovrei Usare I18N/L10N?

I18N/L10N è usato ogni qualvolta desideri visualizzare, immettere o processare dati in lingue diverse da quella inglese.

=== Quali Lingue sono Disponibili nel Lavoro I18N?

I18N e L10N non sono caratteristiche specifiche di FreeBSD. Al momento, è possibile scegliere fra la maggior parte delle lingue più diffuse nel mondo, tra le quali: cinese, tedesco, giapponese, francese, russo, italiano e altre ancora.

[[using-localization]]
== Come Utilizzare la Localizzazione

Vista la sua importanza, I18N non è specifico del sistema FreeBSD ed è una convenzione. Siete invitati ad aiutare il progetto FreeBSD per sostenere questa convenzione.

Le impostazioni per la localizzazione o nazionalizzazione sono basate su tre termini principali: Codice Lingua, Codice Nazione e Codifica. I nomi che contraddistinguono una localizzazione sono formati utilizzando questi termini nel modo seguente:

[.programlisting]
....
CodiceLingua_CodiceNazione.Codifica
....

=== I Codici per la Lingua e la Nazione

Al fine di localizzare un sistema FreeBSD (o qualsiasi altro sistema UNIX(R) che gestisca I18N) in una specifica lingua, l'utente deve innanzitutto conoscere i codici della nazione e della lingua desiderati (i codici delle nazioni segnalano alle applicazioni quali convenzioni adottare all'interno di un dato linguaggio). Inoltre, i browser web, i server SMTP/POP, i server web, ecc. possono operare in base ad essi. I seguenti sono esempi di codici lingua/nazione:

[.informaltable]
[cols="1,1", frame="none", options="header"]
|===
| Codice Lingua/Nazione
| Descrizione

|en_US
|inglese - Stati Uniti d'America

|ru_RU
|russo - Russia

|zh_TW
|cinese tradizionale - Taiwan
|===

=== Codifiche

Alcune lingue utilizzano codifiche non ASCII, cioè caratteri a 8 bit, estesi o multibyte, vedere man:multibyte[3] per maggiori dettagli. Le applicazioni più vecchie, non riconoscendoli, li interpretano come caratteri di controllo. Quelle più recenti invece riconoscono di solito i caratteri a 8 bit. A seconda dell'implementazione, è possibile che gli utenti debbano ricompilare un'applicazione con il supporto ai caratteri estesi o multibyte, o debbano configurare l'applicazione in modo corretto. Per essere in grado di immettere e di elaborare caratteri estesi o multibyte, la link:https://www.FreeBSD.org/ports/[FreeBSD Ports Collection] fornisce vari programmi in differenti linguaggi. Si faccia riferimento alla relativa documentazione I18N del port di FreeBSD.

Precisamente, l'utente deve consultare la documentazione propria dell'applicazione per conoscere come configurarla correttamente o come passare i giusti valori al configuratore/Makefile/compilatore.

Alcune cose da tener presente sono:

* Gli insiemi di caratteri rappresentabili dal tipo char del linguaggio C, specifici della lingua (vedere man:multibyte[3]), cioè ISO8859-1, ISO8859-15, KOI8-R, CP437.
* Codifiche estese o multibyte, cioè EUC, Big5.

Puoi consultare l'elenco corrente degli insiemi di caratteri nel link:ftp://ftp.isi.edu/in-notes/iana/assignments/character-sets[Registro IANA].

[NOTE]
====
FreeBSD usa le codifiche per la localizzazione compatibili con X11.
====

=== Applicazioni I18N

Nel sistema dei port e dei pacchetti precompilati di FreeBSD, le applicazioni I18N sono facilmente riconoscibili, perché il loro nome include la sigla `I18N`. Tuttavia, non sempre queste potrebbero supportare la lingua desiderata.

[[setting-locale]]
=== Impostazione del Locale

Di solito è sufficiente esportare il valore del nome del locale posto nella variabile `LANG` all'interno della shell di login. Questo può essere fatto utilizzando il file dell'utente [.filename]#~/.login_conf# oppure il file di configurazione della shell di login dell'utente ([.filename]#~/.profile#, [.filename]#~/.bashrc#, [.filename]#~/.cshrc#). Non c'è bisogno di impostare le altre variabili del locale, come `LC_CTYPE`, `LC_CTIME`. Per maggiori informazioni si faccia riferimento alla documentazione di FreeBSD specifica per la data lingua.

Puoi settare le due variabili d'ambiente seguenti nei tuoi file di configurazione:

* `LANG` per le funzioni appartenenti alla famiglia POSIX(R), man:setlocale[3]
* `MM_CHARSET` per l'insieme dei caratteri che dovranno usare le applicazioni che supportano lo standard MIME

Ciò va fatto per la configurazione della shell dell'utente, di un'applicazione specifica e per quella di X11.

==== Metodi di Localizzazione

Ci sono due metodi per impostare il locale, entrambi descritti qui di seguito. Il primo (raccomandato) consiste nell'impostare le variabili d'ambiente in una <<login-class,classe di login>>, mentre il secondo consiste nell'aggiungere i valori delle variabili d'ambiente al <<startup-file,file d'avvio>> della shell di sistema.

[[login-class]]
===== Metodo delle Classi di Login

Questo metodo fa sì che le variabili d'ambiente necessarie per il nome del locale e per gli insiemi dei caratteri MIME vengano inizializzate una volta sola per ogni possibile shell di sistema invece di aggiungere specifici assegnamenti per ogni file d'avvio di shell. Il <<usr-setup,Setup a Livello Utente>> può essere fatto dall'utente stesso e il <<adm-setup,Setup a Livello Amministratore>> richiede i privilegi del superuser.

[[usr-setup]]
====== Setup a Livello Utente

Ecco un breve esempio di un file [.filename]#.login_conf# posto nella directory home di un utente che ha entrambe le variabili impostate alla codifica Latin-1:

[.programlisting]
....
me:\
:charset=ISO-8859-1:\
:lang=de_DE.ISO8859-1:
....

Ecco invece un esempio di un file [.filename]#.login_conf# che imposta le variabili per il cinese tradizionale con codifica BIG-5. Si noti che sono state impostate molte variabili perchè alcuni programmi non rispettano come dovrebbero le variabili di localizzazione per il cinese, giapponese e il coreano.

[.programlisting]
....
#Gli utenti che non vogliono usare l'unità monetaria o i formati temporali
#di Taiwan possono modificare manualmente ogni variabile
me:\
        :lang=zh_TW.Big5:\
        :setenv=LC_ALL=zh_TW.Big:\
        :setenv=LC_COLLATE=zh_TW.Big5:\
        :setenv=LC_CTYPE=zh_TW.Big5:\
        :setenv=LC_MESSAGES=zh_TW.Big5:\
        :setenv=LC_MONETARY=zh_TW.Big5:\
        :setenv=LC_NUMERIC=zh_TW.Big5:\
        :setenv=LC_TIME=zh_TW.Big5:\
        :charset=big5:\
        :xmodifiers="@im=gcin": #Set gcin as the XIM Input Server
....

Vedere il paragrafo <<adm-setup,Setup a Livello Amministratore>> e man:login.conf[5] per maggiori dettagli.

[[adm-setup]]
===== Setup a Livello Amministratore

Controlla che la classe di login dell'utente in [.filename]#/etc/login.conf# selezioni la lingua corretta. Assicurati che queste impostazioni appaiano in [.filename]#/etc/login.conf#:

[.programlisting]
....
nome_lingua:titolo_account:\
:charset=MIME_charset:\
:lang=nome_locale:\
:tc=default:
....

Ritornando quindi all'esempio di prima che utilizzava Latin-1, si dovrebbe avere una cosa simile a questa:

[.programlisting]
....
tedesco:Account Utenti Tedeschi:\
:charset=ISO-8859-1:\
:lang=de_DE.ISO8859-1:\
:tc=default:
....

Dopo aver modificato le Classi di Login degli utenti esegui il comando seguente:

[source,shell]
....
# cap_mkdb /etc/login.conf
....

per creare una nuova configurazione in [.filename]#/etc/login.conf# visibile al sistema.

===== Modifica delle Classi di Login con man:vipw[8]

Usa `vipw` per aggiungere nuovi utenti, e crea qualcosa di simile a quanto segue:

[.programlisting]
....
utente:password:1111:11:lingua:0:0:Nome Utente:/home/user:/bin/sh
....

===== Modifica delle Classi di Login con man:adduser[8]

Usa `adduser` per aggiungere nuovi utenti, in questo modo:

* Imposta `defaultclass = lingua` in [.filename]#/etc/adduser.conf#. Tieni presente che in questo modo dovrai inserire una classe `default` per tutti gli utenti di altre lingue.
* In alternativa si può specificare la lingua desiderata ogni volta che appare il prompt 
+
[source,shell]
....
Enter login class: default []: 
....

durante l'esecuzione di man:adduser[8]

* Un'altra alternativa è utilizzare il comando nel modo seguente per ogni utente di una diversa lingua che si desidera aggiungere:
+
[source,shell]
....
# adduser -class lingua
....

===== Cambiare le Classi di Login con man:pw[8]

Se utilizzi il comando man:pw[8] per aggiungere nuovi utenti, invocalo in questo modo:

[source,shell]
....
# pw useradd nome_utente -L  lingua
....

[[startup-file]]
===== Metodo del File di Avvio della Shell

[NOTE]
====
Questo metodo è sconsigliato perché richiede una inizializzazione diversa per ogni possibile shell. Usa invece il <<login-class,Metodo delle Classi di Login>>.
====

Per aggiungere il nome del locale e l'insieme dei caratteri per lo standard MIME, bisogna semplicemente settare le due variabili d'ambiente mostrate di seguito nei file d'avvio della shell [.filename]#/etc/profile# e/o [.filename]#/etc/csh.login#. Nell'esempio che segue viene utilizzata la lingua tedesca:

In [.filename]#/etc/profile#:

[.programlisting]
....
LANG=de_DE.ISO8859-1; export LANG
MM_CHARSET=ISO8859-1; export MM_CHARSET
....

Oppure in [.filename]#/etc/csh.login#:

[.programlisting]
....
setenv LANG de_DE.ISO8859-1
setenv MM_CHARSET ISO8859-1
....

Lo stesso risultato si ottiene aggiungendo i precedenti comandi al file [.filename]#/usr/shared/skel/dot.profile# (per i comandi usati in [.filename]#/etc/profile#), oppure al file [.filename]#/usr/shared/skel/dot.login# (per quelli in [.filename]#/etc/csh.login#).

Per l'ambiente X11:

Nel file [.filename]#$HOME/.xinitrc#:

[.programlisting]
....
LANG=de_DE.ISO8859-1; export LANG
....

Oppure:

[.programlisting]
....
setenv LANG de_DE.ISO8859-1
....

a seconda della shell utilizzata (vedi sopra).

[[setting-console]]
=== Settaggio della Console

Per tutti gli insiemi di caratteri che sono rappresentabili con il tipo char in C, imposta i font della console adatti alla lingua prescelta in [.filename]#/etc/rc.conf#:

[.programlisting]
....
font8x16=nome_font
font8x14=nome_font
font8x8=nome_font
....

_nome_font_ è il nome di uno dei file di font presenti nella directory [.filename]#/usr/shared/syscons/fonts#, privato del suffisso [.filename]#.fnt#.

Assicurati anche di impostare la giusta mappatura della tastiera e del video per il proprio set di caratteri usando `sysinstall` (`/stand/sysinstall` nelle versioni di FreeBSD precedenti alla 5.2). Una volta all'interno di sysinstall, seleziona [.guimenuitem]#Configure#, quindi [.guimenuitem]#Console#. In alternativa, aggiungi le seguenti righe in [.filename]#/etc/rc.conf#:

[.programlisting]
....
scrnmap=nome_screenmap
keymap=nome_keymap
keychange="numero_tasto_funzione sequenza"
....

_nome_screenmap_ viene preso dalla directory [.filename]#/usr/shared/syscons/scrnmaps#, privato del suffisso [.filename]#.scm#. Una _screenmap_ assieme ad una corrispondente mappa dei font è solitamente necessaria nel caso la scheda grafica non gestisca i font via software, ma li abbia codificati internamente; la screenmap serve appunto a rimappare tali font interni nel font prescelto.

Se hai abilitato il demone moused inserendo la seguente riga in [.filename]#/etc/rc.conf#:

[.programlisting]
....
moused_enable="YES"
....

allora leggi quanto riportato nel prossimo paragrafo sul cursore del mouse.

Di default il cursore del mouse del driver man:syscons[4] occupa l'intervallo da 0xd0 a 0xd3 nel set di caratteri in uso. Se la tua lingua utilizza tali caratteri, devi spostare l'intervallo occupato dal cursore. Per far questo con FreeBSD, inserisci la seguente riga in [.filename]#/etc/rc.conf#:

[.programlisting]
....
mousechar_start=3
....

_nome_keymap_ deve invece corrispondere a uno dei file presenti nella directory [.filename]#/usr/shared/syscons/keymaps#, privato del suffisso [.filename]#.kbd#. Se sei indeciso su quale _keymap_ scegliere, puoi usare il comando man:kbdmap[1] per testare le varie mappature senza dover riavviare il sistema.

La variabile `keychange` è di solito richiesta per programmare i tasti funzione in relazione al tipo di terminale in uso, poiché le sequenze generate da un tasto funzione non possono essere definite in una mappa di tasti.

Assicurati inoltre di impostare il corretto tipo di terminale in [.filename]#/etc/ttys# per tutte le voci del tipo `ttyv*`. Attualmente, le corrispondenze predefinite sono:

[.informaltable]
[cols="1,1", frame="none", options="header"]
|===
| Insieme di Caratteri
| Tipo di Terminale

|ISO8859-1 o ISO8859-15
|`cons25l1`

|ISO8859-2
|`cons25l2`

|ISO8859-7
|`cons25l7`

|KOI8-R
|`cons25r`

|KOI8-U
|`cons25u`

|CP437 (di default per VGA)
|`cons25`

|US-ASCII
|`cons25w`
|===

Per i linguaggi che usano caratteri estesi o multibyte, è bene servirsi del corretto port di FreeBSD nella directory [.filename]#/usr/ports/linguaggio#. Poichè alcuni port che si presentano come console sono riconosciuti dal sistema come terminali seriali virtuali (vtty), devi riservare abbastanza vtty sia per X11 che per la console pseudo-seriale. Ecco una lista parziale di applicazioni con cui si possono utilizzare altri linguaggi in console:

[.informaltable]
[cols="1,1", frame="none", options="header"]
|===
| Linguaggio
| Ubicazione

|cinese tradizionale (BIG-5)
|package:/usr/ports/chinese/big5con[]

|giapponese
|package:japanese/kon2-16dot[] oppure package:japanese/mule-freewnn[]

|coreano
|package:korean/han[]
|===

=== Impostazione di X11

Sebbene X11 non faccia parte del progetto FreeBSD, vengono qui fornite alcune informazioni per gli utenti di FreeBSD. Per maggiori dettagli, si faccia riferimento al sito web http://www.x.org/[Xorg] o a quello del Server X11 utilizzato.

Nel file [.filename]#~/.Xresources#, puoi mettere a punto le impostazioni per I18N specifiche di un'applicazione (ad esempio, i font, i menu, ecc.).

==== Visualizzazione dei Font

Installa il server Xorg (package:x11-servers/xorg-server[]) o XFree86(TM) (package:x11-servers/XFree86-4-Server[]), quindi installa i font TrueType(R) propri della lingua prescelta. L'impostazione del corretto locale dovrebbe permetterti di visualizzare tale lingua nei vari menu, ecc.

==== Immissione di Caratteri Non Inglesi

Il protocollo X11 Input Method (XIM) è un nuovo standard per tutti i client X11. Tutte le applicazioni X11 dovrebbero essere scritte come client XIM che ricevono l'input dai server XIM. Vi sono parecchi server XIM disponibili per le differenti lingue.

=== Configurazione della Stampante

Alcuni set di caratteri del tipo char del C sono solitamente codificati a livello hardware all'interno delle stampanti stesse. Gli insiemi di caratteri estesi o multibyte richiedono invece una speciale configurazione e si raccomanda l'utilizzo di apsfilter. Puoi anche convertire documenti nei formati PostScript(R) o PDF utilizzando convertitori specifici per una data lingua.

=== Il Kernel e i File System

Il file system di FreeBSD FFS (Fast File System) è completamente a 8-bit, perciò può essere utilizzato con qualsiasi insieme di caratteri del tipo char del C (vedere man:multibyte[3]), ma non vi è un nome particolare di un insieme di caratteri memorizzato nel file system; cioè, il file system è a 8 bit senza alcuna codifica interna e ignora un'eventuale codifica. Ufficialmente, FFS non supporta ancora alcuna forma degli insiemi di caratteri estesi o multibyte. Tuttavia, esistono per alcuni di questi delle patch indipendenti per il FFS che abilitano tale supporto. Sono solo soluzioni temporanee, non portabili ed si è deciso di non includerle nell'albero dei sorgenti. Si faccia riferimento ai rispettivi siti web della lingua desiderata per ulteriori informazioni e per i file di patch.

Il supporto per il file system di MS-DOS(R) in FreeBSD offre la possibilità di configurare la modalità di conversione tra gli insiemi di caratteri MS-DOS(R), Unicode e quelli scelti per il file system di FreeBSD. Consultare man:mount_msdosfs[8] per i dettagli.

[[l10n-compiling]]
== Compilazione dei Programmi con Supporto I18N

Molti dei port di FreeBSD includono il supporto I18N. Alcuni di essi sono contrassegnati dal suffisso -I18N nel loro nome. Questi e molti altri programmi hanno il supporto per I18N già incluso e non necessitano perciò di speciali considerazioni.

Tuttavia, alcune applicazioni come ad esempio MySQL richiedono che venga specificato nel [.filename]#Makefile# l'insieme dei caratteri che si utilizzeranno. Questa operazione viene fatta o modificando direttamente il suddetto file oppure passando un opportuno valore al programma `configure` nella directory dei sorgenti.

[[lang-setup]]
== Localizzazione di FreeBSD con Lingue Particolari

[[ru-localize]]
=== Lingua Russa (Codifica KOI8-R)

Per maggiori informazioni sulla codifica KOI8-R, si veda la http://koi.pp.ru/[fonte di riferimento per il KOI8-R (Russian Net Character Set)].

==== Impostazione del Locale

Metti le seguenti righe nel tuo file [.filename]#~/.login_conf#:

[.programlisting]
....
me:My Account:\
:charset=KOI8-R:\
:lang=ru_RU.KOI8-R:
....

Si veda quanto esposto precedentemente in questo capitolo per degli esempi di impostazione del <<setting-locale,locale>>.

==== Configurazione della Console

* Aggiungi la riga seguente al tuo file [.filename]#/etc/rc.conf#:
+
[.programlisting]
....
mousechar_start=3
....

* Utilizza inoltre le seguenti impostazioni nel file [.filename]#/etc/rc.conf#:
+
[.programlisting]
....
keymap="ru.utf-8"
scrnmap="utf-82cp866"
font8x16="cp866b-8x16"
font8x14="cp866-8x14"
font8x8="cp866-8x8"
....

* Per ogni voce `ttyv*` nel file [.filename]#/etc/ttys#, usa `cons25r` come tipo di terminale.

Si veda quanto esposto in precedenza in questo capitolo per degli esempi su come impostare la <<setting-console,console>>.

==== Configurazione della Stampante

Dal momento che la maggior parte delle stampanti con caratteri russi hanno a livello hardware la codifica codepage CP866, è necessario utilizzare uno speciale filtro di conversione da KOI8-R a CP866. Tale filtro viene installato di default come [.filename]#/usr/libexec/lpr/ru/koi2alt#. La voce per una stampante russa dovrebbe apparire perciò così in [.filename]#/etc/printcap#:

[.programlisting]
....
lp|Russian local line printer:\
:sh:of=/usr/libexec/lpr/ru/koi2alt:\
:lp=/dev/lpt0:sd=/var/spool/output/lpd:lf=/var/log/lpd-errs:
....

Si veda man:printcap[5] per una spiegazione dettagliata del significato dei vari campi.

==== Nomi di File Russo e File System MS-DOS(R)

La seguente voce d'esempio di man:fstab[5] abilita il supporto per i nomi di file in russo su file system MS-DOS(R):

[.programlisting]
....
/dev/ad0s2      /dos/c  msdos   rw,-W=koi2dos,-L=ru_RU.KOI8-R 0 0
....

L'opzione `-L` seleziona il nome locale usato, e `-W` imposta la tabella di conversione dei caratteri. Per usare l'opzione `-W`, assicurati di montare [.filename]#/usr# prima della partizione MS-DOS(R) perché le tabelle di conversione sono posizionate in [.filename]#/usr/libdata/msdosfs#. Per maggiori informazioni, guarda la pagina man di man:mount_msdosfs[8].

==== Configurazione di X11

. Segui innanzitutto la configurazione del <<setting-locale,locale in console>> come descritto in precedenza.
. Se usi Xorg, installa il package package:x11-fonts/xorg-fonts-cyrillic[].
+ 
Controlla la sezione `"Files"` nel tuo file [.filename]#/etc/X11/xorg.conf#. Le seguenti righe devono essere aggiunte _prima_ di qualsiasi altra voce `FontPath`:
+
[.programlisting]
....
FontPath   "/usr/X11R6/lib/X11/fonts/cyrillic/misc"
FontPath   "/usr/X11R6/lib/X11/fonts/cyrillic/75dpi"
FontPath   "/usr/X11R6/lib/X11/fonts/cyrillic/100dpi"
....
+ 
Se utilizzi una modalità video ad alta risoluzione, scambia le righe 75 dpi e 100 dpi.
+
[NOTE]
====
Cerca nei port per altri font cirillici.
====

. Per attivare la tastiera russa, aggiungi alla sezione `"Keyboard"` del tuo file [.filename]#xorg.conf# queste cose:
+
[.programlisting]
....
Option "XkbLayout"   "us,ru"
Option "XkbOptions"  "grp:toggle"
....
+ 
Verifica inoltre che la riga `XkbDisable` sia commentata.
+ 
Per `grp:caps_toggle` il cambio RUS/LAT si usa kbd:[Right Alt], per `grp:ctrl_shift_toggle` si usa kbd:[Ctrl+Shift]. La vecchia funzione di kbd:[CapsLock] à ancora disponibile via kbd:[Shift+CapsLock] (solamente in modalità LAT). Per `grp:toggle` il cambio RUS/LAT si usa kbd:[Right Alt]. `grp:caps_toggle` non funziona in Xorg per ragioni sconosciute.
+ 
Se hai i tasti "Windows(R)" sulla tua tastiera, e noti che alcuni tasti non alfabetici sono mappati non correttamente in modalità RUS, aggiungi in [.filename]#xorg.conf# la seguente riga:
+
[.programlisting]
....
Option "XkbVariant" ",winkeys"
....
+
[NOTE]
====
La tastiera russa XKB potrebbe non lavorare con applicazioni non localizzate.
====

[NOTE]
====
Di base le applicazioni localizzate dovrebbe chiamare la funzione `XtSetLanguageProc (NULL, NULL, NULL);` all'inizio del programma.

Guarda http://koi8.pp.ru/xwin.html[KOI8-R per X Window] per maggiori istruzioni sulle applicazioni di X11 localizzate.
====

=== Localizzazione del Cinese Tradizionale per Taiwan

Il FreeBSD-Taiwan Project fornisce un Chinese HOWTO per FreeBSD all'indirizzo http://freebsd.sinica.edu.tw/\~statue/freebsd/zh-tut/[http://freebsd.sinica.edu.tw/~statue/freebsd/zh-tut/] per l'utilizzo di gran parte delle applicazioni in cinese. L'attuale autore del `FreeBSD Chinese HOWTO` è Shen Chuan-Hsing mailto:statue@freebsd.sinica.edu.tw[statue@freebsd.sinica.edu.tw].

Chuan-Hsing Shen mailto:statue@freebsd.sinica.edu.tw[statue@freebsd.sinica.edu.tw] ha creato la http://netlab.cse.yzu.edu.tw/\~statue/cfc/[Chinese FreeBSD Collection (CFC)] utilizzando `zh-l10n-tut` del FreeBSD-Taiwan Project. I pacchetti e i file di script sono disponibili all'url link:ftp://freebsd.csie.nctu.edu.tw/pub/taiwan/CFC/[ftp://freebsd.csie.nctu.edu.tw/pub/taiwan/CFC/].

=== Localizzazione della Lingua Tedesca (per Tutte le Lingue ISO 8859-1)

Slaven Rezic mailto:eserte@cs.tu-berlin.de[eserte@cs.tu-berlin.de] ha scritto un tutorial su come utilizzare le lettere con l'_umlaut_ su una macchina FreeBSD. Il tutorial è scritto in tedesco e disponibile all'indirizzo http://user.cs.tu-berlin.de/\~eserte/FreeBSD/doc/umlaute/umlaute.html[http://user.cs.tu-berlin.de/~eserte/FreeBSD/doc/umlaute/umlaute.html].

=== Localizzazione della Lingua Giapponese e Coreana

Per il giapponese, vedere l'url http://www.jp.FreeBSD.org/[http://www.jp.FreeBSD.org/], per il coreano, l'url http://www.kr.FreeBSD.org/[http://www.kr.FreeBSD.org/].

=== Documentazione Non Inglese per FreeBSD

Alcuni volontari hanno tradotto parte della documentazione di FreeBSD in altre lingue. Questo materiale è raggiungibile seguendo i link segnalati sul link:https://www.FreeBSD.org/it/[sito ufficiale di FreeBSD] oppure sotto la directory [.filename]#/usr/shared/doc#.