الفرق بين المراجعتين ل"Next.js/create next app"
| سطر 8: | سطر 8: | ||
# أو | # أو | ||
pnpm create next-app | pnpm create next-app | ||
| − | </syntaxhighlight>بإمكانك أيضًا إنشاء مشروع TypeScript باستخدام الرايتين <code>ts, --typescript--</code> :<syntaxhighlight lang="bash"> | + | </syntaxhighlight>بإمكانك أيضًا إنشاء مشروع TypeScript باستخدام الرايتين <code>ts, --typescript--</code>:<syntaxhighlight lang="bash"> |
npx create-next-app@latest --ts | npx create-next-app@latest --ts | ||
# أو | # أو | ||
| سطر 26: | سطر 26: | ||
=== الخيار example-path [path-to-example]-- === | === الخيار example-path [path-to-example]-- === | ||
| − | قد يتضمن عنوان URL في حالات نادرة على اسم فرع يضم المحرف "/" (مثل bug/fix-1) | + | قد يتضمن عنوان URL في حالات نادرة على اسم فرع يضم المحرف "/" (مثل bug/fix-1) ومسارًا إلى المثال (مثل foo/bar). لا بد في هذه الحالة من تخصيص المسار إلى المثال بشكل مستقل: <code>example-path foo/bar--</code>. |
=== الخيار use-npm-- === | === الخيار use-npm-- === | ||
| سطر 34: | سطر 34: | ||
يجبر CLI صراحة على استخدام pnpm في تحميل التطبيق. | يجبر CLI صراحة على استخدام pnpm في تحميل التطبيق. | ||
| − | '''ملاحظة''': ننصحك بتنفيذ الأمر <code>yarn create next-app</code> للتحميل باستخدام | + | '''ملاحظة''': ننصحك بتنفيذ الأمر <code>yarn create next-app</code> للتحميل باستخدام <code>yarn</code>. |
== إيجابيات استخدام Create Next App == | == إيجابيات استخدام Create Next App == | ||
| سطر 43: | سطر 43: | ||
* '''دعم دون اتصال''': تستشعر الأداة تلقائيًا أنك دون اتصال، وتحمّل مشروعك من الذاكرة المؤقتة المحلية. | * '''دعم دون اتصال''': تستشعر الأداة تلقائيًا أنك دون اتصال، وتحمّل مشروعك من الذاكرة المؤقتة المحلية. | ||
* '''دعم الأمثلة''': تُحمّل الأداة تطبيقك باستخدام مثال من مجموعة أمثلة (مثل <code>npx create-next-app --example api-routes</code>). | * '''دعم الأمثلة''': تُحمّل الأداة تطبيقك باستخدام مثال من مجموعة أمثلة (مثل <code>npx create-next-app --example api-routes</code>). | ||
| − | * '''أداة مختبرة''': هذه الحزمة جزء من مستودع | + | * '''أداة مختبرة''': هذه الحزمة جزء من مستودع Next.js وهي مختبرة باستخدام اختبارات التكامل ذاتها التي تُطبق على Next.js لضمان عملها في أي إصدار. |
== اقرأ أيضًا == | == اقرأ أيضًا == | ||
| − | * [[Next.js/pages|الصفحات في | + | * [[Next.js/pages|الصفحات في Next.js]]. |
| − | * [[Next.js/built in css support|الدعم المدمج لتنسيقات CCS في | + | * [[Next.js/built in css support|الدعم المدمج لتنسيقات CCS في Next.js]]. |
| − | * [[Next.js/cli|استخدام واجهة سطر الأوامر CLI في | + | * [[Next.js/cli|استخدام واجهة سطر الأوامر CLI في Next.js]]. |
== المصادر == | == المصادر == | ||
| − | * الصفحة [https://nextjs.org/docs/api-reference/create-next-app Create Next App] من توثيق | + | * الصفحة [https://nextjs.org/docs/api-reference/create-next-app Create Next App] من توثيق Next.js الرسمي. |
مراجعة 11:48، 15 يوليو 2022
إن أسهل الطرق لتبدأ بناء تطبيقات Next.js هو استخدام create-next-app. تمكنك هذه الأداة التي تستخدم واجهة سطر الأوامر CLI أن تبدأ بناء تطبيق Next.js جديد بسرعة بعد أن تهيئ لك كل شئ. بإمكانك بناء تطبيق جديد بالاستفادة من قالب Next.js الافتراضي أو باستخدام أحد قوالب Next.js الرسمية.
نفّذ الأوامر التالية لتبدأ:
npx create-next-app@latest
# أو
yarn create next-app
# أو
pnpm create next-app
بإمكانك أيضًا إنشاء مشروع TypeScript باستخدام الرايتين ts, --typescript--:
npx create-next-app@latest --ts
# أو
yarn create next-app --typescript
# أو
pnpm create next-app --ts
خيارات الأداة
تأتي الأداة create-next-app مع الخيارات التالية:
الخيار typescript-- أو ts--
ويُستخدم لتهيئة التطبيق كمشروع TypeScript.
الخيار example [name]|[github-url]-- أو e--
ويقدّم مثالًا لتحميل التطبيق من خلاله. بإمكانك استخدام اسم المثال من مستودع Next.js أو من خلال عنوان URL على GitHub. يمكن ان يضم العنوان أي فرغ أو/و مجلد فرعي.
الخيار example-path [path-to-example]--
قد يتضمن عنوان URL في حالات نادرة على اسم فرع يضم المحرف "/" (مثل bug/fix-1) ومسارًا إلى المثال (مثل foo/bar). لا بد في هذه الحالة من تخصيص المسار إلى المثال بشكل مستقل: example-path foo/bar--.
الخيار use-npm--
يجبر CLI صراحة على استخدام npm في تحميل التطبيق.
الخيار use-pnpm--
يجبر CLI صراحة على استخدام pnpm في تحميل التطبيق.
ملاحظة: ننصحك بتنفيذ الأمر yarn create next-app للتحميل باستخدام yarn.
إيجابيات استخدام Create Next App
تساعدك الأداة في إنشاء تطبيق Next.js خلال ثوانٍ، وتجري صيانته باستمرار من قبل مصممي Next.js. تقدم الأداة إضافة إلى ذلك الفوائد التالية:
- التجربة التفاعلية: يؤدي تنفيذ الأمر
npx create-next-app@latestإلى تشغيل دليل يرشدك بأسلوب تفاعلي إلى خطوات إعداد المشروع. - لا حاجة لإدراج اعتماديات: لا تحتاج الأداة إلى أية اعتماديات لإنشاء مشروع، ويهيأ خلال ثوانٍ.
- دعم دون اتصال: تستشعر الأداة تلقائيًا أنك دون اتصال، وتحمّل مشروعك من الذاكرة المؤقتة المحلية.
- دعم الأمثلة: تُحمّل الأداة تطبيقك باستخدام مثال من مجموعة أمثلة (مثل
npx create-next-app --example api-routes). - أداة مختبرة: هذه الحزمة جزء من مستودع Next.js وهي مختبرة باستخدام اختبارات التكامل ذاتها التي تُطبق على Next.js لضمان عملها في أي إصدار.
اقرأ أيضًا
المصادر
- الصفحة Create Next App من توثيق Next.js الرسمي.