Home /Modules/docs/README.IT.md

README.IT.md

docs/i18n/README.IT.md · 446 line(s) · markdown

<img align="right" src="../../images/sleela/sleela-medium-profile-permanent-icon-002.jpg" width="45" height="45" alt="SLeeLa">

SLeeLa 3.0 — Italia (IT)

<p align="center"><img src="https://github.com/mearvk/SLeeLa/blob/master/images/sleela/sleela-wordmark.svg" alt="SLeeLa — The Now. The Ingredient." width="560"></p> <p align="center"><img src="https://github.com/mearvk/SLeeLa/blob/master/images/sleela-programming-language-002.jpg" alt="SLeeLa Marketing Logo" width="560"></p>

<p align="center"><strong>Un linguaggio nativo per sistemi, con compilatore, ambiente di esecuzione ed ecosistema di macchine virtuali.</strong></p> <p align="center"><a href="https://github.com/mearvk/SLeeLa/actions"><img alt="GitHub Actions" src="https://img.shields.io/github/actions/workflow/status/mearvk/SLeeLa/test-suite.yml?branch=main&label=test%20suite"></a> <a href="../../docs/PLATFORM-SUPPORT.md"><img alt="Platform matrix" src="https://img.shields.io/badge/platforms-Linux%20%7C%20macOS%20%7C%20Windows-273238"></a></p>

Edizione internazionale per paese. Questo file raccoglie le versioni linguistiche previste per l’Italia. La traduzione tecnica viene realizzata per fasi. Le sezioni tradotte sono riportate integralmente; quelle ancora da tradurre sono indicate in modo esplicito.

The Now. The Ingredient. Un linguaggio di programmazione è più della sua sintassi: comprende il compilatore, l’ambiente di esecuzione, le librerie, gli strumenti e i contratti di piattaforma che rendono il software concretamente utilizzabile.

Aree di lavoro di SLeeLa. SLeeLa affronta Math, Object, Science e Reach, le quattro dimensioni del suo lavoro: ciò che è calcolabile (Math), l’oggetto definito nel catalogo di ciò che esiste (Object), lo studio disciplinato del vero (Science) e l’estensione delle capacità di un sistema verso altri sistemi e persone (Reach). Gli interessi nazionali restano validi: nessuna di queste quattro dimensioni li sostituisce. Quando un argomento riguarda gli interessi di una nazione, tale relazione viene mantenuta e documentata fedelmente, ad esempio nei campi di metadati di una classe metaOrigin e metaNationalSchedule.

I. Per iniziare

II. Novità

Aggiunte recenti al linguaggio, ai driver e alla libreria standard:

III. Compilazione e test

Prerequisiti: una toolchain C/C++ (GCC o Clang) e GNU Make; Python 3 per gli strumenti relativi a manifesti e flussi di lavoro; su Linux, anche i pacchetti di sviluppo X11/Xrandr per i prodotti di visualizzazione. Il comando make deps di ciascun modulo segnala o installa le dipendenze necessarie. La compilazione in impl/ si interrompe in sicurezza se il manifesto SHA-256 attendibile non viene rispettato; il Makefile principale lo richiama automaticamente.

Il modo più rapido per iniziare da un clone pulito:

make                                  # compilare tutto dalla radice del repository

Oppure compilare e testare soltanto il nucleo nativo:

make -C impl all                      # compilare soltanto il nucleo del compilatore e del runtime
bash ./test-suites/run-all.sh --all   # eseguire l’intera suite di test

Il comando make nella radice del repository compila tutti i prodotti (core, VM, codec, churn, antivirus e così via) e termina creando il registro e materializzandone la tabella di base. Un albero di lavoro compilato include quindi fin dall’inizio un registro verificabile.

Obiettivi principali:

make                     # compilare tutto (alias di make all; il registro viene creato per ultimo)
make all                 # stessa compilazione completa, indicata esplicitamente
sudo make install        # installare comandi e file di supporto del runtime (vedere § IV)
make clean               # rimuovere gli output di compilazione di tutti i sistemi integrati
make help                # mostrare tutti gli obiettivi del Makefile principale

Altri obiettivi utili:

make registry            # compilare solo il registro e materializzare la tabella
./build-registry.sh      # stessa operazione tramite script diretto
make tests               # compilare ed eseguire la suite di test
make ballum              # compilare la libreria di visualizzazione Ballum per questo sistema operativo
bin/install-modules      # installare/compilare i moduli in modo scaglionato per circa 10–20 minuti

L’obiettivo registry esegue build-registry.sh: compila il nucleo del registro, inserisce la tabella di base nell’archivio testuale portabile registry/build/sleela.sleelareg ed esporta lo script della tabella MySQL registry/build/registry.sql (tramite sleela registry export). Il registro può essere esaminato con sleela registry oppure registry/build/sleela-registry review. Consultare la guida al registro e l’architettura Registry 3.0.

Per i prerequisiti e le procedure specifiche di ciascuna piattaforma, fare riferimento alle guide di compilazione e test. La compilazione riuscita di un componente non dimostra che ogni libreria o piattaforma sia pronta per il rilascio.

