Manuale su JIF

Seconda versione, 2 dicembre 2004.
Prima versione, 15 novembre 2004.

Questo manuale fa riferimento alla versione 1.4 di JIF, scaricabile dal sito ufficiale dell'autore.

Si assume che il lettore sia abbastanza pratico di Inform. In caso contrario, rimando a documentazioni che sono indirizzate esclusivamente a questo linguaggio di programmazione:

• Manuale di Inform, di Vincenzo Scarpa
• GIP, Una Guida Inform per i Principianti
• Altri documenti su Inform

• Inform Designer's Manual
• Inform Beginners Guide

Nota dell'autore:
Spero che questo manuale su JIF possa essere d'aiuto a chi voglia avvicinarsi a questa dimensione narrativa che ritengo assolutamente affascinante.
Questo manuale è stato scritto per voi, non per me.
Quindi se avete domande, correzioni o segnalazioni da fare, non esitate a scrivermi.

Asti
15 novembre 2004

Alessandro Schillaci
silver.slade@tiscali.it

Indice dei contenuti

1. Introduzione
2. Installazione
3. Post-Installazione
4. Ambiente di lavoro
5. Primo utilizzo
6. Menu Pop-up
7. Gestione dei Progetti
8. Funzioni Principali
9. Switch Manager
10. Template Manager
11. Personalizzazione di JIF
12. Riferimenti

1. Introduzione

Jif è un editor scritto in java che permette di gestire avventure testuali scritte in Inform: con questo programma, è possibile editare i sorgenti, compilarli (tramite un compilatore) ed eseguirli (tramite un interprete).

Per esempio, grazie al mapping automatico dei caratteri, si possono tranquillamente utilizzare i caratteri speciali (es:è,ò,à..) che verranno poi trasformati automaticamente da JIF in formato ZSCII.

La gestione della fase di compilazione è realizzata tramite un pannello dove è possibile scegliere quale switch attivare quando si compila.

2. Installazione

• 2.1 Sistemi operativi
• 2.2 Installare JIF su ambienti Windows
• 2.3 Installare JIF su ambienti Linux/Unix
• 2.4 Installare JIF su MAC OSX

2.1 Sistemi operativi

JIF è disponibile per i seguenti sistemi operativi:

• Windows 95, 98, ME, XP, 2000
• Linux
• Unix
• Mac OS X (Panther)

2.2 Installare JIF su ambienti Windows

L'installazione su ambienti Windows, si avvale di un installer, cioè di un programma di installazione che si occupa di installare in maniera automatica JIF sul proprio computer.

Sono possibili due tipi di installazioni: una che riguarda una versione completa di JIF (chiamata Mega Pack) che include tutti i tool che servono per la compilazione ed esecuzione dei programmi scritti in Inform, e una versione con solo JIF, senza alcun tool.

In questo secondo caso si devono scaricare separatamente altre utility quali il compilatore e l'interprete Inform, le librerie Inform italiane (le INFIT2.5 o superiori): questo tipo di installazione è indirizzata a utenti esperti.

torna all'indice

2.2.1 Installazione rapida (Mega Pack)

Questa installazione di JIF è pre-configurata (cioè una volta installata, non necessita di ulteriori configurazioni) e comprende i seguenti componenti:

• JIF 1.4
• il compilatore 6.30 Inform
• le librerie 6/11 originali Inform
• le librerie italiane INFIT2.5 di Giovanni Riccardi
• alcune librerie italiane varie
• l'interprete WindowsFrotz
• l'interprete WinGlulxe
• i tool Bres, Blc, Bpal, Front per la compilazione in formato Glulx

• Scaricare ed installare il JRE 1.4 o superiore.
• Scaricare ed installare JIF 1.4 Mega Pack.

2.2.2 Installazione standard

In queste istruzioni per PATH_DI_INSTALLAZIONE si intende la directory scelta dall'utente per l'installazione di JIF (per esempio: C:\Programmi\JIF)

