--------------------------------------------------------------------------------
                                       Jif
                                      v 1.0
Configuración
--------------------------------------------------------------------------------

JIF - editor de Java para Inform
© 2003 - Alessandro Schillaci
http://www.freec0de.netfirms.com
silver.slade@tiscalinet.it


INDICE

0. TECLAS RÁPIDAS

1. CONFIGURACIÓN

2. FICHEROS DE CONFIGURACIÓN

	2.1 Menu
	2.2 config.ini
	2.3 helpedcode.ini	
	2.4 mapping.ini	
	2.5 switches.ini
	2.6 functionKeys.ini
	2.7 symbols.ini
	2.8 syntax.ini
	2.9 links.ini

3. ADMINISTRADOR DE PLANTILLAS


--------------------------------------------------------------------------------
0. TECLAS RÁPIDAS
--------------------------------------------------------------------------------

CTRL+A                  Seleccionar todo
CTRL+X                  Cortar
CTRL+C,CTRL+INS         Copiar
CTRL+V,SHIFT+INS        Pegar

CTRL+Z                  Deshacer
CTRL+Y                  Rehacer

ALT+FLECHA DCHA.        Desplazar hacia la derecha el bloque de texto seleccionado
ALT+FLECHA IZQDA.       Desplazar hacia la izquierda el bloque de texto seleccionado

BOTON DCHO. RATÓNTASTO  Menú Contextual 1 (si el puntero está en el Editor de Texto)
                        Menú Contextual 2 (si el puntero está en la lista de ficheros)

ALT+1                   Ventana de Símbolos
ALT+2                   Ventana de Objetos (objetos presentes en el código fuente)
ALT+3                   Ventana de Funciones (se cogen del los ficheros en el directorio de Librería)

CTRL+F                  Buscar cadena

F1...F10                Caracteres Personalizados
F11 y F12               Ejecutar programas externos


--------------------------------------------------------------------------------
1. CONFIGURACIÓN
--------------------------------------------------------------------------------

Jif contiene los siguiente ficheros/directorios:

[DIRECTORIO]:

backup            - directorio de copias de seguridad (si está activada la opción de copia de seguridad)
compiler          - directorio del compilador de Inform
config            - directorio de ficheros de configuración de Jif
doc               - directorio de documentación
games             - fuentes (*.inf) y ficheros compilados (*.z5, *.z8)
interpreter       - directorio del intérprete de Inform
lib               - directorio de librería
projects          - directorio de proyectos
tutorial          - directorio del Tutorial

config/menu       - "Insertar Nueva" función
config/template	  - directorio de plantillas

[FICHEROS DE CONFIGURACIÓN]
Estos ficheros están en el directorio: RUTA_JIF/config
Puesde editar y personalizar estos ficheros.
El único fichero que no se debe tocar el "config.jif".

config.ini         - configuración de rutas
config.jif         - configuración general de Jif
functionKeys.ini   - teclas de función (F1...F10)
helpedcode.ini	   - lista de comandos para el "asistente de código"
links.ini          - enlaces WEV
mapping.ini        - mapeos para la traducción de caracteres especiales
switches.ini       - lista de opciones del compilador
symbols.ini        - lista de símbolos
syntax.ini         - resalte de sintaxis

spellcheck_ENG.diz - Lista de palabras en Inglés
spellcheck_ES.diz  - Lista de palabras en Español
spellcheck_IT.diz  - Lista de palabras en Italiano

[REGISTRO DE ERRORES]
En caso de error, hay un fichero de "log": RUTA_JIF/err.txt
In case of errors, there is a logging file: JIF_PATH/err.txt


--------------------------------------------------------------------------------
2. FICHEROS DE CONFIGURACIÓN
--------------------------------------------------------------------------------


--------------------------------------------------------------------------------
2.1 Menú - RUTA_JIF/config/menu
--------------------------------------------------------------------------------

Es posible usar la función "Insertar Nuevo": permite insertar un nuevo bloque
de código de una lista personalizable. Esta lista comienza en:
RUTA_JIF/config/menu y está compuesta de un menú de dos niveles.

Ejemplo:

RUTA_JIF/config/menu
|
|____Attribute A-O         menu.ini
|____Attribute P-Z         menu.ini
|____Class                 menu.ini
|...
|____Verb T-W              menu.ini

      LEVEL 1              LEVEL2

Se puede añadir un nuevo directorio en RUTA_JIF/config/menu dentro del cual es
posible crear un fichero "menu.ini" con el código.  Mira el contenido de los
ficheros "menu.ini" existentes para hacer el tuyo propio.

Reglas para los ficheros "menu.ini":

* se ignoran las lineas que comienzan con el caracter "#" y las lineas en blanco
  (estas lineas se tratan como comentarios)
* el caracter "§" se considera como caracter de salto de linea


--------------------------------------------------------------------------------
2.2 config.ini
--------------------------------------------------------------------------------

Este fichero contiene las rutas de búsqueda de la librería, el compilador, el
intérprete, etc...

El fichero "config.ini" puede editarse a mano pero es preferible hacerlo
usando el panel de configuración de Jif.

Ejemplo:

	libPath=C:\Jif\lib
	libPathSecondary=C:\Jif\lib1 
	gamesDir=C:\Jif\games
	interpreter=C:\Jif\interpreter\WindowsFrotz2002\Frotz.exe
	compiler=C:\Jif\compiler\infrmw32.exe
	defaultBrowser=C:\Archivos de programa\Internet Explorer\IEXPLORE.EXE

