Simboli

La libreria Simboli: le undici librerie di sistema e I miei simboli, la ricerca e i filtri della galleria, l'ispettore con i suoi ingressi vivi e i suoi morsetti, l'editor Nuovo simbolo utente e ogni natura di zona attiva, Importa simbolo…, Esporta pacchetto, Duplica, Copia l'istruzione per la chat, e dove si usa un simbolo.

Simboli è la quarta categoria sotto la radice Risorse: il disegno che un componente Simbolo di dashboard disegna e anima. Il pannello è intitolato « Simboli », con la riga « Librerie pensate per dashboard moderne, banchi di prova, prodotti connessi, schemi normalizzati, sistemi industriali e impianti. Ogni simbolo di sistema è ispezionabile e può essere duplicato in I miei simboli. » e la pillola di conteggio. Leggere e ispezionare richiedono Visualizzare Logic; creare, importare, duplicare, modificare ed eliminare richiedono Configurare Logic. Il formato di file con cui un simbolo viaggia è descritto in Simboli SVG portabili.

Le librerie

Le librerie di sistema sono disegni originali Ganter Lab, compilati nel prodotto e in sola lettura: un aggiornamento le sostituisce senza toccare i dati della tua stazione. Ogni definizione porta un riferimento stabile system:<key>, la sua libreria e la sua categoria, una descrizione, etichette di ricerca, la norma che le si applica e i metadati di origine e di licenza.

La galleria

Sopra le schede: Cerca (testo segnaposto « Nome, categoria o parola chiave »; la ricerca confronta il nome, la descrizione, la categoria, la norma e le etichette del simbolo, senza distinguere maiuscole e minuscole; la libreria si sceglie con il suo filtro), Libreria (« Tutte le librerie (530) » oppure una libreria con il suo conteggio; sceglierne una azzera la categoria e mostra la descrizione della libreria sotto i filtri), Categoria (« Tutte le categorie » oppure una categoria della libreria scelta), Origine e Per pagina. Una scheda mostra la libreria, un'anteprima nelle proporzioni naturali del disegno, il nome, la categoria, l'origine (Sistema o Miei) e una riga di capacità: « Statico », « 1 ingresso » o « N ingressi », seguite da « · N morsetti » quando il simbolo dichiara morsetti di collegamento. Un risultato vuoto dice « Nessun simbolo corrisponde a questi filtri. » con Azzera filtri. Quando i tuoi simboli non si sono potuti leggere, una nota dice « I miei simboli non è disponibile in questo momento. Sono elencate solo le librerie di sistema. » invece di far passare il pacchetto di sistema per l'intero catalogo.

L'ispettore

Selezionare una scheda apre l'ispettore accanto alla galleria:

• Il nome e un contrassegno: Sistema · sola lettura, Il mio simbolo, oppure Bozza non salvata mentre l'editor è aperto.
• La libreria, la categoria e la norma; la descrizione.
• Ingombro (la dimensione consigliata sulla dashboard, in celle, larghezza × altezza) e Adattamento (Contieni, Estendi, Estendi in X o Estendi in Y).
• « N ingressi · N morsetti di collegamento », oppure « solo visivo » quando non ci sono morsetti.
• Provenienza del disegno, una sezione espandibile con l'origine e, per un simbolo di sistema, la licenza.
• Le azioni: Esporta pacchetto per ogni ruolo; per un simbolo di sistema Duplica in I miei simboli, per i tuoi Modifica ed Elimina (solo per i ruoli che configurano).
• La scena di anteprima: il disegno depurato, reso dallo stesso runtime di una dashboard, con una maniglia disegnata all'ancoraggio di ogni morsetto. Un disegno che non si può rendere lascia la scena vuota con « Anteprima non disponibile » e il motivo. Quando il depuratore ha dovuto correggere il markup, una sezione espandibile « L'anteprima usa SVG depurato » elenca le correzioni (al massimo otto, poi « Altre N correzioni non sono mostrate. »).
• Ingressi: « Le costanti temporanee riguardano solo questa anteprima. » e Azzera gli ingressi. Una sezione per ogni zona attiva dichiarata, con il suo nome, l'effetto che comanda, una frase che descrive la corrispondenza, l'intervallo di ingresso e l'elemento di destinazione (#id), e un comando per provarla: un numero (con un cursore quando l'intervallo di ingresso è finito), un interruttore Attivo/Inattivo, una casella di testo, oppure un selettore di colore con una casella del valore di colore. « Questo simbolo non dichiara ingressi dinamici. » quando non ce ne sono; una dichiarazione non valida mostra il suo errore invece di un comando. Le costanti che imposti qui non vengono mai salvate e non arrivano mai a una dashboard.

Gli effetti e il modo in cui l'ispettore li descrive:

Nuovo simbolo utente

Il verbo sopra la riga Simboli apre l'editor nella colonna della galleria (« Nuovo simbolo utente »: « Comporre SVG inerte e le sue zone attive nominate per la dashboard. »); l'ispettore segue la bozza non salvata mentre scrivi, così provi il simbolo prima di crearlo.

Le regole delle zone attive, ciascuna segnalata sotto i campi con la riga in errore incorniciata: il nome deve essere un identificatore (una lettera o _ per primo, poi lettere, cifre, _, ., : o -) ed essere univoco; l'id dell'elemento deve esistere nel markup; Text punta solo a text e tspan; Fill e FillColor puntano alle forme riempibili, ai gruppi, a use e al testo; le altre nature puntano ai gruppi, a use, alle forme e al testo; Rotate, Rotazione continua e Scale richiedono che l'elemento porti data-ganter-pivot="x y"; ogni valore di intervallo deve essere finito; la coppia Y c'è per intero o non c'è, e solo per Translate e Scale; i colori attivo e inattivo devono essere un esadecimale, un token di tema come var(--color-success) o un nome di colore CSS; un elemento prende al massimo una zona attiva per canale (riempimento, contorno, spessore del contorno, oppure una per ogni altra natura); una zona attiva Rotazione continua attiva richiede una zona attiva Rotazione continua sullo stesso elemento.

