وثائق تطبيق الطقس (الإصدار 1.6.0)

مرحبًا بكم في وثائق تطبيق الطقس! يوفر هذا التطبيق معلومات عن الطقس في الوقت الفعلي وتوقعات من عدة مزودي بيانات الطقس.

الميزات

آخر التحديثات

للحصول على قائمة كاملة بالتغييرات، يرجى مراجعة ملف CHANGELOG.md.

البدء

  1. دليل التثبيت - كيفية تثبيت وإعداد التطبيق
  2. دليل المستخدم - كيفية استخدام التطبيق
  3. التكوين - كيفية تكوين التطبيق

مواضيع متقدمة

الدعم

للدعم الفني، يرجى فتح issue في مستودع GitHub.

الترخيص

هذا المشروع مرخص بموجب ترخيص GPLv3 - انظر ملف LICENSE للتفاصيل.

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

البدء

  1. تشغيل التطبيق
  2. البحث عن موقع

الواجهة الرئيسية

عرض الطقس

التنقل

خرائط الطقس والرادار

توفر ميزة “خرائط الطقس والرادار” تصورًا تفاعليًا لأنماط الطقس وظروفه.

الوصول إلى خرائط الطقس

  1. انقر على عرض في شريط القوائم
  2. اختر خرائط الطقس والرادار
  3. سيتم فتح مربع حوار بعلامات تبويب متعددة

الميزات

علامة تبويب الرادار

علامة تبويب درجة الحرارة

علامة تبويب هطول الأمطار

علامة تبويب الرياح

استخدام الخريطة

نصائح

الميزات

المفضلة

الإعدادات

  1. انقر على أيقونة الترس (⚙️) أو انتقل إلى القائمة > الإعدادات
  2. قم بتكوين خيارات مثل:
  3. انقر فوق “حفظ” لتطبيق التغييرات

واجهة سطر الأوامر

# الاستخدام الأساسي
weather-app [الموقع] [خيارات]

# أمثلة
weather-app "القاهرة، EG"
weather-app --provider openweathermap --units metric
weather-app --config ~/.config/weather/config.ini

# الخيارات
  -h, --help            إظهار رسالة المساعدة والخروج
  -v, --version         إظهار معلومات الإصدار
  -c, --config ملف       تحديد ملف التكوين
  -d, --debug           تمكين وضع التصحيح
  --provider مزود        تعيين مزود بيانات الطقس
  --units {metric,imperial}
                        تعيين نظام الوحدات
  --lang لغة            تعيين رمز اللغة
  --theme {light,dark,system}
                        تعيين السمة اللونية
  --no-gui              التشغيل في وضع وحدة التحكم

اختصارات لوحة المفاتيح

اختصارات عامة

الاختصار الإجراء
Ctrl + F التركيز على شريط البحث
Ctrl + , فتح الإعدادات
F5 تحديث بيانات الطقس
Ctrl + Q إغلاق التطبيق

التنقل في الخريطة

الاختصار الإجراء
+ تكبير
- تصغير
أسهم التمرير في الخريطة
R إعادة تعيين عرض الخريطة
F العثور على موقعي

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

المشاكل الشائعة

  1. لا توجد بيانات الموقع
  2. بيانات قديمة
  3. مشاكل في الخرائط

إعادة تعيين التطبيق

  1. مسح ذاكرة التخزين المؤقت: 
    # Linux/macOS
rm -rf ~/.cache/weatherapp
   
# Windows
del /s /q %APPDATA%\WeatherApp\cache
  2. إعادة تعيين الإعدادات: 
    # Linux/macOS
rm ~/.config/WeatherApp/config.ini
   
# Windows
del %APPDATA%\WeatherApp\config.ini
  3. إعادة التثبيت الكاملة: 
    # قم أولاً بعمل نسخة احتياطية من بياناتك
# ثم احذف دليل التطبيق

التطوير

البناء من المصدر

  1. استنسخ المستودع: 
    git clone https://github.com/Nsfr750/weather.git
cd weather
  2. تثبيت التبعيات: 
    pip install -r requirements.txt
  3. التشغيل في وضع المطور: 
    python -m weatherapp

إنشاء الحزم

Windows

pyinstaller --onefile --windowed --icon=assets/icon.ico weatherapp/__main__.py

Linux

pyinstaller --onefile --windowed --icon=assets/icon.png weatherapp/__main__.py

macOS

pyinstaller --onefile --windowed --icon=assets/icon.icns --osx-bundle-identifier com.example.weatherapp weatherapp/__main__.py

الترخيص

يخضع هذا البرنامج لترخيص GPLv3. انظر ملف LICENSE للحصول على النص الكامل للترخيص.

الشكر والتقدير

© 2023 Nsfr750. جميع الحقوق محفوظة.