Utente:LoStrangolatore/Per scrivere un testo commentato

Come scrivere un testo commentato

0. Da controllare in anticipo:

se possibile, il testo di Wikisource dovrebbe essere allo stato "Edizione Wikisource" (aka SAL 101%, è lo stato con la stellina); semmai, prepararsi in anticipo, segnalandolo, con qualche mese di anticipo, tra le "collaborazioni del mese" di WS (cioè → qui).

1. Incollare, da Wikipedia,

la biografia dell'autore
la sintesi e le info generali sul contesto storico e sull'opera.

2. Incollare i testi da Wikisource. Predisporre le seguenti sezioni:

testo
parafrasi
traduzione
riassunto
sezioni per l'analisi: analisi stilistica, commento, ...; in alternativa, predisporre una sola sezione "Analisi del testo", così da lasciare libertà all'utente.

Come aggiungere un testo da Wikisource:

predisporre una sandbox con la struttura della pagina. Il minimo è il tmpl sommario, la categoria del libro, l'avanzamento. Decidere se l'analisi andrà nella stessa pagina del testo originale o in una pagina separata (per motivi di spazio).
prendere il testo da WS. Nota: il testo di WS potrebbe contenere link, utili per es. se il testo fa menzione di personaggi, che sono stati identificati durante la rilettura su WS, ma potrebbero non essere facilmente individuabili se manca un link che li identifichi. Tali wikilink vanno messi nelle note, con delle indicazioni verbali, invece di essere lasciati come semplici wikilink nel testo, perché altrimenti si perderanno durante la stampa o la conversione in PDF.
- Al momento, lo faccio copiando la colonna centrale della pagina di WS, quindi sostituendo le occorrenze della regex \[p. [^]]*] con la stringa vuota, quindi ripassando per aggiustare i paragrafi (che nel copia-incolla diventano un singolo ritorno a capo, mentre dovrebbero essere due ritorni a capo) ed eventualmente aggiungere i wikilink.
- Un altro modo è substare le pagine interessate in una sandbox, quindi sottoporre il prg ad uno script (→ vedi) che sostituisca i template di Wikisource con il markup o i template utilizzati su Wikibooks (alcuni magari da sostituire con il template:void), e infine scorrendo il testo alla ricerca di immagini o altro markup, e controllando i wikilink.
- Potrebbero esserci altri modi per copiare il testo (magari preservando i link): vedi s:Wikisource:Bar#Il_testo_di_un_capitolo.
creare la nuova pagina, substando la sandbox e passando come argomento a quest'ultima il testo di WS.

Prendere in considerazione la possibilità di mettere nella sandbox

la fonte: un link che punti a Wikisource, da utilizzare come rimando all'originale. Ciò permette di verificare rapidamente l'aderenza al testo originale (su WS c'è la versione scannerizzata) soprattutto se il testo di WS non è al 101%. La sandbox può generare il link in automatico, ma per fare questo deve ricevere come argomento almeno il numero del capitolo.
le parti principali della futura pagina possono essere passate ad un templ creato apposta per il libro; per es. il testo la parafrasi, la traduzione. Ciò permetterà di restilizzare le parti principali dell'intero libro, in seguito, con un solo edit. Stesso dicasi per la parafrasi. Esempi: Template:Carmina (Catullo)/TestoOriginale e Template:Il Principe/Testo.
...

3. Predisporre la raccolta, sotto WB:Raccolte, con l'elenco di tutte le pagine del libro.

Se le pagine di analisi sono separate dalle pagine del testo originale, prendere in considerazione la struttura

;Capitolo n
:[[Libro/Capitolo n|Testo]]
:[[Libro/Capitolo n (analisi)|Analisi]]

Utilità varie

Utente:LoStrangolatore/Script/Apri_Puntano_Qui/Codice

Generare numeri romani

Generare i numeri romani

class Main
{
        public static void main (String[] args) {
                for(int i = 0; i < 27; i++)
                        System.out.println(romano(i));
        }
        
        // Restituisce il numero romano che corrisponde al numero indicato.
        // @param num > 0
        private static String romano(int num) {
                if (num <= 0)
                        throw new IllegalArgumentException("" + num + " <= 0");
                
                final int[] soglie = { 1000, 900, 500, 400, 100, 90, 50, 40, 10, 9, 5, 4, 1 };
                final String[] simboli = { "M", "CM", "D", "CD", "C", "XC", "L", "XL", "X", "IX", "V", "IV", "I" };
                
                
                final StringBuilder result = new StringBuilder();
                
                for(int i = 0; i < soglie.length; i++) {
                        final int soglia = soglie[i];
                        final String simbolo = simboli[i];
                        
                        final int numRipetizioni = num / soglia;
                        appendNTimes(result, simbolo, numRipetizioni);
                        num = num % soglia;
                }
                
                return result.toString();
        }
        
        private static void appendNTimes(StringBuilder target, String what, int n) {
                for(int i = 0; i < n; i++)
                        target.append(what);
        }
        
}

Trasformazione capitolo incollato da WS

Codice che prende in input il markup di un capitolo salvato su WS (ottenuto substando in una sandbox le pagine interessate), e lo adatta a WB. Cosa deve fare:

sostituisce alcuni template di WS con quelli di WB; se trova template di WS che non conosce, non restituisce un output, invece segnala un errore indicando il template
duplica ogni wikilink [[link|titolo]] nella forma titolo<ref>[[link|titolo]].</ref> preoccupandosi anche di aggiungere il prefisso s: se il link non contiene già quello di Wikipedia, cioè w:
se ci sono immagini, le segnala, così che l'utente possa decidere che farne

Sostituzione template di WS

Elenco di testi commentati da creare

Una wishlist è in s:Wikisource:Biblioteca_scolastica.
Commento illuminante di Mizardellorsa (12:41, 21 mar 2012) in w:Wikipedia:Bar/Discussioni/Progetto Editoria Digitale (o come portare Wikipedia nei libri di testo).

Esempi di testi che possono essere realizzati già adesso:

s:Dei delitti e delle pene