lovelace mushroom

؟ فطر

ما هو الفطر؟

Mushroom عبارة عن مجموعة من البطاقات لـ Home Assistant Dashboard UI.

تتمثل Mishroom Mission في اقتراح مكونات سهلة الاستخدام لبناء لوحة معلومات مساعد منزلك.

سمات

• ؟ محرر لجميع البطاقات وجميع الخيارات (لا حاجة لتحرير yaml )
• ؟ Icon Picker
• ؟ منتقي الألوان
• 0 التبعيات: لا حاجة لتثبيت بطاقة أخرى.
• ؟ بناءً على ألوان واجهة المستخدم المادية
• ؟ دعم الموضوع الخفيف والظلام
• ؟ تخصيص موضوع اختياري
• ؟ تدويل

هدف الفطر هو عدم توفير بطاقة مخصصة للتخصيص العميق. يمكنك استخدام ملحقات بطاقة UI Lovelace الممتازة وبطاقة الأزرار لهذا الغرض.

تثبيت

HACS

يتوفر الفطر في HACS (متجر المجتمع المساعد).

استخدم هذا الرابط للذهاب مباشرة إلى المستودع في HACS

أو

1. قم بتثبيت HACS إذا لم يكن لديك بالفعل
2. فتح HACS في مساعد المنزل
3. ابحث عن "الفطر"
4. انقر فوق زر التنزيل.

يدوي

1. قم بتنزيل ملف mushroom.js من أحدث إصدار.
2. ضع ملف mushroom.js في مجلد config/www الخاص بك.
3. أضف إشارة إلى mushroom.js في لوحة القيادة. هناك طريقتان للقيام بذلك:
   • باستخدام واجهة المستخدم: الإعدادات ← لوحات المعلومات ← المزيد من الخيارات أيقونة ← الموارد ← إضافة مورد ← تعيين عنوان URL كـ /local/mushroom.js → تعيين نوع الموارد JavaScript Module . ملاحظة: إذا لم ترى قائمة الموارد ، فستحتاج إلى تمكين الوضع المتقدم في ملف تعريف المستخدم الخاص بك
   • باستخدام YAML: أضف الكود التالي إلى قسم lovelace .

      resources :
         - url : /local/mushroom.js
           type : module 

الاستخدام

يمكن تكوين جميع بطاقات الفطر باستخدام محرر UI لوحة القيادة.

1. في واجهة مستخدم لوحة القيادة ، انقر فوق 3 نقاط في الزاوية اليمنى العليا.
2. انقر فوق تحرير لوحة القيادة .
3. انقر فوق الزر Plus لإضافة بطاقة جديدة.
4. ابحث عن واحدة من بطاقة الفطر في القائمة.

البطاقات

تتوفر بطاقات مختلفة لكيانات الاختلافات:

• بطاقة الإنذار
• ؟ بطاقة الرقائق
• ؟ بطاقة المناخ
• ؟ بطاقة تغطية
• ؟ بطاقة الكيان
• ؟ بطاقة المروحة
• ؟ بطاقة المرطب
• بطاقة الضوء
• بطاقة القفل
• بطاقة الوسائط
• ؟ بطاقة الرقم
• ؟ بطاقة الشخص
• ؟ حدد بطاقة
• ؟ بطاقة قالب
• ✏ بطاقة العنوان
• ؟ تحديث بطاقة
• ؟ بطاقة فراغ

شارات

تتوفر شارة القالب إذا كنت تستخدم على الأقل مساعد منزلي 2024.8.

تخصيص الموضوع

يعمل Mushroom بدون موضوع ولكن يمكنك إضافة موضوع لتجربة أفضل عن طريق تثبيت موضوعات الفطر. إذا كنت ترغب في مزيد من المعلومات حول الموضوعات ، تحقق من وثائق مساعد المنزل الرسمي حول الموضوعات.

خادم التطوير

منزل مساعد تجريبي

يمكنك تشغيل مثيل تجريبي لمساعد المنزل مع Docker عن طريق التشغيل:

npm run start:hass

بمجرد الانتهاء من ذلك ، انتقل إلى Home Assistant مثيل http: // localhost: 8123 وبدء التكوين.

مستخدمي Windows

إذا كنت على Windows ، فإما قم بتشغيل الأمر أعلاه في PowerShell ، أو استخدم أدناه إذا كنت تستخدم موجه الأوامر:

npm run start:hass-cmd

تطوير

في محطة أخرى ، قم بتثبيت التبعيات وتشغيل خادم التطوير:

npm install
npm start

سيبدأ الخادم على المنفذ 4000 .

يبني

يمكنك إنشاء ملف mushroom.js في مجلد dist عن طريق تشغيل أمر build.

npm run build

الترجمات

إذا كنت ترغب في المساعدة في ترجمة الفطر ، فيمكنك ترجمته مباشرة من متصفحك باستخدام WebLate.

خطوات المشرف لإضافة لغة جديدة

1. لتكون متوافقة مع مساعد المنزل ، يجب أن تتبع علامات اللغة BCP 47. يمكن العثور على قائمة بمعظم علامات اللغة هنا: سجل Iana subtag. أمثلة: fr ، fr-CA ، zh-Hans .
2. قم بإنشاء ملف جديد {language_code}.json مع رمز اللغة الخاص بك في مجلد الترجمة. أمثلة: fr.json .
3. استيراد ملفك إلى localize.ts file وأضف لغتك في سجل languages .
4. لا تنسى الاختبار محليًا مع خادم التطوير من خلال اختيار اللغة مع واجهة المستخدم المساعد المنزلي في ملفك الشخصي.

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

لا أرى التغييرات الأخيرة

1. تحقق من أن إصدار مساعد منزلك هو الأحدث. يمكن أن تكون بعض ميزات الفطر الجديدة مرئية فقط لأحدث إصدار مساعد للمنزل.
2. تأكد من أن لديك أحدث إصدار من الفطر على HACS
3. تأكد من أن لديك أحدث إصدار من الفطر عن طريق التحقق من وحدة التحكم في المتصفح
4. امسح ذاكرة التخزين المؤقت الخاصة بك:
   • حذف موارد الفطر (https://my.home-assistant.io/redirect/lovelace_resources/)
   • إلغاء تثبيت الفطر من HACS
   • أعد تثبيت الفطر من HACS

تكوين MY CARD MOD الخاص بي لا يعمل.

لم يتم توفير مساعدة حول تكوين Mod Card في هذا المستودع. مزيد من المعلومات في حالة دعم Mod State.

الاعتمادات

التصميم مستوحى من عمل 7ahang على Behance و UI Lovelace Minimalist.