Notas sobre Producción Documental Científica y Técnica

1. Notas sobre Producción Documental Científica y Técnica Juan Méndez Instituto Universitario de Sistemas Inteligentes y Aplicaciones Numéricas en Ingeniería ULPGC Julio 2004

2. INDICE • Aspectos Metodológicos y Técnicos de la Producción Documental • Estructura del Documento y Elementos Básicos • Tablas, Columnas y Referencias Internas • Matemáticas. AMS • Figuras Internas • Figuras Importadas • Material Bibliográfico, Indices temáticos y de contenidos • Hipertexto • Introducción a la Confección de Estilos • Trabajo Personal Final

3. Metodología y Programación del Curso • Clases de Teoría • Ejercicios en el Laboratorio • Trabajo Final

4. Las Producción Documental para un entorno Científico y Técnico. Tres enfoques y aspectos complementarios • Metodología.Como debe abordarse el proceso, los componentes y materiales • Técnica.Recursos, herramientas y utilidades • Gestión.Organización de la producción, conservación y modificación

5. Modalidades de la Producción Personal/Individual. Carácter libre y creativo Corporativa e Institucional. Ajustada a moldes y formatos Publicaciones Editoriales. Fuertemente restringida en contenidos, estilo, espacio y lenguaje.

6. ¿Como escribir artículos e informes científico- técnicos? http://maths.uwa.edu.au/~mike/swc Expresarse correctamente es difícil. Escribir correctamente es aún más difícil. Recomendación: Ponerse en el lugar del lector Solución: Revisor y/o Crítico previo. Otros Lenguajes: Imprescindible el traductor y/o revisor Google: “writing papers”

7. Fases de Ejecución (Receta) Pensar. Construir un modelo mental de los contenidos y enfoques. Planificar. Establecer un proyecto de organización de los contenidos. Escribir. Generar los documentos y materiales gráficos. Revisar y Corregir: “Tropecientas” veces.

8. Partes de una Publicación Científica Título Autor(es) Filiación y/o Dirección Resumen [Palabras Claves] [Indice] [Listas de Figuras y Tablas] Introducción Material Propio Conclusiones o Resultados [Agradecimientos] Bibliografía [Apéndices] [Indice Temático]

9. Sistema IMRD En entornos científicos-experimentales y de ciencias sociales Introducción. Idéntico significado Métodos. Elementos teóricos e instrumentos formales utilizados en el trabajo Resultados. Principales hallazgos o metas alcanzadas. Discusión. Significado, relevancia y comparación de los resultados alcanzados. En los entornos científico-técnicos se suele ser más libre en cuanto a la organización de un informe. Generalmente los resultados y discusión se suelen agrupar en una sección única, mientras que para los métodos se adopta una estructura muy libre.

10. Título Debe ser corto y conciso, no más de 12 palabras No debe tener formulas y a ser posible sin siglas Evitar las generalizaciones Es el primer escaparate de presentación. Debe cuidarse y elegirse adecuadamente Diseñar varias versiones del título

11. Autor(es) Nombre del o de los autores del trabajo Evitar los nombres completos Juan Méndez Rodríguez (NO) J. Méndez Juan Méndez J. Méndez-Rodríguez El primer autor es la referencia principal Martínez et al

12. Filiación Descripción de la institución de los autores, así como la dirección cuando se requiera. Incluir siempre el e-mail, y si está aceptado el WWW Ser breves, si es posible.

13. Resumen Descripción breve del contenido del trabajo Suele estar limitado a un número máximo de palabras. Se escribe al final de la elaboración del documento. Aumento de la perspectiva Es la tarjeta de presentación del trabajo, debe cuidarse mucho. Debe contener todas la palabras importantes relacionadas con el tema (Búsquedas informáticas).

14. Palabras claves Un conjunto de palabras que se utilizan para delimitar el objeto del trabajo. Utilizar las contenidas en trabajos similares. No inventar palabras claves (nadie las utilizará). En algunos casos existen catálogos, utilizarlos. Códigos Unesco(Inútiles y Obsoletos) Utilizadas en búsquedas (Obsoleto)

