Citorio version 1.1 release 1
Copyright (C) 1995,1996 Javier Cmara Melgosa
  Email: jcamara@jet.es
  WWW: http://www.jet.es/amateur/jcamara
Basado en Pundit, (C) 1990 by Jeff Bienstadt

INTRODUCCIN E INSTALACIN
==========================

Qu es esto?
-------------
Citorio es un programa para Windows que cada cierto nmero de segundos
muestra una ventana con una cita, frase o gracia. Ver "Uso de Citorio" ms
adelante para ms detalles.

Es un programa de 16 bits que funciona en Windows 3.1, Windows 95 y
Windows NT 3.51.

Tambin hay una versin que muestra citas sueltas en MS-DOS.

Licencia
--------
Citorio es FREEWARE - Es todo gratis para t. Puedes usarlo y distriburlo sin
problemas de conciencia, por lo que a m respecta.

El fuente no va aqu, pero realmente no tengo problemas en mandrtelo si lo quieres
y me lo pides a jcamara@jet.es.

De todas formas, si te gusta y tienes correo electrnico, satisface mi ego
mandando un mensaje a jcamara@jet.es.

Las citas contenidas en CITORIO.EXE pueden modificarse... en principio (ver
"Aadiendo citas").
El copyright no incluye ni las citas (que han sido saqueadas de mltiples
fuentes, incluyendo otros programas de citas), ni los iconos.

Ficheros includos
------------------

  LEEME.TXT     Este fichero
  HISTORIA.TXT  Historia de versiones de Citorio
  CITORIO.EXE   Ejecutable de Citorio/Win
  CITORIOD.EXE  Citorio/DOS - saca una cita en MS-DOS
  README.TXT    Instrucciones para usuarios no hispanohablantes
  FILE_ID.DIZ   Descripcin corta para BBSs

Instalacin
-----------

Lo mnimo necesario para usar Citorio es CITORIO.EXE. Si adems deseas
usar Citorio/DOS, copiar CITORIOD.EXE al mismo directorio que
CITORIO.EXE (sto es requerido; no vale copiarlo a otro directorio).

Si te gusta, lo normal es que lo pongas en el grupo de Inicio,
mediante la opcin "Archivo/Nuevo/Elemento de Programa" del
Administrador de Programas; o en Windows 95, desde "Inicio/Configuracin/Barra 
de tareas/Programas del men de inicio/Aadir"

USO DE CITORIO
==============

Descripcin
-----------

Citorio es un programa que peridicamente muestra una ventana con una cita
o frase graciosa o similar en una ventana. Mientras tanto, permanece oculta.
Otras caractersticas son:

  - Lo ms importante: La ventana de Citorio NO CAMBIA LA APLICACIN
    ACTIVA - aparece como una ventana "TOPMOST". O sea, puedes estar p.ej.
    escribiendo; el que Citorio aparezca no te impedir seguir hacindolo. La
    nica molestia es cuando debajo de donde aparece Citorio hay algo
    donde quieras pinchar con el ratn o as.

  - Junto con el texto de la cita se muestra un icono. Las citas estn
    clasificadas por carcter (ver "Las Citas de Citorio", ms
    adelante); para cada clase aparece un icono distinto.

  - Puede seleccionarse uno de los sonidos de Windows que sonar con
    cada cita (ver "Configuracin")

  - Se puede seleccionar un font distinto para el texto de la cita y
    para el nombre del autor (ver "Configuracin")

  - La posicin y ancho de la ventana se guardan de forma que Citorio
    aparece siempre en el mismo sitio. El alto de la ventana se ajusta
    automticamente para que quepa la cita entera.

  - Citorio sabe cules son las ltimas citas que ha mostrado, de
    forma que la siguiente vez no mostrar ninguna de sas. As
    evita el repetirse demasiado. La longitud de la memoria de Citorio
    es el 60% del nmero total de cadenas.

  - El tiempo que la cita permanece visible, y el lapso de tiempo entre citas,
    es configurable en segundos. El tiempo que permanece visible es un rango;
    el tiempo real que permanecer visible depender del alto de la ventana
    necesaria para mostrar la cita.

  - Hay una versin para MS-DOS, CITORIOD.EXE, que lee las citas
    contenidas en el propio CITORIO.EXE y muestra una al azar.

