UF2 - INTRODODUCCION

Un sistema pobremente documentado carece de valor aunque haya funcionado bien en alguna ocasión.
En el caso de programas pequeños y poco importantes que solo se utilizan durante un corto período de
tiempo, unos cuantos comentarios en el código podrían ser suficientes. No obstante, la mayoría de los
programas cuya única documentación es el código, se quedan obsoletos rápidamente y es imposible
mantenerlos.

Si no documentaron sus decisiones, se verán siempre cometiendo los mismos errores y tratando de
comprender lo que pudieron haber descrito fácilmente en una ocasión.

1. FICHEROS AYUDA. FORMATOS

Los formatos de ayuda más destacados:
1.1. PDF (O CUALQUIER FORMATO OFIMÁTICO)
Son los más habituales y fáciles de realizar. Pueden ser abiertos por cualquier visor pdf en el
primer caso o bien herramientas ofimáticas de carácter general en el segundo caso.
1.2. WINHELP (.HLP)
Los archivos con extensión hlp son los archivos de ayuda de Windows. Fue la plataforma de
ayuda más popular desde Windows 3.0 a Windows XP.
1.3. CHM.2
Se publicó como sucesor del sistema de ayuda.
1.4. MICROSOFT ASISTENCIA MARKUP LANGUAGE (MAML).
Es un lenguaje de marcado basado en XML desarrollado para proporcionar asistencia al usuario
(“ayuda en línea”) para el sistema operativo Microsoft Windows Vista y sucesivos.
1.5. FICHEROS DE AYUDA EN LINUX.
Los ficheros de ayuda generados con el comando -man- para conocer el uso y opciones de los
comandos. Por otro lado están los comandos ‘whatis’ que permiten una breve descripción de
los comandos y ‘apropos’ que nos permiten conocer los comandos relacionados con un
determinado temas.
2. HERRAMIENTAS DE GENERACIÓN DE AYUDAS.
2.1. HELPMAKER
Es una aplicación para crear archivos de ayuda para programas. Permite la creación de archivos
de ayuda enteros; en diferentes formatos tales como: WinHelp, RTF (texto enriquecido) y
HTML-Help.
2.2. MICROSOFT HTML HELP WORKSHOP
Permite crear ficheros de ayuda de windows (HLP) y páginas web.
2.3. DOCBUILDER
Es una aplicación capaz de generar archivos de documentación y ayuda en diversos formatos
para el software desarrollado por usted mismo.
2.4. WINHELP COMPILER
Crea ficheros de ayuda Windows hlp.
3. AYUDA GENÉRICA Y SENSIBLE AL CONTEXTO
Una ayuda genérica es una ayuda que no trata sobre ningún tema específico, sino sobre la
aplicación en sí. Frente a este concepto de ayuda esta la ayuda sensible al contexto. Los programas
están volviéndose más inteligentes sobre cómo ofrecer ayuda que resulte apropiada para las tareas
que actualmente usted está haciendo. Las cajas de diálogo tienen un pequeño botón arriba a la
derecha con el símbolo de interrogación (?). Si usted pulsa este botón y después pulsa sobre algo en
la ventana, conseguirá que surja una explicación. Esto resulta muy útil cuando no entiende las
opciones que se presentan en la caja de diálogo.
4. TABLAS DE CONTENIDOS, ÍNDICES, SISTEMAS DE BÚSQUEDA, ENTRE OTROS
Una vez creados los diferentes capítulos de nuestra ayuda en diferentes archivos HTML, estos son
aglutinados en un archivo de proyecto con extensión HHP. Archivos H: añaden un ID para
identificador de capítulo. Archivos HHK: índices. Archivos HHC: tablas de contenido.
Con todo esto, compilamos el proyecto y obtenemos un archivo de ayuda con extensión CHM.
 4.1. ARCHIVOS HHC (CONTENIDO)
