|
1 |
| -# Releases |
| 1 | +# انتشارها |
2 | 2 |
|
3 |
| -Vite releases follow [Semantic Versioning](https://semver.org/). You can see the latest stable version of Vite in the [Vite npm package page](https://www.npmjs.com/package/vite). |
| 3 | +انتشارهای Vite از نسخهگذاری معنایی ([Semantic Versioning](https://semver.org/)) پیروی میکنند. آخرین نسخهی پایدار Vite را میتوانید در صفحهی [npm](https://www.npmjs.com/package/vite) در npm ببینید. |
4 | 4 |
|
5 |
| -A full changelog of past releases is [available on GitHub](https://github.com/vitejs/vite/blob/main/packages/vite/CHANGELOG.md). |
| 5 | +فهرست کامل تغییرات نسخههای گذشته در [GitHub](https://github.com/vitejs/vite/blob/main/packages/vite/CHANGELOG.md) در دسترس است. |
6 | 6 |
|
7 |
| -## Release Cycle |
| 7 | +## چرخه انتشار |
8 | 8 |
|
9 |
| -Vite does not have a fixed release cycle. |
| 9 | +دروقع Vite چرخهی انتشار ثابتی ندارد. |
10 | 10 |
|
11 |
| -- **Patch** releases are released as needed (usually every week). |
12 |
| -- **Minor** releases always contain new features and are released as needed. Minor releases always have a beta pre-release phase (usually every two months). |
13 |
| -- **Major** releases generally align with [Node.js EOL schedule](https://endoflife.date/nodejs), and will be announced ahead of time. These releases will go through long-term discussions with the ecosystem, and have alpha and beta pre-release phases (usually every year). |
| 11 | +- نسخههای **پچ (Patch)** در صورت نیاز منتشر میشوند (معمولاً هر هفته). |
| 12 | +- نسخههای **فرعی (Minor)** همیشه شامل ویژگیهای جدید هستند و در صورت نیاز منتشر میشوند. این نسخهها همیشه یک مرحله پیشانتشار بتا (pre-release) دارند (معمولاً هر دو ماه یکبار). |
| 13 | +- نسخههای **اصلی (Major)** معمولاً با [برنامه پایان عمر (EOL) Node.js](https://endoflife.date/nodejs) هماهنگ هستند و از قبل اعلام میشوند. این نسخهها پس از بحثهای بلندمدت با اکوسیستم منتشر شده و مراحل پیشانتشار آلفا و بتا را طی میکنند (معمولاً هر سال یکبار). |
14 | 14 |
|
15 |
| -The Vite version ranges that are supported by the Vite team are automatically determined by: |
| 15 | +بازههای نسخهی Vite که توسط تیم Vite پشتیبانی میشوند بهصورت خودکار بر اساس موارد زیر تعیین میشوند: |
16 | 16 |
|
17 |
| -- **Current Minor** gets regular fixes. |
18 |
| -- **Previous Major** (only for its latest minor) and **Previous Minor** receives important fixes and security patches. |
19 |
| -- **Second-to-last Major** (only for its latest minor) and **Second-to-last Minor** receives security patches. |
20 |
| -- All versions before these are no longer supported. |
| 17 | +- نسخهی **Current Minor** بهطور منظم رفع اشکال (bug fixe) میشود. |
| 18 | +- نسخهی **Previous Major** (فقط آخرین نسخهی Minor آن) و **Previous Minor** اصلاحات مهم و پچهای امنیتی دریافت میکنند. |
| 19 | +- نسخههای **Second-to-last Major** و **Second-to-last Minor** فقط پچهای امنیتی دریافت میکنند. |
| 20 | +- تمام نسخههای قبل از این بازهها دیگر پشتیبانی نمیشوند. |
21 | 21 |
|
22 |
| -As an example, if the Vite latest is at 5.3.10: |
| 22 | +برای مثال، اگر آخرین نسخهی Vite برابر با ۵.۳.۱۰ باشد: |
23 | 23 |
|
24 |
| -- Regular patches are released for `[email protected]`. |
25 |
| -- Important fixes and security patches are backported to `vite@4` and `[email protected]`. |
26 |
| -- Security patches are also backported to `vite@3`, and `[email protected]`. |
27 |
| -- `vite@2` and `vite@5.0` are no longer supported. Users should upgrade to receive updates. |
| 24 | +- پچهای معمولی برای `[email protected].` منتشر میشوند. |
| 25 | +- اصلاحات مهم و پچهای امنیتی به `vite@4` و `.[email protected]` منتقل میشوند. |
| 26 | +- پچهای امنیتی همچنین به `vite@3` و `[email protected]` منتقل میشوند. |
| 27 | +- نسخههای `vite@2` و `vite@5.0` دیگر پشتیبانی نمیشوند. کاربران باید برای دریافت بهروزرسانیها، نسخهی خود را ارتقا (upgrade) دهند. |
28 | 28 |
|
29 |
| -We recommend updating Vite regularly. Check out the [Migration Guides](https://vite.dev/guide/migration.html) when you update to each Major. The Vite team works closely with the main projects in the ecosystem to ensure the quality of new versions. We test new Vite versions before releasing them through the [vite-ecosystem-ci project](https://github.com/vitejs/vite-ecosystem-ci). Most projects using Vite should be able to quickly offer support or migrate to new versions as soon as they are released. |
| 29 | +ما توصیه میکنیم Vite را بهصورت منظم بهروزرسانی کنید. هنگام ارتقا به هر نسخهی اصلی (Major)، [راهنمای مهاجرت](https://vite.dev/guide/migration.html) را بررسی کنید. تیم Vite با پروژههای اصلی اکوسیستم همکاری نزدیکی دارد تا کیفیت نسخههای جدید را تضمین کند. نسخههای جدید Vite قبل از انتشار، از طریق پروژه [vite-ecosystem-ci project](https://github.com/vitejs/vite-ecosystem-ci) تست میشوند. بیشتر پروژههایی که از Vite استفاده میکنند، باید بتوانند سریعاً پشتیبانی ارائه دهند یا به نسخههای جدید مهاجرت کنند. |
30 | 30 |
|
31 |
| -## Semantic Versioning Edge Cases |
| 31 | +## حالات خاص در نسخهگذاری معنایی |
32 | 32 |
|
33 |
| -### TypeScript Definitions |
| 33 | +### تعاریف تایپ اسکریپت |
34 | 34 |
|
35 |
| -We may ship incompatible changes to TypeScript definitions between minor versions. This is because: |
| 35 | +ممکن است بین نسخههای Minor تغییرات ناسازگار در تعاریف تایپ اسکریپت ارائه دهیم. دلیل این موضوع این است که: |
36 | 36 |
|
37 |
| -- Sometimes TypeScript itself ships incompatible changes between minor versions, and we may have to adjust types to support newer versions of TypeScript. |
38 |
| -- Occasionally we may need to adopt features that are only available in a newer version of TypeScript, raising the minimum required version of TypeScript. |
39 |
| -- If you are using TypeScript, you can use a semver range that locks the current minor and manually upgrade when a new minor version of Vite is released. |
| 37 | +- گاهی خود تایپ اسکریپت بین نسخههای Minor تغییرات ناسازگار دارد و ما ممکن است برای پشتیبانی از نسخههای جدیدتر، تایپها را تغییر دهیم. |
| 38 | +- گاهی لازم است از ویژگیهایی استفاده کنیم که فقط در نسخههای جدیدتر تایپ اسکریپت وجود دارند، بنابراین حداقل نسخهی موردنیاز تایپاسکریپت را افزایش میدهیم. |
| 39 | +- اگر از تایپ اسکریپت استفاده میکنید، میتوانید بازه نسخه semver را قفل کنید روی نسخه فرعی فعلی و هنگام انتشار نسخه Minor جدید Vite بهصورت دستی ارتقا دهید. |
40 | 40 |
|
41 | 41 | ### esbuild
|
42 | 42 |
|
43 |
| -[esbuild](https://esbuild.github.io/) is pre-1.0.0 and sometimes it has a breaking change we may need to include to have access to newer features and performance improvements. We may bump the esbuild's version in a Vite Minor. |
| 43 | +[esbuild](https://esbuild.github.io/) هنوز به نسخه ۱.۰.۰ نرسیده و گاهی تغییرات ناسازگار دارد که برای دسترسی به ویژگیها و بهبودهای عملکردی جدید باید آنها را در Vite بگنجانیم. ممکن است نسخه esbuild را در یک نسخهی Minor در Vite افزایش دهیم. |
44 | 44 |
|
45 |
| -### Node.js non-LTS versions |
| 45 | +### نسخههای ناپایدار Node.js |
46 | 46 |
|
47 |
| -Non-LTS Node.js versions (odd-numbered) are not tested as part of Vite's CI, but they should still work before their [EOL](https://endoflife.date/nodejs). |
| 47 | +نسخههای ناپایدار Node.js (شماره فرد) بهعنوان بخشی از تستهای CI Vite آزمایش نمیشوند، اما تا قبل از [پایان عمر](https://endoflife.date/nodejs) آنها باید کار کنند. |
48 | 48 |
|
49 |
| -## Pre Releases |
| 49 | +## پیشانتشارها |
50 | 50 |
|
51 |
| -Minor releases typically go through a non-fixed number of beta releases. Major releases will go through an alpha phase and a beta phase. |
| 51 | +نسخههای Minor معمولاً از چندین نسخهی بتا (با تعداد غیرثابت) عبور میکنند. نسخههای Major نیز یک مرحله آلفا و یک مرحله بتا خواهند داشت. |
52 | 52 |
|
53 |
| -Pre-releases allow early adopters and maintainers from the Ecosystem to do integration and stability testing, and provide feedback. Do not use pre-releases in production. All pre-releases are considered unstable and may ship breaking changes in between. Always pin to exact versions when using pre-releases. |
| 53 | +پیشانتشارها به پذیرندگان اولیه و نگهدارندگان اکوسیستم اجازه میدهند تا تستهای یکپارچگی و پایداری انجام دهند و بازخورد بدهند. هیچوقت از پیشانتشارها در محیط production استفاده نکنید. همه پیشانتشارها ناپایدار محسوب میشوند و ممکن است تغییرات ناسازگار داشته باشند. همیشه هنگام استفاده از پیشانتشارها نسخه دقیق را قفل کنید. |
54 | 54 |
|
55 |
| -## Deprecations |
| 55 | +## فرایند منسوخ شدن |
56 | 56 |
|
57 |
| -We periodically deprecate features that have been superseded by better alternatives in Minor releases. Deprecated features will continue to work with a type or logged warning. They will be removed in the next major release after entering deprecated status. The [Migration Guide](https://vite.dev/guide/migration.html) for each major will list these removals and document an upgrade path for them. |
| 57 | +ما بهصورت دورهای ویژگیهایی که در نسخههای Minor با گزینههای بهتر جایگزین شدهاند را منسوخ میکنیم. ویژگیهای منسوخشده همچنان با یک هشدار یا لاگ کار میکنند و در نسخهی Minor بعدی پس از اعلام منسوخشدن حذف خواهند شد. [راهنمای مهاجرت](https://vite.dev/guide/migration.html) هر نسخهی Major، این حذفها را فهرست کرده و مسیر ارتقا را مستند میکند.ض |
58 | 58 |
|
59 |
| -## Experimental Features |
| 59 | +## ویژگیهای آزمایشی |
60 | 60 |
|
61 |
| -Some features are marked as experimental when released in a stable version of Vite. Experimental features allow us to gather real-world experience to influence their final design. The goal is to let users provide feedback by testing them in production. Experimental features themselves are considered unstable, and should only be used in a controlled manner. These features may change between Minors, so users must pin their Vite version when they rely on them. We will create [a GitHub discussion](https://github.com/vitejs/vite/discussions/categories/feedback?discussions_q=is%3Aopen+label%3Aexperimental+category%3AFeedback) for each experimental feature. |
| 61 | +برخی ویژگیها هنگام انتشار در نسخه پایدار Vite بهعنوان آزمایشی علامتگذاری میشوند. ویژگیهای آزمایشی به ما کمک میکنند تا تجربهی واقعی کاربران را جمعآوری کنیم و طراحی نهایی آنها را بهبود دهیم. هدف این است که کاربران با استفاده در محیط تولید بازخورد دهند. خود ویژگیهای آزمایشی ناپایدار هستند و فقط باید بهصورت کنترلشده استفاده شوند. این ویژگیها ممکن است بین نسخههای Minor تغییر کنند، بنابراین کاربران هنگام استفاده باید نسخه Vite خود را قفل کنند. برای هر ویژگی آزمایشی، [بحثی در GitHub](https://github.com/vitejs/vite/discussions/categories/feedback?discussions_q=is%3Aopen+label%3Aexperimental+category%3AFeedback) ایجاد خواهیم کرد. |
0 commit comments