Y adems, es gratis y las citas estn en espaol.

Origen de Citorio
-----------------

Citorio es una mejora de un programa shareware llamado Pundit (C) 1990 by
Jeff Bienstadt. Nunca hubo ms que una versin 1.0 de Pundit, y ya no est
en cica.indiana.edu (ahora ftp.winsite.com), que es donde yo lo encontr.
Yo considero que he mejorado el programa, tanto por dentro como por
fuera, de una forma en que Citorio ya no es Pundit.

Para ver la historia de versiones de Citorio, consulta HISTORIA.TXT

Ejecucin
---------

Ejectalo desde el Administrador de Archivos (con un doble click), desde
la opcin Archivo/Ejecutar del Administrador de Programas o creando un
icono para l en el Administrador de Programas. Lo normal es instalarlo
en el grupo de Inicio. En Windows 95, ejecutarlo desde una caja MS-DOS o 
desde "Inicio/Ejecutar".

Citorio admite un argumento opcional que es un nmero de cita. Eso fuerza a
que la siguiente cita que se muestre sea ese nmero.

Si se ejecuta a Citorio cuando ya es ejecutndose, se mostrar la
ventana de la instancia anterior. Si se ha pasado un nmero de cita como
argumento, se mostrar esa cita directamente.

Citorio no se mostrar si el salvapantallas (estndar de Windows -.SCR- o 
Afterdark) de Windows se est ejecutando, pero s si est maximizada una 
ventana MS-DOS (entonces no se ver, claro).

Si se pincha un men de Citorio, o encima de su barra de ttulo, el temporizador
de Citorio se suspender y no se ocultar.

Cuando Citorio est pausado (el temporizador est desactivado), el ttulo se
muestra entre corchetes.

Aunque inicialmente se muestra como una ventana TOPMOST (o sea que se ve sobre
todas las dems), tras haber interactuado con l (ej. seleccionar un men), dejar
de serlo.

Mens de Citorio
----------------
Los mens son:
  Menu / Configuracin: Ver siguiente apartado
  Editar / Copiar: Copia la cita actual en el portapapeles
  Pausa! / Reanudar! : Permite parar y rearrancar automticamente el temporizador de
       Citorio.
  Luego! : Oculta a Citorio, pero la siguiente vez que se muestre repetir la misma
       cita que actualmente muestra.

Configuracin
-------------

La opcin "Men/Configuracin" de Citorio muestra un dilogo que permite
especificar:

  - El tiempo mximo y mmimo en segundos que una cita permanecer visible. Para cada
    cita se interpola entre ambos segn el alto de la ventana necesaria para mostrar
    la cita.
  - El tiempo en segundos que Citorio permanecer oculto entre citas;
  - El sonido de Windows que sonar cuando aparezca una cita
    (slo puede ser un sonido estndar, no un .WAV cualquiera);
  - Si se muestran o no iconos junto al texto de la cita;
  - El font a usar para pintar el texto de la cita;
  - El font a usar para pintar el texto del autor de la cita.

Adems, Citorio almacena automticamente la posicin y ancho de su ventana.

La configuracin de Citorio se almacena en el fichero CITORIO.INI en el
directorio de Windows. Aqu se almacena tambin la lista de las ltimas
citas mostradas.

Ocultando a Citorio
-------------------

Para que Citorio se oculte antes de tiempo, pulsa el botn de minimizar.
Ten en cuenta que si en vez de minimizarlo lo cierras, Citorio simplemente
terminar y no volver a mostrarse.
La opcin de men de Luego! tambin lo ocultar, y la siguiente vez
que salga repetir la misma cita.

