A lo largo de este tutorial conoceremos algunas de las tecnologías necesarias para la puesta en marcha de proyectos documentales. Estas ideas han sido observadas desde la perspectiva de la experiencia a lo largo de mi contacto con los proyectos de documentación LDP, LuCAS y LDP-es en general.
Lo que se ofrece es una idea de cómo debe ser la próxima generación de proyectos de documentación GNU/Linux en concreto y de bibliotecas electrónicas en general.
Un proyecto de documentación técnica-científica informatizada necesita de las siguientes tecnologías:
El código fuente debe estar basado en un sistema abierto de documentos estructurados basado en las tecnologías SGML/XML.
Ventajas (expuestas también en la parte dedicada a SGML/XML):
En cuanto a las herramientas que asistan a la creación:
El libro de estilo es una herramienta absolutamente indispensable para todos aquellos que sin ser profesionales de la documentación necesitan crear textos destinados al público. Así pues el libro de estilo es la guía y oráculo que debe ayudar a resolver todas las dudas e inquietudes del autor.
Así debería incluir al menos las siguientes secciones:
donde se normalice el uso del estilo literario dentro del documento o de la colección de los mismos.
donde se fije una terminología uniforme a fin de no despistar al lector.
algo que parece imprescindible en el caso de la documentación informática en el que tanta importancia tiene el vocabulario de la jerga en inglés. Es obvio que debe estar perfectamente sincronizado con el vocabulario o que ambos formen una unidad.
que reflejen la norma y convenios del idioma usado e instruyan su aplicación en la tecnología de documentos elegida.
bibliografía electrónica e impresa de interés.
Las labores que debe favorecer este sistema son:
Con «responsabilidad distribuida» quiero referirme al modo en el que se desarrollan los proyectos tipo bazar, en los cuales la responsabilidad de las tareas las adquieren voluntariamente los colaboradores en función de sus posibiliades y deseos; paralelamente el proyecto es dirigido/supervisado por un equipo más o menos reducido de líderes. Así es importante que las herramientas agilicen las tareas de coordinación al máximo liberando a los líderes del tiempo dedicado a las labores rutinarias.
Actualmente estoy trabajando en la especificación de los requerimientos a exigir a esta clase de tecnologías. Es lo que he llamado la «arquitectura Donantonio».
Los planteamientos básicos de Donantonio son:
Los objetivos del diseño son:
Elementos necesarios (entre otros):
A lo largo de este tutorial se mostrarán técnicas que dan solución a parte de las necesidades del primer punto y al cuarto.
Una introducción a las tecnologías de documentos estructurados está disponible en la conferencia «SGML para autores» que puede encontrarse en http://lucas.hispalinux.es/Presentaciones/campus-party98/conf-olea-cp98.tgz.
En la actualidad estoy diseñando el borrador de una arquitectura para el diseño y operación de esta clase de sistemas. Además participo en el diseño de una aplicación bibliográfica que asista a la publicación de recursos en Metalab con la vista puesta en un diseño basado en Donantonio.
También tengo previsto que este esfuerzo, junto a otros que al menos partirán inicialmente de la comunidad hispana, forme parte del próximo proyecto LuCAS I+D.
Por lo pronto ya están en desarrollo los siguientes trabajos:
esquema bibliográfico para clasificar los documentos del LDP. TACATACA.
LDP-core expresado como DTD XML. http://casbah.org/cgi-bin/cvsweb.cgi/XML/DTDs/ldpCoreMetaML.dtd
una arquitectura para publicación distribuida automática.
ftp://sunsite.rediris.es/docs/rfc/24xx/2413 http://purl.org/DC/
TACATACA
http://LuCAS.HispaLinux.ES/Otros/glosario/Glosario/glosario.html
TACATACA
TACATACA http://www.insflug.org/
International Standars Organization
TACATACA
Uniform Resource Locators ftp://sunsite.rediris.es/docs/rfc/17xx/1738
TACATACA
Además podrá encontrar material actualizado de este tutorial y otros relacionados en