html2wml - Online na nuvem

PROGRAMA:

NOME

Html2Wml - Programa que pode converter páginas HTML em páginas WML

SINOPSE

Html2Wml pode ser usado como um comando shell:

$ html2wml arquivo.html

ou como um CGI:

/cgi-bin/html2wml.cgi?url=/index.html

Em ambos os casos, o arquivo pode ser um arquivo local ou um URL.

DESCRIÇÃO

Html2Wml converte páginas HTML em decks WML, adequados para serem visualizados em um dispositivo Wap. o
programa pode ser iniciado a partir de um shell para converter estaticamente um conjunto de páginas, ou como um CGI para
converter um recurso HTML específico (potencialmente dinâmico).

Embora o resultado não seja garantido como WML válido, deve ser o caso para a maioria
Páginas. Boas páginas HTML provavelmente produzirão decks WML válidos. Para verificar e corrigir
suas páginas, você pode usar os softwares W3C: o HTML Validador, disponível online em
http://validator.w3.org e HTML Arrumado, escrito por Dave Raggett.

Html2Wml fornece os seguintes recursos:

· Tradução dos links

· Limitação do tamanho dos cartões, dividindo o resultado em vários cartões

· Inclusão de arquivos (semelhante ao SSI)

· Compilação do resultado (usando as ferramentas WML, consulte a seção sobre "LINKS")

· Um modo de depuração para verificar o resultado usando funções de validação

OPÇÕES

Observe que a maioria dessas opções também está disponível ao chamar Html2Wml como CGI.
Neste caso, as opções booleanas recebem o valor "1" ou "0", e outras opções simplesmente
recebam o valor que esperam. Por exemplo, `--ascii 'torna-se`? Ascii = 1' ou `? A = 1 '. Ver
o arquivo t / form.html para obter um exemplo de como chamar Html2Wml como CGI.

Conversão Opções

-a, --ascii
Quando esta opção está ativada, entidades HTML nomeadas e caracteres não ASCII são convertidos em
Caracteres US-ASCII usando as mesmas aproximações de 7 bits do Lynx. Por exemplo, `© '
é traduzido como "(c)", e `ß 'é traduzido como" ss ". Esta opção está desativada por
padrão.

- [não] colapso
Esta opção diz ao Html2Wml para recolher espaços em branco redundantes, tabulações, carruagem
retornos, alimentações de linhas e parágrafos vazios. O objetivo é reduzir o tamanho do WML
documentar tanto quanto possível. Recolher parágrafos vazios é necessário para dois
razões. Primeiro, isso evita telas vazias (e em um dispositivo com apenas 4 linhas de
exibição, uma tela vazia pode ser bastante enjoativa). Em segundo lugar, o Html2wml cria muitos
parágrafos durante a conversão, devido à forma como o reconstrutor de sintaxe é programado.
Excluir esses parágrafos vazios é necessário como limpar a cozinha :-)

Se isso realmente te incomoda, você pode desativar esse comportamento com o --nocollapse
opção.

--ignore-imagens
Esta opção diz ao Html2Wml para ignorar completamente todos os links de imagem.

- [não] img-alt-text
Esta opção diz ao Html2Wml para substituir as tags de imagem por seus correspondentes
texto alternativo (como em um navegador da Web em modo texto). Essa opção está ativada por padrão.

- [não] linearizar
Essa opção está ativada por padrão. Isso faz com que o Html2Wml nivele as tabelas HTML (elas são
linearizado), como faz o Lynx. Eu acho que isso é melhor do que tentar usar o WML nativo
tabelas. Primeiro, eles têm recursos e possibilidades extremamente limitados em comparação com HTML
tabelas. Em particular, eles não podem ser aninhados. Na verdade, isso é normal porque Wap
dispositivos não devem ter uma grande CPU rodando em alguns zilhões de hertz, e o
cálculos necessários para renderizar as tabelas são os mais complicados e consomem muito da CPU
de HTML.

Em segundo lugar, como eles não podem ser aninhados e, como as páginas HTML típicas usam intensamente
tabelas para criar seu layout, é impossível decidir qual delas pode ser mantida. Então
o melhor é não ficar com nenhum deles.

[Nota] Embora você possa desativar esse comportamento, e embora haja
suporte para tabelas, o modo não linear não foi fortemente testado com
tabelas, e pode produzir resultados inesperados.

