Browse Source

🌐 Add Portuguese translation for the tutorial/index page (#1259)

* Translate tutorial/index.md to Portuguese

* ✏️ Update capitalization

* 🔧 Update docs section title in Portuguese

Co-authored-by: Sebastián Ramírez <[email protected]>
pull/1420/head
Marcos Monteiro 5 years ago
committed by GitHub
parent
commit
caed37a08f
No known key found for this signature in database GPG Key ID: 4AEE18F83AFDEB23
  1. 80
      docs/pt/docs/tutorial/index.md
  2. 2
      docs/pt/mkdocs.yml

80
docs/pt/docs/tutorial/index.md

@ -0,0 +1,80 @@
# Tutorial - Guia de Usuário - Introdução
Esse tutorial mostra como usar o **FastAPI** com a maior parte de seus recursos, passo a passo.
Cada seção constrói, gradualmente, sobre as anteriores, mas sua estrutura são tópicos separados, para que você possa ir a qualquer um específico e resolver suas necessidades específicas de API.
Ele também foi feito como referência futura.
Então você poderá voltar e ver exatamente o que precisar.
## Rode o código
Todos os blocos de código podem ser copiados e utilizados diretamente (eles são, na verdade, arquivos Python testados).
Para rodar qualquer um dos exemplos, copie o codigo para um arquivo `main.py`, e inicie o `uvivorn` com:
<div class="termy">
```console
$ uvicorn main:app --reload
<span style="color: green;">INFO</span>: Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
<span style="color: green;">INFO</span>: Started reloader process [28720]
<span style="color: green;">INFO</span>: Started server process [28722]
<span style="color: green;">INFO</span>: Waiting for application startup.
<span style="color: green;">INFO</span>: Application startup complete.
```
</div>
É **ALTAMENTE recomendado** que você escreva ou copie o código, edite-o e rode-o localmente.
Usá-lo em seu editor é o que realmente te mostra os benefícios do FastAPI, ver quão pouco código você tem que escrever, todas as conferências de tipo, auto completações etc.
---
## Instale o FastAPI
O primeiro passo é instalar o FastAPI.
Para o tutorial, você deve querer instalá-lo com todas as dependências e recursos opicionais.
<div class="termy">
```console
$ pip install fastapi[all]
---> 100%
```
</div>
...isso também inclui o `uvicorn`, que você pode usar como o servidor que rodará seu código.
!!! nota
Você também pode instalar parte por parte.
Isso é provavelmente o que você faria quando você quisesse lançar sua aplicação em produção:
```
pip install fastapi
```
Também instale o `uvicorn` para funcionar como servidor:
```
pip install uvicorn
```
E o mesmo para cada dependência opcional que você quiser usar.
## Guia Avançado de Usuário
Há também um **Guia Avançado de Usuário** que você pode ler após esse **Tutorial - Guia de Usuário**.
O **Guia Avançado de Usuário** constrói sobre esse, usa os mesmos conceitos e te ensina alguns recursos extras.
Mas você deveria ler primeiro o **Tutorial - Guia de Usuário** (que você está lendo agora).
Ele foi projetado para que você possa construir uma aplicação completa com apenas o **Tutorial - Guia de Usuário**, e então estendê-la de diferentes formas, dependendo das suas necessidades, usando algumas ideias adicionais do **Guia Avançado de Usuário**.

2
docs/pt/mkdocs.yml

@ -25,6 +25,8 @@ nav:
- pt: /pt/
- zh: /zh/
- features.md
- Tutorial - Guia de Usuário:
- tutorial/index.md
- history-design-future.md
markdown_extensions:
- toc:

Loading…
Cancel
Save