Está en la página 1de 69

Creando Documentación Técnica con DocBook

Creando Documentación Técnica con DocBook Hardy Hardy Beltran Monasterios Instructor y Consultor Linux hardy@acm.org

Hardy

Hardy Beltran Monasterios Instructor y Consultor Linux

hardy@acm.org

Distribuido bajo Licencia Creative Commons Attribution-NonCommercial-NoDerivs

Instructor y Consultor Linux hardy@acm.org Distribuido bajo Licencia Creative Commons Attribution-NonCommercial-NoDerivs

Hardy Beltran Monasterios • www.hardy.com.bo

Agenda

IntroducciónHardy Beltran Monasterios • www.hardy.com.bo Agenda Comenzado con DocBook Creando un artículo DocBook Conociendo marcas

Comenzado con DocBookMonasterios • www.hardy.com.bo Agenda Introducción Creando un artículo DocBook Conociendo marcas útiles de

Creando un artículo DocBookwww.hardy.com.bo Agenda Introducción Comenzado con DocBook Conociendo marcas útiles de DocBook Generando documentos

Conociendo marcas útiles de DocBookComenzado con DocBook Creando un artículo DocBook Generando documentos HTML y PDF Personalizando hojas de

Generando documentos HTML y PDFun artículo DocBook Conociendo marcas útiles de DocBook Personalizando hojas de estilo Conclusiones y Referencias

Personalizando hojas de estilomarcas útiles de DocBook Generando documentos HTML y PDF Conclusiones y Referencias Preguntas V Congreso Nacional

Conclusiones y Referenciasdocumentos HTML y PDF Personalizando hojas de estilo Preguntas V Congreso Nacional de Software Libre y

PreguntasPersonalizando hojas de estilo Conclusiones y Referencias V Congreso Nacional de Software Libre y GNU/Linux •

hojas de estilo Conclusiones y Referencias Preguntas V Congreso Nacional de Software Libre y GNU/Linux •

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

y Referencias Preguntas V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba,

Introducción

Introducción

Hardy Beltran Monasterios • www.hardy.com.bo

¿ Y qué es documentación Técnica ?

• www.hardy.com.bo ¿ Y qué es documentación Técnica ? Para nosotros del mundo de las compu

Para nosotros del mundo de las compu

Manuales de usuarioTécnica ? Para nosotros del mundo de las compu Libros, Tutoriales Ensayos y artículos técnicos

Libros, Tutoriales? Para nosotros del mundo de las compu Manuales de usuario Ensayos y artículos técnicos Documentación

Ensayos y artículos técnicosmundo de las compu Manuales de usuario Libros, Tutoriales Documentación de un API Preguntas Comunes Diapositivas

Documentación de un APIde usuario Libros, Tutoriales Ensayos y artículos técnicos Preguntas Comunes Diapositivas V Congreso Nacional de

Preguntas ComunesEnsayos y artículos técnicos Documentación de un API Diapositivas V Congreso Nacional de Software Libre y

Diapositivastécnicos Documentación de un API Preguntas Comunes V Congreso Nacional de Software Libre y GNU/Linux •

Documentación de un API Preguntas Comunes Diapositivas V Congreso Nacional de Software Libre y GNU/Linux •

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

Preguntas Comunes Diapositivas V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba,

Hardy Beltran Monasterios • www.hardy.com.bo

¿ Y qué es DocBook ?

Es un sistema para escribir documentos estructurados en SGML o XMLMonasterios • www.hardy.com.bo ¿ Y qué es DocBook ? Bien adaptado para escribir documentos técnicos

Bien adaptado para escribir documentos técnicos relacionados con las computadoras, aunque no está limitado a ellosistema para escribir documentos estructurados en SGML o XML Apoyado por empresas y organizaciones Cuenta con

Apoyado por empresas y organizacionescon las computadoras, aunque no está limitado a ello Cuenta con un número amplio de usuarios

Cuenta con un número amplio de usuarios y desarrolladoresestá limitado a ello Apoyado por empresas y organizaciones V Congreso Nacional de Software Libre y

Cuenta con un número amplio de usuarios y desarrolladores V Congreso Nacional de Software Libre y
Cuenta con un número amplio de usuarios y desarrolladores V Congreso Nacional de Software Libre y

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

Hardy Beltran Monasterios • www.hardy.com.bo

Un poco de historia

Creado en 1991 por HaL Computer Systems y O'Reilly & AssociatesBeltran Monasterios • www.hardy.com.bo Un poco de historia Desde 1998 es parte de OASIS Hoy en

Desde 1998 es parte de OASISpor HaL Computer Systems y O'Reilly & Associates Hoy en día participan varias empresas Novell Sun

Hoy en día participan varias empresasy O'Reilly & Associates Desde 1998 es parte de OASIS Novell Sun Microsystems Hewlett Packard Fujitsu

Novelles parte de OASIS Hoy en día participan varias empresas Sun Microsystems Hewlett Packard Fujitsu y

Sun Microsystemsparte de OASIS Hoy en día participan varias empresas Novell Hewlett Packard Fujitsu y muchos otros

Hewlett Packarden día participan varias empresas Novell Sun Microsystems Fujitsu y muchos otros mas V Congreso Nacional

Fujitsu y muchos otros masvarias empresas Novell Sun Microsystems Hewlett Packard V Congreso Nacional de Software Libre y GNU/Linux •

Sun Microsystems Hewlett Packard Fujitsu y muchos otros mas V Congreso Nacional de Software Libre y

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

Fujitsu y muchos otros mas V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005

Hardy Beltran Monasterios • www.hardy.com.bo

¿ Quienes usan DocBook ?

Varias empresas del sector ITMonasterios • www.hardy.com.bo ¿ Quienes usan DocBook ? Varias distribuciones de Linux Red Hat, Fedora, Suse,

Varias distribuciones de Linux¿ Quienes usan DocBook ? Varias empresas del sector IT Red Hat, Fedora, Suse, Gentoo, LFS,

Red Hat, Fedora, Suse, Gentoo, LFS, etc.Varias empresas del sector IT Varias distribuciones de Linux Varios proyectos de documentación de Software Libre/Abierto

Varios proyectos de documentación de Software Libre/Abiertode Linux Red Hat, Fedora, Suse, Gentoo, LFS, etc. GNOME, KDE, PHP, Linux Documentation Proyect, etc.

GNOME, KDE, PHP, Linux Documentation Proyect, etc.Varios proyectos de documentación de Software Libre/Abierto Varios consultores y autores de documentación libre V

Varios consultores y autores de documentación libreGNOME, KDE, PHP, Linux Documentation Proyect, etc. V Congreso Nacional de Software Libre y GNU/Linux •

etc. Varios consultores y autores de documentación libre V Congreso Nacional de Software Libre y GNU/Linux

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

autores de documentación libre V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 •

Hardy Beltran Monasterios • www.hardy.com.bo

¿ Por qué usar DocBook ?

El autor se concentra en el contenido y no en el aspecto del documentoMonasterios • www.hardy.com.bo ¿ Por qué usar DocBook ? Estilos personalizables y extensibles Se pueden producir

Estilos personalizables y extensiblesconcentra en el contenido y no en el aspecto del documento Se pueden producir varios formatos

Se pueden producir varios formatosaspecto del documento Estilos personalizables y extensibles HTML, XHTML, Ayuda Java, Ayuda HTML PostScript, PDF, RTF,

