Progetto:Trascrizioni/Progetto Auto/Backup1

Progetto Auto

Il progetto Auto si propone di automatizzare, fin dove possibile, la creazione di tutte le pagine della versione testuale di un'opera, sia che sia introdotta con il sistema tradizionale "non proofread", ossia senza versione con testo a fronte, sia che sia introdotta con il metodo proofread; lo scopo è quello di razionalizzare l'introduzione dei dati (evitando ogni violazione del pricipio della coerenza, ossia evitando di introdurre più volte lo stesso dato, esponendosi a inevitabili errori) e di facilitare a tutti gli utenti, anche a quelli meno esperti, la procedura manuale, che peraltro resta praticabile integralmente per chi volesse intraprenderla.

Vi prego di annotare qui sotto il vostro nome utente se siete interessati a seguire gli sviluppi:

1. Alex brollo

Gli strumenti

Per ora, la creazione del codice necessario alle varie pagine sarà ottenuta con un foglio Excel, pubblicato su Google Docs come file pubblico all'indirizzo: Google Doc pubblico

Il file potrà essere utilizzato online o scaricato e utilizzato localmente. Produrrà il codice completo delle varie pagine necessarie e il nome delle pagine da creare a supporto dei meccanismi di automazione.

Il codice prodotto potrà essere copiaincollato all'interno della pagina creata, o ricopiato su un elaboratore di testi per eventuali piccole modifiche prima di essere copiaincollato come codice della pagina.

Aggiornamento: da ieri 11.01.09 una versione preliminare del file sta producendo i risultati sperati; il codice è stato utilizzato nel'opera sperimentale Lettere autografe di Cristoforo Colombo, proposto da Aubrey.

La logica dell'automazione

La possibilità di un'automazione nasce dall'osservazione che rendendo accessibili e utilizzabili di dati ricorrenti dell'opera, ossia:

1. i dati compresi nell'intestazione
2. i dati compresi nell'infotesto
3. i dati specifici dei vari capitoli:
   1. titolo del capitolo per esteso
   2. titolo del capitolo abbreviato
   3. link alla pagina/sottopagina testuale
   4. eventuale elenco delle pagine da transcludere per le opere proofread

allora la differenza fra il codice di un capitolo e di quello successivo si riduce alla differenza nel numero d'ordine dei capitoli.

Ad esempio, il codice del secondo elemento di Lettere autografe edite e inedite di Cristoforo Colombo, denominato Proemio, è:

