Aiuto:Strumenti per la rilettura

Cosa sono?

Gli strumenti per la rilettura sono degli script che hanno lo scopo di aiutare il rilettore wikisourciano, automatizzando alcune azioni ripetitive e alleggerendo il lavoro necessario a completare la procedura di rilettura. Essi sono stati pensati sia per facilitare il lavoro degli utenti alle prime armi, che per velocizzare quello degli utenti più esperti. A discapito del nome, alcuni strumenti sono mirati non soltanto alla rilettura, ma possono essere adoperati anche i fase di formattazione.

Si trova nella parte sinistra dello schermo, nella barra laterale sinistra, in basso.

Come si attivano?

Per attivare gli strumenti di rilettura, bisogna anzitutto aprire la pagina Preferenze e andare alla sezione Accessori. Alla voce Strumenti di modifica si trova l'opzione Strumenti di rilettura: cliccando sulla casella di spunta, verranno attivate alcune funzioni ausiliarie durante la fase di rilettura.

In pratica, durante la modifica di una singola pagina, apparirà nella colonna laterale sinistra di Wikisource, sotto ai collegamenti normalmente presenti, una nuova sezione intitolata Strumenti di rilettura in cui sono raccolti alcuni collegamenti aggiuntivi. Ciò che apparirà sarà simile all'immagine sulla destra.

Ecco come appaiono gli strumenti di rilettura (Gennaio 2015).

Per utilizzare gli strumenti di rilettura è sufficiente premere i collegamenti elencati oppure, dove presenti, utilizzare le scorciatoie da tastiera (Alt+5, Alt+6, ...).

Funzioni attivate

1. trova & sostituisci
2. elimina riga 1 Alt+5 (in parte deprecato)
3. aggiusta paragrafi Alt+6
4. postOCR Alt+7
5. unisci linee Alt+8
6. RigaIntestazione Alt+9 (deprecato)
7. Numero riga ogni 3
8. Numero riga ogni 4
9. Numero riga ogni 5
10. Num. riga ogni fine strofa
11. Elimina tutti i {{R}}
12. converti é -> è (può essere ottenuto con Trova e sostituisci)
13. virgolette
14. spostamento note
15. iniziale maiuscola (per le opere in versi)

Strumenti

Trova e sostituisci

Lo strumento Trova e sostituisci presenta alcune analogie con l'omonimo strumento integrato negli strumenti di default e rintracciabile alla sezione Avanzate del toolbox, sulla destra. Nonostante il nome, questo strumento non possiede una funzione "trova", ed esegue solamente sostituzioni globali e dirette.

Quindi, se serve sostituire con cautela esaminando una a una le sostituzioni, è opportuno usare lo strumento standard, anziché lo script.

Tuttavia il nostro Trova e sostituisci, scritto da Candalua, ha il vantaggio di avere un codice aperto e quindi migliorabile; e nel tempo in effetti sono state aggiunte interessanti caratteristiche.

1. Se si seleziona un testo, e poi si attiva Trova e sostituisci, la selezione viene automaticamente caricata sia nel campo Cerca che nel campo Sostituisci. Basta modificare (per quello che serve) il campo Sostituisci e dare OK.
2. Eseguita la sostituzione, il tool non si chiude; possono essere predisposte altre sostituzioni e possono essere lanciate, una dopo l'altra, con notevole velocità.
3. Possiede un'opzione Ricorda. Se si attiva questa opzione, la sostituzione viene memorizzata in una variabile permanente, e verrà lanciata automaticamente su qualsiasi pagina aperta successivamente, nel momento in cui si lancia postOCR.
4. Può eseguire sostituzioni regex; l'argomento è molto complesso, ma chi conosce la sintassi regex di javascript o chi intende provare troverà questa opzione molto interessante. Il codice da inserire nel primo campo è quello che si inserirebbe nel delimitatore regex / / e non quello che si inserirebbe in una stringa da passare a RegExp. Il tool dà all'espressione regex un parametro g (sostituzioni multiple) di default.

Approfondimento: "Ricorda"