HTML, XHTML, Ayuda Java, Ayuda HTMLy extensibles Se pueden producir varios formatos PostScript, PDF, RTF, Texto «man pages», «XSL Formating

PostScript, PDF, RTF, Textoproducir varios formatos HTML, XHTML, Ayuda Java, Ayuda HTML «man pages», «XSL Formating Objects» Número creciente

«man pages», «XSL Formating Objects»XHTML, Ayuda Java, Ayuda HTML PostScript, PDF, RTF, Texto Número creciente de herramientas comerciales y

Número creciente de herramientas comerciales y libres/abiertasPDF, RTF, Texto «man pages», «XSL Formating Objects» V Congreso Nacional de Software Libre y GNU/Linux

creciente de herramientas comerciales y libres/abiertas V Congreso Nacional de Software Libre y GNU/Linux • Agosto

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

comerciales y libres/abiertas V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba,

Hardy Beltran Monasterios • www.hardy.com.bo

Desventajas de DocBook

Demasiadas marcas XML/SGMLMonasterios • www.hardy.com.bo Desventajas de DocBook Inicialmente su aprendizaje es lento para quienes nunca

Inicialmente su aprendizaje es lento para quienes nunca usaron «lenguajes de marcas»Desventajas de DocBook Demasiadas marcas XML/SGML Algunas herramientas libres no son suficiente maduras para

Algunas herramientas libres no son suficiente maduras para ciertos usos (Ej. Editor XML, Convertir XML FO a PDF)es lento para quienes nunca usaron «lenguajes de marcas» Varias herramientas maduras son solo para Windows

Varias herramientas maduras son solo para Windows y no son librespara ciertos usos (Ej. Editor XML, Convertir XML FO a PDF) V Congreso Nacional de Software

herramientas maduras son solo para Windows y no son libres V Congreso Nacional de Software Libre
herramientas maduras son solo para Windows y no son libres V Congreso Nacional de Software Libre

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

¿ Cómo funciona DocBook ?

XML XSL Hardy Beltran Monasterios • www.hardy.com.bo
XML
XSL
Hardy Beltran Monasterios • www.hardy.com.bo
FOP FO PDF
FOP
FO
PDF
Hardy Beltran Monasterios • www.hardy.com.bo FOP FO PDF XSL FO PassiveTex DVI Procesador XSLT dvips Postscript
Hardy Beltran Monasterios • www.hardy.com.bo FOP FO PDF XSL FO PassiveTex DVI Procesador XSLT dvips Postscript

XSL FO

Beltran Monasterios • www.hardy.com.bo FOP FO PDF XSL FO PassiveTex DVI Procesador XSLT dvips Postscript HTML,

PassiveTex

• www.hardy.com.bo FOP FO PDF XSL FO PassiveTex DVI Procesador XSLT dvips Postscript HTML, XHTML, Java
• www.hardy.com.bo FOP FO PDF XSL FO PassiveTex DVI Procesador XSLT dvips Postscript HTML, XHTML, Java

DVI

Procesador

XSLT

FOP FO PDF XSL FO PassiveTex DVI Procesador XSLT dvips Postscript HTML, XHTML, Java Help Modo
FOP FO PDF XSL FO PassiveTex DVI Procesador XSLT dvips Postscript HTML, XHTML, Java Help Modo

dvips

FOP FO PDF XSL FO PassiveTex DVI Procesador XSLT dvips Postscript HTML, XHTML, Java Help Modo
FOP FO PDF XSL FO PassiveTex DVI Procesador XSLT dvips Postscript HTML, XHTML, Java Help Modo

Postscript

PDF XSL FO PassiveTex DVI Procesador XSLT dvips Postscript HTML, XHTML, Java Help Modo de operación

HTML, XHTML, Java Help

Modo de operación de DocBook XML

Los íconos fueron tomados de GNOME

de DocBook XML Los íconos fueron tomados de GNOME V Congreso Nacional de Software Libre y

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

íconos fueron tomados de GNOME V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005

Comenzando con DocBook

Comenzando con DocBook

Hardy Beltran Monasterios • www.hardy.com.bo

¿ DocBook XML o SGML ?

XML es más simple de manejarMonasterios • www.hardy.com.bo ¿ DocBook XML o SGML ? Clara tendencia a XMLizar el mundo ;-)

Clara tendencia a XMLizar el mundo ;-)¿ DocBook XML o SGML ? XML es más simple de manejar Históricamente DocBook ha sido

Históricamente DocBook ha sido SGMLsimple de manejar Clara tendencia a XMLizar el mundo ;-) Desde la versión 4 es XML

Desde la versión 4 es XML y SGMLa XMLizar el mundo ;-) Históricamente DocBook ha sido SGML La versión 5 será principalmente XML

La versión 5 será principalmente XMLDocBook ha sido SGML Desde la versión 4 es XML y SGML Hay un creciente número

Hay un creciente número de herramientas para tratar XML4 es XML y SGML La versión 5 será principalmente XML V Congreso Nacional de Software

XML Hay un creciente número de herramientas para tratar XML V Congreso Nacional de Software Libre

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

de herramientas para tratar XML V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005

Hardy Beltran Monasterios • www.hardy.com.bo

Básicamente se necesita

Un editor de texto o editor XMLMonasterios • www.hardy.com.bo Básicamente se necesita DocBook instalado en su sistema El DTD de DocBook XML

DocBook instalado en su sistemaBásicamente se necesita Un editor de texto o editor XML El DTD de DocBook XML Hojas

El DTD de DocBook XMLeditor de texto o editor XML DocBook instalado en su sistema Hojas de estilo XSLT DocBook

Hojas de estilo XSLT DocBookXML DocBook instalado en su sistema El DTD de DocBook XML Un procesador XSLT Por ejemplo

Un procesador XSLTsistema El DTD de DocBook XML Hojas de estilo XSLT DocBook Por ejemplo xsltproc Un procesador

Por ejemplo xsltprocDocBook XML Hojas de estilo XSLT DocBook Un procesador XSLT Un procesador FO (si quiere PDF)

Un procesador FO (si quiere PDF)estilo XSLT DocBook Un procesador XSLT Por ejemplo xsltproc Por ejemplo Apache FOP V Congreso Nacional

Por ejemplo Apache FOPXSLT Por ejemplo xsltproc Un procesador FO (si quiere PDF) V Congreso Nacional de Software Libre

Un procesador FO (si quiere PDF) Por ejemplo Apache FOP V Congreso Nacional de Software Libre

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

PDF) Por ejemplo Apache FOP V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005

Hardy Beltran Monasterios • www.hardy.com.bo

Editando XML

Emacs y nXMLHardy Beltran Monasterios • www.hardy.com.bo Editando XML Emacs es un poderoso editor de textos ampliamente usado

Emacs es un poderoso editor de textos ampliamente usado en Linux. es un poderoso editor de textos ampliamente usado en Linux.

nXML es un complemento que facilita escribir marcas XML. Valida mientras se escribe, ofrece sintaxis coloreada es un complemento que facilita escribir marcas XML. Valida mientras se escribe, ofrece sintaxis coloreada y autocompleta.

VIMse escribe, ofrece sintaxis coloreada y autocompleta. Con ayuda de determinadas macros se puede editar también

