summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/toptesi/README.txt
diff options
context:
space:
mode:
Diffstat (limited to 'macros/latex/contrib/toptesi/README.txt')
-rw-r--r--macros/latex/contrib/toptesi/README.txt76
1 files changed, 47 insertions, 29 deletions
diff --git a/macros/latex/contrib/toptesi/README.txt b/macros/latex/contrib/toptesi/README.txt
index 220bda5eaf..05c2a00f18 100644
--- a/macros/latex/contrib/toptesi/README.txt
+++ b/macros/latex/contrib/toptesi/README.txt
@@ -1,5 +1,5 @@
-con-TOPtesi bundle version 6.x
-Copyright 2008-2019 Claudio Beccari
+TOPtesi bundle version 6.x
+Copyright 2008-2020 Claudio Beccari
LaTeX Project Public Licence LPPL v.1.3c (or later)
This work may be distributed and/or modified under the conditions of
@@ -27,7 +27,7 @@ This work consists of the following files:
toptesi-example-dottorale.tex
toptesi-example-magistrale.tex
toptesi-scudo-example.zip
- README
+ README.txt
toptesi-it.tex
The files derived from the work are the following:
@@ -55,14 +55,15 @@ pdf file.
The Italian documentation is obtained by running LuaLaTeX on
toptesi-it.tex; this documentation has been completely redone
compared to previous versions. With this compiler the result
-should be PDF/A-1b compliant. The compilation of this file
+is PDF/A-2b compliant. The compilation of this file
requires input of various .pdf files, mostly obtained by
processing the .tex files belonging to the bundle. It requires
also the FAKE logos of Politecnico di Torino and of its doctoral
school. See below.
The two documentations pdf files, toptesi.pdf and toptesi-it.pdf,
-are complementary to one another.
+are complementary to one another and both should be stored in the
+doc/latex/toptesi/ folder.
The various files
@@ -112,14 +113,24 @@ As a new feature compared to versions 5.x, 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.4.x is further upgraded in order to customise header positions
+and folios. It it also upgraded to allow compliance with level 2 of the
+ISO PDF/A regulations on long term archivability. Because the filecontents
+*package* functionalities have been embedded into the LaTeX *kernel*
+environment, in a way backwards compatible with the previous definition
+of that environment, the now obslete package filecontents functionalities may
+still be obtained, but with a different syntax; therefore a new TOPtesi
+specific metadata environment has been defined so as to bypass such syntax
+changes.
+
Version 6.3.x contains some enhancements and corrections, especially
in view of the 2019 Italian TUG meeting that contained a tutorial
on this bundle. For what concerns PDF/A compliant files, the
documentation gives instructions that are up to date with package
pdfx dated February 2019, version 1.6.3.
-Version 6.1.12 just differs from the previous 6.x versions because some
-little bugs were corrected and the documentation was upgraded.
+Version 6.x derives from the previous version by using several features
+of the LaTeX3 language.
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
@@ -136,10 +147,15 @@ Italian documentation file toptesi-it.pdf.
--------------------------------------------------------------------
-For installation, if the package is not already contained in the
-installed TeX system distribution, on your platform either read
-the Italian documentation toptesi-it.pdf or move the toptesi.zip
-file to
+You might have your valid reasons for not upgrading your installed TeX
+system distribution, but in order to have available some new
+functionalities, you might consider upgrading your installation;
+otherwise you have to install the whole TOPtesi bundle by yourself.
+You can get some help by carefully reading the Italian documentation
+file toptesi.
+
+In this case you have to download the toptesi.zip file from a CTAN archive
+and save it to this (possibly created on purpose) folder:
.../texmf/source/latex/toptesi.
@@ -147,23 +163,9 @@ 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.
+the .tex, .cls, .sty, and .cfg files (including the example .tex files)
+to .../texmf/tex/latex/toptesi/. Move the two pdf files
+toptesi.pdf and toptesi-it.pdf to .../texmf/doc/latex/toptesi/.
If the mentioned folders do not exist, create them.
@@ -176,12 +178,28 @@ 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.
+that is actually used in your personal 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.
+------------------------------------------------------------------------
+
+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.
+
+-------------------------------------------------------------------------
+
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 your