-n, --numeric-não-ascii
Esta opção diz ao Html2wml para converter todos os caracteres não ASCII em entidades numéricas,
ou seja, "e" torna-se `é 'e" ss "torna-se` ß'. Por padrão, esta opção é
fora.

-p, --nopre
Esta opção diz ao Html2Wml para não usar o marcação. Esta opção foi adicionada porque
o compilador do WML Tools 0.0.4 não oferece suporte a essa tag.

Ligações Úteis Reconstrução Opções

--hreftmpl =MODELO
Esta opção define o modelo que será usado para reconstruir os links do tipo `href '.
Consulte a seção "RECONSTRUÇÃO DE LINKS" para obter mais informações.

--srctmpl =MODELO
Esta opção define o modelo que será usado para reconstruir os links do tipo `src '.
Consulte a seção "RECONSTRUÇÃO DE LINKS" para obter mais informações.

Dividir Opções

-s, --max-card-size =TAMANHO
Esta opção permite limitar o tamanho (em bytes) dos cartões gerados. O padrão é
1,500 bytes, o que deve ser pequeno o suficiente para ser carregado na maioria dos dispositivos Wap. Veja o
seção "DECK SLICING" para obter mais informações.

-t, --card-split-threshold =TAMANHO
Esta opção define o limite do evento de divisão, que pode ocorrer quando o tamanho de
o cartão atual está entre `tamanho máximo do cartão '-` limite de divisão do cartão' e
`tamanho máximo do cartão '. O valor padrão é 50. Consulte a seção "CORTE DE DECK" para mais
informações.

--next-card-label =STRING
Esta opção define o rótulo do link que aponta para o próximo cartão. O padrão é
"[>>]", que será processado como "[>>]".

--prev-card-label =STRING
Esta opção define o rótulo do link que aponta para o cartão anterior. O padrão é
"[<<]", que será processado como "[<<]".

HTTP Autenticação

-U, --http-user =NOME DE USUÁRIO
Use esta opção para definir o nome de usuário para uma solicitação autenticada.

-P, --http-passwd =SENHA
Use esta opção para definir a senha para uma solicitação autenticada.

procuração Suporte

- [não] S, - [não] proxy
Use esta opção para ativar o suporte de proxy. Por padrão, o suporte a proxy está ativado. Ver
a seção "SUPORTE PROXY".

saída Opções

-k, --compilar
Definir esta opção diz ao Html2Wml para usar o compilador das ferramentas WML para compilar o
Deck WML. Se você deseja criar um site Wap real, você deve usar esta opção seriamente
para reduzir o tamanho dos decks WML. Lembre-se de que os dispositivos Wap têm muito
pouca quantidade de memória. Se isso não for suficiente, use as opções de divisão.

Dê uma olhada em wml_compilation / para obter mais informações sobre como usar um compilador WML com
HTML2Wml.

-o, --saída
Use esta opção (no modo shell) para especificar um arquivo de saída. Por padrão, Html2Wml
imprime o resultado na saída padrão.

depuração Opções

-d, --debug [=NÍVEL]
Esta opção ativa o modo de depuração. Isso imprime o resultado de saída com linha
numeração e com o resultado da verificação XML. Se o compilador WML foi chamado, o
o resultado também é impresso em formas hexadecimais e ascii. Quando chamados como CGI, todos os
isso é impresso como HTML, para que possa usar qualquer navegador da web para esse fim.

--xmlcheck
Quando esta opção está ativada, ele envia a saída WML para XML :: Parser para verificar se está bem
formação.

DECK FATIAMENTO

A convés slicing é um recurso que o Html2Wml fornece para combinar com a baixa memória
recursos da maioria dos dispositivos Wap. Muitos não conseguem lidar com cartões com mais de 2,000 bytes,
portanto, os cartões devem ser suficientemente pequenos para serem vistos por todos os dispositivos Wap. Alcançar
isso, você deve compilar seu deck WML, o que reduz o tamanho do deck em 50%, mas mesmo
então seus cartões podem ser muito grandes. É aqui que o Html2Wml vem com o fatiamento do deck
recurso. Isso permite que você limite o tamanho dos cartões, atualmente apenas antes que o
fase de compilação.

Fatia by cartões or by baralhos

Em alguns telefones Wap, dividir o baralho não é suficiente: o navegador WML ainda tenta
baixe todo o baralho em vez de apenas escolher uma carta de cada vez. Uma solução é fatiar
o documento WML por decks. Veja a figura abaixo.

_____________ _____________
⎪ deck ⎪ ⎪ deck # 1 ⎪
⎪ _________ ⎪ ⎪ _________ ⎪
⎪ ⎪ cartão # 1 ⎪ ⎪ ⎪ ⎪ cartão ⎪ ⎪
⎪ ⎪ _________ ⎪ ⎪ ⎪ ⎪ _________ ⎪ ⎪
⎪ _________ ⎪ ⎪ _____________ ⎪
⎪ ⎪ cartão # 2 ⎪ ⎪
⎪ ⎪ _________ ⎪ ⎪. . .
⎪ _________ ⎪
⎪ ⎪ ... ⎪ ⎪ _____________
⎪ ⎪ _________ ⎪ ⎪ ⎪ deck #n ⎪
⎪ _________ ⎪ ⎪ _________ ⎪
⎪ ⎪ cartão #n ⎪ ⎪ ⎪ ⎪ cartão ⎪ ⎪
⎪ ⎪ _________ ⎪ ⎪ ⎪ ⎪ _________ ⎪ ⎪
⎪ _____________ ⎪ ⎪ _____________ ⎪

Documento WML Documento WML
fatiado por cartas fatiado por baralhos

O que isso significa é que o Html2Wml gera vários documentos WML. No modo CGI, apenas o
o deck apropriado é enviado, selecionado pelo id fornecido no parâmetro. Se nenhum id foi fornecido, o
o primeiro baralho é enviado.

Note on tamanho Cálculo

Atualmente, o Html2Wml estima o tamanho do cartão em tempo real, somando o comprimento de
as strings que compõem a saída WML, textos e tags. Eu digo "estimativas" e não
"calcula" porque calcular o tamanho exato exigiria muito mais cálculos do que
do jeito que é feito agora. Pode-se objetar que há apenas acréscimos, o que é correto,
mas conhecendo o exato o tamanho não é necessário. Na verdade, se você compilar o WML, a maioria dos
strings das tags serão removidas, mas não todas.

Por exemplo, pegue uma tag de imagem: ` '. Quando
compilado, a string `" img "'será substituída por um valor de um byte. A mesma coisa para o
strings `" src "'e` "alt"', e os espaços, aspas duplas e sinais de igual serão
despojado. Apenas o texto entre aspas duplas será preservado ... mas não em todos os casos.
Na verdade, para dar um passo adiante, o compilador também pode codificar partes dos argumentos
como binário. Por exemplo, a string `"http://www. "'pode ser codificado como um único byte (` 8F'
nesse caso). Ou, se o atributo for `href ', a string` href = "http: //' pode se tornar o
byte `4B '.

Como você pode ver, não importa saber exatamente o tamanho da forma textual do WML, pois
ele sempre será muito superior ao tamanho da forma compilada. É por isso que eu não conto
todos os caracteres que podem ser realmente escritos.

Além disso, é porque sou muito preguiçoso ;-)

Sua marca compilando que o WML área coberta?

Se você pretende criar páginas WML reais, deve sempre considerar compilá-las.
Se você não está convencido, aqui está uma ilustração.

Pegue o seguinte fragmento de código WML:

<a href='http://www.yahoo.com/'> Yahoo!

É a maneira básica e clássica de codificar um hiperlink. Leva 42 bytes para codificar isso,
porque é apresentado em uma forma legível por humanos.

O WAP Forum definiu uma representação binária compacta de WML em sua especificação,
que é chamado de "WML compilado". É um formato binário, portanto você, um mero humano, não pode
leia isso, mas seu computador pode. E é muito mais rápido para ele ler um formato binário do que
para ler um formato textual.

O exemplo anterior seria, uma vez compilado (e impresso aqui como hexadecimal):

1C 4A 8F 03 yahoo 00 85 01 03 Y ahoo! 00 01

Isso leva apenas 21 bytes. Metade do tamanho da forma legível por humanos. Para um dispositivo Wap,
isso significa menos download e coisas mais fáceis de ler. Portanto, o processamento de
o documento pode ser obtido em um curto espaço de tempo em comparação com a versão intelectual do mesmo
documento.

Há um último argumento, e não menos importante: muitos dispositivos Wap só leem binários
WML.

AÇÕES

As ações são um recurso semelhante (mas com muito menos funcionalidades!) O SSI (lado do servidor
Inclui) disponível em bons servidores como o Apache. Para não interferir com o real
SSI, mas para manter a sintaxe fácil de aprender, ela difere em poucos pontos.

Sintaxe

Basicamente, a sintaxe para executar uma ação é:



Observe que os colchetes angulares fazem parte da sintaxe. Exceto por esse ponto, sintaxe de ações
é muito semelhante à sintaxe SSI.

Disponível ações

Apenas algumas ações estão disponíveis no momento, mas mais podem ser implementadas mediante solicitação.

incluir

Descrição
Inclui um arquivo no documento no ponto atual. Por favor, note que
O Html2Wml não verifica nem analisa o arquivo e, se o arquivo não puder ser encontrado,
morrerá silenciosamente (este é o mesmo comportamento do SSI).

parâmetros
`virtual = url '- O arquivo é obtido por http.

