@DATABASE "Adagis v4 Guide Español" @WORDWRAP @NODE "Main" "Adagis v4.1" @TOC "MAIN" @{b}@{" Adagis v4.1 " LINK New_Adagis_Logo.iff/main}@{ub} @{ub} @{" Nuevo en la v4.1 " LINK "New"} © 1996 Esteve Boix @{" Sobre Adagis " LINK "What is Adagis"} @{" Instalación " LINK "Install"} @{" Usando Adagis " LINK "How it works"} @{" Historia " LINK "History"} @{" Por hacer " LINK "To do"} @{" Distribución / Renúncia " LINK AFD-COPYRIGHT/Main} @{" Gracias... " LINK "Thanks"} @{" Sobre el autor " LINK "About"} Este software está sujeto al "Standard Amiga FD-Software Copyright Note". Es @{b}Cardware/Mailware@{ub} como está definido en el parrafo 4c/4b. Para más información, por favor, lea "AFD-COPYRIGHT" (Versión 1 o mayor). Para registrarte, debes mandarme un eMail o una postal con tu nombre. Entonces yo te mandaré tu código de registro personal. Podrás crear tu llave usando el programa 'MakeKey.esp' (cajón Install). Evidentemente el registro es absolutamente GRATIS. Adagis mostrará de vez en cuando un requester pidiéndote que te registres. No hay características inhabilitadas si no estás registrado. @ENDNODE @NODE "New" "Nuevo en Adagis v4.1" @TOC "MAIN" @{b}Nuevo en la v4.1@{ub} -Un par de bugs eliminados -Nuevo menú 'Copiar al clipboard'. -La lista que muestra los refranes es el objecto activo por defecto, de forma que puedes usar las teclas directamente para desplazarte. -El error de 'Fuera de rango' no deberia aparecer más. -Mejorada la generación de números aleatorios. -Nuevo logotipo para Adagis :-). @ENDNODE @NODE "What is Adagis" "Qué és Adagis" @TOC "MAIN" @{b}Qué és Adagis ?@{ub} Bien, Adagis es un programa tipo "Galleta de la fortuna". Su propósito es mostrar un refrán (adagio) en una ventana del WB. Los adagios se encuentran en un fichero de texto. Adagis escoje uno aleatoriamente (o no) y lo muestra. Esta es una descripción simple. Sigue leyendo ! @ENDNODE @NODE "Install" "Instalación" @TOC "MAIN" @{b}Instalación@{ub} Sencillo: Ejecuta el programa de instalación, y sigue las indicaciones. AmigaTechnologies recomienda tener todos los datos de un programa en un solo cajón. Con esta versión de Adagis he intentado seguir esa recomendación, de forma que el instalador creará un cajón 'Adagis4'. Este cajón contiene los AddOns, el programa de preferencias, etc... En el futuro es posible que algunas características de Adagis funcionen a través de 'AddOns', con lo cual será más importante tener el programa bien ordenado. Nota: Para aquellos que no miran nada al instalar. He decidido cambiar el sistema de distribución de Adagis: Ahora viene en dos ficheros: El primero es 'Adagisv40_bin.lha'. Este contiene el programa, las librerias, la instalación, los iconos, etc... El segundo es 'Adagisv10_dat.lha'. Este segundo paquete contiene ficheros de refranes. He adoptado este método porque así se evita bajar una y otra vez los refranes en cada nueva versión de Adagis. Los números de versión són diferentes porque una nueva versión de Adagis no implicará una nueva versión de los datos. @ENDNODE @NODE "How it works" "Usando Adagis 4" @TOC "MAIN" @{b}Usando Adagis@{ub} Para usar Adagis necesitas: -AmigaDOS v2.0+ (2.1+ -v37- requerido para usar la locale.library) -MUI v3.2+ @{" Usando Adagis " LINK "Usage"} @{" El ficheros de refranes " LINK "Adagis.data"} @{" AdagisPrefs " LINK "AdagisPrefs"} @{" Adagis desde CLI " LINK "CLI"} @{" AddOns " LINK "AddOns"} @{" Interface ARexx " LINK "ARexx"} @{" Notas técnicas " LINK "Tech"} @ENDNODE @NODE "CLI" "Ejecutando Adagis desde CLI" @TOC "How it works" @{b}Ejecutando Adagis desde CLI@{ub} Adagis puede ser ejecutado desde el CLI. En ese caso se supone que quieres usar Adagis a través de su puerto Rexx, por lo que NO ABRIRÁ GUI. Como cualquier aplicación MUI, Adagis es una 'comodity', por lo que puedes salir usando una aplicación tipo 'Exchange'. @ENDNODE @NODE "ARexx" "Interface ARexx de Adagis v4" @TOC "How it works" @{b}Interface ARexx de Adagis@{ub} Adagis 4 incorpora un interface ARexx. El puerto es 'ADAGIS.X', donde X=1,2,3... De momento, Adagis soporta los siguientes comandos: GET_OFFSET OFFSET Obtiene un refrán por su offset en el fichero. GET_ORDINAL POSITION Obtiene un adagio por su posición ordinal en el fichero. GET_RANDOM Obtiene un adagio aleatoriamente (el modo depende del AddOn actual). CURRENT_OFFSET Devuelve el offset del adagio actual. Depende también del AddOn actual. Evidentemente, Adagis reconoce los comandos estándard del MUI: QUIT / FORCEQUIT Sale de Adagis. HIDE Iconifica Adagis. SHOW Desiconifica Adagis. Nota: SHOW y HIDE no harán efecto si Adagis corre sin ventana. Hay un par de ejemplos incluidos en la distribución del programa. Són muy sencillos, pero sirven para ver cómo funciona Adagis a través del ARexx. Adagis_CLI.rexx: Adagis debe estar en la memoria. Simplemente muestra varios refranes en el Shell actual. Adagis_WB.rexx: Este carga Adagis y lo usa para mostrar un refran en una ventana del WB. @ENDNODE @NODE "AddOns" "AddOns de Adagis v4's" @TOC "How it works" @{b}AddOns de Adagis 4@{ub} Adagis 4 soporta (y requiere) los llamados AddOns. Un AddOn es un trozo de código (una libreria estándar) que es capaz de leer ficheros de refranes. Cada AddOn lee un formato de fichero distinto. El proceso de instalación te pide qué AddOn quieres usar, pero los instala los dos. Por ahora, sólo hay 2 AddOns, pero más pueden aparecer en el futuro. Realmente depende de los usuarios (como es normal). Estos 2 AddOns són: Adagis_adagis.addon: Este lee el formato propio de Adagis. No está integrado en el programa porque eso haría el ejecutable de Adagis más largo, y lo encuentro innecesario. El formato de búqueda por defecto es 'Offset'. Adagis_IC.addon: Con este AddOn puedes usar el formato IntuiCookie con Adagis. IntuiCookie es un programa de galletas de la fortuna de Christian Kemp. Todos los códigos de formato son filtrados, excepto el '--'. El AddOn usa por supuesto el fichero Hash de IC, de forma que acceder un adagio por su número es mucho más rápido con este formato/AddOn que con el propio de Adagis. El modo de búsqueda por defecto es 'Ordinal'. De hecho, el modo 'Offset' está desactivado en este AddOn. El fichero hash DEBE llamarse igual que el fichero de refranes con la extensión '.hash' (sin las comillas). Gracias a Christian Kemp por su ayuda, y por dejarme hacer este AddOn. Notas: -Cada AddOn tiene su modo por defecto de búsqueda. Es posible que, debido al formato de un fichero, no todos los modos de búsqueda estén disponibles, -Es possible que el AddOn dé un error de 'fuera de rango'. Significa que has intentado obtener un refrán que no se puede encontrar en el fichero. @ENDNODE @NODE "Tech" "Notas técnicas" @TOC "MAIN" @{b}Notas técnicas@{ub} -Al contrario que las versiones anteriores de Adagis, la v4 no almacena todo el Adagis.data en memoria. La ventaja más evidente es que el uso de RAM se reduce mucho, da igual el tamaño del fichero de refranes. Aún así, el método que usa ahora Adagis tiene el problema (?) que no puede saber el número del refrán que está mostrando ni el total de refranes que contiene el fichero. Esto sólo es aplicable al AddOn 'adagis_adagis.addon'. -Cuando Adagis escoje un refrán, accede a él de forma instantánea y muestra su offset (posición) en bytes. Esto es aplicable al AddOn 'adagis_adagis.addon'. El offset en el 'adagis_ic.addon' es la posición del adagio en el fichero. -Si quieres visualizar un refrán concreto lo puedes hacer, pero el acceso puede ser terriblemente lento, ya que Adagis no tiene información sobre la posición de los refranes en el fichero y tiene que buscar línea por línea. Esto sólo es aplicable al AddOn 'adagis_adagis.addon'. -Adagis pone su prioridad a -1 automáticamente. -Si especificas un refrán por su posición en bytes, observarás que Adagis no va exactamente a esa posición. Lo que hace es buscar el primer refrán a partir de la posición que tú le indicas. -Tengo que admitir que el código de control de tiempo de Adagis 4 es lamentable. Esta es la razón por la cual Adagis pone su prioridad a -1. Esto va a cambiar en el futuro. @ENDNODE @NODE "Usage" "Usando Adagis" @TOC "MAIN" @{b}Cómo usar Adagis@{ub} La ventana principal de Adagis v4 se divide en dos páginas. @{u}Adagis@{uu}: Es casi idéntica al GUI de las versiones 2.x/3.x. Adagis selecciona un refrán y lo muestra en la lista. Entonces espera un tiempo proporcional al número de líneas del refrán y sale. Esta página contiene 3 botones: Congelar: Si Adagis está congelado no saldrá hasta que pulses 'Salir'. Más: Adagis escogerá un nuevo refrán y lo mostrará. El modo de búsqueda depende del AddOn. Salir: Es evidente, no ? La seguna página contiene sólo el 'Acerca de...' de Adagis v4. La mayoría de características de Adagis v4 se encuentran en los menús del programa: @{u}Proyecto:@{uu} Sobre Adagis : Hace falta ?. Sobre el AddOn: Muestra información del AddOn que Adagis está usando para interpretar el fichero de refranes. Iconificar: Iconifica el programa (también congela Adagis). Salir: ... @{u}Varios:@{uu} Analizar fichero: Esta función analiza el fichero de refranes y muestra información sobre el mismo. Esta función puede llevar su tiempo. Grabar refrán: Graba el refrán actual en un fichero. Un requester ASL pedirá el nombre del fichero en el cual quieres grabarlo. Navegación: Abre la ventana de navegación. @{u}Preferencias:@{uu} MUI: Abre la ventana de preferencias MUI para Adagis. AdagisPrefs: Ejecuta el programa de preferencias AdagisPrefs. Ver @{" Configurando Adagis (AdagisPrefs) " LINK "AdagisPrefs"} Cargar preferencias: Cierra la ventana de Adagis, lee la configuración de nuevo y la vuelve a abrir. La ventana Navegación contiene 3 páginas: Ordinal: Te permite buscar los refranes por su posición ordinal en el fichero (1º, 2º...). Ten en cuenta que -según el AddOn- este modo de búsqueda puede tomar su tiempo. Los valores válidos van de 0 a Número de Refranes-1. Offset: Te permite buscar los refranes por su posición en bytes (offset) en el fichero. Navegación: Adagis recuerda los refranes que has visualizado desde que ejecutas el programa. Esta página contiene un slider que te permitirá 'navegar' por estos refranes. @ENDNODE @NODE "Adagis.data" "Adagis.data file" @TOC "MAIN" @{b}El fichero Adagis.data@{ub} Este fichero contiene los refranes. Es un fichero ASCII puro, por lo que lo puedes editar con tu editor favorito de textos. Su estructura es muy simple: >>Adagis<< # Refrán 1 # Refrán 2 # Refrán 3 # . . . # Refrán N Cada refrán va precedido de '#'. Personalmente intento que las líneas no sobrepasen los 48 carácteres, pero por supuesto Adagis puede manejar cadenas considerablemente más largas. No juegues con este fichero, ya que puedes colgar fácilmente el programa. Nota: Este formato es que que lee/analiza el AddOn 'Adagis_adagis.addon'. Si planeas usar otro formato (sólo el de IntuiCookie está disponible) te remito al documento del programa en cuestión. @ENDNODE @NODE "AdagisPrefs" "AdagisPrefs" @TOC "MAIN" @{b}Configurar Adagis con AdagisPrefs@{ub} Adagis es un programa MUI, de forma que puedes configurar casi cualquier cose, Te recomiendo que uses fuentes grandes para la lista, 14 o 15 puntos, ya que la hacen más 'leible'. Puedes configurar algunos aspectos del programa a través del programa AdagisPrefs. Este programa es realmente sencillo de utilizar. Sólo debes tener en cuenta: -Es NECESARIO especificar un AddOn, ya que sin él, Adagis es incapaz de funcionar. -Es NECESARIO especificar un fichero de refranes (obvio, no ?) -Cuidado con 'Crear/No crear GUI'. Debe estar en 'Crear'. Usalo solo si planeas usar Adagis a través del puerto ARexx. Ver @{" Interface ARexx " LINK "ARexx"}. -Para encontrar el programa AdagisPrefs, Adagis usa el tooltype 'ADAGISPREFS'. Modificalo si mueves 'AdagisPrefs' de su lugar de instalación. Por ahora, Adagis no detecta si has cambiado la configuración. Esto va a cambiar probablemente en una versión futura del programa. De momento, puedes usar el menú 'Cargar preferencias' para releer la configuración sin tener que salir del programa. @ENDNODE @NODE "History" "Historia" @TOC "MAIN" @{b}Historia@{ub} v0.1...0.9: Nunca vieron la luz. Eran versiones ß. v1.0...1.8: Poca gente las vió. Usaban la gadtools.library. v2.1: Primera versión MUI. Dejada en Aminet. Configurable por Tooltypes. v2.2: Cambios internos. Nunca vió la luz. No la subí a Aminet debido a la inminencia de la v3. v3.0: Requiere MUI 3.2+. Adagis.data no se carga en RAM. Fichero de refranes en inglés incluido. Subida a Aminet. v3.1: Tooltype AUTHOR Ventana 'Saltar a...' Cambios internos v3.2: Tooltype ADAGISFILE Tooltype CLOSEWINS Adagis puede grabar el refrán actual en un fichero Nueva ventana/característica 'Navegar' Las ventanas de Adagis no bloquean el programa Cambios internos Algunos bugs eliminados v3.2a: No subida a Aminet. Algunos cambios menores (referentes al GUI). v4.0: Nuevo GUI, sin usar el MUIBuilder. Nueva función: AddOns. Adagis incorpora comandos Rexx. Adagis puede correr sin GUI. La lista de Adagis es un objecto Floattext. Programa de preferencias. v4.0b: Algunos bugs corregidos. Algunos cambios internos. Partes del código optimizadas. Pequeños cambios en la distribución. v4.1 Algun bug eliminado Nueva función 'Copiar al clipboard' Nuevo logo :-) Mejor generación de # aleatorios. @ENDNODE @NODE "Thanks" "Gracias" @TOC "MAIN" @{b}Gracias a...@{ub} -Anna: Por la mayoria de adagios en catalán para Adagis. -Christian Kemp: Por su ayuda, por los mails, por ser betatester y por dejarme hacer el AddOn de IC. -Michael Misfud: Por parte del fichero de adagios en inglés y por la postal. -Mike Carlin: Por parte del fichero de adagios en inglés, por el icono y por hacer de betatester. -Víctor Carceler: Por hacer de betatester. -Víctor Garcia Valero: Por las sugerencias y por el fichero de 500 chistes para el Adagis :-) -Dietmar Knoll: Por el texto AFD-Copyright. -Wouter van Oortmerssen: Por el AmigaE !!! Gracias también a los usuarios que me han mandado postales ! @ENDNODE @NODE "About" "Sobre el autor" @TOC "MAIN" @{b}Sobre el autor@{ub} Como es usual, necesito 'realimentación' de los usuarios. Las contribuciones son muy importantes para mi, ya que me ayudan a encontrar la forma de mejorar Adagis. Por favor, envia sugerencias, críticas, ideas, postales y demás a: Esteve Boix Sánchez C/Alcalde Armengou n11 7-1 08240 Manresa (Barcelona) Spain Me puedes encontrar en la siguiente dirección e-mail: axe@arrakis.es Adagis v4 ha sido programa completamente en AmigaE v3.2e, de Wouter van Oortmerssen, en un Amiga 3000 con 68030+882 25Mhz, 18Mb RAM, HD SCSI 540 MB y CyberVision64. @ENDNODE @NODE "To do" "To do" @TOC "MAIN" @{b}Por hacer en Adagis@{ub} Algunas cosas que se pueden añadir al programa: -Versiones no MUI: No soy muy propenso a ellas, pero si alguien lo quiere y me lo dice, se puede hacer. -Añadir más características del MUI 3.2: Buf... No sé... Burbujas de ayuda ? Para Adagis ??? -Hacer que Adagis "hable" los refranes: Realmente, ya añadí esta característica y, aunque necesitaba retoques, funcionaba correctamente, pero no me gustaba y por eso al final no lo incluí. Seguramente Adagis v4.1 incorporará una función de 'hablar'. -Cambiar el código de control de tiempo. -Adagis recibirá una señal cuando el usuario cambie las preferencias, de forma que el menú 'Releer prefs' desaparecerá. La v4.2 incluirá seguramente: -Un memú 'Hablar'. -Un nuevo AddOn. Como es usual, espero sugerencias e ideas... @ENDNODE