Browse Source

🌐 Add Spanish translation for the tutorial-user-guide index page (#1244)

* Spanish translation for the tutorial-user-guide index page

* Improve some parts of the text in terms of writing

* Change the wording to keep the documentation consistent.

* 📝 Add small wording and consistency changes

* 🎨 Apply the same consistency changes to EN 🤷

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

4
docs/en/docs/tutorial/index.md

@ -75,6 +75,6 @@ There is also an **Advanced User Guide** that you can read later after this **Tu
The **Advanced User Guide**, builds on this, uses the same concepts, and teaches you some extra features.
But you should first read the **Tutorial - User guide** (what you are reading right now).
But you should first read the **Tutorial - User Guide** (what you are reading right now).
It's designed so that you can build a complete application with just the **Tutorial - User guide**, and then extend it in different ways, depending on your needs, using some of the additional ideas from the **Advanced User Guide**.
It's designed so that you can build a complete application with just the **Tutorial - User Guide**, and then extend it in different ways, depending on your needs, using some of the additional ideas from the **Advanced User Guide**.

80
docs/es/docs/tutorial/index.md

@ -0,0 +1,80 @@
# Tutorial - Guía de Usuario - Introducción
Este tutorial te muestra cómo usar **FastAPI** con la mayoría de sus características paso a paso.
Cada sección se basa gradualmente en las anteriores, pero está estructurada en temas separados, así puedes ir directamente a cualquier tema en concreto para resolver tus necesidades específicas sobre la API.
También está diseñado para funcionar como una referencia futura.
Para que puedas volver y ver exactamente lo que necesitas.
## Ejecuta el código
Todos los bloques de código se pueden copiar y usar directamente (en realidad son archivos Python probados).
Para ejecutar cualquiera de los ejemplos, copia el código en un archivo llamado `main.py`, y ejecuta `uvicorn` de la siguiente manera en tu terminal:
<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>
Se **RECOMIENDA** que escribas o copies el código, lo edites y lo ejecutes localmente.
Usarlo en tu editor de código es lo que realmente te muestra los beneficios de FastAPI, al ver la poca cantidad de código que tienes que escribir, todas las verificaciones de tipo, autocompletado, etc.
---
## Instala FastAPI
El primer paso es instalar FastAPI.
Para el tutorial, es posible que quieras instalarlo con todas las dependencias y características opcionales:
<div class="termy">
```console
$ pip install fastapi[all]
---> 100%
```
</div>
...eso también incluye `uvicorn` que puedes usar como el servidor que ejecuta tu código.
!!! nota
También puedes instalarlo parte por parte.
Esto es lo que probablemente harías una vez que desees implementar tu aplicación en producción:
```
pip install fastapi
```
También debes instalar `uvicorn` para que funcione como tu servidor:
```
pip install uvicorn
```
Y lo mismo para cada una de las dependencias opcionales que quieras utilizar.
## Guía Avanzada de Usuario
También hay una **Guía Avanzada de Usuario** que puedes leer luego de este **Tutorial - Guía de Usuario**.
La **Guía Avanzada de Usuario**, se basa en este tutorial, utiliza los mismos conceptos y enseña algunas características adicionales.
Pero primero deberías leer el **Tutorial - Guía de Gsuario** (lo que estas leyendo ahora mismo).
La guía esa diseñada para que puedas crear una aplicación completa con solo el **Tutorial - Guía de Usuario**, y luego extenderlo de diferentes maneras, según tus necesidades, utilizando algunas de las ideas adicionales de la **Guía Avanzada de Usuario**.

2
docs/es/mkdocs.yml

@ -26,6 +26,8 @@ nav:
- zh: /zh/
- features.md
- python-types.md
- "Tutorial - Gu\xEDa de usuario":
- tutorial/index.md
markdown_extensions:
- toc:
permalink: true

Loading…
Cancel
Save