IV. Installazione

Dopo aver compilato i prodotti nativi, installare i comandi e i file di supporto del runtime:

sudo make install
make install PREFIX="$HOME/.local"        # installazione per il solo utente, senza sudo
make install DESTDIR="$PWD/package-root" # installazione in una directory di staging del pacchetto
make install-check

L’installer convenzionale utilizza per impostazione predefinita /usr/local/bin, /usr/local/lib/sleela e /usr/local/share/sleela. Mantiene la configurazione di avvio esistente e non sovrascrive comandi preesistenti non tracciati dal repository. La disinstallazione rimuove soltanto i file registrati dall’installer; configurazione e dati runtime non tracciati vengono conservati.

Per una distribuzione guidata e mirata del solo pacchetto principale — i binari sleela, sleelvac e nordshrift, la libreria standard, i protocolli e i moduli di supporto — utilizzare l’installer pulito:

make clean-install       # installazione guidata del solo pacchetto principale

In primo luogo viene chiesto se installare il pacchetto principale; successivamente si sceglie l’ambito dell’installazione. In caso di esito positivo, può essere proposto un selettore facoltativo di moduli aggiuntivi selezionati. Il flusso interattivo completo e tutte le opzioni sono descritti in Installazione rapida e sicura.

V. Linguaggio e runtime

La grammatica normativa si trova in SLEELA.syntax. Il repository documenta attualmente la sintassi 3.0; la versione del compilatore/degli strumenti e la versione della sintassi del codice sorgente sono distinte. La superficie 3.0 aggiunge i marcatori documentali pure e gasoline (§30): due Preonem contestuali e dichiarativi, privi di effetti di esecuzione autonomi, che esprimono ciascuno la posizione di un documento attraverso la sua stessa onestà. La sintassi 3.0 riunisce le superfici linguistiche dalla 1.0 alla 2.9 in un’unica edizione normativa corrente, mantenendo i requisiti di versione minima per ciascuna funzionalità.

La precedente superficie 2.9 aggiunge i campi sequenziali @mix (§28): una classe può dichiarare più campi di istanza con lo stesso nome se ciascuno è contrassegnato con @mix. Sono trattati come un gruppo indicizzato (in ordine crescente per impostazione predefinita: 1,2,3,…, oppure definito manualmente tramite @mix(1,2,3,...); il numero di indici deve corrispondere al numero di campi). Sono inoltre incluse le famiglie di interi binari estesi con e senza segno, da int32 a int16777216 (§24) e da uint32 a uint16777216 (§25), che estendono long, int64 e int128 (§21); i documenti di supporto per le parole chiave (§22); e i Preonem: marcatori documentali dichiarativi author/authorial (§18), material/memory (§19–§20), determine (§23), object/field (§26), pure/gasoline (§30) e artifact (§35; uno stato di qualità legislativa valutato in relazione al tempo e allo spazio). Nel loro insieme sono denominati Preonem (§26.1).

La risoluzione degli overload dei costruttori e la delega ai costruttori this(...) e delle classi base sono esplicitamente escluse dal contratto di sintassi 1.8 verificato. Prima di fare affidamento su una funzionalità, consultare la grammatica e le note d’implementazione. Le nove unità sorgente SleelaDoc dichiarano ora #sleela 3.0; il controllo comune del compilatore accetta sintassi sorgente dalla 1.0 alla 3.0. La nuova documentazione API viene generata con make api-docs.

Il repository contiene un’implementazione nativa C/C++, riferimenti per la generazione SLVM, moduli della libreria standard, test, esempi e integrazioni di piattaforma. Lo stato di implementazione e convalida varia da modulo a modulo. Consultare la specifica pertinente e i risultati CI correnti, senza presumere un livello uniforme di completezza.

VI. Principi di progettazione

VII. Build antivirus e integrità

Il pacchetto antivirus Sleelavirin comprende uno scanner SHA-256 nativo, un adattatore ClamAV facoltativo, manifesti di integrità per sorgenti e indici e checksum per i pacchetti di piattaforma. Compilare e testare il pacchetto dalla radice del repository:

make antivirus
make antivirus-test
make antivirus-integrity
make antivirus-integrity-check MANIFEST=build/INTEGRITY-MANIFEST.json

Il manifesto di integrità viene generato in antivirus/build/. Comprende input di codice sorgente e documentazione tracciati dal repository, oltre ai file protetti degli indici delle firme; esclude gli output generati e la cache ClamAV modificabile. Gli snapshot dei database ClamAV dispongono di manifesti propri. Gli archivi ZIP di rilascio includono INTEGRITY-MANIFEST.json, SHA256SUMS e un file .sha256 associato. Confrontare gli hash degli archivi scaricati con un valore attendibile ottenuto indipendentemente: un checksum memorizzato accanto a un archivio non costituisce una firma dell’editore. Consultare la guida Sleelavirin, la lista di controllo di sicurezza e il workflow di build antivirus.

