Skip to content

Commit 864d764

Browse files
kevlgkevlg
committed
[Added] Spanish translation
1 parent 06bb98e commit 864d764

16 files changed

+1017
-0
lines changed

‎es.lang.js

+135
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,135 @@
1+
/**
2+
* Configuration for the english (original) translation
3+
*/
4+
5+
module.exports = {
6+
// Language display name. MUST BE THE SAME AS IN [inert.config.js].custom.langs
7+
display: "Español",
8+
prefix: "/es/",
9+
dir: "ltr",
10+
lang: "es",
11+
// `p` stands for `paragraph`. This will contain translations of full text blocks
12+
p: {
13+
headline: "Cliente HTTP basado en Promesas para el navegador y node.js",
14+
subhead: `Axios es un cliente HTTP simple basado en promesas para el navegador y node.js
15+
Axios provee una librería fácil de usar en un paquete pequeño con una
16+
interfaz muy extensible.`,
17+
},
18+
// `t` stands fot `translation`. This will contain translations of single words or phrases
19+
t: {
20+
"Empezar": undefined,
21+
"Ver en GitHub": undefined,
22+
"Idiomas": undefined,
23+
"Código Abierto": undefined,
24+
"Contribuir": undefined,
25+
"Código en GitHub": undefined,
26+
"Bifurcar en GitHub": undefined,
27+
"Bifurcar el Sitio Web": undefined,
28+
"Crear un reporte": undefined,
29+
"Siguiente": undefined,
30+
"Anterior": undefined,
31+
},
32+
sidebar: [
33+
{
34+
type: "heading",
35+
text: "Empezando",
36+
},
37+
{
38+
type: "link",
39+
href: "/docs/intro",
40+
text: "Introducción",
41+
},
42+
{
43+
type: "link",
44+
href: "/docs/example",
45+
text: "Ejemplo",
46+
},
47+
{
48+
type: "link",
49+
href: "/docs/post_example",
50+
text: "Petición POST",
51+
},
52+
{
53+
type: "heading",
54+
text: "API de Axios",
55+
},
56+
{
57+
type: "link",
58+
href: "/docs/api_intro",
59+
text: "API de Axios",
60+
},
61+
{
62+
type: "link",
63+
href: "/docs/instance",
64+
text: "La instancia Axios",
65+
},
66+
{
67+
type: "link",
68+
href: "/docs/req_config",
69+
text: "Configuración de Petición",
70+
},
71+
{
72+
type: "link",
73+
href: "/docs/res_schema",
74+
text: "Esquema de Respuesta",
75+
},
76+
{
77+
type: "link",
78+
href: "/docs/config_defaults",
79+
text: "Configuraciones por Defecto",
80+
},
81+
{
82+
type: "link",
83+
href: "/docs/interceptors",
84+
text: "Interceptores",
85+
},
86+
{
87+
type: "link",
88+
href: "/docs/handling_errors",
89+
text: "Manejando Errores",
90+
},
91+
{
92+
type: "link",
93+
href: "/docs/cancellation",
94+
text: "Cancelación",
95+
},
96+
{
97+
type: "link",
98+
href: "/docs/urlencoded",
99+
text: "Cuerpos de solicitud codificados como URL",
100+
},
101+
{
102+
type: "heading",
103+
text: "Otro",
104+
},
105+
{
106+
type: "link",
107+
href: "/docs/notes",
108+
text: "Notas",
109+
},
110+
{
111+
type: "heading",
112+
text: "Contribuidores",
113+
},
114+
{
115+
type: "link",
116+
href: "https://github.com/axios/axios/blob/master/CODE_OF_CONDUCT.md",
117+
text: "Código de Conducta",
118+
},
119+
{
120+
type: "link",
121+
href: "https://github.com/axios/axios/blob/master/COLLABORATOR_GUIDE.md",
122+
text: "Guía del Colaborador",
123+
},
124+
{
125+
type: "link",
126+
href: "https://github.com/axios/axios/blob/master/CONTRIBUTING.md",
127+
text: "Contribuir a Axios"
128+
},
129+
{
130+
type: "link",
131+
href: "/docs/translating",
132+
text: "Traducir estos documentos"
133+
}
134+
],
135+
};

‎inert.config.js

+7
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,7 @@ const zhConfig = require("./zh.lang.js");
2020
const ukConfig = require("./uk.lang.js");
2121
const ptBRConfig = require("./ptBR.lang.js");
2222
const kuConfig = require("./ku.lang.js");
23+
const esConfig = require('./es.lang.js');
2324