Con ayuda de determinadas macros se puede editar también fácilmente XML.se escribe, ofrece sintaxis coloreada y autocompleta. VIM Conglomerate Editor XML Libre basado en GTK. (no

Conglomeratemacros se puede editar también fácilmente XML. Editor XML Libre basado en GTK. (no maduro) V

Editor XML Libre basado en GTK. (no maduro)se puede editar también fácilmente XML. Conglomerate V Congreso Nacional de Software Libre y GNU/Linux •

Conglomerate Editor XML Libre basado en GTK. (no maduro) V Congreso Nacional de Software Libre y

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

Libre basado en GTK. (no maduro) V Congreso Nacional de Software Libre y GNU/Linux • Agosto

Hardy Beltran Monasterios • www.hardy.com.bo

Instalar DTD y XSL DocBook

En sistemas Debian LinuxMonasterios • www.hardy.com.bo Instalar DTD y XSL DocBook apt-get install docbook-xml docbook-xsl En sistemas RPM con

Instalar DTD y XSL DocBook En sistemas Debian Linux apt-get install docbook-xml docbook-xsl En sistemas RPM

apt-get install docbook-xml docbook-xsl

En sistemas RPM con yumDebian Linux apt-get install docbook-xml docbook-xsl yum install docbook Vea si su distro ya trae instalado

yum install docbookinstall docbook-xml docbook-xsl En sistemas RPM con yum Vea si su distro ya trae instalado DocBook

Vea si su distro ya trae instalado DocBookdocbook-xsl En sistemas RPM con yum yum install docbook Red Hat, Fedora, CentOS, WhiteBox instalan de

install docbook Vea si su distro ya trae instalado DocBook Red Hat, Fedora, CentOS, WhiteBox instalan

Red Hat, Fedora, CentOS, WhiteBox instalan de modo predeterminado las herramientas DocBook

instalan de modo predeterminado las herramientas DocBook V Congreso Nacional de Software Libre y GNU/Linux •

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

las herramientas DocBook V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba,

Hardy Beltran Monasterios • www.hardy.com.bo

El DTD de DocBook

Define la estructura, elementos y atributos de un documento DocBookBeltran Monasterios • www.hardy.com.bo El DTD de DocBook Los procesadores XSLT requieren el DTD para validar

Los procesadores XSLT requieren el DTD para validar el documento XMLla estructura, elementos y atributos de un documento DocBook El DTD puede ser accedido en línea

El DTD puede ser accedido en línea o puede estar en el sistema de archivos localXSLT requieren el DTD para validar el documento XML V Congreso Nacional de Software Libre y

en línea o puede estar en el sistema de archivos local V Congreso Nacional de Software

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

en el sistema de archivos local V Congreso Nacional de Software Libre y GNU/Linux • Agosto

Hardy Beltran Monasterios • www.hardy.com.bo

Hojas de estilo DocBook

Norman Walsh mantiene las hojas de estilo estándarMonasterios • www.hardy.com.bo Hojas de estilo DocBook Hay dos tipos de hojas de estilo, pero con

Hay dos tipos de hojas de estilo, pero con DocBook XML usamos hojas de estilo XSLDocBook Norman Walsh mantiene las hojas de estilo estándar Las hojas de estilo son las que

Las hojas de estilo son las que permiten generar varios formatos de salidade estilo, pero con DocBook XML usamos hojas de estilo XSL HTML, XHTML, PS, PDF, RTF,

son las que permiten generar varios formatos de salida HTML, XHTML, PS, PDF, RTF, etc V

HTML, XHTML, PS, PDF, RTF, etc

varios formatos de salida HTML, XHTML, PS, PDF, RTF, etc V Congreso Nacional de Software Libre

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

HTML, XHTML, PS, PDF, RTF, etc V Congreso Nacional de Software Libre y GNU/Linux • Agosto

Hardy Beltran Monasterios • www.hardy.com.bo

Sobre el procesador XSLT

Puede utilizar los siguientesMonasterios • www.hardy.com.bo Sobre el procesador XSLT libxsl/xsltproc – escrito en C, originalmente para GNOME.

libxsl/xsltproc – escrito en C, originalmente para GNOME. Veloz y maduro. – escrito en C, originalmente para GNOME. Veloz y maduro.

Saxon – escrito en Java incluye funciones experimentales. – escrito en Java incluye funciones experimentales.

Xalan – escrito en Java por el proyecto Apache, ampliamente usado en la comunidad. – escrito en Java por el proyecto Apache, ampliamente usado en la comunidad.

Hay también alternativas comercialespor el proyecto Apache, ampliamente usado en la comunidad. V Congreso Nacional de Software Libre y

usado en la comunidad. Hay también alternativas comerciales V Congreso Nacional de Software Libre y GNU/Linux

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

alternativas comerciales V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

Hardy Beltran Monasterios • www.hardy.com.bo

Instalar un procesador XSLT

En sistemas Debian LinuxMonasterios • www.hardy.com.bo Instalar un procesador XSLT apt-get install xmlto En sistemas RPM con yum yum

apt-get install xmlto

En sistemas RPM con yumXSLT En sistemas Debian Linux apt-get install xmlto yum install xmlto Para usar Xalan vaya al

yum install xmlto

Para usar Xalan vaya al sitio de Apache, descarge el programa y siga las instrucciones. Xalan vaya al sitio de Apache, descarge el programa y siga las instrucciones.

Varias distribuciones ya traen libxsl/xsltproc instalado libxsl/xsltproc instalado

xmlto es un conjunto de scripts que facilita el uso de un « tool ch ain es un conjunto de scripts que facilita el uso de un « tool ch ain ». Actualmente sólo usa xsltproc

de un « tool ch ain ». Actualmente sólo usa xsltproc V Congreso Nacional de Software
de un « tool ch ain ». Actualmente sólo usa xsltproc V Congreso Nacional de Software

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

Creando un artículo DocBook

Creando un artículo DocBook

Hardy Beltran Monasterios • www.hardy.com.bo

Cabecera de DocBook XML

Un documento empieza con la cabecera:Monasterios • www.hardy.com.bo Cabecera de DocBook XML <?xml version="1.0" encoding="UTF-8"

<?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"

"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd">

DOCTYPE define el tipo de documentoarticle – para un artículo (varias secciones) book –

article – para un artículo (varias secciones) – para un artículo (varias secciones)

book – para un libro (varios capítulos con varias secciones) – para un libro (varios capítulos con varias secciones)

– para un libro (varios capítulos con varias secciones) V Congreso Nacional de Software Libre y

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

capítulos con varias secciones) V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 •

Hardy Beltran Monasterios • www.hardy.com.bo

Datos básicos de un artículo

<article id="tutorial-ejemplo" lang="es"> <articleinfo> <title>Trabajando con directorios</title> <copyright>

<year>2005</year>

<holder>Hardy Beltran Monasterios</holder> </copyright> <authorgroup> <author> <surname>Beltran Monasterios</surname> <firstname>Hardy</firstname> <email>hbm@hardy.com.bo</email> </author> </authorgroup> <legalnotice><para> </para></legalnotice> </articleinfo>

para ></ legalnotice > </ articleinfo > V Congreso Nacional de Software Libre y GNU/Linux •

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

> </ articleinfo > V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 •

Hardy Beltran Monasterios • www.hardy.com.bo

Secciones de un artículo

Monasterios • www.hardy.com.bo Secciones de un artículo Un documento tipo artículo puede estar formado de varias

