Vai al contenuto principale

Scrivere un tema

Come cambiare l'aspetto di BeeBEEP modificando il suo file del tema, e che cosa controlla ogni token di quel file.

Per: sviluppatori · Da BeeBEEP 6.0.0 · Aggiornata il

L'intero aspetto di BeeBEEP -- ogni colore, raggio degli angoli, misura e dimensione del carattere, nella versione chiara e in quella scura -- sta in un solo file QML. Questa pagina è per un grafico o uno sviluppatore che vuole cambiare l'aspetto di BeeBEEP: dice dove si trova il file, come modificarlo in sicurezza e che cosa controlla ogni token. Non serve cambiare nessun codice.

Come funziona il tema

Il tema è il file assets/themes/beebeep-custom-theme.qml dell'albero dei sorgenti: un solo QtObject con una proprietà per ogni token. BeeBEEP lo legge quando si avvia, e ogni schermata prende da esso i propri colori e le proprie dimensioni.

Le due palette sono nello stesso file. Ogni colore è scritto con il valore scuro per primo e quello chiaro per secondo:

property color surfaceColor: dark ? "#171D23" : "#FFFFFF"

La proprietà dark è impostata da BeeBEEP, mai da te. Segue la scelta in Impostazioni > Aspetto > Tema: Segui il tema di sistema (il valore predefinito; cambia insieme al dispositivo), Chiaro o Scuro. Il cambiamento è immediato, senza riavvio. Per cambiare il tema chiaro modifica il secondo valore di una riga, per cambiare il tema scuro il primo.

Alcuni token hanno un solo valore che vale per entrambi i temi (il badge dei messaggi non letti, la schermata iniziale).

Dove si trova il file

BeeBEEP cerca beebeep-custom-theme.qml in una cartella chiamata themes accanto al suo eseguibile (su macOS, nella sua cartella dei dati: vedi sotto). Se il file è lì e si carica, viene usato; altrimenti BeeBEEP usa la copia dello stesso file incorporata nel programma.

Una compilazione dai sorgenti mette themes accanto all'eseguibile che produce, e aggiorna la copia da assets/themes ogni volta che quel file cambia (su macOS ricompila invece la copia incorporata nel programma).

Windows

Lo zip portatile contiene la cartella come themes accanto a beebeep.exe, nella cartella in cui l'hai estratto. L'installer e l'MSI la installano come C:\Program Files\BeeBEEP\themes\beebeep-custom-theme.qml, un file che per modificarlo richiede i diritti di amministratore, e ogni installazione successiva di una nuova versione rimette sopra al tuo il file di quella versione: tieni la tua copia fuori dalla cartella di BeeBEEP.

macOS

Un'app su macOS è firmata, e nulla al suo interno può essere modificato, quindi la cartella themes non è nell'app. Creala nella cartella dei dati di BeeBEEP, ~/Library/Preferences/MarcoMastroddiSW/BeeBEEP/themes, e copiaci il file (oppure nella cartella indicata con --data-folder, se BeeBEEP viene avviato con questa opzione).

Linux

Il pacchetto tar.gz contiene la cartella themes accanto all'eseguibile beebeep. Il pacchetto deb la installa come /usr/lib/beebeep/themes/beebeep-custom-theme.qml, che per essere modificato richiede i diritti di amministratore.

Modificare il tema

  1. Copia il file e conserva la copia: ti serve per tornare indietro.
  2. Modifica i valori dopo i due punti. Mantieni la forma di ogni riga: la parola property, un tipo, il nome, i due punti e il valore.
  3. Salva e avvia di nuovo BeeBEEP. Usa Impostazioni > Aspetto > Tema per guardare entrambe le palette.

Regole:

  • Un colore è un nome che Qt conosce (white, gray) oppure una stringa esadecimale, #RRGGBB, o #AARRGGBB con la trasparenza per prima (#8814213A).
  • Un raggio o una dimensione è un numero di pixel.
  • Una dimensione del carattere è in punti, scritta rispetto alla dimensione del testo del sistema (baseFontPointSize + 9), così l'intera app segue la dimensione del testo impostata sul dispositivo. Non trasformarla in un numero fisso.
  • Non aggiungere, rimuovere o rinominare una proprietà, e non toccare dark. Una nuova proprietà non fa nulla finché una schermata non la legge per nome.
  • Mantieni la riga import QtQuick e il QtObject { } più esterno.

Catalogo dei token

Ogni token del file, con il suo valore predefinito. Un token il cui valore predefinito è lo stesso nelle due colonne ha un solo valore per entrambi i temi.

Superfici