• Scaricare ed installare il JRE 1.4 o superiore.
• Scaricare ed installare JIF 1.4.
• Scaricare il compilatore Inform e scompattarlo nella directory (PATH_DI_INSTALLAZIONE\compiler\)
• Scaricare l'interprete WindowsFrotz e scompattarlo nella directory (PATH_DI_INSTALLAZIONE\interpreter\)
• Scaricare l'interprete WinGlulxe e scompattarlo nella directory (PATH_DI_INSTALLAZIONE\interpreter\)
• Scaricare le librerie che si intendono usare per la compilazione e installarle sotto la directory (PATH_DI_INSTALLAZIONE\lib\) Queste librerie normalmente sono quelle relative al compilatore Inform utilizzato e quelle relative alla lingua italiana (Infit2.5 o superiori di Giovanni Riccardi)

2.3 Installare JIF su ambienti Linux/Unix

In queste istruzioni per PATH_DI_INSTALLAZIONE si intende la directory scelta dall'utente per l'installazione di JIF (per esempio: \usr\bin\)

• Copiare il file Jif.X.X_Linux.zip (JIF versione per Linux/Unix) nella directory voluta
• Scompattare il file
• Accertarsi di aver installato Java, un compilatore inform e l'interprete xfrotz (o zoom)
• Editare i due file:
  start_JIF_ita.sh
  start_JIF_eng.sh
  
  modificare l'ultimo parametro della prima linea con il PATH di installazione di JIF
  Esempio: start_JIF_ita.sh
  la riga:
  
  java -Duser.language=it -Duser.region=IT -cp . -jar Jif.jar /home/ale/Jif/
  va modificata in:
  
  java -Duser.language=it -Duser.region=IT -cp . -jar Jif.jar PATH_DI_JIF
• Eseguire il comando:
  "chmod +x start_JIF_ita.sh" e "chmod +x start_JIF_eng.sh"
  Se il comando "java" non è automaticamente riconosciuto, modificarlo con il path assoluto esempio: (/usu/java/j2sdk1.4.0_01/bin/java)
• Eseguire il file sh a seconda della lingua voluta (esempio start_JIF_ita.sh)
• Impostare/ricontrollare i path via menu (da JIF)
• Scaricare tutte le librerie nella directory "lib"

2.4 Installare JIF su MAC OSX

• Copiare il file Jif.X.X_Linux.zip (JIF versione per Linux/Unix) nella directory voluta
• Scompattare il file
• Se la JVM (Java virtual machine) è installata correttamente, JIF dovrebbe partire senza problemi, eseguendo un doppio click sul file "Jif.jar"
• Se JIF non parte correttamente, allora è possibile che la JVM non sia stata installata correttamente. Seguire passo passo le istruzioni della sezione Installare JIF su ambienti Linux/Unix.

3. Post-Installazione

Dopo aver installato JIF correttamente, la struttura delle directory dovrebbe essere come questa:

• compiler:
  Directory che contiene il compilatore Inform utilizzato per la compilazione.
• config:
  Directory di configurazione di JIF - solo alcuni file possono essere modificati e personalizzati.
  
• doc:
  Directory che contiene documenti che possono essere visualizzati da JIF. In questa directory è possibile salvare, per esempio, tutti i documenti che sono importanti durante la sessione di programmazione Inform. Ad esempio, Inform Beginners Guide e Inform Designer's Manual (in lingua inglese).
  Oppure in italiano, il Manuale di Vincenzo Scarpa su Inform o la GIP (Guida ad Inform per Principianti).
  Con JIF è possibile associare ai tasti funzione F11 - F12 comandi esterni. Per esempio è possibile associare ad uno dei due tasti funzione, l'esecuzione di un Reader PDF che visualizzi in automatico un documento preso da questa directory.
