143

Uni

dad

VManejo de software para documentar

Manejo de software para documentar

144

D o c u m e n taci ó n t é cn i ca

Esquema conceptual: Unidad V

Características

Utilización

Extensión del archivo

Características

Utilización

Extensión del archivo

UNIDAD VManejo de software

para documentar

Características

Utilización

Extensión del archivo

1. FrameMaker

2. InDesign

3. Writer

Características

Programa

Procedimiento para LaTeX

Utilización

Extensión del archivo

5. LaTeX

Características

Utilización

Extensión del archivo

4. Word

145

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

Sem

ana

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.

V.1 FrameMaker

V.2 InDesign

V.3 Writer

V.4 Word

V.5 LaTeX

I. Manejo de software para documentar

Tema y subtemas

V

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.

146

D o c u m e n taci ó n t é cn i ca

Características del FrameMaker

V.1 FrameMaker

Adobe FrameMaker® es un programa para la publicación y creación de documen-tos 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 mante-ner la uniformidad y características que den coherencia al formato final.

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 pu-blicado en varios formatos como xml/html, impresión en papel, pdf, wsf, We-bHelp, 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 in-formació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 vec-toriales escalables.

La siguiente imagen muestra la ventana principal de FrameMaker®.

Utilización del FrameMaker

147

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

Extensión del archivo

Esta herramienta ofrece además del tratamiento de textos, la posibilidad de em-plear 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 composicio-nes profesionales para la edición digital e impresa. Entre sus características se in-cluyen 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.

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

Características del InDesign

Utilización del InDesign

Los archivos que resultan del empleo de InDesign tienen la extensión .indd. Extensión del archivo

148

D o c u m e n taci ó n t é cn i ca

Características del Writer

V.3 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 (mul-tiplataforma), 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 en-cuentran programas para presentaciones, hoja de cálculo, bases de datos y publi-cació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:

• Barradetítulo• BarradeMenú• BarradeHerramientas• ReglaVertical• ReglaHorizontal• BarradeEstado• Áreadeingresodedatos

En la siguiente imagen se observa la pantalla inicial de Writer.

149

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.

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 edi-tor de fórmulas (Math) gratuito para cuando requiera utilizar simbología de ma-temá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

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 soft-ware, 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 herra-mientas que se encontrarán ahí.

Una vez que se selecciona alguna ficha aparecen funciones específicas repre-sentadas 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.

Características de Word

Utilización del Writer

Extensión del archivo

Elementos de Word

150

D o c u m e n taci ó n t é cn i ca

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.

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 predetermi-nados y de creación por parte del usuario.

Word no es propiamente un programa para diseño de publicaciones profesio-nales, pues si bien permite el uso de diferentes elementos como imágenes, gráfi-cas 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éc-nica que no requiere de extensa simbología especializada o de textos muy grandes.

La extensión de los documentos creados en Word es .doc.Extensión del archivo

¿Qué encuentras en común en la pantalla inicial de InDesig, Writer y Word?

Visualización de word

V.5 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 mis-mos 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

ECaracterísticas de LaTeX

151

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 impre-sión final.

Entre sus características está el que se distribuye bajo distintos sistemas ope-rativos, 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 cien-tíficos que se complementa, en principio, por un compilador. Uno de los compila-dores 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 presen-tando 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 esen-ciales:

• 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.

• 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.

En la siguiente imagen se observa el preámbulo y cuerpo de un texto en LaTeX.

Procedimiento para LaTeX

Imagen de un texto LaTeX

Partes del documento LaTeX

152

D o c u m e n taci ó n t é cn i ca

LaTeX es un sistema de preparación orientado principalmente a la elabora-ció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 adecua-do para textos sencillos que no requieran simbología, sino que es útil precisa-mente 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, or-ganizado en secciones bien delimitadas y características específicas de formato desde el inicio.

La extensión de los archivos LaTeX es .tex.

Utilización del LaTeX

Extensión del archivo

¿Con qué elementos se podrían comparar en la documentación técnica el preámbulo y cuerpo en LaTeX?

153

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. _____

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. _____

154

D o c u m e n taci ó n t é cn i ca

Compilador: Los compiladores son programas o herramientas encargadas de compilar. Un compilador toma un texto (código fuente) escrito en un len-guaje de alto nivel y lo traduce a un lenguaje comprensible por las compu-tadoras (código objeto).

Básicamente, existen dos grandes formas de ejecutar programas: programas compilados (previamente pasados por un compilador) y pro-gramas 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 len-guaje 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 servi-cios para estructurar, almacenar e intercambiar 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.

Glosario

Fuentes de información

155

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

F

V

V

V

V

V

F

F

F

F

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. _____

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. _____