volta setup

أمر volta setup سيمكن Volta من خلال تعديل PATH للمستخدم الحالي (بطريقة خاصة بالمنصة) لتشمل دليل shims Volta. له الصيغة التالية:

تمكين Volta للمستخدم الحالي

الاستخدام:
    volta setup [FLAGS]

الأعلام:
        --verbose    تمكين التشخيص المفصل
        --quiet      منع المخرجات غير الضرورية
    -h, --help       طباعة معلومات المساعدة

إعداد Unix

على أنظمة Unix (macOS و Linux)، سيبحث volta setup في القائمة التالية عن ملفات تكوين shell:

• ~/.profile
• ~/.bash_profile
• ~/.bashrc
• ~/.zshrc
• ~/.config/fish/config.fish
• قيمة متغير البيئة PROFILE

للملفات الموجودة من هذه، سيقوم volta setup بتعديلها لتشمل السطور التالية:

1. تعريف متغير البيئة VOLTA_HOME (عادة ما يُعين إلى ~/.volta)
2. إضافة $VOLTA_HOME/bin إلى متغير البيئة PATH

إذا لم يكن ملف تكوين shell الحالي (المكتشف باستخدام متغير البيئة $SHELL) موجودًا، فسيقوم بإنشائه بمحتوى مناسب إذا أمكن.

إعداد Windows

على Windows، سيقوم volta setup بتعديل متغير البيئة Path للمستخدم ليشمل دليل shims (%LOCALAPPDATA%\Volta\bin). هذا يضمن توفر أوامر Volta في جميع موجهات الأوامر.

أمثلة

الإعداد الأساسي

# تشغيل عملية الإعداد
volta setup

هذا سيثبت ملف تكوين shell الخاص بك ويجعل Volta متاحًا في shell الخاص بك.

الإعداد الصامت

# تشغيل الإعداد بأقل مخرجات
volta setup --quiet

متى تستخدم

أمر volta setup مفيد في عدة حالات:

1. بعد التثبيت الجديد: تشغيله بعد تثبيت Volta لأول مرة
2. بعد حذف تكوين Shell: إذا حررت ملف تكوين shell يدويًا وحذفت تكوين Volta
3. المستخدم الجديد: عند إعداد Volta لمستخدم جديد على النظام
4. بعد تغيير Shell: إذا انتقلت إلى shell مختلف

ما يضيفه الإعداد إلى ملفات التكوين الخاصة بك

لـ bash/zsh/sh، يضيف volta setup سطورًا مشابهة:

export VOLTA_HOME="$HOME/.volta"
export PATH="$VOLTA_HOME/bin:$PATH"

لـ fish shell، يضيف:

set -gx VOLTA_HOME "$HOME/.volta"
set -gx PATH "$VOLTA_HOME/bin" $PATH

الإعداد اليدوي

إذا كنت لا تريد استخدام volta setup، يمكنك إضافة Volta يدويًا إلى PATH:

1. إنشاء الدليل الرئيسي لـ Volta (افتراضيًا ~/.volta على Unix، %LOCALAPPDATA%\Volta على Windows)
2. إضافة دليل bin إلى متغير البيئة PATH
3. إعادة تحميل shell أو إعادة تشغيل terminal

استكشاف الأخطاء وإصلاحها

إذا لم يكن Volta متاحًا بعد تشغيل volta setup:

1. تأكد من فتح نافذة terminal جديدة
2. تحقق من وجود دليل bin لـ Volta في PATH (استخدم echo $PATH على Unix، echo %PATH% على Windows)
3. تحقق من وجود الدليل الرئيسي لـ Volta
4. لأنظمة Unix، تحقق من تعديل ملف تكوين shell بشكل صحيح