Un documento tipo artículo puede estar formado de varias secciones:

<sect1 id=”seccion_1”> <title>Título de esta sección</title>

<para>Este párrafo aparece en la sección 1</para>

</sect1>

<sect1 id=”seccion_2”> <title>Otra sección</surname> <para>Algún texto</para> <sect2 id=”seccion_2.1> <title>Otro título</email>

<para>

</sect2>

</sect1>

</para>

</ sect2 > </ sect1 > </ para > V Congreso Nacional de Software Libre y

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

sect1 > </ para > V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005

Hardy Beltran Monasterios • www.hardy.com.bo

Marcas de sección

Una sección es una división lógica del contenido del documentoBeltran Monasterios • www.hardy.com.bo Marcas de sección Las secciones se definen usando las marcas < sect1

Las secciones se definen usando las marcas <sect1 > a < sect5 > o simplemente < section > sect1> a <sect5> o simplemente <section>

Esta última sólo se puede usar en documentos tipo “article ” article

Se pueden usar cuantas secciones se necesite.sólo se puede usar en documentos tipo “ article ” V Congreso Nacional de Software Libre

article ” Se pueden usar cuantas secciones se necesite. V Congreso Nacional de Software Libre y

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

cuantas secciones se necesite. V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 •

Conociendo marcas útiles de DocBook

Conociendo marcas útiles de DocBook

Hardy Beltran Monasterios • www.hardy.com.bo

Recomendaciones generales

Todas las marcas DocBook XML se deben escribir en minúsculasMonasterios • www.hardy.com.bo Recomendaciones generales Toda marca que se abra se debe cerrar Los identificadores de

Toda marca que se abra se debe cerrarlas marcas DocBook XML se deben escribir en minúsculas Los identificadores de capítulos, secciones, tablas,

Los identificadores de capítulos, secciones, tablas, figuras, etc., deben ser únicosen minúsculas Toda marca que se abra se debe cerrar V Congreso Nacional de Software Libre

secciones, tablas, figuras, etc., deben ser únicos V Congreso Nacional de Software Libre y GNU/Linux •

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

figuras, etc., deben ser únicos V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005

Hardy Beltran Monasterios • www.hardy.com.bo

Marca <application>

Se usa para referirse a una aplicación gráfica o texto.Monasterios • www.hardy.com.bo Marca <application> Ejemplo: Para trabajar con archivos Zip comprimidos, usted

Ejemplo:Se usa para referirse a una aplicación gráfica o texto. Para trabajar con archivos Zip comprimidos,

Para trabajar con archivos Zip comprimidos, usted puede usar el programa <application>File Roller</application> en modo gráfico o utilizar el programa <application>Zip</application> desde la línea de órdenes.

application > desde la línea de órdenes. V Congreso Nacional de Software Libre y GNU/Linux •

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

desde la línea de órdenes. V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005

Hardy Beltran Monasterios • www.hardy.com.bo

Marca <citetitle>

Se usa para hacer cita una referencia externa.Monasterios • www.hardy.com.bo Marca <citetitle> Por ejemplo: Para una descripción detallada del proceso de

Por ejemplo:Se usa para hacer cita una referencia externa. Para una descripción detallada del proceso de instalación

Para una descripción detallada del proceso de instalación consulte la <citetitle>Guía Oficial de Instalación para Intel x86</citetitle>.

de Instalación para Intel x86</ citetitle >. V Congreso Nacional de Software Libre y GNU/Linux •

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

Intel x86</ citetitle >. V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 •

Hardy Beltran Monasterios • www.hardy.com.bo

Marca <command>

Se usa para referirse al ejecutable de una aplicación, a una orden o una directiva de configuración.Monasterios • www.hardy.com.bo Marca <command> Por ejemplo: Para configurar la red en Linux Red Hat usted

Por ejemplo:aplicación, a una orden o una directiva de configuración. Para configurar la red en Linux Red

Para configurar la red en Linux Red Hat usted puede usar la orden <command>netconfig</command>.

<command>DocumentRoot</command> - Esta directiva de configuración le indica al servidor Apache la ubicación de los documentos (páginas web) a servir.

la ubicación de los documentos (páginas web) a servir. V Congreso Nacional de Software Libre y

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

(páginas web) a servir. V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 •

Hardy Beltran Monasterios • www.hardy.com.bo

Marca <computeroutput>

Se usa para mostrar mensajes que aparecen en la pantalla. Por ejemplo:• www.hardy.com.bo Marca <computeroutput> < computeroutput >rm: ¿borrar el fichero regular

<computeroutput>rm: ¿borrar el fichero regular «Makefile»? (s/n)</computeroutput>

El contenido se debe poner inmediatamente después de la marca.regular «Makefile»? (s/n)</ computeroutput > Como en la marca < screen > se respetan los espacios

Como en la marca <screen > se respetan los espacios y líneas extras. screen> se respetan los espacios y líneas extras.

screen > se respetan los espacios y líneas extras. V Congreso Nacional de Software Libre y

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

los espacios y líneas extras. V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005

Hardy Beltran Monasterios • www.hardy.com.bo

Marca <emphasis>

Se usa para poner énfasis a una fraseMonasterios • www.hardy.com.bo Marca <emphasis> Ejemplo: Usar < command >/sbin/mke2fs</ command

Ejemplo:<emphasis> Se usa para poner énfasis a una frase Usar < command >/sbin/mke2fs</ command >

Usar <command>/sbin/mke2fs</command> sobre un sistema de archivos existente, provocará que se pierda <emphasis>toda</emphasis> la información contenida en éste.

emphasis > la información contenida en éste. V Congreso Nacional de Software Libre y GNU/Linux •

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

información contenida en éste. V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 •

Hardy Beltran Monasterios • www.hardy.com.bo

Marca <example>

Se usa para mostrar ejemplos acompañados de un títuloMonasterios • www.hardy.com.bo Marca <example> Típicamente son secciones de código o de archivos de

Típicamente son secciones de código o de archivos de configuración.Se usa para mostrar ejemplos acompañados de un título Ejemplo: < example id=”ej-resolv” > < title

Ejemplo:son secciones de código o de archivos de configuración. < example id=”ej-resolv” > < title

<example id=”ej-resolv”> <title>Dominio y servidor DNS a utilizar</title> <screen> <computeroutput>domain unsitio.com nameserver 192.168.1.4;</computeroutput> </screen> </example>

> </ screen > </ example > V Congreso Nacional de Software Libre y GNU/Linux •

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

> </ example > V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 •

Hardy Beltran Monasterios • www.hardy.com.bo

Marca <filename>

Se usa para hacer referencia a nombres de archivo o directorios.Monasterios • www.hardy.com.bo Marca <filename> Si es un directorio se sugiere incluir “/” al final para

Si es un directorio se sugiere incluir “/” al final para clarificar el textopara hacer referencia a nombres de archivo o directorios. Ejemplo: El archivo < filename >/etc/passwd</

Ejemplo:se sugiere incluir “/” al final para clarificar el texto El archivo < filename >/etc/passwd</ filename

El archivo <filename>/etc/passwd</filename> contiene varias piezas de información de una cuenta de usuario.

varias piezas de información de una cuenta de usuario. V Congreso Nacional de Software Libre y

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

de una cuenta de usuario. V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005

Hardy Beltran Monasterios • www.hardy.com.bo

Marca <figure>

