Ayuda para MagicPoint
=====================


Autor
-----

Pedro Reina <pedro@pedroreina.net>


Fecha
-----

J.11.8.2005


Objetivo
--------

Con este archivo intento ayudar a aquellas personas que
deseen por cualquier motivo utilizar las presentaciones
que preparo usando el programa MagicPoint.


Archivos incluidos
------------------

leeme.txt            : este archivo de ayuda
mgp-x-m17n           : ejecutable de MagicPoint
mgp-castellanizar.pl : programa en Perl para modificar archivos
mgp-prepara.sh       : script en Bash para preparar la presentacin
gilgon__.ttf         : tipo de letra "Gilgongo"
street__.ttf         : tipo de letra "Street - Plain"
strsl___.ttf         : tipo de letra "Street Slab"
local.conf           : archivo de configuracin local de fontconfig


Sistema operativo
-----------------

Todas las explicaciones aqu dadas han sido probadas en
un sistema operativo Debian 3.1; en otros sistemas puede
ser necesario realizar algn ajuste distinto.


Instalacin de las fuentes
--------------------------

Utilizo las fuentes en MagicPoint a travs del sistema fontconfig,
que est presente en todas las distribuciones GNU/Linux modernas
y me imagino que tambin estar en las *BSD.

Hay que copiar los tres archivos ttf a algn directorio de fuentes
reconocido por fontconfig.

Como la versin de MagicPoint que utilizo no puede reconocer la
fuente llamada "Street - Plain", creo que por tener un guin,
hay que definir en fontconfig el alias "StreetPlain" para ella.

En el archivo local.conf doy ejemplos de cmo se puede definir
un directorio de tipos en fontconfig y un alias. Este archivo
puede estar ubicado en el directorio /etc/fonts.

Para comprobar que las fuentes han sido reconocidas por fontconfig
puedes ejecutar, como usuario sin privilegios, la orden fc-cache
para regenerar la cach de fuentes y la orden fc-list para ver
el listado de fuentes disponibles; luego estas tres rdenes te deben
indicar los tres archivos de fuentes que has instalado:
fc-match Gilgongo
fc-match StreetPlain
fc-match "Street Slab"


Instalacin de MagicPoint
-------------------------

Puedes instalar el paquete MagicPoint siguiendo el mtodo recomendado
para tu sistema. En Debian 3.1 debes escribir como root la orden
apt-get install mgp

El ejecutable mgp que viene con el paquete Debian no es capaz de
asignar correctamente las fuentes, probablemente por haber sido
compilado con la opcin m17n, segn se indica en el bug Debian #308213:
http://bugs.debian.org/308213

Para solventar ese problema he compilado MagicPoint sin incluir
soporte para m17n y el ejecutable mgp que he obtenido lo he
renombrado como mgp-x-m17n. Para poder ejecutarlo solo por su
nombre, lo tengo en un directorio del PATH, en /usr/local/bin/


Instalacin de la preparacin de la presentacin
------------------------------------------------

Con el fin de preparar las imgenes PNG finales de la presentacin
y los archivos HTML, he preparado el programa en Perl mgp-castellanizar.pl
y el script Bash mgp-prepara.sh. Ambos deben estar disponibles en
algn directorio del PATH, yo los tengo en /usr/local/bin/

El script mgp-prepara hace una copia de seguridad tgz de los archivos
de la presentacin y genera archivos HTML para la web e imgenes PNG
de las diapositivas.

El programa en Perl mgp-castellanizar.pl modifica los archivos generados
por MagicPoint para cambiar los nombres de los archivos y traducir
al castellano los textos de las pginas HTML.


Ejecucin de la presentacin
----------------------------

Con cada presentacin se incluye el script conf.sh que la arranca.


Modificacin de la presentacin
-------------------------------

He intentado documentar la presentacin para que sea fcil
modificarla, pero hay un aspecto que no entiendo bien y
prefiero explicar con detalle cmo utilizo.

Para aadir una imagen a una diapositiva en un punto diferente
del flujo normal de las instrucciones utilizo la orden %area,
pero hay que ponerla al final de todas las dems instrucciones
de la diapositiva. Las rdenes que pongo son estas:

%area 100 100 0 y
%prefix x
%image "nombre-de-la-imagen"
%prefix 0
%area 100 100

Los parmetros x e y me sirven para colocar la imagen en el
punto de la diapositiva que deseo; la "y" es la ordenada empezando
a contar por arriba y la "x" la abscisa empezando a contar por la
izquierda; ambos valores son porcentajes, as que deben estar
entre 0 y 100; dicho esto, aado que no entiendo realmente cmo
funcionan, as que los voy poniendo a ojo. Es fcil, porque basta
salvar el fichero mgp con una modificacin para que el programa
refresque la diapositiva.


Conversin de la presentacin
-----------------------------

Con cada presentacin se incluye el script prepara.sh que crea
imgenes PNG y archivos HTML


Ejecucin alternativa de la presentacin
----------------------------------------

En muchas ocasiones es difcil usar mgp para ver estas
presentaciones, ya que requieren varios ajustes y adems
puede haber cambios de composicin en las diapositivas al
cambiar de sistema.

Por eso prefiero usar las imgenes PNG para mostrar las
presentaciones. Las coloco en un directorio y uso un reproductor
de imgenes, mi preferido es qiv. Uso esta orden:
qiv -fti *


Consultas
---------

Si despus de leer este archivo y los scripts sigues teniendo
alguna duda, mndame un correo y har lo que pueda para ayudarte.
