Capítulo 1. Un concepto revolucionario

1. ¿Qué es Borges?
1.1. Características
2. Eligiendo a Borges
2.1. ¿Lo necesito?
2.2. Borges, ¿es para mí?
3. Some Vocabulary

1. ¿Qué es Borges?

Borges es un sistema de administración de documentos extensible de código abierto orientado a proyectos de documentación XML. Su propósito principal es optimizar la internacionalización (muchos idiomas, traducciones), el contenido reutilizable y el trabajo en equipo.

La filosofía principal detrás de Borges es brindar una herramienta conveniente:

  • Para los principiantes: brindando una interfaz simple para compilar documentos DocBook XML en muchos formatos;

  • Para los usuarios avanzados: brindando un conjunto completo de características de personalización que permiten ajustar con facilidad todos y cada uno de los aspectos del sistema: formatos de salida y distribución de los mismos, reglas personalizadas de compilación, etc.

  • Para los administradores de proyectos: brindando un sistema de seguimiento de proyectos potente para manejar a los autores y traductores, las fechas de entrega, etc.

1.1. Características

Las DTDs que soporta son DocBook y TDB (Training DocBook), un subconjunto de la DTD DocBook escrita para los manuales de formación de MandrakeSoft. Añadir DTDs externas es muy fácil, aunque todavía el sistema de revisión de versiones puede no funcionar con DTDs que no sean DocBook o TDB.

Corrientemente, el sistema permite:

  • Compilar los archivos fuente en PDF, PS y (X)HTML;

  • Administrar versiones diferentes de un único documento definiendo con facilidad versiones derivadas basadas en la exclusión de partes condicionales;

  • A cada módulo se asigna un conjunto de autores: escritor, traductores, correctores, cada uno responsable por un estado de un módulo. Cada contribuyente puede revisar con facilidad sus atribuciones a través de páginas web, y puede recibir correo electrónico con la lista de tareas que tiene asignada en el momento;

  • Seguir la pista al trabajo en progreso. Desde todo el proyecto (compuesto de varios documentos) hasta los componentes más básicos (párrafos), y las traducciones de los mismos;

  • Seguir la pista al estado de cada módulo de acuerdo con seis estados predefinidos (Desde "escrito" hasta "última re-lectura idiomática"). Una vez que se completa una tarea, el estado correspondiente se considera superado y el módulo cambia al estado siguiente;

Algunos hechos acerca de Borges:

  • administración automática de imágenes en formatos EPS, PNG, DIA, XFig;

  • administración automática de entidades externas globales y locales (por documento);

  • administración automática de módulos como entidades externas.