Le sostituzioni memorizzate vengono impaccate in un oggetto in formato JSON memorizzato in localStorage.memoRegex. L'opzione Ricorda memorizza la sostituzione aggiungendola a quelle già presenti nella variabile. Il gadget memoRegex aggiunge due pulsanti,salva regex e carica regex. Il primo permette di scaricare l'intera variabile in formato testo, in qualsiasi pagina; il secondo consente di caricare in memoria un set precedentemente memorizzato con salva regex, semplicemente selezionandolo e premendo il pulsante, aggiungendo tutte le sostituzioni a quelle precedentemente memorizzate.

Questo meccanismo è pensato per creare delle serie di sostituzioni specifiche per un'opera, o per un tipo di opere; salvando le sostituzioni in una pagina stabilita (di solito la pagina Discussioni indice: dell'opera) il set di sostituzioni può essere caricato e arricchito da più utenti, ed è inoltre disponibile per lo stesso utente nel momento in cui si lavora con un altro browser o con un altro pc (localStorage è, infatti, "privato", nel senso che è memorizzato in uno spazio specifico del pc, inaccessibile agli altri browser, e visibile solo dal sito da cui è stato memorizzato).

Un approfondimento ed esempi pratici qui: Aiuto:MemoRegex

Esempi

Emulazione dello strumento é -> è

Per inglobare l'azione di converti é -> è in trova e sostituisci, è sufficiente inserire nel campo Cerca il carattere é, in Sostituisci il carattere è, attivare l'opzione Ricorda e premere Ok. Alle successive attivazioni di postOCR, la sostituzione verrà effettuata in automatico. È importante notare che in certi casi é va conservato e non sostituito!

Creazione di un dizionario per la sostituzione f -> s

Il carattere ſ, o s lunga, presente in alcuni testi non recenti, è prevalentemente interpretato dal software OCR come f. Essendo nell'italiano scritto più frequente la s rispetto alla f, una discreta strategia è quella di convertire tutti i caratteri f in s per poi correggere gli eventuali errori. Tuttavia, un metodo più accurato potrebbe essere il seguente: memorizzare le sostituzioni per le parole più comuni e meno ambigue, andando a costituire progressivamente un dizionario di sostituzioni.

Allineamento a destra delle celle contenenti numeri

Un interessante esempio di applicazione di trova e sostituisci congiuntamente alle espressioni regolari. Poniamo il caso in cui la riga della tabella in cui vogliamo allineare le cifre a destra sia la seguente:

|Milano||1924||Torino||1932

È possibile notare che le celle in cui va inserito il codice di allineamento align=right| sono riconoscibili per la presenza di un doppio carattere |, seguito da una cifra numerica. Impostando le espressioni regolari \|\|(\d) in Cerca e ||align=right|$1 in Sostituisci, il lavoro viene svolto agilmente, anche in presenza di molte righe e colonne. :-)

Elimina riga 1

