lovelace mushroom

? Jamur

Apa itu jamur?

Mushroom adalah kumpulan kartu untuk asisten rumah UI dasbor.

Misi jamur adalah untuk mengusulkan komponen yang mudah digunakan untuk membangun dasbor asisten rumah Anda.

Fitur

• ? Editor untuk semua kartu dan dan semua opsi (tidak perlu mengedit yaml )
• ? Ikon pemetik
• ? Pemetik Warna
• 0 Ketergantungan: Tidak perlu menginstal kartu lain.
• ? Berdasarkan Warna UI Bahan
• ? Dukungan tema terang dan gelap
• ? Kustomisasi tema opsional
• ? Internasionalisasi

Tujuan jamur bukan untuk menyediakan kartu khusus untuk kustomisasi mendalam. Anda dapat menggunakan plugin minimalis UI Lovelace yang sangat baik dan plugin kartu tombol untuk ini.

Instalasi

HACS

Mushroom tersedia di HACS (Asisten Rumah Komunitas Home).

Gunakan tautan ini untuk langsung pergi ke repositori di HACS

atau

1. Instal HACS jika Anda belum memilikinya
2. Buka HACS di Asisten Rumah
3. Cari "jamur"
4. Klik tombol Unduh.

Manual

1. Unduh file mushroom.js dari rilis terbaru.
2. Masukkan file mushroom.js ke folder config/www Anda.
3. Tambahkan referensi ke mushroom.js di dasbor. Ada dua cara untuk melakukan itu:
   • Menggunakan UI: Pengaturan → Dasbor → Ikon Opsi Lebih Banyak → Sumber Daya → Tambahkan Sumber Daya → Atur URL As /local/mushroom.js → Atur Jenis Sumber Daya sebagai JavaScript Module . Catatan: Jika Anda tidak melihat menu sumber daya, Anda harus mengaktifkan mode lanjutan di profil pengguna Anda
   • Menggunakan YAML: Tambahkan kode berikut ke bagian lovelace .

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

Penggunaan

Semua kartu jamur dapat dikonfigurasi menggunakan editor UI dasbor.

1. Di Dashboard UI, klik 3 titik di sudut kanan atas.
2. Klik Edit Dasbor .
3. Klik tombol Plus untuk menambahkan kartu baru.
4. Temukan salah satu kustom: kartu jamur dalam daftar.

Kartu

Kartu yang berbeda tersedia untuk entitas yang berbeda:

• Kartu alarm
• ? Kartu chip
• ? Kartu Iklim
• ? Kartu penutup
• ? Kartu entitas
• ? Kartu kipas
• ? Kartu humidifier
• Kartu ringan
• Kartu kunci
• Kartu media
• ? Kartu angka
• ? Kartu orang
• ? Pilih Kartu
• ? Kartu Template
• ✏️ Kartu judul
• ? Perbarui Kartu
• ? Kartu vakum

Lencana

Lencana template tersedia jika Anda menggunakan setidaknya Asisten Rumah 2024.8.

Kustomisasi tema

Jamur berfungsi tanpa tema tetapi Anda dapat menambahkan tema untuk pengalaman yang lebih baik dengan memasang tema jamur. Jika Anda ingin informasi lebih lanjut tentang tema, lihat dokumentasi Asisten Rumah Resmi tentang tema.

Server pengembangan

Demo Asisten Rumah

Anda dapat menjalankan contoh demo asisten rumah dengan Docker dengan menjalankan:

npm run start:hass

Setelah selesai, buka instance asisten home http: // localhost: 8123 dan mulai konfigurasi.

Pengguna Windows

Jika Anda berada di Windows, jalankan perintah di atas di PowerShell, atau gunakan di bawah ini jika menggunakan perintah perintah:

npm run start:hass-cmd

Perkembangan

Di terminal lain, instal dependensi dan jalankan server pengembangan:

npm install
npm start

Server akan mulai di port 4000 .

Membangun

Anda dapat membangun file mushroom.js di folder dist dengan menjalankan perintah build.

npm run build

Terjemahan

Jika Anda ingin membantu menerjemahkan jamur, Anda dapat menerjemahkannya langsung dari browser Anda menggunakan Weblate.

Langkah Pemeliharaan Untuk Menambahkan Bahasa Baru

1. Agar kompatibel dengan asisten rumah, tag bahasa harus mengikuti BCP 47. Daftar sebagian besar tag bahasa dapat ditemukan di sini: IANA Subtag Registry. Contoh: fr , fr-CA , zh-Hans .
2. Buat file baru {language_code}.json dengan kode bahasa Anda di folder terjemahan. Contoh: fr.json .
3. Impor file Anda ke localize.ts file dan tambahkan bahasa Anda dalam catatan languages .
4. Jangan lupa untuk menguji secara lokal dengan server pengembangan dengan memilih bahasa dengan Home Assistant UI di profil Anda.

Pemecahan masalah

Saya tidak melihat perubahan terakhir

1. Periksa apakah versi asisten rumah Anda adalah yang terbaru. Beberapa fitur jamur baru hanya dapat terlihat untuk versi asisten rumah terbaru.
2. Periksa apakah Anda memiliki versi jamur terbaru di HACS
3. Periksa apakah Anda memiliki versi jamur terbaru dengan memeriksa konsol browser
4. Bersihkan cache Anda:
   • hapus sumber daya jamur (https://my.home-assistant.io/redirect/lovelace_resources/)
   • uninstall jamroom dari hacs
   • Pasang kembali jamur dari HACS

Konfigurasi mod kartu saya tidak berfungsi.

Bantuan tentang konfigurasi mod kartu tidak disediakan di repositori ini. Info lebih lanjut dalam keadaan dukungan mod kartu.

Kredit

Desainnya terinspirasi oleh karya 7ahang tentang Behance dan Minimalis UI Lovelace.