rodimus

Il mio problema è stato risolto. Da qui in poi si tratta solo di chicche.

Nessuna obiezione sostanziale eccetto che forse, invece di una sezione per esercizio, andrebbe meglio un ambiente, che potrebbe chiamare \clearpage alla fine (se si vuole lasciare spazio) oppure niente se si vogliono stampare tutti gli esercizi uno in fila all’altro.

Molto bene. E allora in stampa.sty elimino le righe
`\setcounter{tocdepth}{0}
\setcounter{secnumdepth}{0}`
che non servono più a nulla, ed elimino pure la ridefinizione di \section. Al suo posto introduco l’ambiente “esercizio”, che definisco nel seguente modo (perdonatemi la sintassi, mi sa che è il primo ambiente che scrivo da zero):
`\newenvironment{esercizio}[1]{% L'ambiente prende un parametro: il titolo
% dell'esercizio.
\noindent% L'ambiente non e` preceduto da alcuna
% indentazione.
\normalfont% I caratteri sono scritti normalmente, in
% romano.
\normalsize% I caratteri hanno un corpo normale.
{\bfseries#1}% *Solo* il primo argomento (il titolo) e` in
% grassetto.
\hspace{.575em}% Vi e` una distanza orizzontale che separa il
% titolo dal resto della consegna.
}
{%
\clearpage% Alla fine dell'esercizio vi e` un salto pagina.
}`
L’ambiente verrà poi utilizzato nel file LaTeX come illustrato di seguito:
`\begin{esercizio}{Esercizio 14 del 21 luglio 2000}
L'esercizio richiede di bla, bla, bla\dots
\end{esercizio}`
Cerco di spiegare alla buona cosa ho fatto: nella versione per la stampa, mi faceva piacere che l’ambiente per l’esercizio fosse uguale a \paragraph; guardo quindi la definizione di \paragraph in book.cls (modifico solo l’indentazione per leggibilità, ma il contenuto è inalterato):
`\newcommand\paragraph{\@startsection
{paragraph}% Il nome.
{4}% Il livello.
{\z@}% L'indentazione.
{3.25ex \@plus1ex \@minus.2ex}% Lo spazio prima.
{-1em}% Lo spazio dopo.
{\normalfont\normalsize\bfseries}}% Lo stile.`
nella definizione del mio ambiente ho cercato di essere il più fedele possibile a \paragraph, a parte qualcosina che non ho capito; apro un post a parte per discutere di ciò, in modo da non divagare troppo nei dettagli tecnici.

Purtroppo questo ambiente, non tanto in modalità “stampa” quanto in modalità “raccolta”, deve fare tutto quello che faceva \section, e quindi la sua definizione in realtà sarebbe molto più complicata di quella che ho proposto io. In particolare, in raccolta.sty:

• l’ambiente deve essere numerato, e la numerazione deve seguire il modello di \section, ovvero .; spulciando un po’ nel forum, forse questo lo so fare:
  `% Viene introdotto un nuovo contatore, che fa dipendere la numerazione
  % dell'ambiente da definirsi da quella del capitolo.

  \newcounter{esercizio}[chapter]

  % La numerazione viene impostata nella forma ..

  \renewcommand{\theesercizio}{\thechapter.\arabic{esercizio}}
  `
  ovviamente, anche l’ambiente deve essere aggiornato di conseguenza:
  `\newenvironment{esercizio}[1]{% L'ambiente prende un parametro: il titolo
  % dell'esercizio.
  \refstepcounter{esercizio}% Il contatore viene aggiornato.
  \noindent% L'ambiente non e` preceduto da alcuna
  % indentazione.
  \normalfont% I caratteri sono scritti normalmente, in
  % romano.
  \normalsize% I caratteri hanno un corpo normale.
  {\bfseries\theesercizio\ #1}% *Solo* il primo argomento (il titolo) e` in
  % grassetto.
  \hspace{.575em}% Vi e` una distanza orizzontale che separa il
  % titolo dal resto della consegna.
  }
  {%
  \clearpage% Alla fine dell'esercizio vi e` un salto pagina.
  }`

• i singoli esercizi devono essere aggiunti all’indice dei contenuti (come \section), quindi direi che nell’ambiente, per esempio dopo \refstepcounter{esercizio}, ci potrei mettere
  `\addcontentsline{toc}{section}{\theesercizio\ #1}`
  (pare che funzioni);

• i singoli esercizi dovranno essere scritti in delle marche che potranno essere usate da fancyhdr per gestire le intestazioni (per esempio, nelle pagine pari il capitolo e nelle dispari l’esercizio, e qui mi vengono già i brividi perché per me le marche sono arabo), come \section;

• il corpo dovrà essere un po’ più in grande, quindi al posto di
  `\normalfont\normalsize\bfseries`
  ci andrà
  `\normalfont\Large\bfseries`
  e penso che basti;

• sarebbe da implementare anche la versione con asterisco e il fatto di permettere di mandare nell’indice dei contenuti un titolo (opzionale) più corto (non sono in grado di farlo).
  

Ho quindi paura che per via delle mie scarse conoscenze TeXniche, tutti questi propositi (bellissimi e interessanti, davvero) li si potrà mettere in atto solo col tempo. Ho idea che userò la tecnica divide et impera :-), eventualmente con nuovi topic, se necessario (uno sulle marche, di sicuro, noi due non andiamo molto d’accordo 😉

Il prossimo passo è di fornire opzioni a stampa.sty in modo da scegliere tra le varie possibilità.

Cosa vorresti dire? Che non dovrei usare due pacchetti (raccolta.sty e stampa.sty) ma uno solo (es. formattazione.sty) da chiamare così
`\usepackage[raccolta]{formattazione}`
oppure così?
`\usepackage[stampa]{formattazione}`
Sarebbe fantastico, ma ho idea che sia un po’ aldilà delle mie possibilità…
Nel frattempo, ringrazio tutti quanti per la pazienza e l’interesse (wow! Questo topic sta diventando tosto e stimolante (almeno per me… 😉

Ciao a tutti. In questo messaggio cerco di fare un riassunto di tutto il discorso, mettendo in evidenza solo i punti essenziali.

Ormai siamo giunti alla fine, e, a parte un piccolo dubbio che mi è venuto in mente, il mio problema è risolto. Scrivo questo messaggio prevalentemente per ringraziare ev, che si chiedeva dove stava l’utilità nel problema che mi sono posto, facendo vedere a lui e a chiunque ne fosse interessato un esempio di applicazione reale dell’idea che mi era venuta.

Questo messaggio è lungo e articolato e serve da riassunto; chi non è interessato non occorre che perda tempo a leggerlo.

alla fine avrei preferito usare una versione (leggermente modificata) della sua [di egreg9], senza nulla togliere alla tua [di ev], che risolve il mio problema alla perfezione.

E invece, alla fine, pare che le cose vadano ancora meglio: le due soluzioni sembrano essersi “unificate” in una sola che prende il meglio di tutte e due. Fantastico! 🙂

In merito al significato dei comandi (almeno a me) misteriosi di cui dovevo cercare il significato:

non so cosa facciano ne’ \@ifstar

`\@ifstar\@gobble\@gobbleopt`
\@ifstar controlla se il comando è seguito dall’asterisco; se lo è, esegue \@gobble, altrimenti \@gobbleopt.

Bene, grazie, direi che questo spiega la sintassi del comando \@ifstar: se il test che conduce (controllare se il comando è seguito dall’asterisco) risulta essere vero, viene eseguito, in generale il primo comando proposto, altrimenti il secondo.

ne’ \@gobble

Il primo [\@gobble] mangia il suo argomento [l’argomento del comando nel quale esso è chiamato]

Benissimo; come leggo anche su questo messaggio, \@gobble “cancella” il primo carattere che trova (che non sia uno spazio bianco) oppure la prima stringa che trova raggruppata tra parentesi (graffe, ovviamente). In pratica si tratta dell’istruzione di cancellazione che andavo cercando. Chiaramente, bisognava anche sapere dove metterla (oltre a sapere che esisteva)…

Per quanto riguarda i nuovi comandi, invece:

`\newcommand\@gobbleopt[2][]{}`
[\@gobbleopt] mangia l’argomento obbligatorio e anche quello opzionale.

Ho idea che questo trucco mi sarà molto utile in futuro (e forse non solo a me…)

Ovviamente vorrai aggiungere a \not@a@section qualche comando di spaziatura.

Ma anche no, grazie, sono più che soddisfatto di com’è attualmente.

Non dovresti avere alcun problema di indice.

Confermo.

Ecco la storia integrale del perché ho voluto risolvere questo problema…

Tempo fa, per prepararmi ad un esame, mi sono messo a raccogliere dei testi degli esercizi di vecchi esami e a scriverli in una dispensa. Ho pensato di codificare il tutto nel seguente modo:

• le consegne degli esercizi sono state scritte direttamente così come le ho trovate; il “titolo” dell’esercizio è stato codificato con una sezione (es. \section{Esercizio 4 del 12 aprile 1996});

• quando degli esercizi simili facevano parte di un blocco logico comune, questo è stato codificato con un capitolo (es. \chapter{Esercizi sui B-tree});

• se è stato possibile racchiudere blocchi comuni in ulteriori macroblocchi, questi ultimi sono stati codificati con delle parti (es. \part{Esercizi sugli alberi}).

A questo punto ho arricchito la dispensa con ulteriori caratteristiche messe a disposizione dal linguaggio (l’indice dei contenuti, le metainformazioni e i segnalibri di hyperref, le intestazioni di fancyhdr e così via) che potessero facilitare il reperimento delle informazioni. Anche per questo motivo, questa dispensa non l’ho mai stampata.

Io sono una persona a cui basta poco per distrarsi, e quindi, quando devo svolgere degli esercizi, desidero che il foglio sia il più “pulito” possibile. Ho pensato quindi che tutti gli strumenti messi a disposizione dal linguaggio che rendevano così facile la navigazione, nella carta stampata per me dovevano sparire.

Mi sono messo quindi a scrivere un secondo file (usando il copia e incolla quando potevo) in cui ho fatto sparire l’indice, le intestazioni, i numeri di pagina (perche’ gli esercizi non erano legati l’uno all’altro, e quindi potevano essere svolti indipendentemente), ho eliminato i comandi \part e \chapter, perché il raggruppamento non aveva più importanza, ho sostituito le occcorrenze di \section con \paragraph per diminuire la dimensione del testo della consegna (semanticamente scorretto, ma una volta stampato uno non vede il sorgente elettronico del documento), ho dato dei \newpage per lasciare lo spazio sufficiente per svolgere l’esercizio e così via. La dispensa, così riscritta, aveva quindi un senso ed una praticità, per me, e stavolta potevo stamparla davvero.

Questo è stato un lavorone; fatto una volta, rifarlo sarebbe stato solo una perdita di tempo. In questi giorni ho avuto proprio la necessità di rifarlo e ho preferito perdere un po’ più di tempo per semplificare il lavoro in modo da non doverlo rifare mai più, e grazie al GuIT il problema è risolto.

In breve, la soluzione è questa (l’esempio che propongo è reale; semplicemente, non ho scritto le consegne degli esercizi per non allungare troppo il post):

• scrivere un solo sorgente, il file esempio.tex illustrato di seguito;

• scrivere delle regole di formattazione varie per la produzione di una modalità “raccolta” della mia dispensa, quella pensata per essere “navigata”, non stampata, nel file raccolta.sty;

• scrivere delle regole di formattazione varie per la produzione di una modalità per la stampa, in cui l’aspetto semantico e ipertestuale è ridotto al minimo, nel file stampa.sty.

Come già detto, questa idea l’ho presa in prestito dal mondo HTML + CSS; in questo ambito, infatti, non è raro che uno stesso documento venga formattato in modi differenti a seconda del mezzo con cui deve essere visualizzato.

Ecco il file esempio.tex con il contenuto; ho indentato un po’ male sperando di facilitare la leggibilità. Si noti che il file carica il pacchetto per la raccolta (raccolta.sty); i due pacchetti sono mutuamente esclusivi: o l’uno, o l’altro.
`\documentclass[a4paper,italian]{book}

\usepackage{raccolta}
%\usepackage{stampa}

\begin{document}

\frontmatter

\tableofcontents

\mainmatter

\pagestyle{fancy}

\part[Alberi]{Esercizi sugli alberi}
\chapter[BST]{Esercizi sui BST}
\section{Esercizio 1 del 7 dicembre 2004}
Bla, bla, bla\dots
\section{Esercizio 2 del 7 dicembre 2004}
Bla, bla, bla\dots
\chapter[RB-tree]{Esercizi sugli RB-tree}
\section{Esercizio 2 del 21 gennaio 1999}
Bla, bla, bla\dots
\section{Esercizio 1 del 10 dicembre 1994}
Bla, bla, bla\dots
\chapter[B-tree]{Esercizi sui B-tree}
\section{Esercizio 5 del 21 gennaio 2006}
Bla, bla, bla\dots
\section{Esercizio 7 del 19 dicembre 1991}
Bla, bla, bla\dots
\part[Grafi]{Esercizi sui grafi}
\chapter[Prim]{Esercizi sull'algoritmo di Prim}
\section{Esercizio 4 del 21 gennaio 1999}
Bla, bla, bla\dots
\chapter[Kruskal]{Esercizi sull'algoritmo di Kruskal}
\section{Esercizio 1 del 9 dicembre 1992}
Bla, bla, bla\dots
\end{document}`
Segue il file raccolta.sty, che permette di generare un documento per la navigazione; non lo commento perché non è rilevante ai fini del problema:
`\NeedsTeXFormat{LaTeX2e}

\ProvidesPackage{raccolta}[2006/04/20]

\RequirePackage[italian]{babel}
\RequirePackage{fancyhdr}
\RequirePackage[bookmarksopen,plainpages=false]{hyperref}

\hypersetup{%
pdfauthor={Pinco Pallino},%
pdftitle={Raccolta di esercizi di Algoritmi e Strutture Dati},%
pdfsubject={Esercizi per migliorare la pratica con gli algoritmi},%
}

\pagestyle{fancy}
\renewcommand{\chaptermark}[1]{\markboth{#1}{}}
\renewcommand{\sectionmark}[1]{\markright{\thesection\ #1}}
\fancyhf{}
\fancyhead[LE,RO]{\thepage}
\fancyhead[RE]{\nouppercase{\leftmark}}
\fancyhead[LO]{\nouppercase{\rightmark}}
\renewcommand{\headrulewidth}{0pt}

\fancypagestyle{plain}{
\fancyhf{}
\renewcommand{\headrulewidth}{0pt}
}

\endinput`
Infine, il file stampa.sty, che contiene tutto il bel discorso che abbiamo fatto; i commenti salienti compaiono prima dei comandi:
`\NeedsTeXFormat{LaTeX2e}

% Il presente pacchetto, pensato per una dispensa di esercizi da svolgere,
% formatta il sorgente in modo tale che ogni esercizio (se la consegna non e`
% troppo lunga) venga posto in una singola pagina, affinché la persona che deve
% svolgerlo (a mano), dopo avere stampato la dispensa, abbia spazio sufficiente
% per poterlo risolvere.

\ProvidesPackage{stampa}[2006/04/20]

\RequirePackage[italian]{babel}
\RequirePackage{fancyhdr}

% Poiche' qualcuno potrebbe voler svolgere gli esercizi nell'ordine che
% preferisce (o, comunque, alcuni esercizi potrebbe non volerli svolgere
% affatto), non ha senso tenere conto di una numerazione sequenziale delle
% pagine.

\pagestyle{fancy}
\fancyhf{}
\renewcommand{\headrulewidth}{0pt}

% Giusta o sbagliata che sia, l'istruzione seguente permette di aumentare di
% parecchio la giustezza del testo, e riduce i margini, in modo da fornire uno
% spazio maggiore per chi deve scrivere.

\RequirePackage[top=2cm,left=2cm,right=2cm,bottom=2cm]{geometry}

% I comandi \part e \chapter vengono azzerati dal comando \not@a@section;
% per quanto riguarda \section, non si vuole che esso venga eliminato del
% tutto, ma solo che esso risulti scritto piu` in piccolo. Si vuole comunque
% che non compaia nell'indice…

\setcounter{tocdepth}{0}

% … e inoltre, se il titolo di una sezione e` semplicemente il testo della
% consegna, a chi deve svolgere l'esercizio non dovrebbe interessare che
% l'esercizio in questione sia la sezione 4.3 di un possibile capitolo
% dedicato ai grafi.

\setcounter{secnumdepth}{0}

% Il nuovo comando \not@a@section si prefigge lo scopo di “annullare” (rendere
% vuoti) i comandi di sezionamento; per fare cio` chiama \@gobble in presenza
% di un comando di sezionamento non numerato e \@gobbleopt in presenza di un
% sezionamento numerato, che potrebbe avere un titolo opzionale.

\def\not@a@section{\@ifstar\@gobble\@gobbleopt}

% Il nuovo comando \@gobbleopt “annulla” sia l'argomento obbligatorio che
% quello opzionale del comando in cui viene chiamato.

\newcommand\@gobbleopt[2][]{}

% I comandi \part e \chapter vengono “annullati”.

\let\part\not@a@section
\let\chapter\not@a@section

% Il comando \section viene riformattato in modo da essere scritto molto piu`
% in piccolo, come \paragraph. In piu` viene chiamata l'istruzione \clearpage
% che fornisce a chi deve svolgere l'esercizio lo spazio bianco in cui poterlo
% risolvere (a mano, dopo averlo stampato) dal momento che inserisce il testo
% dell'esercizio [la \section] successivo[a] appena alla pagina seguente; in
% questo modo, per ogni facciata c'e` un solo esercizio (a meno di consegne
% troppo lunghe).

\renewcommand{\section}{\@startsection
{section}% Il nome.
{1}% Il livello.
{\z@}% L'indentazione.
{3.25ex \@plus1ex \@minus.2ex}% Lo spazio prima.
{-1em}% Lo spazio dopo.
{\normalfont\normalsize\bfseries\clearpage}} % Lo stile.

\endinput`
Chi è interessato può provare a compilare per vedere la differenza con i due pacchetti.
L’ultimo dubbio che mi è venuto: se sintatticamente è corretto chiamare \clearpage dentro a \section codì direttamente oppure se si può fare di meglio; comunque, questa sarebbe solo una chicca.

Grazie a tutti per la bontà dei vostri suggerimenti e per la vostra pazienza! A presto! 🙂

Un grazie di cuore a tutti quelli che hanno voluto aiutarmi nella soluzione del mio problema! 🙂

Adesso cerco io di essere utile a qualcun altro, se mai dovesse averne bisogno in futuro, riassumendo i punti principali di questo discorso (e facendo qualche piccola considerazione):

1. sono persuaso che la soluzione migliore per me (perché una soluzione universale non esiste 😉 sia quella proposta dal prof. Gregorio (eliminare \sloppy e \fussy e usare \raggedright{…}); tra l’altro, mi sono persuaso a diminuire la dimensione del corpo del carattere per ottenere una giustificazione meno “indecente” 😉

2. visto che pensavo di utilizzare questo frontespizio non per un singolo documento ma per una serie di documenti, ho pensato che fosse più corretto separare il contenuto dalla presentazione, come si fa nei linguaggi di marcatura per il web, inserendo il codice appena visto in un file di classe. Siccome non l’ho mai fatto prima (ho preso spunto da qui e da qui), forse non ho tenuto conto di qualche usanza e/o consuetudine. In tal caso, chiedo scusa ;-).

   Per chiarezza, riassumo di seguito il codice riveduto e corretto, che non si trova più all’interno di un file LaTeX (.tex) ma in un file di classe (.cls) (es. book-frontispiece.cls):

   `%% book-frontispiece.cls
   %%
   \NeedsTeXFormat{LaTeX2e}
   \ProvidesClass{book-frontispiece}
   [2006/03/11 Classe per personalizzare il frontespizio. Si basa su `book.cls']
   %%
   \DeclareOption*{\PassOptionsToClass{\CurrentOption}{book}}
   \ProcessOptions
   \LoadClass{book}
   %%
   \renewcommand{\maketitle}{
   \setlength{\parindent}{0pt}
   \thispagestyle{empty}
   \rule{\linewidth}{5pt}
   {\raggedright\fontsize{30}{36}\selectfont\sffamily{}\@title\par}
   \vspace{1em}
   \rule{\linewidth}{5pt}
   %\vspace{1em} % Non funziona! Come mai?
   \vskip 1em % Ho dovuto usare \vskip
   {\raggedleft\LARGE\sffamily{}\@date\par}
   \setlength{\parindent}{15.0pt}
   \clearpage
   }
   %%
   \endinput`
   Ho anche creduto che fosse più corretto ridefinire \maketitle con \renewcommand{…}{…} (visto che esisteva già), piuttosto che usare \def…

   Tale classe di documento può essere richiamata in un file LaTeX nel modo seguente:

   `\documentclass[a4paper,italian]{book-frontispiece}

   \title{Appunti del corso di Algoritmi e Strutture Dati}
   \author{Pinco Pallino}
   \date{\isodash{.}\isodate{\today}} % formattazione data

   % Pacchetti
   \usepackage{avant} % AvantGarde
   \usepackage[italian]{babel}
   \usepackage[T1]{fontenc}
   \usepackage{isodate} % per scrivere la data in formato aaaa.mm.gg
   \usepackage[top=2cm,left=2cm,right=2cm,bottom=2cm]{geometry}
   \usepackage[latin1]{inputenc}
   \usepackage{mathptmx} % Times
   \frenchspacing

   \begin{document}

   \maketitle

   \end{document}`

3. già che c’ero, ho modificato la classe in modo che permettesse pure l’inserimento della data (formattata in un modo un po’ diverso grazie al pacchetto isodate); non riesco però a capire perché \vspace{…} non funziona più (ho dovuto usare \vskip)! Qualcuno ha qualche spiegazione?

4. se mi avanza un po’ di tempo, cercherò di scrivere una piccola guida che riassume il nostro bel discorso.

Grazie ancora e buon finesettimana a tutti! 🙂