`file = path '- O arquivo é lido do disco local.

tamanho f

Descrição
Retorna o tamanho de um arquivo no ponto atual do documento.

parâmetros
`virtual = url '- O arquivo é obtido por http.

`file = path '- O arquivo é lido do disco local.

Observações Se você usar o parâmetro de arquivo, um caminho absoluto é recomendado.

pular

Descrição
Pula tudo até a primeira ação `end_skip '.

Generic parâmetros

Os parâmetros a seguir podem ser usados ​​para qualquer ação.

para =saída formato
Este parâmetro restringe a ação para o formato de saída fornecido. Atualmente, o único
o formato disponível é "` wml '"(ao usar` html2chtml' o formato é "` chtml '").

Exemplos

Se você deseja compartilhar uma barra de navegação entre várias páginas WML, você pode `incluí-la 'neste
caminho:



Claro, você deve escrever esta barra de navegação primeiro :-)

Se você deseja usar suas páginas HTML atuais para criar suas páginas WML, mas que elas
contém tabelas complexas, ou tabelas de navegação desnecessárias, etc, você pode simplesmente `pular 'o
partes complexas e mantenha o resto.



partes desnecessárias para as páginas WML

partes úteis para as páginas WML

LINKS RECONSTRUÇÃO

O mecanismo de reconstrução de links é IMHO a parte mais importante do Html2Wml, porque é
este mecanismo que permite reconstruir os links do documento HTML que está sendo convertido.
Ele tem dois modos, dependendo se o Html2Wml foi iniciado a partir do shell ou como um CGI.

Quando usado como um CGI, este motor irá reconstruir os links do documento HTML para que
todos os urls serão passados ​​para Html2Wml a fim de converter os arquivos apontados (páginas ou
imagens). Isso é totalmente automático e não pode ser personalizado por enquanto (mas eu não acho
seria muito útil).

Quando usado a partir do shell, esse mecanismo reconstrói os links com os modelos fornecidos.
Observe que os URLs absolutos não serão alterados. Os modelos podem ser personalizados usando o
seguinte sintaxe.

Modelos

Modelo HREF
Este modelo controla a reconstrução do atributo `href 'da tag` A'. Seu
o valor pode ser alterado usando o --hreftmpl opção. O valor padrão é
`" {FILEPATH} {FILENAME} {$ FILETYPE = ~ s / s? Html? / Wml / o; $ FILETYPE} "'.

Modelo de fonte de imagem
Este modelo controla a reconstrução do atributo `src 'da tag` IMG'. Seu
o valor pode ser alterado usando o --srctmpl opção. O valor padrão é
`" {FILEPATH} {FILENAME} {$ FILETYPE = ~ s / gif⎪png⎪jpe? G / wbmp / ​​o; $ FILETYPE} "'

Sintaxe

O modelo é uma string que contém o novo URL. Mais precisamente, é um Text :: Template
modelo. Os parâmetros podem ser interpolados como uma constante ou como uma variável. O modelo é
abraçados entre colchetes e pode conter qualquer código Perl válido.

A forma mais simples de um template é `{PARAM} 'que retorna apenas o valor de PARAM. Se você
deseja fazer algo mais complexo, você pode usar a variável correspondente; por exemplo
`{" foo $ PARAM bar "} ', ou` {join "_", dividir "", PARAM}'.

Você pode ler a página de manual Text :: Template para obter mais informações sobre o que é possível dentro de um
template.

Se o URL original continha uma parte de consulta ou uma parte de fragmento, eles serão anexados
ao resultado do modelo.

Disponível parâmetros

URL Este parâmetro contém o URL original do atributo `href 'ou` src'.

NOME DO ARQUIVO
Este parâmetro contém o nome base do arquivo.

CAMINHO DE ARQUIVO
Este parâmetro contém o caminho principal do arquivo.

TIPO DE ARQUIVO
Este parâmetro contém o sufixo do arquivo.

Isso pode ser retomado desta forma:

url= http://www.server.net/path/to/my/page.html
------------ ^^^^ ----
⎪ ⎪ \
⎪ ⎪ \
FILETH FILENAME FILETYPE

Note que `FILETYPE 'contém todas as extensões do arquivo, então se seu nome for
index.html.fr por exemplo, `FILETYPE 'contém" `.html.fr'".

Exemplos

Para adicionar uma opção de caminho:

{URL} $ wap

Usando o Apache, você pode adicionar uma diretiva Rewrite para que a URL que termina com `$ wap 'seja
redirecionado para Html2Wml:

RewriteRule ^ (/.*) \ $ wap $ /cgi-bin/html2wml.cgi?url=$1

Para alterar a extensão de uma imagem:

{FILEPATH} {FILENAME} .wbmp

PROXY SUPPORT

Html2Wml usa suporte de proxy embutido LWP. É ativado por padrão e carrega o proxy
configurações das variáveis ​​de ambiente, usando as mesmas variáveis ​​que muitos outros programas.
Cada protocolo (http, ftp, etc) pode ser mapeado para usar um servidor proxy, definindo uma variável
da forma `PROTOCOL_proxy '. Exemplo: use `http_proxy 'para definir o proxy para http
access, `ftp_proxy 'para acesso ftp. No shell, isso é apenas uma questão de definir o
variável.

Para shell Bourne:

$ export http_proxy = "http://proxy.domain.com: 8080 / "

Para C-shell:

% setenv http_proxy "http://proxy.domain.com: 8080 / "

No Apache, você pode adicionar esta diretiva ao seu arquivo de configuração:

SetEnv http_proxy "http://proxy.domain.com: 8080 "

mas isso tem o padrão que outro CGI, ou outro programa, pode usar isso para acessar
recursos externos. A melhor maneira é editar Html2Wml e preencher a opção `proxy-server '
com o valor apropriado.

RESSALVAS

Html2Wml tenta fazer documentos WML corretos, mas a boa formação e a validade de
os documentos não são garantidos.

") may produce unexpected results. Marcas invertidas (como " negrito ") podem produzir resultados inesperados. Se apenas
softwares ruins fazem coisas ruins como essa.

LINKS

Baixar

Html2WmlName
Este é o site do projeto Html2Wml, hospedado por SourceForge.net. Todos
versões estáveis ​​podem ser baixadas deste site.

[ http://www.html2wml.org/ ]

Nutialândia
Este é o site do autor, onde você pode encontrar os arquivos de todos os
versões do Html2Wml.

[ http://www.maddingue.org/softwares/ ]

Recursos

O Fórum WAP
Este é o site oficial do Fórum WAP. Você pode encontrar algumas informações técnicas,
conforme as especificações de todas as tecnologias associadas ao WAP.

[ http://www.wapforum.org/ ]

WAP.com
Este site contém algumas informações e links úteis. Em particular, tem um bom
feito FAQ.

[ http://www.wap.com/ ]

O Consórcio World Wide Web
Embora não esteja diretamente relacionado ao material Wap, pode ser útil ler o
especificações do XML (WML é um aplicativo XML) e as especificações do
diferentes linguagens de folha de estilo (CSS e XSL), que incluem suporte para baixa resolução
dispositivos.

[ http://www.w3.org/ ]

TuxMobil
Este site é dedicado aos sistemas Mobile UniX. Isso leva você a muito útil
informações práticas sobre como instalar e executar Linux e BSD em laptops, PDAs e
outros dispositivos de computador móvel.

[ http://www.tuxmobil.org/ ]

Programadores utilitários

HTML Tidy
Este é um utilitário muito útil que corrige seus arquivos HTML para que estejam em conformidade com
Padrões W3C.

[ http://www.w3.org/People/Raggett/tidy ]

Canil
Kannel é um gateway de Wap e SMS de código aberto. Um compilador WML está incluído no
distribuição.

[ http://www.kannel.org/ ]

Ferramentas WML
Esta é uma coleção de utilitários para programadores WML. Isso inclui um compilador, um
descompilador, visualizador e conversor WBMP.

[ http://pwot.co.uk/wml/ ]

WML navegadores e Wap emuladores

Opera
Opera é originalmente um navegador da Web, mas a versão 5 tem um bom suporte para XML e
WML. O Opera está disponível gratuitamente para vários sistemas.

[ http://www.opera.com/ ]

wApua
wApua é um navegador WML de código aberto escrito em Perl / Tk. É fácil instalar e
usar. Seu suporte para WML é incompleto, mas suficiente para fins de teste.

[ http://fsinfo.cs.uni-sb.de/~abe/wApua/ ]

Tofoa
Tofoa é um emulador Wap de código aberto escrito em Python. Sua instalação é bastante
difícil, e seu suporte WML incompleto faz com que produza resultados estranhos, mesmo com
documentos WML válidos.

[ http://tofoa.free-system.com/ ]

EzWAPName
EzWAP, da EZOS, é um navegador WML comercial disponível gratuitamente para Windows 9x, NT,
2000 e CE. Comparado a outros navegadores WML do Windows, requer muito poucos recursos,
e é bastante estável. Seu suporte para as especificações WML parece bastante completo. Um muito bom
.

[ http://www.ezos.com/ ]

Deck-It
Deck-It é um emulador de telefone Wap comercial, disponível para Windows e Linux / Intel
só. É um software muito bom que realmente mostra como as páginas WML são renderizadas
em um telefone Wap, mas um de seus principais padrões é que ele não pode ler arquivos locais.

[ http://www.pyweb.com/tools/ ]

Navegador WAP Klondike
Klondike WAP Browser é um navegador WAP comercial disponível para Windows e PocketPC.

[ http://www.apachesoftware.com/ ]

WinWAPGenericName
WinWAP é um navegador Wap comercial, disponível gratuitamente para Windows.

[ http://www.winwap.org/ ]

WAPmanName
WAPman da EdgeMatrix, é um navegador WAP comercial disponível para Windows e PalmOS.

[ http://www.edgematrix.com/edge/control/MainContentBean? page = downloads]

Companheiro sem fio
Wireless Companion, de YourWap.com, é um emulador WAP disponível para Windows.

[ http://www.yourwap.com/ ]

Mobilizador
Mobilizer é um emulador Wap disponível para Windows e Unix.

[ http://mobilizer.sourceforge.net/ ]

Navegador QWml
QWmlBrowser (anteriormente conhecido como WML BRowser) é um navegador WML de código aberto, escrito
usando o kit de ferramentas Qt.

[ http://www.wmlbrowser.org/ ]

Wapsódia
Wapsody, desenvolvido pela IBM, é um ambiente de simulação disponível gratuitamente que
implementa a especificação WAP. Ele também possui um navegador WML que pode ser executado
estar sozinho. Como o Wapsody é escrito em Java / Swing, ele deve funcionar em qualquer sistema.

[ http://alphaworks.ibm.com/aw.nsf/techmain/wapsody ]

WA Visualização
WAPreview é um emulador Wap escrito em Java. Como ele usa uma IU baseada em HTML e precisa de um
proxy da web local, ele é executado muito lentamente.

[ http://wapreview.sourceforge.net ]

PicoWapGenericName
PicoWap é um pequeno navegador WML feito por três estudantes franceses.

[ http://membres.lycos.fr/picowap/ ]

AGRADECIMENTOS

Werner Heuser, por suas inúmeras idéias, conselhos e sua ajuda para a depuração

Igor Khristophorov, por suas inúmeras sugestões e patches

E todas as pessoas que me enviam relatórios de bug: Daniele Frijia, Axel Jerabek, Ouyang

Use html2wml online usando serviços onworks.net