Manejo de software para documentar Manejo de software para

Unidad V
Manejo de
software para
para
documentar
documentar
143
Do cumentación técnica
Esquema conceptual: Unidad V
Características
Utilización
Extensión del archivo
Características
Utilización
Extensión del archivo
2. InDesign
3. Writer
1. FrameMaker
Características
Utilización
Extensión del archivo
UNIDAD V
Manejo de software
para documentar
144
5. LaTeX
Características
Programa
Procedimiento para LaTeX
Utilización
Extensión del archivo
4.Word
Características
Utilización
Extensión del archivo
Semana 13
Unida d V. Ma nejo de soft wa r e pa r a d o cumenta r
Presentación
P
ara 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.
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
145
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.
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.
Utilización del
FrameMaker
146
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®.
Unida d V. Ma nejo de soft wa r e pa r a d o cumenta 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.
Extensión del archivo
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.
Características del
InDesign
InDesign es útil para crear composiciones para revistas, publicaciones periódicas y folletos, con opciones de pdf, y documentos interactivos.
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
Los archivos que resultan del empleo de InDesign tienen la extensión .indd.
147
Extensión del archivo
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.
Unida d V. Ma nejo de soft wa r e pa r a d o cumenta 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.
Extensión del archivo
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 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í.
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.
149
Características de
Word
Elementos de Word
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.
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.
150
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.
Extensión del archivo
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
Unida d V. Ma nejo de soft wa r e pa r a d o cumenta 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.
Procedimiento para
LaTeX
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.
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.
En la siguiente imagen se observa el preámbulo y cuerpo de un texto en LaTeX.
151
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.
Extensión del archivo
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
Unida d V. Ma nejo de soft wa r e pa r a d o cumenta 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.
_____
153
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.
_____
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.
Unida d V. Ma nejo de soft wa r e pa r a d o cumenta 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.
V
_____
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.
V
_____
7. Word es el programa recomendado para textos científicos extensos que requieren
simbología.
F
_____
155
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.
F
_____
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
_____