\documentclass{ithaca}

% Usare 'ithaca_bozza' se non sono installati tutti i pacchetti
% richiesti da 'ithaca'. 
%\documentclass{ithaca_bozza}

% Da inserire a cura della redazione
\NUMERO{0}
\ANNO{2012}


\begin{document}
% In caso di titolo lungo nelle parentesi quadre mettere una versione
% corta del titolo. Altrimenti omettere le parentesi quadre.
\title[Manuale di {\tt ithaca.cls}]{Manuale d'Uso per lo Stile
  \LaTeX~ \texttt{ithaca}.  } 

\dottacitazione{Ho sempre rimpianto di aver interrotto la mia
  educazione in quinta elementare. È piuttosto dura quando ti trovi lì
  nel gran mondo e cerchi di affettare un atteggiamento
  sofisticato. La padrona di casa potrebbe snocciolare teorie di
  Schopenhauer e Kafka. Tu al massimo potresti spingerti alla
  tabellina del sette.}{Attribuita a Groucho Marx}

\serie{Ithaca Manuali}

\author{
\name{Francesco Paparella}
\affiliation{Dipartimento di Matematica \& Fisica ``Ennio De Giorgi''
  - Università del Salento}
}

\ithacamaketitle

\abstract{La classe \texttt{ithaca} implementa lo stile \LaTeX~
  progettato per impaginare gli articoli del giornale di scienza e
  cultura ``\textit{Ithaca: viaggio nella scienza}''.  In questo breve
  manuale sono elencati i nuovi comandi definiti dalla classe e
  vengono dati agli autori degli articoli dei suggerimenti per l'uso.}

La classe \texttt{ithaca} è basata sulla classe \texttt{scrartcl} del
pacchetto Koma-Script e funziona con il programma \texttt{pdflatex}
(chi preferisce usare il più consueto programma \texttt{latex} deve
usare la classe \texttt{ithaca\_bozza}, v.p.\pageref{sec:bozza}). È pensata
per la tipografia di articoli di media lunghezza, disposti su due
colonne, scritti in italiano, corredati opzionalmente da figure,
tabelle, riferimenti bibliografici e riquadri di testo, con in coda
piccole note biografiche sugli autori. Il formato della carta è lo
standard europeo A4. Margini, tipi e dimensioni dei caratteri, formato
delle didascalie, e molti altri parametri sono preimpostati. Gli
autori degli articoli sono pregati di non modificarli. La classe si
presta alla tipografia della matematica in quanto inlude il sistema
\AmS-\LaTeX~ della \textit{American Mathematical Society}.

\section{Titolo, autori, abstract, sezioni}
\ColumnFigure{forest_phase_space}{\label{fig:phase_space}Figura su
  colonna singola impaginata con il comando
  {\tt\textbackslash ColumnFigure\{\}\{\}}. La didascalia
  è posizionata sotto la figura.  
}

La classe \texttt{ithaca} è fondamentalmente una classe \texttt{article}
modificata, perciò l'uso di base è analogo. Per attivarne l'uso è
sufficiente dare come primo comando il seguente:\\
\fbox{\footnotesize\texttt{\textbackslash documentclass\{ithaca\}}}

Il titolo dell'articolo è definito dal comando \texttt{\textbackslash
  title} che accetta un argomento opzionale per definire un titolo
