CDP Bundle & documentazione

IL_MAGO_GANDALF” post=99889Ho letto il post che riguarda la nuova versione della classe letterCDP.
Non riesco invece a reperire la “corposa” documentazione tra cui NOVITA34.pdf NT..pdf etc etc.
E’ presente nel mirror con la nuova versione,si genera dal dtx, oppure può soltanto essere fornita dall’autore della classe medesima su richiesta?
Un saluto ed un grazie a tutti voi
A.

Sul CTAN non c’è, né ci può stare, alcuna documentazione in italiano. Poiché i documenti che citi tu sono per l’appunto in italiano, per essi vale, temo, l’ultima che hai detto.:)

—
Gustavo

letteracdp” post=99906Sul CTAN non c’è, né ci può stare, alcuna documentazione in italiano.

Questo è assolutamente falso. Tanto per citarne uno, fancyhdr, ha la documentazione scritta in diverse lingue, tra cui l’italiano. Moltissimi pacchetti hanno la documentazione anche in italiano e, tanto per andare oltre il confine e prendere un caso limite, esistono un sacco di pacchetti che hanno solo la documentazione in francese.

Quindi, il fatto di scrivere anche la documentazione in italiano dipende solo dall’autore.

Ciao
Claudio

letteracdp” post=99906Sul CTAN non c’è, né ci può stare, alcuna documentazione in italiano. Poiché i documenti che citi tu sono per l’appunto in italiano, per essi vale, temo, l’ultima che hai detto.:)

Mi permetto di dissentire: le documentazioni dei pacchetti frontespizio e layaureo, tanto per fare due esempi, sono nell’italico idioma 🙂

Detto questo, vorrei riassumere qui per tutti il grande lavoro che Gustavo ha fatto per noi.

Su CTAN è presente la versione 0.36 del C.D.P. Bundle. I file di documentazione in esso presenti sono questi:

1. [tt]cdp-ver-0-36.pdf[/tt]

2. [tt]cdpbundl-doc.pdf[/tt]

Nel messaggio #99842, Gustavo ha tentato di allegare i seguenti file:

1. [tt]esempi.pdf[/tt]

2. [tt]novita34.pdf[/tt]

3. [tt]nts2.pdf[/tt]

4. [tt]aq2.pdf[/tt]

5. [tt]rfc.pdf[/tt]

Essi costituiscono la documentazione originaria della classe, destinata ai dottorandi di Padova, ritoccata in qualche punto. Questi file sono disponibili richiedendoli direttamente a Gustavo. Ma credo che non sarebbe male aggiungerli al bundle: si dovrebbe poter fare e ti risparmierebbe un bel po’ di email a cui rispondere 🙂

Nel messaggio #99886, Gustavo allega quattro file che contengono esempi pratici per personalizzare facilmente una propria carta intestata:

1. [tt]FrankTest.tex[/tt]

2. [tt]frankletter.cls[/tt]

3. [tt]frankarticletter.cls[/tt]

4. [tt]franklogo.def[/tt]

Direi che Gustavo ha fatto un bel lavoro 🙂

Grazie e ciao
Tommaso

IL_MAGO_GANDALF” post=99909Grazie mille per la risposta.
Troverà allora la mia mail…(di stamattina) […]

Proprio riguardo a quella, stavo per risponderti che è meglio che le domande vengano rivolte tramite un forum come questo, e non privatamente, in modo che la risposta possa servire anche ad altri che hanno un problema simile.

Adesso non ricordo e mi è scomodo leggere la posta, ma mi sembra che nel codice che mi hai mandato manchi la definizione di una delle macro che usi… Prova a controllare.

Ciao

—
Gustavo

cfiandra” post=99910

Sul CTAN non c’è, né ci può stare, alcuna documentazione in italiano.

Questo è assolutamente falso. Tanto per citarne uno, fancyhdr, ha la documentazione scritta in diverse lingue, tra cui l’italiano. Moltissimi pacchetti hanno la documentazione anche in italiano e, tanto per andare oltre il confine e prendere un caso limite, esistono un sacco di pacchetti che hanno solo la documentazione in francese.

