Apici ‘italiani’

bellisano” post=94418Salve a tutti, sono un nuovo utente e apprezzo quanto di buono viene fatto in questo forum. Ho cercato qualche dritta su alcuni dubbi tipografici, per il momento invano:

1) Esiste un libro che illustri professionalmente le regole tipografiche per scrivere un libro per esempio?

2) Ho realizzato una guida in cui faccio uso del pacchetto lstlisting per riportare del codice di programmazione. Gli apici singoli però vengono rappresentati da LaTeX non come apici verticali (‘) ma come apici orizzontali (`). Scusate la definizione. Come posso risolvere agilmente il problema?

3) Molte guide tecniche sono scritte senza utilizzare il rientro ad inizio paragrafo: cosa ne pensate?

Grazie ancora a tutti

Ciao e benvenuto. Ti rispondo al primo e al terzo quesito.

1. Ce ne sono diversi. Ti consiglio The Elements of Typographic Style di Robert Bringhurst, nella versione 4.0; La forma del libro di Jan Tschichold. Per questioni di ortografia tipografica e stile, va bene Il nuovo manuale di stile di Roberto Lesina.

3. Molti libri anche non tecnici, in realtà, non hanno il rientro a inizio paragrafo. Nel libro di Tshichold c’è un articoletto che spiega perché ogni paragrafo (a eccezione del primo paragrafo dopo un titolo di sezione) deve essere rientrato. La mancanza del rientro è semplicemente un abominio.

2. Per quanto riguarda la questione dell’apice, o premi un tasto sbagliato, oppure prova a impostare diversamente il tuo editor. Sono le prime cose che mi vengono in mente. Risposte arriveranno.

Ciao
Tommaso

Benché io sia affezionato a Roberto Lesina, l’autore del “Nuovo manuale di stile”, che è stato mio allievo molti anni fa, ma è morto prematuramente poco dopo aver scritto al prima edizione del suo manuale di stile, devo dire che quel manuale è in pratica l’unica cosa disponibile sul mercato accessibile a chiunque, ma è datato, molto datato.

Purtroppo i manuali di tipografia adatti a chi scrive per/con il Desk Top Publishing, così come il bellissimo libro di Bringhurst, o quello di Tschichold, si riferiscono quasi sempre a letteratura puramente testuale, non a letteratura tecnica. Qualche umanista potrebbe riprendermi sostenendo che la letteratura tecnica NON è letteratura; ovviamente non sono d’accordo. visto che scrivo tecnico anch’io.

Ecco, prima ancora di studiare tipografia tecnica, che trovi anche descritte in alcune guide che trovi in questo forum {nel senso che pur essendo guide sull’uso di LaTeX, non mancano di consigli e suggerimenti in merito alla scrittura tecnica; inoltre qui nel sito si può trovare da scaricare il manualetto Saper comunicare — Cenni di scrittura tecnico-scientifica) devi dimenticare tutto quello che hai visto composto con i soliti word processor, Word, Writer, comunque si chiamino; essi non realizzano la buona tipografia; essi semplificano solo la composizione dei testi, ma la qualità è sostanzialmente affidato all’esperienza di chi scrive; questo è vero in parte anche per chi usa LaTeX, ma questo permette una composizione tipografica di solito priva degli errori tipografici pacchiani che si vedono nei testi scritti con i word processor.

In sostanza la manualistica scritta con i word processor non è da prendere ad esempio. Ricordane il contento se è valido, ma dimenticane l’aspetto. Dopo apprendi quanta più tipografia puoi, non solo leggendo, ma anche osservando quello che fanno gli esperti, i libri pubblicati dalle migliori case editrici di testi scientifici, affina il gusto e impara a valutare quello che leggi non solo per il contenuto ma anche per come esso è presentato. Scoprirai un mondo che si riferisce ad un’arte totalmente dimenticata dalla cultura “ufficiale”.

bellisano” post=94418
3) Molte guide tecniche sono scritte senza utilizzare il rientro ad inizio paragrafo: cosa ne pensate?

Il citato manuale di stile di Lesina compone tutti i capoversi senza rientro ma…
aggiunge una spaziatura verticale tra capoversi. È un caso limite, lo so.
Ma è solo per dire che la scelta dipende dal tipo di testo. Se ci sono capoversi mediamente molto corti, intervallati da molti esempi o altri elementi paratestuali, come è il caso del Lesina, il rientro è inutile. Di fatto il rientro non serve per ogni paragrafo in sé, ma solo per far vedere che inizia un nuovo paragrafo. Se non ci sono mai, ovvero ci sono molto raramente, due paragrafi consecutivi, il rientro può essere evitato. Nella manualistica non è un caso rarissimo, anche se rimane un caso limite se si parla di testo in generale.

Ciao
Ivan

Se per “paragrafo” intendi “capoverso” (in inglese si chiama paragraph ciò che in italiano si chiama capoverso) il rientro ci sta benissimo, ma io personalmente preferirpreferisco che il primo capoverso di ogni paragrafo non sia rientrato, specialmente quando il rientro è così marcato come nel tuo stile compositivo.È una questione di gusti; non pretendo che i miei gusti siano condivisi.

Invece paragrafi di poche righe, numerati o non numerati non hanno granché senso; quelle poche righe potrebbero essere senzate se quel primo capoverso fosse solo l’intorduzione o la presentazione dei sottoparagrafi che seguono. ((quello che in italiano si chiama paragrafo, in inglese si chiama section; analogamente per i sottoparagrafi e le subsection)

Che lavoro titanico, complimenti 🙂
Occhio agli accenti con le maiuscole: ad esempio a pagina 5 PECULARIETÁ anziché (suppongo) PECULIARITÀ, É anziché È.
Buona fortuna e buon lavoro.
Saluti

Complimenti! 🙂 Io avrei preferito vedere alcuni schemi disegnati con TikZ o PSTRicks, ma resta un ottimo lavoro.

Farei attenzione ad inserire uno spazio fra “con” e “LaTeX” nel frontespizio e ricordati di spezzare i codici a fine riga (tipo pagina 102): c’è anche un bel quadrato nero a ricordartelo 😉

Ciao
Claudio

Per le documentazioni è più adatta la GFDL rispetto alla GPL, poi ovviamente sei libero di scegliere la licenza che più ti aggrada 🙂

A pagina 427, paragrafo “Installazione con Linux” ci sono dei codici in posizioni sballate 😉

alegenn” post=94461Che lavoro titanico, complimenti 🙂
Occhio agli accenti con le maiuscole: ad esempio a pagina 5 PECULARIETÁ anziché (suppongo) PECULIARITÀ, É anziché È.

@bellisano: a questo proposito, come inserisci gli accenti nel sorgente? Con, per esempio, [tt]\’E[/tt] oppure direttamente con [tt]É[/tt]?

bellisano” post=94467Per le lettere accentate maiuscole come la “E” sto usando \’E

Visto che stai scrivendo la guida su GNU/Linux, o almeno così leggo all’inizio della guida, eri al corrente che per inserire le lettere accentate maiuscole basta attivare il caps lock e premere normalmente il tasto della lettera accentata? In questo modo inserisci sempre l’accento giusto ed è di gran lunga più facile rispetto a qualsiasi altro metodo

bellisano” post=94467TikZ o PSTRicks? Cercherò qualcosa anche su questo argomento.

In riferimento allo schema nella prima pagina del capitolo 4, prova a compilare questo codice:`
\documentclass [tikz,border=10pt]{standalone}
\usepackage{tikz}
\usetikzlibrary{calc,positioning}
\definecolor{myred}{rgb}{.647 ,.129 ,.149}

\begin{document}

\begin{tikzpicture}[node distance=1cm and 1cm,
module/.style={rectangle,
rounded corners,
minimum width=2cm,
minimum height=0.75cm,
draw=myred,
thick
}]
\node[module] (con) at (0,0) {Controller};
\node[module, below left=of con](view) {View};
\node[module, below right=of con](model) {Model};

% connections
\begin{scope}[-stealth]
\draw[shorten >=-2pt](con)–(view.north east);
\draw[shorten >=-2pt](con)–(model.north west);
\draw[dashed] ($(model.north west)!0.6!(model.west)$)–($(view.north east)!0.6!(view.east)$);
\draw ($(view.south east)!0.6!(view.east)$)–($(model.south west)!0.6!(model.west)$);
\end{scope}
\draw[dashed](view.north) edge[-stealth,out=90,in=180](con.west);
\end{tikzpicture}

\end{document}
` Per più informazioni su TikZ, trovi nella sezione Documentazione due riferimenti interessanti. Il primo riferimento, fra le Guide per iniziare, è una lettura introduttiva a TikZ. Il secondo, nella sezione delle guide tematiche, è una galleria di esempi.

Ciao
Claudio

Altri due suggerimenti di libri su regole tipografiche da applicare (e su errori da evitare):

Fabrizio Serra, Regole editoriali, tipografiche & redazionali, Pisa-Roma, Istituti Editoriali e Poligrafici Internazionali, 2004

James Felici, The Complete Manual of Typography. A Guide to Setting Perfect Type, Adobe Press, 2003 (un classico in questo genere).

Sono però due guide alla composizione tipografica come tale, che di (La)TeX non parlano.

Cosco il libro di Serra e ne ho già fatto una recensione qui sl forum, non troppo favorevole, a causa dei numerosi errori che contieene; Ho scirtto anche a Serra; mi ha risposto prendendo atto e promettendo che nella prossima edizione non ce ne saranno più.