Skip to content
This repository has been archived by the owner on Jan 14, 2020. It is now read-only.

Commit

Permalink
Merge pull request #11 from Hand-Talk/corrige-topicos
Browse files Browse the repository at this point in the history
Corrige topicos
  • Loading branch information
MatheusMoura17 authored Sep 4, 2018
2 parents e4b0de9 + afdeb55 commit 20474c1
Show file tree
Hide file tree
Showing 6 changed files with 85 additions and 47 deletions.
17 changes: 8 additions & 9 deletions source/includes/introduction.md
Original file line number Diff line number Diff line change
@@ -1,9 +1,8 @@
# Introdução
<h1 id='introducao'>Introdução</h1>

O plugin desenvolvido pela Hand Talk torna os sites acessíveis em língua de sinais. O mesmo conta com duas principais funcionalidades: tradução de texto e tradução de vídeos.


## Sobre o Tradutor de Texto
<h2 id='sobre-o-tradutor-de-texto'>Sobre o Tradutor de Texto</h2>

O usuário pode ativar a funcionalidade clicando no ícone que representa a acessibilidade em língua de sinais:

Expand All @@ -17,7 +16,7 @@ Enquanto a janela estiver aberta, os textos e imagens com descrição ficarão c

![](images/screenshoots/tradutor-de-sites-3.png)

## Sobre o Tradutor de Vídeos
<h2 id='sobre-o-tradutor-de-videos'>Sobre o Tradutor de Vídeos</h2>

O plugin oferece um player de vídeo acessível em Libras, que suporta:

Expand All @@ -37,16 +36,16 @@ No player acessível você encontra os botões de ativar e desativar tradução

![](images/screenshoots/tradutor-de-videos-2.png)

