2 - Amiga Magazine Online

## version: per inserire una stringa di versione
## language: per specificare la lingua del catalog
## codeset: il set di codice richiesto dal catalog (0)
Ed ecco un esempio di file.cd e relativo.ct in italiano:
; Catalog Description di prova
MSG-SALUTO ( / / )
Hello boys, I'm talking \n with you in English
MSG-TITOLO (+l//)
Language test
MSG-LO-SO-GAD (5//)
I Know
; Catalog Translation di prova
## version SVER: ProvaLoc.catalog 1.0 (2/6/97)
## codeset O
## language italiano
MSG-SALUTO
Ciao Ragazzi, sto parlando \n con voi in Italiano
MSG-TITOLO
Prova lingua
MSG-LO-SO-GAD
LO so
Ricordiamo che prima di ogni stringa deve essere pre-
sente una riga riportante il marcatore di commento, e
due tra il nome della stringa e i suoi parametri deve es-
sere presente sempre un solo spazio.
La terza stringa ha il nome con suffisso -GAD che, sem-
pre per convenzione, indica che è destinata ad apparire
all'interno di un gadget. I numeri delle stringhe sono sta-
ti messi in questo modo a solo scopo dimostrativo: infat-
ti è più comune usare numerazioni progressive ometten-
do il parametro. In questo esempio le stringhe avranno
rispettivamente i numeri 1, 3, 5.
Se usate CatEdit, è sufficiente caricare prima il file .cd e in
seguito quello .ct (opzioni Read Catalog Description e Ca-
talog Translation) per poter poi salvare un completo file
catalog. In realtà sarebbe possibile anche creare e caricare
il solo file .cd e tradurre direttamente le varie stringhe me-
diante CatEdit. Basterebbe a quel punto assegnare il nome
della lingua tradotta e salvare il file catalog.
Consigliamo comunque di scrivere sempre anche il file .ct
che, tra l'altro, permette di inserire anche il numero di
versione del catalog.
Programmare con la Locale
#include
#include
#include
#include
#include
#include
#include "provacata1og.h" /* file include contenente i define */
/* delle stringhe (vedi testo) * /
struct LocaleInfo
(
);
APTR li-LocaleBase;
APTR li-Catalog;
struct Library *IntuiBase;
struct Library *LocaleBase;
struct Catalog *catalog;
struct LocaleInfo li;
struct EasyStruct es;
STRPTR GetString(struct LocaleInfo *li,LONG stringid,
STRPTR strinterna)
(
if(li->li-LocaleBase)
return(GetCatalogStr(li->li-Catalog,stringid,strinterna) );
return(strinterna) ;
)
void main (void)
(
IntuiBase = OpenLibrary("intuition.library",OL);
if(1ntuiBase)
(
LocaleBase = OpenLibrary("locale.library",OL);
li.li-LocaleBase = LocaleBase;
if(Loca1eBase)
(
l
catalog = OpenCatalog(NULL,"provalocale.catalog",
OC-BuiltInLanguage,"english"
TAG-DONE);
li.li-Catalog = catalog;
es.es-StructSize = sizeof(struct EasyStruct);
es.es-Flags = NLiLL;
es.es-Title = ~etstring(&li,~SG-~1~0~0,"Language test")
es.es-TextFormat = ~et~tring(&li,MSG-SALUTO,
"Hello Boys, I'm talking\n with you
in English") ;
es.es-GadgetFormat= GetString(&li,MSG-~O-S0-GAD"1 know");
Viste e analizzate tutte le componenti, possiamo finai-
mente dedicarci alla programmazione vera e propria.
Ricordiamo che è consigliabile l'uso di un file header Comp che genera questi file automaticamente. Per il ca-
che associ il nome di ogni stringa al suo relativo numero talog dell'esempio precedente, questo file avrebbe il se-
d'identificazione sempre che non si disponga di Cat guente contenuto: