
Gua de inicio rpido:
----------------------

necesitars un linux con aceleracin grfica por hardwar, una tarjeta grfica
con bastante RAM (bueno, 64 megas es lo corrientito y de sobra) y las siguientes
biblitecas (que recuerde)

	- glut (quiz tengas que instalarla)
	- libgd (idem)
	- zlib (deberas tenerla instalada)
	- freetype (la tendrs)
	- fontconfig (tambin la tendrs)
	- libc (si no la tienes no s cmo ests leyendo esto)

para abrir la presentacin "Introduccion":

	cd /donde/est/cabaret
	./cabaret /donde/est/Introduccion.cabaret

(mejor sin el / al final)

Tras unos segundos, Cabaret mostrar su escritorio. Haz que la ventana
se convierta en pantalla completa (algunos windowmanagers como el metacity 
de ubuntu no lo hacen por s solo y tendrs que definirte alguna combinacin 
de teclas en preferencias -> combinaciones de teclas -> pantalla completa).

Te vas al men Presentacin y le das a iniciar presentacin.

Las teclas son:
	espacio: avanzar con transicin
	flecha derecha: avanzar sin transicin
	flecha izquierda: adivina
	esc: volver al escritorio de Cabaret





Gua de inicio lento:
---------------------

Esta es una beta de Cabaret

Eso significa que es posible que tenga errores y que casque, pero no debera
suponer ningn peligro para tu sistema. Sin embargo, no se te ocurra lanzarlo
con permisos de root ni ninguna locura de esas.

Para ver cualquiera de estas presentaciones, haz:

	./cabaret [nombre]

donde [nombre] es el nombre de la carpeta que contiene la presentacin que 
quieras ver. Los nombres de esas carpetas deberan acbaabar en ".cabaret" 
y es mejor que no le aadas el / al final. Aunque no debera pasar nada.

Cabaret requiere dos cosas:

	- que la carpeta "ui" est en el directorio actual. No
	  lances cabaret de esta forma: 

	  /donde/est/cabaret nombre.cabaret

	  sino

	  cd /donde/est
	  ./cabaret nombre.cabaret

	- una presentacin existente. Cabaret no sabe empezar as:

	  cd /donde/est
	  ./cabaret

	  y si lo haces vers que se hunde en la miseria de un desagradable 
	  segmentation fault. En lugar de eso, indcale siempre una
	  presentacin. En realidad, esto es algo bueno. Por ahora. Si quieres
	  empezar una presentacin nueva, cgete una existente y comienza
	  a partir de ah. En este directorio se incluye un gul_theme.cabaret que
	  es el tema a partir del cual se cre la presentacin de tarde de web.



Creando presentaciones
----------------------

Todo debera ser ms o menos autodescriptivo. Cabret se ha creado con la facilidad
siempre en mente. Te coges una plantilla y a partir de ah vas aadiendo contenido.

Tienes varias ventanas importantes

	- Edicin: aqu va lo gordo. Pulsando con el botn derecho puedes crear
	  nuevos elementos:

	  Texto: pulsa en el tamao que quieras y escribe lo que sea. El editor de
	  textos no es lo ms flexible del mundo, pero algo es algo. Las tildes son
	  en realidad rollito HTML (&aacute; y cosas as). La  por ahora no. 

	  Fotos: te saldr un dilogo donde le metes el path de la foto. Cabaret slo
	  entiendo PNG. Mete el path completo /home/tal...) y no uses tildes ni ees
	  ni cosas raras.

	  Con el izquierdo puedes seleccionar, mover, alinear, etc. La tecla "del" borra
	  el elemento, por cierto.

	- Fondo: Pulsa cerca de una esquina de la transparencia. Vers que en la ventana
	  Fondo se marca dicha esquina con un triangulito. Ahora cambia su color. Voil!
	  Tambin puedes poner una foto de fondo y cambiar el tipo de mezcla entre el 
	  gradiente y la foto. El tipo de mezcla "superposicin" es probable que te guste
	  porque colorea la foto de fondo con los colores del gradiente. Ta chulo.

	- Propiedades: cuando selecciones un objeto de la transparencia con el botn
	  izquierdo puedes cambiar su color, su transparencia, etc.
	
	- Organizador: vale para ver todas las transparencias y organizarlas. Puedes
	  cambiar el orden arrastrando, copiar transparencias (click en una y pulsa "c") o
	  borrar una transparencia (click y x)

	- Transicin: los parmetros de la transicin van aqu. Puedes hacer que una
	  transparencia tarde ms o menos o que pase automticamente y definir las
	  transiciones de cada elemento. Los nombres son un poco feos pero todo se andar.

Las ventanas pueden cerrarse (pulsando en la esquinita superior izquierda), cambiar su
tamao (con la esquinita inferior derecha) o fusionarse con  el fondo (superior derecha).

En la barra de men hay poca cosa pero muy chula. Un men para guardar tu trabajo, uno para
mostrar las ventanas cerradas, uno para comenzar la presentacin y el men de ayudantes.
Los ayudantes son como el puto clip del office pero sin dar por culo. Son como pequeos
scripts que hacen una tarea repetitiva. Prubalo: crea una transparencia con 5 lneas de
texto independientes, mrcalas todas (usando shift+click o cogiendo un rea) y prueba 
los asistentes. 


El futuro
---------

Hacer una versin para .NET, cerrar el cdigo y venderlo por 50$ va paypal. 

O mejor, aadir soporte para scripting en python :)



Licencia
--------

Cabaret es Software Libre. En concreto, es GPL. Eso significa que tienes una serie
de derechos que otro tipo de licencia no te da. Entre ellos est el obtener el 
cdigo fuente del programa, modificarlo y redistribuirlo.

Durante un breve perodo de tiempo, Cabaret estar en pruebas y, probablemente, su
cdigo fuente cambie a otro servidor. Mientras tanto, en 

	http://forja.rediris.es

podrs encontrar las versiones (ahora mismo un poco viejas) en el proyecto llamado 

	csl-cabaret

El objetivo es llevarme las fuentes a un servidor en el GUL UC3M o quiz a un dominio
propio. Preferira que en lugar de un dominio de dreamhost o algo as fuera una mquina
virtualizada en un servidor del GUL, pero bueno, todo se andar.

Puedes coger las fuentes y hacer lo que quieras, pero estara bien que, antes de hacer
ninguna locura, avisaras. Soy un desastre y suelo tener fuentes viejas en los
repositorios CVS. As que para cualquier cosa, ponte en contacto con el gul en la 
siguiente direccin:

	gul@gul.uc3m.es

Hasta pronto.