Monasterios • www.hardy.com.bo Marca <figure> Use si quiere incluir una figura que tenga un título y

Use si quiere incluir una figura que tenga un título y una breve descripción

<figure id=”f-pref-mozilla”> <title>Preferencias de Mozilla</title> <mediaobject> <imageobject>

<imagedata fileref="./figs/moz-pref.eps" format="EPS"/> </imageobject> <imageobject> <imagedata fileref="./figs/moz-pref.png" format="PNG"/> </imageobject> <textobject>

<phrase>La figura muestra las preferencias </textobject> </mediaobject> </figure>

</phrase>

mediaobject > </ figure > </ phrase > V Congreso Nacional de Software Libre y GNU/Linux
mediaobject > </ figure > </ phrase > V Congreso Nacional de Software Libre y GNU/Linux

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

Hardy Beltran Monasterios • www.hardy.com.bo

Marca <footnote>

Se usa para insertar una nota al pie de páginaMonasterios • www.hardy.com.bo Marca <footnote> Ejemplo: En una instalación estándar, la partición

Ejemplo:Se usa para insertar una nota al pie de página En una instalación estándar, la partición

En una instalación estándar, la partición asignada a <filename>/boot</filename> <footnote> <para>En algunos sistemas debido a problemas con discos grandes, se acostumbra crear esta partición dentro los primeros 1024 cilindros.</para> </footnote> requerirá un espacio de 60 a 100 MiB.

</ footnote > requerirá un espacio de 60 a 100 MiB. V Congreso Nacional de Software

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

un espacio de 60 a 100 MiB. V Congreso Nacional de Software Libre y GNU/Linux •

Hardy Beltran Monasterios • www.hardy.com.bo

Marca <foreignphrase>

Se usa para mostrar una palabra o frase en un idioma diferente al del documento• www.hardy.com.bo Marca <foreignphrase> Ejemplo: Las siguientes órdenes deben ser escritas desde el

Ejemplo:una palabra o frase en un idioma diferente al del documento Las siguientes órdenes deben ser

Las siguientes órdenes deben ser escritas desde el indicador del sistema (<foreignphrase>prompt </foreignphrase>).

foreignphrase >prompt </ foreignphrase >). V Congreso Nacional de Software Libre y GNU/Linux • Agosto

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

</ foreignphrase >). V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba,

Hardy Beltran Monasterios • www.hardy.com.bo

Lista de ítemes <itemizedlist>

Se usa para mostrar información breve que no requiere un orden específico• www.hardy.com.bo Lista de ítemes <itemizedlist> Ejemplo: < itemizedlist > < listitem > <

Ejemplo:información breve que no requiere un orden específico < itemizedlist > < listitem > < para

<itemizedlist> <listitem> <para>Revisar uso de espacio libre en disco</para> </listitem> <listitem> <para>Monitorear y gestionar procesos</para> </listitem> <listitem> <para>Mantener programas al día</para> </listitem> </itemizedlist>

para > </ listitem > </ itemizedlist > V Congreso Nacional de Software Libre y GNU/Linux

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

> </ itemizedlist > V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 •

Hardy Beltran Monasterios • www.hardy.com.bo

Lista ordenada <orderedlist>

Para mostrar una lista de ítemes cuyo orden tiene importancia• www.hardy.com.bo Lista ordenada <orderedlist> Ejemplo: < orderedlist > < listimtem > <

Ejemplo:mostrar una lista de ítemes cuyo orden tiene importancia < orderedlist > < listimtem > <

<orderedlist> <listimtem> <para>Instalar el paquete</para> </listimtem> <listimtem> <para>Modificar el archivo de configuración</para> </listimtem> <listimtem> <para>Iniciar el servicio</para> </listimtem> </orderedlist>

para > </ listimtem > </ orderedlist > V Congreso Nacional de Software Libre y GNU/Linux

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

> </ orderedlist > V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 •

Hardy Beltran Monasterios • www.hardy.com.bo

Lista de términos y definiciones <variablelist>

Lista de términos y definiciones <variablelist> Para mostrar una lista de términos y definiciones con sus

Para mostrar una lista de términos y definiciones con sus descripciones

<variablelist> <varlistentry> <term>Servidor X</term> <listimtem>

<para>Ofrece las operaciones básicas de </listimtem> </varlistentry> <varlistentry> <term>Servidor de Letras X</term> <listimtem>

<para>Provee los tipos de letras </listimtem> </varlistentry>

</para>

</variablelist>

</para>

para > </ variablelist > </ para > V Congreso Nacional de Software Libre y GNU/Linux

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

> </ para > V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 •

Hardy Beltran Monasterios • www.hardy.com.bo

Lista simple <simplelist>

Se usa principalmente para crear una lista contenida en una tabla• www.hardy.com.bo Lista simple <simplelist> Ejemplo: < simplelist > < member >Procesador

Ejemplo:principalmente para crear una lista contenida en una tabla < simplelist > < member >Procesador

<simplelist> <member>Procesador Intel</member> <member>Pentium IV 4.2 Ghz</member> <member>512 MiB RAM</member> <member>80 GiB Disco</member> <member>CDWR/DVD</member> </simplelist>

>CDWR/DVD</ member > </ simplelist > V Congreso Nacional de Software Libre y GNU/Linux • Agosto

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

> </ simplelist > V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 •

Hardy Beltran Monasterios • www.hardy.com.bo

Marca <option>

Se usa para indicar una opción de una determinada ordenMonasterios • www.hardy.com.bo Marca <option> Ejemplo: La orden < command >uname</ command

Ejemplo:Se usa para indicar una opción de una determinada orden La orden < command >uname</ command

La orden <command>uname</command> seguida de la opción <option>-r</option> muestra la versión de núcleo que está ejecutando su sistema.

la versión de núcleo que está ejecutando su sistema. V Congreso Nacional de Software Libre y

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

que está ejecutando su sistema. V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005

Hardy Beltran Monasterios • www.hardy.com.bo

Marca <para>

Esta marca se emplea alrededor de cualquier párrafo simple.Monasterios • www.hardy.com.bo Marca <para> Ejemplo: < para > La orden < command

Ejemplo:Esta marca se emplea alrededor de cualquier párrafo simple. < para > La orden < command

<para> La orden <command>uname</command> seguida de la opción <option>-r</option> muestra la versión de núcleo que está ejecutando su sistema. </para>

núcleo que está ejecutando su sistema. </ para > V Congreso Nacional de Software Libre y

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

su sistema. </ para > V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005

Hardy Beltran Monasterios • www.hardy.com.bo

Contenido en marcas <para>

Sólo use marcas <para > alrededor de párrafos simples únicamente para> alrededor de párrafos simples únicamente

Específicamente no use <para > alrededor de las siguientes marcas: para> alrededor de las siguientes marcas:

<itemizedlist > itemizedlist>

<orderedlist > orderedlist>

<variablelist > variablelist>

<screen > screen>

<table > table>

variablelist > < screen > < table > V Congreso Nacional de Software Libre y GNU/Linux

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

screen > < table > V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005

Hardy Beltran Monasterios • www.hardy.com.bo

Marca <prompt>

Se usa para mostrar un indicador (prompt ). prompt).

Ejemplo:Se usa para mostrar un indicador ( prompt ). En el indicador < prompt >LILO:</ prompt

En el indicador <prompt>LILO:</prompt> escriba linux para arrancar su sistema.

