1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255
1256
1257
1258
1259
1260
1261
1262
1263
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273
1274
1275
1276
1277
1278
1279
1280
1281
1282
1283
1284
1285
1286
1287
1288
1289
1290
1291
1292
1293
1294
1295
1296
1297
1298
1299
1300
1301
1302
1303
1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
1320
1321
1322
1323
1324
1325
1326
1327
1328
1329
1330
1331
1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531
1532
1533
1534
1535
1536
1537
1538
1539
1540
1541
1542
1543
1544
1545
1546
1547
1548
1549
1550
1551
1552
1553
1554
1555
1556
1557
1558
1559
1560
1561
1562
1563
1564
1565
1566
1567
1568
1569
1570
1571
1572
1573
1574
1575
1576
1577
1578
1579
1580
1581
1582
1583
1584
1585
1586
1587
1588
1589
1590
1591
1592
1593
1594
1595
1596
1597
1598
1599
1600
1601
1602
1603
1604
1605
1606
1607
1608
1609
1610
1611
1612
1613
1614
1615
1616
1617
1618
1619
1620
1621
1622
1623
1624
1625
1626
1627
1628
1629
1630
1631
1632
1633
1634
1635
1636
1637
1638
1639
1640
1641
1642
1643
1644
1645
1646
1647
1648
1649
1650
1651
1652
1653
1654
1655
1656
|
%
% toptesi-doc.tex
%% Copyright 2005-2010 Claudio Beccari
%
% This work may be distributed and/or modified under the
% conditions of the LaTeX Project Public License, either version 1.3
% of this license or (at your option) any later version.
% The latest version of this license is in
% http://www.latex-project.org/lppl.txt
% and version 1.3 or later is part of all distributions of LaTeX
% version 2003/12/01 or later.
%
% This work has the LPPL maintenance status "author-maintained".
%
%
% This work consists of the files listed in manifest.txt
%
% Version 1.3 of the LaTeX Project Public License is included in the
% appendix of this documentation, but the primary source remains in
% http://www.latex-project.org/
%
% 2008/03/01 corretto l'esempio della sola stampa del frontespizio,
% perche' risultava errata omettendo di chiamare babel
\documentclass[12pt,twoside,pdfa]{toptesi}\errorcontextlines=9
\hypersetup{%
pdfpagemode={UseOutlines},
bookmarksopen,
pdfstartview={FitH},
colorlinks,
linkcolor={blue},
citecolor={blue},
urlcolor={blue}
}
\usepackage[latin1]{inputenc}
\usepackage{color}
\usepackage{microtype}%
%%%% inserire il valore corretto della versione di toptesi
\def\fileversion{5.04}
\NomeMonografia{Manuale d'uso}
\monografia{La classe \textsf{TOPtesi}}
\sottotitolo{Per comporre le tesi al Poli \\e in molte altre università}
\candidato{Claudio Beccari}
\sedutadilaurea{Versione \fileversion}
\logosede{logopolito}
\begin{document}
\thispagestyle{empty}
\vspace*{.2\textheight}
\hrule
\bigskip
\centerline{\fontfamily{sf}\fontsize{25}{25}\selectfont La classe TOPtesi}
\bigskip
\hrule
\newpage
\frontespizio
\sommario
Questo testo serve per descrivere come comporre tipograficamente la
tesi di laurea o la monografia o la dissertazione di dottorato
mediante il noto programma di composizione \LaTeX, o meglio, mediante la sua variante pdf\LaTeX; sono previste di default le necessarie azioni per produrre il file finale in formato PDF archiviabile secondo la norma ISO 19005-1.
L'appendice~A contiene il testo della \LaTeX\ Project Public Licence,
versione 1.3, alla quale questo lavoro è soggetto.
\ringraziamenti
Ringrazio gli studenti del Politecnico di Torino che mi hanno
sollecitato a mettere la mia esperienza a loro disposizione per
predisporre e rendere disponibile il software necessario per
preparare le loro tesi, monografie o dissertazioni con la qualità
che solo \LaTeX\ e pdf\LaTeX\ riescono a produrre.
\indici
\chapter{Introduzione}
Si legge ancora nelle istruzioni per scrivere le tesi di molte
università italiane come di moltissime università straniere:
\begin{quote}\ttfamily
Comporre la tesi con interlinea 2 e con righe di 60 battute;
\dots
\end{quote}
Quelle università non si sono ancora accorte che le macchine da
scrivere meccaniche o elettromeccaniche sono rimasti oggetti di
sola curiosità, ammesso che ce ne sia ancora qualcuna disponibile
e le poche superstiti non siano tutte nei musei.
Oggi si scrive con uno dei tanti sistemi di elaborazione testi,
detti anche ``word processors'', che fanno parte più o meno di
default di ogni dotazione iniziale di qualsiasi PC di qualunque
marca e con qualunque sistema operativo.
Fra i vari programmi di elaborazione testi, uno in particolare
spicca per la sua particolarità: \LaTeX. Esso è nato come
sovrastruttura di un altro programma, \TeX, che continua ad
esserne il motore. La prima versione di \TeX\ è stata creata nel
1978, ma è ancora usata oggi, naturalmente molto aggiornata, e
questo fatto è una cosa insolita nel panorama turbolento di novità
dell'informatica.
Secondo me, il suo successo è dovuto a due fatti: (a) esso è stato
progettato e implementato da un matematico per comporre i suoi
stessi libri di informatica; (b) egli l'ha messo a disposizione di
chiunque, sin dal primo momento, come software libero.
Oggi il software libero è piuttosto diffuso, ma nel 1978 parlare
di software libero era quasi una bestemmia.
D'altra parte Donald E.\ Knuth non era soddisfatto della bassa
professionalità che anno dopo anno manifestavano i compositori
delle case editrici, i quali anno dopo anno si abituavano a quanto
i programmi di elaborazione mettevano loro a disposizione, ma
contemporaneamente perdevano le loro conoscenze professionali via
via che si adattavano a quanto quei programmi consentivano loro di
fare.
La cosa era o stava diventando insostenibile durante i vari anni
in cui uscivano i successivi volumi dell'opera di Knuth ``The Art
of Computer Programming'', e così Knuth si dedicò alla creazione
della tipografia elettronica realizzando il programma \TeX\ che,
ripeto, è ancora in ottima salute dopo quasi trent'anni di
onorato servizio.
L'uso di \TeX\ per eseguire direttamente la composizione era piuttosto
difficile, e ogni utente doveva prima o poi imparare a scriversi delle
macroistruzioni che gli consentissero di agevolare il suo lavoro.
Nel 1984 \TeX\ era già così diffuso in tutto il mondo,
specialmente in ambito accademico, che Leslie Lamport decise di
produrre un sistema quasi completo di macro che consentiva agli
utenti di usare \TeX\ lasciandolo dietro alle quinte, in modo da
potersi concentrare sul contenuto dei loro scritti e non sulla
forma da dare a questo o a quel dettaglio.
Nel 1990 Knuth realizzò la versione di \TeX\ che consentiva di
comporre in diverse lingue simultaneamente; nel 1994 molti utenti
di \LaTeX\ costituirono il \LaTeX3 Team al fine di rendere
gestibile la mole enorme delle estensioni di \LaTeX\ che in
10~anni utenti entusiasti avevano messo a disposizione della
comunità degli altri utenti. Insomma è successo con \TeX\ e
\LaTeX\ quello che succede normalmente con il software libero.
Attenzione: Knuth paga di tasca sua un dollaro a chiunque trovi un
errore nel suo software; a tutt'oggi non è andato in bancarotta,
sia perché gli errori sono rarissimi, sia perché quelle poche
persone che hanno segnalato errori veri e hanno ricevuto l'assegno
di Knuth, non l'hanno incassato ma l'hanno incorniciato come fosse
una reliquia preziosa.
\section{\LaTeX\ e le tesi di laurea}
Ovviamente \LaTeX\ serve per scrivere qualunque cosa; o meglio;
serve per comporre tipograficamente qualunque testo. \LaTeX\ non è
un programma di impaginazione, è un programma di composizione
tipografica. Non aspettatevi quindi di poter fare qualunque
acrobazia con le righe di testo, come per esempio piegare le
righe, deformando i caratteri che vi sono appoggiati sopra,
mettendovi attorno aloni di luce cangiante, sfumature,
ombreggiature, evidenziandone i contorni, eccetera. Queste cose
sono riservate ai creativi che si occupano di pubblicità.
Aspettatevi invece di comporre testi in cui ogni capoverso è
ottimizzato per avere il minor numero di parole divise in sillabe
in fin di riga, e di avere il minor numero possibile di
``ruscelli'' fra le parole grazie alla uniformità dello spazio
interparola; aspettatevi di comporre formule complicatissime con
il minimo di sforzo da parte vostra ma con la certezza che esse
saranno composte come nessun altro programma riesce a fare.
Aspettatevi uno stampato estremamente professionale.
Per questo motivo voi studenti che userete questo pacchetto di
macroistruzioni chiamato \textsf{TOPtesi} dovrete astenervi
dall'introdurre errori compositivi così da vanificare quanto di
bello riesce a produrre \LaTeX.
Inizialmente vi troverete un po' a disagio perché vi siete
abituati anche voi ai programmi commerciali che consentono la
``composizione sincrona''; vi consentono di vedere subito sullo
schermo il frutto del vostro lavoro. Per ottenere questo risultato
questi programmi hanno necessariamente rinunciato a diverse
funzioni, massimizzando invece la velocità di presentazione del
risultato.
\LaTeX\ richiede che voi scriviate un testo non formattato in puri
caratteri ASCII, ma marcato con un particolare sistema di
\emph{mark-up} che consente di sapere che cosa sia ogni parte del
vostro scritto. Ci pensa poi \LaTeX\ in un secondo tempo a dare forma
al vostro testo e, in particolare, a dare la stessa forma a ogni
elemento del vostro scritto a seconda di come lo abbiate ``marcato'';
elementi marcati nello stesso modo vengono composti nello stesso modo.
Così si evitano quelle disuniformità compositive che si notano assai
spesso quando si usa un word processor comune.
Attenzione: questa guida presuppone che voi abbiate già uno conoscenza di base del linguaggio di \emph{mark-up} di \LaTeX. Se non l'avete ancora, installate pure il programma, ma non usate questa guida per imparare a comporre testi con \LaTeX. Esistono diversi testi gratuiti in rete, da \emph{\LaTeX\ per l'impaziente} a \emph{L'arte di scrivere con \LaTeX} a \emph{Introduzione all'arte della composizione tipografica con \LaTeX}; vi basta cercare questi titoli con un qualunque motore di ricerca e troverete da dove scaricarli.
Ricordatevi però che il vostro primo problema sarà quello di superare lo scoglio psicologico di non vedere subito il frutto delle vostre fatiche; abituati come siete ai word processor che seguono il paradigma \emph{What you see is what you get}, che più realisticamente andrebbe scritto \emph{What you see is all you can get} (Quello che vedi e tutto quel che puoi ottenere), dovete passare al paradigma: \emph{What you see is what you mean}, dove l'aspetto grafico di quel che si vede sullo schermo del PC in fase di composizione non è importante, ma è importante quello che avete scritto; il suo aspetto grafico gli verrà dato da \LaTeX\ in un secondo tempo e in una maniera estremamente professionale. Non pretendo di dire che non si possano scrivere tesi ancora più professionali di come si ottengono con \textsf{TOPtesi}, ma certo il risultato è molto migliore di quello che si può ottenere con qualsiasi word processor.
Volete avere una migliore approssimazione sulla finestra di composizione, in modo da restare su una via di mezzo fra le due posizioni di composizione? Usate LyX, oppure usate la componente \texttt{Writer} di OpenOffice; questa componente può essere arricchita con una estensione, scaricabile dal sito di OpenOffice, che si chiama \texttt{Writer2LaTeX}. Mentre sto scrivendo questi appunti la versione stabile non consente di usare \texttt{Writer} come se fosse un editor per \LaTeX; ma è già disponibile una versione sperimentale, che diventerà la versione ufficiale~1.2 di questa estensione) che permette di usare con certe limitazioni il programma \texttt{Writer} come un editor per \LaTeX, per poi disporre di un comodo bottone da cliccare per ottenere la composizione del testo sorgente, ed un altro comodo bottone per la visualizzazione dell'uscita in formato PDF. Gli utenti esperti possono superare le limitazioni inserendo nel testo sorgente adeguate istruzioni in linguaggio \LaTeX, cosicché quello che non può fare \texttt{Writer} come word processor, lo fa poi \LaTeX\ nella sua qualità di text processor.
Personalmente non consiglierei queste vie di mezzo; tuttavia vale la pena sapere che esistono e che possono essere usate, sia pure con qualche limitazione.
\section{Installare \LaTeX}
Quindi per cominciare a lavorare con \LaTeX\ per prima cosa dovete
installarvi il software; ovviamente se vi siete già installati
l'intero sistema \TeX\ ed è già calibrato per comporre
correttamente, potete saltare questo paragrafo.
Ci sono sostanzialmente tre situazioni:
\begin{enumerate}
\item se siete degli utenti delle piattaforme Windows allora
collegatevi in rete al sito \texttt{www.miktex.org} e scaricatevi
ed installatevi la distribuzione di \LaTeX, o meglio, del sistema
\TeX\ chiamato MiK\TeX. Scaricatevi l'installazione completa, \emph{non} l'installazione minima o ``basic''. Ovviamente questo scaricamento implica una
connessione di rete sufficientemente veloce.
{\tolerance=9999
Personalmente, anche sulla mia macchina virtuale Windows, io preferisco usare la distribuzione multipiattaforma \TeX~Live; basta scaricare da \texttt{http:/"/www.ctan.org"/tex-archive"/systems"/texlive"/tlnet} il pacchetto \texttt{install-tl.zip}, decomprimere il pacchetto, leggere le istruzioni, e lanciare l'installatore specificando anche il sito da cui eseguire lo scaricamento die file sia per la prima installazione sia per i successivi aggiornamenti. Il sito più conveniente per gli utenti italiani non è il \emph{mirror} ufficiale di Roma2, quello di default, (che funziona ma può risultare lentissimo), ma è il sito \texttt{http:/"/bo.mirror.garr.it"/mirrors"/CTAN"/systems"/texlive"/tlnet}. Tenuto conto che bisogna installare circa 2\,GiB di file, ci vuole una buona mezzz'oretta per installare il tutto con un collegamento ADSL sufficientemente veloce, ma poi Il sistema è pronto per funzionare senza ulteriori configurazioni. Il bello di questa distribuzione è che i suoi moltissimi pacchetti vengono aggiornati piuttosto spesso e io personalmente il il \TeX\ Live Manager almeno una volta alla settimana per essere sempre aggiornato alle ultime versioni di qualunque pacchetto; uso la stessa distribuzione e lo stesso manager anche su una mia macchina Macintosh e su un'altra macchina Linux.\par}
\item Siete degli utenti di Linux; in questo caso siete particolarmente
fortunati perché il sistema \TeX\ fa parte integrante di
qualunque distribuzione, anche se non viene installato di default;
vi basta inserire il disco di installazione o vi basta connettervi
in rete e invocare uno dei vari programmi come \texttt{apt-get},
\texttt{rpm} o \texttt{yast} per scaricare tutto quanto vi serve e
per configurare l'installazione. Ricordatevi che Linux un po'
più ``ruspante'' di Windows, e quindi la configurazione richiede
un po' più di attenzione e di smanettamento con la riga di
comando; ma a questo, in qualità di ``pinguini doc'', ci siete
abituati; in compenso avete il beneficio di avere tutto quanto il
software già predisposto fin dalla nascita per macchine UNIX e
Linux e quindi evitate tutti i (pochi) piccoli bug che si
incontrano quando le cose sono tradotte per altri sistemi.
Piuttosto se siete utenti di un Debian/Linux, vi conviene installare in parallelo alla distribuzione TeX Live/Debian o alla vecchia distribuzione teTeX, anche la distribuzione \TeX\ Live indicata sopra, perché questa è sempre aggiornata o comunque è aggiornabile in tempo reale, mentre le distribuzioni Debian hanno sempre almeno due anni di età; siccome questo è un periodo di rapida evoluzione, due anni sono troppi, e quindi è decisamente preferibile disporre della distribuzione \TeX\ Live ufficiale prodotta dall'apposito Working Group di TUG (l'associazione internazionale degli utenti di \TeX, oltre che l'ente ufficiale che produce e distribuisce il sistema \TeX).
\item Siete degli utenti delle piattaforme Macintosh e siete i
fortunati possessori di un portatile o di un desktop che funziona
con il sistema operativo Mac~OS~X. Anche voi avete a disposizione
una distribuzione che si chiama \texttt{Mac\TeX}, che viene
installata e configurata con un particolare software adatto alla
specificità del sistema che state usando. Cercate il nome MacTeX
con un qualunque motore di ricerca e sarete portati ad un sito dal
quale potrete scaricare il pacchetto di installazione (piuttosto
grosso); alla fine del download vi viene chiesto se continuare con
l'installazione; rispondendo affermativamente, il software vi viene
scaricato sul disco che avrete indicato, ma quel che è più
comodo, esso è già pronto per funzionare senza bisogno di ulteriori configurazioni. Il sistema \texttt{Mac\TeX} produce il suo output solo
in formato PDF; se ne tenga conto leggendo attentamente la
documentazione, perché la cosa può essere critica con
l'inserimento delle immagini. Il pacchetto è già dotato dello
shell editor \TeX{}shop e fa ricorso ad un suo previewer interno per
il formato PDF.
Attenzione: questo previewer interno consente di eseguire
l'\textit{inverse search} mentre l'editor \TeX{}shop consente di
fare la \textit{forward search}. Questo è molto comodo durante la
fase di editing del vostro documento.
\end{enumerate}
Poi avete bisogno di programmi accessori per visualizzare sullo
schermo e/o stampare su carta i prodotti delle vostre
composizioni. Ognuna delle tre piattaforme tipo può avere già
installati sia i visualizzatori dei file in formato \texttt{.dvi},
\texttt{.ps} o \texttt{.pdf}. Il formato \texttt{.dvi} è il
formato nativo del sistema \TeX\ quindi il software per
visualizzare e stampare arriva insieme alla distribuzione che
avete già installato. Per il formato \texttt{.ps} bisogna disporre
di qualcosa come \texttt{ghostscript} e/o \texttt{GSView} o altri
simili software che con Linux sono solitamente già disponibili
insieme al sistema. In ogni caso non è difficile trovare in rete
i luoghi da dove scaricarli. Per il formato \texttt{.pdf} Linux,
come al solito è già attrezzato.
Infine è necessario disporre di un programma di composizione di
testi ASCII che sia anche un po' d'aiuto per comporre con \LaTeX.
Il programma gratuito che, a detta degli appassionati, serve per
fare tutto sarebbe \texttt{emacs}, disponibile per tutte e tre le
piattaforme anche se è nativo di UNIX. Sarà anche vero che è
quasi onnipotente, ma per me è difficile da usare; diciamo che ha
una curva di apprendimento piuttosto ripida e per la mia età le
salite ripide non sono indicate.
Per tutte e tre le piattaforme è disponibile l'editor gratuito TeXmakerX, scaricabile dalla rete; esso è multipiattaforma ed è capace di lavorare anche con l'encoding UNICODE e di riconoscere se un file sorgente è codificato UNICODE oppure nella codifica di default del particolare sistema operativo della macchina. Anche TeXmakerX è dotato di un visualizzatore PDF interno che gli consente di tenere sincronizzate le finestre di editing e di composizione, cosicché come si muove il cursore in una finestra, simultaneamente si muove anche l'altra finestra alla posizione corrispondente. Estremamente utile, comodo e facile da usare.
Per le piattaforme Mac esistono diversi programmi e vi si può installare anche TeXmakerX; a me, però, sembra che il migliore di tutti sia TeXShop, automaticamente installato quando si usa il pacchetto \texttt{Mac\TeX}.
\section{Ora siete pronti}
Ora che avete scaricato tutto il software gratuito o commerciale di cui
avete bisogno siete pronti per cominciare.
{\color{red}Dopo avere letto un po' di documentazione e aver giocato un poco
con i programmi già predisposti sia dalla distribuzione del
sistema \TeX\ sia dai vari editor ASCII, siete in grado di capire
come funziona il tutto.
Attenzione: non si minimizzi la frase precedente: la documentazione va letta sempre e capita fino in fondo; se c'è qualcosa che non capite, provate ad esercitarvi con qualche piccolo esercizio, visto che la pratica permette di capire la teoria (e viceversa), ma non andate a cercare in rete aiuto nei vari forum dedicati a \LaTeX\ per farvi dire: ``guarda nella pagina tal-dei-tali della documentazione''; per voi sarebbe una vera umiliazione\dots}
A qualcuno può venire in mente: ``Ma non sarà mica che ci siano in giro dei programmi che permettono di fare tutto questo in modo WYSIWYG?'' Come noto, WYSIWYG è l'acronimo che si forma con le iniziali di ``what you see is what you get''. \LaTeX\ dovrebbe essere classificato con l'acronimo WYSIWYM che sta per ``what you see is what you mean''. Certo per ottenere esattamente quello che si voleva bisogna lavorare (apparentemente) di più; in realtà bisogna usare di più la testa e di meno il mouse.
Tuttavia là fuori nei negozi ci sono diversi prodotti che consentono di usare \LaTeX\ praticamente in modo WYSIWYG; da Scientific Word a LyX a TeXmacs a Textures ce ne è per ogni piattaforma; LyX e TeXmacs sono freeware mentre gli altri costano attorno ai 500\$. Poi c'è la soluzione gratuita di OpenOffice con l'estensione~1.2 di \texttt{Writer2LaTeX}.
Sia però chiaro; per poter operare in modo ``sincrono'' così da
avere immediatamente sullo schermo una cosa molto simile a quello
che si otterrà sulla carta, il programma deve essere velocissimo
ad eseguire il rendering grafico di quanto viene via via composto;
per questo motivo deve rinunciare a non poche funzionalità del
sistema \TeX. Però tutti questi software hanno la possibilità di
salvare i file in formato \texttt{.tex}, cioè nel formato
sorgente del sistema \TeX, per cui una volta finito l'editing si
può eseguire la composizione finale con il programma vero, e non
tramite le facilities del programma di editing.
Io ho cominciato a lavorare con \LaTeX\ a metà degli anni '80 e non ho mai usato editor sincroni. Una decina di anni fa mi sono interessato per vedere i vantaggi di Textures, ma dopo poco ho lasciato perdere perché dovevo lavorare su una piattaforma Mac altrui e non potevo seccarlo in continuazione per chiedergli come si fa questo, come si fa quello; allora il sistema operativo era molto diverso dall'attuale Mac~OS~X e solo gli addetti ai lavori sapevano come usarlo al meglio.
Disponendo di una piattaforma Linux ho verificato il funzionamento
sia di LyX sia di TeXmacs, ma alla fine sono tornato a usare i
miei semplici editor ASCII con i quali non ho nessuna limitazione
di nessun genere per quel che riguarda la composizione dei miei
testi. Bisogna dire che io faccio un grande uso di macroistruzioni
adatte al mio modo di comporre; in generale le macroistruzioni non
sono interpretabili da quei sistemi che sono un po' chiusi in se
stessi, proprio per poter massimizzare la velocità di rendering.
\textcolor{red}{Nel seguito partirò dal presupposto che abbiate già una certa
conoscenza di \LaTeX\ e che conosciate la differenza fra \LaTeX\ e
pdf\LaTeX.}
\chapter{L'uso di \textsf{TOPtesi}}
L'insieme di macro contenute in \textsf{TOPtesi} realizza esattamente
le specifiche di composizione per le monografie, tesi di laurea e
dissertazioni di dottorato da comporre presso il Politecnico di Torino;
l'acronimo TOP sta per TOrino Politecnico e naturalmente gioca un po'
anche sull'altro significato della parola inglese ``top''.
Tuttavia il pacchetto non è stato creato solo per il Politecnico
di Torino; le informazioni relative a questo ateneo sono di
default, così come la facoltà di ingegneria è la facoltà di
default. Ma i comandi predisposti consentono di personalizzare il
pacchetto per ogni ateneo e ogni facoltà e, oserei dire, in ogni
lingua.
Tenete conto che \textsf{TOPtesi} è già stato usato anche per
scrivere tesi in filologia classica greca e in filologia copta;
\textsf{TOPtesi} non è limitato solo a scritti delle discipline
cosiddette esatte, quelle che fanno un grande uso del linguaggio
matematico, ma altrettanto utile per scrivere testi in
discipline umanistiche, perché \LaTeX\ e pdf\LaTeX\ sono
altrettanto precisi nel comporre la matematica di quanto lo siano
nel comporre una poesia o un romanzo.
\section{Dove sono i file di \textsf{TOPtesi}?}
La distribuzione di \textsf{TOPtesi} contiene molti file; ma ogni distribuzione moderna del sistema \TeX\ li carica tutti senza che dobbiate intervenire a mano. Tuttavia è importante che voi sappiate dove trovare questi file.
L'installazione del sistema \TeX\ prevede che i suoi numerosissimi file siano installati in un certo numero di strutture di cartelle, chiamate ``alberi''; ogni albero ha una radice; normalmente la radice della distribuzione si chiama \texttt{texmf-distr}, ma sulla vostra macchina e con il vostro sistema operativo potrebbe avere un altro nome. Esiste anche un albero radicato nella vostra ``home''; nei sistemi di stampo UNIX essa si indica simbolicamente con la tilde e la radice del vostro albero personale potrebbe chiamarsi \texttt{\~{}/texmf}; sulle macchine Windows invece dovete cercare in \texttt{C:\char92Documents and settings} Seguito dal vostro user nome oppure da \texttt{All users}; magari ci sono ancora altri rami di albero da percorrere, ma poi si trova \texttt{texmf} o \texttt{localtexmf}. Nei sistemi Mac la radice del vostro albero personale è sotto la vostra \texttt{Library}.
Tutti i file del pacchetto \textsf{TOPtesi} vengono caricati nell'albero della distribuzione; i file della documentazione lungo il ramo \texttt{doc}; i file sorgente, lungo il ramo \texttt{source}; i file ``eseguibili'' in una cartella lungo il ramo \texttt{tex}; fra questi file ``eseguibili''\footnote{Chiamare ``eseguibili'' i file che vengono usati da \LaTeX\ è molto improprio: si tratta di file necessari durante l'esecuzione del programma, ma non sono quei file ad essere eseguibili nel senso informatico del termine.} c'è anche il file \texttt{toptesi.cfg}. Copiate questo file nella vostra cartella di lavoro come spiegato qui di seguito e modificatelo secondo le vostre necessità.
\section{Il file di configurazione}
È comodo disporre di un file di configurazione
\texttt{toptesi.cfg}; il pacchetto \textsf{TOPtesi} contiene già
un file con la configurazione di default; chiunque se lo può
modificare come meglio crede; infatti che senso avrebbe una
configurazione di default se non la si potesse configurare?
Tuttavia non è necessario servirsi del file \texttt{toptesi.cfg}
né di modificare il file con la configurazione di default,
perché ogni comando che contenga esplicitamente materiale per il
frontespizio ridefinisce quanto è definito di default e quindi
nulla è cristallizzato, fisso e immutabile. Tuttavia il file
di configurazione semplifica molto la vita e se ne consiglia
l'uso.
Potete perciò usare un diverso file di configurazione, sempre
chiamato però \texttt{toptesi.cfg}, collocato nella stessa
cartella dove risiede il materiale da comporre. Per esempio,
poteste comporre la monografia di laurea creando da qualche parte
la cartella \texttt{/monografia} e in questa cartella vi copiate
\texttt{toptesi.cfg} che poi modificherete a vostro piacimento; in
questa cartella sistemerete anche i file per comporre la
monografia. Quando due anni dopo componete la vostra tesi di
laurea magistrale, create da qualche parte la cartella
\texttt{/tesi} e mettetevi dentro un copia del file
\texttt{toptesi.cfg} con la vostra configurazione adattata alla
tesi magistrale; in questa stessa cartella metterete i file
relativi alla vostra tesi magistrale. Se dopo tre anni prenderete
il dottorato e vi scriverete la vostra dissertazione dottorale,
createvi da qualche parte la cartella \texttt{/dissertazione} e
mettetevi dentro un'altra copia di \texttt{toptesi.cfg} che
configurerete per la vostra dissertazione; sempre in questa stessa
cartella metterete i file necessari per comporre la vostra
dissertazione.
\section{Il formato PDF/A}
Il Politecnico di Torino, come anche molte università italiane e straniere, sta cercando di ``smaterializzare'' le copie di archivio delle tesi di laurea. Sono al corrente che oggi (fine 2008) è allo studio un processo per consegnare la copia di archivio della tesi tramite il Portale della Didattica, in modo da eliminare le copie cartacee.
Il problema dell'archiviazione elettronica è che il materiale archiviato deve essere reperibile, leggibile e stampabile anche di qui a, diciamo, cinquanta anni. Per questo è necessario che esso sia archiviato in un formato standard e che nel futuro continuino ad esistere i programmi per la visualizzazione e la stampa di questo formato.
L'Interntional Standards Organization ha pubblicato nel 2005 uno standard per l'archiviazione dei file con la norma ISO 19005-1:2005. Secondo questa norma i file archiviabili devono avere il formato PDF della versione 1.4 e devono soddisfare ad altri requisiti, oltre a contenere un certo numero di \emph{metadata} specificati dalla norma. Esistono due sotto"formati: il PDF/A-1a e il PDF/A-1b. Il formato PDF/A-1a deve rispondere ai requisiti del formato PDF/A-1b oltre ad altri requisiti specifici, in particolare che i font siano tutti inclusi nel file ed abbiano codifica UNICODE e che il file deve mantenere una struttura logica che possa essere esaminata con i motori di ricerca. Viceversa il formato PDF/A-1b, con meno pretese, richiede che i font siano tutti inclusi nel file, anche se non rispettano la codifica UNICODE, e che il file sia riproducibile a schermo e sia stampabile esattamente nello stesso modo di quando il file è stato archiviato. Il Politecnico richiede il sotto'formato PDF/A-1b.
Per questo scopo è necessario usare il programma di composizione \texttt{pdflatex} e il pacchetto specifico \textsf{pdfx} richiedendo nel preambolo del file principale della tesi che sia richiamato il file \texttt{pdfx.sy} con l'opzione giusta, precisamente il preambolo, subito prima di \verb|\begin{document}|, deve contenere la richiesta:
\begin{verbatim}
\usepackage[a-1b]{pdfx}
\end{verbatim}
Per facilitare la composizione della tesi questa richiesta è già contenuta nella classe \texttt{TOPtesi}, quindi lo studente non deve preoccuparsi di niente, fuorché installare il pacchetto \textsf{pdfx} nel proprio albero locale.
Se questo pacchetto non fosse già caricato con l'installazione del sistema \TeX\ in un albero di sistema, bisogna provvedere scaricando il pacchetto dagli archivi \textsc{ctan} e installandolo nel proprio albero locale. Siccome bisogna provvedere ad una certa personalizzazione, è consigliabile eseguire questa installazione nell'albero locale, perché quando si aggiorna il sistema \TeX, vengono riscritti tutti i file degli alberi di sistema, ma non quelli dell'albero locale.
Non solo, ma il formato PDF/A richiede che sia specificato un profilo di colore; se il sistema non contenesse già il file indicato nella documentazione del pacchetto \textsf{pdfx}, si consiglia di scaricare dalla pagina di download del sito \texttt{www.eci.org} il file \texttt{ECI-RGB.V1.0.icc} e di modificare con questo nome le varie righe del file \texttt{pdfx.sty} che contengono il riferimento ad un file \texttt{icc} o \texttt{.icm} diverso.
Il file \texttt{pdfx.sty} carica anche il file \texttt{hyperref.sty} che permette di eseguire i link interni ed esterni del file PDF. Non è quindi possibile fare a meno di questo file; tuttavia, subito all'inizio del preambolo è possibile personalizzare le informazioni da inserire nel file PDF mediante i parametri dell'argomento del comando \verb|\hypersetup|; a titolo di esempio questo documento informativo è stato composto con questa personalizzazione:
\begin{verbatim}
\documentclass[12pt,twoside]{toptesi}
\hypersetup{%
pdfpagemode={UseOutlines},
bookmarksopen,
pdfstartview={FitH},
colorlinks,
linkcolor={blue},
citecolor={blue},
urlcolor={blue}
}
\usepackage[latin1]{inputenc}
...
\end{verbatim}
e, come si vede, la personalizzazione è stata eseguita subito dopo la dichiarazione di classe e prima di invocare altri pacchetti. Naturalmente la personalizzazione indicata è solo indicativa e riportata a titolo di esempio.
I \emph{metadata} di carattere generale sono inseriti nel file di uscita dall'azione diretta del file \texttt{pdfx.sty}; ma questo non può contenere i \emph{metadata} specifici del documento che si sta componendo; è necessario allora predisporre nella cartella dove risiede il file principale della tesi (quello sul quale opera l'eseguibile \texttt{pdflatex}) un file contenente i \emph{metadata} specifici, e che abbia estensione \texttt{xmpdata}. Per esempio, il file principale di questo documento si chiama \texttt{toptesi-doc.tex}: nella cartella dove risiede è stato creato il file \texttt{toptesi-doc.xmpdat} con il seguente contenuto:
\begin{verbatim}
\Author{Claudio Beccari}
\Title{La classe ToPtesi}
\Keywords{LaTeX</rdf:li><rdf:li>Tesi</rdf:li><rdf:li>PDF/A</rdf:li>%
<rdf:li>Dissertazione</rdf:li><rdf:li>Monografia}
\end{verbatim}
Questa operazione, evidentemente va ripetuta per ogni documento da produrre in formato PDF/A, e quindi bisogna predisporre un diverso file \texttt{.xmpdata} contenente le informazioni specifiche relative allo specifico documento.
Ricordate solo che il pacchetto \textsf{TOPtesi} non contiene nessuna verifica se state componendo con \texttt{pdflatex} oppure con il semplice \texttt{latex} o con qualche altro applicativo del sistema \TeX. Il concetto è che \emph{dovete} usare \texttt{pdflatex}.
Se esistono validi motivi per non usare \texttt{pdflatex} (ma è meglio che vi mettiate nelle condizioni di \emph{non usare} quei pacchetti che richiedano l'uso di comandi PostScript, come per esempio \textsf{PSTriks} o \textsf{XYpic}, ma di usare i pacchetti di grafica come \textsf{pgf} e il suo ambiente \texttt{tikz} che consento di fare quasi tutto quello che si può fare con gli altri pacchetti che richiedono il linguaggio PostScript), allora dovete usare il semplice \LaTeX, e poi convertire il file DVI ottenuto in un file PS; per la conversione in file PDF/A dovete poi usare \texttt{ghostscript}; per come fare dovete consultare il libretto \textit{Saper Comunicare -- Cenni di scrittura tecnico scientifica} e/o la documentazione di \texttt{ghostscript} (versione 8.61 o successiva) in particolare il file \texttt{ps2pdf.html}.
Ricordate solo che produrre un file PDF/A non è semplice, ma se usate \texttt{pdflatex} con i font di default, se incorporate solo figure PNG e JPEG con profilo di colore RGB (red, green, blue), se controllate che ogni file PDF da incorporare contenga al suo interno anche i font che eventualmente sono necessari per comporre il testo che contengono, non dovreste incontrare problemi di certificazione della natura PDF/A del file della vostra tesi.
\section{Pronti? Via!}
Ora siete pronti per comporre la vostra tesi o monografia o
dissertazione. Ricordate solo di non giocare con quei pochi
comandi di \LaTeX\ che permettono di fare pasticcetti alla
WYSIWYG; \LaTeX\ compone da solo benissimo; al massimo, alla fine,
quando tutto sarà finito e non sarà più necessario apportare
correzioni, potrete anche inserire qualche spazio fine positivo o
negativo per fare degli aggiustamenti di seconda o terza
approssimazione. Ricordatevi però che, anche se non c'è limite
al meglio (ma nemmeno al peggio!), \LaTeX\ lavora benissimo da
solo purché non lo si disturbi con interventi non professionali.
\section{I file accessori}
Il pacchetto \textsf{TOPtesi} contiene fra le sue parti il file
\texttt{topfront.sty} che può essere usato per comporre il solo
frontespizio. Esso in effetti, oltre a leggere il file di
configurazione contiene solo i comandi per definire gli elementi
del frontespizio e per comporlo. La cosa può tornare utile in
diverse circostanze, per esempio quando dovete ancora modificare
la tesi quasi ultimata, ma dovete cercare il o i relatori per far
loro firmare alcune copie del frontespizio.
Basta predisporre un piccolo file come questo, salvandolo con un nome a
piacere, per esempio, con grande fantasia, \texttt{myfile.tex}:
\begin{verbatim}
\documentclass{report}%%%% <--- Nota bene: la classe è report!
\usepackage[latin1]{inputenc}
\usepackage[italian]{babel}%%% ci vuole perché topfront ne fa uso
\usepackage{topfront}
\candidato{Mario Rossi}
\titolo{La mia tesi di laurea}
\relatore{Giovanni Bianchi}
\sedutadilaurea{Dicembre 2005}
\begin{document}
\frontespizio
\end{document}
\end{verbatim}
Passando questo piccolo file a \LaTeX\ o a pdf\LaTeX, si ottiene
un documento di una sola pagina, il frontespizio, che si può
stampare in varie copie per gli scopi detti sopra. Anche se componete il frontespizio in inglese, non potete fare a meno di chiamare \texttt{babel} perché \texttt{topfront} usa alcuni comandi di quel pacchetto. Naturalmente al posto di \texttt{italian} potete specificare un'altra lingua.
L'altro file accessorio \texttt{topcoman.sty} contiene diversi
utili comandi, alcuni già incorporati nella definizione della
lingua italiana del sistema \TeX. Tuttavia se dovete scrivere in
una lingua diversa dall'italiano quei comandi non sono
disponibili. Il file contiene anche un comando per la stampa in
pulito di un programma; ci sono altri pacchetti \LaTeX\ che
consentono di stampare il listato di un programma, ma visto che vi
può servire per la tesi e visto che una volta che lo conoscete vi
potrebbe piacere e poi vorreste continuare ad usarlo, è meglio
disporne come pacchetto separato. Non sarebbe difficile per
esempio stamparsi in pulito il listato del proprio programma
\texttt{myprogram.c}: si scrive semplicemente un file del tipo
\begin{verbatim}
\documentclass{report}%%%% <--- Nota bene: la classe è report!
\usepackage{topcoman}
\begin{document}
\chapter{Il programma myprogram.c}
\listing{myprogram.c}
\end{document}
\end{verbatim}
e lo si passa a \LaTeX\ o a pdf\LaTeX\ per ottenere poi una stampa
ben composta da conservare per documentazione; per evitare che le
righe sbordino fuori della larghezza normale del testo, o, peggio
ancora, fuori dalla carta, sarebbe opportuno che le righe del
programma non fossero più lunghe di una ottantina di caratteri.
\section{Come si comincia}
Non vi sto a dire niente di come si scriva una tesi; so per
esperienza che all'inizio ci si sente sperduti davanti allo
schermo vuoto. Ma voi studenti del Politecnico, e non solo del
Politecnico, potete scaricare dal portale della didattica del sito
del Politecnico \texttt{http://didattica.polito.it} l'opuscoletto
\emph{Saper Comunicare --- Cenni di scrittura tecnico-scientifica}
dove c'è scritto più o meno tutto quel che bisogna sapere per
impostare e scrivere un rapporto tecnico-scientifico qual è la
tesi, la monografia o la dissertazione.
Qui dirò solo come si comincia a scrivere il file sorgente della
tesi. Ci sono essenzialmente due vie, ognuna delle quali offre vantaggi e svantaggi, quindi non si può dire a priori quale via sia la più indicata:
\begin{enumerate}
\item si compone un unico file come esemplificato con il file \texttt{toptesi-example.tex} allegato alla documentazione di \textsf{TOPtesi}. Questo file permette di sperimentare diverse cose semplicemente mettendo o togliendo dei segni di commento all'inizio delle righe del preambolo che contengono alcuni comandi particolari. Esso è completo di bibliografia e quell'unico file permette di comporre una tesi completa; ovviamente può essere usato come modello per la vostra tesi; basta cambiare il contenuto dei comandi che contengono i nomi dei candidati, dei relatori, del titolo, dell'ateneo, della facoltà, eccetera. Ovviamente bisogna cambiare anche il contenuto dei capitoli.
\item Si spezza il file sorgente in un numero adeguato di file parziali da gestire come specificato qui di seguito; ogni file parziale conterrà solo una parte della tesi, per esempio un solo capitolo; siccome il tutto è gestito dal master file, ciascun file parziale non dovrà più contenere la dichiarazione della classe né il preambolo né le righe \verb|\begin{document}| e \verb|\end{document}|, ma solo il materiale relativo ad uno specifico capitolo cominciando appunto con la riga che ne specifica il titolo: \verb|\chapter{Il titolo di questo capitolo}|.
\end{enumerate}
Avendo già predisposto una scaletta da seguire per comporre la
tesi e avendo dato un nome a ciascun capitolo (nome un po' più
furbo di quelli che scriverò io qui a titolo di esempio),
predisponete un master file con un nome ``diverso'' da
\texttt{tesi.tex}; sbizzarrite la fantasia, ma che il nome sia
mnemonico e vi ricordi subito a che cosa vi riferite. Questo
master file sarà dunque composto così:
\begin{verbatim}
\documentclass[11pt]{toptesi}%% <--- Nota Bene: la classe è toptesi!
\ateneo{Università di Bengodi}
\nomeateneo{La Saggezza}
\titolo{Studi di tricotetratomia applicata}
\sottotitolo{Cosa succede quando si spacca un capello in quattro}
\candidata{Maria Chiomafolta}
\relatore{prof.\ Piero Scapigliati}
\sedutadilaurea{Maggio 2006}
\includeonly{%
preliminari,%
capitolo1,%
capitolo2,%
capitolo3,%
appendici,%
bibliografia%
}
\begin{document}
\include{preliminari}
\include{capitolo1}
\include{capitolo2}
\include{capitolo3}
\appendix
\include{appendici}
\include{bibliografia}
\end{document}
\end{verbatim}
È da osservare in particolare che l'aver scritto l'argomento di
\verb+\includeonly+ nel modo esemplificato sopra, permette di
inserire dei segni di commento all'inizio di alcune delle righe in
modo da eseguire, per esempio, la compilazione selettiva di un
solo capitolo conservando tutte le informazioni incrociate
relative agli altri capitoli già compilati. Con i PC di oggi la
compilazione è rapidissima, quindi non vi invito a seguire questa
procedura per risparmiare tempo di compilazione; faccio solo
notare che il fatto di tenere separate le varie parti della tesi
permette di lavorare con più ordine e di risparmiare non poco
tempo nella gestione dei vari file sorgente e nelle loro
correzioni.
Il file \texttt{preliminari.tex} conterrà presumibilmente il
comando per comporre il frontespizio, il sommario, molto
facoltativamente i ringraziamenti\footnote{I ringraziamenti in una
tesi sono necessari molto raramente, cioè quando bisogna
ringraziare una istituzione o una o più persone \emph{esterne}
alla propria università che hanno messo a disposizione le loro
strutture o le loro competenze per lo svolgimento della tesi. Non
si ringraziano genitori, fidanzati/e, amici, e tutti i parenti di
ogni grado, il quali saranno più che contenti di sapervi laureati,
piuttosto che non vedere il proprio nome scritto sulla tesi\dots.
Inoltre rappresenta un atto di piaggieria ringraziare il o i
propri relatori; essi hanno svolto un loro compito istituzionale,
non vi hanno fatto un piacere. Naturalmente questo non vieta che
la consuetudine del lavoro assieme non abbia dato origine a
sentimenti di reciproca stima e anche di amicizia, ma questa è
un'altra faccenda.} e gli indici.
Il file \texttt{capitolo1.tex} conterrà l'introduzione e in
pratica esporrà lo stato dell'arte oltre allo scopo del lavoro e
ai risultati che si vorrebbero ottenere.
I file \texttt{capitolo2.tex}, \texttt{capitolo3.tex}, eccetera,
conterranno la descrizione del lavoro svolto e l'analisi critica
dei risultati via via ottenuti; l'ultimo file prima delle
appendici conterrà le conclusioni.
Nelle varie appendici verranno raccolte le misure eseguite, gli
sviluppi matematici, i listati dei programmi, le note critiche, le
lunghe citazioni e tutte le altre cose che rovinerebbero la
fluidità del testo, se fossero inserite direttamente nel corpo
della tesi. La bibliografia conclude la tesi.
Alcuni laureandi desiderano mettere una dedica o delle citazioni nelle loro tesi; nelle versioni precedenti di questo pacchetto era necessario ricorrere all'opzione \texttt{classica}, ma ora questi ambienti, molto semplici, direi quasi rudimentali, sono accessibili a tutti i laureandi senza bisogno di specificare l'opzione \texttt{classica}.
Perché questi due piccoli ambienti sono rudimentali? Per consentire a ciascuno di scegliere i font che preferisce, la forma, la serie e il corpo; nell'ambiente \texttt{dedica} di default il corpo corrisponde alla dichiarazione \verb|\LARGE| e la forma alla dichiarazione \verb|\itshape|, ma nessuno vieta di iniziare la dedica specificando, per esempio:
\begin{verbatim}
\begin{dedica}
\normalfont \large\scshape
...
\end{dedica}
\end{verbatim}
Per l'ambiente \texttt{citazioni} non è stata preimpostata nessuna dichiarazione per i font, quindi l'utente è completamente responsabile della scelta dei font.
Entrambi gli ambienti sono realizzati con una composizione in bandiera, perché la giustezza è ridotta a metà di quella del testo, ma lil testo della dedica o delle citazioni è composto dentro una ``paginetta'' (\texttt{minipage}) collocata a due terzi dalla base della griglia di stampa a filo del margine esterno.
\subsection{La scelta della codifica per il file sorgente}
Si noti che per comporre i file del corpo della tesi si possono
usare direttamente le lettere accentate della tastiera italiana o
quelle che si possono ottenere con combinazioni di tasti sia sotto
Windows sia sotto Linux o Mac~OS~X; per default \textsf{TOPtesi}
non specifica nessuna particolare codifica dell'input; ma perché
\LaTeX\ elabori correttamente i file sorgente o non si specifica
nessuna particolare codifica ma si usano solo i caratteri ASCII a
7~bit, oppure si usano i caratteri nazionali direttamente da
tastiera ma si specifica la codifica che l'editor usato ha
impiegato per salvare nei file i codici dei caratteri non ASCII,
per esempio le lettere accentate; si suggerisce di specificare
esplicitamente la codifica mediante il comando
\begin{verbatim}
\usepackage[ansinew]{inputenc}
\end{verbatim}
per le macchine Windows; invece per le macchine Linux, UNIX e Mac~OS~X
suggerisco di specificare la codifica con
\begin{verbatim}
\usepackage[latin1]{inputenc}
\end{verbatim}
In particolare vanno accentate anche le lettere maiuscole; siccome la tastiera italiana non le prevede, consiglio di inserire nel preambolo la definizione del comando \verb|\E| per scrivere È. Credo che questa sia la maiuscola accentata più frequente in italiano e le altre non capitano mai all'inizio di un periodo. Il comando:
\begin{verbatim}
\newcommand*\E{\`E\space}
\end{verbatim}
inserisce direttamente una È all'inizio di un periodo e inserisce direttamente lo spazio successivo, per cui, senza inserire esplicitamente nessun comando di spaziatura dopo il comando \verb|\E|, si può scrivere semplicemente:
\begin{verbatim}
\E conveniente rilevare che\dots
\end{verbatim}
per ottenere:
\begin{quote}
È conveniente rilevare che\dots
\end{quote}
Se il vostro editor vi consente di selezionale le maiuscole accentate da una tabella oppure vi consente di usare combinazioni di tasti per inserire direttamente le maiuscole accentate nel file sorgente, fatene uso, perché la lettura del file sorgente ne guadagna moltissimo.
Per scrivere con in lingue dell'Europa orientale e, mi si dice, anche
in francese, sono migliori altre opzioni di codifica, ma per questo si
rinvia alla documentazione di \LaTeX.
Certo se il vostro editor lo prevede, e gli editor moderni lo prevedono, potete anche scegliere di codificare i vostri file \texttt{.tex} con la codifica UTF-8; questo, sempre se il vostro editor lo consente, vi permette di scrivere direttamente la vostra tesi inserendo anche delle parti con alfabeti diversi, tutti quelli che i vostri font di uscita vi consentono, dal greco al cirillico, per citare i più vicini a noi, fino al cinese o al giapponese. Ovviamente dovete caricare nel vostro preambolo tutto quello che è necessario per gestire quelle lingue, ma non chiedetemi come si fa, perché so dirvelo solo per il greco. Per questa lingua, se usate l'ortografica monotonika, basta inserire l'opzione della lingua \texttt{greek} fra le opzioni della classe; se usate l'ortografia polytonika, allora dovete richiedere lo specifico attributo seguendo questo procedimento:
\begin{verbatim}
\documentclass[...,greek,...]{toptesi}
...
\languageattribute{greek}{polutoniko}
\begin{document}
...
\end{document}
\end{verbatim}
Per una tesi che tratti il greco antico in forma filologica, consiglio l'uso del pacchetto \textsf{teubner}; visto che l'ho scritto io, un po' di réclame non guasta~\dots\ Bisogna però leggerne la documentazione con attenzione. In particolare conviene ricordare che \textsf{teubner} non viene installato se non è stato precedentemente specificata la lingua greca fra le opzioni, ma poi provvede da solo ad impostare l'attributo \texttt{polutoniko} e tutte le altre caratteristiche necessarie per comporre in greco con il \emph{mark-up} filologico.
Probabilmente per usare le lingue che si scrivono in cirillico, basta specificare l'opzione della lingua, come si fa per il greco. Per alcune altre lingue bisogna invece caricare l'apposito pacchetto, il quale provvede a tutte le impostazioni necessarie; in questi casi bisogna leggere con attenzione la documentazione di quei pacchetti.
Ma, tornando alla codifica UTF-8, il problema non è tanto l'editor che consenta o non consenta di usare quella codifica; quasi tutti i sistemi operativi consentono di installare diversi driver per la tastiera del PC, cosicché con un semplice click del mouse si può passare da un alfabeto all'altro; il problema sono i tasti della tastiera che hanno serigrafato sulla loro faccia il segno che si ottiene premendo quel tasto. Non è ovviamente possibile cambiare il disegno che appare sui tasti, semplicemente cliccando per cambiare driver; forse lo si può fare con le tastiere virtuali dei PC \emph{touch screen}, ma con i PC normali questo non è possibile. Ecco quindi che la difficoltà di scrivere con un alfabeto diverso richiede una memoria ferrea per ricordare a quale segno dell'altro alfabeto corrisponda il tasto della nostra tastiera. Per il greco moderno e classico, se si usano i font di default con la codifica LGR (Local GReek), che vengono installati praticamente con ogni installazione del sistema \TeX\ che non sia proprio una distribuzione essenziale, le corrispondenze con la tastiera latina sono studiate in modo da semplificare molto questo processo di ``memorizzazione''. Tuttavia ad una persona abituata a leggere il greco scritto (giustamente) in greco, vederlo scritto con caratteri latini fa un certo effetto; la documentazione di \textsf{babel} e quella di \textsf{teubner} ricordano questa corrispondenza fra i tasti latini e i segni greci (lettere, accenti, spiriti, segni speciali, ecc.). La corrispondenza fra greco e latino è abbastanza semplice perché il greco ha 24 maiuscole e 25 minuscole, mentre il latino ne ha 26 di ciscun tipo. Non so che cosa succeda con il cirillico che ha un alfabeto composto di più di 30 segni, per cui la corrispondenza con l'alfabeto latino è impossibile.
\subsection{La scelta della codifica per il file di uscita}
Solo per scrivere in inglese non è necessario specificare nessuna codifica per i font da usare per comporre la tesi; questo è vero in quanto l'inglese, fra le lingue più comuni nel mondo occidentale, è l'unico che non fa uso di accenti o altri segni diacritici. Perciò la codifica di default \texttt{OT1} per l'inglese va benissimo e non è necessario specificare nulla.
Invece con questa codifica la presenza di accenti impedisce la divisione in sillabe o ne riduce molto l'efficacia; per l'italiano il problema è relativamente modesto perché normalmente gli accenti compaiono solo sull'ultima vocale delle parole \emph{tronche}. Quindi con questa codifica la parola ``qualità'' viene divisa in ``qua-lità'' invece che in ``qua-li-tà''. Invece in francese una parola come ``électricité'' non viene divisa per niente a causa dell'accento sulla prima vocale.
Allora per tutte le lingue diverse dall'inglese è quanto mai opportuno specificare per i font di uscita la codifica \texttt{T1}. C'è però un problemino, facilmente risolubile, ma bisogna pensarci: i font di default usati da \LaTeX\ e pdf\LaTeX\ sono i font della collezione Computer Modern con codifica \texttt{OT1}; e ogni installazione del sistema \TeX\ li può usare sia nella versione ``bitmapped'' sia in quella PostScript Type~1. Quest'ultima dovrebbe essere quella da usare sempre con il formato PDF del file di uscita, perché questo formato è portabile da una macchina ad un'altra, indipendentemente dal sistema operativo usato. Se poi il file deve essere archiviato esso deve essere in formato PDF, quindi, di fatto non ci sono scelte.
I file della collezione Computer Modern con codifica \texttt{T1}, conosciuti anche come font EC, sono invece distribuiti solo nella forma bitmapped, la quale, oltre ad essere vietata nei file PDF archiviabili, si leggono molto male sullo schermo, se il programma di visualizzazione non è molto ben adattato ai font bitmapped. Esiste il pacchetto \textsf{cm-super} per ovviare a questo inconveniente, ma scaricare dalla rete questo pacchetto enorme richiede molto tempo e poi occupa molto spazio sul disco del vostro~PC. Per aggirare questi inconvenienti bisogna usare i font della collezione Latin Modern, normalmente preinstallati, per cui nel preambolo si specificherà:
\begin{verbatim}
\documentclass[...]{toptesi}
...
\usepackage[T1]{fontenc}
\usepackage{lmodern}
...
\begin{document}
...
\end{verbatim}
Naturalmente per gli utenti esperti di \LaTeX\ ci sono anche altri pacchetti usabili per impiegare altri font diversi da quelli della collezione Latin Modern, che comunque sono i migliori per la loro completezza; grazie al diverso disegno dei corpi minori la lettura dei pedici e degli apici ne risulta agevolata.
Qui segnalo solo la collezione dei font Times eXtendex, richiamabili con il pacchetto \textsf{txfonts}, e la collezione dei font Palatino eXtended, richiamabili con il pacchetto \textsf{pxfonts}. I Times sono font più stretti di quelli della collezione Latin Modern e sono forse indicati per rendere più compatta una tesi un po' voluminosa. I Palatino sono un po' più larghi dei font della collezione Latin Modern e allungano la tesi di qualche pagina.
Tanto per confronto, questo testo di documentazione su \textsf{TOPtesi} è composto con i font di default Computer Modern con codifica \texttt{OT1}; come si vede la divisione delle parole tronche in fin di riga è piuttosto rara e non si presentano inconvenienti particolari; forse con un testo di altro genere, con composizione in colonne strette o all'interno di tabelle, si potrebbe verificare la presenza di righe molto lasche, dove è stato allargato troppo lo spazio interparola. Per questo si consiglia sempre di usare la codifica \texttt{T1} anche per l'italiano; non si sa mai, ma certamente con questa codifica si hanno meno inconvenienti e le lettere accentate sono disegnate meglio\footnote{Questo testo è stato composto facendo uso anche del pacchetto \textsf{microtype}; con questo pacchetto si ottimizza la composizione delle righe di ogni capoverso allo scopo di ridurre al massimo le cesure in fin di riga (in questo testo di una sessantina di pagine, ci sono solo una decina di righe, escluse le tabelle, con la cesura in fin di riga) e di rendere il più omogenei possibile gli spazi interparola; se ne coniglia l'uso, ma certo si tratta di una \emph{raffinatezza}, non di una cosa necessaria. \textsf{microtype} produce gli effetti migliori quando si usano i font PostScript e il motore di composizione pdf\LaTeX.}.
\section{Come stampare la tesi}
Il pacchetto \textsf{TOPtesi} contiene anche l'opzione di composizione
\emph{in bianca e volta}, ma di default compone su una facciata sola
della pagina.
Qual è la differenza? È quella che si osserva nei libri composti
meglio, cioè nei libri con i fogli stampati davanti e di dietro:
quando il libro è aperto la striscia bianca formata dai due
margini interni delle pagine affacciate è circa uguale a ciascuno
dei margini esterni. Invece quando si stampa su una facciata sola
il corpo del testo è centrato e i margini laterali sono
uguali. Inoltre nelle testatine delle pagine stampate solo in
bianca compare sempre e solo il titolo del capitolo corrente,
mentre nelle testatine delle pagine \emph{pari} stampate in bianca
e volta compare il titolo del capitolo, mentre nelle pagine
\emph{dispari} compare il titolo del paragrafo con cui comincia la
pagina.
Molti laureandi ritengono di fare una cosa utile stampando fronte
e retro, o, come dicono i tipografi, in bianca e volta. Certamente
è una buona idea, sia perché il fascicolo della tesi viene ad
assumere un aspetto più professionale, sia perché, ecologicamente
parlando, si consuma meno carta.
Per questo ho cambiato le impostazioni di default della classe
\texttt{report}, sulla quale è basata la classe \texttt{toptesi},
per far sì che comunque la stampa della pagina, sia essa solo in
bianca o in bianca e volta, appaia sempre con i margini laterali
uguali.
Ho deciso per questa soluzione perché quando si rilega la tesi,
necessariamente dal lato della cucitura o dell'incollatura le
pagine sono piegate e l'insieme dei due margini interni delle
pagine affacciate appare visivamente più piccolo di ciascuno dei
margini esterni. Se si stampa solo in bianca invece sarebbe il
caso di aumentare il margine sinistro; tuttavia non ho realizzato
questo spostamento non solo perché il margine destro resta di una
certa ampiezza e può accogliere le note
marginali\marginpar{\footnotesize\sffamily Questa è una nota a
margine}, se si decide di farne uso, ma anche perché, almeno al
Politecnico di Torino, la copia da depositare nella segreteria di
facoltà non deve essere realizzata in carta, ma deve essere
registrata su un dischetto o su un CD-ROM in formato \texttt{.pdf}
(o in formato \texttt{.doc} se non si usa \LaTeX) e chi legge la
tesi sullo schermo preferisce senz'altro avere il testo centrato
piuttosto che spostato alternativamente da un lato o dall'altro
dello schermo.
Però questa soluzione potrebbe non piacere ad alcuni laureandi,
specialmente se compongono tesi piuttosto voluminose e/o se le
rilegano con una costola piuttosto rigida. In questo caso la
classe \texttt{toptesi} accetta l'opzione \texttt{cucitura}
mediante la quale le facciate di sinistra e di destra vengono
spostate all'esterno di quasi un centimetro, precisamente di
7\,mm, per compensare la rigidezza della cucitura e la forte
curvatura delle pagine causate dallo spessore e/o dal tipo di
rilegatura. Questo implica che la copia da memorizzare sul CD-ROM
o sul dischetto dovrà essere compilata senza specificare questa
opzione, che invece sarà specificata per ricomporre il file prima
della stampa su carta.
\section{Comporre la tesi in diverse lingue}
Il pacchetto \textsf{TOPtesi} usa di default il pacchetto
\texttt{babel} per gestire la composizione in diverse lingue.
Tuttavia la composizione in lingue diverse dall'inglese (che è la
lingua di default per una installazione ``vergine'' del sistema
\TeX) richiede che il sistema sia configurato per gestire diverse
lingue; perciò le operazioni da fare sono essenzialmente due:
\begin{enumerate}
\item configurare il sistema \TeX\ per gestire diverse lingue;
\item specificare nel comando di apertura del master file di quali altre
lingue ci si vuole servire \textcolor{red}{oltre all'italiano e all'inglese che sono già automaticamente invocati da \textsf{TOPtesi}}. Si ricorda che non si può più invocare nel preambolo il pacchetto \textsf{babel} per la gestione delle lingue una seconda volta, quando esso è già stato invocato una prima volta nel corpo della classe. Si veda nel seguito come bisogna specificare le ulteriori lingue oltre all'italiano e all'inglese.
\end{enumerate}
\subsection{Configurazione iniziale}
Per la prima parte, cioè per configurare il sistema \TeX\ per
gestire diverse lingue, subito dopo l'installazione lanciate
\LaTeX\ su un file di prova qualunque, per esempio
\texttt{sample.tex}, poi apritene il file \texttt{.log},
nell'esempio \texttt{sample.log}; nelle prime righe di questo file
troverete le lingue per le quali il vostro sistema già
configurato.
Per esempio scrivendo questo file di documentazione il file
\texttt{toptesi-doc.log} contiene nelle prime righe quanto segue:
\begin{verbatim}
This is pdfTeX, Version 3.1415926-1.40.10 (TeX Live 2009)
(format=pdflatex 2009.11.13) 10 MAY 2010 10:37
entering extended mode
\write18 enabled.
%&-line parsing enabled.
**toptesi-doc.tex
(./toptesi-doc.tex
LaTeX2e <2009/09/24>
Babel <v3.8l> and hyphenation patterns for english, usenglishmax,
dumylang, nohyphenation, german-x-2009-06-19, ngerman-x-2009-06-19,
ancientgreek, ibycus, arabic, basque, bohairic, bulgarian, catalan,
pinyin, coptic, croatian, czech, danish, dutch, esperanto, estonian,
farsi, finnish, french, galician, german, ngerman, monogreek, greek,
hungarian, icelandic, indonesian, interlingua, irish, italian,
kurmanji, latin, latvian, lithuanian, mongolian, mongolian2a, bokmal,
nynorsk, polish, portuguese, romanian, russian, sanskrit, serbian,
slovak, slovenian, spanish, swedish, turkish, ukenglish, ukrainian,
uppersorbian, welsh, loaded.
\end{verbatim}
Chiaramente la mia non è una configurazione di default, ma serve
per dare una idea di quello che contengono le prime righe del file
in questione. Se, come è possibile, dopo la prima installazione
il vostro primo file \texttt{.log} non contiene fra le lingue
elencate anche l'italiano, allora questa è la cosa più urgente da
fare; non vorrete mica che la vostra tesi, scritta in italiano,
abbia le parole divise in sillabe in fin di riga con le regole
angloamericane? Se poi siete su un programma di doppia laurea e
dovete scrivere parte della tesi nella lingua dell'università
straniera di cui prendete l'altro titolo, allora è necessario
avere disponibile almeno anche quella lingua.
Le regole per inizializzare le lingue gestibili differiscono da
distribuzione a distribuzione del sistema \TeX. Leggete quindi la
documentazione che accompagna la vostra distribuzione; qui darò
alcuni cenni relativi alle distribuzioni che io conosco.
\subsubsection{MiK\TeX}
Questa distribuzione nella sua versione completa è in grado di gestire tutte le lingue che il sistema \TeX\ conosce, quindi non c'è bisogno di nessuna configurazione ulteriore.
\subsubsection{teTeX e Debian teTeX }
La distribuzione \texttt{teTeX} non viene più aggiornata da quando esiste \TeX\-live; mi risulta che venga ancora distribuita da alcuni sistemi Linux basati su Debian; per esempio Slackware.
Tuttavia, sempre per mia esperienza, ho installato \TeX\-live sulla mia versione Debian di Ubuntu e non ho avuto nessunissimo problema; la distribuzione \TeX\-live è sempre veramente aggiornata in tempo praticamente reale e il suo ``package manager'' consente l'aggiornamento continuo, indipendentemente dalle ``uscite'' annuali di \TeX\-live; mi permetterei di consigliare di non usare \texttt{teTeX} nemmeno nella versione Debian, ma non vorrei passare per un iconoclasta di quella gloriosa distribuzione.
\subsubsection{\TeX-live}
La distribuzione \TeX-live nasce già configurata per tutte le lingue che \LaTeX\ è capace di gestire, quindi anche l'italiano; bisogna ricorrere ai suoi comandi di configurazione solo se si vuole aggiungere una lingua la cui sillabazione non sia distribuita insieme a \TeX\-live. Questo evento è talmente raro che non vale la pena di insistervi sopra. Tuttavia un laureando che svolga la sua tesi sull'ostrogoto altomedievale e disponesse solo della sillabazione per l'ostrogoto classico e per l'ostrogoto contemporaneo, si troverebbe in difficoltà; infatti, prima ancora di inserire le regole per l'ostrogoto altomedievale, dovrebbe scriversi le regole di sillabazione e codificarle nel linguaggio specifico richiesto dal sistema \TeX; questo è tutt'altro che facile ed è riservato a specialisti molto avanzati.
\subsubsection{Mac\TeX}
Dal 2007 la distribuzione di \texttt{Mac\TeX} sostanzialmente coincide con\TeX-live, salvo che contiene anche programmi accessori specifici per le macchine Macintosh; è preconfigurato per gestire tutte le lingue di cui il sistema è capace, compreso l'italiano.
\subsubsection{Distribuzioni commerciali}
Le distribuzioni commerciali differiscono da quelle gratuite
essenzialmente per i programmi accessori che accompagnano la
distribuzione del sistema \TeX\ che, di sua natura, è gratuito;
il costo delle distribuzioni commerciali corrisponde al valore
delle parti accessorie, all'assistenza per i clienti, eccetera.
Fra le parti accessorie in generale ci sono anche i programmi
realizzati attraverso comode interfacce grafiche per la
inizializzazione e l'aggiornamento del software.
Perciò con queste distribuzioni bisogna leggere il manuale di
istruzioni e provvedere corrispondentemente.
\subsection{Le lingue della tesi}
Di default \textsf{TOPtesi} compone la tesi in italiano e per scrivere
la tesi in italiano non occorre altro.
Se si devono inserire nella tesi brani di testo in lingua
straniera, ma lasciando la struttura della tesi in italiano, basta
elencare i nomi (inglesi) delle lingue da usare nel comando di
apertura del master file fra le altre opzioni; per esempio, per
inserire brani in francese si scriverà:
\begin{verbatim}
\documentclass[12pt,twoside,french]{toptesi}
\end{verbatim}
Se invece si vuole scrivere la tesi in inglese, lingua già
inserita di default in \textsf{TOPtesi}, ma non attivata, bisogna
dare l'indicazione esplicita dopo l'inizio del documento così:
\begin{verbatim}
\documentclass[11pt,cucitura]{toptesi}
...
\begin{document}
\english
...
\end{verbatim}
Per commutare dall'italiano all'inglese e viceversa basta
alternare le dichiarazioni \verb|\italiano| e \verb|\english|.
Attenzione: queste dichiarazioni alterano anche le parole come
Chapter o Capitolo, Table o Tabella, quindi per inserire brani
nell'altra lingua è opportuno servirsi dei comandi di
\texttt{babel}, in particolare l'ambiente \texttt{otherlanguage},
per esempio:
\begin{verbatim}
... disse:
``\begin{otherlanguage}{english}
Mr Livingstone, I suppose\dots
\end{otherlanguage}''
e si strinsero la mano.
\end{verbatim}
L'ambiente \texttt{otherlanguage} è adatto per citazioni
relativamente lunghe; per citazioni brevi, come quella dell'esempio,
sarebbe meglio usare così il comando \verb|\foreignlanguage|:
\begin{verbatim}
disse: ``\foreignlanguage{english}{Mr Livingstone, I suppose\dots}''
e si strinsero la mano.
\end{verbatim}
Invece per comporre la tesi in una lingua diversa dall'italiano e
dall'inglese bisogna lavorare un pochino di più perché bisogna
ridefinire alcune cose; per esempio per scrivere la tesi in
spagnolo bisogna agire così:
\begin{verbatim}
\documentclass[12pt,spanish]{toptesi}% <--- la lingua come opzione
% della classe!
\ExtendCaptions{spanish}{Resumen}{Agradecimientos}
\newcommand*{\spagnolo}{\selectlanguage{spanish}}%
...
\begin{document}
\spagnolo
...
\end{document}
\end{verbatim}
Ovviamente le parole ``Resumen'' (Sommario) e ``Agradecimientos'' (Ringraziamenti) andranno scelte accuratamente; io ho indicato solo ciò che ho trovato sul vocabolario.
È anche possibile servirsi del file di configurazione; per esempio le
definizioni dei comandi suddetti possono venire scritte nel file di
configurazione e alternando i comandi \verb|\italiano|, \verb|\english|
e \verb|\spagnolo| si possono alternare le regole di sillabazione oltre a cambiare le parole \emph{infix}, come Chapter, Capitolo, Capítulo, eccetera.
Per scrivere in lingue che implicano alfabeti diversi da quello
latino, ovviamente, bisogna aver curato di disporre di una
configurazione del sistema \TeX\ completa anche dei font che
servono. Non dovrebbero esserci problemi con il cirillico e con il
greco; per altri alfabeti e per le lingue che si scrivono da
destra a sinistra bisogna ovviamente disporre dei pacchetti
necessari. Si tenga presente che le versioni moderne del sistema
\TeX\ \emph{non} usano come interprete il programma originario di Knuth,
ma una la sua estensione che in origine si chiamava $\varepsilon$\TeX; la variante
che produce il file del documento composto in formato
\texttt{.pdf} si chiama \texttt{pdftex}, come appare evidente
dalle prime righe del file \texttt{.log} di questo documento, ma questa versione comprende tutte le estensioni di $\varepsilon$\TeX.
Bene, queste estensioni servono anche per gestire le lingue
con scrittura retrograda pur di disporre dei pacchetti relativi a queste lingue.
\chapter{I comandi specifici introdotti da \textsf{TOPtesi}}
\section{Introduzione}
I comandi specifici introdotti da \textsf{TOPtesi} si aggiungono a
tutti quelli definiti da \LaTeX\ e dalla sua classe standard
\texttt{report}; mentre questi sono tutti in inglese o sono
abbreviazioni inglesi, i comandi introdotti da \textsf{TOPtesi} sono
quasi tutti in italiano o sono abbreviazioni italiane.
Questi comandi sono di diverse categorie; alcuni si possono usare solo
in modo matematico altri solo in modo testo; alcuni solo nel preambolo,
alcuni hanno senso solo durante la composizione del testo; alcuni
servono solo per il frontespizio. Essi saranno descritti nei paragrafi
seguenti.
\section{Le opzioni}
La classe \texttt{toptesi} accetta diverse opzioni nel
comando di di dichiarazione della classe; negli esempi esposti ne sono
state usate diverse, ma qui forse vale la pena di elencarle tutte
in ordine, senza ripetere le opzioni già presenti di default per
la classe \texttt{report}.
\begin{description}\def\Item[#1]{\item[\normalfont\texttt{#1}]}
\Item[chapterbib] serve per specificare che si desidera la composizione della bibliografia alla fine di ogni capitolo; la bibliografia va composta a mano; se si desidera comporla con \textsc{Bib\TeX} si invochi invece il pacchetto \texttt{chapterbib.sty} con il solito comando \verb|\usepackage|. Si abbia cura di leggere attentamente la documentazione di quel pacchetto.
%
\Item[classica] Serve per usare delle denominazioni un po' diverse
dei comandi e per dare una forma diversa al loro contenuto; il
frontespizio ne viene un poco modificato con un look più adatto
alle tesi in discipline classiche. Si veda la
tabella~\ref{tab:front5} per i nuovi comandi disponibili.
%
\Item[cucitura] Serve per spostare il testo scritto verso l'esterno
quando si teme che la piegatura delle pagine verso il centro del
fascicolo rilegato possa impedire la lettura agevole delle parole
vicino al margine interno.
%
\Item[14pt] Aumenta la possibilità di scelta del corpo normale per
la composizione della tesi; può contribuire a migliorare la
lettura quando il testo è fitto di notazioni molto articolate, ma in
generale il corpo così grande è un trucco per rimpolpare una
tesi di modeste dimensioni; ne sconsiglio l'uso per questo secondo
scopo. Avverto che con un corpo così grande è facile che certe
righe risultino troppo lunghe e vadano a capo in punti non
adeguati e producano delle righe non giustificate con i messaggi
d'errore ``Overfull hbox''; questo è un altro motivo per il quale
sconsiglio di usare questa opzione, se non quando è strettamente
necessario. Se la si usa, si verifichi che il titolo, i titoli dei
capitoli, quelli dei paragrafi, eccetera siano composti
correttamente. In particolare il titolo della tesi e i titoli dei
capitoli possono andare a capo solo prima di articoli,
preposizioni semplici o articolate, congiunzioni e brevi avverbi
come ``non''; per evitare di andare a capo dopo queste parti del
titolo si abbia l'accortezza di inserire il segno di legame
\verb|~| fra queste brevi parole e le parole seguenti; per
esempio, il titolo della tesi fornita come modello va scritto
nella forma \verb|La~pressione barometrica di~Giove|.
%
\Item[autoretitolo] Questa opzione funziona solo se viene
specificata anche l'opzione \texttt{classica}; se la si inserisce
senza specificare \texttt{classica}, non succede nulla di male,
semplicemente la classe informa di aver trovato delle opzioni che
né lei né altri pacchetti hanno usato. Serve per comporre la
testatina di sinistra sulle pagine pari con l'indicazione del
candidato e del titolo della tesi. È ovvio che il titolo della
tesi con questa opzione deve essere molto breve, ed è per questo
che è stato messo a disposizione dello studente l'argomento
facoltativo del comando \verb|\titolo| che consente di specificare
un titolo di tre o quattro parole (brevi) ma di senso compiuto,
che possa sostituire il titolo normale, specialmente se questo è
un po' lungo.
%
\Item[oldstyle] Anche questa opzione funziona solamente insieme
all'opzione \texttt{classica}; serve per scrivere i numeri delle
pagine con i numeri all'antica, cioè con segni di altezze e
profondità diverse; si confronti \oldstylenums{1234567890} con
1234567890.
%
\Item[pdfa] Serve per attivare la composizione di un file PDF che possa passare la verifica per la certificazione del formato PDF/A. Attenzione: si ricorda che questa operazione viene eseguita tramite l'uso del file \texttt{pdfx.sty} che a sua volta richiama il file \texttt{hyperref.sty} con la giusta opzione per il formato PDF/A. Eventuali personalizzazioni per configurare gli stili di composizione dei link generati da \texttt{hyperref.sty} devono essere dichiarate subito dopo la dichiarazione della classe. Se si specificano queste personalizzazioni, ma non è stata data l'opzione \texttt{pdfa}, viene prodotto un errore terminale. Inoltre bisogna ricordarsi di predisporre il file \texttt{.xmpdata} contenente i \emph{metadata} relativi al documento specifico come si è già spiegato in precedenza.
\end{description}
\section{Comandi di tipo generale}
I comandi di tipo generale si possono usare in ogni contesto, in
particolare alcuni sono fatti per essere usati sia in modo testo sia in
modo matematico. Essi sono raccolti nella tabella~\ref{tab:generale}.
\begin{table}\def\V{\rule{0pt}{2.5ex}}
\def\cs#1{\texttt{\string#1}}
\centering \footnotesize
\begin{tabular}{llp{.3\textwidth}p{.3\textwidth}}
\hline
Comando\V & Default & Scopo & Esempio d'uso \\[.5ex]
\hline
\cs{\interlinea\string{\dots\string}} &
1.0 & Modifica l'argomento di
\cs{\linespread}\newline \textcolor{red}{NON usare se non costretti con la forza!}\newline Modo testo &
\cs{\interlinea\string{1.05\string}} \newline
oppure \newline
\cs{\begin\string{interlinea\string}\string{1.05\string}} \newline
\dots\newline
\cs{\end\string{interlinea\string}}\newline
Vedi annotazioni sull'interlinea nel testo\\
\cs{\ohm} & & Omega ``diritto''\newline
Modi testo e matematico & \texttt{45\string\ohm}\\
\cs{\ped\string{...\string}}&
nessuno & Pedice in tondo\newline
Modi testo e matematico & \texttt{\string$V\string\ped\string{eff\string}\string$} \\
\cs{\unit\string{...\string}}&
nessuno & Unità di misura in
tondo unite al numero\newline
Modi testo e matematico &
\texttt{15\string\unit\string{k\string\ohm\string}} \\
\cs{\gei} & & Unità immaginaria in
tondo \newline
Solo modo matematico &
\texttt{\string$\string\eu\string^\string{\string\gei\string\omega\ t\string}\string$} \\
\cs{\eu} & & Numero ``e'' in tondo\newline Solo modo matematico &
\texttt{\string$\string\eu\string^\string{\string\gei\string\omega\ t\string}\string$} \\
\cs{\gradi} & & circoletto alzato\newline Modo testo e %!TEX encoding =
matematico &
\texttt{27\string\unit\string{\string\gradi\ C\string}} \\
\cs{\listing\string{...\string}}&
nessuno & Listato di un programma in caratteri typewriter &
\texttt{\string\listing\string{toptesi.tex\string}}\\[.5ex]
\hline
\end{tabular}
\caption{Comandi di tipo generale}\label{tab:generale}
\end{table}
Vale la pena di commentare sull'uso dell'ambiente \texttt{interlinea} e/o del comando \texttt{\string\interlinea}.
Il primo confina il suo effetto all'interno dell'ambiente da lui
stesso formato; il secondo agisce come una dichiarazione che resta
in vigore finché una dichiarazione contraria non ne modifica il
valore.
\textcolor{red}{Tuttavia sia l'ambiente sia il comando non dovrebbero essere mai usati!}
La composizione tipografica non ha nulla a che vedere con la
composizione dattilografica (\emph{absit iniuria verbis}!).
Quest'ultima si faceva con mezzi avanzati per l'epoca, ma oggi quei
mezzi sono del tutto obsoleti; le poche macchine da scrivere
meccaniche o elettromeccaniche che esistono ancora fuori da qualche
museo, vengono usate per riempire formulari o compilare le informazioni
sui documenti cartacei che sopravvivono alla invasione delle carte
plastificate; forse qualche ufficio di notaio fa ancora uso di quelle
macchine; ma tolti gli usi burocratici non mi viene in mente nessun
altro uso degno di essere citato.
La composizione tipografica esige un perfetto equilibrio fra il
corpo del font usato e la distanza fra due righe successive,
distanza che prende il nome tecnico di \emph{avanzamento di riga};
questo avanzamento a seconda del font in uso può essere dal 10\%
al 20\% maggiore del corpo del font usato.
Questa documentazione è scritta in corpo 12\,pt e l'avanzamento
di riga è di 14,5\,pt; si dice che questo testo è composto in
corpo 12/14,5.
\begin{interlinea}{1.05}
L'interlinea era originariamente lo spazio aggiuntivo da inserire
fra una linea e l'altra; quando la composizione tipografica era
eseguita con font ricavati da punzoni metallici, l'interlinea era
la striscia di metallo che veniva interposta fra una riga di
caratteri metallici e la successiva. Il comando
\texttt{\string\interlinea} e l'ambiente corrispondente hanno
pertanto dei nomi che si rifanno alla tipografia tradizionale, ma
vengono usati come in dattilografia. In effetti l'argomento del
comando e dell'ambiente serve solo come fattore moltiplicativo
dell'avanzamento di riga; porre questo fattore al valore
\texttt{1.05} vuol dire moltiplicare l'avanzamento di riga per
1,05 portandolo quindi al valore di 15,5225\,pt. Questo capoverso
è composto con questo fattore impostato con l'ambiente
\texttt{interlinea} e, nonostante si tratti solo di un aumento del
5\% dell'avanzamento di riga, l'occhio lo percepisce in modo più
grande di quanto non faccia pensare il suo piccolo valore.
\end{interlinea}
L'avanzamento di default scelto per i caratteri in uso è
l'avanzamento otticamente ottimale; se desideraste usare un font
diverso da quello di default, potreste, per esempio, invocare il
pacchetto \texttt{pxfonts} per usare il Palatino esteso come font
di testo. Siccome questo font a pari corpo ha le minuscole
decisamente più grandi di quelle dei font di default, potrebbe
essere una idea sensata quello di sperimentare con diversi valori
del fattore di \texttt{interlinea}, ma poi si scoprirebbe che
questo fattore differirebbe di pochi centesimi dall'unità e quindi
ci sarebbe da domandarsi se ne valga la pena.
Se proprio volete stampare delle bozze su carta scritte abbastanza
larghe per potervi inserire le correzioni e le annotazioni a mano,
allora impostate il fattore di \texttt{interlinea} al massimo a
\texttt{1.5}, ma quando stampate la bella copia, la versione finale,
ricordatevi di re-impostare per \texttt{interlinea} il valore unitario
di default.
Tra l'altro non vorreste mica usare l'espediente di un grande fattore
di interlinea solo per rimpolpare una tesi dal volume modesto? Esso
sarebbe un espediente talmente puerile che sarebbe scoperto al primo
sguardo. Ricordate che ci sono state in passato tesi che non superavano
le 30~pagine dattiloscritte o scritte a mano (!) e sulle quali si sta
studiando ancora oggi dopo più di 50~anni!
\section{Comandi per il frontespizio}
I comandi per la composizione del frontespizio debbono essere
tutti inseriti nel preambolo, cioè prima di
\verb|\begin{document}|.
\begin {table}[p]
\def\V{\rule{0pt}{2.5ex}}
\def\cs#1{\texttt{\string#1}}\let\s\string
\def\d{\discretionary{\%}{}{}}
\makebox[\textwidth]{%
\begin {tabular}{p{.3\textwidth}p{.2\textwidth}p{.2\textwidth}p{.25\textwidth}}
\hline
Comando\V & Default & Scopo & Esempio d'uso \\[.5ex]
\hline
\cs{\ateneo\s{...\s}}\V&POLITECNICO DI TORINO& Definisce il nome generico dell'Ateneo &
\cs{\ateneo\{II Università di Roma\}} \\
\cs{\nomeateneo\s{...\s}}& nessuno& Definisce il nome proprio dell'Ateneo &
\cs{\nomeateneo\{Tor Vergata\}} \\
\cs{\facolta[...]\s{...\s}}& Ingegneria& Definisce il nome della
Facoltà opzionalmente con l'indicazione dell'ordinale&
\cs{\facolta[III]\d\{Scienze\}} \\
\cs{\corsodilaurea\s{...\s}}& nessuno& Definire il nome del corso di laurea &
\cs{\corsodilaurea\d\{Fisica\}} \\
\cs{\corsodidottorato\{...\}}& nessuno&Definisce il nome del corso di dottorato&
\cs{\corsodidottorato\d\{Fisica\}} \\
\cs{\monografia\{...\}}&nessuno&Definisce il titolo della monografia e imposta lo stile del frontespizio&
\cs{\monografia\d\{Il~teorema di Eulero\}}\\
\cs{\titolo[...]\{...\}}&nessuno&Definisce il titolo della tesi o della dissertazione&
\cs{\titolo\d[La~pressione]\d\{La~pressione di Giove\}}\\
\cs{\sottotitolo\{...\}}&nessuno&Definisce il sottotitolo della tesi o della dissertazione&
\cs{\sottotitolo\{Metodo Barometrico\}} \\
\cs{\Materia\{...\}}&nessuno&Definisce la materia su cui verte la tesi &
\cs{\Materia\{Remote Sensing\}} \\
\cs{\materia\{...\}}&nessuno&sinonimo di \cs{\Materia} &
\cs{\materia\d\{Letteratura ostrogota\}} \\[.5ex]
\hline
\end{tabular}}
\caption{Comandi per il frontespizio della monografia di laurea, della
tesi di laurea e della dissertazione di dottorato
(\emph{continua})}\label{tab:front1}
\end{table}
\addtocounter{table}{-1}
\begin{table}[p]
\def\V{\rule{0pt}{2.5ex}}
\def\cs#1{\texttt{\string#1}}\let\s\string
\def\d{\discretionary{\%}{}{}}
\makebox[\textwidth]{%
\begin {tabular}{p{.3\textwidth}p{.2\textwidth}p{.2\textwidth}p{.25\textwidth}}
\hline
Comando\V & Default & Scopo & Esempio d'uso \\[.5ex]
\hline
\cs{\relatore\{...\}}\V&nessuno& Definisce il nome del relatore&
\cs{\relatore\d\{prof.\s~Albert Einstein\}} \\
\cs{\secondorelatore\{...\}}&nessuno&Se c'è, definisce il nome del secondo relatore&
\cs{\secondorelatore\d\{dott.\s~Grazia Deledda\}}\\
\cs{\terzorelatore\{...\}}&nessuno&Se c' è, definisce il nome del
terzo relatore&
\cs{\terzorelatore\d\{ing.\s~Thomas A.\s~Edison\}}\\
\cs{\direttore\{...\}}&nessuno&Definisce il nome del direttore del ciclo di dottorato&
\cs{\direttore\d\{prof.\s~Albert Enstein\}}\\
\cs{\coordinatore\{...\}}&nessuno&Definisce il nome del coordinatore del ciclo di dottorato&
\cs{\coordinatore\d\{prof.\s~Albert Einstein\}}\\
\cs{\tutore\{...\}}&nessuno&Definisce il nome del tutore&
\cs{\tutore\d\{prof.\s~Karl Von Braun\}} \\
\cs{\candidato\{...\}}&nessuno&Definisce il nome del candidato&
\cs{\candidato\{Galileo Galilei\}} \\
\cs{\candidata\{...\}}&nessuno&Definisce il nome della candidata&
\cs{\candidata\{Maria Curie\}} \\
\cs{\secondocandidato\{...\}}&nessuno&Se c'è , definisce il nome
del secondo candidato&
\cs{\secondocandidato\d\{Evangelista Torricelli\}}\\
\cs{\secondacandidata\{...\}}&nessuno&Se c'è , definisce il nome
della seconda candidata&
\cs{\secondacandidata\d\{Rita Levi Montalcini\}}\\
\cs{\terzocandidato\{...\}}&nessuno& Se c'è, definisce il nome del
terzo candidato&
\cs{\terzocandidato\d\{Alessandro Volta\}} \\
\cs{\terzacandidata\{...\}}&nessuno&Se c'è, definisce il nome della terza candidata&
\cs{\terzacandidata\d\{Eleonora Duse\}}\\[.5ex]
\hline
\end{tabular}}
\caption{Comandi per il frontespizio della monografia di laurea, della
tesi di laurea e della dissertazione di dottorato (\emph{continua})}\label{tab:front2}
\end{table}
\addtocounter{table}{-1}
\begin{table}
\def\V{\rule{0pt}{2.5ex}}
\def\cs#1{\texttt{\string#1}}\let\s\string
\def\d{\discretionary{\%}{}{}}
\makebox[\textwidth]{%
\begin {tabular}{p{.3\textwidth}p{.2\textwidth}p{.2\textwidth}p{.25\textwidth}}
\hline
Comando\V & Default & Scopo & Esempio d'uso \\[.5ex]
\hline
\cs{\sedutadilaurea\{...\}}\V&data corrente &Definisce il mese e l'anno (volendo il giorno) della seduta di laurea&
\cs{\sedutadilaurea\d{Dicembre~2005}}\\
\cs{\esamedidottorato\{...\}}&data corrente&Definisce il mese e l'anno (volendo il giorno) della seduta di discussione&
\cs{\esamedidottorato\d\{Febbraio~2003\}}\\
\cs{\ciclodidottorato\{...\}}&nessuno&Definisce il numero ordinale del ciclo di dottorato&
\cs{\ciclodidottorato\d\{XV~ciclo\}} \\
\cs{\logosede\{...\}}&nessuno&Inserisce nel frontespizio il logo dell'ateneo&
\cs{\logosede\d\{logopolito\}}\\[.5ex]
\hline
\end{tabular}}
\caption{Comandi per il frontespizio della monografia di laurea, della
tesi di laurea e della dissertazione di dottorato}\label{tab:front3}
\end{table}
\begin{table}[p]
\def\V{\rule{0pt}{2.5ex}}
\def\cs#1{\texttt{\string#1}}\let\s\string
\def\d{\discretionary{\%}{}{}}
\def\serve{definisce una stringa equivalente a }
\makebox[\textwidth]{\small%
\begin{tabular}{@{}p{.35\textwidth}p{.65\textwidth}@{}}
\hline
\cs{\FacoltaDi\{...\}}\V & \serve ``Facoltà di'' prima del nome della facoltà \\
\cs{\DottoratoIn\{...\}} & \serve ``Dottorato in'' prima del nome del dottorato\\
\cs{\CorsoDiLaureaIn\{...\}} & \serve ``Corso di Laurea in'' prima del nome del corso di laurea\\
\cs{\TesiDiLaurea\{...\}} & \serve ``Tesi di Laurea''\\
\cs{\NomeMonografia\{...\}} & \serve ``Monografia di Laurea''\\
\cs{\NomeDissertazione\{...\}} & \serve ``Dissertazione di Dottorato''\\
\cs{\InName\{...\}} & \serve ``in''; in tedesco potrebbe essere ``auf'', in francese ``en'', ecc.\\
\cs{\CandidateName\{...\}} & \serve ``Candidato''; per questo e i due comandi successivi il programma riesce
a scegliere la stringa giusta adattata in numero e genere; nel cambiare queste stringhe
il compositore ha una sola possibilità e deve scegliere direttamente il genere e il numero.\\
\cs{\AdvisorName\{...\}} & \serve ``Relatore''\\
\cs{\CoAdvisorName\{...\}} & \serve ``Correlatore''; questo comando si può usare sempre, ma il suo contenuto viene effettivamente usato solo se si specifica l'opzione \texttt{classica}; se in italiano non piace ``Correlatore'' ma si preferisce ``Corelatore'' o ``Co-relatore'', sempre con l'opzione \texttt{classica}, si può correggere la versione di default.\\
\cs{\TutorName\{...\}} & \serve ``Tutore''\\
\cs{\NomeTutoreAziendale\{...\}}& \serve ``Supervisore aziendale''; usando un argomento che contenga anche
indicazioni di ``a capo'', nella seconda riga si può scrivere il nome dell'azienda.\\
\cs{\CycleName\{...\}} & \serve ``ciclo''; serve essenzialmente per indicare il ciclo di dottorato\\
\cs{\NomePrimoTomo\{...\}} & \serve ``Tomo primo''\\
\cs{\NomeSecondoTomo\{...\}} & \serve ``Tomo secondo''\\
\cs{\NomeTerzoTomo\{...\}} & \serve ``Tomo terzo''\\
\cs{\NomeQuartoTomo\{...\}} & \serve ``Tomo quarto''; tutte e quattro queste stringhe dipendono dalla lingua
usata e dall'ordine che si vuole o si deve dare alle due parole.\\[.5ex]
\hline
\end{tabular}}
\caption{Comandi per modificare le parole e/o le brevi frasi scritte
nel frontespizio o per cambiare le parole italiane di default in altre
parole diverse, o per esprimere gli stessi concetti in un'altra
lingua}\label{tab:front4}
\end{table}
I comandi di questa sezione possono essere introdotti in un
ordine qualunque, ma è più chiaro se sono introdotti nell'ordine
in cui sono elencati.
Essi possono anche essere scritti nel file di configurazione
\texttt{toptesi.cfg}, anzi, direi che è meglio che siano inseriti
in quel file, lasciando nel preambolo solo quelli che cambiano i
valori di default o che inseriscono informazioni non presenti di
default.
Alcuni comandi sono generali; altri si riferiscono specificatamente
alla monografia di laurea, alla tesi laurea, o alla dissertazione di
dottorato.
La differenza è che generalmente la monografia di laurea non ha
un relatore; se nella vostra facoltà anche la monografia di laurea
ha un relatore comportatevi come per la tesi di laurea. Se nel
vostro ateneo o nella vostra facoltà succede così, allora inserite
nel file di configurazione il seguente comando
\begin{verbatim}
\TesidiLaurea{Tesi di Laurea Specialistica}
\end{verbatim}
oppure cambiate ``Specialistica'' in `Magistrale'' se così è l'uso
della vostra facoltà o del vostro ateneo. Similmente cambiate le
stringhe inserite dai vari comandi facendo ampio uso dei comandi
esposti nelle tabelle~\ref{tab:front1}--\ref{tab:front4}, in
particolare inserendoli nel file di configurazione, specialmente
se devono rappresentare delle modifiche ``permanenti''; usateli
anche per predisporre quelle stringhe in una lingua diversa
dall'italiano.
Per comporre questo manuale si è usata la classe \texttt{toptesi},
e si è supposto di scrivere una monografia; tuttavia alcune
delle stringhe di default non sono adeguate all'uso, quindi il
preambolo di questo documento contiene le seguenti specificazioni
che illustrano l'impiego di diversi fra i comandi descritti nelle
tabelle citate:
\begin{verbatim}
\NomeMonografia{Manuale d'uso}
\monografia{La classe \textsf{TOPtesi}}
\sottotitolo{Per comporre le tesi al Poli\\
e in molte altre università}
\candidato{Claudio Beccari}
\sedutadilaurea{Versione \fileversion}
\logosede{logopolito}
\end{verbatim}
Vale la pena di fare le seguenti osservazioni:
\begin {itemize}
\item \texttt{\string\titolo} non deve
essere usato per la monografia (ma \texttt{\string\sottotitolo} si
può usare, come si è fatto per il frontespizio di questo
manuale); per la monografia il comando \texttt{\string\monografia}
imposta sia il titolo sia le altre informazioni che distinguono la
monografia da una tesi di laurea (magistrale).
%
\item Il comando \texttt{\string\titolo} accetta un argomento facoltativo, la versione breve
del titolo del frontespizio; serve con l'opzione \texttt{classica} e l'opzione
\texttt{autoretitolo}, dove il titolo breve va nella testatina delle pagine;
se il titolo del frontespizio fosse troppo lungo la testatina verrebbe
molto male!
%
\item Non dare i comandi \texttt{\string\relatore}, \texttt{\string\secondorelatore}
e \texttt{\string\terzorelatore} né per la dissertazione di
dottorato né per la monografia.
%
\item L'indicazione della materia su cui si svolge la tesi di laurea
o di dottorato non viene normalmente indicata se non, talvolta,
nelle facoltà umanistiche.
%
\item I secondi e terzi candidati non hanno senso né per
le tesi di dottorato né per le monografie.
%
\item Per la monografia l'informazione della data può essere omessa
se non c'è una data per la presentazione.
%
\item Il pacchetto \textsf{TOPtesi} contiene i loghi del Politecnico
di Torino, del Politecnico di Bari e dell'Institut National
Polytechnique de Grenoble; delle Università di Torino, del
Piemonte Orientale, di Genova, di Pavia, di Padova, di Trieste, di
Bologna (di cui questa Università specifica il corretto uso), di
Pisa, di Urbino, delle tre Università di Roma, di quelle di Bari e
di Palermo; questi loghi sono forniti nei formati \texttt{.pdf} e
\texttt{.eps}\footnote{Ahimè , alcuni di questi loghi sono stati
ricavati con una risoluzione troppo bassa; se dovete inserire il
logo di una di queste sfortunate università il cui logo è di
bassa qualità grafica, cercate di informarvi all'ufficio giusto
per avere l'autorizzazione per scaricare un logo di qualità
grafica migliore.}.
È ovvio che prima di usare un logo, del quale ogni università è
piuttosto gelosa, bisogna essere sicuri di non commettere un
illecito. Prima di usare qualsiasi logo informatevi
dall'istituzione rappresentata da quel simbolo sul suo uso
corretto e legale.
\end{itemize}
Per quanto riguarda i loghi, la loro inserzione implica l'uso del
pacchetto \texttt{graphicx}, che \textsf{TOPtesi} carica di
default; specificare nuovamente quel pacchetto non produce nessun
danno, perché \LaTeX\ controlla da solo se lo deve caricare o non
lo deve ricaricare.
Tuttavia va segnalato un punto che dovrebbe essere evidente dal
fatto che sono presenti le figure dei loghi sia nel formato
\texttt{.eps} gestibile da \LaTeX\ e \texttt{dvips}, sia nel
formato \texttt{.pdf} gestibile da {pdf\LaTeX}. I due insiemi di
formati sono disgiunti, nel senso che non esiste un formato su cui
possano operare indifferentemente sia \LaTeX\ sia pdf\LaTeX,
tranne il formato dei file prodotti dal programma MetaPost, che è
assai raro e poco usato, certamente non usato per i loghi.
No, anzi: dal 2010 il programma {pdf\LaTeX} è capace di gestire da solo anche le figure in formato \texttt{.eps}, nel senso cha da solo se le converte nel formato \texttt{.pdf} senza bisogno di chiederglielo esplicitamente; una volta prodotta la figura convertita, {pdf\LaTeX} la riconosce e non esegue più di nuovo la conversione. Perché allora non ho distribuito loghi solo in formato \texttt{.eps}? Perché questo formato è molto ingombrante e per produrre un file finale in formato \texttt{.pdf} bisogna comunque disporre di figure in formato accettabile da {pdf\LaTeX} senza conversioni di mezzo. Forse in un prossimo futuro eliminerò dalla distribuzione tutte le figure in formato \texttt{.eps}, con buona pace di coloro che continuano ad usare \LaTeX invece di {pdf\LaTeX}. Per questi utenti ricordo che il programma GUI \texttt{gview} è in grado di aprire un file \texttt{.pdf} e di salvarlo in formato \texttt{.eps}, quindi non sarebbe difficile fare la conversione a mano nemmeno per quei pochi utenti che continuano ad usare \LaTeX.
Per questo io preferisco usare sempre e solamente il compilatore
pdf\LaTeX, se non altro perché accetta un maggior numero di
formati grafici. L'unico inconveniente è che non posso usare direttamente il
pacchetto \texttt{PSTricks}; ma finora me la sono cavata molto
bene anche senza le prestazioni di questo bellissimo pacchetto.
\section{Altri comandi}
Il pacchetto \textsf{TOPtesi} richiede l'uso di altri comandi il
più notevole dei quali è senza dubbio \verb|\frontespizio|. È un comando che
non vuole argomenti e che va dato all'inizio, subito dopo
l'apertura del documento o all'inizio del primo file incluso dal
master file. Si veda comunque la tabella~\ref{tab:comandi}.
\begin{table}[p]
\def\V{\rule{0pt}{2.5ex}}
\def\cs#1{\texttt{\string#1}}\let\s\string
\def\d{\discretionary{\%}{}{}}
\makebox[\textwidth]{%
\begin {tabular}{p{.25\textwidth}p{.25\textwidth}p{.4\textwidth}}
\hline
Comando\V & Default & Scopo \\[.5ex]
\hline
\cs{\figurespagetrue}&\cs{\figurespagefalse}& Fa o non fa stampare l'indice delle figure\\
\cs{\tablespagetrue}&\cs{\tablespagefalse}&Fa o non fa stampare l'indice delle tabelle\\
\cs{\frontespizio} & nessuno & Fa stampare il frontespizio \\
\cs{\sommario} &nessuno & Inizia un capitolo non numerato che ha per
intestazione la parola SOMMARIO (anche in lingua)\\
\cs{\ringraziamenti}&nessuno & Inizia un capitolo non numerato
che ha per intestazione la parola
RINGRAZIAMENTI (anche in lingua)\\
\cs{\indici} &nessuno & Fa stampare l'indice generale, e,
se sono stati dati i comandi
\texttt{\char92figures"page"true} e
\texttt{\char92tables"page"true},
anche gli indici delle figure e delle
tabelle.\\[.5ex]
\texttt{dedica} && È un ambiente con cui si può stampare una
pagina di dedica; generalmente questa pagina viene prima del
frontespizio.\\
\texttt{citazioni} && È un ambiente che consente di scrivere una pagina con frasi argute.
L'arguzia dipende dall'autore; spesso nei libri, raramente nelle tesi,
l'autore cita frasi celebri o che in qualche modo hanno a che fare con
il contenuto del testo.\\
\cs{\paginavuota} &nessuno & Emette nel file di uscita una pagina totalmente bianca,
senza nemmeno il numero della pagina. Non so a che cosa
possa servire, ma non costa niente mettere a disposizione
anche questo comando che mi è stato richiesto a gran
voce.\\
\hline
\end{tabular}}
\caption{Comandi ulteriori di \textsf{TOPtesi}}\label{tab:comandi}
\end{table}
Ovviamente perché il comando esegua il suo compito, tutte le
informazioni rilevanti devono già essere state scritte nel file di
configurazione o i comandi specifici con i loro argomenti devono
essere già stati posti nel preambolo.
Nella figura~\ref{fig:frontespizi} sono riportati quattro esempi di frontespizi relativi ai tipi di tesi seguenti:
\begin{itemize}
\item tesi di laurea del Vecchio Ordinamento,
\item monografia di laurea,
\item tesi di laurea specialistica o magistrale,
\item dissertazione di dottorato
\end{itemize}
Con questi modelli lo studente che compila la sua tesi usando
\textsf{TOPtesi} può scegliere la versione che fa al caso suo e sa
anche che cosa deve configurare per eseguire alcuni cambiamenti.
%\enlargethispage*{3\baselineskip}
\begin{figure}[!htp]\centering
\begin{minipage}{.45\textwidth}\centering
\frame{\includegraphics[width=\linewidth]{tesilaurea}}
\end{minipage}\hfil
\begin{minipage}{.45\textwidth}\centering
\frame{\includegraphics[width=\linewidth]{monografia}}
\end{minipage}\\[\bigskipamount]
\begin{minipage}{.45\textwidth}\centering
\frame{\includegraphics[width=\linewidth]{laureaspecialistica}}
\end{minipage}\hfil
\begin{minipage}{.45\textwidth}\centering
\frame{\includegraphics[width=\linewidth]{tesidottorato}}
\end{minipage}
\caption{I quattro frontespizi fondamentali}\label{fig:frontespizi}
\end{figure}
\begin{table}[p]
\def\V{\rule{0pt}{2.5ex}}
\def\cs#1{\texttt{\string#1}}\let\s\string
\def\d{\discretionary{\%}{}{}}
\makebox[\textwidth]{%
\begin {tabular}{p{.2\textwidth}p{.7\textwidth}}
\hline
Comando\V & Scopo \\[.5ex]
\hline
\cs{\candidato}\V &Si usa come di solito ma con l'opzione \texttt{classica}
produce la scrittura ``Laureando'' invece che ``Candidato''.\\
\cs{\candidata} & Come sopra al femminile.\\
\cs{\tomo} & Esegue i frontespizi successivi di una tesi divisa in tomi
scrivendovi Tomo primo, Tomo secondo, eccetera,
a seconda del numero progressivo dei volumi in cui è suddivisa la tesi
(massimo quattro).\\
\cs{\annoaccademico} & Il suo argomento può essere un anno solare o
due anni separati da una lineetta.
Viene scritto nel frontespizio della tesi o del singolo tomo
con la specificazione che si tratta dell'anno accademico e non della
data della presentazione della tesi.\\
\cs{\EnDash} & Produce una lineetta lunga come ---, ma ribassata in modo che stia
bene fra numeri scritti con le cifre minuscole.\\
\cs{\nota[...]} & Serve per comporre una nota senza ricorrere al contatore numerico di
default.
Il simbolo con cui viene richiamata di default è l'asterisco, ma si può
mettere qualunque segno matematico senza esplicitare i segni di dollaro,
per esempio si può scrivere \cs{\nota[\s\dagger]\{Questa nota \dots\}}\\
\cs{\NoteWhiteLine} & Anche questo comando mi è stato richiesto a
gran voce e serve per mettere in nota una riga completamente bianca.
\\[.5ex]
\hline
\end{tabular}}
\caption{Comandi ulteriori per il frontespizio e per il corpo
della tesi definiti con l'opzione \texttt{classica}}\label{tab:front5}
\end{table}
\chapter*{Conclusioni}
\addcontentsline{toc}{chapter}{Conclusioni}
Il pacchetto \textsf{TOPtesi} fa quasi tutto quello che è
necessario per comporre uno qualunque di quegli scritti che
vengono chiamati \emph{monografia di laurea}, oppure \emph{tesi di
laurea}, oppure \emph{tesi di laurea specialistica}, oppure
\emph{tesi di laurea magistrale}, oppure \emph{dissertazione di
dottorato}.
Non fa tutto, ci mancherebbe altro, visto che nessuna persona è in
grado di prevedere tutte le necessità delle altre persone.
Da un lato alcuni devono adattarsi a quello che è disponibile,
magari dandosi da fare per creare qualche cosa di nuovo per se
stessi e forse anche per gli altri. Qualcun altro deve sapersi
immedesimare nelle necessità altrui e magari deve darsi da fare
per creare qualcosa di nuovo che possa essere utile agli altri e
forse anche a se stesso.
Una cosa certamente che rimane da fare è un procedimento più
semplice per la composizione del frontespizio in una lingua
diversa dall'italiano. Attualmente il procedimento si rifà all'uso
delle macro che servono per definire le stringhe in lingua; il
sistema dovrebbe essere completo ma richiede un po' di attenzione
da parte dell'utente.
\begin {sloppypar}
Un'altra possibilità sarebbe quella di predisporre altri file con
i nomi, per esempio, \texttt{topfrnten.sty},
\texttt{topfrntfr.sty}, \texttt{topfrntsp.sty}, eccetera, che
siano cloni del file \texttt{topfront.sty} e che si possono
richiamare come pacchetti aggiuntivi. Ognuno definisce il comando
\texttt{\string\frontespizioinglese},
\texttt{\string\frontespiziofrancese},
\texttt{\string\frontespiziospagnolo}, eccetera, e questo comando
può quindi essere usato in sostituzione del comando per il
frontespizio italiano. Questi file differirebbero da quello per il
frontespizio in italiano perché vi sarebbero ridefinite tutte le
definizioni di default delle stringhe in lingua. Ovviamente
bisogna che chi clona e modifica il file \texttt{topfront.sty} e
lo modifica per adattarlo ad una determinata lingua, debba
conoscere quella lingua da maestro. Suggerirei però di non
modificare le strutture con cui è composto il frontespizio del
nostro Politecnico, perché effettivamente contiene tutti gli
elementi richiesti ``per legge'' ed è tipograficamente abbastanza
equilibrato; la sfalsatura del blocco dei relatori e di quello dei
candidati lascia abbastanza spazio per le firme di legge, anche se
introduce un elemento di asimmetria; tuttavia~\dots
\end{sloppypar}
Il pacchetto \textsf{TOPtesi} carica di default sia \texttt{babel} sia
\texttt{graphicx}; certo potrebbe caricare di default anche
\texttt{amsmath} e i suoi compagni, ma non tutti hanno bisogno di
scrivere e comporre matematica avanzata e se non vengono usati essi
comportano uno spreco di memoria e un sia pur piccolo rallentamento
nell'esecuzione. Ritengo quindi che sia meglio che ognuno si carichi i
pacchetti che intende davvero usare.
Si ricordi che specificando l'opzione \texttt{pdfa}, bisogna usare esclusivamente \texttt{pdflatex} (con il parametro \verb|\pdfoutput| caricato con un numero positivo, generalmente~1); viene caricato un file di estensione specifico che a sua volta attiva la possibilità di disporre dei link interni ed esterni, che sono così comodi per ``navigare'' dentro al documento. Eventuali personalizzazioni devono perciò venire eseguite immediatamente dopo la dichiarazione della classe, altrimenti non vengono recepite correttamente. Bisogna altresì ricordarsi di predisporre il file con i \emph{metadata} richiesti dal formato PDF/A.
È possibile usare il semplice \texttt{latex} (o anche \texttt{pdflatex}, con il valore di \verb|\pdfoutput| caricato con il valore~0); ma questo serve solo per produrre un file in formato DVI, che può servire solo per una stampa della tesi su carta; può venire trasformato nel formato PS tramite l'applicativo \texttt{dvips}, ma questo formato non stamperebbe meglio di quel che si potrebbe ottenere dai ``previewer'' recenti per il formato DVI che siano anche in grado di inviare il file DVI in stampa. Viceversa è più interessante disporre della versione finale in formato PDF, cosa che si può ottenere mediante il programma \texttt{ps2pdf} il quale, con opportuni artifici, permette anche di produrre un file in formato PDF/A. Ma allora perché non ottenere questo risultato in un passaggio solo? Certo, potrebbe esserci l'esigenza di usare estensioni che fanno uso del linguaggio PostScript, ma, solitamente, agendo direttamente con \texttt{pdflatex} si possono usare altri pacchetti di estensione che consentono di evitare del tutto il linguaggio PostScript.
So per certo che le tesi di filologia classica possono essere
composte molto bene con \LaTeX\ e \textsf{TOPtesi}; se bisogna
usare una buona dose di lingua greca classica è conveniente
caricare il pacchetto \texttt{teubner}; gli intenditori sanno
perfettamente che i font della casa editrice Teubner di Lipsia
sono fra i più gradevoli che esistano; il pacchetto
\texttt{teubner} fa uso di un'ottima imitazione di quei font e
mette a disposizione una miriade di comandi per comporre quei
segni ``strani'' che i filologi usano per scrivere le loro opere.
Per le edizioni critiche esiste il pacchetto \texttt{ledmac}; io non
l'ho mai usato, ma sembra che sia di grande aiuto per i letterati.
Per gli scienziati e i tecnologi esistono troppi pacchetti
specializzati e sarebbe impossibile, e forse inutile, elencarli
tutti, o anche elencare solo i più importanti.
Non resta che augurare:
\begin {center}\Large\bfseries
Buona composizione con \LaTeX!
\end{center}
\appendix
\input{LPPL}
\end{document}
|