{{Lettere autografe Colombo/Auto|2|{{#section:Template:Lettere autografe Colombo/Pagine|2}}|}}

Logicamente l'elemento 3 della stessa opera ha un codice che differisce solo nel numero d'ordine:

{{Lettere autografe Colombo/Auto|3|{{#section:Template:Lettere autografe Colombo/Pagine|3}}}}

Lo schema di una pagina testuale tipica e la sua trasformazione

Una pagina tipica di un'opera transclusa, suddivisa nei suoi quattro elementi:

{{Intestazione
    | Nome e cognome dell'autore =Claudio Corte
    | Titolo =Il cavallarizzo
    | Iniziale del titolo =C
    | Nome della pagina principale =Il cavallarizzo
    | Eventuale titolo della sezione o del capitolo = Libro 1, Capitolo 1
    | Anno di pubblicazione =1562
    | Eventuale secondo anno di pubblicazione =
    | Secolo di pubblicazione =XVI
    | Il testo è una traduzione? =no
    | Lingua originale del testo =
    | Nome e cognome del traduttore =
    | Anno di traduzione =
    | Secolo di traduzione =
    | Abbiamo la versione cartacea a fronte? =si
    | URL della versione cartacea a fronte =http://it.wikisource.org/wiki/Indice:Il_cavallarizzo
    }} 

{{capitolo 
|CapitoloPrecedente=Indice
|NomePaginaCapitoloPrecedente=Il cavallarizzo/Indice
|CapitoloSuccessivo=Cap. 2
|NomePaginaCapitoloSuccessivo=Il cavallarizzo/Libro 1/Capitolo 2
}}

{{Pagina|Il cavallarizzo.djvu/22}}
{{Pagina|Il cavallarizzo.djvu/23}}

{{capitolo 
|CapitoloPrecedente=Indice
|NomePaginaCapitoloPrecedente=Il cavallarizzo/Indice
|CapitoloSuccessivo=Cap. 2
|NomePaginaCapitoloSuccessivo=Il cavallarizzo/Libro 1/Capitolo 2
}}

Nell'ordine compaiono:

1. un template Intestazione, uguale per tutte le pagine meno che per l'elemento Eventuale titolo della sezione o del capitolo;
2. un template Capitolo che crea la barra di navigazione superiore, contenente quattro elementi diversi da capitolo a capitolo che puntano al capitolo precedente e al successivo:
3. uno spazio per il contenuto testuale del capitolo, consistente nel testo vero e proprio (opere non proofread) o nell'elenco dei template Pagina che puntano alla versione con testo a fronte;
4. una seconda copia identica alla prima del template Capitolo, che crea una seconda barra di navigazione inferiore.

Ognuno dei tre elementi (uno ripetuto due volte) è automatizzato con la creazione di un piccolo numero di template di servizio specifici dell'opera, con un approccio "modulare" in quanto a uno qualsiasi degli elementi "tipo tradizionale" può essere sostituito un elemento "di nuovo tipo"; un ultimo template consente di richiamare i vari elementi automatizzati tutti insieme.

Useremo per gli esempi il caso di Lettere autografe di Cristoforo Colombo su cui si sta svolgendo oggi 12.01.09 la sperimentazione più avanzata.

Tutti i template necessari sono creati come sottopagine di un template Template:NomeOpera. NomeOpera non è necessariamente il nome della pagina testuale (anche se sarebbe opportuno). Nel caso Colombo, il template:NomeOpera è Template:Lettere autografe Colombo, al momento inesistente (esistono però le sue sottopagine).

Il Template Indice

Il cuore dell'automazione è il Template:NomeOpera/Indice; nel nostro esempio: Template:Lettere autografe Colombo/Indice. In questo template, sono elencati, una riga per "capitolo", tre dati: il nome breve del capitolo, come comparirà nella barra di navigazione; il nome completo del capitolo, come comparirà nell'intestazione del capitolo; il link al capitolo. Ogni elemento di ogni riga costituisce una section; le section hanno, per nome, qualcosa del genere: numero riga.numero colonna, quindi il secondo dato (nome breve capitolo) del sesto elemento di Colombo, ossia quello contenuto nella section di nome 6.2, è recuperabile dovunque, su it.wikisource, con il seguente codice di transclusione di una section:

{{#section:Template:Lettere autografe Colombo/Indice/6.2}}

che restituisce: {{#section:Template:Lettere autografe Colombo/Indice|6.2}}, che è il nome breve del sesto elemento di Colombo.

Il Template Navbar

Creato il template Indice, si dispone di tutti gli elementi per costruire automaticamente un template che crea la barra di navigazione di qualsiasi capitolo; si dispone infatti del nome breve e del link al capitolo precedente e successivo. Tale template è il Template:Lettere autografe Colombo/Navbar. Il codice:

{{Lettere autografe Colombo/Navbar|6}}

produce questo risultato:{{Lettere autografe Colombo/Navbar|6}} perchè il capitolo precedente a {{#section:Template:Lettere autografe Colombo/Indice|6.2}}, l'elemento 6, è il 5, "Altre lettere", e il successivo è il 7, "All'ambasciatore".

Questo codice produce esattamente lo stesso risultato del template Capitolo opportunamente compilato:

{{capitolo 
|CapitoloPrecedente=Altre lettere
|NomePaginaCapitoloPrecedente=Lettere autografe di Cristoforo Colombo/Altre lettere
|CapitoloSuccessivo=All'ambasciatore
|NomePaginaCapitoloSuccessivo=Lettere autografe di Cristoforo Colombo/All'ambasciatore
}}

che produce:

◄

Altre lettere

All'ambasciatore

►

ma con due grandissimi vantaggi:

1. per compilare il codice semplificato, non occorre comnoscere nè il nome, nè il link del capitolo successivo;
2. in caso di errore o di ridenominazione di un elemento qualsiasi della pagina principale o del capitolo, non servirà rintracciare uno per uno i templates multipli in cui è stato scritto il codice da modificare, ma basterà modificare il Template Indice (potenza della "riduzione della ridondanza") e non si commetteranno errori per dimenticanza o correzione errata di uno o l'altro delgi elementi (potenza dell' "aumento della coerenza").

Il template Schema

Il template Schema di Colombo ha il seguente contenuto:

<includeonly>{{Intestazione letteratura
    | Nome e cognome dell'autore =Cristoforo Colombo
    | Titolo =Lettere autografe di Cristoforo Colombo
    | Iniziale del titolo =C
    | Nome della pagina principale =Lettere autografe di Cristoforo Colombo
    | Eventuale titolo della sezione o del capitolo = {{#lst:Template:Lettere autografe Colombo/Indice|{{{1|2}}}.1}}
    | Anno di pubblicazione =1863
    | Eventuale secondo anno di pubblicazione =
    | Secolo di pubblicazione =XIX secolo
    | Il testo è una traduzione? =no
    | Lingua originale del testo =
    | Nome e cognome del traduttore =
    | Anno di traduzione =
    | Secolo di traduzione =
    | Abbiamo la versione cartacea a fronte? = si
    | URL della versione cartacea a fronte = http://it.wikisource.org/wiki/Indice:Lettere autografe Colombo.djvu
    }}</includeonly>

Come si vede, il codice è quasi identico al testo che si aggiunge alle varie pagine per richiamare il Template Intestazione. C'è una sola differemza alla voce Eventuale titolo della sezione o del capitolo, dove appare un codice di transcusione che punta sui dati del template Indice, e precisamente sul nome per esteso del capitolo.

Il seguente codice:

{{Lettere autografe Colombo/Schema|4}}

equivale quindi, in tutto e per tutto, al seguente codice:

{{Intestazione letteratura
    | Nome e cognome dell'autore =Cristoforo Colombo
    | Titolo =Lettere autografe di Cristoforo Colombo
    | Iniziale del titolo =C
    | Nome della pagina principale =Lettere autografe di Cristoforo Colombo
    | Eventuale titolo della sezione o del capitolo = Lettera di Cristoforo Colombo a Rafaele Saxis
    | Anno di pubblicazione =1863
    | Eventuale secondo anno di pubblicazione =
    | Secolo di pubblicazione =XIX secolo
    | Il testo è una traduzione? =no
    | Lingua originale del testo =
    | Nome e cognome del traduttore =
    | Anno di traduzione =
    | Secolo di traduzione =
    | Abbiamo la versione cartacea a fronte? = si
    | URL della versione cartacea a fronte = http://it.wikisource.org/wiki/Indice:Lettere autografe Colombo.djvu
    }}

ma è molto più leggero ed ha gli stessi vantaggi discussi per il template Navbar connessi alla riduzione della ridondanza/aumento della coerenza. Qualsiasi modifica, fatta al template Schema, si ripercuote su tutte le sottopagine dov'è invocato, appena la pagina viene sottoposta a refresh.

Mettere i pezzi insieme

Sostituendo il codice "tradizionale" con il "nuovo codice", qualsiasi elemento di Colombo (ipotizziamo, l'elemento 5) può essere scritta in questa forma:

{{Lettere autografe Colombo/Schema|5}}

{{Lettere autografe Colombo/Navbar|5}}

(qui il testo o l'elenco dei template Pagina)

{{Lettere autografe Colombo/Navbar|5}}

ma essendo ognuno dei template equivalente alla sua forma "estesa", niente impedisce di mescolare "vecchi elementi" con "elementi nuovi". In questo senso il nuovo approccio è "modulare".

Ma osservate che il numero 5 è ripetuto per ben tre volte.... il template Auto non fa che mettere insieme i tre template Schema, Navbar, Navbar richiamandoli con un unico parametro, accettando il testo o l'elenco dei template Pagina come secondo parametro.

Il codice dell'elemento 2 di Colombo di riduce quindi a:

{{Lettere autografe Colombo/Auto|2|{{Pagina|Lettere autografe Colombo.djvu/7}}
{{Pagina|Lettere autografe Colombo.djvu/8}}
{{Pagina|Lettere autografe Colombo.djvu/9}}
{{Pagina|Lettere autografe Colombo.djvu/10}}
{{Pagina|Lettere autografe Colombo.djvu/11}}
{{Pagina|Lettere autografe Colombo.djvu/12}}
{{Pagina|Lettere autografe Colombo.djvu/13}}
{{Pagina|Lettere autografe Colombo.djvu/14}}
{{Pagina|Lettere autografe Colombo.djvu/15}}
{{Pagina|Lettere autografe Colombo.djvu/16}}
{{Pagina|Lettere autografe Colombo.djvu/17}}
{{Pagina|Lettere autografe Colombo.djvu/18}}
{{Pagina|Lettere autografe Colombo.djvu/19}}
{{Pagina|Lettere autografe Colombo.djvu/20}}
}}

L'ultimo passo

Volendo si può semplificare ancora! Infatti nel template Pagine l'elenco completo dei template Pagina è suddiviso in section, numerate progressivamente 1,2... e quindi il codice:

{{#section:Template:Lettere autografe Colombo/Pagine|2}}

equivale all'elenco dei template Pagina relativi all'elemento 2 del testo.

Quindi il codice della pagina, come potete controllare qui: Lettere autografe di Cristoforo Colombo/Proemio, si riduce a:

{{Lettere autografe Colombo/Auto|2|{{#section:Template:Lettere autografe Colombo/Pagine|2}}
}}

Opere in corso su cui si stanno svolgendo sperimentazioni

• Indice:Lettere autografe Colombo.djvu e corrispondente v. testuale Lettere autografe edite ed inedite di Cristoforo Colombo, con Aubrey
• Fiore di virtù, con Snark
• Indice:Olanda.djvu e Olanda, con OrbiliusMagister

Discussione in corso su en.source

E' appena stata aperta una discussione sull'argomento su en.source; il sistema di automazione, con le opportune modifiche, è stato implementato su The Modern Art of Taming Wild Horses, dopo un cenno di interesse di Utente:Jayvdb.

[continua]