El indicador <prompt>#</prompt> está reservado al usuario privilegiado root.

prompt > está reservado al usuario privilegiado root. V Congreso Nacional de Software Libre y GNU/Linux

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

al usuario privilegiado root. V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 •

Hardy Beltran Monasterios • www.hardy.com.bo

Marca <replaceable>

Se usa indicar que el lector debe remplazar el texto mostrado de manera adecuada a su situaciónMonasterios • www.hardy.com.bo Marca <replaceable> Ejemplo: Los módulos del núcleo se encuentran en el

Ejemplo:el texto mostrado de manera adecuada a su situación Los módulos del núcleo se encuentran en

Los módulos del núcleo se encuentran en el directorio

<filename>/lib/modules/<replaceable>versión-de-

núcleo</replaceable>/</filename>

núcleo</ replaceable >/</ filename > V Congreso Nacional de Software Libre y GNU/Linux • Agosto

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

>/</ filename > V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba,

Hardy Beltran Monasterios • www.hardy.com.bo

Marca <screen>

Monasterios • www.hardy.com.bo Marca <screen> Se usa para mostrar listado de programas, contenido de

Se usa para mostrar listado de programas, contenido de archivos o cualquier resultado mostrado en pantalla. Por ejemplo

<para>Para ver la versión de su núcleo escriba:</para>

<screen> <userinput>uname -r</userinput> </screen>

<para>Que mostrará un resultado similar a:</para>

<screen>

<computeroutput>2.4.29-686</computeroutput>

</screen>

computeroutput > </ screen > V Congreso Nacional de Software Libre y GNU/Linux • Agosto

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

> </ screen > V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 •

Hardy Beltran Monasterios • www.hardy.com.bo

Contenido en marcas <screen>

La marca y el contenido deben estar justificados a la izquierda• www.hardy.com.bo Contenido en marcas <screen> Cualquier espacio dentro la marca < screen > se

Cualquier espacio dentro la marca <screen > se conserva screen> se conserva

Esta marca puede contener otras como: <computeroutput >, < userinput >, o < replaceable > computeroutput>, <userinput>, o <replaceable>

Por definición no se requiere incluir otras marcas dentro de <screen > screen>

requiere incluir otras marcas dentro de < screen > V Congreso Nacional de Software Libre y

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

dentro de < screen > V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005

Hardy Beltran Monasterios • www.hardy.com.bo

Marca <table>

<table id="tb-pop-imap"> <title>Características de POP e IMAP</title> <tgroup cols=”3”> <colspec colnum="1" colname="carac" colwidth="120pt"/> <colspec colnum="2" colname="pop" colwidth="30pt"/> <colspec colnum="3" colname="imap" colwidth="30pt"/> <thead> <row> <entry>Característica</entry> <entry>POP</entry> <entry>IMAP</entry> </row> </thead> <tbody> <row> <entry>Trabaja en modo conectado (on-line)</entry> <entry>Si</entry> <entry>Si</entry> </row> </tbody> </tgroup> </table>

</ tbody > </ tgroup > </ table > V Congreso Nacional de Software Libre y
</ tbody > </ tgroup > </ table > V Congreso Nacional de Software Libre y

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

Hardy Beltran Monasterios • www.hardy.com.bo

Tablas <table>

Tabla 1. Características POP e IMAP Característica POP IMAP Trabaja en modo conectado Si Si
Tabla 1. Características POP e IMAP
Característica
POP
IMAP
Trabaja en modo conectado
Si
Si
<table id="tb-pop-imap">
<title>Características de POP
<tgroup cols=”3”>
<colspec colnum="1" colname=
<colspec colnum="2" colname=
<colspec colnum="3" colname=
<thead>
<row>
<entry>Característica</entry>
<entry>POP</entry>
<entry>IMAP</entry>
</row>
</thead>
<tbody>
<row>
<entry>Trabaja en modo
<entry>Si</entry>
<entry>Si</entry>
</row>
</tbody>
</tgroup>
</table>
V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

Hardy Beltran Monasterios • www.hardy.com.bo

Marca <userinput>

Se usa para indicar lo que el usuario debe escribir.Monasterios • www.hardy.com.bo Marca <userinput> Ejemplo: En el indicador del sistema escriba: <

Ejemplo:Se usa para indicar lo que el usuario debe escribir. En el indicador del sistema escriba:

En el indicador del sistema escriba:

<userinput>fdformat /dev/fd0</userinput>

< userinput >fdformat /dev/fd0</ userinput > V Congreso Nacional de Software Libre y GNU/Linux • Agosto

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

/dev/fd0</ userinput > V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba,

Hardy Beltran Monasterios • www.hardy.com.bo

Marca <xref>

Use para hacer referencia a otra sección o capítulo del documentoMonasterios • www.hardy.com.bo Marca <xref> Ejemplo: Para ver más información sobre las particiones de

Ejemplo:hacer referencia a otra sección o capítulo del documento Para ver más información sobre las particiones

Para ver más información sobre las particiones de disco en Linux, refiérase a <xref linkend=”sec-particiones” />.

a < xref linkend=”sec-particiones” />. V Congreso Nacional de Software Libre y GNU/Linux • Agosto

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

/>. V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

Generando

documentos

Generando documentos

Hardy Beltran Monasterios • www.hardy.com.bo

Generar un sólo archivo HTML

Por claridad vamos a usar la variable• www.hardy.com.bo Generar un sólo archivo HTML DB=/usr/share/xml/docbook/stylesheet/nwalsh Aplicamos la

DB=/usr/share/xml/docbook/stylesheet/nwalsh

Aplicamos la hoja de estilo al documento XML para generar HTMLusar la variable DB=/usr/share/xml/docbook/stylesheet/nwalsh xsltproc -o ejemplo.html $DB/html/docbook.xsl ejemplo.xml

xsltproc -o ejemplo.html $DB/html/docbook.xsl ejemplo.xml

Ver el documento en el navegadorxsltproc -o ejemplo.html $DB/html/docbook.xsl ejemplo.xml mozilla ~/Vcongreso/ejemplo.html V Congreso Nacional de

mozilla ~/Vcongreso/ejemplo.html

documento en el navegador mozilla ~/Vcongreso/ejemplo.html V Congreso Nacional de Software Libre y GNU/Linux • Agosto

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

mozilla ~/Vcongreso/ejemplo.html V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

Hardy Beltran Monasterios • www.hardy.com.bo

Generar varios archivos HTML

Cada sección es un archivo HTML• www.hardy.com.bo Generar varios archivos HTML El archivo inicial es «index.html» La hoja de estilo que

El archivo inicial es «index.html»varios archivos HTML Cada sección es un archivo HTML La hoja de estilo que se debe

La hoja de estilo que se debe usar es «chunk.xsl»es un archivo HTML El archivo inicial es «index.html» xsltproc $DB/html/chunk.xsl ejemplo.xml Ver el documento en

xsltproc $DB/html/chunk.xsl ejemplo.xml

Ver el documento en el navegadores «chunk.xsl» xsltproc $DB/html/chunk.xsl ejemplo.xml mozilla ~/Vcongreso/index.html V Congreso Nacional de

mozilla ~/Vcongreso/index.html

el documento en el navegador mozilla ~/Vcongreso/index.html V Congreso Nacional de Software Libre y GNU/Linux •

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