TokenChiaroScuroCosa colora
backgroundColor#F4F6F8#0F1418Lo sfondo della finestra, dietro a ogni schermata, e il fondo delle schede delle Impostazioni e del campo di ricerca.
surfaceColor#FFFFFF#171D23Un elenco o una scheda sopra lo sfondo: le righe delle chat e dei contatti, le schede delle Impostazioni, i popup.
headerColor#FFFFFF#1C242BLa cornice dell'app: le intestazioni delle schermate, la barra delle schede in basso, la barra laterale di una finestra larga, la barra di composizione dei messaggi.
chatBackgroundColor#EDF1F4#0F1418Lo sfondo dell'elenco dei messaggi, leggermente colorato perché un fumetto ricevuto risalti.
dividerColor#E3E7EB#2A343DLe sottili linee di separazione tra le righe di un elenco e sotto le intestazioni.
dialogColor#FFFFFF#2B353ECiò che sta sopra a tutto il resto: una finestra di dialogo, il menu di un messaggio. Nel tema scuro è più chiaro di qualsiasi fumetto o scheda, così appare sollevato rispetto a loro.
dialogBorderColor#E3E7EB#3A4651Il bordo di quelle finestre di dialogo e di quei menu.
modalDimColor#12000000#80000000Il velo che una finestra di dialogo stende sul resto della finestra; più forte nel tema scuro, altrimenti non si vedrebbe su un fondo quasi nero.

Testo

TokenChiaroScuroCosa colora
textPrimaryColor#14202B#E8EDF1Il testo normale da leggere: nomi, testo dei messaggi, titoli, icone delle intestazioni.
textSecondaryColor#5F6E7B#98A6B3Il testo attenuato: orari, didascalie, stato di consegna, anteprime negli elenchi, segnaposto.
textDisabledColor#9AA6B1#5F6E7BIl testo inattivo: l'etichetta di un controllo disattivato, l'anello di un pulsante di opzione non selezionato.

Marchio

TokenChiaroScuroCosa colora
accentColor#0277BD#4FC3F7Il blu di BeeBEEP: il pulsante più, i link, la scheda selezionata, la freccia del pulsante per saltare ai non letti, le spunte di lettura.
accentStrongColor#01579B#81D4FAL'accento mentre è premuto o sotto il puntatore.
accentSoftColor#E3F2FB#123B52Un riempimento morbido con l'accento: la pillola della scheda selezionata, un filtro selezionato, il riquadro dell'icona di una riga delle Impostazioni, la scheda del file in un fumetto.
textOnAccentColor#FFFFFF#0F1418Testo e icone disegnati sopra l'accento, come la freccia del pulsante di invio.
honeyColor#F5B301#FFC93CIl colore miele, firma di BeeBEEP, usato con parsimonia: il chip della cifratura end-to-end, il pallino di attività sull'icona dei trasferimenti di file, la stella dei messaggi importanti, il badge di un messaggio vocale non ascoltato, il bordo della corrispondenza corrente di una ricerca.
honeySoftColor#FFF4D6#3A2E0FUn riempimento morbido color miele: il chip della cifratura end-to-end.
textOnHoneyColor#3A2A00#FFE9A8Testo e icone disegnati sopra il riempimento morbido color miele.

Fumetti dei messaggi

TokenChiaroScuroCosa colora
bubbleOwnColor#D7ECFA#1D4B66Il riempimento di un messaggio che hai inviato.
bubbleReceivedColor#FFFFFF#232C34Il riempimento di un messaggio inviato da qualcun altro.
bubbleBorderColor#E3E7EB#2A343DIl sottile bordo di un fumetto ricevuto; i tuoi fumetti non ne hanno.
searchMatchColor#FFD54F#7A5C00Lo sfondo dietro una parola trovata dalla ricerca dentro una chat.

Messaggi vocali

TokenChiaroScuroCosa colora
voiceWaveformPlayedColor#0277BD#4FC3F7Le barre della forma d'onda già riprodotte, e il punto della posizione corrente.
voiceWaveformUnplayedColor#9DB2C2#5E7282Le barre della forma d'onda ancora da riprodurre.
voiceBadgeUnplayedColor#F5B301#FFC93CIl badge con il microfono su un messaggio vocale ricevuto che nessuno ha ancora ascoltato.
voiceBadgeUnplayedIconColor#3A2A00#3A2A00Il simbolo del microfono su quel badge.
voiceBadgePlayedColor#E3E7EB#2A343DIl badge con il microfono dopo che il messaggio è stato ascoltato, e sempre sui tuoi messaggi.
voiceBadgePlayedIconColor#5F6B76#9AA7B2Il simbolo del microfono su quel badge.

Stato

TokenChiaroScuroCosa colora
successColor#2E9E5B#4CC276Uno stato completato, come un trasferimento terminato.
warningColor#E08A00#F2A93BUn avviso o uno stato in corso, come un trasferimento ancora in attesa.
dangerColor#D64545#EF6B6BUno stato di errore, come un trasferimento fallito, e il banner di assenza di connessione.
importantColor#F5B301#FFC93CLa stella di un messaggio segnato come importante.

Badge e presenza