En un archivo HHC se define la estructura del libro de contenidos de nuestra ayuda. El formato
de un archivo de contenido es HTML.
4.2. ARCHIVOS HHK (ÍNDICE).
Un archivo de índices también está descrito en formato HTML. En él se hacen referencia todas
las cadenas de búsqueda para cada capítulo
4.3. ARCHIVOS H (DECLARACIÓN DE ID DE CONTEXTO).
En un archivo H definimos (con el comando #define) los alias que referenciaremos a cada
capítulo (archivos HTM) de nuestra ayuda.
4.4. ARCHIVOS HTM (CUERPOS DE LA AYUDA).
Los archivos HTM son archivos en formato HTML en los que relatamos toda nuestra ayuda.
Cada capítulo o tema de nuestra ayuda conforma un archivo HTM.
5. TIPOS DE MANUALES: MANUAL DE USUARIO, GUÍA DE REFERENCIA, GUÍAS RÁPIDAS, MANUALES
DE INSTALA CIÓN, CONFIGURACIÓN Y ADMINISTRACIÓN, DESTINATARIOS Y ESTRUCTURA.

5.1. TIPOS DE DOCUMENTACIÓN

• Interna: es aquella que se crea en el mismo código, ya puede ser en forma de comentarios o
de archivos de información dentro de la aplicación.
• Externa: es aquella que se escribe en cuadernos o libros, totalmente ajena a la aplicación en
sí. Dentro de esta categoría también se encuentra la ayuda electrónica.
5.2. LA GUÍA TÉCNICA.
En la guía técnica o manual técnico se reflejan el diseño del proyecto, la codificación de la
aplicación y las pruebas realizadas para su correcto funcionamiento. Generalmente, este
documento está diseñado para personas con conocimientos de informática, generalmente
programadores. El principal objetivo es el de facilitar el desarrollo, corrección y futuro
mantenimiento de la aplicación de una forma rápida y fácil.

5.2.1. Cuaderno de carga.

Es donde queda reflejada la solución o diseño de la aplicación. Esta parte de la guía es
únicamente destinada a los programadores. Debe estar realizado de tal forma que permita
la división del trabajo.
5.2.2. Programa fuente.
Es donde se incluye la codificación realizada por los programadores. Este documento
puede tener, a su vez, otra documentación para su mejor comprensión y puede ser de
gran ayuda para el mantenimiento o
desarrollo mejorado de la aplicación. Este documento debe tener una gran claridad en su
escritura para su fácil comprensión.
5.2.3. Pruebas.
Es el documento donde se especifican el tipo de pruebas realizadas a lo largo de todo el
proyecto y los resultados obtenidos.

5.3. GUIA DEL USUARIO.

Es lo que comúnmente llamamos el manual del usuario. Contiene la información necesaria
para que los usuarios utilicen correctamente la aplicación.
Este documento se hace desde la guía técnica pero se suprimen los tecnicismos y se presenta
de forma que sea comprensible para el usuario que no sea experto en informática.
Un punto a tener en cuenta en su creación es que no debe hacer referencia a ningún apartado
de la guía técnica y, en el caso de que se haga uso de algún tecnicismo, debe ir acompañado de
un glosario al final de la misma para su fácil comprensión.
5.4. LA GUÍA DE INSTALACIÓN.
Es la guía que contiene la información necesaria para implementar dicha aplicación. Dentro de
este documento se encuentran las instrucciones para la puesta en marcha del sistema y las
normas de utilización del mismo. Dentro de las normas de utilización se incluyen también las
normas de seguridad, tanto las físicas como las referentes al acceso a la información.
6. CONFECCIÓN DE TUTORIALES MULTIMEDIA.

6.1. ¿ENTIENDE LAS NECESIDADES DE SU TARGET?

Su misión es sencilla: hacer un material útil, antes de crear un tutorial multimedia, asegúrese
de que hay una necesidad clara comunicada por su audiencia.
6.2. SEA BREVE, LA ATENCIÓN DISMINUYE RÁPIDO.
Los tutoriales multimedia más populares suelen ser muy cortos.
6.3. ESPIAR A LA COMPETENCIA.
Ver y analizar lo que otras personas han hecho sobre la temática sobre la que usted quiere
hacer su tutorial.
6.4. PREPÁRESE ANTES DE APRETAR EL BOTÓN DE GRABAR.
Como ve, no hay sitio para la improvisación si quiere grabar grandes tutoriales. El secreto está
en tener un plan y ejecutarlo al pie de la letra, estar enfocado en lo que va a decir y hacerlo de
forma breve.
6.5. CONCLUSIÓN.
Resuma lo que ha presentado en el tutorial de forma muy breve.
7. HERRAMIENTAS DE CAPTURA DE PANTALLAS Y SECUENCIAS DE ACCIONES.

7.1. ZSCREEN.
Está enfocado principalmente a poner nuestras capturas online. Nos permite subirlas a varios
servicios al mismo tiempo o a nuestro servidor por medio de FTP.
7.2. GREENSHOT.
Es un pequeño programa bastante minimalista pensado para que lo lleves a todas partes, pues
no necesita de instalación. Dispone de un pequeño editor incorporado que nos permite
modificar nuestra imagen y añadirle flechas, resaltar elementos, ofuscarlos, etc. Sin ser una
maravilla, cumple con su función de manera correcta y, al ser portátil, nos permite llevarlo a
cualquier parte en nuestra memoria USB.
7.3. LIGHTSHOT.
Nos permite guardar las imágenes en nuestro disco, ponerlas directamente on line o editarlas
en la nube por medio de Pixlr.
7.4. PRTSRC.
Otra aplicación de captura.
7.5. SCREENSHOT CAPTOR.
Uno de los más completos, con muchas opciones, tanto para capturar como para editar.
7.6. JET SCREENSHOT.
Nos permite subir las capturas directamente a nuestro FTP o a su web.
7.7. SCREENPRESSO.
Nos da la opción de compartir nuestras capturas directamente en Twitter, Facebook, Flickr y
otros medios.
8. HERRAMIENTAS PARA LA CONFECCIÓN DE TUTORIALES INTERACTIVOS, SIMULACIÓN

Una de las alternativas multimedia para elaborar contenidos multimedia, es mostrar lo que
hacemos en nuestra pantalla, es decir, realizar una videocaptura o screencasting.
8.1. VERSIÓN ESCRITORIO.

8.1.1. Aviscreen.
Aviscreen nos permite grabar nuestra pantalla en formato AVI o bien tomar fotos de nuestra pantalla
en formato JPG.
8.1.2. CamStudio.
Es un software opensource o de código abierto que nos permite grabar nuestra pantalla en formato
AVI. Funciona únicamente con Windows.
8.1.3. Webinaria.
Webinaria es otro software open source, en este caso podemos grabar en formato AVI y FLV La
principal ventaja de Webinaria es la posibilidad de grabar audio junto al vídeo de nuestra pantalla.
 8.1.4. Krut.
Es otra alternativa open source. En este caso los vídeos son grabados en formato quicktime (mov)
Krut, además permite grabar audio y un sector específico de la pantalla.
8.1.5. Jing.
Además de grabar nuestra pantalla Jing nos permite tomar fotos de la misma, subir nuestro vídeo a
una cuenta gratuita o bien descargar el mismo el formato SWf.
8.2. VERSIONES WEB.

8.2.1. Screencast-O-Matic.
Una web basada en Java que permite grabar nuestra pantalla sin necesidad de descargar software
alguno.
8.2.2. ScreenToaster.
Screen Toaster permite grabar nuestros vídeos sin necesidad de descargar nada, enviar el vídeo por
email o bien anexarlo en una web con un solo clic.

9. COMPONENTES DE UNA APLICACIÓN. EMPAQUETADO.

El empaquetado de aplicaciones consiste en proporcionar a los futuros usuarios las

aplicaciones en forma de paquetes, a los que se suele llamar en inglés: software bundle o
application bundle. Estos paquetes están formados por:

• Los programas ejecutables de la aplicación.

• Las bibliotecas necesarias de las que depende. Otro tipo de ficheros (como imágenes,
bases de datos, ficheros de audio, traducciones y localizaciones, etc.). Todos en ellos
dentro del mismo fichero forman un todo o un conjunto.
• Las bibliotecas de las que depende el programa pueden haber sido enlazadas tanto
de forma dinámica como también estática.

9.2. LINUX.

Tenemos dos tipos de paquetes que sobresalen del resto:

• .rpm: (Redhat Package Manager) de la familia de RedHat (RHEL,
Fedora,CentOS), Mandriva,Suse.
• .deb: de la familia de Debian (Debian,Ubuntu, y derivados).

9.1. WINDOWS.
El formato de empaquetado es msi. Se definen como instaladores de Microsoft, a
saber, aquellos paquetes de software que contienen la información necesaria para
automatizar su instalación.

9.3. JAVA.

El principales jar. Es un tipo de archivo que permite ejecutar aplicaciones escritas en el

lenguaje Java. Los archivos JAR están comprimidos con el formatozip y cambiada su
extensión a jar.

10. INSTALADORES. PAQUETES DE INSTALACIÓN. HERRAMIENTAS PARA CREAR PAQUETES

DE INSTALACIÓN. PARÁMETROS DE LA INSTALACIÓN.

10.1 . WINDOWS.
Los exe y los misi. Estos dos últimos son utilizados con mayor frecuencia en el entorno
gráfico de Windows. La herramienta encargada de llevar a cabo la instalación es Windows
 Installer que es un motor para la instalación, mantenimiento y eliminación de programas
en plataformas Windows.
Los paquetes MISI (MicroSoft Installer) se definen como instaladores de Microsoft o
paquetes de software que contienen la información necesaria para automatizar su
instalación, minimizando la intervención manual del usuario, ya que toda la información
iría contenida en el propio fichero “misi”.

10.2. LINUX.

10.2.1 Compilar el paquete.

Bajar el código fuente, comprimido en un archivo targzo.tar.bz2. entramos en la consola

(shell) y nos movemos hasta el directorio donde tengamos el

paquete. Si el paquete está en formato targz escribimos:

# tar -xzvf archivo.tar.gz //para descomprimir el paqute

Si está en tar.bz2 escribimos:

bzip2 -dic archivo.tar.bz2 tar -xv

Una vez hecho esto, hay que entrar en el directorio creado y compilar el código para obtener la
aplicación

funcional y que consiste en escribir en la siguiente línea de comandos lo siguiente:

it. . / configure it make it make install

Lo que estamos haciendo es compilando el programa a partir de código fuente.

11. ASISTENTES DE INSTALACION Y DESINSTALACION. PAQUETES AUTOINSTALABLES.

11.1 WINDOWS.

La desinstalación de software es el proceso de revertir los cambios producidos en un sistema

por la instalación del mismo. Por ello no solo deben ser borrados los archivos, sino también
cambios en otros aspectos del software como, por ejemplo, eliminar usuarios que hayan sido
creados, retirar derechos concedidos, borrar directorios creados hasta llevar la contabilidad en
un sistema de gestión del sistema, en el caso Windows el Registro.
Cada vez es más difícil la desinstalación, dado que muchas bibliotecas se comparten entre
aplicaciones de diferentes productores de software que utilizan enlaces duros o simbólicos a
través del directorio.

11.2. LINUX.

En cuanto a Linux los comandos para desinstalar aplicaciones son los siguientes:

• Desinstalar paquete: sudo apt-get remove “nombre-paquete.”

• Borrar los archivos de configuración: sudo apt-get purge “nombre-paquete.”
• Borrar los archivos descargados con la aplicación: sudo apt-get clean “nombre-
paquete.”

12. FICHEROS FIRMADOS DIGITALMENTE.

 12.1 . ESTRUCTURA DE LA FIRMA.
Una firma electrónica es un fichero que contiene información sobre el documento original,
el firmante, la fecha de la firma, algoritmos utilizados y posible caducidad de la firma.

12.3. FIRMAS CON MÚLTIPLES USUARIOS.

• Firmas simples. Son las firmas básicas que contienen la firma de un solo firmante

• Cofirma o firma en línea. Es la firma múltiple en la que todos los firmantes están al
mismo nivel y en la que no importa el orden en el que se firma. La cofirma se utiliza en
la firma de documentos que son resultados de reuniones, conferencias o comités.

• Contrafirma o firma en cascada. Firma múltiple en la que el orden en el que se firma

es importante.

12.4. FIRMAS LONGEVAS Y SELLO DE TIEMPO.

Para verificar una firma es necesario: Comprobar la integridad de los datos firmados
asegurando que éstos no hayan sufrido ninguna modificación.

Comprobar que el estado del certificado con el que se firmó era el correcto, es decir,
era vigente en el momento de la operación.

En el caso de la firma electrónica básica, si el certificado está caducado

automáticamente se da la firma como no válida.

12.7. RESELLADO.

Antes de que el certificado caduque es necesario resellar o aplicar de nuevo el Sello

Temporal para mantener la validez temporal de la firma.

12.8. HERRAMINETAS GRATUITAS PARA LA FIRMA ELECTRÓNICA BASADAS EN

CERTIFICADO DE DOCUMENTOS.

Presentamos 5 aplicaciones de firma que le ayudarán a firmar documentos PDF (y

también otros formatos).

1. Firma fácil, 2. Firma, 3. EcoFirma, 4. Ksi ESecure, 5. XolidoSigra.

13. DESCARGA, INSTALACION Y EJECUCION DE APLICACIONES UBICADAS EN SERVIDORES WEB.

Un sistema de gestión de paquetes, también conocido como “gestor de paquetes”, es una colección
de herramientas que sirven para automatizar el proceso de descarga, instalación, actualización,
configuración y eliminación de paquetes de software.

13.1. SISTEMAS BASADOS EN PAQUETES BINARIOS.

Dpkg
apt-get install <paquete> Instalar un paquete.
apt-get remove <paquete> Desinstalar un paquete.
Fink
Para Mac OS X
RPM
Usado por un gran número de distribuciones de GNU/Linux
TGZ
Empaqueta el software usando tar y gzip.
Pacman
Usa binarios pre compilados distribuidos en un fichero pkg.taraz
13.2. SISTEMAS DE METAPAQUETES.

Los siguientes sistemas unifican la gestión de paquetes para muchas o todas las
distribuciones de GNU/Linux y otras variantes de Unix:
Klik, Autopackage, Epm

13.3. SISTEMAS (PRIORITARIOS).

Sistemas de gestión de paquetes es usada por algunos sistemas operativos

propietarios para tratar con la instalación tanto de paquetes propietarios como libres.
Nos interesa el framework NET de Microsoft.

13.4. GESTIÓN DE PAQUETES INCRUSTADA EN APLICACIONES.

Algunos sistemas de gestión de paquetes no forman parte nativa del sistema

operativo, fink en MacOSX o Cyguin (para Windows).
Otros programas pueden venir con su propio sistema para gestionar
módulos.