15. Introducción Presentación del problema que motiva el estudio o trabajo. Revisión comentada de los precedentes, enfoques alternativos y trabajos similares. Incluir las referencias bibliográficas clásicas el tema y los trabajos más modernos. Presentación breve de los principios básicos que se van a utilizar. Breve índice comentado de lo que se presentará al lector a lo largo del trabajo.

16. Para el orden exacto de la introducción se aconseja el siguiente: 1. Centrar el campo de estudio en el que se enmarca el trabajo. Con abundancia de referencias a los trabajos más significativos del área, así como a los éxitos alcanzados por la disciplina. 2. Definir la situación problemática, sobre la que se trabajará. 3. Comentar brevemente las líneas generales de la aportación señalando las ventajas o mejoras que se esperan alcanzar. Evitar detalles. 4. Comentar brevemente los apartados que el se presentaran seguidamente, a modo de comentario del programa.

17. Conclusiones Un comentario sobre las aportaciones más significativas del trabajo. Discusión detallada de las consecuencias de los resultados encontrados. Impacto o relevancia del material presentado. Líneas futuras de continuación del trabajo. Ni muy corto, ni muy largo.

18. Agradecimientos Parte preceptiva. Reconocimiento de las instituciones que hayan concedido becas o financiación de proyectos. También en el caso de cesión de material gráfico o experimental. Bibliografía Relación detallada de las referencias documentales citadas en el trabajo. Se debe adoptar un formato normalizado de referencias

19. Apéndices Para demostraciones o cálculos que requieren un detalle excesivo. En general para todos los detalles cuya exposición rompería el tono o planificación del trabajo. Indices Temáticos En publicaciones extensas como libros o informes densos, se debe incluir un índice temático ordenada alfabéticamente.

20. Aspectos técnicos de la producción documental. Entornos, herramientas y utilidades para la producción documental. Factores a considerar: Coste. Plataformas. Implantación. Soporte regulador, evolución. Robustez. Interacción. Multimedia. Aprendizaje.

21. Entornos más utilizados MS Word. Alta interacción, precio medio, baja estabilidad y robustez, muy difundido, plataforma única, aprendizaje fácil. Adove. Alta interacción, alto precio, gran robustez, poco implantado (Reader muy implantado). (La)Tex. Alta estabilidad y robustez, muchas plataformas, gratuito, poca interacción, muy difundido, aprendizaje medio.

22. Formas de Diseño Documental • Diseño Visual. El usuario diseña tanto los contenidos como el aspecto • visual del documento. WYSIWYG. • Para aplicaciones sencillas es altamente creativo y eficaz. • Para aplicaciones más complejas el usuario suele fracasar(inestabilidad) • Poco adecuado a la producción corporativa y editorial. • Diseño Lógico. El usuario diseña los contenidos, mientras que el • aspecto visual esta diseñado previamente. • Robusto para aplicaciones sencillas y complejas. • Frustrante para el usuario creativo (pocos grados de libertad). • Reduce los costes de los procesos documentales.

23. Error Común Utilizar el diseño lógico de documentos con mentalidad de usuario visual y creativo. Cada modalidad tiene sus ventajas y genera distintos tipos de frustraciones. El usuario debe valorar las ventajas e inconvenientes de cada alternativa.

24. Tex (Donald Knuth) • Un programa de composición tipográfica que utiliza un fichero del usuario describiendo el contenido del documento. • Difícil de utilizar. • De propósito general (ciencia, humanidades, poesía) LaTex (Leslie Lamport) • Un conjunto de macros y herramientas para utilizar Tex. • Fácil de utilizar. • Orientado a la ciencia y técnica • Evoluciona • LaTex 2.09 -> LaTex2e -> LaTex3

25. LaTex. El entorno de diseño lógico de documentos más utilizado. Gratuito Multiplataforma No-Propietario Internacinalización. Alfabetos no latinos Soportado: Grupos de Usuarios

26. Grupos de Usuarios de Tex TUG (Tex User Group) Internacional: http://www.tug.org Grupos específicos Hispano: CervanTex http://apolo.us.es/CervanTex CTAN (Comprehensive Tex Archive Network) Servidores: USA: ctan.tug.org UK: ftp.tex.ac.uk www.tex.ac.uk Alemania: ftp.dante.de www.dante.de