corto che appare a piè di pagina:\\
%\setlength{\fboxsep}{0pt}%
\fbox{\footnotesize\texttt{\textbackslash title[Titolo corto]\{Titolo
    dell'articolo\}}}

L'inserimento degli autori è leggermente diverso dal
solito. All'interno del comando \texttt{\textbackslash author} è
necessario elencare il nome di ciascun autore immediatamente seguito
dalla propria affiliazione, come specificato di seguito:\\
\fbox{
  \hspace{-4pt}\parbox{0.97\columnwidth}{%
    \noindent\footnotesize\texttt{\textbackslash author\{\\
      \hphantom{mm}\textbackslash name\{Primo Nome\}\\
      \hphantom{mm}\textbackslash affiliation\{Affiliazione del Primo Nome\}\\
      \hphantom{mmm}$\vdots$\\
      \hphantom{mm}\textbackslash name\{Ennesimo Nome\}\\
      \hphantom{mm}\textbackslash affiliation\{Affiliazione dell'Ennesimo 
      Nome\}\\
     \}
    }
  }
}
Se l'articolo non ha un autore (p.es. è un editoriale), allora bisogna
omettere \texttt{\textbackslash author} e dare il comando:\\
\fbox{\footnotesize\texttt{\textbackslash noauthor}}

Dopo aver specificato il titolo e l'autore (o gli autori) è necessario
dare il comando:\\
\fbox{\footnotesize\texttt{\textbackslash ithacamaketitle}}

Ad alcuni autori piace inserire in cima al proprio articolo una dotta
citazione di qualche saggio del passato (per esempio, in questo
manualetto cito un Groucho Marx quasi certamente apocrifo). Il comando
per far ciò è il seguente:\\
\fbox{
  \hspace{-4pt}\parbox{0.97\columnwidth}{%
    \noindent\footnotesize\texttt{\textbackslash dottacitazione\{%
      Testo della
    citazione\}\{Nome del Citato\}
    }
  }
}
Il comando è facoltativo ma, se presente, deve comparire prima di
\texttt{\textbackslash ithacamaketitle}.

Un altro comando facoltativo da specificare prima di
\texttt{\textbackslash ithacamaketitle} è il seguente:\\
\fbox{\footnotesize\texttt{\textbackslash serie\{nome della serie\}}}\\
il cui scopo è quello di indicare nel titolo il nome della serie o
rubrica a cui appartiene il pezzo. Questo è un comando ad uso della
redazione. Il tipico articolo non appartiene ad alcuna serie.


La classe \texttt{ithaca} non prevede un esplicito riassunto
dell'articolo (o \textit{abstract}, per dirlo in inglese). Tuttavia è
previsto un primo capoverso introduttivo, tipografato con colori e
caratteri diversi da quelli del testo normale, il cui scopo è di di
fornire rapidamente al lettore un'idea sul contenuto
dell'articolo. Pertanto il comando \texttt{\textbackslash abstract} è
stato mantenuto, e va utilizzato per tipografare il primo capoverso
dell'articolo. La prima lettera di questo capoverso è resa come
\textit{capolettera}. Nel caso il capolettera abbia un apostrofo, si
racchiuda la lettera e l'apostrofo fra parentesi graffe, specificando
una crenatura negativa, come nel seguente codice di esempio:
\fbox{\footnotesize\texttt{\{L\textbackslash kern-15pt'\}}}

\WideFigure{sf}{\label{fig:salt_fingers}Immagine
  a larghezza piena impaginata con il comando {\tt\textbackslash
    WideFigure\{\}\{\}}. La didascalia è posizionata sotto la figura.
}

I comandi \texttt{\textbackslash section}, \texttt{\textbackslash
  subsection}, \texttt{\textbackslash subsubsection} e
\texttt{\textbackslash paragraph} sono omologhi ai comandi con lo
stesso nome nella classe \texttt{article}. Tuttavia non è prevista una
numerazione delle sezioni, perciò essi producono risultati identici a
quelli dei comandi \texttt{\textbackslash section*},
\texttt{\textbackslash subsection*}, \texttt{\textbackslash
  subsubsection*} e \texttt{\textbackslash paragraph*}.

\section{Lingue e caratteri accentati\label{lingue}}
La classe usa il pacchetto \texttt{babel} per la sillabazione in
italiano, che è la lingua preimpostata. Tuttavia, per ottenere dei
risultati corretti, è necessario che le regole di sillabazione della
lingua italiana siano installate nel calcolatore che si usa per
compilare il testo in \LaTeX. Per esempio, su un sistema Linux-Ubuntu
bisogna controllare che sia installato il pacchetto
\texttt{texlive-lang-italian}.  

È possibile scrivere testi anche in inglese, facendoli precedere dal
comando:\\
\fbox{\footnotesize\texttt{\textbackslash selectlanguage\{english\}}}\\
Al termine del testo inglese, il comando:\\
\fbox{\footnotesize\texttt{\textbackslash selectlanguage\{italian\}}}\\
ripristina la sillabazione italiana. Ovviamente è possibile scrivere
un intero articolo in inglese, selezionando fin dall'inizio questa lingua:
\fbox{
   \hspace{-4pt}\parbox{0.97\columnwidth}{%
    \footnotesize\texttt{%
      \textbackslash begin\{document\}\\
      \textbackslash selectlanguage\{english\}\\
      \hphantom{mmm}$\vdots$\\
      {\it text of the paper}\\
      \hphantom{mmm}$\vdots$\\
      \textbackslash end\{document\}
    }
  }
}
Non è previsto, per il momento, l'uso di altre lingue.


% Riquadro, colonna singola  %%%%%%%%%%%
\ocbox{Riquadro Testuale}{ 
  I riquadri testuali sono utili per illustrare singoli concetti,
  fornire definizioni o notizie al di fuori del testo principale
  dell'articolo.
  
  Per esempio, si potrebbe brevemente discutere il significato della
  formula:
  \[P(E)   = \binom{n}{k} p^k (1-p)^{ n-k}. \]
}
%%%%%%%%%%%%%%%%%
Per l'inserimento di lettere accentate e di caratteri speciali la
classe usa la codifica dei caratteri \texttt{UTF-8}. Ciò vuol dire
che, per esempio, non è necessario scrivere
``\textbackslash`a'' per ottenere il carattere
``à'': è sufficiente usare il corrispondente tasto della
tastiera italiana. Tuttavia, affinché tutto funzioni correttamente, è
necessario usare un \textit{editor} di testi che supporti la codifica
\texttt{UTF-8}. Ciò è del tutto standard in ambiente Linux. Anche
versioni recenti di \texttt{TeXnicCenter} (una popolare interfaccia
per \LaTeX~ in ambiente windows) supportano la codifica
\texttt{UTF-8}. È da evitare l'ormai obsoleta codifica
\texttt{latin1}.


\section{Figure e riquadri di testo}

La classe \texttt{ithaca} importa il pacchetto \texttt{graphicx} che
permette l'inclusione di figure in formato \texttt{PDF},
\texttt{JPEG}, \texttt{TIFF}, \texttt{PNG}. Inoltre importa il
pacchetto \texttt{epstopdf} che converte automaticamente le immagini
in formato  \texttt{EPS} in formato \texttt{PDF}.
Salvo il caso di eccezionali esigenze tipografiche, gli autori non
dovrebbero usare direttamente i comandi \LaTeX~ per l'inclusione delle
figure, ma dovrebbero scegliere la più appropriata fra i tre comandi
definiti \textit{ad hoc} da \texttt{ithaca} ed elencati di seguito:
\fbox{
   \hspace{-4pt}\parbox{0.97\columnwidth}{%
    \footnotesize\texttt{%
      \textbackslash ColumnFigure\{NomeFigura\}\{Didascalia\}
      \textbackslash WideFigure\{NomeFigura\}\{Didascalia\}
      \textbackslash WideFigureSideCaption\{NomeFigura\}\{Didascalia\}
    }
  }
}
Il primo impagina la figura su di una colonna singola, con una
didascalia posizionata sotto la figura (figura \ref{fig:phase_space});
il secondo impagina la figura usando entrambe le colonne, con una
didascalia sotto la figura (figura \ref{fig:salt_fingers}); il terzo
anche occupa due colonne, ma la didascalia è posizionata sul fianco
destro della figura (figure \ref{fig:salt_fingers_big}). In tutti e
tre i casi ``\texttt{NomeFigura}'' è il nome del \textit{file} che
contiene l'immagine, senza l'estensione \texttt{.pdf}, \texttt{.eps},
etc.; ``\texttt{Didascalia}'' è un breve
testo esplicativo, nel quale può essere incluso il comando:\\
\fbox{\footnotesize\texttt{\textbackslash label\{identificativo\}}}\\
in modo da poter citare la figura nel testo con l'usuale comando:\\
\fbox{\footnotesize\texttt{\textbackslash ref\{identificativo\}}}

È anche possibile definire dei riquadri di testo utili per fornire
notizie sintetiche, definire concetti e discutere notizie accessorie
al di fuori del testo principale dell'articolo. Essi sono definiti dai
comandi \texttt{ad hoc}:
\fbox{
   \hspace{-4pt}\parbox{0.97\columnwidth}{%
    \footnotesize\texttt{%
      \textbackslash ColumnFigure\{NomeFigura\}\{Didascalia\}
      \textbackslash WideFigure\{NomeFigura\}\{Didascalia\}
      \textbackslash WideFigureSideCaption\{NomeFigura\}\{Didascalia\}
    }
  }
}

I comandi per l'inserimento delle figure rispettano le proporzioni
predefinite nelle immagini, ovvero non dilatano né comprimono
l'altezza rispetto alla larghezza. I comandi per i riquadri di testo
non consentono l'uso di tutte le opzioni previste per le
minipagine. Tutti questi comandi omettono gli usuali controlli
opzionali per il posizionamento delle strutture flottanti. Salvo
esigenze del tutto eccezionali (da concordare con la redazione) si
sconsiglia di modificare queste impostazioni predefinite. Per
deformare o ritoccare le immagini è consigliabile usare un programma
di fotoritocco. Un certo margine di controllo sul posizionamento delle
strutture flottanti può essere recuperato variando la posizione nel
testo in cui appare il comando che definisce una di queste strutture.

% Riquadro testuale, doppia colonna %%%%%%%%%%%
\tcbox{Riquadro Testuale a Doppia Colonna}{
Alcuni concetti non possono essere spiegati nel ristretto spazio di
una colonna singola. Pertanto sono previsti riquadri testuali che si
estendono su entrambe le colonne della pagina!
\begin{equation}
\label{eq:Maxwell}
\tag{2}
\begin{aligned}
  \nabla \times \vec{\mathbf{B}} -\, \frac1c\, \frac{\partial\vec{\mathbf{E}}}{\partial t} & = \frac{4\pi}{c}\vec{\mathbf{j}} \\   
  \nabla \cdot \vec{\mathbf{E}} & = 4 \pi \rho \\
  \nabla \times \vec{\mathbf{E}}\, +\, \frac1c\, \frac{\partial\vec{\mathbf{B}}}{\partial t} & = \vec{\mathbf{0}} \\
  \nabla \cdot \vec{\mathbf{B}} & = 0 
\end{aligned}
\end{equation}

I riquadri di testo non sono altro che minipagine leggermente
modificate inglobate in una struttura flottante. Pertanto esse possono
contenere tutte le normali strutture tipografiche del \LaTeX, quali
formule, tabelle, ed anche altre minipagine.
}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%


\section{Matematica}

La classe \texttt{ithaca} importa il sistema \AmS-\LaTeX, ovvero i
pacchetti per la tipografia della matematica \texttt{amsmath},
\texttt{amsfonts}, \texttt{amsthm}. È quindi possibile tipografare in
modo elegante anche formule complesse quali il sistema
(\ref{eq:Maxwell}) o formule lunghe quali la seguente:
\begin{equation} 
\begin{split}
\label{eq:RR}
1 + \frac{q^2}{(1-q)}+\frac{q^6}{(1-q)(1-q^2)}+\cdots = \\
\prod_{j=0}^{\infty}\frac{1}{(1-q^{5j+2})(1-q^{5j+3})}, \quad\quad
\text{for $|q|<1$}.
\end{split}
\end{equation} 
Si noti che l'uso dell'ambiente \texttt{\textbackslash
  begin\{split\}~$\cdots$\textbackslash
  end\{split\}} ha permesso una resa tipografica accetabile anche
all'interno di una colonna relativamente stretta.

Per una documentazione completa si
faccia riferimento direttamente al sito della American Mathematical
Society: \url{http://www.ams.org/publications/authors/tex/tex}.


\section{Bibliografia}

È consigliabile, sebbene non obbligatorio, corredare un articolo con
una breve bibliografia che permetta ad un lettore non specialista di
approfondire gli argomenti discussi.  

Per garantire un minimo di uniformità nello stile, sono stati definiti
dei nuovi comandi per la citazione di articoli e libri, inoltre si
consigli fortemente di usare il comando \texttt{\textbackslash url}
per citare gli indirizzi di siti \textit{web}.\\
\fbox{
   \hspace{-4pt}\parbox{0.97\columnwidth}{%
    \footnotesize\texttt{%
      \textbackslash begin\{thebibliography\}\{9\}\\
      ~\\
      \textbackslash bibitem\{chiave1\}%
      \textbackslash refer\{Autori\}\{Titolo\}\\
      \hphantom{mmm}\{Rivista,\}\{Volume\}\{Anno\}\{Pagine\}\\
      ~\\
      \textbackslash bibitem\{chiave2\}%
      \textbackslash referbook\{Autori\}\{Titolo\}\\
      \hphantom{mmm}\{Editore\}\{Anno\}\\
      ~\\
      \textbackslash bibitem\{chiave3\}%
      \textbackslash url\{www.nomesito.edu/cartella\}\\
%      ~\\
      \hphantom{mmm}$\vdots$\\
%      ~\\
      \textbackslash end\{thebibliography\}
    }
  }
}

Qualora l'articolo non fosse corredato da una bibliografia, è
opportuno inserire il seguente comando, al termine del testo vero e
proprio e prima delle note biografiche:\\
\fbox{\footnotesize\texttt{\textbackslash nobibliography}}


\section{Note biografiche}

La redazione della rivista trova utile che gli autori degli articoli
indichino una brevissima nota che specifichi i propri interessi
scientifici, le posizioni accademiche occupata attualmente o in
passato, etc.

A tale scopo è stato predisposto il seguente comando:\\
\fbox{\footnotesize\texttt{\textbackslash AuthorsBio\{nome\}\{testo
    della nota\}}}\\
dove \texttt{nome} è il nome di un autore, così come appare nel
comando \texttt{\textbackslash name} nell'elenco degli autori del
titolo, e \texttt{testo della nota} è lungo non più di quattro o
cinque righe. Il comando va ripetuto per ciascun autore, in coda alla
bibliografia.


\section{Testo Bilingue}

La classe \texttt{ithaca.cls} permette di impaginare testi bilingue
(italiano ed inglese) su colonne affiancate. A tale scopo è necessario
usare l'apposita opzione \texttt{ItaEng} quando si specifica la classe
del documento:\\
\fbox{\footnotesize\texttt{\textbackslash
    documentclass[ItaEng]\{ithaca\}}}.

Questa opzione rende disponibile un nuovo ambiente (\texttt{sinossi})
e due nuovi comandi (\texttt{\textbackslash Ita} e
\texttt{\textbackslash Eng}) da usarsi secondo il seguente schema:\\
\fbox{
   \hspace{-4pt}\parbox{0.97\columnwidth}{%
    \footnotesize\texttt{%
      \textbackslash begin\{sinossi\}\\
      \hphantom{mm}\textbackslash Ita\{\\
      \hphantom{mmmm}{\it Testo in italiano. Qui le regole di}\\
      \hphantom{mmmm}{\it sillabazione sono quelle della lingua}\\
      \hphantom{mmmm}{\it italiana.}\\
      \hphantom{mm}\}\\%
      \hphantom{mm}\textbackslash Eng\{\\
      \hphantom{mmmm}{\it English text. Here hyphenation rules are}\\
      \hphantom{mmmm}{\it those of the English languague.}\\
      \hphantom{mm}\}\\
      \textbackslash end\{sinossi\}
    }
  }
}

Per mantenere in sincrono il testo fra le due colonne, si sconsiglia di
usare un solo ambiente \texttt{sinossi} che racchiude l'intero testo,
ma di usare un ambiente \texttt{sinossi} per ciascuna sezione, o anche
più spesso, se necessario.

Con l'opzione \texttt{ItaEng}, eventuale testo al di fuori degli
ambienti \texttt{sinossi} non è tipografato su doppia colonna, ma su
linee a pagina intera, seguendo le regole di sillabazione della lingua
italiana.



\section{Modalità bozza\label{sec:bozza}}

La classe \texttt{ithaca} utilizza molti pacchetti \LaTeX~ per
tipografare gli articoli. Alcuni di essi non sono di uso comune (in
particolare i quelli che gestiscono i tipi di carattere ed i colori) e
potrebbero essere assenti nell'installazione \LaTeX~ sul calcolatore
degli autori. Inoltre \texttt{ithaca} richiede l'uso del programma
\texttt{pdflatex} e non funziona col più comune \texttt{latex}.

\WideFigureSideCaption{sfbig}{\label{fig:salt_fingers_big}Se una
  figura ha un rapporto d'aspetto quasi quadrato, ma non è opportuno
  rimpicciolirla fino alle dimensioni della larghezza di una colonna,
  allora si può usare il comando
  {\tt\textbackslash WideFigureSideCaption\{\}\{\}} che tipografa la
  didascalia a fianco della figura.}

Per permettere la composizione di articoli per la nostra rivista anche
con installazioni \LaTeX~ non particolarmente esuberanti, è stata
predisposta una versione parallela della classe \texttt{ithaca},
denominata \texttt{ithaca\_bozza}. Essa introduce tutti i nuovi comandi di
\texttt{ithaca}, ma ha una resa tipografica meno elaborata, in modo da
evitare l'utilizzo dei pacchetti poco comuni. Inoltre
\texttt{ithaca\_bozza} funziona col programma \texttt{latex}, e produce un
\textit{file} \texttt{.dvi} (anziché direttamente un \textit{file}
\texttt{.pdf})

Per usare \texttt{ithaca\_bozza} è sufficiente sostituire il comando:\\ 
\fbox{\footnotesize\texttt{\textbackslash documentclass\{ithaca\}}}\\
con:\\
\fbox{\footnotesize\texttt{\textbackslash documentclass\{ithaca\_bozza\}}}

È ovviamente possibile compilare il sorgente di questo manualetto con
la classe bozza, ma (attenzione!) si perderanno tutte le lettere
accentate in quanto la modalità bozza non permette l'uso di un insieme
esteso di caratteri (gli accenti vanno tipografati con gli appositi
comandi \LaTeX, come discusso nella sezione ``Lingue e caratteri
accentati'' a p.\pageref{lingue}). Qualora si volesse usare la
modalità bozza ed anche un insieme esteso di caratteri (inclusi i
caratteri accentati), possono essere inclusi i seguenti comandi nel
preambolo del documento:\\
\fbox{ \hspace{-4pt}\parbox{0.97\columnwidth}{%
    \footnotesize\texttt{%
      \textbackslash usepackage[T1]\{fontenc\}\\
      \textbackslash usepackage[utf8]\{inputenc\} } } }

Infine, in modalità bozza non è possibile tipografare un testo
bilingue su colonne affiancate: l'opzione \texttt{ItaEng} non è
disponibile.


\section{Problemi noti}
Le formule nei riquadri testuali sono numerate prima delle formule che
appaiono nel testo principale, anche quando il riquadro è impaginato
dopo la formula nel testo. Un modo per aggirare il problema è numerare
manualmente le formule che appaiono nei riquadri di testo con il
comando:\\
\fbox{\footnotesize\texttt{\textbackslash tag\{nn\}}}\\
dove \texttt{nn} è il numero che si desidera attribuire alla formula.

% Il seguente non crea davvero una nuova pagina, ma una nuova colonna.
%\newpage
% \begin{thebibliography}{9}
% \bibitem{chiave1} \refer{George W. Hart}{Mathematically Correct
%     Breakfast: How to Slice a Bagel into Two Linked Halves}{Annals of
%     Improbable Research}{16}{2010}{16-17}

% \bibitem{chiave2} \referbook{Marc Abrahams}{The Best of Annals of
%     Improbable Research}{W. H. Freeman}{1997}

% \bibitem{chiave3} Un classico della scienza improbabile:
%   \url{http://www.improbable.com/airchives/classical/articles/peanut_butter_rotation.html}
% \end{thebibliography}

\nobibliography

\AuthorsBio{Francesco Paparella}{È un ricercatore in fisica matematica
  presso l'Università del Salento. Si occupa di meccanica dei fluidi
  (applicata alla geofisica) e di sistemi dinamici (applicati alla
  meccanica dei fluidi ed all'ecologia). Sta tentando di imparare i
  segreti del \LaTeX.}

\end{document}