@DATABASE "Adagis v3 Fichero Guide Español" @NODE "Main" "Adagis v3" @TOC "MAIN" @{b} Adagis v3.0 @{ub} © 1996 Esteve Boix @{" Qué es Adagis " LINK "What is Adagis"} @{" Instalación " LINK "Install"} @{" Cómo funciona ? " LINK "How it works"} @{" Historia " LINK "History"} @{" Por hacer " LINK "To do"} @{" Distribución/Renuncia " LINK "Distribution"} @{" MUI " LINK "MUI"} @{" Gracias... " LINK "Thanks"} @{" Sobre el autor " LINK "About"} @ENDNODE @NODE "What is Adagis" "Qué és Adagis ?" @TOC "MAIN" @{b}Qué és Adagis ?@{ub} Bien, Adagis se puede describir como un programa del tipo "Galleta de la Fortuna". Su propósito es escojer un refrán al azar de un fichero y mostrarlo en una ventana del Workbench. Los refranes se encuentran en el fichero "Adagis.data". Adagis escoje uno al azar (o no) y lo muestra en pantalla. @ENDNODE @NODE "Install" "Instalación" @TOC "MAIN" @{b}Instalación@{ub} Simple: Sólo ejecuta el programa Install.esp (o Install.cat para catalán). Lamentablemente, nadie me ha enviado refranes en español, de forma que no hay Adagis.data en español. Si alguien me envia, los incluiré en la próxima versión del programa (si hay, claro :). @ENDNODE @NODE "How it works" "Cómo funciona" @TOC "MAIN" @{b}Cómo funciona@{ub} Para usar Adagis necesitas: -AmigaDOS v2.0+ (2.1+ si quieres usar la locale.library) -MUI v3.2+ @{"Cómo usar el programa" LINK "Usage"} @{"El fichero 'Adagis.data'" LINK "Adagis.data"} @{"Configurando Adagis" LINK "Config"} @{"Técnico" LINK "Tech"} @ENDNODE @NODE "Tech" "Cosillas técnicas" @TOC "MAIN" @{b}Cosillas técnicas@{ub} Al contrario que las versiones anteriores de Adagis, la v3 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. Cuando Adagis escoje un refrán, accede a él de forma instantánea y muestra su offset (posición) en bytes. 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. @ENDNODE @NODE "Usage" "Usando Adagis" @TOC "MAIN" @{b}Cómo usar el programa@{ub} Adagis v3 tiene dos páginas MUI. La primera es 'Adagis', y es (casi) identica al GUI de las versiones 2.x. Adagis selecciona un refrán y lo muestra en una lista. Entonces espera un tiempo proporcional al número de líneas y sale al DOS. Puedes hacer que Adagis espere para siempre pulsando 'Esperar'. Pulsando 'Esperar' de nuevo 'descongelas' el programa. Si pulsas 'Más', Adagis escojerá otro refrán y lo mostrará. 'Salir' no requiere explicación, no ? La seguna página, 'Varios', es nueva, y contiene (por ahora) 4 botones: 'Configuración MUI': Ejecuta el MUI-Prefs para Adagis v3. 'Ver refrán #': Permite especificar qué refrán quieres ver. Recuerda que para ficheros grandes, el acceso puede ser MUY lento. 'Sobre Adagis.data': Analiza el fichero de refranes y muestra alguna información sobre el mismo. Puede tardar algo de tiempo. 'Sobre Adagis v3': Muestra información sobre el programa. @ENDNODE @NODE "Adagis.data" "El fichero Adagis.data" @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. @ENDNODE @NODE "Config" "Configuración" @TOC "MAIN" @{b}Configurando Adagis@{ub} Adagis es un programa MUI, de forma que puedes configurar casi cualquier cosa. Sólo te puedo recomendar que uses fuentes grandes para la lista, de forma que los refranes sean más fáciles de leer. Puedes variar también algunos valores con tooltypes: DELAY=# Tiempo de espera por línea en milisegundos (1000=1seg). PROB=# Si este valor es 100, el programa arrancará cada vez que lo ejecutes. Si es 50, tendrás el 50% de posibilidades de que arranque. CENT Si este Tooltypes está presente, las líneas del refrán aparecerán centradas en la lista. AUTOFREEZE Si está presente, AutoFreeze hace que Adagis no salga al Workbench automáticamente. USEBIGFONT Si está, Adagis usa la fuente grande (Big Font) definda en las MUI-Prefs para mostrar los refranes. @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: Esta versión :-) Requiere MUI 3.2+. Adagis.data no se carga en RAM. Fichero de refranes en inglés incluido. Subida a Aminet. @ENDNODE @NODE "Distribution" "Distribución" @TOC "MAIN" @{b}Distribución@{ub} Este software está sujeto al "Standard Amiga FD-Software Copyright Note". Es Cardware como está definido en el parrafo 4c [...] Para más información, por favor, lea "AFD-COPYRIGHT" (Versión 1 o mayor). Por favor, si creas un fichero de refranes ponte en contacto conmigo. Me gustaria distribuir Adagis con muchos más refranes que los que tengo. --------------------------------------------------------------------- $VER: "AFD-COPYRIGHT.es"(TM) Spanish Version 1.2 (27.02.96) __ __ *====================================* __ __ / // / * Standard Amiga FD-Software * / // / / // / * Copyright Note (TM) * / // / / // / *====================================* / // / __ __ / // / * * __ __ / // / \ \\ \/ // / * Versión 1.2 - Español * \ \\ \/ // / \ \\/ // / * 27-Feb-1996 * \ \\/ // / \ / // / * * \ / // / """ "" *====================================* """ "" 0. INTRODUCCIÓN =============== Si es un usuario espero que le guste esta Nota Estándard de Copyright para Software de Amiga® Libremente Distribuible ("Standard Amiga FD-Software Copyright Note"), sólo tendrá que leerlo una vez, en vez de las notas individuales. Hay versiones traducidas de este documento disponibles en Aminet® bajo el nombre: /pub/aminet/docs/misc/AFD-Files1-xx.lha (xx = número de lenguajes). Si es un desarrollador de software y quiere incluir este documento en su porpio paquete de programas libremente distribuibles, por favor, lealo cuidadosamente, especialmente el capitulo 5 "INFORMACIÓN PARA DESARROLLADO- RES". Gracias por su soporte. 1. COPYRIGHT ============ a. Este software tiene todos los derechos reservados por su(s) desarrolladore(s). Esto implica que NO ESTA PERMITIDO modificar el(los) programa(s) y la documentación de ningun modo. Especialmente NO SE DEBE QUITAR la documentación o este fichero de texto. b. NO ESTA PERMITIDO usar este software a cualquiera de sus partes para ningún proposito que el mencionado en su documentación , esto incluye las fuentes, imágenes o sonidos. Si el(los) desarrollador(es) no incluye el código fuente del(de los) programa(s) es este paquete, NO ESTA PERMITIDO descompilar ninguna parte de él. 2. DISTRIBUCIÓN =============== Este paquete puede ser libremente distribuible. Esto significa que esta permitido redistribuirlo mientras se sigan los siguientes puntos: a. Cualquier re-distribución tiene que incluir todos los ficheros en este archivo, incluyendo este fichero "AFD-COPYRIGHT", sin ninguna modificación. NO esta permitido añadir ningún fichero al archivo. b. Este paquete puede ser libremente distribuido via BBSs, InterNet/UseNet, coloecciones de SW como Fred Fish y CD-ROM de Aminet®, y otros canales electronicos similares. c. Revistas en disco y servicios que cargen por la transferencia de ficheros !NO pueden distribuirlo sin el permiso escrito del(de los) desarrollador(es)!. 3. RENUNCIA (DISCLIMER) ======================= Por el uso de este producto acepta TODAS las responsabilidades de cualquier daño o perdida que pueda ocurrir en el trancurso de su uso o por la incapacidad de usarlo. El(los) desarrollador(es) del software y el autor y el traductor de esta "Copyright Note" NO pueden ser responsabilizados. IMPORTANTE: !!!El autor y los traductores de esta "Copyright Note" NO dan ninguna garantía de calidad y utilidad de NINGÚN producto que se atenga a esta nota!!!! Algunos nombres usados en este texto son marcas comerciales o registradas. El uso de estos nombres en este documento no implica que su uso sea libre. 4. COMPENSACIONES ================= "Libremente Distribuible" sólo indica que no tiene que pagar por el copiado o redistribución del software. Está permitido probar este producto por 30 días. Si le gusta y decide usarlo regularmente, la mayoría de los desarro- lladores quieren algo en compensación a sus esfuerzos. En la documentación de este software está una clasificacion de las siguientes: a. Freeware - Está permitido usar este software GRATIS. b. Mailware - Se tiene que mandar un MENSAJE al(os) desarrollador(es) por correo electrónico o habitual. c. Cardware - Se tiene que mandar una TARJETA POSTAL al(os) desarrollador(es). d. Donationware - Se tiene que hacer una DONACIÓN a una organizacián de las indicadas en la documentación del producto. g. Giftware - Se requiere del usuario que mande un REGALO al(os) desarrollador(es), por ejemplo: - algunos caramelos o - un paquete de discos o - una copy de un programa propio o - algo de dinero o - un Amiga 5000 PowerTower ;-) s. Shareware - Se tiene que mandar al(los) desarrolladores la cantidad de DINERO demandada en la documentación. 5. INFORMACIÓN PARA DESARROLLADORES =================================== El concepto de una "Licencia Estándar" como esta tiene varias ventajas: - Como desarrolador no tiene que pensar sobre los derechos usted mismo. - Los usuarios de su producto sólo tendrán que leerlo si no lo han hecho antes. - Este documento está disponible en varios lenguajes via Aminet®. Así podrá asegurar que los usuarios lo han leido al menos una vez y lo han comprendido. Si quiere incluir "AFD-COPYRIGHT"(TM) en sus en sus paquetes de software Amiga® L.D. tiene que seguir las siguientes normas: a. Lea este documento en su totalidad cuidadosamente y asegurese de que está de acuerdo con todo lo mencionado en el texto SIN EXCEPCIONES. (Si no está de acuerdo con algo, ¡no lo use!. Le esta permitido copiar partes de él, pero si lo hace NO DEBE usar los nombre "AFD-COPYRIGHT"(TM) y "Standard Amiga FD-Software Copyright Note"(TM).) b. Asegurese de que usa las siguientes herramientas por defecto en los ficheros .info que va a poner en el paquete: - para texto ASCII: More - para documentos AmigaGuide®: AmigaGuide - para scripts AmigaOS: IconX - para scripts ARexx: RX - para ficheros de configuración: Ed - para scripts Installer: Installer - para imagenes IFF-ILBM: Display (La idea de esta norma fue inspirada por Osma "Tau" Ahvenlampi, Finlandia). Fué incluida para establecer un estandar. ¡Si álguien no usa estas herraminetas no tiene que hacer mas que un enlace por tipo de fichero!) c. Incluir un párrafo como el siguiente en el manual de su producto: ------8<------------------------------------------------------------------- Este software está sujeto al "Standard Amiga FD-Software Copyright Note". Es como está definido en el parrafo 4. [...] Para más información, por favor, lea "AFD-COPYRIGHT" (Versión 1 o mayor). ------8<------------------------------------------------------------------- Ejemplo: Este software está sujeto al "Standard Amiga FD-Software Copyright Note". Es SHAREWARE como está definido en el parrafo 4s. Si le gusta y lo usa regularmente, por favor, mande $15 a ... Para más información, por favor, lea "AFD-COPYRIGHT" (Versión 1 o mayor). d. Tiene que incluir este fichero llamado "AFD-COPYRIGHT"(TM) (Inglés). Si incluye documentación en formato hypertexto AmigaGuide® puede enlazar a este fichero o incluirlo completo en el fichero AmigaGuide® como usted quiera. Por favor no añada más de dos traducciones de este fichero a su paquete, así no crecerá demasiado de tamaño. 6. AUTORES ========== "AFD-COPYRIGHT"(TM) fue escrito por Dietmar Knoll. Está sujeto esta misma Nota de Información de Copyright (© 10.12.1994, 27.02.1995). Si tiene algún comentario, pregunta o alguna sugerencia para la siguiente versión, por favor escriba a la siguiente dirección: Dietmar Knoll InterNet-Email: To: dknoll@gwdg.de Iltisweg 6 Subject: AFD D-37081 Göttingen WWW-Homepage: ALEMANIA/EUROPA ftp://ftp.gwdg.de/pub/physik1/WWW/GAUHPIL/Welcome.html Los traductores de este documento y sus direcciones están en los ficheros correspondientes. Las traducciones son © de los traductores. La traducción al castellano (español) de este fichero ha corrido a cargo de José Roberto González Rocha (© 15.11.1995, 27.02.1996) José Roberto González Rocha InterNet-Email: alu756@csi.ull.es C/La Cabezada, n4, Valle San Lorenzo Arona, Tenerife WWW-Homepage: Canary Islands http://www.csi.ull.es/alumnado/alu756/ CP 38626 Spain. @ENDNODE @NODE "Thanks" "Gracias" @TOC "MAIN" @{b}Gracias@{ub} Bies... Gracias a: -Anna: Por la mayoría de refranes en catalán de la v3. -Christian Kemp: Por su ayuda. -Josep Rubiralta: ...ejem... Por sus ideas y sugerencias. -Wouter: Por el Amiga_E !!! Gracias a los usuarios de Adagis que me habéis mandado postales y adagios !!! @ENDNODE @NODE "About" "Sobre" @TOC "MAIN" @{b}Sobre el autor@{ub} Por favor, mandad sugerencias, críticas, ideas, regalos, CyberStorms y postales a: Esteve Boix Sánchez C/Alcalde Armengo n11 7-1 08240 Manresa (Barna) España También os podéis poner en contacto conmigo en la siguiente dirección e-mail: axe@arrakis.es Adagis v3 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" "Por hacer" @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 me gustaba y por eso al final no lo incluí. Como es usual, espero sugerencias e ideas... @ENDNODE @NODE "MUI" "Sobre MUI" @TOC "MAIN" @{b}MUI@{ub} Esta aplicación usa MUI - MagicUserInterface. MUI es © 1993/94 Stefan Stuntz. MUI es un sistema para crear y mantener interfaces gráficos de usuario (GUI's). Con la ayuda de un programa de preferencias, el usuario de una aplicación tiene la capacidad de adaptarla a sus gustos. MUI se distribuye bajo el concepto de ShareWare. Para obtener el paquete entero, que contiene muchos ejemplos y más información para registrarse, busca un fichero llamado 'muiXXusr.lha' (XX es la versión) en tu BBS o en discos de dominio público. Si quieres registrarte del MUI, por favor envia: DM 30.- o US$ 20.- a Stefan Stuntz Eduard-Spranger-Straße 7 80935 München GERMANY @ENDNODE