Σύμβολα

Όλα τα σύμβολα μπορούν να χρησιμοποιηθούν σε διάφορες θέσεις στην οπτικοποίηση. Έτσι είναι δυνατό να οριστούν αυτά ως μεταβλητή ή κείμενο.

Για να εμφανιστεί ένα σύμβολο στην οπτικοποίηση, αυτό δηλώνεται με την ετικέτα [icon:SYMBOLPFAD] απευθείας στο κείμενο. Η διαδρομή του συμβόλου μπορεί να αντιγραφεί από τη βιβλιοθήκη συμβόλων με το δεξί κλικ ή με CTRL+C. Πρέπει, εάν είναι δυνατό, να επιλεγεί μόνο το Material Symbols, ώστε ο στυλ της οπτικοποίησης να παραμένει ίδιος.

Βιβλιοθήκη Συμβόλων

Όλα τα διαθέσιμα σύμβολα μπορούν να αναζητηθούν και να προστεθούν κάτω από το μενού Οπτικοποίηση Σύμβολα. Είναι επίσης δυνατό να εισαχθεί ένα δικό σας σύνολο συμβόλων στη βιβλιοθήκη. Η διαδικασία εξηγείται παρακάτω.

Σημειώσεις: Το όνομα που εμφανίζεται στη λίστα των συμβόλων δεν είναι ίδιο με τη διαδρομή του συμβόλου. Αν στην διαδρομή δεν ορίζεται ένα σύνολο συμβόλων, τότε χρησιμοποιείται αυτόματα το σύνολο Glyphicons.

Ο φίλτρο στη βιβλιοθήκη συμβόλων αναζητά επίσης τις ετικέτες που έχουν καταχωρηθεί. Αν δεν επιθυμείτε αυτήν τη συμπεριφορά, μπορείτε να ξεκινήσετε τον φίλτρο με ένα = για να αναζητήσετε μόνο στα ονόματα.

Σύνολο Συμβόλων Material Symbols (Προεπιλογή)

Αυτό το σύνολο συμβόλων είναι πλήρως δυναμικό και ο στυλ των συμβόλων ρυθμίζεται αυτόματα σύμφωνα με το σχέδιο της οπτικοποίησης. Επιπλέον, ένα γεμάτο σύμβολο χρησιμοποιείται αυτόματα όταν το σύμβολο πρέπει να είναι ενεργό. Όμως, όχι όλα τα σύμβολα έχουν μια γεμάτη έκδοση.

Τα σύμβολα στρογγυλοποιούνται αυτόματα όταν η ακτίνα του κουμπιού είναι μεγαλύτερη ή ίση με 16 Pixel. Αν η ακτίνα είναι ίση με 0px, τότε χρησιμοποιούνται τα αιχμηρά σύμβολα. Στο επεξεργαστή, όμως, χρησιμοποιούνται πάντα τα κανονικά σύμβολα.

Σημείωση: Συνιστάται η χρήση του συνόλου συμβόλων "Material Symbols" για να διατηρηθεί η ομοιομορφία της οπτικοποίησης.

Σύνολο Συμβόλων Material Animated

Υπάρχουν επιλεγμένα σύμβολα του Material Symbols που έχουν αναπτυχθεί για να παρουσιάζουν τιμές. Αυτά τα σύμβολα έχουν μόνο μια ανίχνευση με το σύμβολο της δομής. Κατά την επιλογή, τότε απελευθερώνονται περισσότερες μεταβλητές.

Σύνολο Συμβόλων Philips Hue

Τα σύμβολα του Philips Hue μπορούν να χρησιμοποιηθούν ελεύθερα όταν χρησιμοποιείται η διεπαφή Hue. Επιπλέον, υπάρχει ένα πρόσθετο σύνολο συμβόλων Hue της κοινότητας του Home Assistant HASS. Περισσότερες πληροφορίες θα βρείτε στο τέλος αυτού του κεφαλαιού.

Σύνολο Συμβόλων Καιρού

Αυτό το σύνολο συμβόλων εμφανίζει τα σύμβολα καιρού της οπτικοποίησης. Αυτά υποστηρίζονται χωρίς ραφή από διάφορες διεπαφές. Δείτε το παρακάτω κεφάλαιο Σύμβολα Καιρού.

Σύνολο Συμβόλων Legacy (παλιό)

Το σύνολο συμβόλων Legacy περιέχει όλα τα σύμβολα της παλιάς οπτικοποίησης. Ο τρόπος εμφάνισης της νέας διεπαφής παραμένει ίδιος. Τα σύμβολα δεν πρέπει να χρησιμοποιούνται πλέον, καθώς η εμφάνισή τους δεν έχει βελτιωθεί για την νέα διεπαφή.

Διάφορα παλιά σύμβολα συνεχίζουν να είναι αναπτυσσόμενα:

  • legacy/door
  • legacy/door_2
  • legacy/lock
  • legacy/shutter
  • legacy/shutter_blinds
  • legacy/window
  • legacy/window_tilt