Finalizando Citorio
-------------------

Citorio permanece invisible la mayora del tiempo. Si quieres cancelarlo, basta 
con ejecutarlo otra vez - la nueva instancia har que la anterior muestre su ventana 
(slo habr una instancia corriendo en un momento dado).
En esa ventana puedes seleccionar la opcin Men/Salir, pulsar Alt+F4 o Cerrar
en el men de sistema para acabar con Citorio.

Citorio/Dos
-----------

CITORIOD.EXE es un programita MS-DOS que lee las citas dentro de
CITORIO.EXE y muestra una, aleatoriamente. Ejecuta

  CITORIOD /?

Y saldr:

Uso: CITORIOD [/?] | [/b] | [/l [c]]
(C) 1995,96 Javier Camara Melgosa	(jcamara@jet.es)
	FREEWARE - Gratis, pero todos los derechos reservados

  Esto muestra una cita aleatoriamente de las contenidas en CITORIO.EXE.
  CITORIO.EXE es un programa para Windows que contiene las citas en forma 
  de recursos STRINGTABLE. Debe estar en el mismo directorio que CITORIOD.EXE

  /b,/B: "Bonito" - Aspecto 3D (requiere ANSI.SYS o sustituto)
  /l,/L: Lista TODAS las citas por la salida estandar. Una cita puede ocupar
  	mas de una linea, asi que 'c' es el caracter que aparecera
  	como delimitador del final de cita, al principio de una linea.
  	Por omision, es '%'.
  	  Se incluyen las clasificaciones de las citas, como #<letra>, pero
  	los demas codigos de control se procesan.

La idea es ejecutar a CITORIOD desde el AUTOEXEC.BAT.
CITORIOD.EXE debe residir en el mismo directorio de CITORIO.EXE.

La opcin /l es por si alguien est interesado en exportar las citas de
Citorio para otro "fortune program" (programa de citas). Esa opcin vuelca
todas las citas por la salida estndar.

Las citas de Citorio
====================

Las citas han sido obtenidas de un nmero diverso de fuentes, incluyendo
otros programas de citas. No considero que eso sea una violacin de la
propiedad intelectual; no pueden pretender hacer valer su copyright sobre
citas ajenas, aunque la recopilacin la hayan hecho ellos.
La traduccin del ingls al espaol ha sido libre... :-)
Citorio tiene tan pocas citas, en comparacin con las que me he ledo,
porque slo he puesto las que me gustaban (criterio discutible, en cualquier
caso).

Las citas de Citorio se almacenan como recursos STRINGTABLE dentro del
propio CITORIO.EXE. Esto en realidad es peor que tenerlas en un fichero
de texto externo.

Las strings de citas van desde 1 a MAX_CITAS. MAX_CITAS es el mximo nmero
de string pero *no* es una constante: est almacenado en la string nmero
30000.
Esto es as para permitir aadir citas con un editor de recursos - ver
"Aadiendo Citas", ms adelante.

Formato de una cita
-------------------
El formato de una string de cita es:

<texto> [ "*DD" | "*EX" ] [ "#"<clase> ]

** Autor de la cita
Dentro de <texto>, la secuencia "|a"<autor> separa el nombre del autor
del texto de la cita. Pueden aparecer varios "|a"; <autor> se considera
finalizado cuando aparece un salto de lnea.

** Citas de mas de 256 caracteres
Los recursos string no pueden sobrepasar los 256 caracteres. Para admitir
citas ms largas que eso, Citorio usa varias strings; todas menos la
ltima acaban en el carcter '-'. Citorio las concatenar todas al
leer la cita.

** Sufijos *DD y *EX
Esos dos sufijos son firmas predefinidas para una cita, que se abrevian pues
aparecen mucho en el conjunto.

El sufijo *DD indica que la cita es del libro "El Diccionario del Diablo",
de Ambrose Bierce. Este libro es una encantadora coleccin de
definiciones corrosivas. "*DD" se expande como "|aAmbrose Bierce, 'El
Diccionario del Diablo'"

