wip(docs): i18n (#12681)

2026-04-15 13:14:35 +00:00 · 2026-02-09 11:34:35 -06:00
parent f74c0339cc
commit dc53086c1e
642 changed files with 192745 additions and 509 deletions
--- a/packages/web/src/content/docs/ar/web.mdx
+++ b/packages/web/src/content/docs/ar/web.mdx
@@ -0,0 +1,142 @@
+---
+title: الويب
+description: استخدام OpenCode في متصفحك.
+---
+
+يمكن تشغيل OpenCode كتطبيق ويب داخل متصفحك، ليمنحك تجربة البرمجة القوية بالذكاء الاصطناعي نفسها دون الحاجة إلى الطرفية.
+
+![OpenCode Web - جلسة جديدة](../../../assets/web/web-homepage-new-session.png)
+
+## البدء
+
+ابدأ تشغيل واجهة الويب عبر تنفيذ:
+
+```bash
+opencode web
+```
+
+يؤدي ذلك إلى تشغيل خادم محلي على `127.0.0.1` بمنفذ عشوائي متاح، ويفتح OpenCode تلقائيا في المتصفح الافتراضي لديك.
+
+:::caution
+إذا لم يتم تعيين `OPENCODE_SERVER_PASSWORD` فسيكون الخادم دون حماية. هذا مناسب للاستخدام المحلي، لكنه يجب أن يكون مُعينا عند إتاحة الوصول عبر الشبكة.
+:::
+
+:::tip[مستخدمو Windows]
+لأفضل تجربة، شغّل `opencode web` من [WSL](/docs/windows-wsl) بدلا من PowerShell. يضمن ذلك وصولا صحيحا إلى نظام الملفات وتكاملا أفضل مع الطرفية.
+:::
+
+---
+
+## الإعدادات
+
+يمكنك ضبط خادم الويب باستخدام خيارات سطر الأوامر أو عبر [ملف الإعدادات](/docs/config).
+
+### المنفذ
+
+افتراضيا، يختار OpenCode منفذا متاحا. يمكنك تحديد منفذ:
+
+```bash
+opencode web --port 4096
+```
+
+### اسم المضيف
+
+افتراضيا، يرتبط الخادم بـ `127.0.0.1` (للاستخدام المحلي فقط). لجعل OpenCode متاحا على شبكتك:
+
+```bash
+opencode web --hostname 0.0.0.0
+```
+
+عند استخدام `0.0.0.0` سيعرض OpenCode كلا من عناوين الوصول المحلي وعناوين الشبكة:
+
+```
+  Local access:       http://localhost:4096
+  Network access:     http://192.168.1.100:4096
+```
+
+### اكتشاف mDNS
+
+فعّل mDNS لجعل خادمك قابلا للاكتشاف على الشبكة المحلية:
+
+```bash
+opencode web --mdns
+```
+
+يضبط ذلك تلقائيا اسم المضيف إلى `0.0.0.0` ويعلن عن الخادم باسم `opencode.local`.
+
+يمكنك تخصيص اسم نطاق mDNS لتشغيل عدة نسخ على الشبكة نفسها:
+
+```bash
+opencode web --mdns --mdns-domain myproject.local
+```
+
+### CORS
+
+للسماح بنطاقات إضافية عبر CORS (مفيد للواجهات الأمامية المخصصة):
+
+```bash
+opencode web --cors https://example.com
+```
+
+### المصادقة
+
+لحماية الوصول، عيّن كلمة مرور عبر متغير البيئة `OPENCODE_SERVER_PASSWORD`:
+
+```bash
+OPENCODE_SERVER_PASSWORD=secret opencode web
+```
+
+اسم المستخدم الافتراضي هو `opencode`، ويمكن تغييره عبر `OPENCODE_SERVER_USERNAME`.
+
+---
+
+## استخدام واجهة الويب
+
+بعد التشغيل، تتيح لك واجهة الويب الوصول إلى جلسات OpenCode الخاصة بك.
+
+### الجلسات
+
+اعرض جلساتك وأدرها من الصفحة الرئيسية. يمكنك رؤية الجلسات النشطة وبدء جلسات جديدة.
+
+![OpenCode Web - جلسة نشطة](../../../assets/web/web-homepage-active-session.png)
+
+### حالة الخادم
+
+انقر على "See Servers" لعرض الخوادم المتصلة وحالتها.
+
+![OpenCode Web - See Servers (عرض الخوادم)](../../../assets/web/web-homepage-see-servers.png)
+
+---
+
+## إرفاق طرفية
+
+يمكنك إرفاق واجهة طرفية (TUI) بخادم ويب قيد التشغيل:
+
+```bash
+# Start the web server
+opencode web --port 4096
+
+# In another terminal, attach the TUI
+opencode attach http://localhost:4096
+```
+
+يتيح لك ذلك استخدام واجهة الويب والطرفية في الوقت نفسه، مع مشاركة الجلسات والحالة نفسها.
+
+---
+
+## ملف الإعدادات
+
+يمكنك أيضا ضبط إعدادات الخادم داخل ملف الإعدادات `opencode.json`:
+
+```json
+{
+  "server": {
+    "port": 4096,
+    "hostname": "0.0.0.0",
+    "mdns": true,
+    "cors": ["https://example.com"]
+  }
+}
+```
+
+تكون خيارات سطر الأوامر ذات أولوية أعلى من إعدادات ملف الإعدادات.