Introduzione alla scrittura delle estensioni per RKWard

Thomas Friedrichsmeier

Meik Michalke

Traduzione italiana: Vincenzo Reale
Revisione 0.8.2 (3/5/2025)

Questa è una guida per scrivere estensioni per RKWard.


Indice

1. Introduzione
2. Preliminari: cosa sono le estensioni in RKWard? Come funzionano?
3. Creazione delle voci di menu
Controllo dell'ordine delle voci di menu
4. Definizione della GUI
Definire una finestra
Aggiunge un'interfaccia di procedura guidata
Alcune considerazioni sulla struttura della GUI
<radio> vs. <checkbox> vs. <dropdown>
5. Generare il codice di R dalle impostazioni della GUI
Utilizzare JavaScript nelle estensioni di RKWard
preprocess()
calculate()
printout()
Convenzioni, criteri e sfondo
Comprendere l'ambiente local()
Formattazione del codice
Gestire le operazioni complesse
Suggerimenti e trucchi
6. Scrivere una pagina della guida
7. Interazioni logiche tra gli elementi della GUI
Logica della GUI
Logica della GUI programmata
8. Integrazione di estensioni in estensioni
Casi di utilizzo per l'integrazione
Integrazione in una finestra
Generazione di codice durante l'integrazione
Integrazione in una procedura guidata
Integrazione meno integrata: pulsante Altre opzioni
Integrazione/definizione di estensioni incomplete
9. Gestire molte estensioni singole
Panoramica su diversi approcci
Utilizzare l'istruzione include di JS
Includere i file .xml
Utilizzare <snippets>
<include> e <snippets> vs. <embed>
10. Concetti per l'uso in estensioni specializzate
Estensioni che producono un grafico
Tracciare un grafico nella finestra del risultato
Aggiungere una funzionalità di anteprima
Opzioni generiche grafico
Un esempio classico
Anteprime dei dati, uscita e altri risultati
Anteprima del risultato (HTML)
Anteprima dei dati (importati)
Anteprime personalizzate
Estensioni dipendenti dal contesto
Contesto del dispositivo X11
Importa contesto di dati
Interrogazione delle informazioni di R
Riferimento all'oggetto attuale o al file attuale
Ripetere (un insieme di) opzioni
Insiemi di opzioni «guidati»
Alternative: quando non utilizzare gli insiemi di opzioni
11. Gestione delle dipendenze e problemi di compatibilità
Compatibilità di versione di RKWard
Compatibilità versione di R
Dipendenze dei pacchetti di R
Dipendenze da altre .pluginmap di RKWard
Un esempio
12. Traduzione delle estensioni
Considerazioni generali
i18n nei file xml di RKWard
i18n nei file js e nelle sezioni di RKWard.
i18n e virgolette
Manutenzione delle traduzioni
Tradurre le estensioni
13. Informazioni su autore, licenza e versione
14. Condividere il proprio lavoro con altri
Estensioni esterne
Perché le estensioni esterne?
Struttura del pacchetto di un'estensione
Gerarchia dei file
Creazione del pacchetto dell'estensione
15. Sviluppo di estensioni con il pacchetto rkwarddev
Panoramica
Esempio pratico
Descrizione della GUI
Codice JavaScript
Mappa delle estensioni
Pagina della guida
Genera i file delle estensioni
Lo script completo
Aggiunge una pagina della guida
Traduzione delle estensioni
A. Riferimento
Tipi di proprietà/Modificatori
Elementi di uso generale da utilizzare in qualsiasi file XML (.xml, .rkh, .pluginmap)
Elementi da utilizzare nella descrizione XML dell'estensione
Elementi generali
Definizioni dell'interfaccia
Elementi della struttura
Elementi attivi
Sezione logica
Proprietà degli elementi dell'estensione
Estensioni integrabili fornite dalla versione ufficiale di RKWard
Elementi da utilizzare nei file di .pluginmap
Elementi da utilizzare nei file .rkh (guida)
Funzioni disponibili per la programmazione della logica della GUI
B. Risoluzione dei problemi durante lo sviluppo delle estensioni
C. Licenza

Lista delle tabelle

A.1. Estensioni standard integrabili