El sufijo *EX indica que la cita se ha sacado de la respuesta a un examen, y se
expande como "|aRespuesta a un examen". Adems, esas citas llevan
implicitas la clasificacion de "divertida" (ver siguiente punto)

** Clasificacion de las citas

Las citas se clasifican segn su carcter en:

  Normales (Sin marca de clase)
  Divertida   (D)
  Deprimente  (P)
  Animosa     (!)
  Romantica   (R)
  Maliciosa   (M)
  De sexo o descerebrada (X)
  De vagos    (V)
  Ley de Murphy   (Y)
  Dicha por el ordenador  (O)

Para clasificar una cita hay que finalizar el texto completo de la cita con
"#"<letra>, donde <letra> es la letra asociada a la clase (listadas arriba).
En Citorio/Win, a cada clase corresponde un icono determinado. Las citas
no clasificadas (normales) se muestran con un icono de entre un conjunto de 21
que van usndose de forma cclica.

En Citorio/Dos la clasificacin se ignora.

** Ejemplos de strings de citas

Cita divertida de "El Diccionario del Diablo":
  1 "Cleptmano: Ladrn rico.*DD#D"

Cita normal con autor:
  352 "El hombre prudente (...texto...) la difamacin|aFranklin"

Cita larga y romntica:
  358 """Cmo es estar enamorado?""\n""Bueno, (...texto...) mareado. -"
  359   "Al tiempo (... texto...) se marcha""|aHobbes#R"

  Citorio concatenar siempre las strings 358 y 359.

Aadiendo citas a Citorio
-------------------------

Se pueden aadir, aunque sera ms sencillo si estuviesen en un fichero
de texto externo.
Se requiere un programa editor de recursos de ejecutables, como el Borland
Resource Workshop o el equivalente de Microsoft, que no recuerdo como se llama.
Ahora, si no tienes un editor de recursos... tendrs que conformarte con las
citas estndar. Se siente.

Lo que hay que tener en cuenta es que, si cambia el nmero de citas, hay que
cambiar el valor de la string 30000 (STR_NUM_CITAS), que contiene precisamente
el nmero total de strings. Citorio genera nmeros aleatorios entre 1 y el
valor almacenado en dicha string.

Soporte de Bitmaps
------------------
Desde la versin 1.1, las citas de Citorio pueden tambin ser un bitmap de 2 o 16 colores.
En mi casa, Citorio contiene tiras cmicas digitalizadas. Pero no distribuyo esos bitmaps 
porque es totalmente ilegal el digitalizarlos... as que la versin "liberada" no contiene
ninguna imagen.

Si t quieres ponerle alguna imagen, puedes, si dispones de un editor de recursos en
ejecutables. Citorio muestra bitmaps numerados entre 1 y el valor del recurso string 
nmero 30003, que actualmente es "0". Recuerda que slo se soportan bitmaps de 2 o 16
colores.

Los bitmaps se identifican como nmeros negativos. Los bitmaps vistos se grabarn en
CITORIO.INI con su nmero en negativo; tambin, si quieres forzar a Citorio a mostrar
un bitmap, psale su nmero en negativo como argumento al invocarlo.

PARA TERMINAR
=============

Espero que te guste Citorio.
Sea as o no, si conoces citas interesantes puedes mandrmelas por correo
electrnico a jcamara@jet.es. Ya he saqueado (o an! estoy en ello) todos los programas 
de citas de Cica (Winsite), Garbo y Simtel as que no te molestes en ellos.

No creo que se le pueda aadir mucha funcionalidad a Citorio. Ideas:

- Sacar las citas a fichero de texto externo
- Incluir sonidos (interesante?)

Yo no tengo planeado aadirle nada, de todas formas (bueno, tampoco lo tena en la
1.0 y he sacado la 1.1, as que har lo que me d la gana, supongo). 

