El manual de xsldbg
Copyright © 2002, 2003 Keith Isdale
Se concede permiso para copiar, distribuir y/o modificar este documento bajo los términos de la Licencia Libre de Documentación de GNU, versión 1.1 o posterior publicada por la Free Software Foundation; con secciones no invariantes, con textos que no estén en la cubierta, y con textos que no estén en la contraportada. Se incluye una copia de la licencia en the section entitled "GNU Free Documentation License".
es unxsldbga herramienta pensada para ayudarle a comprender las hojas de estilo. Lo que la hace diferente de otros depuradores de hojas de estilo es la capacidad de buscar elementos de interés y poder seguir una traza de la ejecución de la hoja de estilos.
Tabla de contenidos
Lista de tablas
xsldbg es una herramienta textual para depurar hojas de estilos (el eXtensible Stylesheet Language, lenguaje de hoja de estilo extensible) y tiene comandos similares al depurador de Unix/Linux gdb. Tiene tres modos principales de ejecución de hojas de estilos.
| Ejecutar toda la hoja de estilos. |
| Pasar a la siguiente instrucción xsl. |
| Continuar hasta que se encuentre el siguiente punto de interrupción, o se reinicie la hoja de estilos. |
En sistemas que tengan la biblioteca readline, puede usar las techas atrás y adelante para navegar por el histórico de los comandos que se han introducido. En todos los sistemas, se puede repetir el último comando que se ha introducido simplemente pulsando la tecla <ENTER>.
Si su sistema operativo lo admite, los nombres de archivos se expandirán.
Algunos comandos llevan más de un argumento. Se pueden usar comillas dobles para evitar que las expresiones complejas se traten como un argumento. Por ejemplo, "* | @" le permitiría definir un punto de interrupción en la plantilla que se llama "* | @"
La tabla siguiente describe los términos que se usan en la subsiguiente guía de comandos.
| NOMBRE_PLANTILLA: Un nombre de plantilla válido sólo contiene carácteres ASCII con los códigos desde el 0x00 hasta el 0x7F. Y puede ser un nombre plenamente cualificado, por ejemplo«xsl:NombrePlantilla». |
| NOMBREARCHIVO: Un nombre de archivo local válido para el sistema del usuario. Puede tener un prefijo «~» en las plataformas *nix y CYGWIN. O las variables de entorno disponibles en RISC OS. |
| URI : Un Uniform Resource Identifier (Identificador de Recurso Uniforme), tal y como se define en el RFC 2396. |
| NOMBRE_MODO: El modo de la plantilla, que puede ser un nombre plenamente cualificado, por ejemplo «xsl:nombreModo». |
| QNOMBRE: Un nombre plenamente cualificado, por ejemplo «xsl:parteLocal». |
| NUMLINEA: Un número de línea válido en el <NOMBREARCH> asociado. |
| NUMERO_DE_MARCOS: Un marco de número de líneas válido con el que cambiar la posición. |
| ID_PUNTOINT: Un número de punto de interrupción válido. |
| ID_OBSERV: Un número de expresión de observador válido, tal y como indica el comando showwatch. |
| VELOCIDAD: velocidad de avance a través del código, entre 0 y 9. |
| (Comentario): un comentario sobre el significado o la utilización de un comando. |
| { opc1 | opc2 | opc2 .. etc}: Elegir una de las opciones. |
| XPATH: una selección de nodos de xpath |
| ID_PARAM: un número de parámetro válido, tal y como se indica para el comando showparam |
| RUTA: Una ruta a la que pasar el directorio de trabajo. En algunos sistemas operativos, el prefijo «~» se reemplaza por la ruta del directorio personal. |
| TEXTO: Texto de formato libre (sin restricciones). |
| COMANDO: Un comando válido para xsdbg. |
| QNOMBRE: Un nombre válido para una variable o un parámetro. |
| ORIGEN: La hoja de estilos que se va a ejecutar. Puede ver la leyenda para <NOMBREARCH> y <URI>. |
| DATA: El (documento) de datos xml que va a procesar la hoja de estilos. Puede ver la leyenda para <NOMBREARCH> y <URI>. |
| RUTA_DISPOSITIVO: Es un terminal válido para el sistema operativo. |
| NIVEL_TTY: Es un nivel de entrada/salida válido que se va a usar. |
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
| Relativos a la ayuda: help |
| Relativos a la ejecución: {bye|exit| quit}, step, stepup, stepdown, next, continue, run, trace, setoption, options |
| Relativos a los parámetros d elibxslt: addparam, delparam, showparam, output, setoption, options |
| Relacionados con las plantillas: templates, where, frame |
| Relacionados con los puntos de interrupción: break, showbreak, delete, enable |
| Ver la expresión(xpath): cat |
| Vista de nodos: ls, dir, du, cat, pwd |
| Vista de variables: globals, locals, cat, addwatch |
| Definición de variables: set |
| Selección de nodos: source, data, cd |
| Búsqueda: search |
| Relacionados con el sistema operativo: chdir, shell, tty |
| Relacionados con el archivo: output, entities, system, public |
| Comandos desactivados de archivos: validate, load, save, write, free |
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Añade un parámetro libxslt ; equivalente a proporcionar --param <QNAME>:<XPATH> en la línea de órdenes.
Añade un observador para una expresión. Puede dirigirse a showwatch para obtener más información sobre la muestra de valores de watch.
Nombre para acceso rápido: watch
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Se detiene en la plantilla, en una ubicación de la hoja de estilos o en un archivo xml cargado por xsldbg, o en el nodo actual. Nuevo en xsldbg 3.1.4: en modo de compatibilidad con gdb, los puntos de interrupción huérfanos se pueden definir en un archivo específico y en un número de línea, y se puede resolver más tarde sobre uno activo.
Nombre para acceso rápido: b
xsldbg intentará averiguar la URL completa, dado un
| nombre de archivo sin una ruta especificada. |
| un archivo del mismo directorio que la hoja de estilos cargada «superior» |
| un nombre de archivo relativo al directorio de trabajo actual de xsldbg |
break -l xsldoc.xsl 26
Este comando hará coincidir con una plantilla QNAME parcial o completa y/o un nombre de modo proporcionado. Por ejemplo, «plantilla» se encajará con cualquier QNAME que tenga una parte local «template».
Cualquier espacio de nombres que haya en el QNAME que se proporciona se expandirá como se indique en los espacios de nombres que estén definidos en el archivo fuente XSL. Por ejemplo, «xsl:test1» se expandirá como «http://www.w3.org/199/XSL/Transform:test1».
Puede ser necesario que se resuelva un punto de introducción solicitado con su URL y número de línea asociados. Esto se hace automáticamente una vez que xsldbg ha visto la primera plantilla. Los puntos de interrupción se vuelven a validar poco después del comienzo de cada ejecución.
La validación automática de puntos de interrupción se usa cuando está activado el modo gdb: el comportamiento predefinido de xsldbg.
Tabla 3.4. Uso de break
| break -l <FILENAME> <LINENO> (Para definir el punto de interrupción en un archivo y número de línea específicos). |
| break -l <URI> <LINENO> (Para definir el punto de interrupción en una URI y número de línea específicos). |
| break <TEMPLATE_NAME> (Para detenerse en una plantilla nombrada o que coincida con la que se indica). |
| break <TEMPLATE_NAME> <MODE_NAME> (Para detenerse en una plantilla en el modo indicado). > |
| break "" <MODE_NAME> (Para detenerse en cualquier plantilla que tenga un nombre de modo indicado). |
| break * (Para detenerse en cualquier plantilla que se encuentre). |
| break \* (Para detenerse en la plantilla «*». No se dará un trato especial a otros nombres que incluyan «*»). |
| break (Para poner el punto de interrupción en el nodo actual. Sí que se incluye en los nodos de datos xml.) |
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Detiene el procesamiento de la hoja de estilos tan pronto como sea posible.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Imprime el resultado de una expresión de xpath en el nodo relativo actual.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Pasa a la ruta especificada en un xpath.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Pasa al directorio de trabajo
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Continúa la ejecución de una hoja de estilos, deteniéndose en cualquier punto de interrupción que se encuentre.
Nombre para acceso rápido: c
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Pasa a mostrar el nodo actual en los datos xml. O cambia los datos xml que se usan
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Elimina un punto de interrupción de la plantilla
Nombre para acceso rápido: c
Tabla 3.11. Uso de delete
| delete (Para eliminar un punto de interrupción del nodo actual). |
| delete <ID_PUNTOINT> (Para eliminar un punto de interrupción, conocido el número específico del punto de interrupción). |
| delete -l <NOMBREARCH> <NUMLINEA> (Elimina el punto de interrupción del número de línea y archivo especificados). |
| delete -l <URI> <NUMLINEA> (Elimina el punto de interrupción del número de línea y la URI especificados). |
| delete <NOMBREPLANTILLA> (Para eliminar un punto de interrupción de la plantilla que se indica). |
| delete * (Para eliminar todos los puntos de interrupción). |
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Elimina un parámetro de libxslt
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Elimina la observación de una expresión o elimina todas las expresiones observadas que se muestran en el comando «showwatch».
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Muestra la lista de nodos de forma similar a como lo hace el comando «dir» en la shell.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Inactiva un punto de interrupción
Tabla 3.15. Uso de disable
| disable (Para desactivar un punto de interrupción en el nodo actual). |
| disable <ID_PUNTOINT> (Para inactivar un punto de interrupción con un número específico). |
| disable -l <NOMBREARCH> <NUMLINEA> (Inactiva el punto de interrupción del archivo y número de línea que se indique). |
| disable -l <URI> <NUMLINEA> (Inactiva el punto de interrupción de la URI y el número de línea que se indique). |
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Activa o inactiva un punto de interrupción (alterna entre activar e inactivar).
Nombre para acceso rápido: e
Tabla 3.18. Uso de enable
| enable (Para activar o inactivar un punto de interrupción en el nodo actual). |
| enable <ID_PUNTOINT> (Para activar o inactivar un punto de interrupción, estando especificado el número del punto). |
| enable -l <NOMBREARCH> <NUMLINEAO> (Activa o inactiva el punto de interrupción en el archivo y número de línea que se indica). |
| enable -l <URI> <NUMLINEA> (Activa o inactiva el punto de interrupción que hay en la URI y el número de línea que se indica). |
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Muestra la lista de entidades externas generales analizadas que se han usado en el archivo de datos (documento).
Nombre para acceso rápido: ent
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Detiene el procesamiento de la hoja de estilos tan pronto como sea posible.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Muestra el marco de pila con la profundidad indicada.
Nombre para acceso rápido: f
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Libera la hoja de estilos y los datos (si está inactivo, vea lo que se dice de run)
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Muestra una lista de las variables o parámetros de la hoja de estilos globales. Muestra el valor de una variable global.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Muestra ayuda genérica o sobre el comando
Nombre para acceso rápido: h
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Carga desde disco las opciones de xsldbg y las preferencias del usuario.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Muestra una lista con las variables o parámetros locales de la hoja de estilos. Muestra el valor de una variable local.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Evita una llamada a plantilla xsl (xsl:call-template) o una aplicación de plantilla xsl (xsl:apply-templates). Este comando tiene el mismo efecto que introducir los comando «step» y luego «up».
Nombre para acceso rápido: n
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Especifica un archivo local y en el que se puede escribir, para mandar allí los resultados.
Nombre para acceso rápido: o
Tabla 3.30. Uso de output
| output <NOMBREARCH> (El nombre de un archivo local en el que se puede escribir. Puede contener el prefijo «~» en las plataformas *nix y CYGWIN, o variables de entorno en RISC OS). |
| output <URI> (La <URI> sólo debe puede usar el protocolo «file://». Esa URI se convierte a un nombre de archivo adecuado para el sistema operativo). |
| output - (Envía a la salida estándar. Sólo se debe usar cuando se esté usando xsldbg desde la línea de órdenes). |
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Muestra el valor al que está mapeado un id. público según el catálogo actual.
Nombre para el acceso rápido: pub
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Detiene el procesamiento de la hoja de estilos tan pronto como sea posible.
Nombre para acceso rápido: q
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Guarda en disco las opciones de xsldbg y las preferencias del usuario.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Busca en una base de datos con toda la información recogida de la hojas de estilos cargadas
Todos los archivos de salida se almacenan donde indique el valor de la opción «searchresultpath», si está definida, o en el mismo directorio que la hoja de estilos. searchresults.xml se suele transformar en search.xsl, pero se transformará usando searchhtml.xsl, si está definida la opción «prefrehtml».
Cuando el comando «search» se hace funcionar, se crea un archivo (searchresults.xml). Luego puede procesar este archivo con su propia hoja de estilos para presentar los datos de otras maneras. Si no está definida la opción «preferhtml», se mostrará en pantalla «searchresult.txt».
Según la cantidad de datos que se haya recogido, puede llevar cierto tiempo la finalización de este comando.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Define una opción para la ejecución de una hoja de estilos.
Tiene que usar el comando «run» para activar los cambios.
Tabla 3.38. Uso de setoption
| setoption <NOMBRE_OPCION> <VALOR_ENTERO> | ||||||||||||||||||||||||
| Donde <NOMBRE_OPCION> puede ser o bien | ||||||||||||||||||||||||
|
| ||||||||||||||||||||||||
| Donde el valor es cierto si NO es igual a cero. | ||||||||||||||||||||||||
| Donde el valor es falso, SI ES igual a cero. | ||||||||||||||||||||||||
| stdout Muestra todos los mensajes de error en la salida estándar (stdout). Normalmente, los mensajes de error van a la salida de error (stderr). | ||||||||||||||||||||||||
| setoption <NOMBRE_OPCION> "<VALOR_DE_CADENA>" (No debe contener comillas dobles dentro de <VALOR_DE_CADENA>). | ||||||||||||||||||||||||
| setoption <NOMBRE_DE_OPCION> <VALOR_DE_CADENA> (No debe contener ningún espacio ni comillas dobles en <VALOR_DE_CADENA>). | ||||||||||||||||||||||||
| Donde <NOMBRE_OPCION> puede ser o bien | ||||||||||||||||||||||||
|
|
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Ejecuta un comando en la shell
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Para mostrar la lista de puntos de interrupción de la plantilla.
Nombre para acceso rápido: show
Si existe un modo en el punto de interrupción de la plantilla, se añadirá al final del nombre de la plantilla para el punto de interrupción. Ejemplo de la salida:
| Punto de interrupción 3 activado para la plantilla «*» en la línea 105 del archivo test1.xsl. |
| Punto de interrupción 2 activado para la plantilla «* testMode» en la línea 109 del archivo test1.xsl. |
| Punto de interrupción 1 activado para la plantilla «* http://www.w3.org/1999/XSL/Transform:testMode» en la línea 113 del archivo test1.xsl. |
| En total hay 3 puntos de interrupción. |
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Muestra la expresión que se está observando en este momento.
Nombre para acceso rápido: watches
Tabla 3.42. Uso de showwatch
| showwatch (Muestra las variables que se están observando en este momento y sus valores). |
| showwatch 1 (Activa la muestra automática de las expresiones que se están observando. Es lo que se usa de forma predefinida). |
| showwatch 0 (Desactiva la muestra automática de las expresiones que se están observando). |
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Pasa a mostrar el nodo actual de la hoja de estilos. O cambia la hoja de estilos que se está usando.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Avanza hasta la siguiente instrucción de la hoja de estilos.
Nombre para acceso rápido: s
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Retrocede hasta un «marco de llamada» más reciente.
Nombre para acceso rápido: down
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Avanza a un «marco de llamada» anterior.
Nombre para acceso rápido: up
No es un comando preciso. xsldbg se detendrá tan pronto como pueda.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Muestra una lista de las hojas de estilos que están cargadas.
Nombre para acceso rápido: style
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Muestra el valor con el que se mapea el archivo de sistema por medio del catálogo actual
Nombre para acceso rápido: sys
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Muestra la lista de las plantillas disponibles. Busca una plantilla.
Nombre para acceso rápido: t
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Traza una ejecución de la hoja de estilo, mostrando el archivo y las líneas de los pasos intermedios.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Abre un terminal. Define el nivel de la redirección de tty.
Tabla 3.51. Uso de tty
| tty <RUTA_DISPOSITIVO> (Donde <RUTA_DISPOSITIVO> es un terminal válido del sistema operativo. Sólo intenta abrir el terminal. | |||||
| tty <NIVEL_TTY> (Define el nivel de la redirección de tty, donde <NIVEL_TTY> es un nivel válido de entrada/salida que se va a usar).
|
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Valida el archivo de salida que genera la hoja de estilos (desactivado).
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Avanza a través del código, usando un rango de velocidades.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Muestra una traza de las llamadas de las plantillas (pila del marco) y muestra el directorio de trabajo.
Nombre para acceso rápido: w
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
xsldbg
Copyright del programa 2004 Keith Isdale (k_isdale tpg com au)
Juan Manuel García Molina(juanma AT superiodico.net)
Esta documentación está sujeta a los términos de la Licencia de Documentación Libre GNU.
Este programa está sujeto a los términos de la Licencia Pública General GNU.
Los autores de libxml y libxsl.
Johannes Sixt, por su ayuda para añadir soporte xsldbg en KDbg.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Tabla de contenidos
Puede ver el componente kxsldbg del módulo kdewebdev en el SVN de KDE.
xsldbg forma parte del proyecto KDE http://www.kde.org/.
xsldbg está incluido en el paquete kdewebdev en ftp://ftp.kde.org/pub/kde/, el servidor FTP del proyecto KDE.
Para usar correctamente xsldbg, necesita que KDE libxslt, libexslt y libxml estén instalados. Suelen estar disponibles en una instalación típica de KDE.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
xsldbg se suele compilar como parte del componente kxsldbg, en el módulo kdewebdev.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
xsldbg se configura usando argumentos que se pasan en la línea de órdenes y con el comando setoption.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team