[cnsl Bolivia 2005]docbook Tutorial

  • August 2019
  • PDF
Download

This document was uploaded by user and they confirmed that they have the permission to share it. If you are author or own the copyright of this book, please report to us by using this DMCA report form. Report DMCA

Overview

Download & View [cnsl Bolivia 2005]docbook Tutorial as PDF for free.

More details

  • Words: 3,678
  • Pages: 69
Creando Documentación Técnica con DocBook

Hardy Beltran Monasterios Instructor y Consultor Linux [email protected]

Hardy Distribuido bajo Licencia Creative Commons Attribution-NonCommercial-NoDerivs

Agenda Hardy Beltran Monasterios • www.hardy.com.bo

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 V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

Introducción

¿ Y qué es documentación Técnica ? Hardy Beltran Monasterios • www.hardy.com.bo

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

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

Hardy Beltran Monasterios • www.hardy.com.bo

¿ Y qué es DocBook ? Es un sistema para escribir documentos estructurados 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 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 & Associates Desde 1998 es parte de OASIS Hoy en día participan varias empresas Novell Sun Microsystems Hewlett Packard Fujitsu y muchos otros mas V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

¿ Quienes usan DocBook ? Hardy Beltran Monasterios • www.hardy.com.bo

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 V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

Hardy Beltran Monasterios • www.hardy.com.bo

¿ 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 V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

Desventajas de DocBook Hardy Beltran Monasterios • www.hardy.com.bo

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 V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

¿ Cómo funciona DocBook ? FOP

Hardy Beltran Monasterios • www.hardy.com.bo

XSL FO

PDF

FO XML

Procesador XSLT

DVI PassiveTex

XSL

HTML, XHTML, Java Help

Modo de operación de DocBook XML

Postscript

dvips

Los íconos fueron tomados de GNOME

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

Comenzando con DocBook

¿ DocBook XML o SGML ? Hardy Beltran Monasterios • www.hardy.com.bo

XML es más simple de manejar Clara tendencia a XMLizar el mundo ;-) Históricamente DocBook ha sido SGML Desde la versión 4 es XML y SGML La versión 5 será principalmente XML Hay un creciente número de herramientas para tratar XML

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

Básicamente se necesita Hardy Beltran Monasterios • www.hardy.com.bo

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

Un procesador XSLT Por ejemplo xsltproc

Un procesador FO (si quiere PDF) Por ejemplo Apache FOP V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

Editando XML Hardy Beltran Monasterios • www.hardy.com.bo

Emacs y nXML Emacs 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 y autocompleta.

VIM Con ayuda de determinadas macros se puede editar también fácilmente XML.

Conglomerate Editor XML Libre basado en GTK. (no maduro) V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

Instalar DTD y XSL DocBook Hardy Beltran Monasterios • www.hardy.com.bo

En sistemas Debian Linux apt-get install docbook-xml docbook-xsl

En sistemas RPM con yum yum install docbook

Vea si su distro ya trae instalado DocBook Red Hat, Fedora, CentOS, WhiteBox instalan de modo predeterminado las herramientas DocBook V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

Hardy Beltran Monasterios • www.hardy.com.bo

El DTD de DocBook Define la estructura, elementos y atributos de un documento DocBook Los procesadores XSLT requieren el DTD para validar el documento XML El DTD puede ser accedido en línea o puede estar en el sistema de archivos local

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

Hardy Beltran Monasterios • www.hardy.com.bo

Hojas de estilo DocBook Norman Walsh mantiene las hojas de estilo estándar Hay dos tipos de hojas de estilo, pero con DocBook XML usamos hojas de estilo XSL Las hojas de estilo son las que permiten generar varios formatos de salida HTML, XHTML, PS, PDF, RTF, etc V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

Sobre el procesador XSLT Hardy Beltran Monasterios • www.hardy.com.bo

