RText: differenze tra le versioni
Contenuto cancellato Contenuto aggiunto
Aggiunta di una fonte. |
m tag source deprecati, replaced: <source lang= → <syntaxhighlight lang= (5), </source> → </syntaxhighlight> (5) |
||
| (35 versioni intermedie di 18 utenti non mostrate) | |||
Riga 1:
{{Software
|Nome = RText
|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.
|DataUltimaVersione = {{data e tempo|
|UltimaVersioneBeta =
|DataUltimaVersioneBeta =
Riga 13 ⟶ 12:
|SistemaOperativo2 = Linux
|SistemaOperativo3 = Mac OS X
|Genere = Editor di testo
|Licenza = [[BSD License]] (in una versione modificata)
|SoftwareLibero = sì
|Lingua = Multilingua
|SitoWeb =
}}
'''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]], [[
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 [[
== 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
* 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
* Evidenziazione della riga correntemente selezionata
* Interfaccia grafica personalizzabile (icone, look and feel e schemi dei colori)
Il codice sorgente è attualmente ospitato dai Server di SourceForge, Maven e GitHub.
== Caratteristiche ==
RText è un software che segue la filosofia [[FOSS]], supporta l'[[autocompletamento]], la ricerca/sostituzione tramite [[espressioni regolari]], il [[code folding]], i [[segnalibro (informatica)|segnalibri]], l'[[Bracket matching|evidenziazione delle parentesi]] e l'[[indentazione]].<ref name=j-rsyntaxtextareaapidocumentation /> Supporta anche l'aggiunta di [[macro (informatica)|macro]] e [[plugin (informatica)|plugin]]. Di base sono già inclusi alcuni plugin ritenuti essenziali dal fondatore, scritti dallo stesso sviluppatore del progetto (permettono, per esempio, di esplorare il [[File System]]).<br />
RText ha un'interfaccia personalizzabile ed è possibile aprire più documenti all'interno della stessa istanza del programma tramite l'uso delle linguette. Presenta stili, ''font'' e colori a tema propri di editor di testo evoluti. Il tradizionale Blocco note incluso in bundle con il sistema operativo [[Microsoft Windows|Windows]], al contrario, non permette di scegliere il colore del font e dello sfondo. Sono presenti alcuni ''temi'' che recuperano la tradizionale modalità sfondo nero/caratteri bianchi o grigi.
Riga 77 ⟶ 53:
* Zoom in e zoom out
* Supporto Windows Cinese, Giapponese e Koreano
* Copia del testo selezionato negli appunti del sistema operativo,
* 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
* Esportazione del contenuto dell'area testuale
* Gestore [[
* 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 memoria|heap]].
== Linguaggi supportati ==
Supporta diversi [[linguaggi di programmazione]] e [[Linguaggio di marcatura|di marcatura]]
Al momento sono:
Riga 95 ⟶ 74:
* [[C Sharp|C#]]
* [[Clojure]]
* [[
* [[
* [[Groovy]]
* [[HTML]]
* [[Java (linguaggio di programmazione)|Java]]
* [[JavaScript]]
* [[
* [[Visual Basic]]
* File .jshintrc
* [[
* [[Lisp]]
* [[
* [[Perl]]
* [[PHP]]
* [[Python]]
* [[Ruby (linguaggio di programmazione)|Ruby]]
* [[
* [[SQL]]
* [[Shell script|Script della shell UNIX]]
* [[
* [[XML|File XML]]
* [[ActionScript]]
* [[BBCode]]
* [[
* [[
* [[Fortran]]
* [[.htaccess|Htaccess]]
* [[LaTeX]]
* Less
* [[Lua]]
* Makefile
* [[MXML]]
* File di properties
* [[
* [[Tcl]]
{{Div col end}}
==
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. <kbd>RSyntaxTextArea</kbd> è un'estensione della più diffusa <kbd>JTextArea</kbd> 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.
* Supporto per le [[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 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 <kbd>Printable</kbd>, 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 <kbd>JTextArea</kbd>.
Se lo sfondo di una <kbd>RTextArea</kbd> (classe estesa da <kbd>RSyntaxTextArea</kbd>) 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 <kbd>RTextScrollPane</kbd>, anziché nel più noto <kbd>JScrollPane</kbd> (componente contenuto nel package [[Swing (Java)|Swing]] di Java), qualora si decidesse di includere <kbd>RSyntaxTextArea</kbd> 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===
Le macro vengono programmate alternativamente nel [[linguaggio di scripting]] [[Programmazione orientata agli oggetti|orientato agli oggetti]] ed agli [[Programmazione orientata agli eventi|eventi]] [[JavaScript]], sfruttando l'interprete [[JavaScript]] Rhino, oppure nel [[linguaggio di programmazione]] [[Programmazione ad oggetti|ad oggetti]] per la [[piattaforma Java]] [[Groovy]].
====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:
<syntaxhighlight lang="javascript">
textArea.beginAtomicEdit();
try {
var fileName = textArea.selectedText;
if (fileName==null || fileName.length()==0) {
javax.swing.JOptionPane.showMessageDialog(rtext,
"Couldn't open file: No selection.\n" +
"A file name must be selected in the active editor to open a file.",
"Error", javax.swing.JOptionPane.ERROR_MESSAGE);
}
else {
var isUrl = fileName.startsWith("http://");
var file = new java.io.File(fileName);
if (!file.isAbsolute()) {
var parentDir = new java.io.File(textArea.fileFullPath).parentFile;
file = new java.io.File(parentDir, fileName);
}
// Easter egg - if this is a URL, open it in a browser
if (isUrl) {
java.awt.Desktop.getDesktop().browse(new java.net.___URL(fileName).toURI());
}
else if (file.isFile()) {
rtext.openFile(file.absolutePath);
}
else if (file.isDirectory()) {
var chooser = rtext.fileChooser;
chooser.currentDirectory = file;
rtext.getAction(org.fife.rtext.RTextActionInfo.OPEN_ACTION).actionPerformed(null);
}
else {
javax.swing.JOptionPane.showMessageDialog(rtext,
"File does not exist:\n" + file.absolutePath, "Error",
javax.swing.JOptionPane.ERROR_MESSAGE);
}
}
} finally {
textArea.endAtomicEdit();
}
</syntaxhighlight>
Lo stesso esempio programmato in linguaggio [[Groovy]]:
<syntaxhighlight lang="groovy">
import java.awt.*
import javax.swing.*
import org.fife.rtext.*
textArea.beginAtomicEdit()
try {
def fileName = textArea.selectedText
if (fileName==null || fileName.length()==0) {
JOptionPane.showMessageDialog(rtext,
"""Couldn't open file: No selection.
A file name must be selected in the active editor to open a file.""",
"Error", JOptionPane.ERROR_MESSAGE)
}
else {
def isUrl = fileName.startsWith("http://")
def file = new File(fileName)
if (!file.isAbsolute()) {
def parentDir = new File(textArea.fileFullPath).parentFile
file = new File(parentDir, fileName)
}
// Easter egg - if this is a URL, open it in a browser
if (isUrl) {
Desktop.desktop.browse(new URL(fileName).toURI())
}
else if (file.isFile()) {
rtext.openFile(file.absolutePath)
}
else if (file.isDirectory()) {
def chooser = rtext.fileChooser
chooser.currentDirectory = file
rtext.getAction(RTextActionInfo.OPEN_ACTION).actionPerformed(null)
}
else {
JOptionPane.showMessageDialog(rtext,
"File does not exist:\n" + file.absolutePath, "Error",
JOptionPane.ERROR_MESSAGE)
}
}
} finally {
textArea.endAtomicEdit()
}
</syntaxhighlight>
====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]]:
<syntaxhighlight lang="javascript">
function replaceMultipleSpaces(text) {
var p = java.util.regex.Pattern.compile(" +");
var m = p.matcher(text);
var sb = new java.lang.StringBuffer();
while (m.find()) {
var spaces = m.group();
m.appendReplacement(sb, spaces.replace(" ", " "));
}
m.appendTail(sb);
return sb.toString();
}
textArea.beginAtomicEdit();
try {
var text = textArea.selectedText;
if (text==null || text.length()==0) {
javax.swing.JOptionPane.showMessageDialog(rtext,
"Error: No selection.\n" +
"Text must be selected to HTML-ify.",
"Error", javax.swing.JOptionPane.ERROR_MESSAGE);
}
else {
text = text.replace("&", "&").replace("\"", """).
replace("<", "<").replace(">", ">").
replace("\t", "	").replace("\n", "<br />\n");
if (text.contains(" ")) { // Replace multiple spaces with sequences
text = replaceMultipleSpaces(text);
}
var start = textArea.getSelectionStart();
textArea.replaceSelection(text);
textArea.setSelectionStart(start);
textArea.setSelectionEnd(start+text.length());
}
} finally {
textArea.endAtomicEdit();
}
</syntaxhighlight>
====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:
<syntaxhighlight lang="javascript">
var removeDuplicates = true; // Change to "false" if you want to keep duplicates
function join(lines) {
var sb = new java.lang.StringBuffer();
if (lines!=null && lines.length>0) {
for (var i=0; i<lines.length; i++) {
//System.out.println(lines[i]);
sb.append(lines[i]).append('\n');
}
}
return sb.toString();
}
// Note: You'll want to consider wrapping your scripts inside calls to
// beginAtomicEdit() and endAtomicEdit(), so the actions they perform can
// be undone with a single Undo action.
textArea.beginAtomicEdit();
try {
var lines = textArea.text.split("\n");
if (removeDuplicates) {
var ts = new java.util.TreeSet();
for (var i=0; i<lines.length; i++) {
ts.add(lines[i]);
}
lines = ts.toArray();
}
java.util.Arrays.sort(lines);
textArea.text = join(lines);
} finally {
textArea.endAtomicEdit();
}
</syntaxhighlight>
Lo stesso esempio programmato in linguaggio [[Groovy]]:
<syntaxhighlight lang="groovy">
final def removeDuplicates = true // Change to "false" if you want to keep duplicates
// Note: You'll want to consider wrapping your scripts inside calls to
// beginAtomicEdit() and endAtomicEdit(), so the actions they perform can
// be undone with a single Undo action.
textArea.beginAtomicEdit()
try {
def lines = textArea.text.split("\n")
if (removeDuplicates) {
def ts = new TreeSet()
lines.each {
ts.add(it)
}
lines = ts.toArray()
}
Arrays.sort(lines)
textArea.text = lines.join("\n")
} finally {
textArea.endAtomicEdit()
}
</syntaxhighlight>
== Note ==
{{Note strette}}
== Voci correlate ==
Riga 146 ⟶ 342:
* [[Videoscrittura]]
==
{{interprogetto}}
== Collegamenti esterni ==
* {{Collegamenti esterni}}
{{Portale|informatica|Software libero}}
| |||