summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/toptesi/README
blob: dccaae41beda9883cc24bd22a7f8b3da17b119d8 (plain)
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
TOPtesi bundle version 6.x
Copyright 2008-2018 Claudio Beccari
LaTeX Project Public Licence LPPL v.1.3c (or later)

The TOPtesi bundle contains everything is needed for typesetting a
bachelor, master or PhD thesis in Italian (or in any other language
supported by LaTeX: the bundle supports multi-language use).

The infix strings may be selected and/or specified at will by means
of a configuration file, so as to customise the information of the
front page to the requirements of a specific university and a specific
language.

Thanks to its language management, the bundle is suited for
multi-language theses that are more and more frequent thanks
to the double degree programs of the European Union Erasmus programs
or the Life Long Learning European programs.

This version 6.x is backwards compatible, but it is completely new; it
uses key=value options, and uses different modules to typeset any
type of thesis supported by the package; it allows to select the use
of the frontespizio package to typeset the title page in substitution 
of its standard modules; it allows a custom setting, to let the user 
typeset the titlepage with his/her own title page layout. 

As a new feature, among the various thesis types there is also the one 
that Italian students submit to the examining committee of their final 
high-school State Exam.

Version 6.2.09 has a different (backwards compatible) way of handling 
the metadata required by the PDF/A regulations. It has a check to inhibit 
the use of hacked and/obsolete versions of its modules, so as to avoid 
requests of assistance in these cases: a strong visible message is issued 
to warn the user and the job is aborted. The documentation is further 
corrected and updated.

Version 6.2.05 has several corrections to the documentation; in 
particular for what concerns the production of PDF/A compliant files,
since the actual pdfx package has a glitch, known to its maintainers, 
that is not yet repaired, although they gave a patch to override the 
mentioned glitch.

Version 6.2.04 differs from the previous one because the module for 
PhD theses developed at the Doctoral School of Politecnico di Torino 
was setup to use by default the IEEE bibliography style. Since, 
obviously, not all PhD theses deal with the disciplines connected 
to the IEEE, a new option is available to let the PhD student to set up 
the style s/he needs in accordance with the practice in the disciplines 
s/he is working in. Moreover documentation has been significantly 
modified and upgraded.

Version 6.1.12 just differs from the previous 6.x versions because some 
little bugs were corrected and the documentation was upgraded.

Version 5.92 of TOPtesi was intended to be compliant also with XeLaTeX 
and LuaLaTeX; the documentation explains also how to obtain PDF/A-1b 
archivable files from pdfLaTeX, XeLaTeX, and LuaLaTeX. This particular 
functionality was up to date with respect to package pdfx dated 
2016/05/03 v.1.5.8.

Version 5.91 contained some small enhancements and bug corrections.

Version 5.90 was enhanced with some more class options that allowed 
TOPtesi to be used with external packages for typesetting the title 
page in different styles. It had a completely enhanced and redone 
Italian documentation file toptesi-it.pdf.


For installation, if the package is not already installed in your
TeX system distribution, either read the Italian documentation 
toptesi-it.pdf or move the toptesi.zip file to

.../texmf/source/latex/toptesi.

and decompress it.

Then run pdflatex on toptesi.dtx in order to get the class, style and
configuration files (and the pdf documentation in English) and move
the .tex, .cls, .sty, and .cfg files (including the
example .tex and .pdf files) to .../texmf/tex/latex/toptesi/.

Two fake logos of the "Institute of Technology of Turin" and its Doctoral 
School are provided, in substitution of the legal official ones. They both 
have a "FAKE LOGO" watermark so as to be sure they are not used in place 
of the official ones. In the documentation of this bundle they are used 
as examples of possible logos, but they do not represent in any way any 
official logo. Even the fake institutional name, the translation in English 
of the official Italian one, has nothing to do with the trademarked one, 
the only one the Politecnico of Torino bachelor, master, and PH.D. students 
should use for their actual theses; they have to get the official logos 
from their Student Office, or from the official restricted Web site where 
only institutional students have access.

Move the .txt and the remaining .pdf files plus this README file to 
.../texmf/doc/latex/toptesi.

If the mentioned folders do not exist, create them.

For a personal installation, the /texmf folder is your personal 
one, rooted in your home directory: ~ on Linux; ~/Library 
on Mac OSX; on a path with different names on different Windows 
systems, all of them containing in one form or another your login 
name; in recent Windows editions your home directory is 
C:\Users\<your login name>.

If you are running a Windows platform change the slashes into backslashes
and prefix all paths with the drive letter and any other specific prefix
that is actually used in your texmf tree. 

Remember to refresh the filename database if you are using a MiKTeX 
installation! 
This operation is not required if you have a TeXLive installation.

The package is already installed with complete TeXLive, MacTeX or 
MiKTeX distributions. In this case you don't need to decompress 
anything and move files around; in case of TeX system upgrades you 
package manager will do the work for you. 

Possibly check if the CTAN repository contains a newer version and, 
in case, use your package manager to upgrade your installation, but 
remember that you are not supposed to move or change anything in the 
TeX system directories.