Debian Codegraph @

texmf-dist/source/latex/prociagssymp/procIAGssymp.dtx

raw
1 % \iffalse
2 % file: procIAGssymp.dtx
3 % author: Battista Benciolini
4 % date: 2024-04-08
5 %\fi
6 % \iffalse
7 %<*ins>
8 \begingroup
9 \input docstrip.tex
10 \keepsilent
11 \preamble
12 -------------------------------------------------------------
13 This file is part of the distribution of procIAGssymp.
14 The author is Battista Benciolini
15 benciolinibattista al gmail dot com
16 -------------------------------------------------------------
17 The package provides (re-)definitions of some LaTeX commands
18 that can be useful for the preparation of a paper with
19 the style of the proceeding of symposia sponsored by the
20 International Association of Geodesy (IAG).
21 -------------------------------------------------------------
22 This program may be used, distributed and modified under
23 the conditions of the LaTeX Project Public License.
24 (see: http://www.latex-project.org/lppl.txt)
25 -------------------------------------------------------------
26 \endpreamble
27 \askforoverwritefalse
28 \generate{\file{procIAGssymp.sty}{\from{procIAGssymp.dtx}{package}}}
29 \generate{\file{TESTprocIAGssymp.tex}{\from{procIAGssymp.dtx}{example}}}
30 \endgroup
31 %</ins>
32 %\fi
33 % \iffalse
34 %<*driver>
35 \documentclass[a4paper,10pt]{ltxdoc} %
36 \title{The package \texttt{procIAGssymp}}
37 \author{Battista Benciolini\thanks{contact: benciolinibattista al gmail dot com}}
38 \parindent=0pt
39 \begin{document}
40 \maketitle
41 \DocInput{procIAGssymp.dtx}
42 \end{document}
43 %</driver>
44 % \fi
45 % \section{Introduction and warnings} The package |procIAGssymp.sty| has
46 % been designed to help the formatting of a paper with the style
47 % of the proceedings of symposia sponsored by the
48 % International Association of Geodesy (IAG).
49 % \par
50 % I have not recently checked the instruction from
51 % the publisher of the proceedings of IAG-sponsored-symposia.
52 % They probably changed since the time this code has been prepared.
53 % I presume that official more refined and
54 % up-to-date class or style files
55 % are now available from the publisher.
56 % This package is therefore not as useful
57 % as it was at the time of it's first publication,
58 % but it is pehaps still conveniet for some user.
59 % \par
60 % The release of this package on CTAN is a personal initiative
61 % of its author. The mention of IAG and of the publisher
62 % of the proceedings of the symposia sponsored by IAG does
63 % not imply any involvement of these entities in this initiative.
64 % \section{The use of \texttt{procIAGssymp.sty}}
65 % \subsection{General informations}
66 % Some of the informations of these section are repeated
67 % in the test article that is distributed with the package.
68 % \par
69 % The reccommended class (with option) is:
70 % |[a4paper,twocolumn,10pt]{article}|.
71 % \subsection{Top-matter}
72 % The title and the (list of) author(s) must be prepared with
73 % \DescribeMacro{\title}
74 % \DescribeMacro{\author}
75 % |\title{ . . .}| and |\author{ . . .}| and they will be
76 % printed by |\maketitle|.
77 % If there are several authors, their
78 % \DescribeMacro{\and}
79 % names must be separated by |\and|.
80 % \DescribeMacro{\thanks}
81 % The authors that share the
82 % same address must be listed consecutively and must be followed by
83 % |\thanks{. . .}| (with the address as argument).
84 % The use of |\thanks{. . .}| referred
85 % to the title is not appropriate because this command has been redefined.
86 % \subsection{Sectioning}
87 % \DescribeMacro{\section} % \DescribeMacro{\subsection}
88 % The use of |\section{. . . }| and |\subsection{. . . }|
89 % can be done as in any \LaTeX\ paper.
90 % These commands have been redefined so that they
91 % produce the first level and second level headers in the proper format.
92 % All the other sectioning commands have been redefined with a coherent style.
93 % The command |\section*{References}| can be used to start the reference list.
94 % \subsection{Technicalities about the format of the top-matter}
95 % The main structure of the topmatter is governed by |\@maketitle|
96 % which is properly redefined.
97 % The command |\thanks| has been redefined to print the
98 % authors' address immediately after the authors' names.
99 % The new form of this command makes it unsuitable
100 % to put a note to the title.
101 % %
102 % \section{Acknowledgment}
103 % People listed here after contributed with suggestions.
104 % Some of them also provided fragments of code.
105 % {\large Claretta Carrara, Nico Snew, Claudio Beccari.}
106 % %
107 % \section{Code of \texttt{procIAGssymp.sty}}
108 % \iffalse
109 %<*package>
110 % \fi
111 % \begin{macrocode}
112 \ProvidesPackage{procIAGssymp}[2024/04/08]
113 % \end{macrocode}
114 % \begin{macro}{\@maketitle}
115 % The following redefinition of |\@maketitle| is quite simplified with
116 % respect to the standard one. The data is not printed; the title is
117 % not centered and it is in sans-serif style; the author is no longer
118 % in tabular environment; the author and its address are left justified.
119 % \begin{macrocode}
120 \def\@maketitle{%
121 {\LARGE\sffamily\bfseries\@title}
122 \vskip 6mm%
123 {\lineskip .5em%
124 {\raggedright\@author}}
125 \vskip 6mm%
126 \par
127 \vskip 1.5em}
128 % \end{macrocode}
129 %\end{macro}
130 %
131 % The proper behaviour of the command |\and| in relation with |\thanks|
132 % require the new conditional named |\ifafterthanks|.
133 % It will be used in the redefinition of |\and|.
134 % \begin{macrocode}
135 \newif\ifafterthanks \afterthanksfalse
136 % \end{macrocode}
137 % \begin{macro}{\thanks}
138 % The macro |\thanks| must be redefined to print the address immediately after
139 % the author(s) it refers to.
140 % \begin{macrocode}
141 \renewcommand{\thanks}[1]{\\ #1 \vskip6mm \global\afterthankstrue}
142 % \end{macrocode}
143 %\end{macro}
144 % \begin{macro}{\and}
145 % The macro|\and| must be redefined.
146 % \begin{macrocode}
147 \renewcommand{\and}{\ifafterthanks\relax \else{\unskip,}\ \fi
148 \global\afterthanksfalse}
149 % \end{macrocode}
150 %\end{macro}
151 %
152 % \begin{macro}{\section}
153 % The command |\section| is redefined to use proper shape and proper spacing.
154 % \begin{macrocode}
155 \renewcommand\section{\@startsection%
156 {section}{1}{0mm}{-3mm}{2mm}%
157 {\fontsize{10.95}{13.6}\selectfont\sffamily\bfseries}}%
158 % \end{macrocode}
159 %\end{macro}
160 % \begin{macro}{\subsection}
161 % The command |\subsection| is redefined to use proper shape and proper spacing.
162 % \begin{macrocode}
163 \renewcommand\subsection{\@startsection%
164 {subsection}{2}{0mm}{-3mm}{2mm}%
165 {\normalfont\sffamily\bfseries}}%
166 % \end{macrocode}
167 %\end{macro}
168 % The first and second order sectioning are generally used. The
169 % lower lever sectioning commands are redefined for compatibiliy.
170 % \begin{macrocode}
171 \renewcommand\subsubsection{\@startsection%
172 {subsubsection}{3}{0mm}{-2mm}{2mm}%
173 {\normalfont\normalsize\sffamily\bfseries}}%
174 \renewcommand\paragraph{\@startsection%
175 {paragraph}{4}{0mm}{-2mm}{-1em}%
176 {\normalfont\normalsize\sffamily\bfseries}} %
177 \renewcommand\subparagraph{\@startsection%
178 {subparagraph}{5}{\parindent}{-2mm}{-1em}%
179 {\normalfont\normalsize\sffamily\bfseries}}%
180 % \end{macrocode}
181 % It is also necessary to set some dimensions.
182 % \begin{macrocode}
183 \textheight224mm
184 \textwidth156mm
185 \columnsep8mm
186 \topmargin0mm
187 % \end{macrocode}
188 %\begin{macro}{\linea}
189 % The new command |\linea|, with Italian name -:) ,
190 % can be used to put some space and a rule after the abstract.
191 % \begin{macrocode}
192 \newcommand{\linea}{\vskip1mm\noindent\rule{74mm}{.5pt}}
193 % \end{macrocode}
194 %\end{macro}
195 % \iffalse
196 %</package>
197 % \fi
198 % \section{Code of \texttt{TESTprocIAGssymp.tex}}
199 % The code of |TESTprocIAGssymp.tex| is presented here after.
200 % \iffalse
201 %<*example>
202 % \fi
203 % \begin{macrocode}
204 \documentclass[a4paper,twocolumn,10pt]{article} %
205 \usepackage{procIAGssymp}
206 \title{The package procIAGssymp.sty for the formatting
207 of a paper with the style of the proceedings of
208 symposia sponsored by IAG}
209 \author{B.Benciolini\thanks{contact: benciolinibattista al gmail dot com}
210 \and No Second Author \and No Third Author\thanks{No-Where Institute}}
211 \hbadness=10000 \vbadness=10000
212 \begin{document}
213 \maketitle
214 \paragraph{Abstract} The use of the package \texttt{procIAGssymp.sty}
215 is explained and tested in this short paper.
216 \linea
217 \section{Introduction}
218 The package \texttt{procIAGssymp.sty} provides some (re-)definitions
219 of \LaTeX\ commands. The main pourpose of the present text is to give
220 an example of the use of the package \texttt{procIAGssymp.sty}.
221 The content is just an essential explenation of the use of the same package.
222 \par\noindent Please refer to the file \texttt{procIAGssymp.pdf} for
223 a complete documentation and to \texttt{README.txt} for general
224 introductory information.
225 \section{Suggestions for the user}
226 \subsection{General page lay-out}
227 The general lay-out of the pages is controlled by some assignment
228 made by \texttt{procIAGssymp.sty} and by the use of the class
229 \texttt{article} that must be loaded with the proper options, i.e.
230 \verb+[a4paper,twocolumn,10pt]+.
231 \subsection{Top-matter}
232 The title and the author(s) must be prepared with
233 \verb+\title{ . . .}+ and \verb+\author{ . . .}+ and they will be
234 printed by \verb+\maketitle+.
235 If there are several authors, their names must be separated by \verb+\and+.
236 The authors that share the same address must be listed consecutively and must
237 be followed by \verb+\thanks{. . .}+ (with the address as argument).
238 The use of \verb+\thanks{. . .}+ referred to the title is not appropriate
239 because this command has been redefined.
240 \subsection{More about the format of the top-matter}
241 The main structure of the topmatter is governed by \verb+\@maketitle+
242 which is properly redefined. \par\noindent
243 The command \verb+\thanks+ has been redefined to print the
244 authors' address immediately after the authors' names.
245 The new form of this command makes it unsuitable
246 to put a note to the title.
247 \subsection{Sectioning}
248 The use of \verb+\section{. . . }+ and \verb+\subsection{. . . }+
249 can be done as in any \LaTeX\ paper.
250 These commands have been redefined so that they
251 produce the first level and second level headers in the proper format. All
252 the other sectioning commands have been redefined with a coherent style. The
253 command \verb+\section*{References}+ can be used to start the reference list.
254 One of the following sections is just a test of the various sectioning commands.
255 \section{Test of sectioning (1st level)}
256 \subsection{Test of sectioning (2nd level)}
257 \subsubsection{Test of sectioning (3rd level)}
258 This is just an example of the use and abuse
259 of \verb+\section+, \verb+\subsection+ and
260 \verb+\subsubsection+. We can also test \verb+\paragraph+ and
261 \verb+\subparagraph+.
262 \paragraph{Paragraph} This is a paragraph, headed by \verb+\paragraph+.
263 \subparagraph{Subparagraph} This is a sub paragraph. And the section
264 ends here.
265 \section{History}
266 \begin{description}
267 \item[2000 ... 2002:] development, test, in-house use,
268 \item[2002] first released in CTAN,
269 \item[2022-05-05] general revision,
270 changes in the comments and documentation, new release in CTAN,
271 \item[2024-04-08] general revision, changes in the documentation,
272 all stuff collected in \texttt{procIAGssymp.dtx},
273 new release in CTAN.
274 \end{description}
275 \section{Recommendation}
276 I recommend all the users of the package \texttt{procIAGssymp.sty}
277 to send me any comment about it.
278 \end{document}
279 \endinput
280 % \end{macrocode}
281 % \iffalse
282 %</example >
283 % \fi
284 %
285 % \iffalse
286 % The END
287 % -------
288 % \fi
289 % \vfill\centerline{\large ***}\vfill
290 %