Lamb� 1.

---------
CONTENIDO
---------
1. Introducci�n
2. Pasos para importar los rtf
3. Interface
4. Importar
5. Exportar
6. B�squeda inteligente
7. Buscar relaciones
8. Opciones
8.1. General
8.2. Buscar
8.3. Importar
9. Drag & Drop
10. Par�metros
11. Instalaci�n
12. Desinstalaci�n
13. Archivos
14. Problemas conocidos
15. Requerimientos

===============
1. Introducci�n
===============
Lamb� permite importar la informaci�n contenida en los archivos index.rtf e
index2t.rtf de Ardalambion (http://www.uib.no/People/hnohf) para que la b�squeda de
palabras sea m�s r�pida y f�cil. Estos archivos contienen la informaci�n de
Etymologies (palabras en �lfico, su ra�z y su lenguaje). Adem�s el archivo
resultante ocupa (archivos con extensi�n etm) menos que el total de los rtf.

==============================
2. Pasos para importar los rtf
==============================
El paso 2 puede saltearse en la mayoria de los casos sin causar problemas.

1. Bajar index.rtf e index2t.rtf

http://www.uib.no/People/hnohf/index/index.rtf
http://www.uib.no/People/hnohf/index2/index2t.rtf
2. Ir a las opciones de Importar (men� Ver, Opciones/Importar).
2.1. Verificar que "Tratar casos especiales" est� activado (si ustedes no lo
cambiaron, por default est� activado).
2.2. Cambiar si se quiere los colores que se le van a asignar a las entradas
importadas haciendo click sobre alguno de los botones con los colores de los
lenguajes.
3. Importar uno de los rtf (el orden no importa) (men� Archivo, Importar). Nota:
Los rtf no deben ser renombrados.
4. Importar el rtf restante. Ac� el programa les pregunta si quieren agregar las
entradas a las que ya existen, contesten que si.
5. Grabar las entradas a un archivo etm.

============
3. Interface
============
Haciendo click sobre el encabezamiento de alg�n campo la lista se ordena
alfab�ticamente de acuerdo al campo elegido y pulsando el bot�n derecho del mouse
sobre la grilla permite cambiar el color de las entradas seleccionadas o
eliminarlas, tambien desde este men� se puede buscar o buscar relaciones,
La selecci�n de una entrada se hace clickeando sobre la misma, para seleccionar a
m�s de una se selecciona la primera entrada y: a. Dejando apretado el boton del
mouse se arrastra hasta seleccionar todas las entradas que se quiere; b. Se
selecciona otra entrada mientras se presiona shift.

===========
4. Importar
===========
Para procesar los datos desde index.rtf e index2t.rtf y llevarlos al formato de la
aplicaci�n se importa cada uno de ellos por separado.
Las entradas con errores y las duplicadas quedan en errores.txt y dups.txt en el
directorio actual.

El parrafo que sigue es el formato que debe presentar el archivo a importar, no es

necesario leerlo a menos que tengan muchas ganas:
Para que el programa importe el contenido de los archivos .rtf, estos deben tener
cierta estructura, que es la presente en index e index2t:
Se pasa por alto toda informaci�n hasta encontrar una l�nea que sea igual a "-A-",
a partir de ah� todo se consideran entradas etimol�gicas a excepci�n de l�neas
vac�as, l�neas que s�lo contengan espacios en blanco o comiencen con un signo menos
"-".
Una l�nea de texto puede contener una o m�s entradas, separando estas con un punto
y coma ";". Adem�s se considera lo que se encuentra entre par�ntesis como
comentarios, pudiendo estos anidarse.
Una entrada consiste de tres campos: <palabra> (<lenguajes>) <ra�ces>.
<palabra> y <ra�ces> pueden tener comentarios, no as� <lenguajes>.

index.rtf e index2t.rtf tienen algunas entradas que no presentan este formato, la

mayor�a son desechadas como errores, pero algunas son aceptadas como v�lidas,
quedando (generalmente en <ra�ces>) datos err�neos. Para tomar en cuenta estas
entradas tiene que estar activada la opci�n "Tratar casos especiales" en las
opciones del programa (men� Ver, �tem Opciones). Por default esta opci�n esta
activada.

===========
5. Exportar
===========
Exportar permite grabar el contenido de un archivo en un archivo .rtf, quedando la
lista de entradas ordenada por el campo palabra, o en un archivo de texto separando
cada columna por una tabulaci�n pudi�ndose luego importar a cualquier otro programa
que soporte dicho formato.

==============================
6. Buscar/B�squeda inteligente
==============================
Esta b�squeda no es tan inteligente, considera una palabra igual a otra sin tomar
en cuenta los acentos, di�resis o circunflejos que puedan tener las vocales de las
palabras y tomando �=n y c=k.

====================
7. Buscar relaciones
====================
Esta b�squeda toma la entrada seleccionada y busca todas las entradas cuya ra�z o
ra�ces tengan una de las ra�ces de la entrada seleccionada. Por ejemplo: si la
entrada seleccionada es "Mablung (Dor) MAP,LUG1" entre otros resultados encontramos
"hand (Dor) LUG1" y "heavy (Dor) MAP" (Mablung es "El de la mano pesada").

===============
8. Ver/Opciones
===============
El bot�n "Guardar" graba las opciones actuales para que el programa las lea al
iniciarse el programa, de lo contrario la configuraci�n actual se perder� al salir
del programa.

================
8.2. Integraci�n
================
Pulsando sobre "Asociar .etm con la aplicaci�n" se pueden abrir luego los
.etm haciendo doble click desde el explorador, pudiendo elegir entre dos hermosos
�conos para los archivos .etm.

============
8.3. General
============
"No mostrar errores de lang.txt" es para no mostrar una ventana de error
cuando el programa se inicia y no puede leer lang.txt (necesario para la opci�n
Archivos/Importar y Ver/Lenguajes). Si este archivo no puede ser leido importar y
lenguajes quedar�n deshabilitados.
Con "Ver entradas largas como hints" chequeada cuando el mouse se pone sobre
un campo de una entrada se muestra todo el texto en otra ventana. El tiempo que se
muestra debajo son lo segundos que se ver� la ventana mostrando la entrada.

===========
8.4. Buscar
===========
Si se chequea la opci�n de guardar las �ltimas cadenas buscadas (por default
est� chequeada) estas aparecer�n en el di�logo de Buscar cuando se reinicie el
programa.

=============
8.5. Importar
=============
Si se van a importar los archivos de Ardalambion se debe dejar activado
"Tratar casos especiales" para as� tratar adecuadamente ciertas entradas escritas
en forma diferente a las dem�s. En la parte de colores se pueden elegir los colores
de los diferentes tipos de entradas.

==============
9. Drag & Drop
==============
Lamb� hace uso de drag & drop - presionar sobre algo con el mouse y
manteniendo apretado el bot�n, arrastrarlo hacia el lugar donde quiere usarse y
luego soltar el bot�n del mouse. Por ahora la �nica acci�n soportada mediante drag
& drop es con archivos etm. Por ejemplo; se selecciona un archivo desde el
explorador de Windows y se suelta sobre la ventana de Lamb�, cargandolo.
==============
10. Par�metros
==============
Desde la l�nea de comandos puede invocarse a Lamb� para que cargue autom�ticamente
un archivo luego de inicializarce. El comando:

lambe.exe <archivo>

Cargar� <archivo> luego de cargarse el programa.

===============
11. Instalaci�n
===============
Con solo descompactar el zip en un directorio, el programa est� instalado. Dentro
de Ver/Opciones/Integraci�n se puede asociar los archivos etm al programa, as�
estos pueden ejecutarse desde el explorador.

==================
12. Desinstalaci�n
==================
Hay que borrar el directorio donde est� el programa. El �nico rastro que va a
quedar es la asociaci�n de los etm y algunas entradas en el registro.

============
13. Archivos
============
lambe.exe El programa
etm.txt Explicaci�n del formato etm, desde la versi�n 1.0 hasta la
versi�n actual (2.1)
lang.txt Los posibles lenguajes de una entrada y el texto de Ver/Lenguajes
especial1.txt Casos especiales para cuando se importa index.rtf
especial2.txt Casos especiales para cuando se importa index2t.rtf
leeme.txt Este archivo

=======================
14. Problemas conocidos
=======================
1. El algoritmo que procesa las entradas no tiene en cuenta ciertos casos
especiales presentes en los archivos rtf, quedando en la parte de la ra�z
informaci�n media rara (o nada).
2. Las entradas con errores son alrededor de 140.
3. Cuando se quiere ver las entradas ordenadas por otro campo es bastante lento.
4. Por ahora no hay soporte para deshacer la asociaci�n de etm y las entradas del
registro.
5. Importar es medio lento.
6. Falta terminar/corregir el texto de Ver/Lenguajes (pedido prestado de
Ardalambion).
10. El punto anterior est� mal enumerado.
11. El punto anterior en esta versi�n no refleja la realidad, pero se deja por
razones de compatibilidad con versiones anteriores.

==================
15. Requerimientos
==================
El programa necesita tener instaladas las fuentes Tahoma y Tolkien. Con el
programa va la �ltima fuente, Tahoma no la incluyo porque creo que ya viene con
Windows. Para instalarla hay que copiarla a windows\fonts.
Se necesita COMCTL32.DLL 4.70 o m�s nuevo pero ya lo deben tener instalado.

Cualquier bug, problema, comentario, sugerencia, etc, etc mandarlo a:

Luis Parravicini
nmuner@satlink.com