Κρυφά Σύμβολα

Υπάρχουν επίσης κρυφά σύμβολα για την οπτικοποίηση. Αυτά εξηγούνται περαιτέρω στα επόμενα κεφάλαια.

Για να καλέσετε τα σύμβολα, απαιτείται μόνο ένα πρόθεμα URL.

Δικά Σας Σύνολα Συμβόλων

Είναι δυνατό να εισαγάγετε ένα δικό σας σύνολο συμβόλων στο πρόγραμμα. Κάθε σύνολο συμβόλων πρέπει να προετοιμαστεί ως αρχείο ZIP. Μπορείτε να κατεβάσετε μερικά δεδομένα παραδείγματος εδώ:

Professional Tip: Μετά την επιτυχή εισαγωγή, μπορείτε να εξάγετε το σύνολο συμβόλων ως .antobj για να απλοποιήσετε την εισαγωγή. Για αυτό, κάντε δεξί κλικ σε ένα σύνολο συμβόλων και επιλέξτε Εξαγωγή.

Οι ακόλουθες κανόνες ορίζουν τη δομή και τις απαιτήσεις ενός συνόλου συμβόλων. Παρακαλώ διαβάστε αυτά προσεκτικά και ακολουθήστε τα ακριβώς.

Κανόνες

  • Πρόθεμα
    • Μπορεί να περιέχει μόνο _, a–z και 0–9.
    • Τα κεφαλαία γράμματα μετατρέπονται αυτόματα σε πεζά.
    • Οι αποθηκευμένοι ονόματα όπως sys, src ή doc είναι άκυρα.
    • Πρέπει να ξεκινά με ένα γράμμα (a–z). Μόνο αριθμοί δεν επιτρέπονται.
    • Τα υπογράμμισμα που προστίθενται στο τέλος (_) αφαιρούνται.
    • Πρέπει να έχει τουλάχιστον 3 χαρακτήρες.
    • Τα πολλαπλά υπογράμμισμα (__) μειώνονται σε ένα μόνο.
  • Ονόματα Συμβόλων
    • Μετατρέπονται αυτόματα σε πεζά.
    • Τα επιτρεπόμενα χαρακτήρες είναι -, _, a–z και 0–9.
    • Τα πολύ μεγάλα ονόματα και πρόθεμα πρέπει να αποφεύγονται.
    • Ένα πρόθεμα πρέπει να είναι μοναδικό και να χρησιμοποιείται μόνο μία φορά.
    • Αν ένα σύμβολο έχει το ίδιο όνομα και πρόθεμα με ένα σύστημα συμβόλου, μπορεί να αντικαταστήσει αυτό.
  • Περιορισμοί Αρχείων
    • Μέγιστο μέγεθος αρχείου μετά την καθαρισμό: 10 kB. Τα μεγαλύτερα αρχεία απορρίπτονται.
    • Τα αρχεία SVG πρέπει να είναι καθαρά:
      • Οι αλλαγές γραμμής αφαιρούνται αυτόματα.
      • Τα ακόλουθα στοιχεία διαγράφονται: <title>, <desc>, <script>, <image>, <style>, <foreignObject>.
      • Τα ακόλουθα χαρακτηριστικά διαγράφονται: style, fill, stroke, color, stop-color, flood-color, lighting-color.
      • Τα σύμβολα με ενσωματωμένα scripts, εικόνες, CSS ή εξωτερικές πηγές απορρίπτονται.
      • Αν τα στυλ περιέχουν χρώματα ή μπλοκ στυλ, η εισαγωγή μπορεί επίσης να απορριφθεί.
  • Απαιτήσεις Κεφαλίδας SVG
    • Πρέπει να περιέχει: viewBox, width και height. Τα λείπωντα δεδομένα, αν είναι δυνατό, συμπληρώνονται αυτόματα.
    • Πρέπει να περιέχει το namespace: xmlns="http://www.w3.org/2000/svg". Αν λείπει ή είναι λανθασμένο, συμπληρώνεται αυτόματα.
    • Το όνομα του συμβόλου πρέπει να ταιριάζει ακριβώς στις διαστάσεις, διαφορετικά το σύμβολο απορρίπτεται.
    • Οι διαστάσεις πρέπει να είναι τετραγωνικές (πλάτος = ύψος). Προεπιλογή: 24px.
    • Πρέπει να αποφεύγονται οι αντίθετοι στυλ ή οι ανεπαρκείς διαστάσεις.
  • Γενικά
    • Κάποια κακά σχεδιασμένα σύμβολα μπορούν να επιβραδύνουν σημαντικά την εμφάνιση ή ακόμη και να προκαλέσουν σφάλματα.
    • Προσοχή στα πνευματικά δικαιώματα των συμβόλων.
    • Όλα τα διανύσματα στρογγυλοποιούνται σε τρεις δεκαδικές θέσεις.

