‫ # مستندات فارسی کوبرنتیز ‫ [![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 خود بروید و یک درخواست ادغام جدید(PR) ایجاد کنید و به ما اطلاع دهید. ‫ پس از ایجاد درخواست ادغام از سمت شما، فرد بررسی‌کننده تیم مستندات فارسی کوبرنتیز مسئولیت ارائه بازخورد و بررسی درخواست شما را بر عهده می‌گیرد. به عنوان صاحب درخواست ادغام، مسئولیت اصلاح درخواست ادغام بر اساس بازخوردی که از بررسی‌کننده تیم مستندات فارسی کوبرنتیز دریافت می‌کنید، بر عهده شماست. همچنین، توجه داشته باشید که ممکن است در نهایت بیش از یک بررسی‌کننده بازخورد ارائه دهند، یا ممکن است از فرد بررسی‌کننده جدید و متفاوت از کسی که در ابتدا برای ارائه بازخورد تعیین شده بود، بازخورد دریافت کنید. در برخی موارد، در صورت نیاز، یکی از بررسی‌کنندگان شما ممکن است از یک [بررسی‌کننده فنی کوبرنتیز](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/) ‫ ## مستندات بومی‌سازی کوبرنتیز ‫ ### فارسی ‫ با تیم بومی سازی فارسی می‌توانید از طریق نشانی های زیر در ارتباط باشید: ‫ * محمدامین طاهری ([@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` ‫ > اگر ترجیح می‌دهید تارنما را بدون Docker اجرا کنید، به [اجرای تارنما با Hugo](#اجرای-تارنما-با-Hugo) مراجعه کنید. ‫ قالب مورد نیاز [Docsy Hugo theme](https://github.com/google/docsy#readme) باید به عنوان یک زیرماژول git نصب شود: ``` git submodule update --init --recursive --depth 1 ``` ‫ اگر Docker را نصب کرده‌اید، image Docker `hugo` را ایجاد کنید: ```bash make container-image ``` ‫ پس از ایجاد image، می‌توانید تارنما را راه اندازی کنید: ```bash make container-serve ``` ‫ برای مشاهده تارنما، مرورگر خود را با نشانی http://localhost:1313 باز کنید. وقتی تغییراتی در پرونده‌های منبع ایجاد می‌کنید، Hugo تارنما را به‌روزرسانی کرده و مرورگر را مجبور به فراخوانی مجدد می‌کند. ‫ ## اجرای تارنما با 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) است. ‫ ## سپاس گزاریم ‫ کوبرنتیز با مشارکت جامعه رونق می‌گیرد و ما از مشارکت‌های شما در تارنما و مستندات کوبرنتیز فارسی استقبال می‌کنیم. دمتون گرم!