Keith Isdale Tradução: Marcus Gama
2
Conteúdo 1 Introdução 5 1.1 Recursos........................................... 5 2 Usando o KXSLDbg 6 2.1 Configurando uma Sessão do KXSLDbg......................... 6 2.1.1 Começando..................................... 6 2.1.2 Trabalhando com as Opções............................ 7 2.1.3 Trabalhando com os Parâmetros......................... 7 2.1.4 Aplicar alterações.................................. 7 2.2 Usando a Janela Principal................................. 8 2.2.1 Trabalhando na Janela Principal......................... 8 2.2.2 Trabalhando com o Resultado do KXSLDbg.................. 8 2.3 Definir e modificar os pontos de parada......................... 9 2.3.1 Adicionando um Ponto de Parada........................ 9 2.3.2 Detalhes do Argumento.............................. 9 2.3.3 Removendo um Ponto de Parada......................... 9 2.3.4 Remover todos os pontos de parada....................... 10 2.3.5 Ativando ou Desativando um Ponto de Parada................. 10 2.4 Trabalhando Com Variáveis................................ 10 2.5 Trabalhando com a Pilha de Chamadas......................... 11 2.6 Trabalhando com Modelos................................. 11 2.7 Trabalhando com Arquivos de Código de XSLT (Código)............... 12 2.8 Trabalhando com os Arquivos de Dados em XML (Entidades)............ 13 2.9 Diversos........................................... 13 2.9.1 Ferramenta de Inspeção.............................. 13 2.9.2 Executar Passo-a-Passo.............................. 14 2.9.3 Procurando as Entidades de XML........................ 14 3 Créditos e licença 15
Resumo O KXSLDbg oferece uma interface gráfica para o xsldbg, que suporta a depuração de código de XSLTs.
Capítulo 1 Introdução 1.1 Recursos 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 Definir e modificar variáveis Desenhar o texto na janela principal, usando as bibliotecas do Kate 5
Capítulo 2 Usando o KXSLDbg 2.1 Configurando uma Sessão do KXSLDbg Você inicia a configuração clicando em Depurar Configurar no menu. O Diálogo de Configuração. 2.1.1 Começando 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 6
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 2.1.2 Trabalhando com as Opções Você pode selecionar nenhuma ou mais opções a partir da seção Opções. Cada opção possui uma dica com uma sugestão do efeito que ela tem. 2.1.3 Trabalhando com os Parâmetros 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ê pode clicar no botão Adicionar e inserir um parâmetro Nome de meuparam com um parâmetro Valor de Olá Mundo!. Para atualizar o nome ou valor de um parâmetro existente, selecione-o com o botão esquerdo do mouse. 2.1.4 Aplicar alterações Para que as mudanças realizadas tenham efeito pressione o botão OK e feche a janela. Para ignorar qualquer mudança, pressione o botão Cancelar. Se precisar de alterar a configuração basta reabrir a janela de configuração como explicado anteriormente. 7
2.2 Usando a Janela Principal Uma janela de texto com o arquivo atual sendo depurado. 2.2.1 Trabalhando na Janela Principal 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 Configurações Configurar o Editor, na página de Cores. Você poderá definir, desativar ou remover um ponto de parada, usando as teclas, o menu Depurar 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 2.2.2 Trabalhando com o Resultado do KXSLDbg 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. 8
2.3 Definir e modificar os pontos de parada A forma principal de lidar com os pontos de parada é através da janela principal. Veja Seção 2.2 Uma vez que tenha iniciado a folha de estilo, você pode usar o menu Depurar Inspecionar... Então clique na aba de Pontos de parada. Veja um exemplo abaixo. 2.3.1 Adicionando um Ponto de Parada Você poderá adicionar um ponto de parada se fornecer um dos seguintes itens: 1. um arquivo e um número de linha 2. o nome de um modelo 3. o nome de um modelo e o nome de um modo 4. o nome de um modo E pressionar em seguida no botão Adicionar. 2.3.2 Detalhes do Argumento 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 2.3.3 Removendo um Ponto de Parada Primeiramente clique no ponto de parada que deseja remover na lista de pontos de parada atuais. Clique depois no botão Remover. 9
2.3.4 Remover todos os pontos de parada Clique no botão Remover Tudo. 2.3.5 Ativando ou Desativando um Ponto de Parada Primeiramente clique com o botão esquerdo do mouse no ponto de parada que deseja ativar na lista de pontos de parada atuais. Depois clique no botão Ativar. 2.4 Trabalhando Com Variáveis Se a janela de inspeção não estiver visível use o menu Depurar Inspecionar... 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 digitando um novo valor para a Expressão da variável, clicando depois no botão Definir a expressã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. 10
2.5 Trabalhando com a Pilha de Chamadas 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. 2.6 Trabalhando com Modelos Se a janela de inspeção não estiver visível use o menu Depurar Inspecionar. Para trabalhar 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. 11
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. 2.7 Trabalhando com Arquivos de Código de XSLT (Código) Se a janela de inspeção não estiver visível use o menu Depurar Inspecionar... 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. 12
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. 2.8 Trabalhando com os Arquivos de Dados em XML (Entidades) Se a janela de inspeção não estiver visível use o menu Depurar Inspecionar... Para trabalhar com entidades, clique na aba Entidades da janela exibida. 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 testdoc. xsl com o testdoc.xml (encontrado na pasta <PREFIXO DO KDE>/share/apps/kxsldbg) 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. 2.9 Diversos Várias ferramentas estão disponíveis através do menu Depurar. A ferramenta principal é a de inspeção. 2.9.1 Ferramenta de Inspeção A ferramenta de inspeção contém todos os diálogos individuais para trabalhar com: Pontos de parada Modelos 13
Variáveis Itens da pilha de chamadas Arquivos de código XSL Entradas XML 2.9.2 Executar Passo-a-Passo Ao clicar no Navegar pela folha de estilo... no menu Depurar uma janela é exibida permitindo que a velocidade de navegação seja selecionada. Para interromper a navegação use a tecla K ou selecione o menu Para a navegação pela folha de estilo. 2.9.3 Procurando as Entidades de XML Para procurar uma ID de Sistema no catálogo XML atual, use o menu Procurar por ID de Sistema... e insira o valor a ser pesquisado na janela exibida. Para procurar por uma ID PÚBLICA use o menu Procurar ID PÚBLICA... e insira o valor a pesquisar na janela exibida. 14
Capítulo 3 Créditos e licença KXSLDbg (c) 2004 Keith Isdale Documentation (c) 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. Tradução de Marcus Gama marcus.gama@gmail.com 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. 15