\r\n\r\n## Formas de uso\r\n\r\n### Versão 0.6.0 ou superiores — fluxo Lexador → Avaliador Sintático → Tradutor\r\n\r\nA partir da versão 0.6.0 é possível usar cada etapa da pipeline de transformação diretamente, o que permite inspecionar tokens e a árvore sintática (AST) antes de gerar o HTML.\r\n\r\n```js\r\nimport { LexadorLmht, AvaliadorSintaticoLmht, TradutorHtml } from \"@designliquido/lmht-js\";\r\n\r\nconst lexador = new LexadorLmht();\r\nconst avaliadorSintatico = new AvaliadorSintaticoLmht();\r\nconst tradutor = new TradutorHtml();\r\n\r\nconst codigo = `TesteOlá, mundo!`;\r\n\r\n// 1. Lexar: transforma o texto em tokens\r\nconst retornoLexador = lexador.mapear(codigo);\r\n\r\n// 2. Analisar: transforma os tokens em uma árvore sintática\r\nconst retornoAvaliador = avaliadorSintatico.analisar(retornoLexador.tokens);\r\n\r\n// 3. Traduzir: transforma a árvore sintática em HTML\r\nconst html = tradutor.traduzir(retornoAvaliador.arvore);\r\nconsole.log(html);\r\n// Resultado:\r\n// \r\n// \r\n// \r\n// Teste\r\n// \r\n// Olá, mundo!\r\n// \r\n```\r\n\r\nO `TradutorHtml` aceita opções de formatação e também permite verificar erros de cada etapa:\r\n\r\n```js\r\nimport { LexadorLmht, AvaliadorSintaticoLmht, TradutorHtml } from \"@designliquido/lmht-js\";\r\n\r\nconst tradutor = new TradutorHtml({\r\n identacao: 4, // Número de espaços por nível de identação (padrão: 2)\r\n usarTabulacao: false, // Usar tabulação em vez de espaços (padrão: false)\r\n formatarSaida: true, // Formatar a saída com quebras de linha (padrão: true)\r\n preservarComentarios: true, // Preservar comentários na saída HTML (padrão: false)\r\n incluirDeclaracaoXml: false, // Incluir declaração (padrão: false)\r\n incluirDocType: true, // Incluir (padrão: true)\r\n});\r\n\r\nconst lexador = new LexadorLmht();\r\nconst avaliadorSintatico = new AvaliadorSintaticoLmht();\r\n\r\nconst codigo = `TesteOlá, mundo!`;\r\n\r\nconst { tokens, erros: errosLexador } = lexador.mapear(codigo);\r\nconst { arvore, erros: errosAvaliador } = avaliadorSintatico.analisar(tokens);\r\n\r\nif (errosLexador.length > 0 || errosAvaliador.length > 0) {\r\n console.error(\"Erros:\", [...errosLexador, ...errosAvaliador]);\r\n} else {\r\n console.log(tradutor.traduzir(arvore));\r\n}\r\n```\r\n\r\n### Versão 0.5.0 ou superiores\r\n\r\nAté esta versão, apenas os métodos de conversão usando transformação XSLT estavam disponíveis. Entre as opções de conversão, há `converterPorArquivo` e `converterPorTexto`, ambos para LMHT e HTML. Os métodos de conversão são assíncronos, e retornam uma `Promise` que resolve para o resultado da conversão.\r\n\r\n#### Exemplos de LMHT para HTML\r\n\r\n```js\r\nimport { ConversorLmht } from \"@designliquido/lmht-js\";\r\n\r\nconst conversorLmht = new ConversorLmht();\r\n// Ou\r\nconst resultado = await conversorLmht.converterPorArquivo(\"meu-arquivo.lmht\");\r\nconsole.log(resultado);\r\n\r\n// Ou\r\nconversorLmht.converterPorArquivo(\"meu-arquivo.lmht\").then(resultado => {\r\n console.log(resultado);\r\n});\r\n```\r\n\r\n```js\r\nimport { ConversorLmht } from \"@designliquido/lmht-js\";\r\n\r\nconst conversorLmht = new ConversorLmht();\r\n// Ou\r\nconst resultado = await conversorLmht.converterPorTexto(\"TesteTeste\");\r\nconsole.log(resultado); // Resultado: TesteTeste\r\n\r\n// Ou\r\nconversorLmht.converterPorTexto(\"TesteTeste\").then(resultado => {\r\n console.log(resultado); // Resultado: TesteTeste\r\n});\r\n```\r\n\r\n#### Exemplos de HTML para LMHT\r\n\r\n```js\r\nimport { ConversorHtml } from \"@designliquido/lmht-js\";\r\n\r\nconst conversorHtml = new ConversorHtml();\r\n// Ou\r\nconst resultado = await conversorHtml.converterPorArquivo(\"meu-arquivo.html\");\r\nconsole.log(resultado);\r\n\r\n// Ou\r\nconversorHtml.converterPorArquivo(\"meu-arquivo.html\").then(resultado => {\r\n console.log(resultado);\r\n});\r\n```\r\n\r\n```js\r\nimport { ConversorHtml } from \"@designliquido/lmht-js\";\r\n\r\nconst conversorHtml = new ConversorHtml();\r\n// Ou\r\nconst resultado = await conversorHtml.converterPorTexto(\"TesteTeste\");\r\nconsole.log(resultado); // Resultado: TesteTeste\r\n\r\n// Ou\r\nconversorHtml.converterPorTexto(\"TesteTeste\").then(resultado => {\r\n console.log(resultado); // Resultado: TesteTeste\r\n});\r\n```\r\n\r\n### Versão 0.3.0 até versão 0.4.9\r\n\r\nOs métodos de conversão são os mesmos, mas são síncronos:\r\n\r\n```js\r\nimport { ConversorLmht } from \"@designliquido/lmht-js\";\r\n\r\nconst conversorLmht = new ConversorLmht();\r\nconst resultado = conversorLmht.converterPorArquivo(\"meu-arquivo.lmht\");\r\nconsole.log(resultado);\r\n```\r\n\r\n```js\r\nimport { ConversorLmht } from \"@designliquido/lmht-js\";\r\n\r\nconst conversorLmht = new ConversorLmht();\r\nconst resultado = conversorLmht.converterPorTexto(\"TesteTeste\");\r\nconsole.log(resultado); // Resultado: TesteTeste\r\n```\r\n\r\n```js\r\nimport { ConversorHtml } from \"@designliquido/lmht-js\";\r\n\r\nconst conversorHtml = new ConversorHtml();\r\nconst resultado = conversorHtml.converterPorArquivo(\"meu-arquivo.html\");\r\nconsole.log(resultado);\r\n```\r\n\r\n```js\r\nimport { ConversorHtml } from \"@designliquido/lmht-js\";\r\n\r\nconst conversorHtml = new ConversorHtml();\r\nconst resultado = conversorHtml.converterPorTexto(\"TesteTeste\");\r\nconsole.log(resultado); // Resultado: TesteTeste\r\n```\r\n\r\n### Até a versão 0.2.0\r\n\r\nOs métodos de conversão são assíncronos.\r\n\r\n```js\r\nimport { ConversorLmht } from \"@designliquido/lmht-js\";\r\n\r\nconst conversorLmht = new ConversorLmht();\r\nconversorLmht.converterPorArquivo(\"meu-arquivo.lmht\").then(resultado => {\r\n console.log(resultado);\r\n});\r\n```\r\n\r\n```js\r\nimport { ConversorHtml } from \"@designliquido/lmht-js\";\r\n\r\nconst conversorHtml = new ConversorHtml();\r\nconversorHtml.converterPorArquivo(\"meu-arquivo.lmht\").then(resultado => {\r\n console.log(resultado);\r\n});\r\n```\r\n\r\n## Conformidade com especificação \r\n\r\n`lmht-js` segue a especificação mais recente de [LMHT](https://github.com/DesignLiquido/LMHT). O projeto da especificação é referenciado aqui como um [submódulo git](https://git-scm.com/docs/git-submodule/pt_BR). Para sincronizar a especificação, use o comando:\r\n\r\n```sh\r\ngit submodule update --init --recursive --remote\r\n```\r\n\r\n## Versões 0.3.0 até 0.4.9, usando `xslt-processor`, e mudanças na versão 0.5.0\r\n\r\nNa versão 0.3.0, tomamos a decisão de mudar para a biblioteca [`xslt-processor`](https://github.com/DesignLiquido/xslt-processor), 100% em código aberto, licença MIT, e mantida pela Design Líquido. Não apenas os _bugs_ que tínhamos com a biblioteca anterior, `saxon-js`, são totalmente evitados como também a implementação de `xslt-processor` privilegia o projeto de LMHT.\r\n\r\nIsso fez com que os métodos se tornassem síncronos. Depois da versão 3.0.0 de `xslt-processor`, em que o comando `` foi implementado, o processamento de transformações XSLT passou a ser novamente assíncrono. O comando `` exige um acesso a um sistema de arquivos ou um recurso na internet, o que pede para que todo o processo seja assíncrono. Para esta biblioteca, os comandos de conversão voltam a ser assíncronos na versão 0.5.0.\r\n\r\n## Versão 0.2.0 e `saxon-js`\r\n\r\nAté a versão 0.2.0, usávamos a biblioteca [`saxon-js`](https://www.npmjs.com/package/saxon-js). Essa biblioteca tornou-se um problema por alguns motivos:\r\n\r\n- Documentação incompleta, em inglês e de baixa qualidade: https://www.saxonica.com/saxon-js/documentation2/index.html;\r\n- [Apesar de ter uma licença gratuita](https://www.saxonica.com/saxon-js/documentation2/index.html#!conditions/public-license), os fontes não são abertos;\r\n- Escrita em JavaScript puro e tipagem fraca, além de ter uma parte compilada em C;\r\n- Não funciona se usada em uma extensão do Visual Studio Code, que em teoria é Node.js, mas algo acontece ao importarmos a dependência e um erro estranho aparece.\r\n\r\nMantemos o suporte a versões anteriores por questões de retrocompatibilidade. \r\n\r\n### Especificação e arquivos `.sef.json`\r\n\r\n`saxon-js` pede por arquivos `.sef.json`, que podem ser gerados pelos comandos abaixo:\r\n\r\nPowerShell:\r\n```powershell\r\nxslt3 -t \"-xsl:especificacao/lmht.xslt\" \"-export:lmht.sef.json\" -nogo -relocate\r\nxslt3 -t \"-xsl:especificacao/lmht-reverso-xml10.xslt\" \"-export:lmht-reverso-xml10.sef.json\" -nogo -relocate\r\n```\r\n\r\nbash, zsh:\r\n```sh\r\nxslt3 -t -xsl:especificacao/lmht.xslt -export:lmht.sef.json -nogo -relocate\r\nxslt3 -t -xsl:especificacao/lmht-reverso.xslt -export:lmht-reverso.sef.json -nogo -relocate\r\n```\r\n\r\nO arquivo XSLT da especificação ou da especificação reversa também podem ser usados, mas isso causa um atraso na carga de pelo menos 2 segundos por arquivo, que é o tempo que leva para compilar a especificação de XSLT para `.sef.json`. Para entender como isso funciona, verifique o fonte [`objeto-especificacao.ts`](https://github.com/DesignLiquido/lmht-js/blob/4260f8006a289d38f5447deac35d92e3a7d9af98/objeto-especificacao.ts). \r\n\r\nAssim sendo, os arquivos `.sef.json` correspondentes ao _commit_ apontado pelo submódulo são versionados neste diretório raiz, e distribuídos juntamente com o pacote NPM.\r\n\r\n### Compatibilidade com XML\r\n\r\nSaxonJS não trabalha com XML 1.1, e por isso a especificação com XML 1.0 é usada aqui.\r\n","readmeFilename":"README.md"}
![](\"https://img.shields.io/github/issues/Designliquido/lmht-js\")
\r\n \r\n ![](\"https://img.shields.io/github/stars/Designliquido/lmht-js\")
\r\n ![](\"https://img.shields.io/github/forks/Designliquido/lmht-js\")
\r\n \r\n ![](\"https://img.shields.io/npm/v/@designliquido/lmht-js\")
\r\n \r\n ![](\"https://img.shields.io/npm/dw/@designliquido/lmht-js\")
\r\n ![](\"https://img.shields.io/github/license/DesignLiquido/lmht-js\")
\r\n![](\"./recursos/imagens/badge-statements.svg\"){kind=icon}
\r\n ![](\"./recursos/imagens/badge-lines.svg\"){kind=icon}
\r\n ![](\"./recursos/imagens/badge-functions.svg\"){kind=icon}
\r\n ![](\"./recursos/imagens/badge-branches.svg\"){kind=icon}
\r\n