2425
// List of languages
2526
const langs = [
@@ -60,6 +61,12 @@ const langs = [
6061
config: kuConfig,
6162
dir: "rtl",
6263
},
64+
{
65+
dir: "ltr",
66+
name: "Español",
67+
prefix: "/es/",
68+
config: esConfig,
69+
},
6370
];
6471

6572
/**

‎posts/es/api_intro.md

+60
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,60 @@
1+
---
2+
title: 'API de Axios'
3+
description: 'Referencia del API de Axios'
4+
prev_title: 'Petición Post'
5+
prev_link: '/es/docs/post_example'
6+
next_title: 'La instancia Axios'
7+
next_link: '/es/docs/instance'
8+
---
9+
10+
Las peticiones pueden ser hechas pasando la configuración relevante a `axios`.
11+
12+
##### axios(config)
13+
14+
```js
15+
// Enviar una petición POST
16+
axios({
17+
method: 'post',
18+
url: '/user/12345',
19+
data: {
20+
firstName: 'Fred',
21+
lastName: 'Flintstone'
22+
}
23+
});
24+
```
25+
26+
```js
27+
// Petición GET para una imagen remota en node.js
28+
axios({
29+
method: 'get',
30+
url: 'http://bit.ly/2mTM3nY',
31+
responseType: 'stream'
32+
})
33+
.then(function (response) {
34+
response.data.pipe(fs.createWriteStream('ada_lovelace.jpg'))
35+
});
36+
```
37+
38+
##### axios(url[, config])
39+
40+
```js
41+
// Enviar petición GET (método por defecto)
42+
axios('/user/12345');
43+
```
44+
45+
### Alias de metodos de petición
46+
47+
Por conveniencia los alias han sido proveídos para todos los métodos de petición.
48+
49+
##### axios.request(config)
50+
##### axios.get(url[, config])
51+
##### axios.delete(url[, config])
52+
##### axios.head(url[, config])
53+
##### axios.options(url[, config])
54+
##### axios.post(url[, data[, config]])
55+
##### axios.put(url[, data[, config]])
56+
57+
##### axios.patch(url[, data[, config]])
58+
59+
###### NOTA
60+
Al usar los alias, las propiedades `url`, `method`, y `data` no necesitan ser especificadas en la configuración.

‎posts/es/cancellation.md

+56
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,56 @@
1+
---
2+
title: 'Cancelación'
3+
prev_title: 'Manejando Errores'
4+
prev_link: '/es/docs/handling_errors'
5+
next_title: 'Cuerpos de solicitud codificados como URL'
6+
next_link: '/es/docs/urlencoded'
7+
---
8+
9+
Puedes cancelar una petición usando un *token de cancelación*.
10+
11+
> El API del token de cancelación de axios esta basado en el retiro de [propuesta de promesas cancelables](https://github.com/tc39/proposal-cancelable-promises).
12+
13+
Puedes crear un token de cancelación usando el factory `CancelToken.source` a como se muestra a continuación:
14+
15+
```js
16+
const CancelToken = axios.CancelToken;
17+
const source = CancelToken.source();
18+
19+
axios.get('/user/12345', {
20+
cancelToken: source.token
21+
}).catch(function (thrown) {
22+
if (axios.isCancel(thrown)) {
23+
console.log('Request canceled', thrown.message);
24+
} else {
25+
// manejar error
26+
}
27+
});
28+
29+
axios.post('/user/12345', {
30+
name: 'new name'
31+
}, {
32+
cancelToken: source.token
33+
})
34+
35+
// cancelar la petición (el parametro mensaje es opcional)
36+
source.cancel('Operation canceled by the user.');
37+
```
38+
39+
También puedes crear un token de cancelación pasando una función ejecutora al constructor `CancelToken`:
40+
41+
```js
42+
const CancelToken = axios.CancelToken;
43+
let cancel;
44+
45+
axios.get('/user/12345', {
46+
cancelToken: new CancelToken(function executor(c) {
47+
// Una función ejecutora recibe una función de cancelación como parámetro
48+
cancel = c;
49+
})
50+
});
51+
52+
// cancelar la petición
53+
cancel();
54+
```
55+
56+
> Nota: puedes cancelar varias peticiones con el mismo token de cancelación.

‎posts/es/config_defaults.md

+50
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,50 @@
1+
---
2+
title: 'Configuraciones por Defecto'
3+
prev_title: 'Esquema de Respuesta'
4+
prev_link: '/es/docs/res_schema'
5+
next_title: 'Interceptores'
6+
next_link: '/es/docs/interceptors'
7+
---
8+
9+
## Configuraciones por Defecto
10+
11+
Puedes especificar configuraciones por defecto que serán aplicadas a cada petición.
12+
13+
### Valores globales predeterminados de axios
14+
15+
```js
16+
axios.defaults.baseURL = 'https://api.example.com';
17+
axios.defaults.headers.common['Authorization'] = AUTH_TOKEN;
18+
axios.defaults.headers.post['Content-Type'] = 'application/x-www-form-urlencoded';
19+
```
20+
21+
### Valores predeterminados de instancias personalizadas
22+
23+
```js
24+
// Establecer configuraciones por defecto al crear la instancia
25+
const instance = axios.create({
26+
baseURL: 'https://api.example.com'
27+
});
28+
29+
// Modificar valores por defecto después que una instancia ha sido creada
30+
instance.defaults.headers.common['Authorization'] = AUTH_TOKEN;
31+
```
32+
33+
### Configurar orden de precedencia
34+
35+
La configuración será combinada en orden de precedencia. El orden es: valores predeterminados de la biblioteca que se encuentran en [lib/defaults.js](https://github.com/axios/axios/blob/master/lib/defaults.js#L28), luego la propiedad `defaults` de la instancia, y finalmente el argumento `config` de la petición. Este último tendrá prioridad sobre el primero. Aquí hay un ejemplo.
36+
37+
```js
38+
// Crear una instancia usando la configuración por defecto proveída por la librería
39+
// En este punto el valor del tiempo de espera es `0`, ya que es el valor predeterminado de la librería.
40+
const instance = axios.create();
41+
42+
// Sobrescribir el tiempo de espera predeterminado para la librería
43+
// Ahora todas las peticiones que usen esta instancia esperaran 2.5 segundos antes de ser canceladas
44+
instance.defaults.timeout = 2500;
45+
46+
// Sobrescribir el tiempo máximo de espera cuando se sabe que la petición tomara mucho tiempo
47+
instance.get('/longRequest', {
48+
timeout: 5000
49+
});
50+
```

‎posts/es/example.md

+68
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,68 @@
1+
---
2+
title: 'Ejemplo Mínimo'
3+
description: 'Un ejemplo pequeño de como usar Axios'
4+
prev_title: 'Introducción'
5+
prev_link: '/es/docs/intro'
6+
next_title: 'Petición POST'
7+
next_link: '/es/docs/post_example'
8+
---
9+
10+
## nota: Uso de CommonJS
11+
Para aprovechar la tipificación de TypeScript (para intellisense / autocompletado) usa el próximo enfoque al utilizar los imports de CommonJS con `require()`:
12+
13+
```js
14+
const axios = require('axios').default;
15+
16+
// axios.<method> proveerá autocompletado y tipificación de parámetros
17+
```
18+
19+
# Ejemplo
20+
21+
Ejecutado una petición `GET`
22+
23+
```js
24+
const axios = require('axios');
25+
26+
// Hacer una petición para un usuario con ID especifico
27+
axios.get('/user?ID=12345')
28+
.then(function (response) {
29+
// manejar respuesta exitosa
30+
console.log(response);
31+
})
32+
.catch(function (error) {
33+
// manejar error
34+
console.log(error);
35+
})
36+
.then(function () {
37+
// siempre sera executado
38+
});
39+
40+
// Opcionalmente, la solicitud anterior también se puede realizar como
41+
axios.get('/user', {
42+
params: {
43+
ID: 12345
44+
}
45+
})
46+
.then(function (response) {
47+
console.log(response);
48+
})
49+
.catch(function (error) {
50+
console.log(error);
51+
})
52+
.then(function () {
53+
// siempre sera ejecutado
54+
});
55+
56+
// ¿Quieres usar async/await? Añade la palabra reservada `async` a tu función/método externo.
57+
async function getUser() {
58+
try {
59+
const response = await axios.get('/user?ID=12345');
60+
console.log(response);
61+
} catch (error) {
62+
console.error(error);
63+
}
64+
}
65+
```
66+
67+
> **NOTA:** `async/await` es parte de ECMAScript 2017 y no es soportado por Internet
68+
> Explorer y otros navegadores antiguos, a si que usalo con cuidado.

0 commit comments

Comments
 (0)