• games:
  Directory standard per i sorgenti Inform: i vostri giochi verranno memorizzati in questa directory. Utilizzando la gestione a progetti, i sorgenti possono comunque essere memorizzati in altre directory.
  Per esempio, per progetti estesi, è possibile creare una directory esterna alla struttura delle directory di JIF e utilizzarla come contenitore per tutti i file che fanno parte del progetto.
• glulx:
  In questa directory vi sono i tool necessari per creare file in formato blorb. Per ulteriori informazioni, consultare il file front.txt incluso.
• interpreter:
  Directory che contiene i vari interpreti che è possibile utilizzare da JIF.
• lib:
  Directory standard dove salvare tutti i file di libreria utilizzati per la compilazione di sorgenti Inform.
• projects:
  JIF consente di raggruppare file in progetti. I file possono avere qualsiasi estensione (*.inf, *.h, *.txt e così via). I progetti JIF, sono descritti da file con estensione *.jpf che vengono memorizzati in questa directory. NB: i file *.jpf sono creati da JIF, quindi è altamente consigliabile NON modificarli.
• tutorial:
  Directory che contiene tutti i tutorial richiamabili da JIF in qualsiasi momento. Sono raggruppati per lingua (Per quelli in italiano, si veda la directory tutorial/IT). E' possibile aggiungere in maniera semplice, altri tutorial, semplicemente creando una nuova directory sotto la lingua desiderata e inserendo al suo interno 3 tipi di file di testo: senza estensione (esempio: Comandi), estensione txt (esempio: Comandi.txt) e file tipo index.html
  
  NB: nel caso di documenti in formato html, nel menu tutorial, JIF mostrerà soltanto i 3 tipi di file, e qualsiasi file aggiuntivo (come immagini, file *.css e via dicendo), non verrà mostrato, anche se effettivamente utilizzato dal file index.html.

4. Ambiente di lavoro

Dopo aver installato correttamente il programma, ecco una prima immagine del vostro nuovo ambiente di lavoro per Inform.

Si possono evidenziare 6 zone particolari:

1. Textarea Principale:
   La Textarea che contiene il sorgente da editare. In questa Area verrà editato il codice sorgente.
   
2. Finestra di output:
   Mostra tutti i messaggi in fase di compilazione.
   
3. Albero degli oggetti:
   Albero che raggruppa logicamente gli oggetti che costituiscono il sorgente
   
4. Pannello dei progetti:
   E' possibile creare un nuovo progetto e aggiungere dei sorgenti al progetto stesso. Molto utile se il progetto che si sta sviluppando è complesso e si deve suddividere in più file.
   
5. Toolbar Principale:
   Contiene i principali tasti associati a svariate azioni.
   
6. Toolbar Inform:
   Contiene i principali tasti associati ad azioni relative ad Inform.
   

5. Primo utilizzo

Quando JIF è stato installato correttamente, è possibile cominciare a lavorare in Inform. Inizieremo a scrivere un piccolo esempio.
Create un nuovo file. Questa operazione si può effettuare in 3 modi:

• Da toolbar: usando il tasto
• Da menu: FILE->NUOVO
• Da shortcut: usando la combinazione di tasti [CTRL + N]

Copiate il testo seguente e incollatelo nella nuova pagina che verrà aperta (nella Textarea principale [1]).

!--------------------------------!
! Primo esempio di codice Inform
!--------------------------------!

Constant Story "Primo esempio di Inform";
Constant Headline
		"^Scritto in Inform con JIF^";

Include "Parser";
Include "VerbLib";
Include "Replace";

! Gioco

Object room "La tua prima stanza"
	with  description
		"Ti trovi nella tua prima stanza della tua avventura.",
	 has light;

! Grammatica

Include "ItalianG";

[Initialise;
	location = room;
	"Ecco il testo che introduce la tua avventura testuale^^";
];

