Skip to content

Commit c66041e

Browse files
LuanGBLuanGB
committed
Adds pt-BR translation for the docs
1 parent 3339b99 commit c66041e

13 files changed

+1204
-0
lines changed

Diff for: ‎docs/pt-BR/README.md

+118
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,118 @@
1+
# Introdução
2+
3+
## O que é Leon?
4+
5+
Leon é um **assistente pessoal de código aberto** que vive no seu servidor.
6+
7+
Ele faz coisas quando você pedir.
8+
9+
Você pode falar com ele e ele pode falar com você.
10+
Você também pode lhe mandar mensagens e ele também, a você.
11+
Se você quiser, Leon pode se comunicar com você offline, para proteger sua provacidade.
12+
13+
Você pode pensar nele como um segundo cérebro.
14+
15+
::: tip
16+
Leon ainda é muito joven, hoje. Se você desejar, pode ajudar [contribuindo](https://github.com/leon-ai/leon/blob/develop/.github/CONTRIBUTING.md) <3
17+
:::
18+
19+
## Demo
20+
21+
O Vídeo está disponível [aqui](http://www.youtube.com/watch?v=p7GRGiicO1c).
22+
23+
## Motivações
24+
25+
26+
1. Como desenvolvedores (ou não), nós **amamos criar** coisas, especialmente aquelas que podem **ajudar** na sua **vida diária**. Então, ao invés de construir um projeto dedicado para cada coisa, Leon pode nos ajudar através da sua estrutura de **packages/modules** (skills). Nós cremos que é melhor que manter suas ideias em backlog pra sempre, certo?
27+
2. Com sua estrutura genérica, **todo mundo** pode **criar** seu próprio **módulo** e **compartilhá-lo**. Assim, há apenas um núcleo (to rule them all).
28+
3. Leon usa **conceitos de AI**, o que é legal.
29+
4. **Privacidade é importante**, então você pode configurar Leon para falar com ele **offline**. Você já pode lhe enviar **textos**, **sem** nenhum **serviço de terceiros**.
30+
5. Por último, mas não menos importante: **código aberto** é ótimo!
31+
32+
## Prerequisitos
33+
34+
- **[Node.js](https://nodejs.org/) >= 10**
35+
> O núcleo do Leon é desenvolvido usando o Node.js
36+
- **npm >= 5**
37+
> o npm é o gerenciador de pacotes do Node.js. Leon precisa dele para as dependências do seu núcleo.
38+
- **[Python](https://www.python.org/downloads/) 3.6.x**
39+
> Hoje em dia, os módulos do Leon são escritos exclusivamente em Python.
40+
- **[Pipenv](https://docs.pipenv.org)**
41+
> Pipenv permite que os módulos sejam executados num ambiente dedicado. Ele também já traz um gerenciador de pacotes embutido para as dependencias dos seus módulos.
42+
- **SO's Suportados: Linux, macOS and Windows**
43+
> Precisa explicação? :)
44+
45+
::: tip
46+
Você pode ler a página de [Como Fazer...](/how-to/) para instalar os pré-requisitos.
47+
:::
48+
49+
## Installation
50+
51+
### Download
52+
53+
VOcê tem duas opções principais para baixar o Leon:
54+
55+
#### 1. Git
56+
57+
Você pode clonar o [repositório do GitHub](https://github.com/leon-ai/leon) de diferentes branches.
58+
59+
##### Master Branch
60+
61+
A branch `master` é usada como um snapshot da última release:
62+
63+
```bash
64+
git clone -b master https://github.com/leon-ai/leon.git leon
65+
```
66+
67+
##### Develop Branch
68+
69+
A branch `develop` é a branch padrão. Aqui é onde as últimas modificações são combinadas. O que significa que nessa branch você vai ter acesso às últimas modificações antecipadamente, mas tenha em mente que não serão tão estáveis quando a `master`:
70+
71+
```bash
72+
git clone https://github.com/leon-ai/leon.git leon
73+
```
74+
75+
#### 2. Arquivos de Release
76+
77+
Você também pode baixar a última versão seguindo [este link](https://github.com/leon-ai/leon/releases/latest).
78+
79+
### Install
80+
81+
Depois de ter instalado todos os pré-requisitos, e ter baixado o Leon, você pode instalar assim:
82+
83+
```bash
84+
# Go to the project root
85+
cd leon
86+
87+
# Install
88+
npm install
89+
```
90+
91+
## Uso
92+
93+
Assegure-se que todo o processo ocorreu bem com o comando:
94+
95+
```bash
96+
npm run check
97+
```
98+
99+
Isto deve lhe retornar um relatório sobre o quanto Leon está instalado/configurado. Não se preocupe se você tiver alguns avisos no relatório. Possivelmente, isto é porque você ainda não [configurou o Leon](/configuration.md)
100+
101+
Se o relatório mencionar que *Leon can run correctly*, então você pode montar e iniciar o Leon
102+
103+
```bash
104+
# Build
105+
npm run build
106+
107+
# Run
108+
npm start
109+
110+
# Go to http://localhost:1337
111+
# Hooray! Leon is running
112+
```
113+
114+
Nessa altura, você já pode comunicar-se com ele por texto e pedir a ele para fazer coisas.
115+
116+
::: tip
117+
Para ver o que ele pode vazer, cheque a [lista de pacotes](https://github.com/leon-ai/leon/tree/develop/packages).
118+
:::

Diff for: ‎docs/pt-BR/architecture.md

+30
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
# Arquitetura
2+
3+
Assegure-se de ler o [glossário](/pt-BR/glossary.md) para entender melhor esta seção.
4+
5+
## Diagrama Arquitetural de Alto Nível
6+
7+
![Diagrama Arquitetural de Alto Nível do Leon](/assets/img/high-level_architecture_schema.svg "Leon's High-Level Architecture Schema")
8+
9+
## Cenário
10+
11+
Este Cenário descreve os passos do esquema acima. Note que a maior parte das interações são feitas através de WebSockets.
12+
13+
1. Cliente (web app, etc.) faz uma solicitação HTTP GET para buscar alguma informação sobre Leon.
14+
2. A [API HTTP](/pt-BR/glossary.md#api) retorna as informações ao cliente.
15+
3. Usuário fala ao microfone.
16+
4. <i style="opacity: 0;">.</i>
17+
- a. Se o servidor de [hotwords](/pt-BR/offline.md#hotword) está iniciado, Leon ouve (offline) se o usuário está o chamando ao dizer "`Leon`".
18+
- b. Se Leon entende o usuário lhe chamando, ele emite a mensagem para o servidor principal usando um WebSocket. Agora Leon está escutando (offline) o usuário.
19+
- c. O Usuário diz `Hello!` para Leon, o cliente transforma a entrada de áudio em um blob de áudio.
20+
5. O [ASR](/pt-BR/glossary.md#asr) transforma o blob de áudio em um arquivo de ondas (wave).
21+
6. O parser [STT](/pt-BR/glossary.md#stt) transforma o wave em uma string (`Hello`).
22+
7. <i style="opacity: 0;">.</i>
23+
- a. O usuário recebe o texto, que é encaminhado ao [NLU](/pt-BR/glossary.md#nlu).
24+
- b. Ou digita `Hello!` com o teclado (ignorando os passos 1. à 7.a.). O texto `Hello!` é encaminhado ao NLU.
25+
8. O NLU classifica o texto e seleciona uma classificação.
26+
9. Se o [logger colaborativo](/pt-BR/collaborative-logger.md) está ativado, a classificação é enviada a ele.
27+
10. O [Cérebro](/pt-BR/glossary.md#cerebro) cria um processo filho e executa o [módulo](/pt-BR/glossary.md#modulos) escolhido.
28+
11. Se o [sincronizador](/pt-BR/glossary.md#sincronizador) está ativado e o módulo tem essa opção, ele sincroniza o conteúdo
29+
12. O Cérebro gera uma [resposta](/pt-BR/glossary.md#respostas) e encaminha ao sintetizador [TTS](/pt-BR/glossary.md#tts).
30+
13. O sintetizador TTS transforma a resposta em texto (e envia a resposta ao usuário como texto) para o buffer de áudio, que é então reproduzido pelo cliente.

Diff for: ‎docs/pt-BR/bridges.md

+20
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
# Bridges
2+
3+
4+
Bridges são uma parte do Leon que permite fazer conexões entre seu core e seus módulos. Você pode pensar neles como conectores também. As bridges também executam os módulos do Leon.
5+
Na verdade, o core cria um [processo filho do Node.js](https://nodejs.org/api/child_process.html) que executa o módulo em questão.
6+
7+
No futuro, nós gostaríamos da possibilidade de escrever módulos par ao Leon um outras linguagens e não somente em Python.
8+
9+
::: tip
10+
As Bridges podem ser encontradas na pasta `bridges`.
11+
:::
12+
13+
## Python
14+
15+
A bridge de Python é a razão pela qual Leon precisa do Python para funcionar hoje. Pois há somente uma bridge disponível até agora.
16+
17+
Se você deseja executar um módulo separadamente, sem um processo filho, execute o regunte comando partindo do diretório raiz do projeto:
18+
```bash
19+
PIPENV_PIPFILE=bridges/python/Pipfile pipenv run python bridges/python/main.py {LANG} {PACKAGE} {MODULE} "{STRING}"
20+
```

Diff for: ‎docs/pt-BR/clients.md

+37
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,37 @@
1+
# Clients
2+
3+
Clients são o que os usuários vêem e usam explicitamente. É graças aos clientes que você pode interagir com o Leon.
4+
5+
## Web App
6+
7+
![App Web Leon](/assets/img/web-app_client_en.png "Leon's Web App")
8+
9+
O app web é o único cliente hoje. Ele lhe permite interagir com Leon através do seu Browser.
10+
11+
Uma vez que Leon está instalado, você pode acessar o cliente seguindo uma das secções seguintes:
12+
13+
### Development
14+
15+
```bash
16+
# Rode o servidor em development
17+
npm run dev:server
18+
19+
# Rode o web app development
20+
npm run dev:app
21+
22+
# Vá para http://localhost:4242
23+
# Aeww! Leon está rodando
24+
```
25+
26+
### Production
27+
28+
```bash
29+
# Build
30+
npm run build
31+
32+
# Run
33+
npm start
34+
35+
# Vá para http://localhost:1337
36+
# Aeww! Leon está rodando
37+
```

Diff for: ‎docs/pt-BR/collaborative-logger.md

+22
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
# Collaborative Logger
2+
3+
O Logger Colaborativo ajuda a a melhorar o entendimento do Leon. Para cada consulta que você submete ao Leon, ele envia uma solicitação HTTP para um servidor Leon externo, se o Logger Colaborativo estiver habilitado.
4+
5+
Aqui estão as informações que o Leon armazena:
6+
7+
- Sua Versão (número).
8+
- Colculta (texto).
9+
- Idioma.
10+
- Pacote que o Leon usou.
11+
- Módulo que o Leon usou.
12+
- Sua confiança sobre seu entendimento.
13+
- Timestamp atual.
14+
15+
O logger colaborativo está **ativado por padrão**. Se você deseja desativá-lo, simplesmente configure a variável de ambiente `LEON_LOGGER` no seu arquivo `.env` para `FALSE` e reinicie o servidor.
16+
17+
::: tip
18+
Se você está curioso sobre o código, você pode encontrar:
19+
20+
- Parte do código que interage com o logger na [NLU do Leon](https://github.com/leon-ai/leon/blob/develop/server/src/core/nlu.js).
21+
- O código fonte do Logger Colaborativo no seu [repositório no GitHub](https://github.com/leon-ai/leon-logger).
22+
:::

Diff for: ‎docs/pt-BR/configuration.md

+131
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,131 @@
1+
# Configuração
2+
3+
Esta seção deve ajudá-lo a configurar opções como dar uma voz ao Leon, entender a sua voz etc.
4+
5+
::: warning
6+
Estes arquivos devem ficar na sua máquina. Nunca os envie para um repositório remoto. Por padrão, eles já estão sendo ignorados graças ao `.gitignore`.
7+
:::
8+
9+
## Variáveis de Ambiente
10+
11+
| Variável | Descrição | Valores |
12+
| ----------------------------|-------------|---------|
13+
| `LEON_LANG` | Idioma de fala e de entendimento do Leon. **Se você mudar o idioma**, rode: `npm run train expressions`. | `en-US` (padrão); `fr-FR` |
14+
| `LEON_NODE_ENV` | Ambiente. | `development` (padrão); `production`; `testing` |
15+
| `LEON_SERVER_HOST` | host do Server. | `localhost` (padrão) |
16+
| `LEON_SERVER_PORT` | porta do Server. | `1337` (padrão) |
17+
| `LEON_WEBAPP_HOST` | host do Web app. | `localhost` (padrão) |
18+
| `LEON_WEBAPP_PORT` | porta do Web app. | `4242` (padrão) |
19+
| `LEON_TIME_ZONE` | Fuso horário do Leon. | Seu fuso horário atual (padrão); [Moment Timezone](https://momentjs.com/timezone/) |
20+
| `LEON_AFTER_SPEECH` | Ativar/Desativar escuta automática depois de falar. Torna desnecessário dizer `Leon` para dar outro comando quando você já falou uma vez. | `true`; `false` (padrão) |
21+
| `LEON_STT` | Ativar/Desativar STT. | `true`; `false` (padrão) |
22+
| `LEON_STT_PROVIDER` | Provedor STT. | `deepspeech` (padrão); `google-cloud-stt`; `watson-stt` |
23+
| `LEON_TTS` | Ativar/Desativar TTS. | `true`; `false` (padrão) |
24+
| `LEON_TTS_PROVIDER` | Provedor TTS. | `flite` (padrão); `google-cloud-tts`; `amazon-polly`; `watson-tts` |
25+
| `LEON_LOGGER` | Ativar/Desativar logger colaborativo. | `true` (padrão); `false` |
26+
| `PIPENV_PIPFILE` | Caminho do Pipfile. Não mude, à menos que você saiba o que está fazendo. | `bridges/python/Pipfile` (padrão) |
27+
| `PIPENV_VENV_IN_PROJECT` | Cria o virtualenv no mesmo nível que o Pipfile. Não mude, à menos que você saiba o que está fazendo. | `true` (padrão) |
28+
29+
## Voz
30+
31+
o Leon tem vários provedores para o seu STT e TTS. Você pode configurar um (ou vários) e escolher o seu favorito.
32+
33+
::: tip
34+
Para ativar o STT e/ou o TTS do Leon, no seu arquivo `.env`, **você deve configurar `LEON_STT=true` e/ou `LEON_TTS=true`**
35+
36+
Também, **você também precisa inquirir o provedor, configurando `LEON_STT_PROVIDER={SUA ESCOLHA DE PROVEDOR STT}` and/or `LEON_TTS_PROVIDER={SUA ESCOLHA DE PROVEDOR TTS}`**.
37+
Cheque a seção [variáveis de ambiente](/configuration.md#variaveis-de-ambiente) para saber os valores para os provedores.
38+
:::
39+
40+
### Offline
41+
42+
Confira [esta seção](/offline.md).
43+
44+
### Amazon
45+
46+
#### Amazon Polly (TTS)
47+
48+
1. [Um um novo usuário IAM](https://console.aws.amazon.com/iam/home#/users$new?step=details) no console AWS. Escolha um `User name`, na seção `Access type`, marque `Programmatic access` e entao clique `Next`.
49+
2. Na seção de permissões, escolha `Attach existing policies directly` e procure por `Polly`. Então, marque o item `AmazonPollyFullAccess`. Clique `Next` (e pule a seção 'tag').
50+
3. Clique no botão `Create user`.
51+
4. Você deverá ver um `Access key ID` e um `Secret access key`. Copie Ambos e cole no arquivo `server/src/config/voice/amazon.json` do Leon.
52+
53+
### Google Cloud
54+
55+
Usando esse provedor, as credenciais são as mesmas para STT e TTS
56+
57+
#### Google Cloud STT & Google Cloud TTS
58+
59+
1. [Crie ou selecione um projeto](https://console.cloud.google.com/cloud-resource-manager) no GCP (Google Cloud Platform).
60+
2. Ative a [STT API](https://console.cloud.google.com/apis/library/speech.googleapis.com) e/ou a [TTS API](https://console.cloud.google.com/apis/library/texttospeech.googleapis.com).
61+
3. [Crie uma service account key](https://console.cloud.google.com/apis/credentials/serviceaccountkey).
62+
4. Faça o Download do arquivo JSON e copie seu conteúdo para o arquivo `server/src/config/voice/google-cloud.json`.
63+
64+
::: tip
65+
A variável de ambiente `GOOGLE_APPLICATION_CREDENTIALS` é usada pelo Google para carregar as credenciais.
66+
O Leon cria e configura o valor desta variável para você.
67+
:::
68+
69+
### Watson
70+
71+
O IBM Watson tem credenciais para cada serviço STT e TTS.
72+
73+
#### Watson STT
74+
75+
1. [Clique aqui](https://console.bluemix.net/catalog/services/speech-to-text) para obter suas credenciais.
76+
2. Clique em `Create` (ou `Sign up to Create` se você ainda não tiver uma conta).
77+
3. Clique em `Manage` no menu da esquerda, e então em `Show Credentials`.
78+
4. Copie `API Key` e `URL`, e então cole no arquivo `server/src/config/voice/watson-stt.json`.
79+
80+
#### Watson TTS
81+
82+
1. [Click here](https://console.bluemix.net/catalog/services/text-to-speech) to get your credentials.
83+
2. Click on `Create` (or `Sign up to Create` if you do not have an account yet).
84+
3. Click on `Manage` in the left menu, then on `Show Credentials`.
85+
4. Copy `API Key` and `URL`, then paste them to the following Leon's file: `server/src/config/voice/watson-tts.json`.
86+
87+
## Synchronizer
88+
89+
Se um módulo tem essa opção, assim que um módulo tiver sido processado, você pode sincronizar seu conteúdo através de diferentes métodos.
90+
91+
> Por exemplo, o módulo *YouTube* do pacote *[Video Downloader Package](https://github.com/leon-ai/leon/tree/develop/packages/videodownloader)* lhe permite sincronizar seus vídeos baixados na sua conta do Google Drive ou no seu dispositivo.
92+
93+
::: tip
94+
Para determinar se um módulo inclui esta opção, simplesmente verifique sua configuração usando este arquivo: `packages/{PACKAGE NAME}/config/config.json`.
95+
96+
**Neste arquivo, defina a chave `enabled` como ` true`** para ativar o sincronizador para um módulo específico.
97+
:::
98+
99+
| Method | Description |
100+
| --------------------|---------------------------
101+
| `direct` | Sincronizar conteúdo com o seu dispositivo atual. |
102+
| `google-drive` | Sincronizar conteúdo com o Google Drive. |
103+
104+
### Direct
105+
106+
```json
107+
"synchronization": {
108+
"enabled": true,
109+
"method": "direct",
110+
"email": ""
111+
}
112+
```
113+
> *`packages/{PACKAGE NAME}/config/config.json`*
114+
115+
### Google Drive
116+
117+
1. [Crie ou Selecione um projeto](https://console.cloud.google.com/cloud-resource-manager) no GCP (Google Cloud Platform).
118+
2. Ative a [Google Drive API](https://console.developers.google.com/apis/library/drive.googleapis.com).
119+
3. [Crie uma service account key](https://console.cloud.google.com/apis/credentials/serviceaccountkey).
120+
4. Faça o Download do arquivo JSON e copie seu conteúdo para o arquivo `server/src/config/synchronizer/google-drive.json`.
121+
122+
```json
123+
"synchronization": {
124+
"enabled": true,
125+
"method": "google-drive",
126+
"email": "{YOUR GOOGLE EMAIL ADDRESS}"
127+
}
128+
```
129+
> *`packages/{PACKAGE NAME}/config/config.json`*
130+
131+
Um email é enviado para este endereço, uma vez que o Leon tenha sincronizado seu conteúdo com o Google Drive.

0 commit comments

Comments
 (0)