update advanced/websockets.md

docs/pt/docs/advanced/websockets.md

@@ -1,10 +1,10 @@
-# WebSockets
+# WebSockets { #websockets }
 
 Você pode usar <a href="https://developer.mozilla.org/en-US/docs/Web/API/WebSockets_API" class="external-link" target="_blank">WebSockets</a> com **FastAPI**.
 
-## Instalando `WebSockets`
+## Instale `websockets` { #install-websockets }
 
-Garanta que você criou um [ambiente virtual](../virtual-environments.md){.internal-link target=_blank}, o ativou e instalou o `websockets`:
+Garanta que você criou um [ambiente virtual](../virtual-environments.md){.internal-link target=_blank}, o ativou e instalou o `websockets` (uma biblioteca Python que facilita o uso do protocolo "WebSocket"):
 
 <div class="termy">
 
@@ -16,9 +16,9 @@ $ pip install websockets
 
 </div>
 
-## Cliente WebSockets
+## Cliente WebSockets { #websockets-client }
 
-### Em produção
+### Em produção { #in-production }
 
 Em seu sistema de produção, você provavelmente tem um frontend criado com um framework moderno como React, Vue.js ou Angular.
 
@@ -40,11 +40,11 @@ Mas é a maneira mais simples de focar no lado do servidor de WebSockets e ter u
 
 {* ../../docs_src/websockets/tutorial001.py hl[2,6:38,41:43] *}
 
-## Criando um `websocket`
+## Crie um `websocket` { #create-a-websocket }
 
 Em sua aplicação **FastAPI**, crie um `websocket`:
 
-{*../../docs_src/websockets/tutorial001.py hl[46:47]*}
+{* ../../docs_src/websockets/tutorial001.py hl[1,46:47] *}
 
 /// note | Detalhes Técnicos
 
@@ -54,15 +54,15 @@ A **FastAPI** fornece o mesmo `WebSocket` diretamente apenas como uma conveniên
 
 ///
 
-## Aguardar por mensagens e enviar mensagens
+## Aguarde mensagens e envie mensagens { #await-for-messages-and-send-messages }
 
 Em sua rota WebSocket você pode esperar (`await`) por mensagens e enviar mensagens.
 
-{*../../docs_src/websockets/tutorial001.py hl[48:52]*}
+{* ../../docs_src/websockets/tutorial001.py hl[48:52] *}
 
 Você pode receber e enviar dados binários, de texto e JSON.
 
-## Tente você mesmo
+## Tente { #try-it }
 
 Se seu arquivo for nomeado `main.py`, execute sua aplicação com:
 
@@ -96,7 +96,7 @@ Você pode enviar (e receber) muitas mensagens:
 
 E todas elas usarão a mesma conexão WebSocket.
 
-## Usando `Depends` e outros
+## Usando `Depends` e outros { #using-depends-and-others }
 
 Nos endpoints WebSocket você pode importar do `fastapi` e usar:
 
@@ -109,7 +109,7 @@ Nos endpoints WebSocket você pode importar do `fastapi` e usar:
 
 Eles funcionam da mesma forma que para outros endpoints FastAPI/*operações de rota*:
 
-{*../../docs_src/websockets/tutorial002_an_py310.py hl[68:69,82]*}
+{* ../../docs_src/websockets/tutorial002_an_py310.py hl[68:69,82] *}
 
 /// info | Informação
 
@@ -119,7 +119,7 @@ Você pode usar um código de fechamento dos <a href="https://tools.ietf.org/htm
 
 ///
 
-### Tente os WebSockets com dependências
+### Tente os WebSockets com dependências { #try-the-websockets-with-dependencies }
 
 Se seu arquivo for nomeado `main.py`, execute sua aplicação com:
 
@@ -133,11 +133,11 @@ $ fastapi dev main.py
 
 </div>
 
-Abrar seu browser em: <a href="http://127.0.0.1:8000" class="external-link" target="_blank">http://127.0.0.1:8000</a>.
+Abra seu navegador em: <a href="http://127.0.0.1:8000" class="external-link" target="_blank">http://127.0.0.1:8000</a>.
 
 Lá você pode definir:
 
-* O "Item ID", usado na rota.
+* O "Item ID", usado no path.
 * O "Token" usado como um parâmetro de consulta.
 
 /// tip | Dica
@@ -150,15 +150,15 @@ Com isso você pode conectar o WebSocket e então enviar e receber mensagens:
 
 <img src="/img/tutorial/websockets/image05.png">
 
-## Lidando com desconexões e múltiplos clientes
+## Lidando com desconexões e múltiplos clientes { #handling-disconnections-and-multiple-clients }
 
 Quando uma conexão WebSocket é fechada, o `await websocket.receive_text()` levantará uma exceção `WebSocketDisconnect`, que você pode então capturar e lidar como neste exemplo.
 
-{*../../docs_src/websockets/tutorial003_py39.py hl[79:81]*}
+{* ../../docs_src/websockets/tutorial003_py39.py hl[79:81] *}
 
 Para testar:
 
-* Abrar o aplicativo com várias abas do navegador.
+* Abra o aplicativo com várias abas do navegador.
 * Escreva mensagens a partir delas.
 * Então feche uma das abas.
 
@@ -172,13 +172,13 @@ Client #1596980209979 left the chat
 
 O app acima é um exemplo mínimo e simples para demonstrar como lidar e transmitir mensagens para várias conexões WebSocket.
 
-Mas tenha em mente que, como tudo é manipulado na memória, em uma única lista, ele só funcionará enquanto o processo estiver em execução e só funcionará com um único processo.
+Mas tenha em mente que, como tudo é manipulado na memória, em uma única list, ele só funcionará enquanto o processo estiver em execução e só funcionará com um único processo.
 
 Se você precisa de algo fácil de integrar com o FastAPI, mas que seja mais robusto, suportado por Redis, PostgreSQL ou outros, verifique o <a href="https://github.com/encode/broadcaster" class="external-link" target="_blank">encode/broadcaster</a>.
 
 ///
 
-## Mais informações
+## Mais informações { #more-info }
 
 Para aprender mais sobre as opções, verifique a documentação do Starlette para: