RText: differenze tra le versioni

Versione delle 11:01, 14 set 2015

Versione attuale delle 20:16, 21 nov 2020

(19 versioni intermedie di 15 utenti non mostrate)

Riga 1:

{{Software

|Nome = RText

|Logo = RText Header green.png

|DimensioneLogo = 235px

|Screenshot = RText Main View Screenshot.png

|Didascalia = Schermata di RText raffigurante il codice sorgente scritto in [[Java (linguaggio di programmazione)|Java]] di una classe appartenente al progetto stesso.

|Sviluppatore = Fifesoft, [https://github.com/bobbylight/RSyntaxTextArea/graphs/contributors collaboratori su GitHub]

|UltimaVersione = 2.5.8

Riga 13 ⟶ 12:

|SistemaOperativo2 = Linux

|SistemaOperativo3 = Mac OS X

|Linguaggio = Java

|Genere = Editor di testo

|Licenza = [[BSD License]] (in una versione modificata)

|SoftwareLibero = sì

|Lingua = Multilingua

|SitoWeb = httphttps://fifesoftbobbylight.com/rtextgithub.io/RText

}}

'''RText''' è un [[editor di testo]] per programmatori ed un [[software libero]], pubblicato rispettando le specifiche di una versione modificata del protocollo [[BSD License]], per [[Microsoft Windows|Windows]], [[Mac OS XmacOS]], [[Linux]], [[OS/2]], [[Unix]] e [[OpenVMS]].<ref name=s-rtexthomepage>{{cita web|titolo=Sito Web ufficiale di RText|url=http://fifesoft.com/rtext/|editore=Fifesoft|accesso=16 agosto 2008|data=16 agosto 2008 |lingua=en |urlmorto=no sì|dataarchivio=21 aprile 2015 |urlarchivio=httphttps://www.webcitation.org/6XwzFEaJ0?url=http://fifesoft.com/rtext/}}</ref>

Il programma è disponibile in inglese ed è stato tradotto anche in diversi idiomi, tra cui quello cinese della Cina continentale (usa i caratteri semplificati), spagnolo, spagnolo argentino, portoghese europeo, tedesco, francese, italiano, russo, taiwanese (fa uso dei caratteri tradizionali), olandese, giapponese, coreano, polacco, turco, ungherese ed indonesiano.

== Storia ==

Il programma è stato creato da [[Fifesoft]] ed è stato programmato per lo più dal suo fondatore, Robert Futrell. I contributi esterni sono aumentati da quando il codice sorgente viene condiviso tramite il software di [[controllo di versione distribuito]] [[Git (software)|Git]] su [[GitHub]].

Le funzionalità di registrazione ed esecuzione delle [[Macro_Macro (informatica)|macro]] sono state aggiunte a partire dalla versione 0.8.9.2.

== Funzionalità ==

Le funzionalità più rilevanti di RText sono le seguenti:

* Evidenziazione sintattica per oltre 40 linguaggi, tra quelli di [[Linguaggio di programmazione|programmazione]] e di [[Linguaggio di marcatura|marcatura]]<ref name=g-rsyntaxtextareareadme>{{cita web|titolo=File Leggimi di RSyntaxTextArea, componente usato da RText, pubblicato su GitHub|url=https://github.com/bobbylight/RSyntaxTextArea/blob/master/README.md/|editore=Repository ufficiale GIT di RSyntaxTextArea|accesso=15 aprile 2015|data=15 aprile 2015 |lingua=en |urlmorto=no |dataarchivio=17 aprile 2015 |urlarchivio=httphttps://www.webcitation.org/6Xr1TtUJB?url=https://github.com/bobbylight/RSyntaxTextArea/blob/master/README.md/}}</ref><ref name=j-rsyntaxtextareaapidocumentation />

* Ricerca e sostituzione testuale per mezzo dell'utilizzo delle espressioni regolari

* Ricerca del testo nel contenuto dei file e sostituzione testuale nel contenuto degli stessi

Riga 37 ⟶ 35:

* Personalizzazione dell'interfaccia del documento (modalità di visualizzazione a schede, MDI o in elenco listato)

* Supporto all'utilizzo simultaneo di molteplici famiglie di caratteri

* Evidenziazione della parentesi corrispondente a quella selezionata<ref name=j-rsyntaxtextareaapidocumentation>{{cita web|titolo=Documentazione API della classe RSyntaxTextArea|url=http://jtstand.codehaus.org/jtstand-editor/apidocs/org/fife/ui/rsyntaxtextarea/RSyntaxTextArea.html|editore=Fifesoft (documentazione API reperita dal sito Web di JTStand)|accesso=11 dicembre 2014|data=11 dicembre 2014 |lingua=en |urlmorto=no sì|dataarchivio=24 aprile 2015 |urlarchivio=httphttps://www.webcitation.org/6Y1hrHueu?url=http://jtstand.codehaus.org/jtstand-editor/apidocs/org/fife/ui/rsyntaxtextarea/RSyntaxTextArea.html}}</ref>

* Evidenziazione della riga correntemente selezionata

* Interfaccia grafica personalizzabile (icone, look and feel e schemi dei colori)

Riga 55 ⟶ 53:

* Zoom in e zoom out

* Supporto Windows Cinese, Giapponese e Koreano

* Copia del testo selezionato negli appunti del sistema operativo, sottoformasotto forma di [[Rich_Text_FormatRich Text Format|RTF]]<ref name=j-rsyntaxtextareaapidocumentation /><ref name=s-rtextreview>{{cita web|titolo=Recensione di RText pubblicata su Softpedia|url=http://www.softpedia.com/get/Office-tools/Text-editors/RText.shtml/|editore=Elena Opris|accesso=31 dicembre 2014|data=31 dicembre 2014 |lingua=en |urlmorto=no |dataarchivio=20 aprile 2015 |urlarchivio=httphttps://www.webcitation.org/6Xvw17xRM?url=http://www.softpedia.com/get/Office-tools/Text-editors/RText.shtml}}</ref><ref name=j-rsyntaxtextareaapidocumentation />

* Stampa ed anteprima di stampa<ref name=h-rtextreview>{{cita web|titolo=Recensione di RText pubblicata su HTML.it|url=http://download.html.it/software/rtext//|editore=Redazione di HTML.it|accesso=15 luglio 2008|data=15 luglio 2008 |lingua=it |urlmorto=no |dataarchivio=20 aprile 2015 |urlarchivio=httphttps://www.webcitation.org/6XvwkEDCV?url=http://download.html.it/software/rtext/}}</ref>

* Esportazione del contenuto dell'area testuale sottoformasotto forma di codice HTML, con conseguente conservazione dello stile sintattico impostato.

* Gestore [[Appunti_Appunti (informatica)|appunti]] integrato nell'area testuale (attivabile premendo la combinazione di tasti Ctrl+Shift+V).

* Restituzione di frammenti di codice sorgente esemplificativi ([[snippet]]) nei linguaggi usati per programmare le macro.

* Collegamenti ipertestuali cliccabili (se il motore analitico del linguaggio lo consente).<ref name=j-rsyntaxtextareaapidocumentation />

Nella barra di stato della finestra principale è presente l'indicatore della quantità di memoria occupata dall'applicazione nell'area di memoria [[Allocazione_dinamica_della_memoriaAllocazione dinamica della memoria|heap]].

== Linguaggi supportati ==

Supporta diversi [[linguaggi di programmazione]] e [[Linguaggio di marcatura|di marcatura]]<ref name=j-rsyntaxtextareaapidocumentation />.

Al momento sono:

Riga 76 ⟶ 74:

* [[C Sharp|C#]]

* [[Clojure]]

* [[D_D (linguaggio)|D]]

* [[DART_DART (linguaggio)|Dart]]

* [[Groovy]]

* [[HTML]]

* [[Java (linguaggio di programmazione)|Java]]

* [[JavaScript]]

* [[JavaServer_PagesJavaServer Pages|JSP]]

* [[Visual Basic]]

* File .jshintrc

* [[JavaScript_Object_NotationJavaScript Object Notation|JSON]]

* [[Lisp]]

* [[Nullsoft_Scriptable_Install_SystemNullsoft Scriptable Install System|NSIS]]

* [[Perl]]

* [[PHP]]

* [[Python]]

* [[Ruby (linguaggio di programmazione)|Ruby]]

* [[Scala_Scala (linguaggio_di_programmazionelinguaggio di programmazione)|Scala]]

* [[SQL]]

* [[Shell script|Script della shell UNIX]]

* [[File_batchFile batch|Windows batch]]

* [[XML|File XML]]

* [[ActionScript]]

* [[BBCode]]

* [[Embarcadero_DelphiEmbarcadero Delphi|Delphi]]

* [[Document_Type_DefinitionDocument Type Definition|Dtd]]

* [[Fortran]]

* [[.htaccess|Htaccess]]

Riga 109 ⟶ 107:

* [[MXML]]

* File di properties

* [[SAS_SAS (linguaggio_di_programmazionelinguaggio di programmazione)|SAS]]

* [[Tcl]]

Riga 115 ⟶ 113:

== Aspetti tecnici ==

Il progetto è basato su un componente, l'area testuale RSyntaxTextArea, anch'esso open source e scritto in [[Java (linguaggio di programmazione)|Java]], e non ricorre in alcun caso all'invocazione delle [[Application programming interface|API]] [[Win32]], quindi non impiega [[Microsoft Foundation Classes]] (MFC) o librerie simili, il che assicura la portabilità del programma in ambito multipiattaforma, in quanto nativo [[Java (linguaggio di programmazione)|Java]]. È distribuito rispettando le specifiche di una versione modificata del protocollo [[BSD License]].

===Dettagli di RSyntaxTextArea===

Dato che RSyntaxTextArea supporta internamente la ricerca di testo con espressioni regolari su più righe, RText permette tale modalità di ricerca. <ttkbd>RSyntaxTextArea</ttkbd> è un'estensione della più diffusa <ttkbd>JTextArea</ttkbd> contenuta nel package [[Swing_Swing (Java)|Swing]] di Java. Tra le caratteristiche aggiunte compaiono:

* Modalità di inserimento / sovrascrittura (viene attivata premendo il tasto Insert).

* Un menù contestuale, a comparsa, con le opzioni di modifica standard.

* Supporto per le [[Macro_Macro (informatica)|macro]].

* Funzionalità "Marca tutto", applicabile durante la ricerca testuale.

* Un modo per modificare lo sfondo dell'area testuale con un'immagine (i formati supportati sono [[Graphics_Interchange_FormatGraphics Interchange Format|gif]] / [[Portable_Network_GraphicsPortable Network Graphics|png]] / [[JPEG|jpg]])

* Evidenziazione della riga correntemente selezionata (può essere disattivata).

* Un modo facile per stampare il suo contenuto testuale (viene estesa l'interfaccia <ttkbd>Printable</ttkbd>, contenuta nel package [[Abstract_Window_ToolkitAbstract Window Toolkit|AWT]] di Java)

* Differenti modalità di aggiunta dei caratteri di tabulazione (soft e hard, rispettivamente emulati o meno dagli spazi)

* Viene corretto un baco tuttora presente nel metodo <code>setTabSize</code> di <ttkbd>JTextArea</ttkbd>.

Se lo sfondo di una <ttkbd>RTextArea</ttkbd> (classe estesa da <ttkbd>RSyntaxTextArea</ttkbd>) fosse impostato con un determinato colore, la sua proprietà <code>opaque</code> (opaco) verrebbe impostata a <code>true</code> (vero) per ragioni prestazionali. Viceversa, se lo sfondo fosse impostato con un'immagine, allora la proprietà <code>opaque</code> sarebbe valorizzata con <code>false</code> (falso). Tutto ciò peggiora le prestazioni ma, se così non fosse, l'utente vedrebbe comparire dei difetti grafici sullo schermo, nella zona occupata dall'area testuale, mentre scorre un documento usando i tasti direzionali (lo stesso problema non si verifica premendo i tasti Pagina Su/Giù). Fifesoft ha sconsigliato di modificare il valore della proprietà <code>opaque</code>, giacché viene fatto dalle logiche in essere, quando opportuno.

Fifesoft raccomanda di inglobare l'area testuale internamente ad un'istanza di <ttkbd>RTextScrollPane</ttkbd>, anziché nel più noto <ttkbd>JScrollPane</ttkbd> (componente contenuto nel package [[Swing_Swing (Java)|Swing]] di Java), qualora si decidesse di includere <ttkbd>RSyntaxTextArea</ttkbd> in un programma sviluppato autonomamente, dato che questa classe consente l'aggiunta dei numeri della linea e dei segnalibri all'area di testo.

===Dettagli sulle macro===

Riga 138 ⟶ 136:

====Esempio di una macro che apre un file====

L'esempio che segue mostra lo script [[JavaScript]] di una macro che apre un file. Il nome del file da aprire viene ricavato sulla base della selezione nel foglio di lavoro attivo dell'editor RText; se disponibile, il file viene aperto in un nuovo foglio di lavoro di RText:

<sourcesyntaxhighlight lang="javascript">

textArea.beginAtomicEdit();

try {

Riga 178 ⟶ 176:

textArea.endAtomicEdit();

}

</syntaxhighlight>

</source>

Lo stesso esempio programmato in linguaggio [[Groovy]]:

<sourcesyntaxhighlight lang="groovy">

import java.awt.*

import javax.swing.*

Riga 225 ⟶ 223:

textArea.endAtomicEdit()

}

</syntaxhighlight>

</source>

====Esempio di una macro che converte i caratteri speciali per il linguaggio HTML====

L'esempio che segue mostra lo script [[JavaScript]] di una macro che sostituisce qualsiasi testo selezionato con una versione di quel testo formattato in [[HTML]]:

<sourcesyntaxhighlight lang="javascript">

function replaceMultipleSpaces(text) {

var p = java.util.regex.Pattern.compile(" +");

Riga 254 ⟶ 252:

text = text.replace("&", "&amp;").replace("\"", "&quot;").

replace("<", "&lt;").replace(">", "&gt;").

replace("\t", "&#009;").replace("\n", "<br />\n");

if (text.contains(" ")) { // Replace multiple spaces with &nbsp; sequences

text = replaceMultipleSpaces(text);

Riga 266 ⟶ 264:

textArea.endAtomicEdit();

}

</syntaxhighlight>

</source>

====Esempio di una macro che ordina alfabeticamente gli elementi di una lista====

L'esempio che segue mostra lo script [[JavaScript]] di una macro che ordina tutte le righe nel foglio di lavoro attivo di RText:

<sourcesyntaxhighlight lang="javascript">

var removeDuplicates = true; // Change to "false" if you want to keep duplicates

Riga 305 ⟶ 303:

textArea.endAtomicEdit();

}

</syntaxhighlight>

</source>

Lo stesso esempio programmato in linguaggio [[Groovy]]:

<sourcesyntaxhighlight lang="groovy">

final def removeDuplicates = true // Change to "false" if you want to keep duplicates

Riga 331 ⟶ 329:

textArea.endAtomicEdit()

}

</syntaxhighlight>

</source>

== Altri progettiNote ==

{{Note strette}}

{{interprogetto|commons=Category:RText}}

== Collegamenti esterni ==

* {{en}} [http://fifesoft.com/rtext/ Sito ufficiale]

== Voci correlate ==

Riga 347 ⟶ 342:

* [[Videoscrittura]]

== NoteAltri progetti ==

{{interprogetto|commons=Category:RText}}

{{Reflist|colwidth=30em}}

== Collegamenti esterni ==

* {{Collegamenti esterni}}

{{Portale|informatica|Software libero}}