27. Linux: La mayor parte de las distribuciones incorporan TeX y LaTeX como packages básicos. Windows: Una de las mejores distribuciones de LaTeX es MikTeX www.miktex.org ¡Tanto TeX como LaTeX son gratuitos! El mejor entorno de edición para LaTeX es Winedt, www.winedt.com Que se suministra gratuitamente durante un mes, pero cuyo coste es bajo. Resultan imprescindibles además, un visualizador Poscript como ghostview y un visualizador Pdf como el Reader de Adobe

28. Entorno de Producción Documental Científico-Técnica PDF PS DVI Visualizadores LaTeX Editores TeX .eps Editores Gráficos Packages: Librerías de Edición

29. ESTRUCTURA DEL DOCUMENTO Cabecera, preámbulo y cuerpo. Ficheros y compilación. Estilos: Class y packages. Castellanización. Tipos de fonts. Unidades de medida. Layout y espaciado. Espacios horizontal y vertical Cambios de línea y página Contenido del preámbulo. Comandos propios. Párrafos y centrados. Secciones, subsecciones, ... Resumen, abstract. Entornos de usuario

30. Los documentos LaTex son ficheros planos de tipo ASCII con la extensión .tex Desde el punto de vista del sistema operativo carecen de formato, lo que los hace idóneos paras ser trasmitido en e-mail e intercambiados libremente entre diferentes plataformas. Los comandos LaTex son en general de la forma: \nombre[opciones]{argumentos} El signo % se utiliza para indicar el comienzo de un comentario desde ese punto hasta el final de la línea.

31. Cabecera, preámbulo y cuerpo. La estructura general de un documento LaTex es de la forma siguiente: \documentclass[opciones]{estilo} % cabecera %preámbulo \begin{document} %cuerpo \end{document}

32. Ficheros y compilación Fichero de usuario .tex Ficheros auxiliares latex .aux, .toc Compilador(2 o más fases) .dvi Fichero resultado

33. Eslilos: Class y Packages El estilo de un documento resulta de la conjunción de tres elementos libremente elegidos por el usuario: 1. La clase(class) general del documento. 2. Los paquetes(package) o librerías de edición incorporadas en el documento. 3. Las modificaciones puntuales introducidas por el propio usuario.

34. Class La clase del documento define la mayor parte de sus características \documentclass[opciones]{class} Las clases más utilizadas son: article report book letter específicas de la editorial Cada clase define multitud de propiedades que rigen la conformación visual del documento y su estructura Las clases son diseñadas por los (muy) expertos.

35. Opciones de clases Tamaño de los fonts 10pt 11pt 12pt Tipo de papel a4paper landscape Formato del documento onecolumn twocolumn oneside twoside titlepage \documentclass[a4paper,11pt,twocolumn]{article}

36. Packages Otro tipo de opciones o utilidades se pueden incluir mediante packages que son adiciones al estilo del documento, o bien utilidades diversas. La declaración del uso de packages se incluye en el preámbulo. \usepackage[opciones]{nombre} Package = Librería de edición Norma: Utilizar clases y packages de dominio público muy bien referenciadas y depuradas. Las clase y packages de un documento no se incorporan en un documento, por ello si ese documento se traslado o envía a otro usuario, el receptor debe poseer la clase y packages utilizados.

37. Castellanización Se puede utilizar el lenguaje castellano en LaTex mediante la inclusión de dos packages específicos: Para la utilización de teclados spanish (acentos, ñ y Ñ) \usepackage[latin1]{inputenc} Para la rotura de palabras (hipenación) adaptadas al castellano, y títulos traducidos: \usepackage[spanish]{babel}

38. Fonts El tipo de font utilizado en un documento se elige en la clase del mismo. El usuario puede realizar modificaciones de tamaño y aspecto del tipo base. Las modificaciones de font tienen lugar básicamente en el ámbito que se denomina grupo. {modificador texto} Los modificadores de tamaño son: \tiny \scriptsize \footnotesize \small \nomalsize \large \Large \LARGE \huge \Huge

