From 33452f6039ba5535d9d9c6fcc58f7a9aad6ce91d Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Tue, 10 Jul 2018 21:08:56 +0000 Subject: topletter (10jul18) git-svn-id: svn://tug.org/texlive/trunk@48182 c570f23f-e606-0410-a88d-b1316a301751 --- .../doc/latex/topletter/EsempioLettera.pdf | Bin 0 -> 133751 bytes .../doc/latex/topletter/EsempioLettera.tex | 46 ++ .../doc/latex/topletter/ExampleLetter.pdf | Bin 0 -> 86275 bytes .../doc/latex/topletter/ExampleLetter.tex | 49 ++ Master/texmf-dist/doc/latex/topletter/LICENSE | 202 ++++++++ .../doc/latex/topletter/LogoPolitoBlu.pdf | Bin 0 -> 47340 bytes Master/texmf-dist/doc/latex/topletter/README.md | 11 + .../texmf-dist/doc/latex/topletter/TOPletter.pdf | Bin 0 -> 191733 bytes .../latex/topletter/Walt_Disney_1942_signature.pdf | Bin 0 -> 48163 bytes .../source/latex/topletter/TOPletter.dtx | 536 +++++++++++++++++++++ .../source/latex/topletter/TOPletter.ins | 52 ++ .../texmf-dist/tex/latex/topletter/TOPletter.cls | 163 +++++++ Master/tlpkg/bin/tlpkg-ctan-check | 2 +- Master/tlpkg/tlpsrc/collection-publishers.tlpsrc | 1 + Master/tlpkg/tlpsrc/topletter.tlpsrc | 0 15 files changed, 1061 insertions(+), 1 deletion(-) create mode 100644 Master/texmf-dist/doc/latex/topletter/EsempioLettera.pdf create mode 100644 Master/texmf-dist/doc/latex/topletter/EsempioLettera.tex create mode 100644 Master/texmf-dist/doc/latex/topletter/ExampleLetter.pdf create mode 100644 Master/texmf-dist/doc/latex/topletter/ExampleLetter.tex create mode 100644 Master/texmf-dist/doc/latex/topletter/LICENSE create mode 100644 Master/texmf-dist/doc/latex/topletter/LogoPolitoBlu.pdf create mode 100644 Master/texmf-dist/doc/latex/topletter/README.md create mode 100644 Master/texmf-dist/doc/latex/topletter/TOPletter.pdf create mode 100644 Master/texmf-dist/doc/latex/topletter/Walt_Disney_1942_signature.pdf create mode 100644 Master/texmf-dist/source/latex/topletter/TOPletter.dtx create mode 100644 Master/texmf-dist/source/latex/topletter/TOPletter.ins create mode 100644 Master/texmf-dist/tex/latex/topletter/TOPletter.cls create mode 100644 Master/tlpkg/tlpsrc/topletter.tlpsrc diff --git a/Master/texmf-dist/doc/latex/topletter/EsempioLettera.pdf b/Master/texmf-dist/doc/latex/topletter/EsempioLettera.pdf new file mode 100644 index 00000000000..c3043f510e2 Binary files /dev/null and b/Master/texmf-dist/doc/latex/topletter/EsempioLettera.pdf differ diff --git a/Master/texmf-dist/doc/latex/topletter/EsempioLettera.tex b/Master/texmf-dist/doc/latex/topletter/EsempioLettera.tex new file mode 100644 index 00000000000..727c3fc58c2 --- /dev/null +++ b/Master/texmf-dist/doc/latex/topletter/EsempioLettera.tex @@ -0,0 +1,46 @@ +%% +%% This is file `EsempioLettera.tex', +%% generated with the docstrip utility. +%% +%% The original source files were: +%% +%% TOPletter.dtx (with options: `sampleIt') +%% +%% This is a generated file. +%% +%% Copyright (C) 2015 by Marco Torchiano +%% +%% This file may be distributed and/or modified under the conditions of +%% the Apache License, either version 2.0 of this license +%% or (at your option) any later version. The latest version of this +%% license is in: +%% +%% http://choosealicense.com/licenses/apache-2.0/ +%% +\documentclass{TOPletter} +%% Carica package necessari +\usepackage{lipsum} + +%% dipartimento +\dipartimentoDi{Disegno e Animazione} + +%% dettagli personali +\ruolo{Fumettista } +\nome{Walt DISNEY} +\telefono{+1 555 123 4567} +\email{walt.disney@polito.it} +\homepage{http://www.polito.it/wdisney/} +\firma{Walt_Disney_1942_signature.pdf} +%% Subject +\soggetto{Esempio di lettera} +\protocollo{} +\begin{document} +%% Letter content +Ecco l'aspetto di una lettera PoliTo... + +\lipsum + +\end{document} +\endinput +%% +%% End of file `EsempioLettera.tex'. diff --git a/Master/texmf-dist/doc/latex/topletter/ExampleLetter.pdf b/Master/texmf-dist/doc/latex/topletter/ExampleLetter.pdf new file mode 100644 index 00000000000..6843bc45500 Binary files /dev/null and b/Master/texmf-dist/doc/latex/topletter/ExampleLetter.pdf differ diff --git a/Master/texmf-dist/doc/latex/topletter/ExampleLetter.tex b/Master/texmf-dist/doc/latex/topletter/ExampleLetter.tex new file mode 100644 index 00000000000..e5f538d882e --- /dev/null +++ b/Master/texmf-dist/doc/latex/topletter/ExampleLetter.tex @@ -0,0 +1,49 @@ +%% +%% This is file `ExampleLetter.tex', +%% generated with the docstrip utility. +%% +%% The original source files were: +%% +%% TOPletter.dtx (with options: `sampleEn') +%% +%% This is a generated file. +%% +%% Copyright (C) 2015 by Marco Torchiano +%% +%% This file may be distributed and/or modified under the conditions of +%% the Apache License, either version 2.0 of this license +%% or (at your option) any later version. The latest version of this +%% license is in: +%% +%% http://choosealicense.com/licenses/apache-2.0/ +%% +\documentclass[english]{TOPletter} +%% Load any additional package +\usepackage{lipsum} + +\IfLanguageName{italian}{ %% italian names + \dipartimentoDi{Disegno e Animazione} + \ruolo{Produttore} +}{%% english names + \dipartimentoDi{Comics and Cartoons} + \ruolo{Producer} +} + +%% personal details +\nome{Walt DISNEY} +\telefono{+1 555 123 4567} +\email{walt.disney@polito.it} +\homepage{http://www.polito.it/wdisney/} + +%% Subject +\soggetto{Sample letter} + +\begin{document} +%% Letter content +This is the typical appearance of a PoliTo letter. + +\lipsum +\end{document} +\endinput +%% +%% End of file `ExampleLetter.tex'. diff --git a/Master/texmf-dist/doc/latex/topletter/LICENSE b/Master/texmf-dist/doc/latex/topletter/LICENSE new file mode 100644 index 00000000000..e06d2081865 --- /dev/null +++ b/Master/texmf-dist/doc/latex/topletter/LICENSE @@ -0,0 +1,202 @@ +Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "{}" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright {yyyy} {name of copyright owner} + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. + diff --git a/Master/texmf-dist/doc/latex/topletter/LogoPolitoBlu.pdf b/Master/texmf-dist/doc/latex/topletter/LogoPolitoBlu.pdf new file mode 100644 index 00000000000..88b572c1aa2 Binary files /dev/null and b/Master/texmf-dist/doc/latex/topletter/LogoPolitoBlu.pdf differ diff --git a/Master/texmf-dist/doc/latex/topletter/README.md b/Master/texmf-dist/doc/latex/topletter/README.md new file mode 100644 index 00000000000..940adde3ce2 --- /dev/null +++ b/Master/texmf-dist/doc/latex/topletter/README.md @@ -0,0 +1,11 @@ +#TOPletter class +##version 0.3.0 of 2018/07/10 +Copyright 2015 Marco Torchiano +Apache License 2.0 + +The TOPletter bundle contains everything is needed for typesetting a letter using LaTeX and conforming to the official [Corporate Image](http://www.politocomunica.polito.it/corporate_image/marchio_e_identita_visiva) guidelines for [Politecnico di Torino](http://www.polito.it). The template can be used for letter both in Italian and English. + +To understand how you can write an official letter, [here](https://github.com/mtorchiano/TOPLetter/blob/master/EsempioLettera.tex) is the source for the letter and [here](https://github.com/mtorchiano/TOPLetter/raw/master/EsempioLettera.pdf) you can see the result. + + + diff --git a/Master/texmf-dist/doc/latex/topletter/TOPletter.pdf b/Master/texmf-dist/doc/latex/topletter/TOPletter.pdf new file mode 100644 index 00000000000..fee589d7d6a Binary files /dev/null and b/Master/texmf-dist/doc/latex/topletter/TOPletter.pdf differ diff --git a/Master/texmf-dist/doc/latex/topletter/Walt_Disney_1942_signature.pdf b/Master/texmf-dist/doc/latex/topletter/Walt_Disney_1942_signature.pdf new file mode 100644 index 00000000000..86fbad6fb7e Binary files /dev/null and b/Master/texmf-dist/doc/latex/topletter/Walt_Disney_1942_signature.pdf differ diff --git a/Master/texmf-dist/source/latex/topletter/TOPletter.dtx b/Master/texmf-dist/source/latex/topletter/TOPletter.dtx new file mode 100644 index 00000000000..cda33cd1bdb --- /dev/null +++ b/Master/texmf-dist/source/latex/topletter/TOPletter.dtx @@ -0,0 +1,536 @@ +% \iffalse meta-comment +% +% Copyright (C) 2015 by Marco Torchiano +% ------------------------------------------------------------------ +% +% This file may be distributed and/or modified under the conditions of +% the Apache License, either version 2.0 of this license +% or (at your option) any later version. The latest version of this +% license is in: +% +% http://choosealicense.com/licenses/apache-2.0/ +% +% \fi +% +% \iffalse +%<*driver> +\ProvidesFile{TOPletter.dtx} +% +%\NeedsTeXFormat{LaTeX2e} +%\ProvidesClass{TOPletter} +%<*class> + [2018/07/10 v0.3.0 Corporate Letter PoliTo LaTeX class] +% +% +%<*driver> +\documentclass{ltxdoc} +\usepackage{hyperref} +\usepackage{mdframed} +\EnableCrossrefs +%\CodelineIndex +\PageIndex +\RecordChanges +\OnlyDescription +\begin{document} + \DocInput{TOPletter.dtx} +\end{document} +% +% \fi +% +% \CheckSum{0} +% \CheckSum{292} +% +% \CharacterTable +% {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z +% Lower-case \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z +% Digits \0\1\2\3\4\5\6\7\8\9 +% Exclamation \! Double quote \" Hash (number) \# +% Dollar \$ Percent \% Ampersand \& +% Acute accent \' Left paren \( Right paren \) +% Asterisk \* Plus \+ Comma \, +% Minus \- Point \. Solidus \/ +% Colon \: Semicolon \; Less than \< +% Equals \= Greater than \> Question mark \? +% Commercial at \@ Left bracket \[ Backslash \\ +% Right bracket \] Circumflex \^ Underscore \_ +% Grave accent \` Left brace \{ Vertical bar \| +% Right brace \} Tilde \~} +% +% +% \changes{v0.2}{2015/03/13}{Initial version} +% \changes{v0.2.1}{2015/03/13}{Minor changes and fixes to examples} +% \changes{v0.3.0}{2018/07/10}{Added possibility to add protocol number} +% +% \GetFileInfo{TOPletter.dtx} +% +% \DoNotIndex{\newcommand,\newenvironment,\\, \bf,\begin, \cond, \condb} +% \DoNotIndex{\centering,\ClassError,\DeclareOption,\def,\definecolor} +% \DoNotIndex{\else,\end,\familydefault,\fancyfoot,\fancyhead,\fancyhf} +% \DoNotIndex{\fancypagestyle,\fi,\fontseries,\fontsize,\footrulewidth} +% \DoNotIndex{\footskip,\headheight,\headrulewidth,\href,\hspace} +% \DoNotIndex{\ifdefined,\IfFileExists,\IfLanguageName,\includegraphics} +% \DoNotIndex{\Large,\linebreak,\LoadClass,\makeatletter,\makeatother} +% \DoNotIndex{\makebox,\MessageBreak,\pagestyle,\parbox,\ProcessOption} +% \DoNotIndex{\protect,\raisebox,\relax,\renewcommand,\RequirePacakge} +% \DoNotIndex{\rule,\selectfont,\setlength,\sfdefault,\sffamily,\small} +% \DoNotIndex{\textwidth,\today,\topl@language,\toplData,\toplDest} +% \DoNotIndex{\toplEmail,\toplFax,\toplHome,\toplLuogo,\toplLogo} +% \DoNotIndex{\toplNome,\toplRuolo,\toplSignature,\toplStruttura} +% \DoNotIndex{\toplSubject,\toplSubjectLabel,\toplTelefono} +% \DoNotIndex{\toplTipoStruttura,\vspace,\color,\RequirePackage} +% +% \title{The \textsf{TOPletter} class\thanks{This document +% corresponds to \textsf{TOPLetter}~\fileversion, dated \filedate.}} +% \author{Marco Torchiano \\ \texttt{marco.torchiano@polito.it}} +% +% \maketitle +% +% \section{Introduction} +% +% The \textsf{TOPletter} class provides the basic functions needed for typesetting +% a letter using LaTeX and conforming to the official Corporate Image guidelines for +% Politecnico di Torino~\footnote{ +% \url{http://www.politocomunica.polito.it/corporate_image/marchio_e_identita_visiva}}. +% The class can be used for letters written both in Italian and in English languages. +% +% +% +% \section{Usage} +% +% The usage of the document class is extremely straightforward: +% \begin{itemize} +% \item the TOPletter document class must be declared as the base for +% the document. i.e. using |\documentclass{TOPletterA}|. +% +% \item the customization macros must be used to define the +% details of the letter, i.e. organization details, personal +% information, and letter subject. +% +% \item the body of the letter can be written as a regular \LaTeX document. +% \end{itemize} +% An example of a document using the \textsf{TOPletter} class is provided +% in section \ref{sec:example} below. +% +% +% \subsection{Organizational Unit} +% +% \DescribeMacro{\dipartimentoDi}\noindent +% The name of the department can be specified using the +% |\dipartimentoDi|\marg{department name} macro. +% +% \noindent\DescribeMacro{\struttura} +% By default the organizational unit is a {\em department}, but +% it is possible to set the type of the organizational unit using +% |\struttura|\marg{structure type} macro. +% +% \subsection{Personal Info} +% +% \noindent\DescribeMacro{\nome} +% |\nome|\marg{name and surname} +% Defines the name of the person, it should include both first and +% last names as they will appear in the header of the letter and +% at the end of the letter (after the date). +% +% \noindent\DescribeMacro{\ruolo} +% |\ruolo|\marg{role} +% defines the role of the person, e.g. {\em Full Professor}. +% +% \noindent\DescribeMacro{\telefono} +% |\telefono|\marg{phone number} +% defines the office phone number. +% +% \noindent\DescribeMacro{\email} +% |\email|\marg{email} +% defines the email address of the person +% +% The above information is mandatory and an error is reported +% if any is missing. +% +% \noindent\DescribeMacro{\homepage} +% |\homepage|\marg{url} +% defines the (optional) URL of the personal home page. +% +% \noindent\DescribeMacro{\fax} +% |\fax|\marg{fax} +% defines the (optional) fax number. +% +% \noindent\DescribeMacro{\firma} +% |\firma|\marg{image file} +% defines an image file (typically a PNG) that contains a scanned signature of the person. +% +% \subsection{Letter Details} +% +% \noindent\DescribeMacro{\soggetto} +% |\soggetto|\marg{subject} +% defines the subject of the letter, that will appear, at the top of the letter +% preceded by the word "{\em Subject:}" (or "{\em Soggetto:}" if the language is italian). +% +% The above macro is the only mandatory for the letter details. +% +% \noindent\DescribeMacro{\destinatario} +% |\destinatario|\marg{recipient} +% defines the recipient of the letter, if no recipient is provided the +% letter will be addressed to "{\em To whom it may concern}" +% (or "{\em A chi di competenza}" if the languaga is italian). +% +% \noindent\DescribeMacro{\luogo} +% |\luogo|\marg{place} +% defines the place that accompanies the date, it is by default "{\em Torino}" +% +% \noindent\DescribeMacro{\data} +% |\data|\marg{date} +% defines a date to be used at the bottom of the letter instead of the current date. +% +% \noindent\DescribeMacro{\esoggetto} +% |\esoggetto|\marg{label} +% changes the word that precedes the subject topic, replaces the default "{\em Subject:}". +% +% \noindent\DescribeMacro{\protocollo} +% |\protocollo|\marg{label} +% define a protol number if empty, only the ``{\em Prot:}'' will appear at top left. +% +% \subsection{Logo} +% +% \noindent\DescribeMacro{\logo} +% |\logo|\marg{image file} +% defines the image file containing the logo used in the header of the letter. +% The logo must be square with at least 400x400 pixel resolution. +% The default is the Politecnico di Torino logo. +% +% \subsection{Language} +% The document language can be specified as either |italian| or |english| +% as class parameter e.g. as |\documentclass[italian]{TOPletter}|. +% The default language is |italian|. +% +% The language can be detected using the |\IfLanguageName| macro to adapt the +% document contents to the specific language. This can be useful if a template +% file is used for both languages, for instance if we want to adapt the OU type +% and name according to the language we can add in the tex file the following: +% +% \begin{verbatim} +% \IfLanguageName{italian}{ %% department italian name: +% \dipartimentoDi{Automatica e Informatica} +% }{%% department english name: +% \dipartimentoDi{Control and Computer Engineering} +% } +% \end{verbatim} +% Automatically, based on the document language (defined as documentclass parameter), +% the correct naming for the department will be used. +% +% +% +% \section{Example} +% \label{sec:example} +% This section reports a very basic example of a short template used for writing a +% bilingual letter. +% \begin{mdframed} +% \begin{verbatim} +% \documentclass[english]{TOPletter} +% %% Load any additional package +% \usepackage{lipsum} +% +% \IfLanguageName{italian}{ %% italian names +% \dipartimentoDi{Disegno e Animazione} +% \ruolo{Produttore} +% }{%% english names +% \dipartimentoDi{Comics and Cartoons} +% \ruolo{Producer} +% } +% +% %% personal details +% \nome{Walt DISNEY} +% \telefono{+1 555 123 4567} +% \email{walt.disney@polito.it} +% \homepage{http://www.polito.it/wdisney/} +% +% %% Subject +% \soggetto{Sample letter} +% +% \begin{document} +% %% Letter content +% This is the typical appearance of a PoliTo letter. +% +% \lipsum +% \end{document} +% \end{verbatim} +% \end{mdframed} +% +% +% \StopEventually{\PrintChanges\PrintIndex} +% +% \iffalse +%<*class> +% \fi +% \section{Implementation} +% +% This class is based on the standard class article, it uses an A4 paper +% format since it is the standard in EU, the default font size is set to 11pt. +% \begin{macrocode} +\LoadClass[a4paper,11pt]{article} +% \end{macrocode} +% The class is designe to work with two languages |italian| and |english|. +% +% \begin{macrocode} +\def\topl@language{main=italian,english} +\DeclareOption{italian}{\def\topl@language{main=italian,english}} +\DeclareOption{english}{\def\topl@language{main=english,italian}} +\ProcessOptions\relax +% \end{macrocode} +% +% \subsection{Used packages} +% \begin{macrocode} +\RequirePackage[a4paper,bottom=8cm,top=2cm,left=2cm,right=2cm]{geometry} +\RequirePackage{graphicx} +\RequirePackage{color} +\RequirePackage{helvet} +\RequirePackage{changepage} +\RequirePackage{setspace} +\RequirePackage{fancyhdr} +\RequirePackage[utf8]{inputenc} +\RequirePackage{hyperref} +\RequirePackage[\topl@language]{babel} +\RequirePackage{iflang} +% \end{macrocode} +% +% \subsection{Colors} +% Offical PoliTo colors defined in the Corporate Image Guidelines. +% +% \begin{macrocode} +\definecolor{orange}{cmyk}{0,.70,1.00,0} %C0/M70/Y100/K0 +\definecolor{blue}{cmyk}{1.00,.80,0,.30} %C100/M80/Y0/K30 +% \end{macrocode} +% and we define accordingly the font faces and colors and a few +% macros to set text color quickly. +% +% \begin{macrocode} +\renewcommand*\familydefault{\sfdefault} +\newcommand{\cond}[1]{\fontseries{mc}\selectfont {#1}} +\newcommand{\condb}[1]{\fontseries{bc}\selectfont {#1}} +\newcommand{\orange}[1]{\color{orange}{#1}} +\newcommand{\blue}[1]{\color{blue}{#1}} +\newcommand{\red}[1]{\color{red}{#1}} +% \end{macrocode} +% \subsection{Headers and footer} +% Define the height of the head and the extra space at the bottom of the page: +% \begin{macrocode} +\setlength{\headheight}{4.1cm} +\setlength{\footskip}{2cm} +% \end{macrocode} +% The header part of the logo is define using the |fancyhdr| package. +% \begin{macrocode} +\fancypagestyle{plain}{ +\fancyhf{} % empty plus +% \end{macrocode} +% The header contains only the left part, and it is equal on both +% even and odd pages. In particular it contains the square logo +% followed by the name of the department. +% \begin{macrocode} +\fancyhead[LE,LO]{ +\makebox[2.15cm]{\includegraphics[width=2cm,height=2cm]{\toplLogo}} +{\color{blue}\rule{0.4pt}{2cm}} +\hspace{1pt} +\parbox[b]{5cm}{ +\condb{\fontsize{10.5pt}{10pt}\selectfont +{\blue POLITECNICO\linebreak + \raisebox{3pt}{DI TORINO}}}\\ +{\fontsize{7.5pt}{6pt}\selectfont \cond {\blue{% +\raisebox{-14pt}{\toplTipoStruttura}\\ \toplStruttura{} }}}% +}\\ +% \end{macrocode} +% After that we have the name and role of the person writing the letter +% \begin{macrocode} +{\sffamily \small +\vspace{0.8cm} +\hspace{2.5cm}\color{blue}{\cond{\toplRuolo{}}}\\ +\hspace{2.5cm}\color{orange}{\condb{\toplNome{}}}}} +% \end{macrocode} +% The footer is the same on odd and even pages and contains a reference to +% the structure and the address +% \begin{macrocode} +\fancyfoot[LE,LO]{\small \cond{\color{blue}{{\bf \toplTipoStruttura \toplStruttura}\\ +Politecnico di Torino - Corso Duca degli Abruzzi 24 - 10129 Torino - Italia\\ +tel:\toplTelefono{} \ifdefined\toplFax\hspace{4pt} fax:\toplFax\fi} \\ +\color{orange}{\href{mailto:\toplEmail}{\toplEmail}\hspace{4pt}% + \ifdefined\toplHome\href{\toplHome}{\toplHome}% + \fi \hspace{4pt} \href{http://www.polito.it}{http://www.polito.it}}}} +\renewcommand{\headrulewidth}{0pt} +\renewcommand{\footrulewidth}{0pt} +} +\pagestyle{plain} +% \end{macrocode} +% \subsection{Language specific issues} +% The name of the structure is different in english and in italian, +% the two default version -- i.e. Dipartimento and Department -- are +% predefined depending on the language: +% \begin{macrocode} +\IfLanguageName{italian}{ + \newcommand{\toplTipoStruttura}{Dipartimento di } + \newcommand{\toplDest}{A chi di competenza} + \newcommand{\toplSubjectLabel}{Oggetto} +}{ + \newcommand{\toplTipoStruttura}{Department of } + \newcommand{\toplDest}{To whom it may concern} + \newcommand{\toplSubjectLabel}{Subject} +} +% \end{macrocode} +% \subsection{Letter customization parameters} +% There are several parameters that can be used to customize the letter: +% \begin{macrocode} +\newcommand{\dipartimentoDi}[1]{\def\toplStruttura{#1}} +\newcommand{\struttura}[1]{\def\toplTipoStruttura{#1}} +\newcommand{\ruolo}[1]{\makeatletter\def\toplRuolo{#1}\makeatother} +\newcommand{\nome}[1]{\makeatletter\def\toplNome{#1}\makeatother} +\newcommand{\telefono}[1]{\makeatletter\def\toplTelefono{#1}\makeatother} +\newcommand{\fax}[1]{\makeatletter\def\toplFax{#1}\makeatother} +\newcommand{\email}[1]{\makeatletter\def\toplEmail{#1}\makeatother} +\newcommand{\homepage}[1]{\def\toplHome{#1}} +\newcommand{\soggetto}[1]{\def\toplSubject{#1}} +\newcommand{\esoggetto}[1]{\def\toplSubjectLabel{#1}} +\newcommand{\destinatario}[1]{\def\toplDest{#1}} +\newcommand{\firma}[1]{\def\toplSignature{#1}} +\newcommand{\logo}[1]{\def\toplLogo{#1}} +\newcommand{\luogo}[1]{\def\toplLuogo{#1}} +\newcommand{\data}[1]{\def\toplData{#1}} +\newcommand{\protocollo}[1]{\def\toplProtocollo{#1}} +\def\toplLogo{LogoPolitoBlu.pdf} +\def\toplLuogo{Torino} +\def\toplData{\today} +% \end{macrocode} +% \subsection{Checks} +% Several checks of completeness are performed at the beginning of the document. +% \begin{macrocode} +\AtBeginDocument{ +\ifdefined\toplEmail \else +\ClassError{TOPLetter} {Manca l'email} +{L'email deve essere definito con \protect\email{}.} +\fi +\ifdefined\toplTelefono \else +\ClassError{TOPLetter} {Manca il numero di telefono} +{Il numero di telefono deve essere definito con \protect\telefono{}.} +\fi +\ifdefined\toplNome \else +\ClassError{TOPLetter} {Manca il nome} +{Il nome della persona deve essere definito con \protect\nome{}.} +\fi +\ifdefined\toplRuolo \else +\ClassError{TOPLetter} {Manca il ruolo} +{Il ruolo deve essere definito con \protect\ruolo{}.} +\fi +\ifdefined\toplStruttura \else +\ClassError{TOPLetter} {Manca il nome della struttura} +{Il nome della struttura deve essere definito con \protect\struttura{}.} +\fi +\IfFileExists{\toplLogo} {} +{ +\ClassError{TOPLetter} {Il file di logo '\toplLogo' non e' stato trovato.} +{Il file deve avere come nome 'PoliLogoBlu.png' oppure essere definito +tramite il comando \protect\logo{}.\MessageBreak +Il file deve essere quadrato e con risoluzione sufficiente, +almeno 400x400 pixel. +} +} +% \end{macrocode} +% \subsection{Begin of the letter} +% The initial part of the letter includes the recipient of the letter +% \begin{macrocode} +\ifdefined\toplProtocollo +Prot. \toplProtocollo +\vspace{1cm} +\fi +\begin{adjustwidth}{10cm}{} + \toplDest +\end{adjustwidth} +\vspace{1cm} +% \end{macrocode} +% After the recicpient the subject of the letter is specified +% \begin{macrocode} +\ifdefined\toplSubject +\begin{center} +{\Large {\bf \toplSubjectLabel: \toplSubject }} +\end{center} +\fi +} +% \end{macrocode} +% \subsection{End of the letter} +% at the end of the letter we have the place and date, followed by the signature, +% if defined. +% \begin{macrocode} +\AtEndDocument{ +\vspace{2cm} +\hspace{.6\textwidth} +\parbox{5cm}{ +\centering +\toplLuogo, \toplData\\ +\toplNome\\ +\ifdefined\toplSignature + \includegraphics[width=4cm]{\toplSignature} +\fi +} +} +% \end{macrocode} +%% \iffalse +% +% \fi +% \Finale +% \iffalse +%<*sampleIt> +% \fi +\documentclass{TOPletter} +%% Carica package necessari +\usepackage{lipsum} + +%% dipartimento +\dipartimentoDi{Disegno e Animazione} + +%% dettagli personali +\ruolo{Fumettista } +\nome{Walt DISNEY} +\telefono{+1 555 123 4567} +\email{walt.disney@polito.it} +\homepage{http://www.polito.it/wdisney/} +\firma{Walt_Disney_1942_signature.pdf} +%% Subject +\soggetto{Esempio di lettera} +\protocollo{} +\begin{document} +%% Letter content +Ecco l'aspetto di una lettera PoliTo... + +\lipsum + +\end{document} +% \iffalse +% +%<*sampleEn> +% \fi +\documentclass[english]{TOPletter} +%% Load any additional package +\usepackage{lipsum} + +\IfLanguageName{italian}{ %% italian names + \dipartimentoDi{Disegno e Animazione} + \ruolo{Produttore} +}{%% english names + \dipartimentoDi{Comics and Cartoons} + \ruolo{Producer} +} + +%% personal details +\nome{Walt DISNEY} +\telefono{+1 555 123 4567} +\email{walt.disney@polito.it} +\homepage{http://www.polito.it/wdisney/} + +%% Subject +\soggetto{Sample letter} + +\begin{document} +%% Letter content +This is the typical appearance of a PoliTo letter. + +\lipsum +\end{document} +% \iffalse +% +% \fi +\endinput \ No newline at end of file diff --git a/Master/texmf-dist/source/latex/topletter/TOPletter.ins b/Master/texmf-dist/source/latex/topletter/TOPletter.ins new file mode 100644 index 00000000000..868ac271e0e --- /dev/null +++ b/Master/texmf-dist/source/latex/topletter/TOPletter.ins @@ -0,0 +1,52 @@ +%% +%% Copyright (C) 2015 by Marco Torchiano +%% +%% This file may be distributed and/or modified under the conditions of +%% the Apache License, either version 2.0 of this license +%% or (at your option) any later version. The latest version of this +%% license is in: +%% +%% http://choosealicense.com/licenses/apache-2.0/ +%% +%% + +\input docstrip.tex +\keepsilent + +\usedir{tex/latex/TOPletter} + +\preamble + +This is a generated file. + +Copyright (C) 2015 by Marco Torchiano + +This file may be distributed and/or modified under the conditions of +the Apache License, either version 2.0 of this license +or (at your option) any later version. The latest version of this +license is in: + + http://choosealicense.com/licenses/apache-2.0/ + +\endpreamble + +\generate{\file{TOPletter.cls}{\from{TOPletter.dtx}{class}}} +\generate{\file{ExampleLetter.tex}{\from{TOPletter.dtx}{sampleEn}}} +\generate{\file{EsempioLettera.tex}{\from{TOPletter.dtx}{sampleIt}}} + +\obeyspaces +\Msg{*************************************************************} +\Msg{* *} +\Msg{* To finish the installation you have to move the following *} +\Msg{* file into a directory searched by TeX: *} +\Msg{* *} +\Msg{* TOPletter.cls *} +\Msg{* *} +\Msg{* To produce the documentation run the file TOPletter.dtx *} +\Msg{* through LaTeX. *} +\Msg{* *} +\Msg{* Happy TeXing! *} +\Msg{* *} +\Msg{*************************************************************} + +\endbatchfile diff --git a/Master/texmf-dist/tex/latex/topletter/TOPletter.cls b/Master/texmf-dist/tex/latex/topletter/TOPletter.cls new file mode 100644 index 00000000000..51b2c5328db --- /dev/null +++ b/Master/texmf-dist/tex/latex/topletter/TOPletter.cls @@ -0,0 +1,163 @@ +%% +%% This is file `TOPletter.cls', +%% generated with the docstrip utility. +%% +%% The original source files were: +%% +%% TOPletter.dtx (with options: `class') +%% +%% This is a generated file. +%% +%% Copyright (C) 2015 by Marco Torchiano +%% +%% This file may be distributed and/or modified under the conditions of +%% the Apache License, either version 2.0 of this license +%% or (at your option) any later version. The latest version of this +%% license is in: +%% +%% http://choosealicense.com/licenses/apache-2.0/ +%% +\NeedsTeXFormat{LaTeX2e} +\ProvidesClass{TOPletter} + [2018/07/10 v0.3.0 Corporate Letter PoliTo LaTeX class] +\LoadClass[a4paper,11pt]{article} +\def\topl@language{main=italian,english} +\DeclareOption{italian}{\def\topl@language{main=italian,english}} +\DeclareOption{english}{\def\topl@language{main=english,italian}} +\ProcessOptions\relax +\RequirePackage[a4paper,bottom=8cm,top=2cm,left=2cm,right=2cm]{geometry} +\RequirePackage{graphicx} +\RequirePackage{color} +\RequirePackage{helvet} +\RequirePackage{changepage} +\RequirePackage{setspace} +\RequirePackage{fancyhdr} +\RequirePackage[utf8]{inputenc} +\RequirePackage{hyperref} +\RequirePackage[\topl@language]{babel} +\RequirePackage{iflang} +\definecolor{orange}{cmyk}{0,.70,1.00,0} %C0/M70/Y100/K0 +\definecolor{blue}{cmyk}{1.00,.80,0,.30} %C100/M80/Y0/K30 +\renewcommand*\familydefault{\sfdefault} +\newcommand{\cond}[1]{\fontseries{mc}\selectfont {#1}} +\newcommand{\condb}[1]{\fontseries{bc}\selectfont {#1}} +\newcommand{\orange}[1]{\color{orange}{#1}} +\newcommand{\blue}[1]{\color{blue}{#1}} +\newcommand{\red}[1]{\color{red}{#1}} +\setlength{\headheight}{4.1cm} +\setlength{\footskip}{2cm} +\fancypagestyle{plain}{ +\fancyhf{} % empty plus +\fancyhead[LE,LO]{ +\makebox[2.15cm]{\includegraphics[width=2cm,height=2cm]{\toplLogo}} +{\color{blue}\rule{0.4pt}{2cm}} +\hspace{1pt} +\parbox[b]{5cm}{ +\condb{\fontsize{10.5pt}{10pt}\selectfont +{\blue POLITECNICO\linebreak + \raisebox{3pt}{DI TORINO}}}\\ +{\fontsize{7.5pt}{6pt}\selectfont \cond {\blue{% +\raisebox{-14pt}{\toplTipoStruttura}\\ \toplStruttura{} }}}% +}\\ +{\sffamily \small +\vspace{0.8cm} +\hspace{2.5cm}\color{blue}{\cond{\toplRuolo{}}}\\ +\hspace{2.5cm}\color{orange}{\condb{\toplNome{}}}}} +\fancyfoot[LE,LO]{\small \cond{\color{blue}{{\bf \toplTipoStruttura \toplStruttura}\\ +Politecnico di Torino - Corso Duca degli Abruzzi 24 - 10129 Torino - Italia\\ +tel:\toplTelefono{} \ifdefined\toplFax\hspace{4pt} fax:\toplFax\fi} \\ +\color{orange}{\href{mailto:\toplEmail}{\toplEmail}\hspace{4pt}% + \ifdefined\toplHome\href{\toplHome}{\toplHome}% + \fi \hspace{4pt} \href{http://www.polito.it}{http://www.polito.it}}}} +\renewcommand{\headrulewidth}{0pt} +\renewcommand{\footrulewidth}{0pt} +} +\pagestyle{plain} +\IfLanguageName{italian}{ +\newcommand{\toplTipoStruttura}{Dipartimento di } +\newcommand{\toplDest}{A chi di competenza} +\newcommand{\toplSubjectLabel}{Oggetto} +}{ +\newcommand{\toplTipoStruttura}{Department of } +\newcommand{\toplDest}{To whom it may concern} +\newcommand{\toplSubjectLabel}{Subject} +} +\newcommand{\dipartimentoDi}[1]{\def\toplStruttura{#1}} +\newcommand{\struttura}[1]{\def\toplTipoStruttura{#1}} +\newcommand{\ruolo}[1]{\makeatletter\def\toplRuolo{#1}\makeatother} +\newcommand{\nome}[1]{\makeatletter\def\toplNome{#1}\makeatother} +\newcommand{\telefono}[1]{\makeatletter\def\toplTelefono{#1}\makeatother} +\newcommand{\fax}[1]{\makeatletter\def\toplFax{#1}\makeatother} +\newcommand{\email}[1]{\makeatletter\def\toplEmail{#1}\makeatother} +\newcommand{\homepage}[1]{\def\toplHome{#1}} +\newcommand{\soggetto}[1]{\def\toplSubject{#1}} +\newcommand{\esoggetto}[1]{\def\toplSubjectLabel{#1}} +\newcommand{\destinatario}[1]{\def\toplDest{#1}} +\newcommand{\firma}[1]{\def\toplSignature{#1}} +\newcommand{\logo}[1]{\def\toplLogo{#1}} +\newcommand{\luogo}[1]{\def\toplLuogo{#1}} +\newcommand{\data}[1]{\def\toplData{#1}} +\newcommand{\protocollo}[1]{\def\toplProtocollo{#1}} +\def\toplLogo{LogoPolitoBlu.pdf} +\def\toplLuogo{Torino} +\def\toplData{\today} +\AtBeginDocument{ +\ifdefined\toplEmail \else +\ClassError{TOPLetter} {Manca l'email} +{L'email deve essere definito con \protect\email{}.} +\fi +\ifdefined\toplTelefono \else +\ClassError{TOPLetter} {Manca il numero di telefono} +{Il numero di telefono deve essere definito con \protect\telefono{}.} +\fi +\ifdefined\toplNome \else +\ClassError{TOPLetter} {Manca il nome} +{Il nome della persona deve essere definito con \protect\nome{}.} +\fi +\ifdefined\toplRuolo \else +\ClassError{TOPLetter} {Manca il ruolo} +{Il ruolo deve essere definito con \protect\ruolo{}.} +\fi +\ifdefined\toplStruttura \else +\ClassError{TOPLetter} {Manca il nome della struttura} +{Il nome della struttura deve essere definito con \protect\struttura{}.} +\fi +\IfFileExists{\toplLogo} {} +{ +\ClassError{TOPLetter} {Il file di logo '\toplLogo' non e' stato trovato.} +{Il file deve avere come nome 'PoliLogoBlu.png' oppure essere definito +tramite il comando \protect\logo{}.\MessageBreak +Il file deve essere quadrato e con risoluzione sufficiente, +almeno 400x400 pixel. +} +} +\ifdefined\toplProtocollo +Prot. \toplProtocollo +\vspace{1cm} +\fi +\begin{adjustwidth}{10cm}{} +\toplDest +\end{adjustwidth} +\vspace{1cm} +\ifdefined\toplSubject +\begin{center} +{\Large {\bf \toplSubjectLabel: \toplSubject }} +\end{center} +\fi +} +\AtEndDocument{ +\vspace{2cm} +\hspace{.6\textwidth} +\parbox{5cm}{ +\centering +\toplLuogo, \toplData\\ +\toplNome\\ +\ifdefined\toplSignature +\includegraphics[width=4cm]{\toplSignature} +\fi +} +} +%% \iffalse +\endinput +%% +%% End of file `TOPletter.cls'. diff --git a/Master/tlpkg/bin/tlpkg-ctan-check b/Master/tlpkg/bin/tlpkg-ctan-check index fe6f958135d..2c0babcc6fb 100755 --- a/Master/tlpkg/bin/tlpkg-ctan-check +++ b/Master/tlpkg/bin/tlpkg-ctan-check @@ -644,7 +644,7 @@ my @TLP_working = qw( tkz-kiviat tkz-linknodes tkz-orm tikz-page tkz-tab tlc-article tlc2 tocbibind tocdata tocloft tocvsec2 todo todonotes - tokenizer toolbox tools topfloat totcount totpages toptesi + tokenizer toolbox tools topfloat topletter totcount totpages toptesi tpslifonts tqft tracklang trajan tram translation-array-fr diff --git a/Master/tlpkg/tlpsrc/collection-publishers.tlpsrc b/Master/tlpkg/tlpsrc/collection-publishers.tlpsrc index e7023f312f4..92248b3b24b 100644 --- a/Master/tlpkg/tlpsrc/collection-publishers.tlpsrc +++ b/Master/tlpkg/tlpsrc/collection-publishers.tlpsrc @@ -160,6 +160,7 @@ depend thucoursework depend thuthesis depend timbreicmc depend tlc-article +depend topletter depend toptesi depend tudscr depend tugboat diff --git a/Master/tlpkg/tlpsrc/topletter.tlpsrc b/Master/tlpkg/tlpsrc/topletter.tlpsrc new file mode 100644 index 00000000000..e69de29bb2d -- cgit v1.2.3