→ تعلّم

البدء السريع: المشروع والمفاتيح

تعمل كل ساحات التجربة في هذا الموقع على مشروع تجريبي مشترك، لذا يمكنك الاستكشاف دون حساب. ولترجمة تطبيقك الخاص تحتاج إلى ثلاثة أشياء من لوحة تحكم Langsys: مشروع، ومفتاح كتابة، ومفتاح للقراءة فقط. دقيقتان فقط، ولمرة واحدة.

الإعداد

1. سجّل الدخول على app.langsys.dev — وأنشئ حسابًا إن لم يكن لديك حساب.
2. أنشئ مشروعًا. اختر اللغة المحلية الأساسية (اللغة التي كُتبت بها عباراتك المصدر) واللغات المحلية الهدف التي تريد ترجمات لها. انسخ معرّف المشروع.
3. أنشئ مفتاحَي API للمشروع: مفتاح كتابة واحدًا ومفتاح قراءة فقط واحدًا. هذا الفصل هو نموذج الأمان بأكمله — ويشرح المفاتيح والبيئات السبب.
4. ضعها في بيئتك وثبّت حزمة SDK الخاصة بتقنياتك. طوّر باستخدام مفتاح الكتابة لتُسجَّل العبارات الجديدة وتُترجم آليًا أثناء البناء؛ وانشر مفتاح القراءة فقط.

# .env.local — development (Vite-style names; adjust the prefix to your bundler)
VITE_LANGSYS_PROJECT_ID=your-project-id
VITE_LANGSYS_API_KEY=write-key       # discovers + registers new phrases

# production
VITE_LANGSYS_PROJECT_ID=your-project-id
VITE_LANGSYS_API_KEY=read-only-key   # only fetches — safe to ship in the browser

# .env (Laravel, or your PHP app's environment)
LANGSYS_PROJECT_ID=your-project-id
LANGSYS_API_KEY=write-key            # server-side, so the write key can stay —
                                     # switch to read-only anywhere that must not
                                     # register phrases (e.g. a public sandbox)

ثم اختر SDK الخاصة بك

تبدأ كل صفحة من صفحات SDK عند التثبيت وتفترض هذا الإعداد تحديدًا — معرّف المشروع والمفتاح في بيئتك:

هل أنت جديد على الأفكار الأساسية؟ ابدأ بـالمفاهيم — العبارة هي المفتاح، واكتشاف الرموز، ومخزن اللغات — ثم عُد إلى هنا.