Bibliotecas electrónicas: tecnología de documentación <author>Ismael Olea &nl; <url url="mailto:olea@hispalinux.es"> <date>1999-09-18 <sect>Introducción: del LDP a la biblioteca inteligente 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: <enum> <item> documentos estructurados y asistentes a la creación; <item> libro de estilo; <item> sistema de control de responsabilidad distribuida; <item> sistema automático de publicación. </enum> <sect1> Documentos estructurados y asistentes a la creación 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): <itemize> <item>Marcación descriptiva versus marcación procedimental. <item>El autor se centra en la labor de escritura y creación, sin distraerse con asuntos que no son relevantes en el proceso de autoría. <item>El documento es independiente de la plataforma, facilitando su manejo, almacenado, consulta y proceso. <item>Sencillez de edición y fácil manejo con cualquier clase de herramientas de edición de textos. <item>Apoyado por un adecuado sistema de representación mejora la calidad final de los documentos y unifica el uso de las convenciones de estilo de cada idioma y área de conocimiento. <item> Gracias al riguroso diseño también se facilita la automatización del proceso y el intercambio de documentos por medios informáticos. </itemize> En cuanto a las herramientas que asistan a la creación: <itemize> <item>Biblioteca de DTD, definiciones de tipos de documentos. <item>Asistentes para la creación de DTD. <item>Hojas de estilo para la transformación a otros DTD y a formatos de visualización. <item>Editores estructurados. <item>Editores de texto. <item>Tesauros. <item>Corrector ortográfico. <item>Asistente para la creación de meta-datos. <item>Control de versiones. <item>Tecnologías y herramientas de representación electrónicas y en papel. </itemize> <sect1> Libro de estilo 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: <descrip> <tag/Convenios de escritura/ donde se normalice el uso del estilo literario dentro del documento o de la colección de los mismos. <tag/Vocabulario/ donde se fije una terminología uniforme a fin de no despistar al lector. <tag/Glosario de traducción/ 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. <tag/Convenios tipográficos/ que reflejen la norma y convenios del idioma usado e instruyan su aplicación en la tecnología de documentos elegida. <tag>Recursos de ayuda al autor/traductor</tag> bibliografía electrónica e impresa de interés. </Descrip> <sect1> Sistema de control de responsabilidad distribuida Las labores que debe favorecer este sistema son: <itemize> <item>Control de versiones. <item>Creación cooperativa. <item>Actualización de los documentos. <item>Control de calidad. </itemize> Con «responsabilidad distribuida» quiero referirme al modo en el que se desarrollan los proyectos tipo <em/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. <sect1> Sistema automático de publicación 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 <bf/Donantonio/». Los planteamientos básicos de <bf/Donantonio/ son: <itemize> <item>Basado en soft libre, preferiblemente GPL o compatible. <item>Especificaciones abiertas y perfectamente documentadas. <item>Basado en verdaderos estándares abiertos como RFC, W3C e ISO. <item>Sencillez, modularidad y flexibilidad. </itemize> Los objetivos del diseño son: <itemize> <item>publicación automática; <item>publicación distribuida a lo largo de la Red; <item>responsabilidad distribuida de la publicación; <item>organización de vistas ---de usuario y de sistema--- automáticas y programables; <item>facilidades de replicación; <item>facilidades de actualización automática; <item>relaciones flexibles entre agentes <bf/Donantonio/. </itemize> Elementos necesarios (entre otros): <itemize> <item>declaración de metadatos conforme a un esquema normalizado (descripción); <item>el fichero como unidad atómica de transferencia de datos; <item>protocolos de transferencia de ficheros internet; <item>mecanismo de consulta sencillo y flexible (por ahora, SQL). </itemize> <sect>Contenidos de este tutorial 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. <sect1>Documentos estructurados. Una introducción a las tecnologías de documentos estructurados está disponible en la conferencia «SGML para autores» que puede encontrarse en <url url="http://lucas.hispalinux.es/Presentaciones/campus-party98/conf-olea-cp98.tgz">. <sect1>Sistema automático de publicación. 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 <bf/Metalab/ con la vista puesta en un diseño basado en <bf/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: <descrip> <tag/LDP-core,/ esquema bibliográfico para clasificar los documentos del LDP. <url url="TACATACA">. <tag/ldpCoreMetaML.dtd,/ LDP-core expresado como DTD XML. <url url="http://casbah.org/cgi-bin/cvsweb.cgi/XML/DTDs/ldpCoreMetaML.dtd"> <tag/Donantonio,/ una arquitectura para publicación distribuida automática. </descrip> <sect>Glosario <descrip> <tag/DC/ <url url="ftp://sunsite.rediris.es/docs/rfc/24xx/2413"> <url url="http://purl.org/DC/"> <tag/DocBook/ <url url="http://www.docbook.org"> <tag/DTD/ TACATACA <tag/GNU/ <url url="http://www.gnu.org"> <url url="http://www.fsf.org"> <tag/Glosario de LuCAS/ <url url="http://LuCAS.HispaLinux.ES/Otros/glosario/Glosario/glosario.html"> <tag/GPL/ TACATACA <tag/Insflug/ TACATACA<url url="http://www.insflug.org/"> <tag/ISO/ International Standars Organization <tag/LDP/<url url="http://www.linuxdoc.org"> <tag/LDP-es/ <url url="http://LuCAS.HispaLinux.ES"> <tag/LuCAS/ <url url="http://LuCAS.HispaLinux.ES"> <tag/Metalab/ <url url="http://metalab.unc.edu"> <tag/Ofelia/ <url url="http://www.insflug.org/ldp/"> <tag/RDF/ <url url="http://www.w3.org/Metadata/RDF"> <tag/RFC/ <url url="ftp://sunsite.rediris.es/docs/rfc/"> <tag/SQL/ TACATACA <tag/URL/Uniform Resource Locators <url url="ftp://sunsite.rediris.es/docs/rfc/17xx/1738"> <tag/SGML/ TACATACA <tag/XML/ <url url="http://www.w3.org/XML/"> <tag/W3C/ <url url="http://w3.org/"> </descrip> <sect>Bibliografía Además podrá encontrar material actualizado de este tutorial y otros relacionados en <itemize> <item><url url="http://www.hispalinux.es/~olea"> <item><url url="http://lucas.hispalinux.es/htmls/presentaciones.html"> </itemize> </article>