Crea simbolo resta grigio finché resta un errore; Annulla o Indietro esce senza creare nulla. Al buon esito il registro delle azioni dice « Simbolo creato. » e la nuova scheda viene selezionata.

Modifica, Duplica, Elimina

Modifica (solo per i tuoi simboli) apre lo stesso editor con « Le modifiche valide di nome, SVG e zone attive si salvano da sole. »: una modifica valida viene salvata mezzo secondo dopo l'ultima battuta (« Simbolo salvato. »), e una bozza non valida non viene salvata e annulla il salvataggio in attesa, così il simbolo memorizzato non diverge mai da quello che l'ispettore mostra. Duplica in I miei simboli (simboli di sistema) copia il disegno, il riquadro di visualizzazione, l'adattamento, l'ingombro, le configurazioni di tipo, i morsetti e i suggerimenti in un simbolo indipendente chiamato « copia di <Name> » (« copia 2 di <Name> »… quando il nome è preso) e lo apre per la modifica (« Simbolo di sistema copiato in I miei simboli. »); la definizione di sistema non viene mai cambiata. Elimina chiede « Eliminare 'X'? Le dashboard che lo usano mostreranno un segnaposto. L'operazione non è reversibile. » (« Simbolo eliminato. »).

Importa simbolo…

Il secondo verbo sopra la riga è un selettore di file che accetta file .svg e .ganter-symbol.json di al massimo 1 MB (« Il file del simbolo supera il limite di 1 MB. »). Il contenuto decide la strada:

• SVG grezzo (il contenuto comincia con <) viene importato come disegno solo visivo: nessuna zona attiva e nessun morsetto. Il depuratore lo corregge e il registro delle azioni conta le correzioni (« Simbolo importato come nuova risorsa; sono stati rimossi 3 elementi SVG non sicuri. »). Il nome è quello del file senza estensione.
• Un pacchetto Ganter symbol v2 (il contenuto comincia con {) viene importato per intero: nome, SVG, riquadro di visualizzazione, adattamento, ingombro, zone attive, configurazioni di tipo, morsetti e suggerimenti. Un pacchetto è severo: formato, versione e schema devono corrispondere, l'SVG deve essere già depurato (un pacchetto che avrebbe bisogno di correzioni viene rifiutato, non corretto), il riquadro di visualizzazione deve corrispondere alla radice SVG, e ogni morsetto, configurazione e suggerimento deve essere valido (il contratto). Il registro delle azioni nomina il primo problema (« Importazione del simbolo non riuscita: … »).

Un nome già usato da un tuo simbolo riceve un suffisso (« 2 », « 3 »…). Ogni importazione crea un nuovo simbolo e non ne sovrascrive mai uno.

Esporta pacchetto

Esporta pacchetto nell'ispettore scarica il simbolo selezionato, di sistema o tuo, come <name>.ganter-symbol.json: lo stesso pacchetto v2 che l'importazione legge, senza alcuna identità di stazione, così viaggia tra le stazioni (« Esportato <file>. »). Un simbolo il cui disegno non ha un riquadro di visualizzazione alla radice, o una delle cui zone attive porta un indirizzo di stazione, viene rifiutato (« Esportazione del simbolo non riuscita: … »).

Copia l'istruzione per la chat

Copia l'istruzione per la chat copia negli appunti un'istruzione autosufficiente per una chat IA esterna che non ha accesso alla stazione. Comincia con « Create a Ganter Lab symbol for me. Return ONLY the file content, either raw SVG or a single .ganter-symbol.json v2 package, with no commentary, so I can save it as a file and import it unchanged. », prosegue con il contratto v2 completo (i due ingressi accettati, l'involucro del pacchetto, i sedici ancoraggi globali, gli otto tipi di tratto, le nature di zona attiva e le loro regole, i token di tema, le regole di geometria dei morsetti, i limiti del depuratore e un pacchetto minimo valido) e finisce con come riportare indietro la risposta: salvare la risposta come file .svg o .ganter-symbol.json e importarlo qui. Lo stesso contratto è quello che leggono gli strumenti symbol_validate e symbol_import dell'agente, così una chat e un agente producono lo stesso file. Il registro delle azioni dice « Istruzione per la chat copiata. Incollarla in una chat IA e importare l'SVG che restituisce. » (oppure « Gli appunti hanno rifiutato la copia. »). Il verbo è disegnato per ogni ruolo, perché legge soltanto.

Dove si usa un simbolo

Il componente di dashboard Simbolo referenzia un simbolo come system:<key> o user:<id>, associa ogni zona attiva a un indirizzo di Logic, sceglie il tipo di tratto di ogni morsetto configurabile e unisce i morsetti con tratti disegnati nell'editor delle dashboard tramite i tipi di tratto. Un simbolo non ha un indirizzo di Logic proprio.

Che cosa non fa la libreria

Non disegna né sposta morsetti e percorsi interni, non modifica sul posto il disegno di sistema, non importa un pacchetto che avrebbe bisogno di correzioni, non tiene una cronologia delle versioni e non condivide da sola i tuoi simboli tra stazioni: esporta e importa il pacchetto.