39. Los modificadores de aspecto del font son: \rm roman \bf bold face \tt typewriter \it italic \sl slanted \sc small caps \sf sans serif Estos modificadores tambien se puede ejecutar como comandos: \textrm{texto} \textb{ } \textnormal{ } \texttt{ } \textit{ } \textsl{ } \textsc{ } \textsf{ }

40. Unidades de medida En LaTex se pueden modificar y utilizar distintos parámetros de distancia asociados al diseño del documento. Las unidades posibles osn las siguientes: cm centímetro mm milímetro in pulgada pt puntos (1in = 72.27pt) em medida de longitud de la letra M ex medida de altura de la letra x Para modificar parámetros de longitud se utiliza el comando: \setlength{\parametro}{valor}

41. Layout y espaciado Los márgenes y dimensiones del texto están definidos en la clase, pero el usuario puede modificarlos. Los parámetros a modificar están contenidos en una hoja anexa. \setlength{\textwidth}{6.25in} \setlength{\oddsidemargin}{0cm} \setlength{evensidemargin}{0cm} \setlength{\textheight}{9in} \setlength{topmargin}{0cm} El espaciado entre líneas se puede modificar con: \renewcommand{\baselinestretch}{factor} donde factor=1.0, 1.5, 2.0, ... Es el espaciado simple, medio, doble

42. El margen izquierdo incluye una pulgada demás del valor especificado

43. Espacios horizontal y vertical Los comandos \hspace{longitud} y \hskip{longitud} permiten realizar saltos de espacio dentro de una línea. \hspace es ignorado si ocurre al principio o fin de una línea. \hspace*{longitud} se considera siempre \ un pequeño espacio de separación El comando \vspace{alto} produce un salto en el texto de la altura definida, se ignora si tiene lugar al principio y fin de la página. \vspace*{alto} se considera siempre.

44. Cambios de línea y página Podemos cambiar de línea sin ajustar hasta los márgenes con los comandos: \\ \newline Podemos forzar una justificación hasta los márgenes con: \hfill con blancos \dotfill con puntos \hrulefill con línea Podemos cambiar de página con: \newpage \clearpage \cleardoublepage

45. Contenidos del preámbulo En el preámbulo del documento se especifican además de los pakacges utilizados, diversas declaraciones como: Comandos propios. Titulo, autor y fecha. Personalizaciones de estilo. \title{texto} \author{autor} \maketitle

46. \documentclass{article} \title{Primera introducción a LaTex} \author{L. Primero} \begin{document} \maketitle Era se una vez que un estudiante de LaTex aprendió que la mejor forma de escribir LaTeX es mediante \LaTeX, al igual que \TeX es la mejor forma de escribir TeX \end{document}

47. Nota de pie en los autores Ejemplo de página de título utilizando titlepage

48. Comandos propios El usuario puede definir sus propios comandos en la forma: \newcommand{nombre}[narg]{definición} Donde los argumentos se referencian como #1, #2, ... \newcommand{\bigita}[1]{\textit{\LARGE #1}} ... seguidamente un texto \bigita{itálico grande} de demostración ... Cuando el comando ya existe previamente y se quiere redefinir se utiliza: \renewcommand

49. Párrafos y centrados Un párrafo es un conjunto de líneas separadas por una línea en blanco. La primera línea del párrafo sufre un indentado hacia la derecha: Esta es la primera línea de un párrafo, como puede verse comienza más la derecha de esta otra que comienza en el margen normal del texto Los párrafos en LaTex están justificado entre los márgenes. Podemos modificar el indentado con: \noindent elimina el indentado del párrafo \indent permite el indentado \parindent es la magnitud del indentado, se modifica con \setlength{\parindent}{nuevo-valor} \par provoca el comienzo de un nuevo párrafo

50. Se pueden generar párrafos centrados con indentado en ambos lados con el entorno \begin{center} texto de un párrafo con organización espacial centrada. \end{center} Un entorno es un espacio del documento encerrado en un \begin y un \end que posee características especiales.