Una release è considerata verificata soltanto quando i job CI pertinenti hanno esito positivo per l’esatto commit della release e gli artefatti risultanti sono stati controllati.

VIII. Temi dell’editor SLeeLa — Vim ed Emacs

SLeeLa include un insieme coordinato di schemi cromatici scuri e professionali per Vim ed Emacs, oltre a un’utilità nativa per le palette C/C++. Lo schema originale American Professional rimane quello predefinito. Dieci palette complementari offrono ispirazioni progettuali culturali e istituzionali diverse; sono interpretazioni grafiche, non rappresentazioni ufficiali di alcuna nazione, cultura, corte o istituzione.

Gli undici schemi e i relativi colori

SchemaSfondoPrimo pianoParole chiaveTipiStringheCommenti
American Professional<span style="display:inline-block;width:1em;height:1em;background:#101820;border:1px solid #888"></span> #101820<span style="display:inline-block;width:1em;height:1em;background:#F4F7FA;border:1px solid #888"></span> #F4F7FA<span style="display:inline-block;width:1em;height:1em;background:#7FB3FF;border:1px solid #888"></span> #7FB3FF<span style="display:inline-block;width:1em;height:1em;background:#73DACA;border:1px solid #888"></span> #73DACA<span style="display:inline-block;width:1em;height:1em;background:#F2C078;border:1px solid #888"></span> #F2C078<span style="display:inline-block;width:1em;height:1em;background:#8A96A3;border:1px solid #888"></span> #8A96A3
Pan-Eurasian<span style="display:inline-block;width:1em;height:1em;background:#111827;border:1px solid #888"></span> #111827<span style="display:inline-block;width:1em;height:1em;background:#F0F2F5;border:1px solid #888"></span> #F0F2F5<span style="display:inline-block;width:1em;height:1em;background:#7AA7E8;border:1px solid #888"></span> #7AA7E8<span style="display:inline-block;width:1em;height:1em;background:#69C9B3;border:1px solid #888"></span> #69C9B3<span style="display:inline-block;width:1em;height:1em;background:#D7B56D;border:1px solid #888"></span> #D7B56D<span style="display:inline-block;width:1em;height:1em;background:#8995A5;border:1px solid #888"></span> #8995A5
Russian and Slavic — Medium<span style="display:inline-block;width:1em;height:1em;background:#202733;border:1px solid #888"></span> #202733<span style="display:inline-block;width:1em;height:1em;background:#E8EAF0;border:1px solid #888"></span> #E8EAF0<span style="display:inline-block;width:1em;height:1em;background:#A9C0DD;border:1px solid #888"></span> #A9C0DD<span style="display:inline-block;width:1em;height:1em;background:#8FC4B2;border:1px solid #888"></span> #8FC4B2<span style="display:inline-block;width:1em;height:1em;background:#D6BD8B;border:1px solid #888"></span> #D6BD8B<span style="display:inline-block;width:1em;height:1em;background:#9AA3AF;border:1px solid #888"></span> #9AA3AF
Central Asian / Silk Road<span style="display:inline-block;width:1em;height:1em;background:#1C2529;border:1px solid #888"></span> #1C2529<span style="display:inline-block;width:1em;height:1em;background:#F5F0E5;border:1px solid #888"></span> #F5F0E5<span style="display:inline-block;width:1em;height:1em;background:#7FADE0;border:1px solid #888"></span> #7FADE0<span style="display:inline-block;width:1em;height:1em;background:#45C6C2;border:1px solid #888"></span> #45C6C2<span style="display:inline-block;width:1em;height:1em;background:#D9B56D;border:1px solid #888"></span> #D9B56D<span style="display:inline-block;width:1em;height:1em;background:#92A3A0;border:1px solid #888"></span> #92A3A0
East Asian<span style="display:inline-block;width:1em;height:1em;background:#171A1C;border:1px solid #888"></span> #171A1C<span style="display:inline-block;width:1em;height:1em;background:#F2EFE7;border:1px solid #888"></span> #F2EFE7<span style="display:inline-block;width:1em;height:1em;background:#D97878;border:1px solid #888"></span> #D97878<span style="display:inline-block;width:1em;height:1em;background:#72C7A5;border:1px solid #888"></span> #72C7A5<span style="display:inline-block;width:1em;height:1em;background:#D8B76A;border:1px solid #888"></span> #D8B76A<span style="display:inline-block;width:1em;height:1em;background:#969F9B;border:1px solid #888"></span> #969F9B
ICC — Corte penale internazionale<span style="display:inline-block;width:1em;height:1em;background:#0E1A2B;border:1px solid #888"></span> #0E1A2B<span style="display:inline-block;width:1em;height:1em;background:#EAF0F7;border:1px solid #888"></span> #EAF0F7<span style="display:inline-block;width:1em;height:1em;background:#5B8FD6;border:1px solid #888"></span> #5B8FD6<span style="display:inline-block;width:1em;height:1em;background:#7FB7C9;border:1px solid #888"></span> #7FB7C9<span style="display:inline-block;width:1em;height:1em;background:#D9B25A;border:1px solid #888"></span> #D9B25A<span style="display:inline-block;width:1em;height:1em;background:#7E8CA0;border:1px solid #888"></span> #7E8CA0
SCOTUS — Corte Suprema degli Stati Uniti<span style="display:inline-block;width:1em;height:1em;background:#1A1416;border:1px solid #888"></span> #1A1416<span style="display:inline-block;width:1em;height:1em;background:#F3EEE6;border:1px solid #888"></span> #F3EEE6<span style="display:inline-block;width:1em;height:1em;background:#9E2B35;border:1px solid #888"></span> #9E2B35<span style="display:inline-block;width:1em;height:1em;background:#8FA9B8;border:1px solid #888"></span> #8FA9B8<span style="display:inline-block;width:1em;height:1em;background:#C9A24B;border:1px solid #888"></span> #C9A24B<span style="display:inline-block;width:1em;height:1em;background:#8C8178;border:1px solid #888"></span> #8C8178
Greek (Hellenic)<span style="display:inline-block;width:1em;height:1em;background:#0A1A30;border:1px solid #888"></span> #0A1A30<span style="display:inline-block;width:1em;height:1em;background:#FFFFFF;border:1px solid #888"></span> #FFFFFF<span style="display:inline-block;width:1em;height:1em;background:#2E7BD6;border:1px solid #888"></span> #2E7BD6<span style="display:inline-block;width:1em;height:1em;background:#5E9FE0;border:1px solid #888"></span> #5E9FE0<span style="display:inline-block;width:1em;height:1em;background:#9FC3EC;border:1px solid #888"></span> #9FC3EC<span style="display:inline-block;width:1em;height:1em;background:#6E86A6;border:1px solid #888"></span> #6E86A6
Turkish (Al Bayrak)<span style="display:inline-block;width:1em;height:1em;background:#2A0609;border:1px solid #888"></span> #2A0609<span style="display:inline-block;width:1em;height:1em;background:#FFFFFF;border:1px solid #888"></span> #FFFFFF<span style="display:inline-block;width:1em;height:1em;background:#F23D48;border:1px solid #888"></span> #F23D48<span style="display:inline-block;width:1em;height:1em;background:#F0A9AE;border:1px solid #888"></span> #F0A9AE<span style="display:inline-block;width:1em;height:1em;background:#F0C9A9;border:1px solid #888"></span> #F0C9A9<span style="display:inline-block;width:1em;height:1em;background:#A8767A;border:1px solid #888"></span> #A8767A
Kiro<span style="display:inline-block;width:1em;height:1em;background:#0B0B12;border:1px solid #888"></span> #0B0B12<span style="display:inline-block;width:1em;height:1em;background:#F5F5FA;border:1px solid #888"></span> #F5F5FA<span style="display:inline-block;width:1em;height:1em;background:#A98EDA;border:1px solid #888"></span> #A98EDA<span style="display:inline-block;width:1em;height:1em;background:#6E8BE0;border:1px solid #888"></span> #6E8BE0<span style="display:inline-block;width:1em;height:1em;background:#E8C547;border:1px solid #888"></span> #E8C547<span style="display:inline-block;width:1em;height:1em;background:#6A6482;border:1px solid #888"></span> #6A6482
SLeeLa<span style="display:inline-block;width:1em;height:1em;background:#08080E;border:1px solid #888"></span> #08080E<span style="display:inline-block;width:1em;height:1em;background:#FFFFFF;border:1px solid #888"></span> #FFFFFF<span style="display:inline-block;width:1em;height:1em;background:#B07CFF;border:1px solid #888"></span> #B07CFF<span style="display:inline-block;width:1em;height:1em;background:#5A7CFF;border:1px solid #888"></span> #5A7CFF<span style="display:inline-block;width:1em;height:1em;background:#FFD21E;border:1px solid #888"></span> #FFD21E<span style="display:inline-block;width:1em;height:1em;background:#6E5F9E;border:1px solid #888"></span> #6E5F9E

