add vietnamese translation (axios#55)

remove old font-family, let the browser decide
fix a bug in inert.config.js
add the ability to use a custom main title and custom sans font for any translations

Co-authored-by: Jay <[email protected]>

Author: Meigyoku-Thmn

README.md

@@ -3,20 +3,20 @@
 [![Netlify Status](https://api.netlify.com/api/v1/badges/09768f21-08e2-487b-8c7a-7fb084bbf99d/deploy-status)](https://app.netlify.com/sites/axios-docs/deploys)
  [![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-2.0-4baaaa.svg)](code_of_conduct.md)
 
-The documentation page was built using [`inert static site generator`](https://github.com/codemaster138/inert). It works like this: inside the `docs` folder, there is a folder named `_src` (because GitHub automatically hides all files and folders starting with `_` from viewers on GitHub Pages). Inside this folder, there are some configuration, templates, styles, and, most importantly, in the `posts` folder, multiple markdown files containing the documentation.
+The documentation page was built using [`inert static site generator`](https://github.com/codemaster138/inert). It works like this: Inside the root folder, there are some configuration, templates, styles, and, most importantly, in the `posts` folder, multiple markdown files containing the documentation.
 
 To compile the documentation page, one must first install the inert CLI:
 
 ```bash
 npm i -g inert-cli # yarn global add inert-cli
 ```
 
-Now, open a terminal, navigate into the folder `docs/_src` and run the following command:
+Now, open a terminal and run the following command:
 
 ```bash
 inert build
 ```
 
-Inert will convert the markdown files into HTML, insert them into the templates, compile the `SCSS` styles and write the output into the `docs` directory.
+Inert will convert the markdown files into HTML, insert them into the templates, compile the `SCSS` styles and write the output into the `public` directory.
 
 This website was generously created by [@codemaster138](https://github.com/codemaster138)

inert.config.js

@@ -23,6 +23,7 @@ const kuConfig = require("./ku.lang.js");
 const esConfig = require('./es.lang.js');
 const trConfig = require("./tr.lang.js");
 const krConfig = require("./kr.lang.js");
+const viConfig = require("./vi.lang.js");
 const faConfig = require("./fa.lang.js");
 
 // List of languages
@@ -82,6 +83,12 @@ const langs = [
     prefix: "/kr/",
     config: krConfig,
   },
+  {
+    dir: "ltr",
+    name: "Tiếng Việt",
+    prefix: "/vi/",
+    config: viConfig,
+  },
   {
     dir: "rtl",
     name: "فارسی",
@@ -208,7 +215,10 @@ module.exports = {
       ...langs
         .map((lang) => [
           singleHTMLBuild(lang.config),
-          writeFile(`:${lang.prefix === '/' ? 'output:/index.html' : lang.prefix.slice(1, -1)}Output:/index.html`),
+          writeFile(lang.prefix === '/'
+            ? ':output:/index.html'
+            : `:${lang.prefix.slice(1, -1)}Output:/index.html`
+          ),
         ])
         .flat(),
     ],

posts/vi/api_intro.md

@@ -0,0 +1,58 @@
+---
+title: 'Axios API'
+description: 'Bản tham khảo Axios API'
+prev_title: 'POST Request'
+prev_link: '/vi/docs/post_example'
+next_title: 'Axios Instance'
+next_link: '/vi/docs/instance'
+---
+
+Có thể truyền cấu hình có liên quan vào `axios` để tạo ra request.
+
+##### axios(config)
+
+```js
+// Gửi một POST request
+axios({
+  method: 'post',
+  url: '/user/12345',
+  data: {
+    lastName: 'Lý'
+    firstName: 'Thường Kiệt',
+  }
+});
+```
+
+```js
+// Truy xuất ảnh từ xa bằng GET request trong node.js
+axios({
+  method: 'get',
+  url: 'http://bit.ly/2mTM3nY',
+  responseType: 'stream'
+})
+  .then(function (response) {
+    response.data.pipe(fs.createWriteStream('ada_lovelace.jpg'))
+  });
+```
+
+##### axios(url[, config])
+
+```js
+// Gửi một GET request (chức năng mặc định)
+axios('/user/12345');
+```
+
+### Alias cho phương thức request
+
+Để cho tiện, thư viện đã cung cấp sẵn alias cho tất cả phương thức request được hỗ trợ.
+
+##### axios.request(config)
+##### axios.get(url[, config])
+##### axios.delete(url[, config])
+##### axios.head(url[, config])
+##### axios.options(url[, config])
+##### axios.post(url[, data[, config]])
+##### axios.put(url[, data[, config]])
+##### axios.patch(url[, data[, config]])
+
+**LƯU Ý:** Khi sử dụng các phương thức alias, các thuộc tính `url`, `method`, và `data` đều không cần phải được chỉ định trong cấu hình.

posts/vi/cancellation.md

@@ -0,0 +1,56 @@
+---
+title: 'Bãi bỏ Request'
+prev_title: 'Xử trí lỗi'
+prev_link: '/vi/docs/handling_errors'
+next_title: 'Phần thân URL-Encoding'
+next_link: '/vi/docs/urlencoded'
+---
+
+Bạn có thể bãi bỏ request bằng cách sử dụng *token bãi bỏ*
+
+> API token bãi bỏ trong axios là dựa trên [đề xuất cancelable promise](https://github.com/tc39/proposal-cancelable-promises) đã bị thu hồi.
+
+Bạn có thể tạo ra một token bãi bỏ bằng cách sử dụng phương thức factory `CancelToken.source` như sau:
+
+```js
+const CancelToken = axios.CancelToken;
+const source = CancelToken.source();
+
+axios.get('/user/12345', {
+  cancelToken: source.token
+}).catch(function (thrown) {
+  if (axios.isCancel(thrown)) {
+    console.log('Request đã được bãi bỏ', thrown.message);
+  } else {
+    // xử trí lỗi
+  }
+});
+
+axios.post('/user/12345', {
+  name: 'tên mới'
+}, {
+  cancelToken: source.token
+})
+
+// bãi bỏ request (tham số message là tùy chọn)
+source.cancel('Thao tác đã được người dùng bãi bỏ.');
+```
+
+Bạn còn có thể tạo ra một token bãi bỏ bằng cách truyền một hàm thực thi vào constructor `CancelToken`:
+
+```js
+const CancelToken = axios.CancelToken;
+let cancel;
+
+axios.get('/user/12345', {
+  cancelToken: new CancelToken(function executor(c) {
+    // Hàm thực thi nhận vào một tham số là hàm bãi bỏ, lưu nó lại
+    cancel = c;
+  })
+});
+
+// bãi bỏ request
+cancel();
+```
+
+> Lưu ý: bạn có thể dùng chung một token bãi bỏ để bãi bỏ nhiều request.

posts/vi/config_defaults.md

@@ -0,0 +1,50 @@
+---
+title: 'Cấu hình Mặc định'
+prev_title: 'Kết cấu Response'
+prev_link: '/vi/docs/res_schema'
+next_title: 'Bộ đón chặn'
+next_link: '/vi/docs/interceptors'
+---
+
+## Cấu hình Mặc định
+
+Bạn có thể chỉ định cấu hình mặc định sẽ được áp dụng cho mọi request.
+
+### Mặc định cho toàn cục
+
+```js
+axios.defaults.baseURL = 'https://api.example.com';
+axios.defaults.headers.common['Authorization'] = AUTH_TOKEN;
+axios.defaults.headers.post['Content-Type'] = 'application/x-www-form-urlencoded';
+```
+
+### Mặc định cho instance tự đặt
+
+```js
+// Đặt cấu hình mặc định lúc tạo ra instance
+const instance = axios.create({
+  baseURL: 'https://api.example.com'
+});
+
+// Sửa đổi cấu hình trị mặc định sau khi tạo ra instance
+instance.defaults.headers.common['Authorization'] = AUTH_TOKEN;
+```
+
+### Thứ tự ưu tiên của cấu hình
+
+Cấu hình sẽ được hợp lại theo thứ tự ưu tiên. Thứ tự lần lượt là mặc định của thư viện được đặt trong [lib/defaults.js](https://github.com/axios/axios/blob/master/lib/defaults.js#L28), tiếp đến là thuộc tính `defaults` của instance, rồi cuối cùng là đối số `config` cho request. Cái đi sau sẽ được ưu tiên hơn cái đi trước. Sau đây là một ví dụ.
+
+```js
+// Tạo ra một instance dùng cấu hình mặc định do thư viện cung cấp
+// Tại thời điểm này giá trị cấu hình timeout là `0` giống như trong mặc định của thư viện
+const instance = axios.create();
+
+// Override giá trị timeout mặc định của thư viện
+// Giờ tất cả request mà dùng instance này thì sẽ chờ 2,5 giây trước khi tính hết thời gian
+instance.defaults.timeout = 2500;
+
+// Override giá trị timeout cho riêng request này vì ta biết trước là nó tốn thời gian dài
+instance.get('/request-lâu', {
+  timeout: 5000
+});
+```

posts/vi/example.md

@@ -0,0 +1,67 @@
+---
+title: 'Ví dụ cơ bản'
+description: 'Ví dụ nhỏ về cách sử dụng Axios'
+prev_title: 'Giới thiệu'
+prev_link: '/vi/docs/intro'
+next_title: 'POST Request'
+next_link: '/vi/docs/post_example'
+---
+
+## Lưu ý: Cách dùng với CommonJS
+Để có được định nghĩa kiểu dữ liệu TypeScript (cho intellisense / autocomplete) trong khi sử dụng phép import của CommonJS (tức `require()`), hãy sử dụng phương pháp sau đây:
+
+```js
+const axios = require('axios').default;
+
+// Giờ axios.<phương thức> sẽ cung cấp autocomplete và định nghĩa kiểu dữ liệu tham số
+```
+
+# Ví dụ
+
+Phát đi một `GET` request
+
+```js
+const axios = require('axios');
+
+// Tạo một request để truy xuất người dùng ứng với ID cho sẵn:
+axios.get('/user?ID=12345')
+  .then(function (response) {
+    // xử trí khi thành công
+    console.log(response);
+  })
+  .catch(function (error) {
+    // xử trí khi bị lỗi
+    console.log(error);
+  })
+  .then(function () {
+    // luôn luôn được thực thi
+  });
+
+// Cái request bên trên cũng có thể được làm bằng cách sau, tùy ý
+axios.get('/user', {
+    params: {
+      ID: 12345
+    }
+  })
+  .then(function (response) {
+    console.log(response);
+  })
+  .catch(function (error) {
+    console.log(error);
+  })
+  .then(function () {
+    // luôn luôn được thực thi
+  });  
+
+// Nếu muốn sử dụng async/await thì viết như sau
+async function getUser() {
+  try {
+    const response = await axios.get('/user?ID=12345');
+    console.log(response);
+  } catch (error) {
+    console.error(error);
+  }
+}
+```
+
+> **LƯU Ý:** `async/await` là một phần của ECMAScript 2017, không được hỗ trợ trong Internet Explorer và những trình duyệt cũ, cho nên khi sử dụng thì phải để ý.

posts/vi/handling_errors.md

@@ -0,0 +1,48 @@
+---
+title: 'Xử trí lỗi'
+prev_title: 'Bộ đón chặn'
+prev_link: '/vi/docs/interceptors'
+next_title: 'Bãi bỏ Request'
+next_link: '/vi/docs/cancellation'
+---
+
+```js
+axios.get('/user/12345')
+  .catch(function (error) {
+    if (error.response) {
+      // Request đã được tạo ra và server đã hồi đáp với một mã trạng thái
+      // nằm ra ngoài tầm 2xx
+      console.log(error.response.data);
+      console.log(error.response.status);
+      console.log(error.response.headers);
+    } else if (error.request) {
+      // Request đã được tạo ra nhưng không nhận được hồi đáp nào
+      // Trong trình duyệt, `error.request` là instance của XMLHttpRequest
+      // còn trong node.js thì nó là instance của http.ClientRequest
+      console.log(error.request);
+    } else {
+      // Điều gì đó đã xảy ra trong bước thiết lập request rồi gây nên lỗi
+      console.log('Lỗi', error.message);
+    }
+    console.log(error.config);
+  });
+```
+
+Sử dụng tùy chọn cấu hình `validateStatus`, bạn có thể định nghĩa mã HTTP nào nên được tính là lỗi để ném ra.
+
+```js
+axios.get('/user/12345', {
+  validateStatus: function (status) {
+    return status < 500; // Chỉ phân giải nếu như mã trạng thái thấp hơn 500
+  }
+})
+```
+
+Sử dụng phương thức `toJSON` để lấy đối tượng có thêm nhiều thông tin hơn về lỗi HTTP.
+
+```js
+axios.get('/user/12345')
+  .catch(function (error) {
+    console.log(error.toJSON());
+  });
+```

posts/vi/instance.md

@@ -0,0 +1,35 @@
+---
+title: 'Axios instance'
+prev_title: 'Axios API'
+prev_link: '/vi/docs/api_intro'
+next_title: 'Cấu hình Request'
+next_link: '/vi/docs/req_config'
+---
+
+### Tạo ra instance
+
+Bạn có thể tạo ra một instance mới của axios bằng cấu hình tự đặt.
+
+##### axios.create([config])
+
+```js
+const instance = axios.create({
+  baseURL: 'https://tên-miền-nào-đó.com/api/',
+  timeout: 1000,
+  headers: {'X-Custom-Header': 'foobar'}
+});
+```
+
+### Phương thức instance
+
+Các phương thức instance sẵn có đều được liệt kê dưới đây. Cấu hình được chỉ định thì sẽ được hợp chung với cấu hình instance.
+
+##### axios#request(config)
+##### axios#get(url[, config])
+##### axios#delete(url[, config])
+##### axios#head(url[, config])
+##### axios#options(url[, config])
+##### axios#post(url[, data[, config]])
+##### axios#put(url[, data[, config]])
+##### axios#patch(url[, data[, config]])
+##### axios#getUri([config])