Organizzare lo spazio di lavoro Octave: pannelli, Focus source e layout

Octave Script Workspace offre un editor per il codice GNU Octave e alcuni pannelli di supporto. La disposizione è modificabile: si possono consultare gli script registrati, le informazioni sulle API e i suggerimenti del bridge, oppure lasciare quasi tutta la finestra al sorgente.

Le schermate si riferiscono a GX-TXT DEV112 con patch P005, modulo Octave Script Workspace 1.8.3. I comandi dell’interfaccia sono riportati con le loro etichette inglesi originali. I piccoli esempi numerici servono soltanto a mostrare il Source; non vengono eseguiti.

1. Riconoscere i tre settori principali

All’apertura il Workspace può mostrare un pannello a sinistra, l’editor centrale e un pannello a destra. In questa configurazione è possibile vedere contemporaneamente Registered scripts, API Browser, il codice e GX-TXT Bridge Snippets.

Octave Script Workspace con Explorer e API Browser a sinistra, Source editor al centro e GX-TXT Bridge Snippets a destra.
Figura 1 — Workspace con i tre settori visibili: Explorer e API Browser a sinistra, Source al centro, Bridge Snippets a destra.

Questa disposizione è utile per orientarsi nella struttura della finestra, ma non è necessariamente la migliore quando si deve leggere o modificare un sorgente lungo. L’area centrale diventa infatti più stretta.

Le opzioni di visibilità si trovano nel menu View. Mostrare un pannello non equivale ad avviare un calcolo né a cambiare il contenuto dello script.

2. Usare Script Explorer e API Browser soltanto quando servono

View → Script Explorer / Registered scripts controlla la presenza del pannello sinistro. L’elenco permette di individuare gli script registrati e riconoscere il loro riferimento qualificato, per esempio session:... oppure user:....

All’interno del pannello sinistro è disponibile anche API Browser, il cui comando di visibilità è indipendente. Si può lasciare aperto l’Explorer per scegliere uno script e nascondere l’API Browser, evitando di occupare inutilmente spazio verticale.

Octave Script Workspace con Registered scripts visibile a sinistra, API Browser e Bridge Snippets nascosti e maggiore spazio per il Source.
Figura 2 — Registered scripts visibile senza API Browser e senza il pannello destro: resta più spazio per il codice.

L’API Browser serve per consultare le interfacce disponibili nel framework. La sua presenza non significa che una funzione sia stata invocata. Prima di scrivere una chiamata a un’API occorre consultare il relativo contratto pubblico e verificare gli input richiesti.

3. Consultare GX-TXT Bridge Snippets

Il pannello destro è controllato da View → GX-TXT Bridge Snippets. Contiene riferimenti sintetici e frammenti di codice relativi al bridge tra gli script Octave e GX-TXT.

Octave Script Workspace con pannello GX-TXT Bridge Snippets aperto a destra del Source editor ed Explorer nascosto.
Figura 3 — Pannello Bridge Snippets aperto a destra del Source, con l’Explorer nascosto.

Il pannello può essere mostrato quando occorre cercare una funzione o leggere un esempio e nascosto nuovamente durante la scrittura. La semplice apertura del pannello non inserisce codice e non avvia uno script.

4. Allargare il codice con Focus source

La voce View → Focus source / restore panes è il comando più immediato per recuperare spazio. Quando Explorer e Bridge Snippets sono presenti, li nasconde e porta l’editor centrale a occupare quasi tutta la larghezza della finestra.

Octave Script Workspace in modalità Focus source, con pannelli laterali nascosti, Source editor ampliato e proprietà superiori visibili.
Figura 4 — Focus source nasconde i pannelli laterali e allarga il Source mantenendo visibili le proprietà in alto.

Richiamando la stessa voce si ritorna alla disposizione laterale precedente. Il comando riguarda il layout: non cambia gli identificativi degli script, non modifica il testo Octave e non salva una nuova revisione.

È particolarmente utile con funzioni lunghe, istruzioni annidate o righe che richiedono una lettura orizzontale ampia.

5. Nascondere le righe delle proprietà per liberare altezza

Il menu View offre anche controlli per le sezioni sopra al Source. Script properties gestisce i campi principali; Parameters e Version possono essere controllati separatamente.

Disattivando le sezioni non necessarie, il codice può occupare una porzione maggiore dell’altezza disponibile. Quando Script properties è nascosto, l’interfaccia rende disponibile il pulsante Show script properties.

Source editor GNU Octave con sezioni superiori delle proprietà nascoste per aumentare lo spazio verticale disponibile.
Figura 5 — Tutte le sezioni superiori opzionali nascoste: il Source guadagna spazio verticale.

Nascondere un campo non equivale a cancellarne il valore. Per modificare nuovamente i metadati basta riabilitare il relativo pannello.

6. Ripristinare soltanto le informazioni necessarie

Le righe superiori possono essere riaperte una alla volta.

Script properties restituisce i campi di identità, come Scope, Script ID, Name, Default arguments e Description.

