RText: differenze tra le versioni

Versione delle 18:37, 20 set 2016

Versione attuale delle 20:16, 21 nov 2020

(14 versioni intermedie di 12 utenti non mostrate)

Riga 1:

{{O|software|settembre 2016}}

{{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 14 ⟶ 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://bobbylight.github.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]], [[macOS]], [[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=yes 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.

Riga 32 ⟶ 29:

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 38 ⟶ 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 56 ⟶ 53:

* Zoom in e zoom out

* Supporto Windows Cinese, Giapponese e Koreano

* Copia del testo selezionato negli appunti del sistema operativo, sotto forma di [[Rich 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>

* 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 sotto forma di codice HTML, con conseguente conservazione dello stile sintattico impostato.

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

Riga 81 ⟶ 78:

* [[Groovy]]

* [[HTML]]

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

* [[JavaScript]]

* [[JavaServer Pages|JSP]]

Riga 92 ⟶ 89:

* [[PHP]]

* [[Python]]

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

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

* [[SQL]]

Riga 116 ⟶ 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 (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.

Riga 126 ⟶ 123:

* Un modo per modificare lo sfondo dell'area testuale con un'immagine (i formati supportati sono [[Graphics Interchange Format|gif]] / [[Portable 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 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 (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 139 ⟶ 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 179 ⟶ 176:

textArea.endAtomicEdit();

}

</syntaxhighlight>

</source>

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

<sourcesyntaxhighlight lang="groovy">

import java.awt.*

import javax.swing.*

Riga 226 ⟶ 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 267 ⟶ 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 306 ⟶ 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 332 ⟶ 329:

textArea.endAtomicEdit()

}

</syntaxhighlight>

</source>

== Altri progettiNote ==

{{Note strette}}

{{interprogetto|commons=Category:RText}}

== Collegamenti esterni ==

* {{cita web|http://bobbylight.github.io/RText/|Sito ufficiale|lingua=en}}

== Voci correlate ==

Riga 348 ⟶ 342:

* [[Videoscrittura]]

== NoteAltri progetti ==

{{interprogetto|commons=Category:RText}}

{{Reflist|colwidth=30em}}

== Collegamenti esterni ==

* {{Collegamenti esterni}}

{{Portale|informatica|Software libero}}