14 de junio de 2001

Zapata_TEI fue creado inicialmente para el proyecto "Testimonios Zapatistas", de la Dirección de Estudios Históricos, México. Ahora, se distribuye bajo la licencia GNU LGPL a todos los interesados. Todavía tiene dos que tres problemitas, los cuales se describen en este texto.

Puedes bajar Zapata_TEI de:
http://sourceforge.net/project/showfiles.php?group_id=29144&release_id=39475

La página de Sourceforge para Zapata_TEI es:
http://sourceforge.net/projects/zapata-tei

Para mayores informes, favor de comunicarse a la dirección andrew_g11@users.sourceforge.net.

(Cabe destacar que el autor del programa no se compromete a proporcionar apoyo técnico alguno.)
 

Funciones del programa

Zapata_TEI es un "plug-in" para Microsoft Word.  Permite insertar en documentos etiquetas XML y mostrar éstas al usuario en un formato "de presentación" --es decir, fácil de leer-- en base a criterios fijados por el programador. Así, puede funcionar como un primitivo editor WYSIWYG para documentos cuyo formato de referencia será XML, pero que serán transformados en otro formato (como HTML) antes de ser difundidos. (Este proceso es cada vez más común en publicaciones electrónicas.) También permite extraer de una base de datos las opciones que se ofrecen al usuario para los valores de atributos XML.

A pesar de sus numerosas limitaciones, Zapata_TEI está siendo empleado sin problemas en el proyecto "Testimonios Zapatistas".  Si crees que lo puedes adaptar a tus objetivos, adelante.  Sólo se te pide respetar unas cuantas condiciones, que se explican en la licencia (vea el archivo licencia.html).

Instrucciones

Zapata_TEI fue escrito en Visual Basic.  Corre dentro de Microsoft Word (97 ó 2000).

Para instalar:

• Copia los archivos Zapata_TEI20.dot y ztbarra.dot a la carpeta de inicio de Word.  (Para saber cuál es, consulta la sección de Ubicación de Archivos dentro de Herramientas -> Opciones .)
• Copia la base de datos Registro de Códigos.mdb a un lugar conveniente (por ejemplo, C:\Archivos de Programa\Zapata_TEI).
• Inicia Word.
• Desde Word, abre Zapata_TEI20.dot (NO desde el Explorador de Windows).
• Activa el editor de Visual Basic desde Herramientas -> Macro.
• Desde el explorador de proyectos, activa Zapata_TEI20.dot (si es que no se encuentra activado).
• Desde el editor de Visual Basic, selecciona Herramientas -> Referencias.
• En esta pantalla viene la lista de bibliotecas y objetos externos que requieren Zapata_TEI.  Para todos los componentes donde dice "FALTA:", debes encontrar el archivo e indicar a Visual Basic dónde se encuentra.  Si no lo tienes, lo debes instalar.
• Si ya crees tener instalados todos los componentes, puedes seleccionar Depuración -> Compilar TemplateProject para verificar que en efecto sea el caso.  Si compila, significa que los vínculos externos están bien.
• Desde el explorador de proyectos, abre el módulo Zapata_TEI.
• Cambia el constante ztMainDataPath para indicar la carpeta donde copiaste la base de datos Registro de Códigos.mdb.
• Cambia las directivas de compilación según el ambiente donde usarás Zapata_TEI. Hay tres constantes que se deben que cambiar.  Si estás empleando Word 2000, asegura que en todos los módulos donde se hace referencia a la constante Word2000, diga en la parte superior #Const Word2000 = 1.  Si estás en Word 97, deben decir #Const Word2000 = 0.  Luego, cambia la directiva de control de errores.  Si quieres poder depurar los errores, en todos los módulos debe decir #Const Debuggery = 1.  Si deseas que cualquier error estorbe lo menos posible el funcionamiento del programa, fija este valor en 0.  Finalmente, la directiva #Const Lenguaje debe ser ESP o ENG, según si tu copia de Word está en español o en inglés.  Los valores de las constantes se pueden fijar simultáneamente en todos los módulos a través de Edición -> Remplazar .
• Cambia la constante ztInstalID a una cadena que identifique a esta instalación de Zapata_TEI.

• Todas las directivas de configuración de códigos se encuentran en el módulo Initialize_And_Finalize, en la función Initialize_Global_Project_Variables .  Estos deben cambiar según el esquema de codificación que emplearás.  La explicación de las funciones de objetos Tag, Attr, y ListBoxColumn se encuentra con las definiciones de sus clases.
• Si aumentas el número de códigos disponibles, deberás crear más procedimientos numerados en el módulo Macro_Entries.  (Esto se debe al sistema un poco torpe --pero inevitable-- que se emplea para transferir el control del sistema a Zapata_TEI.)
•  Reconstruye la base de datos según el esquema de codificación que usarás.

Zapata_TEI cumple con su objetivo original: ayudar en el proceso de transcripción de entrevistas del proyecto "Testimonios Zapatistas". Nunca se pensó que pudiera emplearse para otras finalidades. En este sentido, no está listo para ser distribuido ampliamente. Sin embargo, no sería tan difícil adaptarlo a otros fines.

Algunas de las limitaciones que tiene son:

• Sólo ha sido probado en un número limitado de ambientes.
• Sus parámetros de configuración fueron "hard coded"; no tiene archivo de configuración.
• Casi no tiene documentación. (Lo que sí tiene son muchos comentarios a lo largo del código.)
• No aprovecha suficientemente las capacidades de orientación hacia objetos (OO) que ofrece Visual Basic.
• Su mecanismo para vincular valores de atributos a una base de datos está un tanto enredado.
• No hay funciones de validación de los documentos XML. Las etiquetas pueden insertarse donde sea.
• Las funciones para transformar el XML en un formato de presentación son muy limitadas.
• Son también limitadas las funciones para cambiar el formato del texto que se encuentra entre una etiqueta de inicio y una etiqueta final.

•  Después de cambiar el nombre de un documento con "Guardar como...", hay que volver a activar Zapata_TEI. Al parecer, en estos casos, pueden surgir errores.