Octave Script Workspace con campi principali dello script visibili e sezioni Parameters e Version nascoste.
Figura 6 — Solo i campi principali dello script sono visibili, senza Parameters e Version.

Version aggiunge la riga relativa alla versione dichiarata del sorgente, senza richiedere l’apertura degli altri pannelli.

Octave Script Workspace con riga Version visualizzata sopra il Source editor senza aprire le altre sezioni opzionali.
Figura 7 — Riga Version visualizzata separatamente sopra al Source.

Parameters visualizza l’area per le definizioni dei parametri tipizzati. Questa sezione va distinta dal semplice campo testuale Default arguments e sarà approfondita quando si tratterà l’invocazione degli script.

Riquadro Parameters di GX-TXT Octave Script Workspace dedicato alla dichiarazione dei parametri tipizzati dello script.
Figura 8 — Riquadro Parameters visibile: l’area riguarda la dichiarazione dei parametri, non l’esecuzione del codice.

Additional required APIs presenta un’ulteriore sezione dedicata ai requisiti API dichiarati. Anche questa può essere nascosta quando non si stanno modificando tali informazioni.

Octave Script Workspace con riquadro Additional required APIs visibile sopra l'editor sorgente.
Figura 9 — Riquadro Additional required APIs mostrato temporaneamente dal menu View.

Una disposizione pratica per scrivere codice è mantenere visibili solo le proprietà principali quando si devono controllare ID e Scope; le altre righe possono restare chiuse.

7. Regolare i divisori e ripristinare il layout

Quando sono aperti più pannelli, i divisori tra i settori sono regolabili. Spostandoli si può assegnare più larghezza all’Explorer, al Source oppure a Bridge Snippets. La nuova geometria viene ricordata dal Workspace.

Octave Script Workspace con divisori regolati per modificare le larghezze di Explorer, Source editor e Bridge Snippets.
Figura 10 — I divisori orizzontali sono stati regolati, modificando la larghezza disponibile ai tre settori.

Se la disposizione è diventata poco pratica, View → Reset editor layout ripristina le proporzioni di riferimento e rende nuovamente disponibili i settori laterali.

Octave Script Workspace dopo Reset editor layout, con tre settori nuovamente visibili e proporzioni predefinite.
Figura 11 — Reset editor layout ripristina la disposizione a tre settori e le proporzioni predefinite.

Il reset riguarda la geometria dell’interfaccia. Non annulla le modifiche al codice e non sostituisce i comandi Undo o Save.

8. Conservazione della disposizione e del tema

Il Workspace memorizza la visibilità dei pannelli e di alcune righe delle proprietà. Se si chiude la finestra con una disposizione essenziale, la si può ritrovare alla riapertura.

Anche il tema scelto per il Source, nell’esempio High Contrast Dark, resta applicato: l’area di codice è nera con testo chiaro. Il font monospaziato del Source rimane leggibile dopo la riapertura.

Octave Script Workspace riaperto con modalità Focus source, proprietà selezionate e Source editor High Contrast Dark conservati.
Figura 12 — Alla riapertura del Workspace sono conservati Focus source, le righe delle proprietà selezionate e la visualizzazione scura del Source.

Il tema scuro del Source è distinto dall’aspetto generale della finestra: alcuni controlli Tk/ttk possono mantenere la propria colorazione chiara originale.

La disposizione salvata non comporta necessariamente che venga aperta automaticamente la stessa scheda. Gli script registrati rimangono disponibili nell’Explorer e possono essere selezionati nuovamente.

9. Una disposizione consigliata per lavorare sul codice

Per l’uso quotidiano, mantenere Focus source e lasciare aperte soltanto le righe superiori effettivamente necessarie. Richiamare Registered scripts, API Browser e Bridge Snippets quando occorre consultarli; poi nasconderli per tornare a un editor ampio.

Octave Script Workspace con Source editor ad alto contrasto, script registrato e pannelli laterali nascosti.
Figura 13 — Disposizione finale minimalista con lo script Octave registrato, Source ad alto contrasto e pannelli laterali chiusi.
Elemento del menu ViewUso principale
Script Explorer / Registered scriptsMostra o nasconde l’elenco degli script.
API BrowserMostra o nasconde il riferimento alle API nel pannello sinistro.
GX-TXT Bridge SnippetsMostra o nasconde esempi e suggerimenti sul bridge.
Focus source / restore panesMassimizza il settore centrale o ripristina i pannelli precedenti.
Script propertiesMostra o nasconde i metadati principali.
Parameters, Version, Additional required APIsGestisce separatamente le rispettive righe.
Reset editor layoutRipristina la geometria iniziale dei settori.

Le viste del Debugger e dei suoi pannelli di supporto seguono una logica analoga, ma appartengono al flusso specifico del debugging. Durante la sola scrittura del codice non serve tenerle aperte.

L’obiettivo è conservare il maggior spazio possibile per il Source, senza rinunciare agli strumenti del framework quando diventano utili.