mozilla ~/Vcongreso/index.html V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

Hardy Beltran Monasterios • www.hardy.com.bo

Generar PDF

Es un proceso de dos pasosHardy Beltran Monasterios • www.hardy.com.bo Generar PDF Generar documento FO desde XML Generar PDF desde FO

Generar documento FO desde XML• www.hardy.com.bo Generar PDF Es un proceso de dos pasos Generar PDF desde FO Ejemplo xsltproc

Generar PDF desde FOEs un proceso de dos pasos Generar documento FO desde XML Ejemplo xsltproc -o ejemplo.fo $DB/fo/docbook.xsl

Ejemplopasos Generar documento FO desde XML Generar PDF desde FO xsltproc -o ejemplo.fo $DB/fo/docbook.xsl ejemplo.xml fop.sh

xsltproc -o ejemplo.fo $DB/fo/docbook.xsl ejemplo.xml

fop.sh -fo ejemplo.fo -pdf ejemplo.pdf

ejemplo.xml fop.sh -fo ejemplo.fo -pdf ejemplo.pdf V Congreso Nacional de Software Libre y GNU/Linux • Agosto

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

-fo ejemplo.fo -pdf ejemplo.pdf V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 •

Hardy Beltran Monasterios • www.hardy.com.bo

Limitaciones de generar PDF

Las herramientas libres para generar PDF no están del todo madurasMonasterios • www.hardy.com.bo Limitaciones de generar PDF FOP PassiveTex / pdflatex Los problemas típicos son:

FOPlibres para generar PDF no están del todo maduras PassiveTex / pdflatex Los problemas típicos son:

PassiveTex / pdflatexlibres para generar PDF no están del todo maduras FOP Los problemas típicos son: Contenido dentro

Los problemas típicos son:PDF no están del todo maduras FOP PassiveTex / pdflatex Contenido dentro de tablas Manejo de

Contenido dentro de tablasFOP PassiveTex / pdflatex Los problemas típicos son: Manejo de imágenes con formato especial de presentación

Manejo de imágenes con formato especial de presentaciónLos problemas típicos son: Contenido dentro de tablas Problemas de memoria al generar documentos de muchas

Problemas de memoria al generar documentos de muchas páginas (> 100)Manejo de imágenes con formato especial de presentación V Congreso Nacional de Software Libre y GNU/Linux

memoria al generar documentos de muchas páginas (> 100) V Congreso Nacional de Software Libre y

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

de muchas páginas (> 100) V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005

Hardy Beltran Monasterios • www.hardy.com.bo

Alternativas propietarias

Muchos autores de DocBook usan la herramienta XEPMonasterios • www.hardy.com.bo Alternativas propietarias XEP genera a partir de XML documentos PDF y PostScript

XEP genera a partir de XML documentos PDF y PostScript aplicando XSL FOMuchos autores de DocBook usan la herramienta XEP Tienen una versión gratuita para uso no comercial

Tienen una versión gratuita para uso no comercial (Personal Edition ) Personal Edition)

Visite http://www.renderx.com/ para más informaciónversión gratuita para uso no comercial ( Personal Edition ) V Congreso Nacional de Software Libre

) Visite http://www.renderx.com/ para más información V Congreso Nacional de Software Libre y GNU/Linux • Agosto

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

para más información V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba,

Hardy Beltran Monasterios • www.hardy.com.bo

Personalización de XSL

Una ventaja de las hojas de estilo XSL es su flexible personalización (uso de «capas»)Monasterios • www.hardy.com.bo Personalización de XSL La personalización es posible de dos formas Modificando

La personalización es posible de dos formasXSL es su flexible personalización (uso de «capas») Modificando parámetros predeterminados Ej. Tipo de papel,

Modificando parámetros predeterminadosde «capas») La personalización es posible de dos formas Ej. Tipo de papel, enumerar títulos Modificando

Ej. Tipo de papel, enumerar títulosde dos formas Modificando parámetros predeterminados Modificando procesamiento de elementos Ej. Insertar una

Modificando procesamiento de elementospredeterminados Ej. Tipo de papel, enumerar títulos Ej. Insertar una imagen al inicio de un capítulo

Ej. Insertar una imagen al inicio de un capítuloenumerar títulos Modificando procesamiento de elementos V Congreso Nacional de Software Libre y GNU/Linux • Agosto

elementos Ej. Insertar una imagen al inicio de un capítulo V Congreso Nacional de Software Libre

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

imagen al inicio de un capítulo V Congreso Nacional de Software Libre y GNU/Linux • Agosto

Hardy Beltran Monasterios • www.hardy.com.bo

Personalización por capas

Significa que se crea una capa de personalización con todos los cambios deseados y se mantienen las hojas de estilo DocBook XSL estándarMonasterios • www.hardy.com.bo Personalización por capas Una capa de personalización es una hoja de estilo XSL,

Una capa de personalización es una hoja de estilo XSL, que se aplica encima de las hojas de estilo DocBook XSL existentesy se mantienen las hojas de estilo DocBook XSL estándar V Congreso Nacional de Software Libre

aplica encima de las hojas de estilo DocBook XSL existentes V Congreso Nacional de Software Libre

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

de estilo DocBook XSL existentes V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005

Hardy Beltran Monasterios • www.hardy.com.bo

Ejemplo de capa de personalización XSL

<?xml version='1.0' ?>

<xsl:stylesheet

xmlns:xsl="http://www.w3.org/1999/XSL/Transform"

version='1.0'>

<!-- Referencia a la hoja de estilo estandar DocBook XSL --> <xsl:import href="/usr/share/sgml/docbook/xsl- stylesheets/xhtml/docbook.xsl"/>

<!-- Parametros TOC --> <xsl:param name="toc.section.depth">2</xsl:param> <xsl:param name="section.autolabel" select="1"/>

</xsl:stylesheet>

Mire en /usr/share/doc/docbook-xsl/doc/reference.html para ver una referencia de los parámetros disponibles

para ver una referencia de los parámetros disponibles V Congreso Nacional de Software Libre y GNU/Linux

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

de los parámetros disponibles V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 •

Hardy Beltran Monasterios • www.hardy.com.bo

Uso de la capa de personalización XSL

Basta con usar nuestra hoja de estilo en lugar de la hoja de estilo estándar• www.hardy.com.bo Uso de la capa de personalización XSL Usando nuestro procesador XSLT xsltproc -o

Usando nuestro procesador XSLThoja de estilo en lugar de la hoja de estilo estándar xsltproc -o ejemplo-mixsl.html miestilo_1.xsl ejemplo.xml

xsltproc -o ejemplo-mixsl.html miestilo_1.xsl ejemplo.xml

Para ver el resultado abrimos ejemplo- mixsl.html en el navegadorxsltproc -o ejemplo-mixsl.html miestilo_1.xsl ejemplo.xml V Congreso Nacional de Software Libre y GNU/Linux • Agosto

ver el resultado abrimos ejemplo- mixsl.html en el navegador V Congreso Nacional de Software Libre y

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

mixsl.html en el navegador V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 •

Hardy Beltran Monasterios • www.hardy.com.bo

Usando CSS con HTML/XHTML

Para mejorar la calidad de presentación de los documentos HTML/XHTML podemos utilizar CSSMonasterios • www.hardy.com.bo Usando CSS con HTML/XHTML CSS tiene la ventaja de ser muy flexible y