1. Salvate il file con il comando Salva con nome (chiamandolo esempio1.inf), usando il comando da menu File->Salva con nome o cliccando sul tasto : selezionare il path assoluto del file (di solito C:\Programmi\JIF\games) e inserire il nome "esempio1.inf". Quindi salvatelo. In questo modo verrà creato un file esempio1.inf nella directory games.
2. Per compilare il sorgente appena creato, utilizzare il menu Compila->Compila, la combinazione di tasti [ALT + B], o più semplicemente cliccate sul tasto di compilazione . Nella finestra di output, dovrebbe essere visualizzato un messaggio che indica che la compilazione è andata a buon fine.

   File C:\Jif\games\esempio.inf salvato
   Fase di compilazione....
   C:\Jif\compiler\inform.exe  -v5 +language_name=italian +include_path=C:\Jif\games,C:\Jif\lib 
   C:\Jif\games\esempio.inf C:\Jif\games\esempio.z5
   Inform 6.30 for Win32 (27th Feb 2004)
   Using Infit v2.5 / Serial: 041014 / (c) 2004 by Giovanni Riccardi
   
   OK.
   

3. Per eseguire la semplice avventura testuale di esempio (che in realtà è la più semplice avventura che è possibile scrivere), basta selezionare il menu Compila->Esegui AT, la combinazione di tasti [ALT + R] oppure il tasto di esecuzione avventura . Viene lanciato l'interprete corretto che esegue l'avventura appena compilata.

   

La directory games ora dovrebbe contenere un nuovo file con nome esempio1.z5. Questo file è il file utilizzato dall'interprete.

Nel caso di installazione da zero (quella per esperti), se qualcosa non dovesse funzionare nel verso giusto, controllate i path del compilatore/interprete. In caso di errori o warning in fase di compilazione, è sufficiente eseguire un doppio click del mouse sulla finestra di output, in prossimità della riga che segnala l'errore (o warning). In questo modo, JIF aprirà il sorgente alla riga in corrispondeza dell'errore segnalato dal compilatore.

6. Menu Pop-up

• 6.1 Menu Pop-up dalla TextArea del codice
• 6.2 Menu Pop-up dal Pannello dei Progetti

Sono disponibili due tipi di menu a pop-up: vengono attivati con il tasto destro del mouse quando il mouse si trova su:

1. TextArea del codice
2. Pannello dei progetti

6.1 Menu Pop-up dalla TextArea del codice

Cliccando con il tasto destro del mouse sulla Textarea principale [1], viene mostrato un menu speciale:

Le azioni principali di questo menu sono:

• Inserisci Nuovo: tramite questo menu è possibile inserire del codice arbitrario, selezionandolo da una lista (personalizzabile)
• Inserisci Simbolo: per inserire un simbolo, selezionandolo da una lista (personalizzabile)
• Inserisci File: per inserire il contenuto di un file direttamente nella textarea del codice sorgente
• Copia: copia il testo selezionato
• Incolla: incolla il testo. E' possibile copiare più parti di codice: da questo menu verranno visualizzati tutti i testi copiati da incollare. Quindi ad ogni operazione di copia del testo, verrà incrementata la dimensione del menu Incolla.
• Azzera menu Incolla: svuota il menu Incolla.
• Aggiorna Albero degli oggetti: con questo menu, viene aggiornato l'albero degli oggetti.
• Stampa: per stampare il file corrente.
• Chiudi: chiude il file corrente.
• Chiudi tutti i file: chiude tutti i file correntemente aperti con JIF.

6.2 Menu Pop-up dal Pannello dei Progetti