Colori delle bandiere nazionali (palette di origine)

Gli schemi greco e turco derivano dai colori ufficiali delle bandiere nazionali dei due paesi, qui riportati con i valori esadecimali pubblicati. Gli sfondi e gli accenti degli schemi sopra sono interpretazioni scurite e adatte agli editor; la tabella seguente conserva i colori di riferimento esposti a livello nazionale.

PaeseColoreEsadecimaleFondamento e significato
GreciaBlu#0D5EAFBlu della bandiera nazionale (legge 851/1978). Il cielo e i mari; in araldica, azzurro.
GreciaBianco#FFFFFFBianco della bandiera nazionale. Purezza della lotta per l’indipendenza; la croce rappresenta il cristianesimo ortodosso orientale.
TürkiyeRosso (al bayrak)#E30A17Rosso della bandiera nazionale (legge turca sulla bandiera). Il campo; per tradizione, il sangue dei martiri e la sovranità ottomana.
TürkiyeBianco#FFFFFFBianco della bandiera nazionale. La mezzaluna e la stella: pace, purezza e simbolo dell’eredità turco-islamica.

Gli schemi utilizzano il bianco nazionale come primo piano e il blu nazionale esatto (#0D5EAF) o il rosso (#E30A17) per parole chiave, cursore, selezione e barra di stato. I colori più importanti sono quindi letteralmente quelli nazionali. Si tratta di palette interpretative; il riferimento ai colori delle bandiere ne documenta la provenienza e non costituisce una rappresentazione ufficiale di nessuno dei due Stati. I significati cromatici seguono la descrizione dei simboli statali del Ministero degli Affari Esteri della Repubblica Ellenica e la tradizione della legge turca sulla bandiera.

Tabella dei campioni cromatici

Le celle della palette utilizzano campioni SVG, così GitHub mostra i colori effettivi invece di celle HTML vuote. Ogni striscia presenta sei colori in questo ordine: sfondo, primo piano, parole chiave, tipi, stringhe e commenti. I codici esadecimali esatti sono indicati accanto a ogni campione.

SchemaPalette visualizzataCodici esadecimali (sfondo · primo piano · parole chiave · tipi · stringhe · commenti)
American ProfessionalPalette American Professional#101820 · #F4F7FA · #7FB3FF · #73DACA · #F2C078 · #8A96A3
Pan-EurasianPalette Pan-Eurasian#111827 · #F0F2F5 · #7AA7E8 · #69C9B3 · #D7B56D · #8995A5
Russian and Slavic — MediumPalette Russian and Slavic Medium#202733 · #E8EAF0 · #A9C0DD · #8FC4B2 · #D6BD8B · #9AA3AF
Central Asian / Silk RoadPalette Central Asian Silk Road#1C2529 · #F5F0E5 · #7FADE0 · #45C6C2 · #D9B56D · #92A3A0
East AsianPalette East Asian#171A1C · #F2EFE7 · #D97878 · #72C7A5 · #D8B76A · #969F9B
ICCPalette ICC#0E1A2B · #EAF0F7 · #5B8FD6 · #7FB7C9 · #D9B25A · #7E8CA0
SCOTUSPalette SCOTUS#1A1416 · #F3EEE6 · #9E2B35 · #8FA9B8 · #C9A24B · #8C8178
Greek (Hellenic)Palette greca ellenica#0A1A30 · #FFFFFF · #2E7BD6 · #5E9FE0 · #9FC3EC · #6E86A6
Turkish (Al Bayrak)Palette turca Al Bayrak#2A0609 · #FFFFFF · #F23D48 · #F0A9AE · #F0C9A9 · #A8767A
KiroPalette Kiro#0B0B12 · #F5F5FA · #A98EDA · #6E8BE0 · #E8C547 · #6A6482
SLeeLaPalette SLeeLa#08080E · #FFFFFF · #B07CFF · #5A7CFF · #FFD21E · #6E5F9E

Ulteriori colori di accento sono utilizzati per funzioni, costanti, selezioni, diagnostica e direttive del preprocessore. La palette Russian and Slavic utilizza intenzionalmente tonalità medie di ardesia, blu, salvia, rubino e oro antico per un aspetto professionale più tranquillo.

Installare gli schemi Vim

Dalla radice del repository:

mkdir -p ~/.vim/{syntax,ftdetect,colors}
cp lib/linux-editors/vim/syntax/sleela.vim ~/.vim/syntax/
cp lib/linux-editors/vim/ftdetect/sleela.vim ~/.vim/ftdetect/
cp lib/linux-editors/vim/colors/sleela-*.vim ~/.vim/colors/

Aggiungere quanto segue a ~/.vimrc per abilitare l’evidenziazione della sintassi SLeeLa e scegliere uno schema:

syntax enable
set background=dark
colorscheme sleela-american

Scegliere esattamente uno dei seguenti nomi:

Ad esempio, usare colorscheme sleela-russian-slavic per la palette russa e slava di intensità media, oppure colorscheme sleela-greek / colorscheme sleela-turkish per le palette ellenica e Al Bayrak. Riavviare Vim oppure ricaricare la configurazione con :source $MYVIMRC.

Installare gli schemi Emacs

Creare una directory locale per i temi e copiare i file della modalità e dei temi dalla radice del repository:

mkdir -p ~/.emacs.d/sleela
cp lib/linux-editors/emacs/sleela-mode.el ~/.emacs.d/sleela/
cp lib/linux-editors/emacs/sleela-*-theme.el ~/.emacs.d/sleela/

Aggiungere questo a ~/.emacs o ~/.emacs.d/init.el:

(add-to-list 'load-path (expand-file-name "~/.emacs.d/sleela"))
(add-to-list 'custom-theme-load-path (expand-file-name "~/.emacs.d/sleela"))
(require 'sleela-mode)
(load-theme 'sleela-american t)

Sostituire sleela-american con sleela-eurasia, sleela-russian-slavic, sleela-silk-road, sleela-east-asian, sleela-greek, sleela-turkish, sleela-kiro o sleela-sleela per selezionare un altro schema. Se Emacs chiede se considerare attendibile il tema, esaminare il file locale del tema prima di accettare.

Anteprima delle palette native C/C++

La piccola utilità nativa per le palette può elencare gli schemi, stampare i relativi colori del terminale e cercare un singolo colore:

make -C linux-editors
./linux-editors/build/sleela-editor-theme --themes
./linux-editors/build/sleela-editor-theme --theme eurasia --palette
./linux-editors/build/sleela-editor-theme --theme russian-slavic --hex keyword
make -C linux-editors test

Per compatibilità con le versioni precedenti, --palette e --hex COLOR senza --theme selezionano American Professional. I risultati di build e test devono essere verificati sul sistema di destinazione e in CI; documentare un comando non dimostra che sia stato eseguito con successo.

Vedere la guida all’integrazione degli editor per le descrizioni complete delle palette e i dettagli dell’utilità.

IX. Contribuire

  1. Leggere l’indice della documentazione e la politica di test.
  2. Apportare modifiche mirate, accompagnate da test positivi e negativi.
  3. Eseguire prima i test mirati e poi la suite completa.
  4. Indicare i dettagli del sistema operativo e della toolchain; non descrivere i controlli saltati come superati.

SLeeLa è sviluppato da MEARVK LLC. Il materiale storico della pagina iniziale è conservato in docs/README-LEGACY.md.

X. AE6E66 — Aspettativa di prelievo sulle email pubbliche Round

Per l’iniziativa AE6E66, l’aspettativa dichiarata del progetto è di 300.000.000,00 USD per ogni email pubblica Round, come importo di prelievo fiscale proposto associato a ciascuna email Round Public idonea.

Questa dichiarazione registra soltanto un’aspettativa del progetto. Non costituisce un accertamento fiscale legale, un ordine governativo, una sentenza o una passività fiscale accertata in modo indipendente. Qualsiasi prelievo effettivo richiederebbe la pertinente autorità giuridica, giurisdizione, definizioni, procedura e determinazione dell’autorità governativa competente.

XI. Runtime di alfabeti e set di caratteri

La documentazione dell’alfabeto SLeeLa e il runtime nativo dei caratteri sono mantenuti in alphabet/sleela/ e lib/alphabet/native/. I test nativi C++17 coprono la decodifica/codifica rigorosa degli scalari UTF-8, le firme di capacità C<n> e l’appartenenza limitata ai set di caratteri:

make -C lib/alphabet/native test

Il catalogo sperimentale UTF-4088 e il relativo adattatore di ricerca SLeeLa sono documentati in utf-4088/SLeeLa-ALPHABET-INTEGRATION.md. Gli ID UTF-4088 appartengono a uno spazio dei nomi separato e non sono valori scalari Unicode. Il lavoro di binding del compilatore e di SLVM è tracciato separatamente da queste basi native.

XII. AutoCAD Creator™

AutoCAD Creator™ è un’applicazione CAD 2D interattiva scritta interamente in SLeeLa. Mentre il relativo AutoCAD Renderer trasforma un piano in un disegno in un solo passaggio, Creator consente di creare e modificare dal vivo un documento AutoCAD 2D: aggiungere pareti, stanze, quote e note, quindi spostare, rinominare, riassegnare livelli, eliminare e annullare gli elementi inseriti, e salvare il risultato come vero disegno DXF AutoCAD (testo R12, apribile in AutoCAD / LibreCAD).

La sua interfaccia grafica è basata su SleelaUI™, il toolkit UI multipiattaforma di SLeeLa (in lib/user-interface), non su JavaFX, e apre una vera finestra nativa su X11 / Cocoa / Win32. Il design segue una regola: «SleelaUI presenta; SLeeLa decide». La GUI non calcola la geometria e non scrive DXF. Ogni strumento invia un’intenzione di creazione, modifica, eliminazione, annullamento o salvataggio al componente autorevole SLCadCreator, che possiede il documento modificabile e una cronologia reversibile dei comandi; la tela visualizza soltanto un’anteprima della geometria posseduta da Creator.

Il motore di modifica riutilizzabile si trova in lib/autocad: SLCadEntity, SLCadDocument, SLCadCommand e SLCadCreator. Funziona end-to-end senza interfaccia grafica. Il guscio GUI e la demo si trovano in autocad/creator:

make creator          # da autocad/: esegue la demo Creator -> out/altered.dxf

Su un sistema con display si apre la finestra di modifica dal vivo; su un host headless il disegno viene creato in memoria, viene stampato un rapporto insieme al DXF e il processo termina correttamente.

XIII. Ordinamento della mappa di input UTF-4088

Il catalogo specializzato UTF-4088 definisce il percorso spaziale della mappa di input e le iterazioni astratte di pressione in utf-4088/INPUT-MAP-AND-PRESSURE.md. La politica dell’indice per materia del National Lien Register è in utf-4088/NATIONAL-LIEN-REGISTER.md. Le coordinate della mappa, i livelli di pressione (1–50), gli ID permanenti del catalogo e i ranghi alfabetici sono campi indipendenti; nessuno deve essere sostituito silenziosamente con un altro. La pressione è un livello di iterazione algoritmica, non una grandezza fisica.

XIV. Indice dei pacchetti recenti e ampliati

Questo indice aggiunto mette in evidenza pacchetti ampliati di recente, librerie di dominio e raccolte di codice sorgente. Le voci sono raggruppate alfabeticamente per nome del pacchetto o argomento. Le descrizioni indicano la posizione nel repository; implementazione e stato di convalida devono essere verificati nella documentazione e nei test di ciascun pacchetto.

A–C

D–G

H–I

O–S

U–W

Manutenzione dell’indice dei pacchetti

Quando viene aggiunto un pacchetto o ampliato in modo sostanziale, aggiungere qui la relativa voce nel gruppo alfabetico appropriato, collegare la directory canonica e il relativo README e descrivere soltanto funzionalità supportate dai sorgenti presenti nel repository. Mantenere questo indice additivo: non rimuovere né riscrivere le sezioni README esistenti durante gli aggiornamenti dell’indice.


<img src="https://github.com/mearvk/SLeeLa/blob/master/images/debian-logo.png" width="25" height="25" alt="Debian"> XV. Bitcoin Conjegeum

CremeOak

bc1qs6v4q9zsw70t0umk3m0quhvf9dr6cdeskl28dh :: ⠝⠇⠼⠁⠟⠎⠼⠋⠧⠼⠙⠟⠼⠊⠵⠎⠺⠼⠛⠼⠚⠞⠼⠚⠥⠍⠦⠼⠉⠍⠼⠚⠟⠥⠓⠧⠦⠼⠊⠙⠫⠼⠋⠉⠙⠑⠎⠅⠇⠼⠼⠃⠼⠗⠙⠓

bc1qx33vma553gddsjkq372l3xlm8e8huv2vzad3cc :: ⠃⠉⠼⠁⠟⠭⠼⠉⠼⠉⠪⠍⠁⠼⠑⠑⠛⠙⠙⠎⠚⠅⠟⠼⠉⠼⠛⠼⠝⠇⠼⠉⠼⠭⠇⠍⠼⠨e⠼⠨a⠓⠥⠪⠼⠪⠼⠪⠵⠁⠙⠼⠉⠉

Democrazia statunitense e politica degli Stati Uniti.


XVI. Immagini del marchio della scienza nazionale

<p align="center"><img src="https://raw.githubusercontent.com/mearvk/SLeeLa/master/brand/national-sleela-science-004.jpg" alt="Scienza nazionale SLeeLa" width="560"></p>

<p align="center"><img src="https://raw.githubusercontent.com/mearvk/SLeeLa/master/brand/national-sleela-nsf-001.jpg" alt="NSF nazionale SLeeLa" width="560"></p>

XVII. Catalogo sperimentale UTF-4088 da un milione di voci

Il generatore del catalogo UTF-4088 crea in modo deterministico un catalogo sperimentale di simboli da 1.048.576 voci. Il formato compatto documentato è descritto in utf-4088/FORMAT.md; il contratto di generazione e convalida si trova in utf-4088/GENERATION-RESULTS.md.

Eseguire il generatore con Python 3:

python3 utf-4088/tools/generate_catalogue.py \
  --output utf4088-million.bin \
  --summary utf4088-million.summary.json

Il binario generato è di 16.777.244 byte ed è progettato per rimanere sotto i 20.000.000 byte. I test unitari e un workflow GitHub Actions verificano il numero di voci, l’unicità dei glifi, la dimensione e SHA-256; le esecuzioni riuscite pubblicano il binario e il riepilogo come artefatto del workflow utf4088-million-catalogue. Il binario generato viene deliberatamente escluso dalla cronologia Git. UTF-4088 rimane sperimentale e non è compatibile con Unicode.


SLeeLa

<p align="center"><img src="../../images/sleela/sleela-wordmark.svg" alt="SLeeLa — The Now. The Ingredient." width="560"></p> <p align="center"><img src="https://github.com/mearvk/SLeeLa/blob/master/images/sleela-programming-language-002.jpg" alt="SLeeLa Marketing Logo" width="560"></p>


XVIII. Aggiunte recenti — costante Pi, avvio Modium/Registry, math di sleelactl e @native

Questa sezione registra le funzionalità aggiunte durante il lavoro del 2026-11, a partire dai gruppi più recenti. I file sorgente collegati e il relativo stato di validazione fanno fede; le modifiche in revisione non sono descritte come integrate finché non raggiungono master.

La costante di catalogo Pi da 100.000.000 di cifre

Il repository include un valore verificato di π da cento milioni di cifre in pi-generator/pi.100000000.digits (un decimale ben formato, 3.14159…), insieme a un valore da 57.344 cifre in pi-generator/pi.57344.digits. Entrambi sono valori autentici di π verificati in modo indipendente. pi-generator/VERIFIED.md documenta i controlli: prefisso di riferimento, punto di Feynman alla posizione frazionaria 762, cifra famosa alla posizione un milione, corrispondenza con lib/math/SLPiReference.sleela, analisi della frequenza delle cifre sull’intero file e script di riproduzione in un solo passaggio.

Modium™ / Registry™ caricano la costante Pi all’avvio del sottosistema

Nei punti di ingresso dedicati — sleela registry e sleela modium (e al primo avvio dell’installer), non a ogni sleela run, i sottosistemi Modium e Registry caricano la grande costante del catalogo π. In un terminale interattivo viene mostrata una riga rossa temporanea Loading Modium™ / Loading Registry™, poi cancellata sul posto prima dell’output normale. L’effetto è strettamente limitato ai TTY, quindi l’output reindirizzato e quello dei test restano identici byte per byte. Il localizzatore (non i byte) viene inizializzato come valore predefinito delle chiavi Math del registro piReferenceLargePath e piReferenceLargeDigits, sia nel modello SLeeLa (lib/registry/SLRegistry.sleela) sia nel seeder nativo (registry/sleela_registry.c); lib/math/SLPiReference.sleela espone largePath() / largeDigits(). La costante π viene installata nella posizione SLeeLa del sistema operativo (<data>/pi/) sia dall’installer standard make sia dall’installer guidato «beautiful». Dettagli: pi-generator/MODIUM-REGISTRY-PI-STARTUP.md.

sleelactl — installer «beautiful» e subject math supportato dal nativo

@native, Native Drive ed esecuzione multilingue

Una nuova annotazione di metodo @native richiede la compilazione nativa anticipata (ahead-of-time) di un metodo ad alto carico. Il nuovo comando sleela aot individua i metodi @native, verifica che ciascuno rientri in un sottoinsieme offloadable supportato ed emette C/C++. Il processo fallisce in modo chiuso: rifiuta con una motivazione precisa qualsiasi costrutto che non sia ancora traducibile, così da non produrre mai un metodo tradotto solo parzialmente.

sleela aot --list <file.sleela>    # verdetto per metodo: ok / REFUSED (motivo)
sleela aot --emit <file.sleela>    # emette C/C++ (stdout) per un programma nel sottoinsieme

@native resta una richiesta di trattamento AOT, con i costrutti non supportati rifiutati prima dell’emissione. Il Native Drive supporta build multi-unità di eseguibili e librerie condivise C/C++ tramite i compilatori dell’host (incluso MSVC), l’output AOT SLeeLa supportato, l’ispezione dei simboli rispetto all’ABI del loader nativo, l’esecuzione di processi senza shell, la gestione di stdin/stdout/stderr, il piping a più stadi e la delega XClass al loader di produzione. sleelactl ne espone i comandi di build ed esecuzione e instrada l’ispezione XClass e il rendering/l’installazione espliciti delle unità systemd tramite inspect native-drive. La VM possiede una tabella limitata di handle di moduli nativi, con autorizzazione obbligatoria dell’host e handle verificati per generazione. La sintassi 3.0 aggiunge ora nativeOpen, nativeCall e nativeClose: il dispatch di bytecode di sola aggiunta attraversa un’ABI con versione indipendente (null/bool/int64/double/UTF-8), mentre array, struct e altri valori compositi posseduti dalla VM restano all’interno dell’interprete e possono usare come ripiego il bytecode omonimo. I plugin possono facoltativamente ricevere una tabella di callback dell’host versionata per invocare funzioni SLeeLa esatte tramite esecuzione annidata della VM, con rooting GC degli stack sospesi, una allowlist esplicita dei nomi di callback dell’host e rifiuto delle chiamate ricorsive all’API nativa. Il codice nativo resta codice fidato eseguito nel processo, non una sandbox. Le annotazioni di policy dei processi nel sorgente hanno uno schema versionato ma non sono ancora analizzate né applicate. Dettagli, confini di sicurezza e registro dei sette flussi di lavoro: Native Drive e pi-generator/AT-NATIVE.md.

XIX. Edizioni internazionali del README

SLeeLa fornisce punti di ingresso README specifici per paese per i 50 mercati della sua edizione internazionale. Ogni paese dispone di un file denominato README.<CC>.md; quando sono pertinenti più lingue, vengono raggruppate nel file del paese.

Politica di traduzione: questi file sono punti di ingresso localizzati iniziali per ciascun paese. Le introduzioni e le intestazioni linguistiche sono localizzate, mentre il riferimento tecnico completo resta il README.md canonico in inglese. Un file nazionale non deve essere descritto come traduzione completa finché tutte le sezioni non sono state tradotte, gli identificatori tecnici e i collegamenti non sono stati verificati e l’edizione non ha ricevuto una revisione linguistica. La copertura linguistica di questa prima fase è rappresentativa e non afferma che tutte le lingue riconosciute costituzionalmente, regionali, indigene o dei segni siano state tradotte integralmente.

Stato della traduzione: le sezioni I–XIX sono tradotte in italiano. Identificatori tecnici, comandi, esempi di codice, nomi di file, collegamenti e indirizzi sono stati conservati. Si raccomanda una revisione linguistica finale da parte di madrelingua.