docBook-tutorial-congreso

De
Publicado por

Creando DocumentaciónTécnica con DocBookHardy Beltran MonasteriosInstructor y Consultor Linuxhardy@hardy.com.boHardy www.hardy.com.boDistribuido bajo Licencia Creative Commons Attribution-Non Commercial-Share AlikeAgendaIntroducciónComenzado con DocBookCreando un artículo DocBookConociendo marcas útiles de DocBookGenerando documentos HTML y PDFPersonalizando hojas de estiloConclusiones y ReferenciasPreguntasSemana del Pingüino • UMSA/SCE FCP•N Nov. 2006 • La Paz, BoliviaHardy Beltran Monasterios • www.hardy.com.boIntroducción¿ Y qué es documentación Técnica ?Para nosotros del mundo de las compuManuales de usuarioLibros, TutorialesEnsayos y artículos técnicosDocumentación de un APIPreguntas ComunesDiapositivasSemana del Pingüino • UMSA/SCE FCP•N Nov. 2006 • La Paz, BoliviaHardy Beltran Monasterios • www.hardy.com.bo¿ Y qué es DocBook ?Es un sistema para escribir documentos estruturados en SGML o XMLBien adaptado para escribir documentos técnicos relacionados con las computadoras, aunque no está limitado a elloApoyado por empresas y organizacionesCuenta con un número amplio de usuarios y desarrolladoresSemana del Pingüino • UMSA/SCE FCP•N Nov. 2006 • La Paz, BoliviaHardy Beltran Monasterios • www.hardy.com.boUn poco de historiaCreado en 1991 por HaL Computer Systems y O'Reilly & AssociatesDesde 1998 es parte de OASISHoy en día participan varias empresasNovellSun MicrosystemsHewlett PackardFujitsu y muchos otros masSemana ...
Publicado el : sábado, 24 de septiembre de 2011
Lectura(s) : 51
Número de páginas: 69
Ver más Ver menos
Creando Documentación Técnica con DocBook
Hardy
Hardy Beltran Monasterios Instructor y Consultor Linux
hardy@hardy.com.bo
www.hardy.com.bo
Distribuido bajo LicenciaCreative Commons Attribution-Non Commercial-Share Alike
Agenda
Introducción
Comenzado con DocBook
Creando un artículo DocBook
Conociendo marcas útiles de DocBook
Generando documentos HTML y PDF
Personalizando hojas de estilo
Conclusiones y Referencias
Preguntas
Semana del Pingüino • UMSA/SCE FCPN • Nov. 2006 • La Paz, Bolivia
Introducción
¿ Y qué es documentación Técnica ?
Para nosotros del mundo de las compu
Manuales de usuario
Libros, Tutoriales
Ensayos y artículos técnicos
Documentación de un API
Preguntas Comunes
Diapositivas
Semana del Pingüino • UMSA/SCE FCPN • Nov. 2006 • La Paz, Bolivia
¿ Y qué es DocBook ?
Es un sistema para escribir documentos estruturados en SGML o XML
Bien adaptado para escribir documentos técnicos relacionados con las computadoras, aunque no está limitado a ello
Apoyado por empresas y organizaciones
Cuenta con un número amplio de usuarios y desarrolladores
Semana del Pingüino • UMSA/SCE FCPN • Nov. 2006 • La Paz, Bolivia
Un poco de historia
Creado en 1991 por HaL Computer Systems y O'Reilly & Associates
Desde 1998 es parte de OASIS
Hoy en día participan varias empresas
Novell
Sun Microsystems
Hewlett Packard
Fujitsu y muchos otros mas
Semana del Pingüino • UMSA/SCE FCPN • Nov. 2006 • La Paz, Bolivia
¿ Quienes usan DocBook ?
Varias empresas del sector IT
Varias distribuciones de Linux
Red Hat, Fedora, Suse, Gentoo, LFS, etc.
Varios proyectos de documentación de Software Libre/Abierto
GNOME, KDE, PHP, Linux Documentation Proyect, etc.
Varios consultores y autores de documentación libre
Semana del Pingüino • UMSA/SCE FCPN • Nov. 2006 • La Paz, Bolivia
¿ Por qué usar DocBook ?
El autor se concentra en el contenido y no en el aspecto del documento
Estilos personalizables y extensibles
Se pueden producir varios formatos
HTML, XHTML, Ayuda Java, Ayuda HTML
PostScript, PDF, RTF, Texto
«man pages», «XSL Formating Objects»
Número creciente de herramientas comerciales y libres/abiertas
Semana del Pingüino • UMSA/SCE FCPN • Nov. 2006 • La Paz, Bolivia
Desventajas de DocBook
Demasiadas marcas XML/SGML
Inicialmente su aprendizaje es lento para quienes nunca usaron «lenguajes de marcas»
Algunas herramientas libres no son suficiente maduras para ciertos usos (Ej. Editor XML, Convertir XML FO a PDF)
Varias herramientas maduras son solo para Windows y no son libres
Semana del Pingüino • UMSA/SCE FCPN • Nov. 2006 • La Paz, Bolivia
DVI
PassiveTex
XSL FO
FO
Procesador XSLT
XSL
¿ Cómo funciona DocBook ?
XML
FOP
PDF
Los íconos fueron tomados de GNOME
HTML, XHTML, Java Help
Postscript
dvips
Modo de operación de DocBook XML
P aL  6002 .voNaviliBo, az del Pingüino  MUASS/ECF PC N eSanam
Comenzando con DocBook
¡Sé el primero en escribir un comentario!

13/1000 caracteres como máximo.

Difunda esta publicación

También le puede gustar