Con JIF è possibile creare dei progetti: semplicemente rappresentano un raggruppamento logico di sorgenti Inform (ma possono essere in teoria anche file di testo per la trama dell'avventura, oppure file *.h di libreria). Cliccando con il tasto destro del mouse sul Pannello dei progetti [4], viene mostrato un menu speciale:

Le azioni principali di questo menu sono:

• Nuovo Progetto:
  

  Crea un nuovo progetto. I nuovi progetti sono file memorizzati nella directory projects. Questi file sono creati da JIF, quindi non dovrebbero essere in nessun caso modificati a mano. All'interno di ogni file di progetto, oltre che ai file che fanno parte del progetto stesso, verranno memorizzate anche altre informazioni:

  • Gli switch attivati per la compilazione relativa al progetto
  • I colori scelti per la syntax highlight relativa al progetto
  • Le opzioni principali impostate per il progetto

  Quindi è possibile avere diversi progetti con impostazioni personalizzate.

• Apri Progetto: Apre un file di progetto.
• Salva Progetto: Salva un file di progetto.
• Aggiungi un nuovo File al progetto: Viene creato un file nuovo (da rinominare) che verrà automaticamente aggiunto al progetto attualmente aperto.
• Aggiungi File: Aggiunge un file già esistente al progetto corrente.
• Rimuovi File: Rimuove un file dalla lista dei file del progetto. Non ha effetti sul file: lo rimuove soltanto dalla lista.
• Apri i file selezionati: Una volta selezionati i file contenuti nel Pannello dei progetti (è consentita anche la selezione multipla), è possibile aprili con un solo click del mouse. Con questa voce di menu.
• Imposta come Main file per la compilazione: Il file selezionato, diventa il main file: ogni volta che viene lanciata la compilazione viene utilizzato il main file come file da compilare.
• Rimuovi Main File: Rimuove il main file.

7. Gestione dei Progetti

• 7.1 Un semplice esempio
• 7.2 Creare un nuovo progetto
• 7.3 Usare il Main File
• 7.4 Salvare le impostazioni

7.1 Un semplice esempio

Se la vostra avventura è abbastanza complessa, allora è consigliabile utilizzare la gestione a progetti. Per avventure brevi, è possibile avere un solo file sorgente e la gestione a progetti è superflua. Dopo aver creato il file esempio1.inf, creare con la stessa procedura un nuovo file. Copiare ed incollare il seguente testo:

Object seconda_stanza "La seconda location"
	with  description
	"Sei nella seconda stanza della tua avventura.
	^Puoi andare a nord.",
	n_to room
	 has light;

Object -> libro "un libro"
	with
		name 'libro',
		article "tuo",
		description
		"Questo è il primo oggetto della tua avventura!";

Salvarlo con nome esempio2.inf.

Selezionare il file precedentemente creato (esempio1.inf): rimuovere il codice compreso tra i commenti ! GIOCO e ! GRAMMAR e incollare al suo posto, il seguente codice:

Object room "La tua prima stanza"
	with  description
		"Ti trovi nella tua prima stanza della tua avventura.
		C'è un passaggio verso sud.",
	s_to seconda_stanza,
	 has light;

Include ">esempio2";

Il codice finale del file esempio1.inf, dovebbe essere costituito dal seguente codice:

!--------------------------------!
! Primo esempio di codice Inform
!--------------------------------!

Constant Story "Primo esempio di Inform";
Constant Headline
		"^Scritto in Inform con JIF^";

Include "Parser";
Include "VerbLib";
Include "Replace";

! Gioco

Object room "La tua prima stanza"
	with  description
		"Ti trovi nella tua prima stanza della tua avventura.
		C'è un passaggio verso sud.",
	s_to seconda_stanza,
	 has light;

Include ">esempio2";

! Grammatica

Include "ItalianG";

[Initialise;
	location = room;
	"Ecco il testo che introduce la tua avventura testuale^^";
];

Selezionare il file esempio1.inf e lanciare la compilazione con . Eseguire l'avventura, usando . In questo modo abbiamo incluso il file esempio2.inf all'interno del file esempio1.inf. Ecco quello che vedremmo, lanciando in esecuzione la nostra avventura.

Possiamo osservare che se viene selezionato per errore il file esempio2.inf e lanciata la compilazione, si verificheranno errori di compilazione.

Questo perchè stiamo cercando di compilare il file sbagliato: dato che il file principale è esempio1.inf, è corretto lanciare la compilazione passando al compilatore quest'ultimo file. Vedremo come utilizzare la gestione dei progetti su JIF, per semplificare e velocizzare il processo di compilazione.

7.2 Creare un nuovo progetto

Utilizziamo la gestione a progetti di JIF per gestire i due sorgenti che abbiamo appena creato. Ovviamente la gestione di un progetto è indicata per progetti che siano costituiti da un numero elevato di file. Questo esempio deve semplicemente spiegare come creare un progetto con JIF.
Procediamo.

Chiudiamo tutti i file aperti con JIF, utilizzando il menu [File|Chiudi tutti i File] (oppure cliccando su ).

Ecco la procedura per creare un nuovo progetto costituito dai due sorgenti:

1. Utilizzare il menu [Progetto|Nuovo Progetto] dalla Toolbar di JIF. Impostare il nome per il progetto (inserire il nome "progetto1").

   

   Cliccare su . Questa operazione crea un file con estensione .jpf (da non modificare a mano) nella directory dei progetti ("projects")
2. Come verifica potete controllare che il nome del progetto appena inserito venga mostrato nel Pannello dei progetti [4].

   

3. Usare il menu [Progetto|Aggiungi File]. Verrà aperto un FileDialog da dove è possibile selezionare i file che verranno aggiunti al nostro progetto. E' possibile anche una selezione multipla dei file: basta tenere premuto il tasto [CTRL]. Nel nostro esempio, il FileDialog dovrebbe aprirsi in corrispondenza della directory games: tenere premuto il tasto [CTRL] e selezionare i file esempio1.inf e esempio2.inf.
4. Ora i due file, dovrebbero comparire all'interno del Pannello dei progetti.

   

5. Con un click del mouse, selezioniamo il file esempio1.inf Con un click del tasto destro, dovrebbe apparire il menu pop-up. Selezionare [Imposta come Main file per la compilazione]. In questo modo si indica a JIF che il file utilizzato per la compilazione sarà sempre esempio1.inf. Come verifica delle operazioni, dovreste vedere che al fondo del Pannello dei Progetti, è indicato quale file Main viene utilizzato per la compilazione.

   

6. Importante: dopo aver effettuato tutte le operazioni ricordarsi di salvare sempre il progetto con [Progetto|Salva Progetto] per non perdere tutte le modifiche.
7. E' possibile aprire i file direttamente utilizzando il Pannello dei Progetti, semplicemente effettuando un doppio click sul file che si vuole aprire. Per aprire più file contemporaneamente, basta selezionare i file nel Pannello dei Progetti sempre con il tasto [CTRL] premuto e poi utilizzare il menu pop-up cliccando con il tasto destro del mouse e scegliendo il menu [Apri i file selezionati]

Per verificare il tutto, possiamo aprire i due file e selezionare il file esempio2.inf. Lanciamo la compilazione con : in questo caso, JIF userà il Main file per la compilazione e non si verificheranno errori di compilazione.

7.3 Usare il Main File

Il funzionamento stardard di JIF, prevede di effettuare la compilazione del file corrente. Tornando all'esempio dei file creati in precedenza: selezionando il file esempio1.inf e lanciando la compilazione (senza la creazione di un progetto), la compilazione viene eseguita correttamente.

Se si seleziona il secondo file (esempio2.inf) e si effettua la compilazione standard, JIF cercherà di compilare questo file, senza successo. Questa gestione della compilazione è corretta solo nel caso si abbia un solo sorgente: nel nostro caso, il file esempio1.inf include il file esempio2.inf.

La soluzione consiste nell'utilizzo di un file di progetto: si tratta di un semplice "raggruppamento" logico di file con la possibilità di salvare informazioni extra. Utilizzando un progetto, infatti, è possibile per esempio impostare un Main File che viene utilizzato (se impostato) per la compilazione effettiva del progetto. L'informazione relativa al Main File, viene mantenuta al salvataggio del progetto, ed è sempre possibile impostare un nuovo Main File utilizzando il menu pop-up

7.4 Salvare le impostazioni

Ogni progetto include il salvataggio delle impostazioni utilizzate da JIF. Quindi vengono memorizzate le informazioni riguardo:

1. I colori della syntax highlighting personalizzati per ogni progetto
2. Quali sono gli switch impostati per la compilazione, al momento del salvataggio del progetto
3. Impostazioni diverse per ogni progetto

In generale per piccole avventure, è possibile l'utilizzo di un solo file sorgente. Per avventure più complesse e di una certa lunghezza, è consigliabile utilizzare diversi sorgenti, riuniti in un progetto.

8. Funzioni Principali

• 8.1 Toolbar principale
• 8.2 Toolbar relativa a Inform

8.1 Toolbar principale

	Nuovo File. Crea un nuovo file vuoto
	Apri. Apre uno o più file
	Salva
	Salva Tutto. Salva tutti i file correntemente aperti
	Salva con Nome
	Chiudi. Chiude il file attualmente selezionato
	Chiudi tutti i File. Chiede conferma per i file che hanno subito modifiche
	Stampa
	Taglia
	Copia
	Incolla
	Annulla
	Ripristina
	Sostituisci
	Cerca
	Informazioni sulla versione di JIF in uso
	Esci da JIF

8.2 Toolbar relativa a Inform

	Commenta il testo selezionato
	Rimuove il commento dal testo selezionato
	Shift a sinistra il testo selezionato
	Shift a destra il testo selezionato
	Effettua un controllo formale sul sorgente selezionato: eventuali parentesi non chiuse o non aperte, vengono segnalate
	Esegue l'avventura selezionata, lanciando l'interprete selezionato dal Pannello di configurazione
	Mostra una pop-up dalla quale è possibile scegliere quale simbolo inserire. Il file di testo relativo alla lista di simboli che è possibile inserire, è symbols.ini nella directory config. Questo file è configurabile a piacere: basta editarlo con un editor di testo qualsiasi
	Mostra una pop-up che visualizza la lista di oggetti definiti nel file sorgente
	Mostra una pop-up che visualizza la lista di tutte le funzioni che sono contenute nei file posizionati all'interno della directory lib
	Visualizza le principali informazioni del file corrente
	Questa funzione, estrae tutte le stringhe del sorgente e le memorizza in un file secondario chiamato translate.txt all'interno della directory games. Può essere utile nel caso di traduzioni da una lingua all'altra oppure se si desidera effettuare un controllo di sintassi utilizzando un programma esterno
	Viene creato un nuovo file (translated.inf), che contiene le traduzioni delle stringhe prelevate dal file translate.txt
	Viene lanciato l'interprete impostato nel Pannello delle Impostazioni.
	Viene visualizzato lo Switch Manager, che consente di indicare quali switch sono attivati in fase di compilazione
	Apre il Pannello di Configurazione: da qui è possibile impostare le opzioni di JIF
	Apre il Template Manager
	Commenta il testo selezionato
	Selezionando un file che contiene Template, è possibile scegliere quali template importare nella versione locale di JIF

9. Switch Manager

Per switch si intendono i parametri che vengono passati in linea di comando al compilatore inform. Nell'esecuzione di una avventura scritta in italiano:

infrmw32.exe  -v5 +language_name=italian +include_path=C:\Jif\lib C:\Jif\games\Esempio.inf 
C:\Jif\games\Esempio.z5

Con JIF è possibile personalizzare un elenco di switch che possono essere utilizzati in fase di compilazione. Nel caso di switch nuovi, aggiunti in versioni "future" del compilatore, basta aggiungere lo switch nuovo in un file di configurazione, per avere JIF aggiornato e perfettamente allineato con il compilatore utilizzato.

10. Template Manager

• 10.1 Template Statici
• 10.2 Template Dinamici

I Template rappresentano un modo di riusare classi, funzioni e oggetti: è possibile creare una sorta di libreria di parti di codice riusabile.

Selezionare il menu [Template/Template manager] oppure con il tasto Viene visualizzato il Pannello relativo al Template Manager.

10.1 Template Statici

I template statici si comportano come frammenti di codice con alcune informazioni aggiuntive (versione, autore ecc).
Selezionando il template statico da utilizzare, verrà inserito nel sorgente corrente il codice selezionato.

Esempio:

1. Creare un nuovo file
2. Cliccare sull'icona
3. Scegliere la funzione "Presskey" (autore: Vincenzo Scarpa) e cliccare sul tasto [Usa il Template selezionato]

10.2 Template Dinamici

I template dinamici si comportano come frammenti di codice da "personalizzare" con l'utilizzo di parametri.

Esempio di Template Dinamico:

Class tesoro
 with punti 10,
      after
      [; 
      	Take: if (location==§*stanza§) "Preso!";        
      ];

Il testo inserito nei caratteri "§*" e "§" è considerato parametro, cioè inseribile dall'utente in fase di utilizzo del template dinamico. Quando l'utente utilizza il template dinamico, gli verrà chiesto di inserire il valore del parametro ("stanza"), che verrà utilizzato per l'inserimento del template all'interno del codice.

11. Personalizzazione di JIF

Molte delle caratteristiche di JIF possono essere facilmente personalizzate per soddisfare diverse esigenze.

• 11.1 Syntax Highlight
• 11.2 Tasti funzione
• 11.3 Mapping, elenco dei caratteri speciali
• 11.4 Switch utilizzati per la compilazione
• 11.5 Simboli
• 11.6 Gestione codice assistito
• 11.7 La gestione del comando "INSERISCI NUOVO"

11.1 Syntax Highlight

Gestisce i colori diversi per tipo di parola inserita nel sorgente Inform.

11.2 Tasti funzione

E' possibile configurare i tasti funzione per digitare caratteri frequentemente usati o particolarmente "ostici" (esempio. ~(tilde),`(apice),{(parentesi graffa), ecc..)

11.3 Mapping, elenco dei caratteri speciali

Gestisce l'elenco dei caratteri speciali riconosciuti da JIF per eseguire il "mapping" in ZSCII.

11.4 Switch utilizzati per la compilazione

Cliccando su , viene visualizzato lo switch manager.

Questo Pannello gestisce un elenco di switch che possono essere scelti per la compilazione.

11.5 Simboli

Con JIF è possibile utilizzare una finestra relativa alla gestisce di simboli.

11.6 Gestione codice assistito

In JIF è integrato un sistema di codice assistito.

11.7 La gestione del comando "INSERISCI NUOVO"

Con il tasto destro del mouse sulla TextArea principale, viene visualizzato un menu a PopUp. La voce più importante di questo menu è INSERISCI NUOVO: contiene una serie di menu e sotto-menu da cui scegliere cosa inserire nel testo.
E' possibile modificare la lista degli oggetti da inserire, semplicemente aggiungendo del codice all'interno dei file menu.ini: questi file sono contenuti nelle directory a partire da: JIF/config/menu

Per esempio il file: JIF/config/menu/Class/menu.ini ha questo contenuto:

Generic Class,Class CLASS_NAME §has ATTRIBUTE;
Room Class,Class Room§  has  light;

Se da menu si sceglie la voce Menu->Inserisci Nuovo->Class->Room Class, nel codice che si sta sviluppando verrà inserita questa porzione di sorgente:

Class Room
has  light;

Da questo esempio si può dedurre:

• Tutti i menu sono configurabili a piacere
• Le righe vuote o che iniziano con il carattere "#" (cancelletto) sono ignorate
• Tutti i caratteri "§" inseriti nei file di tipo "menu.ini", servono per andare capo (vengono cioè interpretati come il codice html)

12. Riferimenti