Puede utilizar los siguientes libxsl/xsltproc – escrito en C, originalmente para GNOME. Veloz y maduro. Saxon – escrito en Java incluye funciones experimentales. Xalan – escrito en Java por el proyecto Apache, ampliamente usado en la comunidad.

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

Instalar un procesador XSLT Hardy Beltran Monasterios • www.hardy.com.bo

En sistemas Debian Linux apt-get install xmlto En sistemas RPM con yum yum install xmlto Para usar Xalan vaya al sitio de Apache, descarge el programa y siga las instrucciones. Varias distribuciones ya traen libxsl/xsltproc instalado xmlto es un conjunto de scripts que facilita el uso de un «toolchain». Actualmente sólo usa xsltproc V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

Creando un artículo DocBook

Cabecera de DocBook XML Hardy Beltran Monasterios • www.hardy.com.bo

Un documento empieza con la cabecera:

DOCTYPE define el tipo de documento article – para un artículo (varias secciones) book – para un libro (varios capítulos con varias secciones) V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

Hardy Beltran Monasterios • www.hardy.com.bo

Datos básicos de un artículo ... <article id="tutorial-ejemplo" lang="es"> <articleinfo> Trabajando con directorios 2005 Hardy Beltran Monasterios <surname>Beltran Monasterios Hardy <email>[email protected] <para>... ... ...

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

Hardy Beltran Monasterios • www.hardy.com.bo

Secciones de un artículo Un documento tipo artículo puede estar formado de varias secciones: ... <sect1 id=”seccion_1”> Título de esta sección <para>Este párrafo aparece en la sección 1 <sect1 id=”seccion_2”> Otra sección</surname> <para>Algún texto</para> <sect2 id=”seccion_2.1> <title>Otro título</email> <para>...</para> </sect2> </sect1> ...<br /> <br /> V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia<br /> <br /> Hardy Beltran Monasterios • www.hardy.com.bo<br /> <br /> Marcas de sección Una sección es una división lógica del contenido del documento Las secciones se definen usando las marcas <sect1> a <sect5> o simplemente <section> Esta última sólo se puede usar en documentos tipo “article” Se pueden usar cuantas secciones se necesite. V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia<br /> <br /> Conociendo marcas útiles de DocBook<br /> <br /> Hardy Beltran Monasterios • www.hardy.com.bo<br /> <br /> Recomendaciones generales Todas las marcas DocBook XML se deben escribir en minúsculas Toda marca que se abra se debe cerrar Los identificadores de capítulos, secciones, tablas, figuras, etc., deben ser únicos<br /> <br /> V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia<br /> <br /> Hardy Beltran Monasterios • www.hardy.com.bo<br /> <br /> Marca <application rel="nofollow"> Se usa para referirse a una aplicación gráfica o texto. Ejemplo: Para trabajar con archivos Zip comprimidos, usted puede usar el programa <application rel="nofollow">File Roller</application> en modo gráfico o utilizar el programa <application rel="nofollow">Zip</application> desde la línea de órdenes.<br /> <br /> V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia<br /> <br /> Hardy Beltran Monasterios • www.hardy.com.bo<br /> <br /> Marca <citetitle> Se usa para hacer cita una referencia externa. Por ejemplo: Para una descripción detallada del proceso de instalación consulte la <citetitle>Guía Oficial de Instalación para Intel x86</citetitle>.<br /> <br /> V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia<br /> <br /> Hardy Beltran Monasterios • www.hardy.com.bo<br /> <br /> Marca <command> Se usa para referirse al ejecutable de una aplicación, a una orden o una directiva de configuración. Por ejemplo: 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.<br /> <br /> V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia<br /> <br /> Hardy Beltran Monasterios • www.hardy.com.bo<br /> <br /> Marca <computeroutput> Se usa para mostrar mensajes que aparecen en la pantalla. Por ejemplo: <computeroutput>rm: ¿borrar el fichero regular «Makefile»? (s/n)</computeroutput><br /> <br /> El contenido se debe poner inmediatamente después de la marca. Como en la marca <screen> se respetan los espacios y líneas extras.<br /> <br /> V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia<br /> <br /> Marca <emphasis> Hardy Beltran Monasterios • www.hardy.com.bo<br /> <br /> Se usa para poner énfasis a una frase Ejemplo: Usar <command>/sbin/mke2fs</command> sobre un sistema de archivos existente, provocará que se pierda <emphasis>toda</emphasis> la información contenida en éste.<br /> <br /> V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia<br /> <br /> Hardy Beltran Monasterios • www.hardy.com.bo<br /> <br /> Marca <example> Se usa para mostrar ejemplos acompañados de un título Típicamente son secciones de código o de archivos de configuración. Ejemplo: <example id=”ej-resolv”> <title>Dominio y servidor DNS a utilizar <screen> domain unsitio.com nameserver 192.168.1.4;

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

