O Manual do KXSLDbg
Copyright © 2002, 2003, 2004 Keith Isdale
É concedida permissão para copiar, distribuir e/ou modificar este documento sob os termos da Licença de Documentação Livre GNU, Versão 1.1 ou qualquer versão posterior publicada pela Fundação do Software Livre; com nenhuma Seção Não Modificável, com nenhum Texto de Capa, e com nenhum Texto de Contra-Capa. Uma cópia da licença está incluída na seção intitulada "Licença de Documentação Livre GNU".
O KXSLDbg oferece uma interface gráfica para o xsldbg, que suporta a depuração de código de XSLTs.
Índice
O KXSLDbg oferece o acesso à maioria dos comandos do xsldbg para
Definir e modificar os pontos de parada
Mostrar o valor de XPaths
Mostrar informações sobre os pontos de parada, modelos, variáveis, pilha de chamadas, folhas de estilo e entidades encontrados
Definir e modificar os pontos de parada e variáveis
Percorrer o código da XSL™ e o documento de XML™ através do XPath
Procurar os IDs PUBLIC (públicos) e SYSTEM (do sistema) no catálogo de XML™ atual
O KXSLDbg pode agora
Definir e modificar variáveis
Desenhar o texto na janela principal, usando as bibliotecas do Kate
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Você inicia a configuração clicando em -> no menu.
O Diálogo de Configuração.
Para ser capaz de executar uma folha de estilo ou 'stylesheet' você precisa indicar o:
código da XSL™
dados em XML™
Arquivo de resultado
Usando o botão poderá escolher o arquivo desejado. O Código de XSL™ e os Dados em XML™ podem referir-se a URIs que contenham um http://, um ftp:// ou um file://. O Arquivo de resultado deverá ser um arquivo local com permissões de escrita.
Para acompanhar os exemplos, selecione os seguintes arquivos na pasta de exemplo em <PREFIXO DO KDE>/share/apps/kxsldbg
código de XSL™: testdoc.xsl
dados em XML™: testdoc.xml
Arquivo de resultado: /tmp/resultado.txt
Você poderá selecionar zero ou mais opções no diálogo de Opções. Cada opção tem uma dica com uma sugestão do efeito que ela tem.
Você poderá adicionar zero ou mais parâmetros com a seção Parâmetros da LibXSLT do diálogo. Isto permite-lhe fornecer valores aos parâmetros da 'stylesheet'.
Por exemplo, você poderá adicionar um Nome de parâmetro igual a meu_parametro com um Valor de Parâmetro igual a 'Olá mundo!' e clicar no botão . Para atualizar o valor de um parâmetro existente, basta escolhe o valor que deseja alterar com os botões ou , inserir um Valor de parâmetro novo e clicar em .
Para as alterações que efetuou terem efeito clique no botão . Para ignorar as alterações, clique no botão .
Você poderá fechar o diálogo usando o botão do canto superior direito da janela. Se precisar alterar a configuração basta reabrir o diálogo de configuração tal como foi explicado anteriormente.
Uma janela de texto com o arquivo atual sendo depurado.
O estado de um determinado ponto de parada é indicado através do texto relevante com uma cor de fundo diferente. Você poderá escolher a cor desejada: veja no diálogo em ->, na página de Cores.
Você poderá definir, desativar ou remover um ponto de parada, usando as teclas, o menu ou os botões da barra de ferramentas.
Você poderá mover o cursor pelo texto, usando as seguintes teclas:
| Teclas de cursores: Esquerda, Direita, Cima ou Baixo. |
| Teclas de página: Page Up ou Page Down |
Grande parte do resultado do KXSLDbg é capturado e apresentado tanto na janela dos inspetores como no resultado do KXSLDbg. As exceções a esta regra são:
Uma mensagem de erro que vem do KXSLDbg e que é mostrada dentro de uma janela de mensagens.
O resultado da avaliação de uma expressão que é também mostrado numa janela de mensagens.
O resultado da procura é enviado para o arquivo indicado na janela de resultado do KXSLDbg.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
A forma principal de lidar com os pontos de parada é através da janela principal. Veja “Usando a Janela Principal”
Logo que tenha iniciado a 'stylesheet', você poderá usar o item do menu ->. clique então na página Pontos de Parada. Veja abaixo um exemplo.
Você poderá adicionar um ponto de parada se fornecer um dos seguintes itens:
um arquivo e um número de linha
o nome de um modelo
o nome de um modelo e o nome de um modo
o nome de um modo
E pressionar em seguida no botão .
O nome de um arquivo poderá ser a localização completa de um arquivo local, ou apenas uma localização parcial (por exemplo docum_xsl.xsl).
O nome de um modelo ou de um modo é um Nome Qualificado completo onde a parte não-local é opcional, por exemplo xsl:meumodelo corresponde a meumodelo
Primeiramente clique no ponto de parada que deseja remover na lista de pontos de parada atuais. Clique depois no botão .
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Se a janela de inspeção não estiver visível use a opção ->.
As variáveis locais e globais são mostradas numa página do diálogo de inspeção. O exemplo a seguir mostra um segmento de código de XSLT que declara uma variável global e uma local
<xsl:variable name="variavelglobal" select="'xpto'"/>
<xsl:template match="/"/>
<xsl:param name="variavellocal" select="'xpto2'"/>
</xsl:template match="/"/>
Clicando com o mouse numa variável da lista, irá mostrar uma informação de resumo no fundo da janela. Se uma variável tiver uma expressão de seleção, por exemplo
<xsl:variable name="alteravel" select="'valorAntigo'" />
então poderá ser escolhido um novo XPath com um novo valor para a Expressão da variável, clicando depois no botão .
A Página de Variáveis
Clicando num item de uma variável na lista mostrada fará com que o cursor da janela principal passe para o arquivo e número de linha indicados.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Todos os itens da pilha de chamadas são listados aqui. Quanto mais antigo for o item da pilha menor número de ordem terá. Veja abaixo um exemplo.
Clicando num item da pilha de chamadas na lista apresentada, fará com que o cursor da janela principal salte para o arquivo e para o número de linha indicado.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Se a janela de inspeção não estiver visível use a opção ->. Para trablhar com modelos, clique na página de modelos no diálogo mostrado.
Todos os modelos encontrados são aqui listados. Repare que as regras de exportação do XSLT se aplicam. Assim poderá existir mais de um modelo com a mesma correspondência e modo.
Clicando num item de um modelo na lista mostrada fará com que o cursor da janela principal salte para o arquivo e número de linha indicados.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Se a janela de inspeção não estiver visível use a opção ->. Para trabalhar com o código, clique na página de código do diálogo mostrado.
Todos os arquivos de código XSLT que são incluídos no arquivo XSLT ou nos arquivos do mesmo nível são listados aqui.
Clicando num item de código na lista mostrada fará com que o cursor da janela principal passe para o início do arquivo indicado.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Se o diálogo de inspeção não é mostrado use a opção do menu ->. Para trabalhar com as entidades clique na página Entidades do diálogo que é mostrado.
Todas as entidades externas de XML™ incluídas com o arquivo DATA ou com alguns dos arquivos de mesmo nível são mostradas aqui. Para este exemplo foi executado o KXSLDbg no test13.xsl com o test13.xml (encontrado na pasta <PREFIXO DO KDE>/share/apps/kxsldbg da distribuição de código do xsldbg) de modo a que possa ver algumas entidades.
Clicando no item de uma entidade na lista irá mudar o cursor na janela principal para o início do arquivo indicado.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Várias ferramentas estão disponíveis através do menu de ferramentas; a ferramenta principal é a de inspeção.
A ferramenta de inspeção é a que contém todos os diálogos individuais para trabalhar com:
Pontos de Parada
Modelos
Variáveis
Itens da pilha de chamadas
Arquivos de código XSL™
Entidades de XML™
Clicando no menu é mostrado um diálogo que permite escolher a velocidade do passo de execução.
Para parar de avançar use a tecla W ou selecione o item do menu .
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
KXSLDbg © 2004 Keith Isdale
Documentation © 2004 Keith Isdale
Agradecimentos a:
Os criadores da libxml e da libxslt.
Robert Jacolin pelo 'feedback' a uma versão anterior do KXSLDbg.
Igor Zlatkovic por criar os binários em WIN32 da libxml/xslt e do xsldbg.
Esta documentação é licenciada sob os termos da Licença de Documentação Livre GNU.
Este programa é licenciado sob os termos da Licença Pública Geral GNU.
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