Init Persian localization - Part 1

Author: xirehat

OWNERS_ALIASES

@@ -223,6 +223,16 @@ aliases:
     - Arhell
     - idvoretskyi
     - MaxymVlasov
+  sig-docs-fa-owners: # Admins for Persian content
+    - behiuu
+    - mamrezb
+    - moh0ps
+    - xirehat
+  sig-docs-fa-reviews: # PR reviews for Persian content
+    - behiuu
+    - mamrezb
+    - moh0ps
+    - xirehat
   # authoritative source: git.k8s.io/community/OWNERS_ALIASES
   committee-steering: # provide PR approvals for announcements
     - aojea

README.md

@@ -221,14 +221,14 @@ If you need help at any point when contributing, the [New Contributor Ambassador
 
 | Language                   | Language                   |
 | -------------------------- | -------------------------- |
-| [Bengali](./content/bn/README.md)    | [Korean](./content/ko/README.md)    |
-| [Chinese](./content/zh-cn/README.md)    | [Polish](./content/pl/README.md)    |
-| [French](./content/fr/README.md)     | [Portuguese](./content/pt-br/README.md)    |
-| [German](./content/de/README.md)     | [Russian](./content/ru/README.md)    |
-| [Hindi](./content/hi/README.md)      | [Spanish](./content/es/README.md)    |
-| [Indonesian](./content/id/README.md) | [Ukrainian](./content/uk/README.md) |
-| [Italian](./content/it/README.md)    | [Vietnamese](./content/vi/README.md) |
-| [Japanese](./content/ja/README.md)   | |
+| [Bengali](./content/bn/README.md)       | [Korean](./content/ko/README.md)         |
+| [Chinese](./content/zh-cn/README.md)    | [Persian](./content/fa/README.md)        |
+| [French](./content/fr/README.md)        | [Polish](./content/pl/README.md)         |
+| [German](./content/de/README.md)        | [Portuguese](./content/pt-br/README.md)  |
+| [Hindi](./content/hi/README.md)         | [Russian](./content/ru/README.md)        |
+| [Indonesian](./content/id/README.md)    | [Spanish](./content/es/README.md)        |
+| [Italian](./content/it/README.md)       | [Ukrainian](./content/uk/README.md)      |
+| [Japanese](./content/ja/README.md)      | [Vietnamese](./content/vi/README.md)     |
 
 ## Code of conduct
 

content/fa/OWNERS

@@ -0,0 +1,14 @@
+# See the OWNERS docs at https://go.k8s.io/owners
+
+# This is the localization project for Persian.
+# Teams and members are visible at https://github.com/orgs/kubernetes/teams.
+
+reviewers:
+- sig-docs-fa-reviews
+
+approvers:
+- sig-docs-fa-owners
+
+labels:
+- area/localization
+- language/fa

content/fa/README.md

@@ -0,0 +1,133 @@
+‫
+# مستندات فارسی کوبرنتیز
+
+‫
+[![Netlify Status](https://api.netlify.com/api/v1/badges/be93b718-a6df-402a-b4a4-855ba186c97d/deploy-status)](https://app.netlify.com/sites/kubernetes-io-main-staging/deploys) [![GitHub release](https://img.shields.io/github/release/kubernetes/website.svg)](https://github.com/kubernetes/website/releases/latest)
+
+
+‫
+خوش آمدید! این مخزن شامل محتویات لازم برای ساخت [تارنما کوبرنتیز فارسی و مستندات](https://kubernetes.io/fa/) آن است. خوشحال می‌شویم که در این مسیر با مشارکت کردن ما را همراهی کنید. 
+
+‫
+## نحوه مشارکت کردن در مستندسازی
+
+‫
+شما می‌توانید روی دکمه‌ی **Fork** در گوشه‌ی سمت راست بالای صفحه کلیک کنید تا یک رونوشت از این مخزن در حساب گیت‌هاب خود ایجاد کنید. این رونوشت *fork* نامیده می‌شود. تغییرات دلخواه را در fork خود اعمال کنید. وقتی آماده‌ی ارسال آن تغییرات به ما شدید، به fork خود بروید و یک درخواست ادغام جدید ایجاد کنید و به ما اطلاع دهید.
+
+‫
+پس از ایجاد درخواست ادغام از سمت شما، فرد بررسی‌کننده تیم مستندات فارسی کوبرنتیز مسئولیت ارائه بازخورد و بررسی درخواست شما را بر عهده می‌گیرد. به عنوان صاحب درخواست ادغام، مسئولیت اصلاح درخواست ادغام بر اساس بازخوردی که از بررسی‌کننده  تیم مستندات فارسی کوبرنتیز دریافت می‌کنید، بر عهده شماست. همچنین، توجه داشته باشید که ممکن است در نهایت بیش از یک بررسی‌کننده بازخورد ارائه دهند، یا ممکن است از فرد بررسی‌کننده جدید و متفاوت از کسی که در ابتدا برای ارائه بازخورد تعیین شده بود، بازخورد دریافت کنید. در برخی موارد، در صورت نیاز، یکی از بررسی‌کنندگان شما ممکن است از یک [بررسی‌کننده فنی کوبرنتیز](https://github.com/kubernetes/website/wiki/tech-reviewers) درخواست بررسی فنی کند. بررسی‌کنندگان تمام تلاش خود را می‌کنند تا بازخوردها را به موقع ارائه دهند، اما زمان پاسخگویی بسته به شرایط ممکن است متفاوت باشد.
+
+‫
+برای اطلاعات بیشتر در مورد مشارکت در مستندسازی کوبرنتیز به فارسی به لینک‌های زیر مراجعه کنید:
+
+‫
+* [شروع مشارکت](https://kubernetes.io/fa/docs/contribute/start/)
+‫
+* [انواع محتوای صفحه](https://kubernetes.io/fa/docs/contribute/style/page-content-types/)
+‫
+* [راهنمای سبک مستندسازی](https://kubernetes.io/fa/docs/contribute/style/style-guide/)
+‫
+* [بومی‌سازی مستندات کوبرنتیز](https://kubernetes.io/fa/docs/contribute/localization/)
+
+‫
+## مستندات بومی‌سازی کوبرنتیز در `README.md`
+
+‫
+### فارسی
+‫
+با تیم بومی سازی فارسی می‌توان از طریق آدرس‌های زیر در ارتباط باشید:
+‫
+* محمدامین طاهری ([@xirehat](https://github.com/xirehat))
+‫
+* محمد زارعی ([@moh0ps](https://github.com/moh0ps))
+‫
+* به‌دین طالبی ([@behiuu](https://github.com/behiuu))
+‫
+* محمدرضا بهفر ([@mamrezb](https://github.com/mamrezb))
+‫
+* [کانال Slack](https://kubernetes.slack.com/messages/kubernetes-docs-fa)
+
+‫
+## اجرای تارنما با Docker
+
+‫
+برای اجرای تارنما کوبرنتیز، توصیه می‌شود آن را با [Docker](https://docker.com) اجرا کنید که شامل مولد تارنما استاتیک [Hugo](https://gohugo.io) باشد.
+
+‫
+> در ویندوز، به ابزارهای اضافی نیاز دارید که می‌توانید با [Chocolatey] (https://chocolatey.org) نصب کنید.
+`choco install make`
+
+‫
+> اگر ترجیح می‌دهید تارنما را بدون داکر اجرا کنید، به [اجرای تارنما با هوگو](#اجرای-تارنما-با-هوگو) مراجعه کنید.
+
+‫
+قالب مورد نیاز [Docsy Hugo theme](https://github.com/google/docsy#readme) باید به عنوان یک زیرماژول git نصب شود:
+
+```
+git submodule update --init --recursive --depth 1
+```
+
+‫
+اگر داکر را نصب کرده‌اید، image داکر `hugo` را ایجاد کنید:
+
+```bash
+make container-image
+```
+
+‫
+پس از ایجاد image، می‌توانید تارنما را راه اندازی کنید:
+
+```bash
+make container-serve
+```
+
+‫
+برای مشاهده تارنما، مرورگر خود را با نشانی http://localhost:1313 باز کنید. وقتی تغییراتی در پرونده‌های منبع ایجاد می‌کنید، Hugo تارنما را به‌روزرسانی کرده و مرورگر را مجبور به فراخوانی مجدد می‌کند.
+
+‫
+## اجرای تارنما با هوگو
+
+‫
+دستورالعمل‌های نصب Hugo را می‌توانید در [مستندات رسمی](https://gohugo.io/installation/) بیابید. مطمئن شوید که نسخه Hugo مشخص شده در متغیر محیطی `HUGO_VERSION` در فایل `netlify.toml` را نصب می‌کنید.
+
+‫
+قالب مورد نیاز [Docsy Hugo theme](https://github.com/google/docsy#readme) باید به عنوان یک زیرماژول git نصب شود:
+
+```
+git submodule update --init --recursive --depth 1
+```
+
+‫
+برای اجرای تارنما در صورتی که Hugo را نصب کرده‌اید:
+
+```bash
+npm ci
+make serve
+```
+
+‫
+برای مشاهده تارنما، مرورگر خود را با نشانی http://localhost:1313 باز کنید. وقتی تغییراتی در پرونده‌های منبع ایجاد می‌کنید، Hugo تارنما را به‌روزرسانی کرده و مرورگر را مجبور به فراخوانی مجدد می‌کند.
+
+‫
+## جامعه، بحث، مشارکت و حمایت
+
+‫
+برای آشنایی با نحوه تعامل با انجمن کوبرنتیز به [صفحه انجمن](https://kubernetes.io/community/) مراجعه کنید.
+
+‫
+برای ارتباط با سرپرستان این پروژه می‌توانید از طریق نشانی زیر اقدام کنید:
+
+- [Slack](https://kubernetes.slack.com/messages/sig-docs)
+- [Mailing List](https://groups.google.com/forum/#!forum/kubernetes-sig-docs)
+
+‫
+### قوانین رفتاری
+
+‫
+مشارکت در جامعه کوبرنتیز تابع [قوانین رفتاری کوبرنتیز](https://github.com/kubernetes/website/blob/main/code-of-conduct.md) است.
+
+‫
+## سپاس گزاریم
+
+‫
+کوبرنتیز با مشارکت جامعه رونق می‌گیرد و ما از مشارکت‌های شما در تارنما و مستندات کوبرنتیز فارسی استقبال می‌کنیم. دمتون گرم!