Quindi, il fatto di scrivere anche la documentazione in italiano dipende solo dall’autore.

Ciao
Claudio

Il problema nasce, per l’appunto, quando la documentazione è solo in una lingua che non sia l’inglese. Non so, io mi sono sempre fatto scrupolo di non fare, appunto, il “francese” e non ho mai osato proporre al CTAN la documentazione in italiano (però hai ben osato proporre letteracdp, direte voi!), ma se davvero pensate che potrei, be’…:)

Ciao.

—
Gustavo

illinguista1972″ post=99911[…] Nel messaggio #99842, Gustavo ha tentato di allegare i seguenti file:

1. [tt]esempi.pdf[/tt]

2. [tt]novita34.pdf[/tt]

3. [tt]nts2.pdf[/tt]

4. [tt]aq2.pdf[/tt]

5. [tt]rfc.pdf[/tt]

Essi costituiscono la documentazione originaria della classe, destinata ai dottorandi di Padova, ritoccata in qualche punto. Questi file sono disponibili richiedendoli direttamente a Gustavo. Ma credo che non sarebbe male aggiungerli al bundle: si dovrebbe poter fare e ti risparmierebbe un bel po’ di email a cui rispondere 🙂 […]

Sentite, si potrbbe fare così: nei prossimi giorni provo a scrivere ai responsabili del CTAN e a sentire il loro parere. Non procedo senza un permesso esplicito da parte loro.

Ciao.

—
Gustavo

Gustavo, ti anticipo.
Io ho caricato su CTAN molta roba, anche scritta in greco, se è per quello (non tutta in greco, ma…)
Esempio: il pacchetto toptesi contiene la documentazione in inglese toptesi,pdf e la documentazione in itlaiano toptesi-it-xetex.pdf
Esempio: la documentazione di teubner contiene la documentazione in inglese teubner.pdf e altra documentazione in inglese teubner-doc.pdf. In entrambi i casi il primo file è la documentazione del codice con qualche informazione per l’uso del pacchetto; il secondo file in entrambi i casi è un manuale d’uso.Nel caso di teubner, visto che serve agli ellenisti, ci sono un mucchio di esempi direttamente scritti in greco classico, anche se il grosso del testo è in inglese, visto che gli ellenisti sono sparsi per il mondo; ho avuto richieste di correzioni persino dalla Cina.

In ogni caso il tema di CTAN che gestisce gli upload richiede uno o più file dtx con gli eventuali file ins per le parti di codice (io li creo sempre auto-estraenti, quindi non metto mai i file ins). Essi richiedono il file README e il file manifest.txt; se ci osno altri documenti vogliono la versione pdf e il corrispondente file sorgente che i lettori possono consultare e vedere come si sono fatte certe cose. Se guardi nel ramo texlive/2014/texmf-dist/doc/ troverai tutte le cartelle con le documentazioni e molte contengono sorgenti e risultati di “esempi svolti”.

Le istruzioni più estese,ma forse leggermente sibilline in qualche punto, sono proprio nella pagina di upload di CTAN.

Ho letto, naturalmente, le istruzioni per l’upload. Nel 2002, quando feci il primo del C.D.P. Bundle, mi sembrò del tutto ovvio che includere i documenti in italiano scritti per i dottorandi di Padova fosse completamente fuori luogo, anche per il loro tono assai frivolo. Questo pensiero, come a volte accade, si cristallizzò nella mia mente e, fino a oggi, l’ho sempre considerato un assunto indiscutibile. Oggi, per la prima volta dopo tredici anni, improvvisamente il messaggio di Tommaso mi ha fatto dire «ma, in fondo, perché no?», e in effetti, come dici, ci sono tanti altri casi. Però, da un lato mi sembra poco garbato mettere istruzioni che siano solo in inglese italiano, dall’altro adesso non ho assolutamente tempo per mettermi a tradurre circa duecento pagine, oltretutto contenenti non pochi lazzi.:oops:

Buona serata.

—
Gustavo