Hardy Beltran Monasterios • www.hardy.com.bo

Marca Se usa para hacer referencia a nombres de archivo o directorios. Si es un directorio se sugiere incluir “/” al final para clarificar el texto Ejemplo: El archivo /etc/passwd contiene varias piezas de información de una cuenta de usuario.

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

Hardy Beltran Monasterios • www.hardy.com.bo

Marca
Use si quiere incluir una figura que tenga un título y una breve descripción
Preferencias de Mozilla <mediaobject> La figura muestra las preferencias...


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

Hardy Beltran Monasterios • www.hardy.com.bo

Marca Se usa para insertar una nota al pie de página Ejemplo: En una instalación estándar, la partición asignada a /boot <para>En algunos sistemas debido a problemas con discos grandes, se acostumbra crear esta partición dentro los primeros 1024 cilindros. requerirá un espacio de 60 a 100 MiB.

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

Hardy Beltran Monasterios • www.hardy.com.bo

Marca Se usa para mostrar una palabra o frase en un idioma diferente al del documento Ejemplo: Las siguientes órdenes deben ser escritas desde el indicador del sistema (prompt ).

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

Hardy Beltran Monasterios • www.hardy.com.bo

Lista de ítemes Se usa para mostrar información breve que no requiere un orden específico Ejemplo: <listitem> <para>Revisar uso de espacio libre en disco <listitem> <para>Monitorear y gestionar procesos <listitem> <para>Mantener programas al día

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

Hardy Beltran Monasterios • www.hardy.com.bo

Lista ordenada Para mostrar una lista de ítemes cuyo orden tiene importancia Ejemplo: <listimtem> <para>Instalar el paquete <listimtem> <para>Modificar el archivo de configuración <listimtem> <para>Iniciar el servicio

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

Hardy Beltran Monasterios • www.hardy.com.bo

Lista de términos y definiciones Para mostrar una lista de términos y definiciones con sus descripciones Servidor <listimtem> <para>Ofrece Servidor <listimtem> <para>Provee ...

X las operaciones básicas de...

de Letras X los tipos de letras...

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

Hardy Beltran Monasterios • www.hardy.com.bo

Lista simple <simplelist> Se usa principalmente para crear una lista contenida en una tabla Ejemplo: <simplelist> <member>Procesador Intel <member>Pentium IV 4.2 Ghz <member>512 MiB RAM <member>80 GiB Disco <member>CDWR/DVD

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

Hardy Beltran Monasterios • www.hardy.com.bo

Marca muestra la versión de núcleo que está ejecutando su sistema.

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

Hardy Beltran Monasterios • www.hardy.com.bo

Marca <para> Esta marca se emplea alrededor de cualquier párrafo simple. Ejemplo: <para> La orden uname seguida de la opción muestra la versión de núcleo que está ejecutando su sistema.

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

Hardy Beltran Monasterios • www.hardy.com.bo

