1. تنزيل Toolkit

ثبّت GNU sed واستنسخ Ayakaleaf Toolkit على جهاز Mac.

1. تحقّق من Git وHomebrew

   git --version
   brew --version
   

   إذا طلب منك macOS تثبيت Command Line Tools عند تشغيل Git، فثبّتها أولًا. إذا لم يكن Homebrew مثبّتًا، فثبّته باتباع التعليمات الرسمية.

2. ضع GNU sed في PATH

   تستخدم سكربتات Toolkit خيارات GNU sed التي يرفضها BSD sed المدمج في macOS. ثبّت GNU sed وضعه أولًا في PATH في هذه الطرفية:

   brew install gnu-sed
   export PATH="$(brew --prefix gnu-sed)/libexec/gnubin:$PATH"
   sed --version
   

   يجب أن يطبع الأمر الأخير GNU sed.

   لا يكفي اسم مستعار مثل alias sed=gsed: إذ يشغّل Toolkit سكربتات Bash، وهي لا ترى الأسماء المستعارة الخاصة بصدفتك التفاعلية. ولا تحتاج إلى استبدال /usr/bin/sed.

   شغّل سطر export PATH=... مجددًا في كل طرفية جديدة تستخدمها مع Toolkit، أو أضفه إلى ملف بدء تشغيل الصدفة بعد التهيئة الخاصة بـ Homebrew.

3. استنسخ مستودع Ayakaleaf Toolkit

   اختر مجلدًا دائمًا. تجنّب /tmp ومحركات الأقراص القابلة للإزالة والمجلدات المتزامنة مع السحابة مثل iCloud Drive لقاعدة البيانات الحية وبيانات المشاريع. يستخدم هذا الدليل ~/ayakaleaf-toolkit:

   git clone https://github.com/ayaka-notes/toolkit.git "$HOME/ayakaleaf-toolkit"
   cd "$HOME/ayakaleaf-toolkit"
   

   إذا كان المجلد يحتوي بالفعل على تثبيت، فاستخدمه كما هو، أو اختر مجلدًا آخر لنسخة جديدة. لا تهيّئ إعدادات جديدة فوق نشر قائم.

​

الخطوة التالية

تابع مع 2. تعرّف على الـ Toolkit.