Added Persian translation (axios#54)

* Add Persian language

* Persian translation

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

Author: RezaAb

fa.lang.js

@@ -0,0 +1,139 @@
+/**
+ * Configuration for the Persian translation
+ * پیکربندی ترجمه فارسی 
+ */
+
+module.exports = {
+  // Language display name. MUST BE THE SAME AS IN [inert.config.js].custom.langs
+  display: "فارسی",
+  prefix: "/fa/",
+  dir: "rtl",
+  lang: "fa",
+  // `p` stands for `paragraph`. This will contain translations of full text blocks
+  p: {
+    headline: "سرویس گیرنده HTTP مبتنی بر پرامیس (Promise) برای مرورگر و node.js ",
+    subhead: `Axios یک سرویس گیرنده HTTP مبتنی بر پرامیس (Promise) برای مرورگر و node.js می باشد.
+				Axios یک کتابخانه ساده حتی برای استفاده در یک بسته کوچک با رابط کاربری بسیار گسترده ارائه شده است.`,
+  },
+  // `t` stands fot `translation`. This will contain translations of single words or phrases
+  t: {
+    "Get Started": "شروع کنید",
+    "View on GitHub": "مشاهده در GitHub",
+    "Languages": "زبان ها",
+    "Open Source": "متن باز",
+    "Contribute": "مشارکت",
+    "Source on GitHub": "منبع در GitHub",
+    "Fork on GitHub": "فورک در GitHub",
+    "Fork the Website": "فورک وب سایت",
+    "Create an Issue": "ایجاد یک مسئله",
+    "Next": "بعدی",
+    "Previous": "قبلی",
+    "Website Copy Right Footer": "پاورقی حق چاپ و استفاده وب سایت",
+    "View On Github": "مشاهده در Github",
+    "Axios Project Copy Right Footer": "پاورقی حق استفاده از پروژه Axios",
+    "License Label Footer": "پاورقی برچسب مجوز"
+  },
+  sidebar: [
+    {
+      type: "heading",
+      text: "شروع به کار",
+    },
+    {
+      type: "link",
+      href: "/docs/intro",
+      text: "مقدمه",
+    },
+    {
+      type: "link",
+      href: "/docs/example",
+      text: "مثال",
+    },
+    {
+      type: "link",
+      href: "/docs/post_example",
+      text: "درخواست های ارسال",
+    },
+    {
+      type: "heading",
+      text: "رابط های برنامه‌نویسی پروژه",
+    },
+    {
+      type: "link",
+      href: "/docs/api_intro",
+      text: "APIهای پروژه Axios",
+    },
+    {
+      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-Encoding)",
+    },
+    {
+      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: "ترجمه این اسناد"
+    }
+  ],
+};

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 faConfig = require("./fa.lang.js");
 
 // List of languages
 const langs = [
@@ -81,6 +82,12 @@ const langs = [
     prefix: "/kr/",
     config: krConfig,
   },
+  {
+    dir: "rtl",
+    name: "فارسی",
+    prefix: "/fa/",
+    config: faConfig,
+  },
 ];
 
 /**

posts/fa/api_intro.md

@@ -0,0 +1,59 @@
+---
+title: 'APIهای پروژه Axios'
+description: 'مرجع APIهای پروژه Axios'
+prev_title: 'درخواست های ارسال'
+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
+// درخواستی از نوع GET برای گرفتن یک عکس از مکانی دیگر در 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
+// ارسال درخواستی از نوع 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/fa/cancellation.md

@@ -0,0 +1,56 @@
+---
+title: 'لغو درخواست'
+prev_title: 'مدیریت خطاها'
+prev_link: '/docs/handling_errors'
+next_title: 'بدنه های رمزگذاری آدرس (URL-Encoding)'
+next_link: '/docs/urlencoded'
+---
+
+با یک *توکن لغو* (cancel token) می توانید درخواستی را لغو کنید. 
+
+> API توکن لغو Axios بر اساس "withdrawn " نوشته شده است [پیشنهادی برای پرامیس های قابل لغو](https://github.com/tc39/proposal-cancelable-promises).
+
+مانند روش زیر می توانید با استفاده از `CancelToken.source` یک توکن لغو ایجاد کنید: 
+
+```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('درخواست لغو شد', thrown.message);
+  } else {
+    // مدیریت خطا
+  }
+});
+
+axios.post('/user/12345', {
+  name: 'نام جدید'
+}, {
+  cancelToken: source.token
+})
+
+// لغو درخواست (پارامتر پیام اختیاری است) 
+source.cancel('عملیات توسط کاربر لغو شد');
+```
+
+همچنین می توانید با ایجاد یک تابع اجرایی که به تابع سازنده کلاس `CancelToken` می دهید، یک توکن لغو ایجاد کنید: 
+
+```js
+const CancelToken = axios.CancelToken;
+let cancel;
+
+axios.get('/user/12345', {
+  cancelToken: new CancelToken(function executor(c) {
+    // تابع مجری یک متغیر را به عنوان پارامتر دریافت می کند که همان تابع لغو است که در اینجا به متغیری که تعریف کرده ایم، اجراع می دهیم.
+    cancel = c;
+  })
+});
+
+// لغو درخواست
+cancel();
+```
+
+> Note: you can cancel several requests with the same cancel token.

posts/fa/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
+// با استفاده از تنظیمات پیش فرض پیکربندی ارائه شده توسط کتابخانه ، یک نمونه ایجاد کنید 
+// در این مرحله مقدار timeout به صورت پیش فرض `0` است 
+const instance = axios.create();
+
+// تغییر مقدار پیش فرض timeout
+// حالا تمام درخواست هایی که از این نمونه استفاده می کنند، تا حداکثر 2.5 ثانیه برای اجرای درخواست صبر می کنند
+instance.defaults.timeout = 2500;
+
+// تغییر دوباره زمان انتظار اجرای درخواست، اگر انتظار داریم که مدت زمان زیادی برای اجرای درخواست طول می کشد
+instance.get('/longRequest', {
+  timeout: 5000
+});
+```

posts/fa/example.md

@@ -0,0 +1,68 @@
+---
+title: 'یک مثال کوچک'
+description: 'یک مثال کوچک در استفاده از axios'
+prev_title: 'مقدمه'
+prev_link: '/docs/intro'
+next_title: 'درخواست های ارسال از نوع POST'
+next_link: '/docs/post_example'
+---
+
+## نکته: استفاده از کد معمول
+برای استفاده از قابلیت های (intellisense / autocomplete) در TypeScript، حین استفاده از «require» به صورت زیر استفاده کنید: 
+
+```js
+const axios = require('axios').default;
+
+// حالا با تایپ axios.<method> لیست توابع این کتابخانه نمایش داده می شود
+```
+
+# مثال
+
+انجام درخواست `GET` 
+
+```js
+const axios = require('axios');
+
+// ایجاد درخواست برای یک کاربر با آی دی مشخص
+axios.get('/user?ID=12345')
+  .then(function (response) {
+    // مدیریت پاسخ در زمان موفق بودن درخواست
+    console.log(response);
+  })
+  .catch(function (error) {
+    // مدیریت خطا
+    console.log(error);
+  })
+  .then(function () {
+    // این قسمت همیشه اجرا می شود
+  });
+
+// درخواست بالا را به صورت زیر هم میتوان نوشت
+axios.get('/user', {
+    params: {
+      ID: 12345
+    }
+  })
+  .then(function (response) {
+    console.log(response);
+  })
+  .catch(function (error) {
+    console.log(error);
+  })
+  .then(function () {
+    // این قسمت همیشه اجرا می شود
+  });  
+
+// اگر میخواهید از async/await? استفاده کنید، کلمه `async` را در ابتدای تعریف تابع اضافه کنید.
+async function getUser() {
+  try {
+    const response = await axios.get('/user?ID=12345');
+    console.log(response);
+  } catch (error) {
+    console.error(error);
+  }
+}
+```
+
+> **نکته:** `async/await` جزوی از روش ECMAScript 2017 است و در اینترنت اکسپلورر یا همان IE و مرورگرهای قدیمی پشتیبانی نمی شود.
+> پس با احتیاط لازم استفاده کنید.