Contenido en marcas <para> Sólo use marcas <para> alrededor de párrafos simples únicamente Específicamente no use <para> alrededor de las siguientes marcas: <screen> V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

Hardy Beltran Monasterios • www.hardy.com.bo

Marca <prompt> Se usa para mostrar un indicador (prompt). Ejemplo: En el indicador <prompt>LILO: escriba linux para arrancar su sistema. El indicador <prompt># está reservado al usuario privilegiado root.

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

Hardy Beltran Monasterios • www.hardy.com.bo

Marca Se usa indicar que el lector debe remplazar el texto mostrado de manera adecuada a su situación Ejemplo: Los módulos del núcleo se encuentran en el directorio /lib/modules/versión-denúcleo/

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

Hardy Beltran Monasterios • www.hardy.com.bo

Marca <screen> 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: <screen> <userinput>uname -r <para>Que mostrará un resultado similar a: <screen> 2.4.29-686

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

Hardy Beltran Monasterios • www.hardy.com.bo

Contenido en marcas <screen> La marca y el contenido deben estar justificados a la izquierda Cualquier espacio dentro la marca <screen> se conserva Esta marca puede contener otras como: , <userinput>, o Por definición no se requiere incluir otras marcas dentro de <screen> V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia

Hardy Beltran Monasterios • www.hardy.com.bo

Marca
Características de POP e IMAP <entry>Característica <entry>POP <entry>IMAP <entry>Trabaja en modo conectado (on-line) <entry>Si <entry>Si


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

Hardy Beltran Monasterios • www.hardy.com.bo

