Docbook para autores I: creación de documentación con Docbook.

Resumen

Docbook es una aplicación SGML/XML para la estructuración de documentación informática. Ha sido diseñada por la industria y se ha convertido en el estándar industrial de documentación para el software libre. Todas las distribuciones modernas incluyen el juego completo de herramientas necesarias para sacarle partido.

Objetivo

Conseguir que el estudiante sea capaz de crear su propia documentación con Docbook y obtener los formatos de reproducción para publicarlos en Internet o imprimirlos.

Dirigido

Autores de documentación, traductores y programadores.

Requisitos

Conocimientos medios de informática y experiencia previa con el entorno de usuario GNU/Linux, incluyendo manejo de la línea de órdenes.

Temario

  1. SGML/XML para autores de documentación
    • Objetivos
    • Los documentos tienen estructura
    • Ventajas de la documentación estructurada
    • Web Semántica
    • Todos usamos SGML/XML
    • Entorno de desarrollo HTML
    • Entorno de producción SGML clásico
    • SGML
    • Estructura de SGML
    • XML vs. SGML
    • DSSSL
    • XSL
    • Entorno de producción SGML ampliado con DSSSL
    • Entorno SGML genérico
    • DTD de éxito: HTML
    • Entorno HTML en Linux
    • DTD de éxito: CALS
    • DTD de éxito: TEI
    • DTD de éxito: Linuxdoc-SGML
    • DTD de éxito: Docbook
    • Entorno Docbook SGML en Linux
    • Ejemplo de uso de Docbook
    • Herramientas:
    • Creando documentos estructurados:
    • Ejemplo de uso de aplicación SGML
    • Preguntas
    • Despedida y cierre
  2. Introducción a CVS
    • Manual de supervivencia de CVS.
  3. Trabajando con Docbook
    • Objetivos
    • Los documentos tienen estructura
    • Presentación de Docbook
    • Recursos de trabajo mínimos
    • Paquetes para RH 7.*
    • Paquetes para Debian Woody/Linex
    • Configuraciones: catálogos
    • Configuraciones relacionadas con TeX
    • Estudio de un documento de ejemplo
    • Usando el manual de referencia
    • Trabajando: definición de entidades y descomposición en varios ficheros fuente
    • Trabajando: diferencias prácticas entre Docbook SGML y Docbook XML
    • Trabajando: usando un corrector ortográfico
    • Trabajando: generando formatos de reproducción/impresión
    • Trabajando: personalización de DTD
    • Trabajando: personalización de hojas de estilo DSSSL
    • Trabajando: personalización de hojas de estilo XSL
    • Trabajando: personalización de hojas de estilo CSS
    • Trabajando: uso de otras herramientas
    • Complicaciones más comunes: errata Debian/Linex
    • Complicaciones más comunes: juegos de caracteres
    • Complicaciones más comunes: usando ilustraciones en PS/PDF
    • Complicaciones más comunes: usando ilustraciones en HTML
    • Editores estructurados
    • Referencias
    • Foros de ayuda
    • Preguntas
    • Despedida y cierre
  4. Tutorial de Docbook
    • Se aprenderá, paso a paso, a crear un documento Docbook usando las marcas más comunes.
  5. Prácticas en grupo estructurando documentos reales y usando CVS

Duración

20 horas.

Material para el alumno