TokenChiaroScuroCosa colora
unreadBadgeColor#0277BD#0277BDLa pillola con il numero dei non letti su una riga di chat, sulla scheda Chat e sul pulsante per saltare ai non letti.
textOnUnreadBadgeColor#FFFFFF#FFFFFFIl numero dentro la pillola dei non letti.
onlineStatusColor#2E9E5B#4CC276Il pallino accanto a un contatto online.
offlineStatusColor#C3CCD4#4A5866Il pallino accanto a un contatto offline, e la guida di un interruttore spento.
notRespondingStatusColor#8E99A4#7C8A97Il pallino di un contatto che è online ma ha smesso di rispondere.

Campi di input e schede

TokenChiaroScuroCosa colora
inputFieldColor#FFFFFF#232C34Il riempimento del campo di composizione dei messaggi e dei campi di testo.
inputBorderColor#D5DCE2#2A343DIl bordo degli stessi.
tabActiveColor#0277BD#4FC3F7L'icona e l'etichetta della scheda selezionata.
tabInactiveColor#6B7A87#8A98A5L'icona e l'etichetta di tutte le altre schede.

Avatar

TokenChiaroScuroCosa colora
colorSwatchBorderColor#40000000#30FFFFFFIl sottile bordo attorno a un avatar o a un campione di colore.
TokenChiaroScuroCosa colora
infoBannerColor#E3F2FB#123B52Lo sfondo di una barra di informazione o di azione: segna tutto come letto, la conferma della copia, la barra della selezione multipla, la barra della risposta, il banner dei trasferimenti di file.
infoBannerBorderColor#CFE4F5#1B4A63Il bordo delle stesse barre.
pinnedBannerColor#FFF4D6#3A2E0FLo sfondo della barra del messaggio fissato.
pinnedBannerBorderColor#F0E0B0#4A3C14Il bordo della barra del messaggio fissato.
typingBannerColor#F4F6F8#171D23Lo sfondo del banner di chi sta scrivendo.
warningBannerColor#FFF3E0#3A2A0FLo sfondo dell'avviso sulla chiave di sicurezza in cima a una chat privata.
warningBannerBorderColor#FFCC80#6B4E1AIl bordo di quell'avviso.

Schermata iniziale

TokenChiaroScuroCosa colora
splashTopColor#0B2A3F#0B2A3FLa parte alta della sfumatura della schermata iniziale.
splashBottomColor#071A28#071A28La parte bassa della sfumatura della schermata iniziale.
splashTextColor#FFFFFF#FFFFFFIl nome e il testo principale della schermata iniziale.
splashMutedTextColor#9FB6C6#9FB6C6Lo slogan, la parola "Versione" e le righe più piccole della schermata iniziale; attenuato, il contorno di una cella di caricamento non ancora riempita.
splashHoneyColor#FFC93C#FFC93CIl miele della schermata iniziale: la seconda metà del nome, il bordo della cella dell'ape, le celle accese del favo, le celle di caricamento e il numero di versione.
splashCombColor#1C4A66#1C4A66Le sottili pareti del favo disegnato sul fondo della schermata iniziale.
splashCellColor#0F3852#0F3852L'interno della grande cella in cui sta l'ape.

Dimensioni del carattere

TokenPredefinitoCosa imposta
fontSizeCaptionsystem size - 1Il testo piccolo: orari, didascalie, etichette di stato, etichette delle schede.
fontSizeBodysystem sizeIl testo normale: testo dei messaggi, titoli delle righe degli elenchi.
fontSizeTitlesystem size + 9Il grande titolo della schermata di una scheda.

Forme

TokenPredefinitoCosa imposta
bubbleRadius16Il raggio degli angoli di un fumetto di messaggio.
cardRadius14Il raggio degli angoli di una scheda e della casella di input dei messaggi.
chipRadius10Il raggio degli angoli di un chip: un filtro, la data in una chat, il chip della cifratura.
iconTileRadius9Il raggio degli angoli del piccolo quadrato dietro l'icona di una riga delle Impostazioni.
buttonRadius8Il raggio degli angoli di ogni pulsante con una parola: Apri, Accetta, Share, i pulsanti grandi di una pagina.
buttonBorderWidth1Lo spessore del contorno di un pulsante; un pulsante che ha il focus della tastiera lo disegna due volte più spesso.

Dimensioni

TokenPredefinitoCosa imposta
touchTargetSize44La larghezza e l'altezza minime di tutto ciò che tocchi: i pulsanti delle intestazioni, il pulsante di invio.
avatarListSize48Il diametro dell'avatar su una riga di un elenco.
avatarHeaderSize40Il diametro dell'avatar nell'intestazione di una conversazione.
avatarProfileSize104Il diametro dell'avatar nella schermata Tu.
iconSize24La dimensione delle icone delle intestazioni e delle barre degli strumenti.
tabIconSize26La dimensione delle icone della barra delle schede e della barra laterale.

Tutte le pagine della guida