CSS tiene la ventaja de ser muy flexible y lograr ricos resultadosde los documentos HTML/XHTML podemos utilizar CSS Para esto requerimos Una capa de personalización XSL que

Para esto requerimosla ventaja de ser muy flexible y lograr ricos resultados Una capa de personalización XSL que

Una capa de personalización XSL que indique la hoja de estilo CSS a utilizarmuy flexible y lograr ricos resultados Para esto requerimos Crear las hojas de estilo CSS V

Crear las hojas de estilo CSSXSL que indique la hoja de estilo CSS a utilizar V Congreso Nacional de Software Libre

hoja de estilo CSS a utilizar Crear las hojas de estilo CSS V Congreso Nacional de

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

Crear las hojas de estilo CSS V Congreso Nacional de Software Libre y GNU/Linux • Agosto

Hardy Beltran Monasterios • www.hardy.com.bo

La capa de personalización

<?xml version='1.0' ?>

<xsl:stylesheet

xmlns:xsl="http://www.w3.org/1999/XSL/Transform"

version='1.0'>

<!-- Uso de una hoja de estilo CSS --> <xsl:param name="html.stylesheet" select="'docbook.css'"/> <xsl:param name="html.stylesheet.type">text/css</xsl:param>

<!-- Referencia a la hoja de estilo estandar DocBook XSL --> <xsl:import href="/usr/share/sgml/docbook/xsl- stylesheets/xhtml/docbook.xsl"/>

<!-- Parametros TOC --> <xsl:param name="toc.section.depth">2</xsl:param> <xsl:param name="section.autolabel" select="1"/>

</xsl:stylesheet>

select="1"/> </xsl:stylesheet> V Congreso Nacional de Software Libre y GNU/Linux • Agosto

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

</xsl:stylesheet> V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

Hardy Beltran Monasterios • www.hardy.com.bo

Extracto docbook.css

body { font-size: 0.9em; font-family: bitstream vera sans,sans-serif; margin: 30px; padding: 0; background-color: #ffffff;

}

pre.screen { font-size: 1.15em; padding: 10px; border: 1px solid #bbb; margin: 0.5em 2em; background-color: #fbfbfb;

}

i.replaceable { color: blue;

}

#fbfbfb; } i.replaceable { color: blue; } V Congreso Nacional de Software Libre y GNU/Linux •

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

i.replaceable { color: blue; } V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005

Hardy Beltran Monasterios • www.hardy.com.bo

¿ Necesita saber más ?

Hay dos libros que cubren ampliamente DocBook XML/SGML y DocBook XSLMonasterios • www.hardy.com.bo ¿ Necesita saber más ? DocBook: The Definitive Guide Norman Walsh and Leonard

DocBook: The Definitive Guide Norman Walsh and Leonard Muellner http://www.docbook.org Norman Walsh and Leonard Muellner http://www.docbook.org

DocBook XSL: The Complete Guide Bob Stayton http://www.docbook.org Bob Stayton http://www.docbook.org

Hay versiones impresas y para leer en línea (HTML)XSL: The Complete Guide Bob Stayton http://www.docbook.org V Congreso Nacional de Software Libre y GNU/Linux •

Hay versiones impresas y para leer en línea (HTML) V Congreso Nacional de Software Libre y

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

y para leer en línea (HTML) V Congreso Nacional de Software Libre y GNU/Linux • Agosto

Hardy Beltran Monasterios • www.hardy.com.bo

Conclusiones

DocBook llama la atención por dos cualidades importantesHardy Beltran Monasterios • www.hardy.com.bo Conclusiones Se puede generar varios formatos desde una sola fuente Los

Se puede generar varios formatos desde una sola fuenteDocBook llama la atención por dos cualidades importantes Los documentos estructurados abren la posibilidad de crear

Los documentos estructurados abren la posibilidad de crear sistemas avanzados de búsqueda de informaciónSe puede generar varios formatos desde una sola fuente Cada día las herramientas en Linux maduran

Cada día las herramientas en Linux maduran más y la adopción de DocBook se extiende.de crear sistemas avanzados de búsqueda de información V Congreso Nacional de Software Libre y GNU/Linux

en Linux maduran más y la adopción de DocBook se extiende. V Congreso Nacional de Software

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

de DocBook se extiende. V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 •

Hardy Beltran Monasterios • www.hardy.com.bo

Referencias

OASIS - http://www.oasis-open.orgHardy Beltran Monasterios • www.hardy.com.bo Referencias Sitio de Norman Walsh - http://nwalsh.com NXML mode -

Sitio de Norman Walsh - http://nwalsh.comReferencias OASIS - http://www.oasis-open.org NXML mode - http://www.thaiopensource.com/nxml-mode/ VIM -

VIM - http://www.lodestar2.com/software/docbook/vimrcNXML mode - http://www.thaiopensource.com/nxml-mode/ Conglomerate - http://www.conglomerate.org Procesadores XSLT

Conglomerate - http://www.conglomerate.orgVIM - http://www.lodestar2.com/software/docbook/vimrc Procesadores XSLT libxslt/xsltpro - http://xmlsoft.org/XSLT/

Procesadores XSLTConglomerate - http://www.conglomerate.org libxslt/xsltpro - http://xmlsoft.org/XSLT/ Saxon -

libxslt/xsltpro - http://xmlsoft.org/XSLT/

libxslt/xsltpro - http://xmlsoft.org/XSLT/

Saxon - http://saxon.sourceforge.net/

Saxon - http://saxon.sourceforge.net/

Apache Xalan - http://xml.apache.org

Apache Xalan - http://xml.apache.org

Script xmlto - http://cyberelk.net/tim/xmlto/Apache Xalan - http://xml.apache.org V Congreso Nacional de Software Libre y GNU/Linux • Agosto

Script xmlto - http://cyberelk.net/tim/xmlto/ V Congreso Nacional de Software Libre y GNU/Linux • Agosto

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

- http://cyberelk.net/tim/xmlto/ V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

Hardy Beltran Monasterios • www.hardy.com.bo

Referencias (continuación)

• www.hardy.com.bo Referencias (continuación) Repositorio Abierto DocBook

Repositorio Abierto DocBook

http://docbook.sourceforge.net/docs.html

Procesadores FOAbierto DocBook http://docbook.sourceforge.net/docs.html Apache FOP - http://xml.apache.org/fop PassiveTex -

Apache FOP - http://xml.apache.org/fop

Apache FOP - http://xml.apache.org/fop

PassiveTex - http://www.tei-c.org.uk/Software/passivetex/

PassiveTex - http://www.tei-c.org.uk/Software/passivetex/

Recursos sobre XMLPassiveTex - http://www.tei-c.org.uk/Software/passivetex/ http://www.ibiblio.org/xml/ http://www.xmlto.com V Congreso

Recursos sobre XML http://www.ibiblio.org/xml/ http://www.xmlto.com V Congreso

http://www.ibiblio.org/xml/

http://www.xmlto.com

sobre XML http://www.ibiblio.org/xml/ http://www.xmlto.com V Congreso Nacional de Software Libre y GNU/Linux • Agosto

V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

http://www.xmlto.com V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

¿ Preguntas ?

Esta presentación y los ejemplos puede encontrarlos en http://www.hardy.com.bo/seminarios/

¿ Preguntas ? Esta presentación y los ejemplos puede encontrarlos en http://www.hardy.com.bo/seminarios/