﻿SOSTITUIRE LIBLOUIS IN INKVEN

Il programma può usare una libreria Liblouis e tabelle compatibili scelte dall’utente. La scelta si registra in components/liblouis/override.json. Il configuratore tools/Configura-Liblouis.ps1 calcola i digest dei file e scrive il manifest completo. Non carica né esegue la DLL, non modifica le tabelle e non contatta servizi di rete.

Chiudi Inkven prima di cambiare configurazione. Prepara separatamente la DLL Windows x64 e una cartella locale contenente la tabella principale, le sue dipendenze e en-us-brf.dis. I nomi dei file delle tabelle devono essere semplici nomi ASCII con lettere, numeri, punto, trattino o underscore; le dipendenze includibili sono nella stessa cartella. Mantieni le dichiarazioni corrette del profilo italiano a sei punti. I percorsi UNC e i collegamenti simbolici non sono accettati dal configuratore.

Apri PowerShell nella cartella del programma. Per creare un manifest che seleziona esplicitamente i file già inclusi, esegui questo comando completo:

powershell.exe -NoProfile -ExecutionPolicy Bypass -File ".\tools\Configura-Liblouis.ps1" -LibraryPath ".\components\liblouis\liblouis.dll" -TableRoot ".\components\liblouis\tables" -MainTable "tecnoaccess-it6.utb" -AppDirectory "."

Per scegliere i tuoi file senza scrivere un JSON a mano, esegui queste righe nella stessa PowerShell; inserisci i percorsi reali quando richiesti:

$dllScelta = Read-Host 'Percorso della DLL Liblouis scelta'
$tabelleScelte = Read-Host 'Percorso della cartella delle tabelle scelte'
$tabellaPrincipale = Read-Host 'Nome del file della tabella principale'
powershell.exe -NoProfile -ExecutionPolicy Bypass -File ".\tools\Configura-Liblouis.ps1" -LibraryPath $dllScelta -TableRoot $tabelleScelte -MainTable $tabellaPrincipale -AppDirectory "."

Se esiste già override.json, il configuratore si ferma. Per sostituirlo, ripeti il comando aggiungendo -Force. La sostituzione conserva automaticamente il manifest precedente in un file override.json.bak- seguito da data e identificativo; l’output indica il percorso del backup. Nessun manifest precedente viene cancellato. Su un filesystem che non supporta la sostituzione atomica, l’operazione si ferma senza un ripiego distruttivo.

Il manifest contiene esattamente schema, libraryPath, librarySha256, tablesDirectory, mainTableFileName, mainTableSha256 e tableSha256. Il valore di schema è tecnoaccess-liblouis-override-v1. Tutti i digest sono SHA-256 di 64 cifre esadecimali. Il configuratore legge le direttive include della tabella principale e delle dipendenze e comprende il display en-us-brf.dis. I percorsi nel JSON sono assoluti; tableSha256 comprende la tabella principale con lo stesso digest di mainTableSha256 e le dipendenze dichiarate. Il formato è descritto anche in override.schema.json. Non sono necessarie firme o approvazioni Tecnoaccess per gli hash scelti.

I percorsi assoluti si riferiscono alla posizione attuale dei file: se sposti il programma o i componenti selezionati, rigenera il manifest. Riavvia l’app e richiedi un’anteprima Braille per usare il componente selezionato. Un manifest non valido non impedisce l’avvio dell’editor: produce un errore esplicito quando richiedi un’operazione Braille. Il programma non ripiega silenziosamente sul componente predefinito. I controlli su ABI, architettura, caratteri, lunghezze, file e formato restano attivi. Una DLL nativa viene eseguita con i permessi dell’utente: scegli soltanto un componente che intendi eseguire. L’hash verifica la corrispondenza al file dichiarato, non la sua sicurezza.

BRF richiede la mappatura Braille ASCII standard dei 64 segni: il programma controlla entrambe le direzioni anche per un display con hash diverso. Un encoding differente viene rifiutato da questo percorso; non viene sostituito silenziosamente con un altro display. Preview e PEF usano il componente di traduzione selezionato.

Per tornare ai componenti predefiniti, chiudi l’app e, dalla sua cartella, conserva il manifest attuale con questo comando, poi riavvia:

Rename-Item -LiteralPath ".\components\liblouis\override.json" -NewName ("override.json.disattivato-" + [Guid]::NewGuid().ToString("N"))

Per costruire una DLL modificata, il sorgente incluso è in sources/liblouis-3.39.0.tar.gz. L’archivio contiene windows/configure.mk con ARCH=x64 e UCS=2 e windows/Makefile.nmake, che usa clang-cl. Con gli strumenti previsti dal Makefile, dalla sua cartella windows il comando è nmake /f Makefile.nmake. Sono supportate interfacce compatibili e widechar a 2 o 4 byte. Per una ricompilazione Liblouis non occorrono i sorgenti proprietari dell’applicazione. Conserva licenze, copyright e avvisi dei componenti e indica le modifiche quando li ridistribuisci secondo le rispettive licenze.