Δομή

  • Το αρχείο iconset.ini είναι απαραίτητο για να αναγνωριστεί το σύνολο συμβόλων.
    • Μπορεί να βρίσκεται στη ρίζα του ZIP ή σε έναν υποκατάλογο.
    • Πρέπει να είναι σε πεζά (iconset.ini).
    • Τα ονόματα αρχείων συμβόλων δεν είναι case-sensitive.
  • Η εισαγωγή δεν αναζητά αυτόματα αρχεία SVG.
    • Ο φάκελος των συμβόλων πρέπει να ορίζεται εκφραστικά στο iconset.ini (προσοχή στην περίπτωση).
    • Στο πρότυπο αρχείου ZIP έχει οριστεί ένας φάκελος με όνομα icons/.
  • Υποκατάλογοι
    • Οι υποκατάλογοι στον ορισμένο φάκελο (icons/) χρησιμεύουν ως κατηγορίες.
    • Τα ονόματα των συμβόλων πρέπει να είναι μοναδικά σε όλες τις κατηγορίες.
    • Κανόνες ονομάτων στον φάκελο συμβόλων:
      • Ελάχιστο: Μόνο διαστάσεις και επέκταση αρχείου (π.χ. 24.svg).
      • Εκδόσεις όπως filled24.svg ή round_filled_24.svg είναι έγκυρες.
      • Αρχεία με πολλαπλούς αριθμούς (π.χ. 24_48.svg) είναι άκυρα.
      • Οι εκδόσεις στυλ αναγνωρίζονται από:
        • Γεμάτο: Πρέπει να περιέχει filled ή fill.
        • Στρογγυλό: Πρέπει να περιέχει round.
        • Αιχμηρό: Πρέπει να περιέχει sharp.
        • Στρογγυλό και αιχμηρό δεν μπορούν να συνδυαστούν μεταξύ τους.
      • Αν ισχύουν πολλές κανόνες, χρησιμοποιείται το τελευταίο αναγνωρισμένο αρχείο (η επιλογή μπορεί να φαίνεται τυχαία).
  • Άλλοι Κανόνες
    • Δεν αναζητούνται εμβοθισμένοι υπο-υποκατάλογοι (αυτές μπορούν να χρησιμοποιηθούν για backup ή πρωτότυπα).
    • Τα αρχεία χωρίς .svg αγνοούνται.
    • Σε έναν φάκελο συμβόλων μπορεί να υπάρχει ένα αρχείο με όνομα tags.txt για να προστεθούν πρόσθετα ετικέτες αναζήτησης.
      • Οι ετικέτες μπορούν να χωριστούν με ,, ; ή αλλαγές γραμμής.

Ειδικά Σύνολα Συμβόλων

Υπάρχουν επίσης διάφορα ειδικά σύνολα συμβόλων που μπορούν να εισαχθούν όπως τα δικά σας σύνολα συμβόλων, ωστόσο δεν χρειάζεται να ρυθμίζονται σύμφωνα με τις παραπάνω οδηγίες.

Hass Hue Icons

Ένα από αυτά είναι το hass-hue-icons από τη σελίδα Gibhub. Αυτό είναι ένα πρόσθετο σύνολο συμβόλων Hue της κοινότητας του Home Assistant HASS και μπορεί να χρησιμοποιηθεί μόνο για μη εμπορικά έργα, καθώς βρίσκεται υπό την Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International-License. Για αυτό το λόγο, το σύνολο συμβόλων δεν παρέχεται με το Antcas Control. Τα σύμβολα μπορούν, ωστόσο, να εισαχθούν οποιαδήποτε στιγμή ως νέο σύνολο συμβόλων στο πρόγραμμα με το αρχείο ZIP hass-hue-icons-main.zip. Παρακαλώ σημειώστε τις όρους χρήσης του έργου στη σελίδα της Github.

Πηγή: https://github.com/arallsopp/hass-hue-icons.

Material Design Icons από Pictogrammers

Ένα άλλο είναι αυτό των Pictogrammers. Για αυτό, το αρχείο mdi-###.json πρέπει να συσκευαστεί σε ένα αρχείο ZIP και να εισαχθεί. Το αρχείο μπορεί να βρεθεί και να κατεβεί από την κονσόλα ανάπτυξης του προγράμματος περιήγησης. Προσπαθούμε να συνδυάσουμε τα σύμβολα περιγράμματος με αυτά που είναι γεμάτα. Η βιβλιοθήκη είναι σχεδόν ίδια με τα Material Symbols. Ωστόσο, υπάρχουν πολλές επεκτάσεις της κοινότητας. Αν θέλετε να ενσωματώσετε άλλα σύνολα συμβόλων στη βιβλιοθήκη, μπορείτε να μας ρωτήσετε.

Πηγή: https://pictogrammers.com/library/mdi/

Υποσελίδες