EMAPS.Voyant

Há duas formas principais de exportação de URLs no Voyant. A primeira delas é a exportação direta para nova página (em guia ou janela) e a segunda é a exportação através de código HTML contido dentro de um <iframe>...</iframe> (já vimos isto no início destes primeiros passos).

A Exportação Direta

Na exportação direta, quando você aciona o controle de exportação que aparece na tela que mostra o estado de interação 4 de nossa primeira explicação sobre controles interativos, aparece uma caixa de diálogo igual a esta:

Se o controle de número de termos na nuvem estiver configurado para 500 e você clicar em "Export", vai navegar para uma nova página com a seguinte URL:

caixa de diálogo de exportação

https://voyant-tools.org/?corpus=fb27886554e534456cdc8add248f06d0&view=Cirrus&visible=500

Temos uma novidade na URL e se você está lendo estes "Primeiros Passos" na sequência proposta certamente está vendo que apareceu um novo parâmetro na cadeia que comanda o carregamento da ferramenta Cirrus: &visible=500.

Ou seja: podemos "comandar" o número de termos da nuvem seja pelo slider , seja pela edição direta do parâmetro "visible" na cadeia da URL que já temos no navegador.

Quer ver 50 termos? Edite &visible=50. Quer ver 326? Edite &visible=326.

Quando é que as coisas começam a ficar interessantes? Quando eu quero ver apenas 10 termos, por exemplo. Isto é menos do que o mínimo até onde vai o controle "Terms." Será que com &visible=10 eu vejo um número menor de termos? Vejo! Confira lá!

Aprendemos, então que a edição de URLs nos permite fazer coisas que não conseguimos fazer com os controles gráficos da interface do Voyant.

Muito cuidado, porém: A edição de parâmetros nas URLs pode resultar em comandos estapafúrdios, inexequíveis ou extremamente PESADOS para o servidor.  E, em alguns destes casos, o seu acesso ao servidor pode ser julgado malicioso e, consequentemente, bloqueado. Seja responsável ao usar os recursos que tem a sua disposição.

Uma das funções dos controles gráficos é justamente CONTER as possibilidades de comandos diretos, resultantes da especificação de parâmetros nas URLs, causem prejuízo ao funcionamento do servidor, ao usuário, ou às duas partes.

A Exportação de Pedaços de Código HTML 

Na exportação exportação de URLs através de pedaços de código HTML (HTML sippets), a que chegamos se clicarmos no controle de visualizaçao de conteúdo ao lado de "Export View (Tools and Data)" aparece uma caixa de diálogo igual a esta:

Se você escolher a primeira opção ("an HTML snippet for embedding this view in another web page", ou: um pedaço de código HTML para embutir esta visualização em outra página da Web) e clicar em "Export", vai ver o seguinte:

caixa de diálogo de exportação

 

Caixa de diálogo para copiar pedaço de código HTML

Se você copiar e colar o texto, como indicado, este será o código importado, com a URL nele embutida (veja o parâmetro "src= ...."):

<!-- Exported from Voyant Tools (voyant-tools.org).
The iframe src attribute below uses a relative protocol to better function with both
http and https sites, but if you're embedding this into a local web page (file protocol)
you should add an explicit protocol (https if you're using voyant-tools.org, otherwise
it depends on this server.
Feel free to change the height and width values or other styling below: -->
<iframe style='width: 1280px; height: 550px;' src='https://voyant-tools.org/tool/Cirrus/?view=Cirrus&visible=500&corpus=fb27886554e534456cdc8add248f06d0'></iframe>

Examinando a URL, podemos reforçar algo que já tínhamos visto, embora não enfatizado: a ordem dos parâmetros na URL não é fixa. O segundo ponto a destacar é que a chamada "reduntante" da ferramenta Cirrus para execução (/tool/Cirrus/?) e visualização (view=Cirrus) aparece na exportação de pedaço de código HTML "para ser inserido em outra Web page" (qualquer). Ou seja, há condições em que a inserção de código sem esta redundância pode resultar em erro de execução, ou inserção defeituosa. 

Assim, concluímos nosso primeiro "ponto" sobre parâmetros de execução da ferramenta Cirrus e como configurá-los, seja por interação, seja por edição da cadeia de comando da URL.  Há outros parâmetros que serão abordados em página separada.

nach oben