Unidad V Manejo de software para para documentar documentar 143
Do cumentación técnica Esquema conceptual: Unidad V Características Utilización Características Utilización 2. InDesign 1. FrameMaker 3. Writer Características Utilización 144 UNIDAD V Manejo de software para documentar 5. LaTeX 4. Word Características Programa Procedimiento para LaTeX Utilización Características Utilización
U n i da d V. M a n e j o d e s o f t wa r e pa r a d o c u m e n ta r Semana 13 Presentación Para la elaboración de documentos técnicos es importante que el formato o la apariencia sea agradable y clara a la vista, pero esto no es más relevante que la estructura y coherencia del contenido. El siguiente paso es elegir el programa de cómputo en el que se realizará el documento. En los siguientes párrafos se presentará una breve descripción de algunos de éstos. Cada uno de ellos tiene características específicas que los hacen más o menos adecuados para cada necesidad; la elección dependerá de elementos como el objetivo, el mensaje, el lector y la forma de transmisión del contenido. Objetivos específicos El alumno describirá los distintos programas para la elaboración de documentos y distinguirá los usos de cada uno para la presentación final del documento. 145 Tema y subtemas I. V Manejo de software para documentar V.1 FrameMaker V.2 InDesign V.3 Writer V.4 Word V.5 LaTeX
Do cumentación técnica V.1 FrameMaker Características del FrameMaker Adobe FrameMaker es un programa para la publicación y creación de documentos dirigida a elaboradores de contenido técnico. Funciona a través de flujos de trabajo y plantillas que permiten simplificar la elaboración del contenido y mantener la uniformidad y características que den coherencia al formato final. 146 Utilización del FrameMaker FrameMaker ofrece soporte para la creación basada en estándares, como Darwin Information Typing Architecture (dita), estándar basado en xml para crear, producir y entregar información técnica. A través de sus opciones permite la creación de contenido que puede ser publicado en varios formatos como xml/html, impresión en papel, pdf, wsf, WebHelp, FlashHelp, Microsoft html Help, OracleHelp, JavaHelp y Adobe AIR. FrameMaker es especialmente útil para los documentadores técnicos para crear, estructurar, revisar y publicar con facilidad contenido extenso y complejo, en el que además se utilice simbología específica. FrameMaker puede incluir distintos tipos de contenido y posibilita el acceso al contenido almacenado para ahorrar tiempo en búsqueda e intercambio de información a incluir en el documento. FrameMaker ofrece, entre otras opciones, soporte para la impresión de alta calidad, el uso de del formato de documentos pdf y la integración de gráficos vectoriales escalables. La siguiente imagen muestra la ventana principal de FrameMaker.
U n i da d V. M a n e j o d e s o f t wa r e pa r a d o c u m e n ta r Esta herramienta ofrece además del tratamiento de textos, la posibilidad de emplear opciones de xml para estructurar, almacenar e intercambiar información. Los archivos realizados en FrameMaker tienen la extensión.fm. V.2 InDesign InDesign es un programa de la empresa Adobe para la creación de composiciones profesionales para la edición digital e impresa. Entre sus características se incluyen las múltiples opciones para el uso de la tipografía y la aplicación del color. Otras características son sus opciones de presentación o reproducción, que puede ser desde una impresión de alta calidad hasta la visualización en Adobe Flash Player y en formato pdf, lo que le da cierto nivel de interactividad. InDesign es útil para crear composiciones para revistas, publicaciones periódicas y folletos, con opciones de pdf, y documentos interactivos. Características del InDesign Utilización del InDesign Los documentos resultantes pueden convertirse en originales para impresión en alta resolución o para consultarse a través de Internet. La imagen siguiente presenta la pantalla inicial del programa 147 Los archivos que resultan del empleo de InDesign tienen la extensión.indd.
Do cumentación técnica V.3 Writer Características del Writer Writer es un procesador de textos que parte de la suite ofimática OpenOffice de Sun Microsystems. Este programa puede correr en cualquier sistema operativo (multiplataforma), de ahí su compatibilidad con GNU/Linux, Mac OS X, FreeBSD, Microsoft Windows, etc., además cuenta con versiones para varios idiomas. Writer se integra con otras aplicaciones de OpenOffice, entre las que se encuentran programas para presentaciones, hoja de cálculo, bases de datos y publicación de documentos. Writer es compatible con Microsoft Word. Su estructura y apariencia es muy parecida a éste, aunque tiene como particularidad el hecho de que es software libre. El entorno de Writer presenta los siguientes elementos: 148 Barra de título Barra de Menú Barra de Herramientas Regla Vertical Regla Horizontal Barra de Estado Área de ingreso de datos En la siguiente imagen se observa la pantalla inicial de Writer.
U n i da d V. M a n e j o d e s o f t wa r e pa r a d o c u m e n ta r En Writer es posible exportar la información a más de 20 formatos de archivo de texto, entre ellos pdf o xml, además de que es editor de html. Writer es útil para la elaboración de documentos en general; se trata de un procesador de textos como cartas, proyectos, informes o folletos. Cuenta con plantillas predeterminadas y opciones para personalizar formatos. Utilización del Writer Se emplea para elaborar documentos donde la mayor parte del contenido sea texto, pero con las opciones de integrar elementos de apoyo como gráficos, imágenes, tablas, uso de colores y tipografía específica. Writer es recomendable para todo tipo de documentos, incluso posee un editor de fórmulas (Math) gratuito para cuando requiera utilizar simbología de matemáticas. No es un sistema especializado en diseño editorial, más bien es práctico para la documentación técnica, donde se necesitan opciones para presentar un contenido estructurado, claramente definido, legible y coherente, por lo que no resulta un diseño muy elaborado que pueda distraer del objetivo del texto. Los archivos de Writer tienen la extensión.odt. V.4 Word 149 Word de la empresa Microsoft permite crear documentos con el apoyo de barras de trabajo y opciones que disminuyen la necesidad de utilizar otro tipo de software, ya que posee opciones para gráficos, manejo de referencias bibliográficas, diseño de página, y es compatible con una gran cantidad de programas que se integran como complementos, como convertidores de formatos, administradores de referencias o los propios programas de la misma suite Office (para elaborar presentaciones, gráficas y cálculos, publicaciones, etcétera). Entre los principales elementos que lo conforman están las barras y menús de trabajo que se encuentran en la parte superior de la pantalla y están organizados por fichas (versión 2007) con un nombre específico que orienta sobre las herramientas que se encontrarán ahí. Características de Word Elementos de Word Una vez que se selecciona alguna ficha aparecen funciones específicas representadas por íconos. Word ofrece opciones para el formato del documento, que incluye tipografía, colores, fondos, inserción de elementos como gráficos, imágenes, tablas y estilos, así como opciones para incluir referencias en el texto, diseñar la página en cuanto a tamaño y márgenes, además de opciones de visualización, impresión y formato de salida.
Do cumentación técnica Visualización de word Utilización de Word Es un programa de amplio uso en todos los ámbitos, desde el casero y académico hasta el comercial o empresarial. 150 Se utiliza en la elaboración de documentos en general, donde es posible elegir entre una variedad de formatos de salida y opciones de presentación predeterminados y de creación por parte del usuario. Word no es propiamente un programa para diseño de publicaciones profesionales, pues si bien permite el uso de diferentes elementos como imágenes, gráficas e hipervínculos, no tiene un soporte para documentos científicos complejos o textos muy grandes. Por otra parte, su amplio uso y constante actualización, lo hace un programa atractivo por su compatibilidad, tanto entre los mismos programas de Office como de otros sistemas y amplias posibilidades para la documentación técnica que no requiere de extensa simbología especializada o de textos muy grandes. La extensión de los documentos creados en Word es.doc. Qué encuentras en común en la pantalla inicial de InDesig, Writer y Word? V.5 LaTeX ECaracterísticas de LaTeX Si bien hay muchos programas en el mercado para el diseño de textos, LaTex se ha mantenido vigente desde hace más de 10 años en el ámbito académico y científico de todo el mundo. Algunos de los factores que lo han permitido es el que los mismos científicos y técnicos pueden generar directamente materiales con calidad profesional, sin la intervención de diseñadores e impresores. A través de LaTeX se
U n i da d V. M a n e j o d e s o f t wa r e pa r a d o c u m e n ta r puede realizar un proceso integral de edición de materiales listos para su impresión final. Entre sus características está el que se distribuye bajo distintos sistemas operativos, entre ellos Windows. Éste es un programa de código abierto, gratuito, que permite anexarle otros programas para incluir la simbología científica deseada. LaTeX es un lenguaje, elemento de un sistema de tratamiento de textos científicos que se complementa, en principio, por un compilador. Uno de los compiladores más utilizados es TecNic Center, a través del cual se edita y visualiza el texto para finalmente exportarlo a un formato de impresión, como.pdf,.dvi o.ps. Su sistema tiene un procedimiento parecido al de html, pues no va presentando el formato final al momento que se escribe, sino que primero elabora un código fuente y después se procesa para observar el texto del documento. De manera general, un documento en LaTeX se compone de dos partes esenciales: Preámbulo. Se trata de la selección de un conjunto de macros con los que se especifica cuál será el aspecto general y el estilo del documento, también se establecen las reglas gramaticales del idioma seleccionado. Procedimiento para LaTeX Partes del documento LaTeX Cuerpo. Se colocan el texto, los gráficos y la simbología que se utilizarán, como es el caso de las expresiones matemáticas. 151 En la siguiente imagen se observa el preámbulo y cuerpo de un texto en LaTeX. Imagen de un texto LaTeX
Do cumentación técnica Utilización del LaTeX LaTeX es un sistema de preparación orientado principalmente a la elaboración de documentos científicos y técnicos de alta calidad que serán publicados de forma impresa, no es propiamente un procesador de textos y es empleado principalmente por matemáticos, físicos e informáticos. No es el más adecuado para textos sencillos que no requieran simbología, sino que es útil precisamente para incluir fórmulas matemáticas, químicas, físicas y diagramas, entre otras. De ahí que LaTeX es una herramienta por excelencia para la documentación técnica. Está diseñado para trabajar a través de un mapa inicial del material, organizado en secciones bien delimitadas y características específicas de formato desde el inicio. La extensión de los archivos LaTeX es.tex. Con qué elementos se podrían comparar en la documentación técnica el preámbulo y cuerpo en LaTeX? 152
U n i da d V. M a n e j o d e s o f t wa r e pa r a d o c u m e n ta r Reactivos de autoevaluación Instrucciones: Escribe en la línea la letra correspondiente, F para falso y V para verdadero 1. FrameMaker es un programa básico para elaborar texto rtf. 2. FrameMaker es especialmente útil para textos largos y con simbología. 3. InDesign es un programa práctico para la edición de revistas y folletos. 4. Writer es un procesador de textos que forma parte de OpenOffice y es software libre. 5. Writer es un procesador de textos útil para publicaciones en general, que además cuenta con un editor de símbolos matemáticos. 6. Word es un procesador de textos con amplias posibilidades para la documentación técnica que no requiere de extensa simbología especializada o de textos muy grandes. 7. Word es el programa recomendado para textos científicos extensos que requieren simbología. 8. LaTeX es un procesador de textos básico para el diseño de publicaciones en general, donde se puede ir viendo directamente la apariencia del contenido del documento. 153 9. Un documento en LaTeX se compone de dos elementos: introducción y contenido. 10. Debido a su complejidad LaTeX no es recomendable para la documentación técnica.
Do cumentación técnica Glosario Compilador: Los compiladores son programas o herramientas encargadas de compilar. Un compilador toma un texto (código fuente) escrito en un lenguaje de alto nivel y lo traduce a un lenguaje comprensible por las computadoras (código objeto). Básicamente, existen dos grandes formas de ejecutar programas: programas compilados (previamente pasados por un compilador) y programas interpretados (necesitan pasar por un intérprete para ejecutarse en tiempo real). XML: Lenguaje de Etiquetado Extensible simple y estricto que interviene en el intercambio de una gran variedad de datos. xml es un formato que permite la lectura de datos a través de diferentes aplicaciones. Se trata de un lenguaje muy similar a html, pero con la función principal es describir datos y no de mostrarlos. Las tecnologías xml son un conjunto de módulos que ofrecen servicios para estructurar, almacenar e intercambiar información. 154 Fuentes de información Consorcio World Wide Web (W3C). Oficina Española. (2009). Guía Breve de Tecnologías xml. Consultada el 19 de septiembre de 2009 en http://www. w3c.es/divulgacion/guiasbreves/tecnologiasxml Diccionario Informático. Consultado el 16 de septiembre de 2009 en http:// www.alegsa.com.ar/dic/compilador.php LaTeX - A document preparation system consultado en septiembre 16, 2009 en http://www.latex-project.org http://www.latex-project.org http:// es.openoffice.org/ LaTeX para Windows. Matemáticas y proceso de textos. Consultado en septiembre 16, 2009 en http://www.matematicas.net/paraiso/latex.php OpenOffice consultado en septiembre 16, 2009 en http://es.openoffice.org/ Ulloa, V. (2007). Apuntes de diseño de textos científicos con LaTeX. UNAM: México.
U n i da d V. M a n e j o d e s o f t wa r e pa r a d o c u m e n ta r Panel de verificación Instrucciones: Escribe en la línea la letra correspondiente, F para falso y V para verdadero 1. FrameMaker es un programa básico para elaborar texto rtf. F 2. FrameMaker es especialmente útil para textos largos y con simbología. V 3. InDesign es un programa práctico para la edición de revistas y folletos. V 4. Writer es un procesador de textos que forma parte de OpenOffice y es software libre. V 5. Writer es un procesador de textos útil para publicaciones en general, que además cuenta con un editor de símbolos matemáticos. 6. Word es un procesador de textos con amplias posibilidades para la documentación técnica que no requiere de extensa simbología especializada o de textos muy grandes. 7. Word es el programa recomendado para textos científicos extensos que requieren simbología. 8. LaTeX es un procesador de textos básico para el diseño de publicaciones en general, donde se puede ir viendo directamente la apariencia del contenido del documento. V V F F 155 9. Un documento en LaTeX se compone de dos elementos: introducción y contenido. F 10. Debido a su complejidad LaTeX no es recomendable para la documentación técnica. F