Tablas
Características de POP... <tgroup cols=”3”> <colspec colnum="1" colname=... <colspec colnum="2" colname=... <colspec colnum="3" colname=... <thead> <row> Tabla 1. Características POP e IMAP <entry>Característica</entry> <entry>POP</entry> Característica POP IMAP <entry>IMAP</entry> </row> Trabaja en modo conectado Si Si </thead> <tbody> <row> <entry>Trabaja en modo... <entry>Si</entry> <entry>Si</entry> </row> </tbody> </tgroup> </table><br /> <br /> V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia<br /> <br /> Hardy Beltran Monasterios • www.hardy.com.bo<br /> <br /> Marca <userinput> Se usa para indicar lo que el usuario debe escribir. Ejemplo: En el indicador del sistema escriba: <userinput>fdformat /dev/fd0</userinput><br /> <br /> V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia<br /> <br /> Hardy Beltran Monasterios • www.hardy.com.bo<br /> <br /> Marca <xref> Use para hacer referencia a otra sección o capítulo del documento Ejemplo: Para ver más información sobre las particiones de disco en Linux, refiérase a <xref linkend=”sec-particiones” />.<br /> <br /> V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia<br /> <br /> Generando documentos<br /> <br /> Generar un sólo archivo HTML Hardy Beltran Monasterios • www.hardy.com.bo<br /> <br /> Por claridad vamos a usar la variable DB=/usr/share/xml/docbook/stylesheet/nwalsh<br /> <br /> Aplicamos la hoja de estilo al documento XML para generar HTML xsltproc -o ejemplo.html $DB/html/docbook.xsl ejemplo.xml<br /> <br /> Ver el documento en el navegador mozilla ~/Vcongreso/ejemplo.html<br /> <br /> V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia<br /> <br /> Generar varios archivos HTML Hardy Beltran Monasterios • www.hardy.com.bo<br /> <br /> Cada sección es un archivo HTML El archivo inicial es «index.html» La hoja de estilo que se debe usar es «chunk.xsl» xsltproc $DB/html/chunk.xsl ejemplo.xml<br /> <br /> Ver el documento en el navegador mozilla ~/Vcongreso/index.html<br /> <br /> V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia<br /> <br /> Generar PDF Hardy Beltran Monasterios • www.hardy.com.bo<br /> <br /> Es un proceso de dos pasos Generar documento FO desde XML Generar PDF desde FO<br /> <br /> Ejemplo xsltproc -o ejemplo.fo $DB/fo/docbook.xsl ejemplo.xml fop.sh -fo ejemplo.fo -pdf ejemplo.pdf<br /> <br /> V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia<br /> <br /> Hardy Beltran Monasterios • www.hardy.com.bo<br /> <br /> Limitaciones de generar PDF Las herramientas libres para generar PDF no están del todo maduras FOP PassiveTex / pdflatex<br /> <br /> Los problemas típicos son: Contenido dentro de tablas Manejo de imágenes con formato especial de presentación Problemas de memoria al generar documentos de muchas páginas (> 100) V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia<br /> <br /> Hardy Beltran Monasterios • www.hardy.com.bo<br /> <br /> Alternativas propietarias Muchos autores de DocBook usan la herramienta XEP XEP genera a partir de XML documentos PDF y PostScript aplicando XSL FO Tienen una versión gratuita para uso no comercial (Personal Edition) Visite http://www.renderx.com/ para más información V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia<br /> <br /> Hardy Beltran Monasterios • www.hardy.com.bo<br /> <br /> Personalización de XSL Una ventaja de las hojas de estilo XSL es su flexible personalización (uso de «capas») La personalización es posible de dos formas Modificando parámetros predeterminados Ej. Tipo de papel, enumerar títulos<br /> <br /> Modificando procesamiento de elementos Ej. Insertar una imagen al inicio de un capítulo V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia<br /> <br /> Hardy Beltran Monasterios • www.hardy.com.bo<br /> <br /> 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ándar Una capa de personalización es una hoja de estilo XSL, que se aplica encima de las hojas de estilo DocBook XSL existentes<br /> <br /> V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia<br /> <br /> Ejemplo de capa de personalización XSL Hardy Beltran Monasterios • www.hardy.com.bo<br /> <br /> <?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/xslstylesheets/xhtml/docbook.xsl"/> <!-- Parametros TOC --> <xsl:param name="toc.section.depth">2</xsl:param> <xsl:param name="section.autolabel" select="1"/> </xsl:stylesheet><br /> <br /> Mire en /usr/share/doc/docbook-xsl/doc/reference.html para ver una referencia de los parámetros disponibles V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia<br /> <br /> Hardy Beltran Monasterios • www.hardy.com.bo<br /> <br /> Uso de la capa de personalización XSL Basta con usar nuestra hoja de estilo en lugar de la hoja de estilo estándar Usando nuestro procesador XSLT xsltproc -o ejemplo-mixsl.html miestilo_1.xsl ejemplo.xml<br /> <br /> Para ver el resultado abrimos ejemplomixsl.html en el navegador<br /> <br /> V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia<br /> <br /> Hardy Beltran Monasterios • www.hardy.com.bo<br /> <br /> Usando CSS con HTML/XHTML Para mejorar la calidad de presentación de los documentos HTML/XHTML podemos utilizar CSS CSS tiene la ventaja de ser muy flexible y lograr ricos resultados Para esto requerimos Una capa de personalización XSL que indique la hoja de estilo CSS a utilizar Crear las hojas de estilo CSS V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia<br /> <br /> La capa de personalización Hardy Beltran Monasterios • www.hardy.com.bo<br /> <br /> <?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/xslstylesheets/xhtml/docbook.xsl"/> <!-- Parametros TOC --> <xsl:param name="toc.section.depth">2</xsl:param> <xsl:param name="section.autolabel" select="1"/> </xsl:stylesheet><br /> <br /> V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia<br /> <br /> Extracto docbook.css Hardy Beltran Monasterios • www.hardy.com.bo<br /> <br /> 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; }<br /> <br /> V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia<br /> <br /> Hardy Beltran Monasterios • www.hardy.com.bo<br /> <br /> ¿ Necesita saber más ? Hay dos libros que cubren ampliamente DocBook XML/SGML y DocBook XSL DocBook: The Definitive Guide Norman Walsh and Leonard Muellner http://www.docbook.org DocBook XSL: The Complete Guide Bob Stayton http://www.docbook.org<br /> <br /> Hay versiones impresas y para leer en línea (HTML) V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia<br /> <br /> Hardy Beltran Monasterios • www.hardy.com.bo<br /> <br /> Conclusiones DocBook llama la atención por dos cualidades importantes Se puede generar varios formatos desde una sola fuente Los documentos estructurados abren la posibilidad de crear sistemas avanzados de búsqueda de información<br /> <br /> Cada día las herramientas en Linux maduran más y la adopción de DocBook se extiende. V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia<br /> <br /> Referencias Hardy Beltran Monasterios • www.hardy.com.bo<br /> <br /> OASIS - http://www.oasis-open.org Sitio de Norman Walsh - http://nwalsh.com NXML mode - http://www.thaiopensource.com/nxml-mode/ VIM - http://www.lodestar2.com/software/docbook/vimrc Conglomerate - http://www.conglomerate.org Procesadores XSLT libxslt/xsltpro - http://xmlsoft.org/XSLT/ Saxon - http://saxon.sourceforge.net/ Apache Xalan - http://xml.apache.org Script xmlto - http://cyberelk.net/tim/xmlto/<br /> <br /> V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia<br /> <br /> Referencias<br /> <br /> (continuación)<br /> <br /> Hardy Beltran Monasterios • www.hardy.com.bo<br /> <br /> Repositorio Abierto DocBook http://docbook.sourceforge.net/docs.html Procesadores FO Apache FOP<br /> <br /> -<br /> <br /> http://xml.apache.org/fop<br /> <br /> PassiveTex - http://www.tei-c.org.uk/Software/passivetex/ Recursos sobre XML http://www.ibiblio.org/xml/ http://www.xmlto.com<br /> <br /> V Congreso Nacional de Software Libre y GNU/Linux • Agosto 2005 • Cochabamba, Bolivia<br /> <br /> ¿ Preguntas ? Esta presentación y los ejemplos puede encontrarlos en http://www.hardy.com.bo/seminarios/ </div> </div> <hr /> <h4>Related Documents</h4> <div class="row"> <div class="col-lg-2 col-md-4 col-sm-6 col-6"> <div class="card item-doc mb-4"> <a href="https://pdfcoke.com/documents/cnsl-bolivia-2005docbook-tutorial-dvl3d1vk23wp" class="d-block"><img class="card-img-top" src="https://pdfcoke.com/img/crop/300x300/dvl3d1vk23wp.jpg" alt=""/></a> <div class="card-body text-left"> <h5 class="card-title"><a href="https://pdfcoke.com/documents/cnsl-bolivia-2005docbook-tutorial-dvl3d1vk23wp" class="text-dark">[cnsl Bolivia 2005]docbook Tutorial</a></h5> <small class="text-muted float-left"><i class="fas fa-clock"></i> August 2019</small> <small class="text-muted float-right"><i class="fas fa-eye"></i> 13</small> <div class="clearfix"></div> </div> </div> </div> <div class="col-lg-2 col-md-4 col-sm-6 col-6"> <div class="card item-doc mb-4"> <a href="https://pdfcoke.com/documents/cnsl-bolivia-2005honeypots-l48ojnj4l31w" class="d-block"><img class="card-img-top" src="https://pdfcoke.com/img/crop/300x300/l48ojnj4l31w.jpg" alt=""/></a> <div class="card-body text-left"> <h5 class="card-title"><a href="https://pdfcoke.com/documents/cnsl-bolivia-2005honeypots-l48ojnj4l31w" class="text-dark">[cnsl Bolivia 2005]honeypots</a></h5> <small class="text-muted float-left"><i class="fas fa-clock"></i> August 2019</small> <small class="text-muted float-right"><i class="fas fa-eye"></i> 15</small> <div class="clearfix"></div> </div> </div> </div> <div class="col-lg-2 col-md-4 col-sm-6 col-6"> <div class="card item-doc mb-4"> <a href="https://pdfcoke.com/documents/cnsl-bolivia-2005simulador-ns2-eq6zpn618opk" class="d-block"><img class="card-img-top" src="https://pdfcoke.com/img/crop/300x300/eq6zpn618opk.jpg" alt=""/></a> <div class="card-body text-left"> <h5 class="card-title"><a href="https://pdfcoke.com/documents/cnsl-bolivia-2005simulador-ns2-eq6zpn618opk" class="text-dark">[cnsl Bolivia 2005]simulador Ns2</a></h5> <small class="text-muted float-left"><i class="fas fa-clock"></i> August 2019</small> <small class="text-muted float-right"><i class="fas fa-eye"></i> 10</small> <div class="clearfix"></div> </div> </div> </div> <div class="col-lg-2 col-md-4 col-sm-6 col-6"> <div class="card item-doc mb-4"> <a href="https://pdfcoke.com/documents/cnsl-bolivia-2005codigo-libre-k09351pv0oe8" class="d-block"><img class="card-img-top" src="https://pdfcoke.com/img/crop/300x300/k09351pv0oe8.jpg" alt=""/></a> <div class="card-body text-left"> <h5 class="card-title"><a href="https://pdfcoke.com/documents/cnsl-bolivia-2005codigo-libre-k09351pv0oe8" class="text-dark">[cnsl Bolivia 2005]codigo Libre</a></h5> <small class="text-muted float-left"><i class="fas fa-clock"></i> August 2019</small> <small class="text-muted float-right"><i class="fas fa-eye"></i> 20</small> <div class="clearfix"></div> </div> </div> </div> <div class="col-lg-2 col-md-4 col-sm-6 col-6"> <div class="card item-doc mb-4"> <a href="https://pdfcoke.com/documents/cnsl-bolivia-2005redes-de-alto-rendimiento-kxlo6ye09361" class="d-block"><img class="card-img-top" src="https://pdfcoke.com/img/crop/300x300/kxlo6ye09361.jpg" alt=""/></a> <div class="card-body text-left"> <h5 class="card-title"><a href="https://pdfcoke.com/documents/cnsl-bolivia-2005redes-de-alto-rendimiento-kxlo6ye09361" class="text-dark">[cnsl Bolivia 2005]redes De Alto Rendimiento</a></h5> <small class="text-muted float-left"><i class="fas fa-clock"></i> August 2019</small> <small class="text-muted float-right"><i class="fas fa-eye"></i> 7</small> <div class="clearfix"></div> </div> </div> </div> <div class="col-lg-2 col-md-4 col-sm-6 col-6"> <div class="card item-doc mb-4"> <a href="https://pdfcoke.com/documents/bolivia-4d378ljkx8zx" class="d-block"><img class="card-img-top" src="https://pdfcoke.com/img/crop/300x300/4d378ljkx8zx.jpg" alt=""/></a> <div class="card-body text-left"> <h5 class="card-title"><a href="https://pdfcoke.com/documents/bolivia-4d378ljkx8zx" class="text-dark">Bolivia</a></h5> <small class="text-muted float-left"><i class="fas fa-clock"></i> June 2020</small> <small class="text-muted float-right"><i class="fas fa-eye"></i> 27</small> <div class="clearfix"></div> </div> </div> </div> </div> </div> </div> </div> </div> <footer class="footer pt-5 pb-0 pb-md-5 bg-primary text-white"> <div class="container"> <div class="row"> <div class="col-md-3 mb-3 mb-sm-0"> <h5 class="text-white font-weight-bold mb-4">Our Company</h5> <ul class="list-unstyled"> <li><i class="fas fa-location-arrow"></i> 3486 Boone Street, Corpus Christi, TX 78476</li> <li><i class="fas fa-phone"></i> +1361-285-4971</li> <li><i class="fas fa-envelope"></i> <a href="mailto:info@pdfcoke.com" class="text-white">info@pdfcoke.com</a></li> </ul> </div> <div class="col-md-3 mb-3 mb-sm-0"> <h5 class="text-white font-weight-bold mb-4">Quick Links</h5> <ul class="list-unstyled"> <li><a href="https://pdfcoke.com/about" class="text-white">About</a></li> <li><a href="https://pdfcoke.com/contact" class="text-white">Contact</a></li> <li><a href="https://pdfcoke.com/help" class="text-white">Help / FAQ</a></li> <li><a href="https://pdfcoke.com/account" class="text-white">Account</a></li> </ul> </div> <div class="col-md-3 mb-3 mb-sm-0"> <h5 class="text-white font-weight-bold mb-4">Legal</h5> <ul class="list-unstyled"> <li><a href="https://pdfcoke.com/tos" class="text-white">Terms of Service</a></li> <li><a href="https://pdfcoke.com/privacy-policy" class="text-white">Privacy Policy</a></li> <li><a href="https://pdfcoke.com/cookie-policy" class="text-white">Cookie Policy</a></li> <li><a href="https://pdfcoke.com/disclaimer" class="text-white">Disclaimer</a></li> </ul> </div> <div class="col-md-3 mb-3 mb-sm-0"> <h5 class="text-white font-weight-bold mb-4">Follow Us</h5> <ul class="list-unstyled list-inline list-social"> <li class="list-inline-item"><a href="#" class="text-white" target="_blank"><i class="fab fa-facebook-f"></i></a></li> <li class="list-inline-item"><a href="#" class="text-white" target="_blank"><i class="fab fa-twitter"></i></a></li> <li class="list-inline-item"><a href="#" class="text-white" target="_blank"><i class="fab fa-linkedin"></i></a></li> <li class="list-inline-item"><a href="#" class="text-white" target="_blank"><i class="fab fa-instagram"></i></a></li> </ul> <h5 class="text-white font-weight-bold mb-4">Mobile Apps</h5> <ul class="list-unstyled "> <li><a href="#" class="bb-alert" data-msg="IOS app is not available yet! Please try again later!"><img src="https://pdfcoke.com/static/images/app-store-badge.svg" height="45" /></a></li> <li><a href="#" class="bb-alert" data-msg="ANDROID app is not available yet! Please try again later!"><img style="margin-left: -10px;" src="https://pdfcoke.com/static/images/google-play-badge.png" height="60" /></a></li> </ul> </div> </div> </div> </footer> <div class="footer-copyright border-top pt-4 pb-2 bg-primary text-white"> <div class="container"> <p>Copyright © 2024 PDFCOKE.</p> </div> </div> <script src="https://pdfcoke.com/static/javascripts/jquery.min.js"></script> <script src="https://pdfcoke.com/static/javascripts/popper.min.js"></script> <script src="https://pdfcoke.com/static/javascripts/bootstrap.min.js"></script> <script src="https://pdfcoke.com/static/javascripts/bootbox.all.min.js"></script> <script src="https://pdfcoke.com/static/javascripts/filepond.js"></script> <script src="https://pdfcoke.com/static/javascripts/main.js?v=1731041992"></script> <!-- Global site tag (gtag.js) - Google Analytics --> <script async src="https://www.googletagmanager.com/gtag/js?id=UA-144986120-1"></script> <script> window.dataLayer = window.dataLayer || []; function gtag(){dataLayer.push(arguments);} gtag('js', new Date()); gtag('config', 'UA-144986120-1'); </script> </body> </html><script data-cfasync="false" src="/cdn-cgi/scripts/5c5dd728/cloudflare-static/email-decode.min.js"></script>