Consulte a guia [Tradutor de Vídeos > Começando](index.html?html#come-ando14) para um guia de implementação.
Consulte a guia [Tradutor de Vídeos > Começando](index.html?html#comecando-tradutor-de-videos) para um guia de implementação.

## Sobre o Tradutor Mobile
<h2 id='sobre-o-tradutor-mobile'>Sobre o Tradutor Mobile</h2>

A tradução de textos e vídeos também está disponivel na versão mobile, com pequenos ajustes que tornam a usabilidade ainda melhor para o usuário surdo.
A funcionalidade de tradução em dispositivos móveis vem habilitada por padrão, mas você pode removê-la definindo o parâmetro `mobileEnabled` como `false` caso necessário.

![](images/screenshoots/tradutor-mobile.jpg)

## Compatibilidade
<h2 id='compatibilidade'>Compatibilidade</h2>

O plugin é compatível com a maioria dos navegadores modernos com suporte a WebGL, tais como, Chrome, Firefox, Edge, Safari e Opera.

Expand All @@ -71,7 +70,7 @@ Legenda:

-- Sistema operacional não suporta o navegador

## Mensagens de Erro
<h2 id='mensagens-de-erro'>Mensagens de Erro</h2>

Algumas mensagens de erro podem surgir por má configuração da ferramenta, são elas:

Expand All @@ -87,7 +86,7 @@ O Tradutor de vídeos está disponível no plano **Gold 2** ou superior. Caso a
**406 - A funcionalidade de vídeo não está habilitada para a sua assinatura.**
</aside>

## Eventos
<h2 id='eventos-introducao'>Eventos</h2>

> Exemplo de Listener de Eventos
Expand Down
35 changes: 28 additions & 7 deletions source/includes/text-translator.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Tradutor de Sites
<h1 id='tradutor-de-sites'>Tradutor de Sites</h1>

## Começando
<h2 id='comecando-tradutor-de-sites'>Começando</h2>

> Exemplo de Instalação
Expand Down Expand Up @@ -39,7 +39,7 @@ Sem um token válido, a ferramenta não irá funcionar, emitindo o erro ***O se
Você pode adquirir um token para o seu domínio em [account.handtalk.me](https://account.handtalk.me/). <br />
Ou fale com um de nossos consultores em [handtalk.me/sites](http://handtalk.me/sites).

## Parâmetros
<h2 id='parametros'>Parâmetros</h2>

Você pode pode preferir habilitar/desabilitar algumas funcionalidades do Tradutor de Sites, para isso utilize os parâmetros abaixo:

Expand All @@ -59,7 +59,7 @@ Você pode pode preferir habilitar/desabilitar algumas funcionalidades do Tradut
| mobileConfig | Objeto de configuração para a plataforma mobile, quando definido, sobscreve as configurações padrões de HT. | Object | { }


### Parâmetros para versão mobile
<h3 id='parametros-para-versao-mobile'>Parâmetros para versão mobile</h3>

> Exemplo de Parâmetros Exclusivos para Versão Mobile
Expand Down Expand Up @@ -108,7 +108,28 @@ Você pode passar parâmetros especificos para dispositivos movéis, para isso b

Consulte o exemplo ao lado.

## Adicionando Exceções
<h2 id='eventos-tradutor-de-sites'>Eventos</h2>

Os eventos que podem ser disparados pela instancia de HT são:

| Eventos | Descrição | Retorno |
| ------------- |:-------------:| -----:|
| authenticating | Autenticando | undefined |
| errorOnAuth | Erro ao autenticar | undefined |
| authenticated | Autenticado | undefined |
| notCompatible | Navegador ou hardware não compatível | string: 'withoutCanvas' ou 'withoutWebGL' ou 'hardwareDoesNotSupport' |
| customizing | Customizando | undefined |
| customized | Customizado | undefined |
| hugoLoaded | Hugo carregado | undefined |
| activated | Feature de texto ou vídeo ativada | string: 'textManager' ou 'videoManager' |
| translate | Dispara quando um texto é capturado e enviado para tradução pela feature de tradução de texto | string: texto capturado |
| translating | Traduzindo texto no servidor da Hand Talk | undefined |
| errorOnTranslate | Erro ao traduzir texto no servidor da Hand Talk | undefined |
| translated | Texto traduzido corretamente no Servidor da Hand Talk | undefined |
| signalized | Sentença sinalizada por completo | undefined |
| videoManagerReady | Disparado quando o assistente de vídeo esta pronto, utilize para chamar as funções de replace manualmente | undefined |

<h2 id='adicionando-excecoes'>Adicionando Exceções</h2>

> Adicionando Exceções
Expand Down Expand Up @@ -155,7 +176,7 @@ var ht = new HT({

Em alguns casos, pode haver algum conflito entre o código da Hand Talk e algum script que o site possui. Para evitar esse conflito, basta adicionar esse elemento como uma exceção.

### Tratamento de Exceção de ID e CLASS:
<h3 id='tratamento-de-excecao-de-id-e-class'>Tratamento de Exceção de ID e CLASS:</h3>

Caso seu site tenha algum problema de conflito com um scripts de carousel, por exemplo, você pode adicionar o elemento na propriedade `exceptions`.

Expand All @@ -169,7 +190,7 @@ No exemplo ao lado, colocamos na exceção um ID de elemento HTML e uma classe C

**Importante**: Dependendo da linguagem e/ou lógica de programação aplicada no desenvolvimento do website, para possibilitar o pleno funcionamento ou aprimorar os resultados obtidos pelo serviço, pode ser necessária a realização de outras customizações no código da Hand Talk, que deverão ser feitas pelo cliente.

## Iframes Dinâmicos
<h2 id='iframes-dinamicos'>Iframes Dinâmicos</h2>

> Exemplo de Compatibilidade com Iframes Dinâmicos
Expand Down
73 changes: 45 additions & 28 deletions source/includes/video-translator.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Tradutor de Vídeos
<h1 id='tradutor-de-videos'>Tradutor de Vídeos</h1>

## Começando
<h2 id='comecando-tradutor-de-videos'>Começando</h2>

> Exemplo de Instalação
Expand Down Expand Up @@ -41,7 +41,7 @@ Sem a flag `videoEnabled` ativada, o Tradutor de Vídeos não irá funcionar.

Com o plugin devidamente configurado, siga os passos da sessão abaixo para implementar o Player Acessível.

## Utilizando o Player Acessível
<h2 id='utilizando-o-player-acessivel-tradutor-de-videos'>Utilizando o Player Acessível</h2>

O plugin oferece um player de vídeo acessível em Libras, que suporta os seguintes **Techs**:

Expand All @@ -58,7 +58,8 @@ Os tipos de legenda suportados são:
- SRT.

<aside class="info">
Nota: Para utilizar o player acessível, certifique-se de estar com o plugin devidamente configurado de acordo com a sessão [Tradutor de Vídeos > Começando](index.html?html#come-ando14).

Nota: Para utilizar o player acessível, certifique-se de estar com o plugin devidamente configurado de acordo com a sessão [Tradutor de Vídeos > Começando](index.html?html#comecando-tradutor-de-videos).
</aside>


Expand All @@ -80,7 +81,7 @@ Em seguida, separando por ponto e virgula (`;`), defina o tipo e caminho da lege

`subtitle=<CAPTIONS_TYPE>:<CAPTIONS_URL>`

### Exemplo com Tech do Youtube
<h3 id='exemplo-com-tech-youtube'>Exemplo com Tech do Youtube</h3>

> Exemplo: Criando um vídeo com o **tech** youtube
Expand All @@ -96,6 +97,7 @@ Em seguida, separando por ponto e virgula (`;`), defina o tipo e caminho da lege
Caso o campo subtitle fique em branco em um src do tipo Youtube, a legenda será obtida automaticamente. Como no exemplo ao lado.

<aside class="info">

Nota: No source do tipo Youtube, você pode optar por adicionar o link do vídeo, ou apenas o ID. Conforme exemplo ao lado.
</aside>

Expand All @@ -107,9 +109,10 @@ Caso o vídeo esteja definido como **não listado**, ou algum outro tipo de rest

O exemplo ao lado *(Criando um vídeo com o tech youtube)* deve gerar o seguinte player:

<video data-ht="src=youtube:H2Io3y98FV4"></video>

### Exemplo com Tech do Vimeo
<video class='video-js' data-ht="src=youtube:H2Io3y98FV4"></video>

<h3 id='exemplo-com-tech-do-vimeo'>Exemplo com Tech do Vimeo</h3>

> Exemplo: Criando um vídeo com o **tech** vimeo
Expand All @@ -125,9 +128,11 @@ O exemplo ao lado *(Criando um vídeo com o tech youtube)* deve gerar o seguinte
Para vídeos hospedados no Vimeo, você deve informar a legenda manualmente.
Como no exemplo ao lado, o vídeo deve aparecer da seguinte forma:


<video data-ht="src=vimeo:https://player.vimeo.com/video/259226390;subtitle=vtt:assets/HandTalk.vtt"></video>


### Exemplo com Tech de MP4/WEBM
<h3 id='exemplo-com-tech-de-mp4-webm'>Exemplo com Tech de MP4/WEBM/OGG</h3>

> Exemplo: Criando um vídeo com o **tech** mp4
Expand All @@ -144,7 +149,7 @@ Utilize para vídeos e legendas hospedadas na internet com link direto - Exemplo

<video data-ht="src=mp4:assets/HandTalk.mp4;subtitle=vtt:assets/HandTalk.vtt"></video>

### Exemplo com Tech da SambaTech
<h3 id='exemplo-com-tech-da-sambatech'>Exemplo com Tech da SambaTech</h3>

> Exemplo: Criando um vídeo com o **tech** sambatech
Expand All @@ -158,9 +163,10 @@ Utilize para vídeos e legendas hospedadas na internet com link direto - Exemplo
```

Utilize para vídeos hospedados na SambaTech e legendas hospedadas na internet com link direto - Exemplo ao lado.

<video data-ht="src=sambatech:https://fast.player.liquidplatform.com/pApiv2/embed/c750c09d7d04891b7f3f5c9a9337d6b9/a40cc34d36f0ee05ae55a971b427888e;subtitle=vtt:assets/HandTalk.vtt"></video>

## Utilizando Apenas o Tradutor de Vídeos
<h2 id='utilizando-apenas-o-tradutor-de-videos'>Utilizando Apenas o Tradutor de Vídeos</h2>

> Exemplo de Utilização
Expand Down Expand Up @@ -214,15 +220,15 @@ var ht = new HT({
Em alguns casos pode ser necessário adicionar apenas o tradutor de vídeos na página. Geralmente acontece quando a página inteira só possui um vídeo e, está incorporada em outra página em formato de iframe. Pra isso basta desativar o tradutor de textos, assim o botão de acessibilidade em Libras não irá aparecer nas laterais.


## Replace Automático de Vídeos
<h2 id='replace-automatico-de-videos'>Replace Automático de Vídeos</h2>

É possível substituir automaticamente os embeds do Youtube e player existentes do Videojs pelo Player Acessível da HandTalk, sempre que uma legenda for encontrada.

Caso o vídeo não possua legenda no idioma **pt-BR** ou **pt**, o mesmo ficará com a funcionalidade de Tradução para Libras bloqueada. Conforme a imagem abaixo

![](images/screenshoots/tradutor-de-videos-fail.png)

## Replace Automático de Embeds do Youtube
<h2 id='replace-automatico-de-embeds-do-youtube'>Replace Automático de Embeds do Youtube</h2>

> Exemplo de Utilização de Embeds do Youtube
Expand All @@ -237,6 +243,8 @@ var ht = new HT({
});
```

<h3 id='replace-automatico-de-embeds-do-youtube'>Replace automático de embeds do Youtube</h3>

```html
<body>

Expand Down Expand Up @@ -267,7 +275,7 @@ Você pode habilitar o replace automático passando o valor `true` a configuraç
Se embeds do Youtube forem inseridos após a inicialização do plugin, você deve chamar a função `ht.ytEmbedReplaceAll();` para que os novos vídeos tornem-se acessíveis.
Também é possível efetuar o replace de um único embed com `ht.ytEmbedReplace(elem)`:

## Replace Automático de Embeds do Videojs
<h2 id='replace-automatico-de-embeds-do-videojs'>Replace Automático de Embeds do Videojs</h2>

> Exemplo de Utilização de Embeds do Videojs
Expand Down Expand Up @@ -319,9 +327,17 @@ Se os players do videojs forem inseridos após a inicialização do plugin, voc

Conforme o exemplo ao lado direito, também é possível efetuar o replace de um único player com `ht.videojsReplace(vjsPlayer):`

## Vídeos Dinâmicos
<h2 id='videos-dinamicos'>Vídeos Dinâmicos</h2>

Caso o elemento do vídeo seja adicionado ao HTML dinâmicamente depois do carregamento do plugin, você precisa chamar a função de busca para renderizar os players novos.

<aside class="info">

Nota: Para realizar esse procedimento, certifique-se de estar com o plugin devidamente configurado de acordo com a sessão [Tradutor de Vídeos > Começando](index.html?html#comecando-tradutor-de-videos).

> Exemplo: Embeds dinâmicos do youtube
</aside>

> Exemplo de Utilização de Embeds dinâmicos do youtube
```javascript
var ht = new HT({
Expand Down Expand Up @@ -367,7 +383,7 @@ window.setTimeout(function() {
var iframe = document.createElement('iframe');
iframe.src='https://www.youtube.com/embed/a9qsp7l5C3o';
document.body.appendChild(iframe);
// Aguarda o iframe carregar
iframe.onload = function() {
// Torna o embed acessível em Libras
Expand All @@ -381,13 +397,9 @@ window.setTimeout(function() {
</body>
```

Caso o elemento do vídeo seja adicionado ao HTML dinâmicamente depois do carregamento do plugin, você precisa chamar a função de busca para renderizar os players novos.
<h3 id='exemplos-videos-dinamicos'>Exemplos</h3>

<aside class="info">
Nota: Para realizar esse procedimento, certifique-se de estar com o plugin devidamente configurado de acordo com a sessão [Tradutor de Vídeos > Começando](#come-ando14).
</aside>

Para player construidos manualmente, ou seja, utilizando o [Player Acessível](#utilizando-o-player-acess-vel):
Para player construidos manualmente, ou seja, utilizando o [Tradutor de Vídeos > Player Acessível](index.html?html#utilizando-o-player-acessivel-tradutor-de-videos):

`videoManager.search();`

Expand All @@ -399,26 +411,31 @@ Para players existentes do videojs:

`replaceVideoJsAll()` ou `replaceVideoJs(vjsplayer)`.

Para mais detalhes sobre o replace consulte a guia [Replace Automático de Vídeos](#replace-autom-tico-de-v-deos)
Para mais detalhes sobre o replace consulte a guia [Tradutor de Vídeos > Replace Automático de Vídeos](index.html?html#replace-automatico-de-videos).

<h2 id='legendas-tradutor-de-videos'>Legendas</h2>


## Legendas
As legendas precisam ser breves e de acordo com o tempo que será utilizado nelas para que o Hugo possa traduzí-las de forma que ele não acelere e não perca a sincronia com o vídeo.

### Exemplos
<h3 id='exemplos-legendas'>Exemplos</h3>

Abaixo está um exemplo de legenda boa e outro de legenda ruim, respectivamente:


`00:00:04.868 --> 00:00:10.500` </br>
`00:00:04.868 --> 00:00:10.500`<br />
Os grandes feitos da humanidade seriam inúteis se não houvesse a comunicação.

O exemplo acima retrata uma prática boa para legendas.

`00:00:01.000 --> 00:00:01.500`</br>
`00:00:01.000 --> 00:00:01.500`<br />
Asteroblaudo corria pela rua do alagamento no deserto para poder fugir de um casal de rinocerontes.

Enquanto que o exemplo acima retrata uma prática ruim para legendas.

## Resolvendo Conflitos de Estilo (css)
<h2 id='resolvendo-conflitos-de-estilo-css'>Resolvendo Conflitos de Estilo (css)</h2>

É provável que na substituição do elemento `<iframe />` do Youtube, pelo elemento `<div />` com a classe CSS video-js do player da Hand Talk, você perca a referência do elemento no seu CSS e Javascript.

> Exemplo de Estrutura Quebrada
Expand Down
3 changes: 2 additions & 1 deletion source/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -81,7 +81,8 @@
<script>
var ht = new HT({
token: "894ad581fb6306c7363cb9c32a5dd9dd",
videoEnabled: true
videoEnabled: true,
exceptions: ['.tocify-wrapper']
});
</script>
</body>
Expand Down
2 changes: 1 addition & 1 deletion source/index.yml
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
title: Hand Talk | Documentação

language_tabs:
- html
- javascript
- html

toc_footers:
- <a href='https://account.handtalk.me/'>Crie sua conta</a>
Expand Down
2 changes: 1 addition & 1 deletion source/stylesheets/screen.css.scss
Original file line number Diff line number Diff line change
Expand Up @@ -627,7 +627,7 @@ html, body {
background-color: $code-bg;
}

.video-js{
.video-js {
left: 2%;
width: 46%;
height: 500px;
Expand Down

0 comments on commit 20474c1

Please sign in to comment.