La prima riga, o le prime due righe, di un testo OCR nella larga maggioranza dei casi contengono elementi dell'intestazione della pagina. L'attuale strumento postOCR è in grado di indovinare, in molti casi, il testo e il formato dell'intestazione, e anche di eliminare la prima riga del testo OCR, quando questa riga è sufficientemente simile al testo dell'intestazione di pagina; in vari casi restano comunque una o due righe da cancellare, il tool cancella la prima riga corrente con un click, senza nemmeno puntare la riga con il mouse, e fa quindi risparmiare qualche secondo. Particolarmente utile se usato in immediata sequenza con gli altri tool (la sequenza tipica per un testo in prosa è Alt+7, Alt+5, Alt+6, Alt+8, da eseguire tenendo d'occhio cosa succede e non alla cieca).

PostOCR

Lo strumento postOCR, richiamabile da tastiera con la combinazione Alt+7, ingloba diverse operazioni di correzione del testo ed ha un duplice scopo: rimuovere gran parte dei difetti tipicamente presenti in un testo ottenuto da software OCR - denominati scannos - e inserire automaticamente del codice di formattazione. La versione attuale dello script preserva le parti già formattate - tabelle, link, template, ... - e ciò consente di eseguirlo più volte senza causare modifiche indesiderate alla struttura della pagina; ad esempio, grazie a postOCR è possibile velocizzare la procedura di inserimento degli apostrofi tipografici ¹ ponendo in fase iniziale degli apostrofi dattilografici - più facilmente inseribili tramite tastiera - e lanciando poi un'istanza dello strumento.

La quantità di operazioni effettuate da postOCR fa di questo strumento un'importante risorsa durante lo svolgimento dell'attività che costituisce il "cuore pulsante" di Wikisource: la correzione del testo e l'inserimento di template ricorrenti in nsPagina. E lo è nonostante alcune delle sue funzioni siano eseguite automaticamente durante il caricamento del testo fornito dal software OCR in una nuova pagina, poiché esso incorpora alcune procedure che possono essere riutilizzate durante la fase di modifica - e che, se conosciute, consentono di svolgere il lavoro più efficacemente.

Approfondimento: come funziona?

Prima di iniziare ad usare postOCR e per comprenderne appieno l'utilità, occorre avere le idee ben chiare riguardo le operazioni - ripetitive e laboriose - necessarie per trasformare il testo prodotto da un software OCR, anche di elevata qualità, in un lavoro che soddisfi ai requisiti di correttezza e buona formattazione di Wikisource.

Un elenco (incompleto) delle azioni da svolgere per correggere il testo è il seguente:

1. Rimuovere porzioni di testo non facenti parte del corpo della pagina, come intestazione di pagina, piè di pagina e residui di pagine precedenti o successive.
2. Verificare che quanto riportato, punteggiatura compresa corrisponda fedelmente all'originale a fronte.
   1. Correggere gli errori di scansione generici;
   2. Correggere gli errori di scansione specifici per l'opera su cui si sta lavorando;
3. Ricomporre le parole spezzare a fine riga, trascurando inizialmente gli "a capo".
4. Sistemare le spaziature in corrispondenza dei segni di interpunzione.
5. Convertire gli apostrofi dattilografici in apostrofi tipografici (ove previsto).
6. Marcare le aree in versi con i tag <poem>...</poem>.
7. Nei testi in prosa, esternamente alle aree in versi:
   1. Identificare i paragrafi aggiungendo una riga vuota tra la fine di un paragrafo e l'inizio del successivo;
   2. Ricomporre ogni paragrafo rimuovendo gli "a capo" presenti tra i suoi periodi.

All'interno del namespace Pagina vanno poi eseguite le seguenti operazioni:

1. Aggiungere in testa alla pagina, nella sezione header, l'intestazione. Ciò dev'essere fatto utilizzando il template {{RigaIntestazione}}, opportunamente compilato: in genere, si devono inserire il numero di pagina ed un riferimento all'opera o al capitolo.
2. Sistemare le parole spezzate a inizio o fine pagina, usando il template {{Pt}} ("parola tronca" ²).
3. Verificare se sono presenti citazioni ad autori o opere ed eventualmente aggiungere i riferimenti mediante i template {{AutoreCitato}} e {{TestoCitato}}.
4. Sistemare le note a piè di pagina usando i tag <ref>...</ref>
5. Aggiungere, se presente, il piè di pagina nella sezione footer, utilizzando {{PieDiPagina}}.

Eseguendo postOCR, vengono automatizzate una buona parte delle azioni contenute nella prima lista e l'inserimento dell'intestazione di pagina. La procedura può essere poi completata - dopo aver marcato le aree in versi! - con l'utilizzo degli strumenti aggiusta paragrafi e unisci linee. Per la correzione di errori "opera-specifici", postOCR agisce in cooperazione con trova e sostituisci; questa procedura è tuttavia complessa, data la necessità di caricare in memoria e salvare in una pagina le liste di sostituzioni "opera-specifiche" che sono state "ricordate", e verrà trattata a parte.

L'automazione dell'inserimento dell'intestazione di pagina si basa sull'analisi - lettura e caricamento in memoria - del testo completo presente due facciate prima rispetto a quella corrente, alla ricerca della presenza del template {{RigaIntestazione}}. Le intestazioni di pagina sono infatti simili rispettivamente per il recto ed il verso di un foglio del libro ³, tranne che per il numero di pagina; da libro a libro, l'intestazione di pagina può differire in base al capitolo. Ciò che fa postOCR è leggere la riga di intestazione ottenuta, identificare il numero di pagina, adeguarlo per la pagina attualmente in fase di modifica, e inserire in header il risultato ottenuto; nel caso di un cambio radicale di intestazione da una pagina all'altra, è necessaria una correzione manuale. Lo script non inserisce nessuna riga di intestazione se si verifica una condizione tra:

1. L'analisi non restituisce alcuna riga di intestazione - quindi, nella facciata ispezionata non si trovava alcun template {{RigaIntestazione}}.
2. Nella pagina che si sta modificando è già presente {{RigaIntestazione}}.

Inoltre, prima di inserire un nuovo template {{RigaIntestazione}}, postOCR verifica - in caso non vi sia ancora alcuna riga di intestazione - la corrispondenza della prima riga del corpo pagina con la riga di intestazione calcolata: se la somiglianza è sufficientemente alta, esso rimuove automaticamente tale riga.

Aggiusta paragrafi

Combinazione da tastiera Alt+6

L'output prodotto da un software OCR non sempre presenta una corretta separazione dei paragrafi originali: alcune volte, infatti, essi vengono giustamente strutturati, altre volte invece il testo fornito è compattato e privo di righe vuote, corrispondenti in sintassi wiki ad un inizio di paragrafo. Lo strumento aggiusta paragrafi serve al rilettore per snellire le operazioni di suddivisione della pagina. Lo script agisce inserendo una riga vuota dopo ogni segno di interpunzione forte - punto fermo, punto esclamativo, punto interrogativo, ... - che in buona parte dei testi indica la fine di un paragrafo; la sua efficacia è alta su testi con periodi molto lunghi, mentre in presenza di frasi molto brevi tende ad aggiungere righe vuote in eccesso. Queste andranno rimosse manualmente.

Prima di avviare aggiusta paragrafi, è essenziale delimitare le eventuali parti in versi con i marcatori <poem>...</poem>, in modo da prevenire l'inserimento di righe vuote di troppo all'interno di queste sezioni.

Unisci linee

Combinazione da tastiera Alt+8

Unisci linee è uno strumento specifico per i testi in prosa e per gli scritti in cui sono presenti sia prosa che poesia, opportunamente delimitata da marcatori <poem>...</poem>. La sua efficacia è massima quando combinato con gli strumenti postOCR e aggiusta paragrafi. Perché?

Grazie a postOCR, le parole tronche a fine riga vengono ricomposte, ma permangono gli "a capo" a fine riga, spesso non necessari. D'altro canto, aggiusta paragrafi aggiunge delle righe vuote ma mantiene intatti i ritorni a capo interni ai paragrafi. Qui entra in gioco unisci linee: gli "a capo" interni ad un paragrafo vengono rimpiazzati da una spaziatura semplice ed il testo viene di fatto compattato. Il vantaggio di avere i periodi compatti e non separati su più righe è quello di poter utilizzare strumenti che agiscono su un singolo periodo, come la formattazione in corsivo, senza doversi preoccupare del fatto che al primo ritorno a capo la sua azione termina.

Una buona prassi, su una nuova pagina contenente il testo OCR appena generato, è quella di lanciare la sequenza postOCR -> aggiusta paragrafi -> unisci linee, ottenendo con il minimo sforzo una formattazione pressoché completa; un'alternativa ancora più comoda è digitare da tastiera Alt+7, poi Alt+6 ed infine Alt+8.

RigaIntestazione

Superato; la funzione è stata rivista e inglobata in postOCR

Tools per la numerazione dei versi

Da “Numero riga ogni 3” a “Elimina tutti i {{R}}”: Tools per la numerazione automatica dei versi, trattati a parte.

Converti é -> è

La convenzione ortografica che indica l'accento acuto sulla e (é) come appropriato per alcune parole (sé, né, ventitré, perché, sicché ecc...) è recente; i testi meno recenti, pubblicati finanche ben entro il primo quarto del XX secolo — per esempio questo testo del 1912 o questo del 1927 — non tengono conto di questa convenzione e in tal caso l'ortografia originale va rispettata. Sia l'OCR che trascrizioni usate come fonte però riportano la versione moderna é invece che quella originale è; il tool converte tutte le ricorrenze di é in è.

Attenzione! alcuni testi presentano citazioni in francese, in cui la differenza fra i due accenti è importante e va conservata.

Attenzione! In testi poetici del XVII e XVIII secolo l'accento acuto è usato per indicare il fenomeno metrico della dieresi, laddove oggi si usa il segno ¨, come ad esempio poéta invece di poëta.

Virgolette

Il problema delle virgolette diverse dall'apostrofo semplice è complesso, perché generalmente sono in coppie di caratteri diversi che devono comparire nella giusta sequenza di apertura - chiusura. Inoltre, vi sono parecchi stili diversi di virgolette.

Inoltre, i due caratteri sono difficili da ottenere con la tastiera; si possono inserire utilizzando i caratteri speciali o la raccolta di codici nella Edittool (gadget attivato di default). Il tool virgolette consente di inserire le virgolette come normali caratteri "come qui"; alla prima pressione di Virgolette tutte le doppie virgolette di qualsiasi formato vengono convertite nel tipo standard più comune: “questo”; un secondo click le inverte (scambia le aperture con le chiusure) in modo di sistemare le cose anche nel caso anomalo in cui la prima virgoletta del testo è di chiusura. Avviene quando la virgoletta di apertura è nella pagina precedente. Le successive pressioni alternano le due possibilità.

Una ottima alternativa per modificare il tipo di virgolette aperte e chiuse, purchè siano due caratteri diversi, è il tool trova & sostituisci, memorizzando la sostituzione con l'opzione "Ricorda"; la sostituzione verrà eseguita sempre, nel momento della chiamata a postOCR.

Spostamento note

Spostamento note è uno strumento pensato per facilitare la lettura di pagine in cui sono presenti molte note, alternando due tipologie di visualizzazione:

1. Visualizzazione normale: le note vengono visualizzate internamente al corpo pagina, circondate da tag <ref>...</ref>; lo svantaggio di questa modalità visiva è che, nel caso in cui siano presenti note corpose o in gran numero, la rilettura risulta piuttosto complicata.
2. Visualizzazione alternativa: le note vengono trasferite nel fondo pagina e al loro posto viene inserito un codice marcatore; questa disposizione riflette quella ottenuta come risultato finale, e generalmente risulta più gradevole in fase di rilettura.

Se si effettua la rilettura in visualizzazione alternativa, lanciando lo script a lavoro concluso si ritorna alla visualizzazione classica. Nell'utilizzare spostamento note, è bene fare attenzione ad alcuni possibili imprevisti:

1. Quando si opera in visualizzazione alternativa, occorre inserire nel punto del testo in cui si vuole richiamare la nota il codice ^nota; nelle prossime versioni dello script questo processo potrebbe essere automatizzato, al momento l'operazione va eseguita manualmente. Successivamente, le note presenti a fondo pagina vanno corrette e delimitate con i tag <ref>...</ref>; infine, cliccando su spostamento note, esse verranno posizionate all'interno del testo.
2. È estremamente importante controllare che il numero dei codici marcatori ed il numero di note a fondo pagina combacino, onde evitare malfunzionamenti dello script. In aiuto del rilettore, verrà visualizzato un messaggio d'errore qualora le due quantità non corrispondessero.
3. Attenzione! Nell'inserire le note, va adottato o uno o l'altro approccio. Se il lavoro è impostato in modalità classica, gli errori o le note mancanti vanno inserite nel corpo pagina; se invece esso è in modalità alternativa, si deve provvedere ad inserire dei codici marcatori nel testo e a riportare le note a fondo pagina. Un utilizzo ibrido delle due procedure comporta un totale rimescolamento delle note.

Iniziale maiuscola

In parecchie opere poetiche si utilizza come base per la trascrizione proofread il testo proveniente da una differente edizione, e avviene che in differenti edizioni siano usate convenzioni tipografiche diverse; è abbastanza frequente che nel testo da correggere le iniziali dei versi siano in lettera minuscola (se il testo continua quello di un verso precedente) mentre l'edizione proofread utilizzi il formato "tutte le iniziali dei versi maiuscole". Lo strumento Iniziale maiuscola esegue la conversione minuscola-maiuscola in tutte le lettere di inizio riga ossia, nei testi in versi, di tutte le iniziali dei versi.

Va utilizzato prima di aggiungere eventuale codice di formattazione all'inizio dei versi (es. {{R}}.

autoPt

Ad oggi attivato dal pulsante in toolbar di modifica->Avanzate, sarà aggiunto come strumento al posto di RigaIntestazione, ormai superato.

Aiuta l'utente ad applicare correttamente il template Pt per riunire, in transclusione, le parole spezzate a fine pagina.

Immaginiamo che a fine pagina vi sia la parola rela- e all'inizio della pagina successiva la parola tivo; in trasclusione deve essere "ricostruita" la parola relativo.

Per farlo occorre scrivere {{Pt|rela-|}} alla fine della prima pagina, e {{Pt|tivo|relativo}} all'inizio della pagina successiva.

Il tool autoPt facilita l'applicazione del codice in tre diverse modalità.

1. alla fine della prima pagina, selezionare rela- e premere il pulsante.
2. all'inizio della pagina successiva, selezionare tivo e premere il pulsante. Attenzione: funziona solo se nella pagina precedente è stato correttamente applicato il template Pt.
3. senza selezionare nulla, premere il pulsante sia nella prima che nella seconda pagina. Attenzione: nella seconda pagina, che inizia con la seconda parte di una parola spezzata, funziona solo se nella pagina precedente è stato correttamente applicato il template Pt e se la parola spezzata su cui applicare il template Pt è la prima parola della pagina.

Altri strumenti

Gli Strumenti per la rilettura integrano altri tools per la modifica dei testi ed altre operazioni ricorrenti:

1. i pulsanti di edit dell'interfaccia di default (vector), a cui possono essere aggiunti pulsanti opzionali, in un'area che compare immediatamente sopra alla finestra di edit (chiamata Toolbar, qui la chiamiamo anche 'toolbar di modifica'); è prevista la possibilità di aggiungere pulsanti aggiuntivi;
2. la raccolta di codici ricorrenti contenuti in un'area che compare al di sotto della finestra di edit (chiamati edit tools); non è prevista la possibilità di aggiungere ulteriori codici personali;
3. la "bottoniera", strumento originale di it.wikisource, che fa apparire una riga di pulsanti personalizzabili fissi sul margine inferiore dello schermo, che viene attivata con il gadget Raccolta dei giocattoli; è fatta apposta per dare la massima libertà di personalizzazione, con un codice semplice (nei limiti di quanto può essere semplice un codice javascript).

Domande?

Se hai domande, dubbi, proposte o necessiti di chiarimenti sui regex Menu Framework premi qui per lasciare un messaggio nella pagina di discussione oppure apri una discussione nel bar principale.

Note

1. La convenzione sul trattamento degli apostrofi in sede di trascrizione prevederebbe un utilizzo prevalente dell'apostrofo dattilografico, per la maggior facilità di inserimento. Utilizzando postOCR, si può parzialmente rimediare a quest'impedimento.
2. In realtà Pt è acronimo di "Pagina-Testo", perché il contenuto del primo parametro si visualizza in Pagina, il contenuto del secondo in Testo; ma a fini mnemonici "parola tronca" va benissimo :-)
3. recto e verso di una carta o foglio indicano la facciata destra e sinistra seguente o viceversa, a seconda del tipo di scrittura di una lingua.