[Added] add Japanese translation (locale: ja) (axios#74)

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

Author: juggernautjp

inert.config.js

@@ -27,6 +27,7 @@ const krConfig = require("./kr.lang.js");
 const viConfig = require("./vi.lang.js");
 const faConfig = require("./fa.lang.js");
 const ruConfig = require("./ru.lang.js");
+const jaConfig = require("./ja.lang.js");
 
 // List of languages
 const langs = [
@@ -108,6 +109,12 @@ const langs = [
     name: "Русский",
     prefix: "/ru/",
     config: ruConfig
+  },
+  {
+    dir: "ltr",
+    name: "日本語",
+    prefix: "/ja/",
+    config: jaConfig
   }
 ];
 

ja.lang.js

@@ -0,0 +1,142 @@
+/**
+ * Configuration for the Japanese (ja) translation
+ */
+
+module.exports = {
+  // Language display name. MUST BE THE SAME AS IN [inert.config.js].custom.langs
+  display: "日本語",
+  prefix: "/ja/",
+  dir: "ltr",
+  lang: "ja",
+  // `p` stands for `paragraph`. This will contain translations of full text blocks
+  p: {
+    headline: "ブラウザと Node.js のための Promise ベースの HTTP クライアント",
+    subhead: `Axios は、ブラウザと Node.js のための、シンプルなプロミスベースの HTTP クライアントです。
+              Axios は、非常に拡張性の高いインターフェイスを持つ小さなパッケージで、
+              シンプルに使えるライブラリを提供します。`,
+  },
+  // `t` stands fot `translation`. This will contain translations of single words or phrases
+  t: {
+    "Get Started": 'Axios 入門',
+    "View on GitHub": 'GitHub で表示',
+    "Languages": '言語',
+    "Open Source": 'オープンソース',
+    "Contribute": 'コントリビュート (貢献)',
+    "Source on GitHub": 'GitHub 上のソース',
+    "Issues": 'イシュー',
+    "Pull Requests": 'プルリクエスト',
+    "Code of Conduct": '行動規範',
+    "Fork on GitHub": 'GitHub でのフォーク',
+    "Fork the Website": 'Web サイトをフォークする',
+    "Create an Issue": 'イシューを作成する',
+    "Next": '次へ',
+    "Previous": '前へ',
+    "Website Copy Right Footer": 'Web サイトの著作権フッター',
+    "View On Github": 'GitHub で表示',
+    "Axios Project Copy Right Footer": 'Axios プロジェクトの著作権フッター',
+    "License Label Footer": 'ライセンスラベル フッター'
+  },
+  sidebar: [
+    {
+      type: "heading",
+      text: "Axiom 入門",
+    },
+    {
+      type: "link",
+      href: "/docs/intro",
+      text: "Axiom 入門",
+    },
+    {
+      type: "link",
+      href: "/docs/example",
+      text: "使用例",
+    },
+    {
+      type: "link",
+      href: "/docs/post_example",
+      text: "POST リクエスト",
+    },
+    {
+      type: "heading",
+      text: "Axios API",
+    },
+    {
+      type: "link",
+      href: "/docs/api_intro",
+      text: "Axios API",
+    },
+    {
+      type: "link",
+      href: "/docs/instance",
+      text: "Axios インスタンス",
+    },
+    {
+      type: "link",
+      href: "/docs/req_config",
+      text: "リクエスト設定",
+    },
+    {
+      type: "link",
+      href: "/docs/res_schema",
+      text: "レスポンス スキーマ",
+    },
+    {
+      type: "link",
+      href: "/docs/config_defaults",
+      text: "デフォルト設定",
+    },
+    {
+      type: "link",
+      href: "/docs/interceptors",
+      text: "インターセプター",
+    },
+    {
+      type: "link",
+      href: "/docs/handling_errors",
+      text: "エラー処理",
+    },
+    {
+      type: "link",
+      href: "/docs/cancellation",
+      text: "キャンセル",
+    },
+    {
+      type: "link",
+      href: "/docs/urlencoded",
+      text: "URL-エンコードボディ",
+    },
+    {
+      type: "heading",
+      text: "その他",
+    },
+    {
+      type: "link",
+      href: "/docs/notes",
+      text: "特記事項",
+    },
+    {
+      type: "heading",
+      text: "コントリビューター",
+    },
+    {
+      type: "link",
+      href: "https://github.com/axios/axios/blob/master/CODE_OF_CONDUCT.md",
+      text: "行動規範",
+    },
+    {
+      type: "link",
+      href: "https://github.com/axios/axios/blob/master/COLLABORATOR_GUIDE.md",
+      text: "コントリビューター ガイド",
+    },
+    {
+      type: "link",
+      href: "https://github.com/axios/axios/blob/master/CONTRIBUTING.md",
+      text: "Axios に貢献する"
+    },
+    {
+      type: "link",
+      href: "/docs/translating",
+      text: "このドキュメントを翻訳する"
+    }
+  ],
+};

posts/ja/api_intro.md

@@ -0,0 +1,60 @@
+---
+title: 'Axios API'
+description: 'Axios API リファレンス'
+prev_title: 'POST リクエスト'
+prev_link: '/docs/post_example'
+next_title: 'Axios インスタンス'
+next_link: '/docs/instance'
+---
+
+関連する設定を `axios` に渡すことでリクエストを行うことができます。
+
+##### axios(config)
+
+```js
+// POST リクエストを送信する
+axios({
+  method: 'post',
+  url: '/user/12345',
+  data: {
+    firstName: 'Fred',
+    lastName: 'Flintstone'
+  }
+});
+```
+
+```js
+// Node.js でのリモート画像を GET リクエスト
+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
+// GET リクエストの送信（デフォルト メソッド）
+axios('/user/12345');
+```
+
+### リクエスト メソッドのエイリアス
+
+使いやすいように、サポートされているすべてのリクエスト メソッドにエイリアスが提供されています。
+
+##### 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]])
+
+###### 注
+
+エイリアス メソッドを使用する場合、`url`、` method`、および `data` プロパティを設定で指定する必要はありません。

posts/ja/cancellation.md

@@ -0,0 +1,107 @@
+---
+title: 'Cancellation'
+prev_title: 'Handling Errors'
+prev_link: '/docs/handling_errors'
+next_title: 'URL-Encoding Bodies'
+next_link: '/docs/urlencoded'
+---
+
+## AbortController
+
+Starting from `v0.22.0` Axios supports [`AbortController`](https://developer.mozilla.org/en-US/docs/Web/API/AbortController) to cancel requests in fetch API way:
+
+```js
+const controller = new AbortController();
+
+axios.get('/foo/bar', {
+   signal: controller.signal
+}).then(function(response) {
+   //...
+});
+// cancel the request
+controller.abort()
+```
+
+## CancelToken `deprecated`
+
+You can also cancel a request using a *CancelToken*. 
+
+> The axios cancel token API is based on the withdrawn [cancelable promises proposal](https://github.com/tc39/proposal-cancelable-promises).
+
+> This API is deprecated since `v0.22.0` and shouldn't be used in new projects
+
+You can create a cancel token using the `CancelToken.source` factory as shown below:
+
+```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 canceled', thrown.message);
+  } else {
+    // handle error
+  }
+});
+
+axios.post('/user/12345', {
+  name: 'new name'
+}, {
+  cancelToken: source.token
+})
+
+// cancel the request (the message parameter is optional)
+source.cancel('Operation canceled by the user.');
+```
+
+You can also create a cancel token by passing an executor function to the `CancelToken` constructor:
+
+```js
+const CancelToken = axios.CancelToken;
+let cancel;
+
+axios.get('/user/12345', {
+  cancelToken: new CancelToken(function executor(c) {
+    // An executor function receives a cancel function as a parameter
+    cancel = c;
+  })
+});
+
+// cancel the request
+cancel();
+```
+
+> Note: you can cancel several requests with the same cancel token / signal.
+
+During the transition period, you can use both cancellation APIs, even for the same request:
+
+```js
+const controller = new AbortController();
+
+const CancelToken = axios.CancelToken;
+const source = CancelToken.source();
+
+axios.get('/user/12345', {
+  cancelToken: source.token,
+  signal: controller.signal
+}).catch(function (thrown) {
+  if (axios.isCancel(thrown)) {
+    console.log('Request canceled', thrown.message);
+  } else {
+    // handle error
+  }
+});
+
+axios.post('/user/12345', {
+  name: 'new name'
+}, {
+  cancelToken: source.token
+})
+
+// cancel the request (the message parameter is optional)
+source.cancel('Operation canceled by the user.');
+// OR
+controller.abort(); // the message parameter is not supported
+```

posts/ja/config_defaults.md

@@ -0,0 +1,50 @@
+---
+title: 'デフォルト設定'
+prev_title: 'レスポンス スキーマ'
+prev_link: '/docs/res_schema'
+next_title: 'インターセプター'
+next_link: '/docs/interceptors'
+---
+
+## デフォルト設定
+
+すべてのリクエストに適用されるデフォルト設定を指定できます。
+
+### グローバル Axios のデフォルト
+
+```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';
+```
+
+### カスタム インスタンスのデフォルト
+
+```js
+// インスタンスの作成時にデフォルト設定を指定する
+const instance = axios.create({
+  baseURL: 'https://api.example.com'
+});
+
+// インスタンスの作成後にデフォルト設定を変更する
+instance.defaults.headers.common['Authorization'] = AUTH_TOKEN;
+```
+
+### 設定の優先順位
+
+設定は、優先順位をつけてマージされます。その順番は [lib/defaults.js](https://github.com/axios/axios/blob/master/lib/defaults.js#L28) にあるライブラリのデフォルト、そしてインスタンスの `defaults` プロパティ、最後にリクエストの `config` 引数の順になります。後者が前者よりも優先されます。以下はその例です。
+
+```js
+// ライブラリが提供するデフォルトの設定を使用してインスタンスを作成します。
+// この時点では、タイムアウトの設定値はライブラリのデフォルトである `0` になっています。
+const instance = axios.create();
+
+// ライブラリのデフォルトのタイムアウトを上書きします。
+// これで、このインスタンスを使用するすべてのリクエストは、タイムアウトする前に 2.5秒待機します。
+instance.defaults.timeout = 2500;
+
+// 時間がかかることがわかっているため、このリクエストのタイムアウトをオーバーライドします。
+instance.get('/longRequest', {
+  timeout: 5000
+});
+```