* Librerías
     La variable "libPath" contiene la ruta a las librerías de Inform.
     Ese valor se pasa al compilador mediante la opción "+include_path".
          
* Librerías Secundarias
     Igual que "libPath" la variable "libPathSecondary" da la posibilidad de tener
     un directorio secundario donde colocar librerías de Inform.
     
* Directorio de Fuentes
     La variable "gamesDir" contiene la ruta al directorio de código fuente.
          
* Compilador
     La variable "compiler" contiene la ruta al compilador.
     
* Intérprete
     La variable "interpreter" contiene la ruta la intérprete.
     
* Navegador Predeterminado
     La variable "defaultBrowser" contiene la ruta al navegador web.


--------------------------------------------------------------------------------
2.3 helpedcode.ini
--------------------------------------------------------------------------------

Este fichero contiene todas las palabras clave que Jif conoce para el
"asistente de código".  Si la opción está activa, cuando insertas una palabra
clave en el editor, la cadena se autocompleta.

Ejemplo:

Si tecleas  -> "IF"+[ESPACIO]
   obtienes -> "IF ( ){ }"

El fichero "helpedcode.ini" se puede personalizar.


--------------------------------------------------------------------------------
2.4 mapping.ini
--------------------------------------------------------------------------------

Mediante el "mapeo" se manejan los caracteres especiales de Inform. Para la
transformación de los caracteres especiales de ASCII a ZSCII el usuario puede
elegir entre dos modos:

By "mapping" I assume the management of special Inform characters:
For translation of the special characters from ASCII to ZSCII user can
choose beetween two "mode":

1) Mapeo automático en modo de edición

Si está activa esta opción, la transformación de caracteres especiales se
activa al tiempo que el usuario edita el código fuente.

Ejemplo: si el usuario tecla el caracter "è" este se transformará a formato
ZSCII ("@`e").

2) Mapeo por fichero temporal

En este caso la transformación de caracteres especiales funcionará aparte, con
la creación de un fichero temporal (con el mismo nombre que el fichero que
estamos editando), en el directorio "RUTA_JIF/games/mapped".

El "mapeo" se puede personalizar editando el fichero "mapping.ini".


--------------------------------------------------------------------------------
2.5 switches.ini
--------------------------------------------------------------------------------

El usuario puede crear una lista de opciones que se pasarán al compilador de
Inform.  Antes de compilar un fichero fuente (*.inf), se podrá elegir que
opciones se pasan al compilador: ver "Administrador de opciones".

Puedes editar el fichero "switches.ini" (y reiniciar Jif para ver los cambios).
El fichero "switches.ini" tiene el siguiente formato:

    [SWITCH],[on,off],[Comentario]

Las opciones en ON se usan al compilar el código fuente.


--------------------------------------------------------------------------------
2.6 functionKeys.ini
--------------------------------------------------------------------------------

Es posible usar las teclas de función (F1,F2,F3,F4,F5,F6,F7,F8,F9,F10).  Esto
puede ser útil cuando se usan caracteres especiales como: ~,^,{,`..

Puedes asociar F1 al caracter "~", F2 a "^" y así sucesivamente...

Las teclas F11 y F12 keys, se usan para ejecutar programas externos.

Ejemplo:

	F11,hh.exe C:\Jif\doc\dm4.chm
	F12,explorer

En este ejemplo, pulsando F11 podrás visualizar el manual de Inform (en formato
CHM). Y pulsando F12 puedes abrir una ventana del Explorador de Windows.

Puede ser útil asociar una tecla a un visor PDF u otros programas.

El fichero "functionKeys.ini" es totalmente personalizable.


--------------------------------------------------------------------------------
2.7 symbols.ini
--------------------------------------------------------------------------------

El fichero "symbols.ini" contiene la lista de símbolos que maneja la "Ventana
de Símbolos".


--------------------------------------------------------------------------------
2.8 syntax.ini
--------------------------------------------------------------------------------

El fichero "syntax.ini" contiene la lista de palabras clave para el "resalte de
sintaxis".


--------------------------------------------------------------------------------
2.9 links.ini
--------------------------------------------------------------------------------

Este fichero contiene todos los enlaces que se pueden abrir desde Jif.


--------------------------------------------------------------------------------
3 ADMINISTRADOR DE PLANTILLAS
--------------------------------------------------------------------------------

Con el administrador de plantillas puedes crear/usar plantillas
estáticas/dinámicas.

Hay opción de actualizarlas desde WEB o desde un fichero de plantillas.

Las plantillas estáticas son, básicamente, bloques de código (con información
adicional como la versión, autor, ...).

Las plantillas dinámicas son bloques de código parametrizables.

Ejemplo:

Class treasure
 with point 7,
      after
      [; 
      	Take: if (location==§*room§) "Taken!";        
      ];

El texto entro "§*" y "§" se considera un parámetro, de tal forma que puedes
sustituirlo por un valor final al usar esta plantilla.

Es posible exportar todas las plantillas a un fichero.

¡Envíame tus plantillas!, encantado las añadiré al sitio web de Jif.


--------------------------------------------------------------------------------
Enviar comentarios, informes de errores, agradecimientos(!) a:

silver.slade@tiscalinet.it
--------------------------------------------------------------------------------
