VoxVera/docs/ar/usage.md

الاستخدام التفصيلي

يغطي هذا الدليل سير عمل واجهة سطر الأوامر (CLI) الشائعة. راجع docs/docker.md للحصول على تعليمات Docker و docs/templates.md لقوالب المنشورات المتاحة.

المتطلبات الأساسية

تم تصميم VoxVera ليكون سهل النقل للغاية ويتطلب الحد الأدنى من تبعيات النظام.

1. الملفات الثنائية المستقلة (موصى به)

يمكنك تنزيل ملفات ثنائية مستقلة بدون تبعيات لنظام التشغيل الخاص بك:

• Linux: voxvera-linux
• Windows: voxvera-windows.exe
• macOS: voxvera-macos

تتضمن هذه الملفات الثنائية كل ما يلزم لتشغيل VoxVera (باستثناء onionshare-cli).

2. المثبت بنقرة واحدة

بدلاً من ذلك، قم بالتثبيت عبر البرمجية النصية المؤتمتة الخاصة بنا:

curl -fsSL https://raw.githubusercontent.com/PR0M3TH3AN/VoxVera/main/install.sh | bash

3. تثبيت Python اليدوي

إذا كنت تفضل التشغيل من المصدر:

pipx install 'voxvera@git+https://github.com/PR0M3TH3AN/VoxVera.git@main'
sudo apt install tor onionshare-cli   # Debian/Ubuntu

خطوة بخطوة

1. التهيئة: قم بتشغيل voxvera init واتبع المطالبات. سيُطلب منك اختيار لغتك أولاً.
2. البناء: قم بإنشاء أصول المنشور. ينشئ كل بناء تلقائياً ملف voxvera-portable.zip في مجلد المنشور، مما يسمح للآخرين بتنزيل الأداة الكاملة مباشرة من منشورك.

   voxvera build
   

3. الخدمة: انشر المنشور عبر Tor:

   voxvera serve
   

   يكتشف هذا تلقائياً نسخة Tor الخاصة بك، ويبدأ OnionShare، ويكتب عنوان .onion الناتج في روابط المنشور القابلة للنزع.

دعم اللغة

VoxVera مترجم بالكامل. يمكنك تغيير تفضيل اللغة الخاص بك بشكل دائم باستخدام المبدل التفاعلي أو اختصار مباشر:

• المبدل التفاعلي: voxvera lang
• اختصار مباشر: voxvera --lang ar (يضبط التفضيل على العربية)

اللغات المدعومة:

• الإنجليزية: en
• الإسبانية: es (اسم مستعار: --idioma)
• الألمانية: de (اسم مستعار: --sprache)
• العربية: ar

يمكنك أيضاً فرض لغة معينة لأمر واحد دون تغيير تفضيلك الدائم:

• الإنجليزية: voxvera --lang en check
• العربية: voxvera --lang ar check

تكتشف المنشورات الناتجة تلقائياً لغة متصفح الزائر وتبدل نص واجهة المستخدم وفقاً لذلك.

إدارة الخوادم

إدارة منشورات متعددة وهويات Tor الخاصة بها من قائمة تفاعلية واحدة:

voxvera manage

الميزات:

• --- إنشاء موقع/منشور جديد ---: ابدأ تسلسل الإعداد الكامل.
• --- تشغيل جميع المواقع ---: تشغيل أو إيقاف جميع المنشورات في أسطولك دفعة واحدة.
• الحالة في الوقت الفعلي: عرض روابط .onion النشطة ومؤشرات تقدم تمهيد Tor.
• التحكم الفردي: تصدير إلى Zip مواقع معينة إلى ZIP أو حذفها.

مراجة شاملة (التوزيع الفيروسي)

لضمان بقاء VoxVera متاحاً حتى لو تم فرض رقابة على المستودعات المركزية، يعمل كل منشور كمرآة للأداة.

عندما تستضيف منشوراً، يوفر زر "تحميل الأداة والكود" في الصفحة المقصودة ملف voxvera-portable.zip يحتوي على:

• كود المصدر الكامل وجميع اللغات المدعومة.
• جميع تبعيات Python (مضمنة مسبقاً).
• ملفات Tor الثنائية لجميع الأنظمة.

يتيح ذلك لأي شخص يقوم بمسح منشورك أن يصبح موزعاً جديداً لأداة VoxVera.

التصدير والنسخ الاحتياطي

قم بنسخ هويات Tor الفريدة الخاصة بك احتياطياً (حتى لا يتغير رابط .onion الخاص بك أبداً) أو انقل منشوراتك إلى جهاز آخر.

• تصدير موقع واحد: voxvera export <folder_name>
• تصدير جميع المواقع: voxvera export-all

مكان التخزين: يتم حفظ جميع الصادرات كملفات ZIP في مجلد يسمى voxvera-exports في دليل الصفحة الرئيسية للمستخدم (~/voxvera-exports/) على جميع الأنظمة.

الاستيراد والاستعادة

استعد إعدادك بالكامل على جهاز جديد بنقل ملفات ZIP الخاصة بك إلى ~/voxvera-exports/ وتشغيل:

voxvera import-multiple

النقل والتشغيل بدون إنترنت

إذا كنت بحاجة إلى تشغيل VoxVera على جهاز لا يتوفر فيه اتصال بالإنترنت، يمكنك "تضمين" التبعيات أولاً:

voxvera vendorize

يقوم هذا بتنزيل جميع مكتبات Python المطلوبة في voxvera/vendor/. ستعطي الأداة بعد ذلك الأولوية لهذه الملفات المحلية، مما يسمح لها بالعمل بدون pip install.

استيراد جماعي (JSON)

لإنشاء منشورات بشكل جماعي من ملفات تكوين JSON متعددة، ضعها في مجلد imports/ وشغل:

voxvera batch-import

كيف تعمل الروابط

يحتوي كل منشور على رابطين منفصلين:

• رابط قابل للنزع (يتم إنشاؤه تلقائياً): عنوان .onion حيث يتم استضافة المنشور.
• رابط المحتوى (يتم تكوينه بواسطة المستخدم): URL خارجي يشير إلى موقع ويب أو فيديو أو تنزيل.

لا تحتاج إلى إدخال عنوان .onion يدوياً؛ يتولى VoxVera ذلك تلقائياً خلال مرحلة serve.