Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/vuejs-translations/docs-fa

The Persian Vue docs 🇮🇷
https://github.com/vuejs-translations/docs-fa

documentation farsi persian vue

Last synced: 4 days ago
JSON representation

The Persian Vue docs 🇮🇷

Host: GitHub
URL: https://github.com/vuejs-translations/docs-fa
Owner: vuejs-translations
License: other
Created: 2023-09-17T13:31:34.000Z (about 1 year ago)
Default Branch: main
Last Pushed: 2024-10-30T01:00:54.000Z (15 days ago)
Last Synced: 2024-10-30T03:50:52.099Z (15 days ago)
Topics: documentation, farsi, persian, vue
Language: Vue
Homepage: https://fa.vuejs.org
Size: 18.8 MB
Stars: 313
Watchers: 4
Forks: 77
Open Issues: 7
Metadata Files:
- Readme: README.md
- Contributing: .github/contributing/oxford-comma.jpg
- License: LICENSE

Awesome Lists containing this project

README

ترجمه مستندات Vue به فارسی💚

ما توی این پروژه گروه کوچیکی از اکوسیستم بزرگ Vue هستیم که روی ترجمه‌ی مستندات این فریمورک کار می‌کنیم، تا کسی که حتی زبان انگلیسی رو خوب بلد نیست بتونه توسعه‌ی فرانت‌اند با این فریمورک رو همراه داکیومنت رسمی و فارسی خودش کاملا اصولی و درست یاد بگیره.

راهنمای مشارکت🌱

اول از همه مشارکت شما باعث دلگرمی ماست و به شدت از علاقه‌مندی شما به پیشرفت مستندات فارسی فریمورک Vue حمایت می‌کنیم. شما می‌تونید با ترجمه‌ی صفحات و بهبود کیفیت صفحات ترجمه‌شده به توسعه‌ی این پروژه کمک کنید.

قبل از شروع بهتره که این چند نکته رو درنظر داشته باشید:

⚙️ مستندات با VitePress ساخته شده و از vue/theme@ استفاده می‌کنه.

⚡ محتوای سایت با فرمت Markdown توی مسیر src قرار داره.

⛰️ برای ویرایش‌های ساده، می‌تونید مستقیماً فایل رو تو GitHub ویرایش کنید و Pull Request بسازید.

📦 برای توسعه به صورت local، استفاده از pnpm به عنوان Package Manager توصیه می‌شه.

🌿 این پروژه نیاز به Node.js نسخه v18.0.0 یا بالاتر داره، چون ما از ویژگی‌های جدیدی مثل optional chaining داخل کدها استفاده می‌کنیم.

🌻 ترجیحا فقط روی ترجمه مشارکت کنید و مشکلات مربوط به RTL یا از این قبیل رو توی issue اطلاع بدید.

🪼 توی مستندات VitePress، می‌تونید در مورد Markdown Extentionsهایی که پشتیبانی میشه و استفاده از سینتکس Vue داخل Markdown مطالعه کنید و یاد بگیرید (که البته برای مشارکت توی ترجمه لازم نیست).

🧠 برای توصیه‌های رسمی Vue درباره نوشتن و حفظ محتوای مستندات، به این صفحه مراجعه کنید (اختیاری).

🍄 برای افزایش کیفیت ترجمه مستندات حتما بخش واژه‌نامه و شیوه نگارش رو با دقت مطالعه کنید.

برای مشارکت کردن توی پروژه باید این مراحل ساده رو طی کنید:

مرحله اول: اول از همه از این ریپازیتوری یه fork رو بگیرید و اون رو روی سیستم خودتون pull کنید. بعد می‌تونید یه نگاه جزئی به پروژه برای آشنایی با ساختار اون داشته باشید. با دستور pnpm install وابستگی‌ها رو نصب و با pnpm run dev هم پروژه رو اجرا کنید.

مرحله دوم: از توی مستندات یه صفحه‌ که تا به حال به فارسی ترجمه نشده رو پیدا کنید و از این لیست مطمئن بشید که کسی درحال ترجمه اون صفحه نباشه. بعد با اعلام کردن این صفحه توی گروه تلگرام و بعد از هماهنگی می‌تونید ترجمه صفحه‌ی جدید رو شروع کنید.

مرحله سوم: بعد از اتمام کامل ترجمه‌ی صفحه، می‌تونید یه PR بسازید تا بعد از بررسی merge بشه.

پی‌نوشت: برای اصلاح یا بهبود صفحات ترجمه شده نیاز به هماهنگی نیست ولی در صورتی که سوالی دارید پیشنهاد میشه تو گروه تلگرام Vue_Docs_Fa بپرسید.