diff options
Diffstat (limited to 'info/l2tabu')
| -rw-r--r-- | info/l2tabu/english/l2tabuen.pdf | bin | 0 -> 310072 bytes | |||
| -rw-r--r-- | info/l2tabu/english/l2tabuen.tex | 1819 | ||||
| -rw-r--r-- | info/l2tabu/french/README | 10 | ||||
| -rw-r--r-- | info/l2tabu/french/l2tabufr.pdf | bin | 0 -> 326592 bytes | |||
| -rw-r--r-- | info/l2tabu/french/l2tabufr.tex | 1470 | ||||
| -rw-r--r-- | info/l2tabu/german/CHANGES | 61 | ||||
| -rw-r--r-- | info/l2tabu/german/README | 7 | ||||
| -rw-r--r-- | info/l2tabu/german/l2tabu.pdf | bin | 0 -> 226094 bytes | |||
| -rw-r--r-- | info/l2tabu/german/l2tabu.tex | 1690 | ||||
| -rw-r--r-- | info/l2tabu/italian/l2tabuit.pdf | bin | 0 -> 237566 bytes | |||
| -rw-r--r-- | info/l2tabu/italian/l2tabuit.tex | 1800 | ||||
| -rw-r--r-- | info/l2tabu/spanish/README | 6 | ||||
| -rw-r--r-- | info/l2tabu/spanish/l2tabues.pdf | bin | 0 -> 278344 bytes | |||
| -rw-r--r-- | info/l2tabu/spanish/l2tabues.tex | 1022 |
14 files changed, 7885 insertions, 0 deletions
diff --git a/info/l2tabu/english/l2tabuen.pdf b/info/l2tabu/english/l2tabuen.pdf Binary files differnew file mode 100644 index 0000000000..7eb0465521 --- /dev/null +++ b/info/l2tabu/english/l2tabuen.pdf diff --git a/info/l2tabu/english/l2tabuen.tex b/info/l2tabu/english/l2tabuen.tex new file mode 100644 index 0000000000..9330ce1241 --- /dev/null +++ b/info/l2tabu/english/l2tabuen.tex @@ -0,0 +1,1819 @@ +%%%------------------------------------------------------------------ +%%% Filename: l2tabuen.tex +%%% Author: Mark Trettin, Jürgen Fenn <juergen.fenn@gmx.de> +%%% Created: 16 Juni 2007 +%%% Time-stamp: none +%%% Version: $Id: l2tabuen.tex,v 1.8.5.7 $ +%%% +%%% Copyright (C) 2004--2007 by Mark Trettin and Jürgen Fenn +%%%------------------------------------------------------------------ +%%% TODO: +%%% - \input{../asdf/} instead of \input ../asdf/ + +\documentclass[11pt,a4paper,pagesize,tablecaptionabove,abstracton,pointlessnumbers]{scrartcl} +%--------------- Basic Configuration (German, 8bit) ---------------- +%\usepackage[ngerman]{babel} % Switch to German +\usepackage[latin1]{inputenc} % Direct input of German umlauts etc. +\usepackage[T1]{fontenc} % T1 Fonts +%%% Times/Helvetica/Courier *only* for minimizing the size of this file +%% as these fonts do not have to be inserted into the output document. +\usepackage{mathptmx} % Times/Maths \rmdefault +\usepackage[scaled=.90]{helvet} % Scaling Helvetica \sfdefault +\usepackage{courier} % Courier \ttdefault +\usepackage{multicol} + +\typearea[current]{current} % Calculate typearea anew +%------------ additional packages (graphics, tables) --------------- +\usepackage{xspace} % automatic blanks after macros +\usepackage{booktabs,array} % nicer tables +\usepackage[english]{varioref} % modifyed for the version publicised + % as current versionf of fancy, and + % varioref do not work together + % (still not?!) +\usepackage{textcomp} % additional characters +\usepackage[nofancy]{rcsinfo} % RCS Informationen in title +\usepackage{enumerate} +\usepackage{calc} % we must calculate +\usepackage{eurosans} % the Euro +%--------------------------- Formatting --------------------------- +%%% Captions +\setkomafont{caption}{\normalcolor\small\sffamily\slshape} +\setkomafont{captionlabel}{\normalcolor\upshape\small\sffamily\bfseries} +%--------------------------- PDF Options --------------------------- +\ifpdfoutput{% % needs KOMA-Script class + \usepackage{hyperref} % hyperref settings for pdf + \hypersetup{% + pdfauthor={(c) 2007 Mark Trettin and Juergen Fenn},% + pdftitle={l2tabuen -- An essential guide to \LaTeXe\ usage},% + pdfsubject={Some hints on LaTeX2e},% + bookmarksopen=true,% Temp + backref=true,% + pdffitwindow=true,% + pdfpagelayout=OneColumn,% + colorlinks=true,% + linkcolor=red,% + linktocpage=true,% + backref=true,% + pdfstartview=FitH,% + bookmarksopen=true,% + bookmarksopenlevel=2,% + bookmarksnumbered=false,% + urlcolor=blue% + }% + \usepackage[activate=normal]{pdfcprot} % character protruding using pdftex + \newcommand{\EMail}[1]{\href{mailto:#1?Subject=[l2tabu.pdf]}{email: \texttt{#1}}} + \newcommand{\News}[1]{\href{news:#1}{\texttt{#1}}} + \newcommand{\MID}[2]{\href{http://groups.google.com/groups?as_umsgid=#1}% + {Message-ID: \texttt{<#2>}}} + % \usepackage{color} % For preview-latex (in pdf tree) + }% +%--------------------------- PS Options ---------------------------- + {% + \usepackage{hyperref} + \newcommand{\EMail}[1]{\href{mailto:#1}{Email: \texttt{#1}}} + \newcommand{\News}[1]{\href{news:#1}{\texttt{#1}}} + \newcommand{\MID}[2]{\href{M-ID: <#1>}{Message-ID: \texttt{<#2>}}} + } +\usepackage{color} % comment out for preview-latex +%-------------------------- new commands -------------------------- +%%% documentation: SansSerif +\newcommand{\TB}{\textbackslash} +\newcommand{\Doku}[1]{\textsf{#1}\xspace} +%%% Paket ,Klasse, Bibstil (packages, classes, bib style): SansSerif, Slanted +%\newcommand{\Paket}[2][sty]{\textsf{\textsl{#2.#1}}\xspace} +\newcommand{\Paket}[1]{\textsf{\textsl{#1.sty}}\xspace} +\newcommand{\Klasse}[1]{\textsf{\textsl{#1.cls}}\xspace} +\newcommand{\Bst}[1]{\textsf{\textsl{#1.bst}}\xspace} +%%% Options: SansSerif +\newcommand{\Option}[1]{\textsf{#1}\xspace} +%%% \Use{graphicx} --> \usepackage{graphicx} +%%% \UseO{dvips}{graphicx} --> \usepackage[dvips]{graphicx} +\newcommand{\Use}[1]{\texttt{\textbackslash usepackage\{#1\}}} +\newcommand{\UseO}[2]{\texttt{\TB usepackage[#1]\{#2\}}} +\newcommand{\UseV}[2]{\texttt{\TB usepackage\{#1\}[#2]}} +\newcommand{\UseOV}[3]{\texttt{\TB usepackage[#1]\{#2\}[#3]}} +%%% Footnotes +\deffootnote{2.5em}{1em}{\thefootnotemark\ \ \ }% +\setlength{\footnotesep}{12pt} +%%% Nonfrenchspacing +\nonfrenchspacing +%%% Bibliography +\newcommand{\Bib}[1]{\texttt{\textbackslash bibliographystyle\{#1\}}} +%%% environment TODO: redefine, for this looks rather bad +\newcommand{\Env}[2]{\raggedright\texttt{\textbackslash begin\{#1\}\\ + #2\\ \textbackslash end\{#1\}}} +%%% \newcommand +\newcommand{\NewCom}[3][]{\texttt{\textbackslash newcommand{#1}\{\textbackslash#2\}\{#3\}}} +\newcommand{\ReNewCom}[3][]{\texttt{\textbackslash renewcommand{#1}\{\textbackslash#2\}\{#3\}}} +%%% Stolen from scrguide ;-) +\DeclareRobustCommand*{\Macro}[1]{\mbox{\texttt{\char`\\#1}}} +\DeclareRobustCommand*{\LMacro}[2]{\mbox{\texttt{\char`\\#1\{#2\}}}} +\DeclareRobustCommand*{\GMacro}[2]{\mbox{\texttt{\{\char`\\#1\ #2\}}}} +% DANTE +\providecommand{\CTANserver}{ftp.dante.de} +% Make CTAN:// be an alias of ftp://\CTANserver/tex-archive/ +\makeatletter +\def\url@#1{\expandafter\url@@#1\@nil} +\def\url@@#1://#2\@nil{% + \def\@tempa{#1}\def\@tempb{CTAN}\ifx\@tempa\@tempb + \hyper@linkurl{\Hurl{#1:#2}}{ftp://\CTANserver/tex-archive/#2}% + \else + \hyper@linkurl{\Hurl{#1://#2}}{#1://#2}% + \fi +} +\makeatother +%%% Farben +\definecolor{gruen}{rgb}{0,0.55,0} +\definecolor{rot}{rgb}{1,0,0} +\newcommand{\FIXME}[1]{\marginline{FIXME: #1!}} +\newsavebox{\Quelle} + +\newenvironment{bspcode}[1]{% + \sbox{\Quelle}{\footnotesize From: #1} + \center + \rule{\linewidth}{1.5pt} +}{% + \rule{\linewidth}{1.5pt} + \usebox{\Quelle} + \endcenter% +} + +%%% Macros for replacing FIXME: +\newcommand{\Ersetze}[2]{\par\noindent Replace: \textcolor{red}{#1} + by \textcolor{gruen}{#2}} +\newcommand{\Ersetzx}[3][.5\textwidth]{% + \par\noindent% + \begin{minipage}[t]{#1} + \raggedright + Replace:\\ + \textcolor{rot}{#2} + \end{minipage}% + \hfill% + \begin{minipage}[t]{(\linewidth - #1)-.02\linewidth} + \raggedright + by\\ + \textcolor{gruen}{#3} + \end{minipage}% +} +% Width for "Ersetze" macros :-( +\newsavebox{\Breite} +%%% A hack by Heiko Oberdiek for acroread under Linux +\pdfstringdefDisableCommands{% + \edef\quotedblbase{\string"}% + \edef\textquotedblleft{\string"}% +} +%%% a very, very crude Hack for typesetting a URL in one line +%%% *without* any additional spacing. :-( +\newcommand{\biburl}[1]{\hfill\\URL:~\url{#1}} +%------------------- defining columns in tables -------------------- +% needs array +\newcolumntype{v}[1]{>{\raggedright\hspace{0pt}}p{#1}} % v column, like + % p column, but + % raggedright +\newcolumntype{V}[1]{>{\footnotesize\raggedright\hspace{0pt}}p{#1}} +\newcolumntype{N}{>{\footnotesize}l} +\newcolumntype{C}{>{\footnotesize}c} +%----------------------------- title ------------------------------ +\title{An essential guide to \LaTeXe{} usage\\[1em] + \LARGE\mdseries\rmfamily Obsolete commands and packages} + +\author{Original German version\thanks{Based on the German version + 1.8 of \Doku{l2tabu}.}\\ + by Mark Trettin\thanks{\EMail{Mark.Trettin@gmx.de}}% + \and% + English translation\\ + by Jürgen Fenn\thanks{\EMail{juergen.fenn@gmx.de}}} + +\date{\today} + +% \rcsInfoRevision\ \\ +% \rcsInfoLongDate} +%----------------------- begin of document ----------------------- +\begin{document} +%\begin{Form}\end{Form} +\pagestyle{headings} +%%% RCS Info for version control +\rcsInfo $Id: l2tabuen.tex,v 1.8.5.7 2007/06/17 00:00:00 juergen Exp $ +\maketitle +\begin{abstract} + \noindent + This is the English version \rcsInfoRevision{} of \Doku{l2tabu}, + focusing on obsolete commands and packages, and demonstrating the + most severe mistakes most \LaTeX{} users are prone to make. You + should read this guide if you want to improve on your \LaTeX{} code. +\end{abstract} + +\subsection*{Legal notice} +\label{sec:legalnotice} + +Copyright \copyright{} 2007 by Mark Trettin and Jürgen Fenn. +\medskip + +Permission is granted to copy, distribute and/or modify this document +under the terms of the GNU Free Documentation License, Version 1.2 or +any later version published by the Free Software Foundation. +\emph{There are no invariant sections in this document.} Please +contact the translator of this version before distributing a modified +version of the following text. A copy of the licence is included in +appendix \ref{sec:fdl}. + +\subsection*{Acknowledgements}%\addcontentsline{toc}{section}{Acknowledgements}% + +Reading the German-language \TeX{} newsgroup \News{de.comp.text.tex} +one of us (Mark Trettin) found that most discussions were about +obsolete or, say, `bad' packages, and commands. So he decided to write +a brief summary to supply a practical guide to \LaTeX. His paper was +called \Doku{altepakete.pdf} in the first place and soon it was +praised by senior developers writing to the group. It is recommended +for reading ever since. Later it was renamed by vote of participants +in \News{de.comp.text.tex} to \Doku{l2tabu}, corresponding to +\Doku{l2kurz}, the German title of \Doku{lshort}\cite{l2kurz:99}, and +the German translation of `taboo'. This was about two years +ago.\footnote{\Doku{altepakete} was first announced on 18 February + 2003 on \News{de.comp.text.tex}.} I (Jürgen Fenn) joined Mark later +for translating his paper into English in order to help it spread to +those users who do not speak German. + +In this article we give a demonstration of the most common mistakes in +using \LaTeX. We also explain how to avoid them. This overview is +neither meant to replace introductions such as +\Doku{lshort}~\cite{l2kurz:99} nor the \Doku{De-TeX-FAQ}~\cite[version +72]{faq:02} nor the \Doku{UK FAQ}~\cite[version 3.16]{ukfaq:99}. Our +goal is just to give a small overview of how to write `good' \LaTeXe{} +code. + +\subsection*{More translations of this paper} + +Please note that besides the German original `Das +\LaTeXe-Sündenregister oder Veraltete Befehle, Pakete und andere +Fehler. Tipps zu \LaTeXe' and this English version, there are more +translations of this paper. They all can be found in the respective +subdirectories at +\begin{quote} +\url{CTAN://info/l2tabu/} +\end{quote} +So far \Doku{l2tabu} has been translated into English, French, and +Italian. + +\subsection*{How to get in touch with the authors} + +We are grateful for any suggestions, improvements, or comments. +Please address your emails directly to the translator of the +English\footnote{\EMail{juergen.fenn@gmx.de}. -- Download of + \Doku{l2tabuen} from: \url{CTAN://info/l2tabu/english/}}, the +French\footnote{See the French translation \Doku{l2tabufr} by Yvon + Henel at \url{CTAN://info/l2tabu/french/}}, or the +Italian\footnote{See the Italian translation \Doku{l2tabuit} by + Emanuele Zannarini at \url{CTAN://info/l2tabu/italian/}} version +respectively. + +Please tell us whether you have found \Doku{l2tabu} useful. We rely on +your feedback for improving our guide. + +\subsection*{Thanks to\dots} + +\dots{} +Ralf Angeli, +Christoph Bier, +Christian Faulhammer, +Jürgen Fenn, +Ulrike Fischer, +Yvon Henel, +Yvonne Hoffmüller, +David Kastrup, +Markus Kohm, +Thomas Lotze, +Frank Mittelbach, +Heiko Oberdiek, +Walter Schmidt, +Stefan Stoll, +Knut Wenzig, +Emanuele Zannarini, +and +Reinhard Zierke +for tips, remarks, and corrections of the German original version. + +\subsection*{Contributors to the English translation} + +Barbara Beeton, +Karl Berry, +Christoph Bier, +Stephen Eglen, +Klas Elmgren, +Gernot Hassenpflug, +Yvon Henel, +Hendrik Maryns, +Walter Schmidt, +Maarten Sneep, +Stefan Ulrich, +Jos\'{e} Carlos Santos, +Knut Wenzig, +Bruno Wöhrer, and +Federico Zenith +have contributed to the English version, making suggestions, or +encouraging development.\\ + +\noindent If we have forgotten anyone please +send an email to the maintainer of the respective language version. + +%\newpage + + +\clearpage +\tableofcontents +%\clearpage + +\section{`Deadly sins'\,---\,The most severe mistakes in using \LaTeXe} +\label{sec:todsunden} +In this section we probably have gathered together the most severe +mistakes that appear again and again in \News{de.comp.text.tex}, +leaving regulars either with a flush of anger or weeping with tears +in their eyes. \texttt{;-)} + +\subsection{\Paket{a4}, \Paket{a4wide}} +\label{sec:paketa4-paketa4wide} + +Do not use these `two' packages any longer. You should delete them +without replacement from your \LaTeX{} source. Use the class option +\Option{a4paper} instead. Speaking in terms of typography these +packages, or others similar to these do not provide good layout. What +is even worse, there is more than one version of these packages +around, and different versions of those packages are incompatible with +one another, providing deviating settings for page margins. So you +may not trust that your document will look the same\,---\,or just as bad? +-- when being compiled on someone else's system when exchanging +\LaTeX{} source. + +\Ersetze{\Paket{a4}, \normalcolor or \color{red} \Paket{a4wide}}{class option \Option{a4paper}} + +\subsection{Modifying page layout} +\label{sec:layoutanderungen} +Page margins produced by the standard classes (\Klasse{article}, +\Klasse{report}, \Klasse{book}) are often deemed too wide by European +users printing on A4 paper. They should use the corresponding classes +from the \KOMAScript{} bundle instead (\Klasse{scrartcl}, +\Klasse{scrreprt}, \Klasse{scrbook}). These classes have been made +with a European point of view on typography in mind. You can also use +\Paket{typearea} which is part of \KOMAScript{} with any other +document class. The documentation included in the bundle provides some +more information. Indeed, this very paper was typeset using +\Klasse{scrartcl}. + +If you really need to use page margins altogether different from the +ones produced by \Paket{typearea} use \Paket{geometry}, or +\Paket{vmargin} because these packages provide reasonable proportions +in setting page margins. Do not use \Macro{oddsidemargin} or similar +commands for modifying page layout. + +Under no circumstances change \Macro{hoffset}, or \Macro{voffset}, +unless you really understand what \TeX{} is doing here. + +\subsection{Changing packages and document classes} +\label{sec:ander-von-paket} +Never modify \LaTeX{} class files (\emph{e.g.}, \Klasse{article}, +\Klasse{scrbook}) or packages (style files, \emph{e.g.}, +\Paket{varioref}, \Paket{color}) directly! If you do not want to make +yourself a `container class', or a \texttt{.sty} file of your own you +should \emph{copy} the class, or style files, edit \emph{the copy}, +and save it as a \emph{different} file using a \emph{different} file +name. + +On how to create container classes see the +\Doku{De-TeX-FAQ}~\cite[question 5.1.5]{faq:02}. + +\paragraph{Note:} +\label{sec:hinweis} + +Install any additional files, or packages in the local texmf tree in +your \texttt{\$HOME} directory. Otherwise these changes will be +overwritten when upgrading your \TeX{} distribution. Styles or +packages you only need in one particular project or which you may want +to hand on to someone you wish to share your project with may as well +be saved in the current working directory. See the +\Doku{De-TeX-FAQ}~\cite[question 5.1.4]{faq:02}, or the \Doku{UK + FAQ}\cite[`Installing \LaTeX{} files', section K, `Where to put new +files', question 90]{ukfaq:99}. + +\subsection{Changing inter-line space using \texttt{\textbackslash + baselinestretch}} +\label{sec:ander-des-zeil} + +As a rule of thumb, parameters should be set on the highest possible +level within a user interface. So if you want to reset inter-line +space you can do so on three levels: +\begin{enumerate} +\item Either by using the \Paket{setspace} package; +\item or by using the \LaTeX{} command \LMacro{linespread}{<factor>}; +\item or by redefining \Macro{baselinestretch}. +\end{enumerate} +Redefining parameters such as \Macro{baselinestretch} works on the +lowest \LaTeX{} level available\,---\,which should better be left to +packages. The \Macro{linespread} command is provided for this, so it +is a better way to get more inter-line space than fiddling with +\Macro{baselinestretch}. It is even better, though, to use +\Paket{setspace} which also takes care of space in footnotes and list +environments that you usually don't want to change when modifying +inter-line space. + +So if you just need some more spacing between lines, say, you would +like to set spacing to one half or to double spacing, \Paket{setspace} +provides the easiest way to achieve this. However, if you only want to +use fonts other than Computer Modern you may use +\LMacro{linespread}{<factor>}. For example, when using Palatino +\LMacro{linespread}{1.05} would be appropriate. + +\subsection[Parindent and the spread between paragraphs +(\texttt{\textbackslash{}parindent}, +\texttt{\textbackslash{}parskip})]{Paragraph indent and the spread + between paragraphs (\texttt{\textbackslash{}parindent}, + \texttt{\textbackslash{}parskip})} +\label{sec:absatz-und-abst} + +It may make sense to change the indent of the first line in paragraphs +(\Macro{parindent}). However, if you do so, please note the following: +\begin{itemize} +\item Never use absolute sizes (\emph{e.g.}, `mm') to modify paragraph + indent. Use sizes that depend on font size, such as `em', for + example. The latter does \emph{not} mean that indent adapts + automatically when changing the font size. Rather, the value that + goes with the font currently activated is used. +\item Always use \LaTeX{} commands. For example, this may make it + easier to parse\footnote{That is to say, analyse syntactically, or + split up.} a \LaTeX{} file through an external program, or + script. Your code will be easier to maintain, too. So problems + concerning compatibility with other packages can be avoided as well + (\Paket{calc}, for example). + \Ersetze{\Macro{parindent}\texttt{=1em}}{\LMacro{setlength}{\Macro{parindent}}\{1em\}} +\end{itemize} +% +In case you prefer some additional space between paragraphs to +paragraph indent for marking the start of a new paragraph (`zero +paragraph indent') do \emph{not} use +\color{red} +\begin{verbatim} +\setlength{\parindent}{0pt} +\setlength{\parskip}{\baselineskip} +\end{verbatim} +\normalcolor +% +\Macro{parskip} should not be used as it will also modify settings for +list environments, table of contents, etc., and headings. + +The \Paket{parskip} package, however, as well as the \KOMAScript\ +classes go to some lengths to avoid these side effects. On how to use +these \KOMAScript{} class options (\Option{parskip}, +\Option{halfparskip}, etc.)\ see \Doku{scrguien}~\cite{kohm:03}. When +using one of the \KOMAScript{} classes you do \emph{not} need to load +\Paket{parskip}. + +\subsection{Separating maths formulae from continuous text using \texttt{\$\$\dots\$\$}} +\label{sec:abges-form-mit} + +Please don't do this! \texttt{\$\$\dots\$\$} is a Plain \TeX{} +command. It will modify vertical spacing within formulae, rendering +them inconsistent. This is why it should be avoided in \LaTeX{} (see +section~\vref{sec:mathematiksatz}; note the warning concerning +\texttt{displaymath} along with the \Paket{amsmath} package). What's +more, class option \Option{fleqn} won't work any more. + +\Ersetze{\texttt{\$\$\dots\$\$}}{% +\parbox[t]{.3\textwidth}{% +\Macro{[}\texttt{\dots}\Macro{]}\\ +\textcolor{black}{or}\\ +\Env{displaymath}{\dots}}} + +\subsection{\texttt{\textbackslash def} vs. \texttt{\textbackslash newcommand}} +\label{sec:def-vs.-newcommand} + +\emph{Always} use \NewCom{<name>}{\dots} for defining +macros.\footnote{See \cite[section 2.7.2]{clsguide}, \cite[section + 3.4]{usrguide}.} + +\emph{Never} use \Macro{def}\LMacro{<name>}{\dots}. The main problem +with \Macro{def} is that no check is done on whether there already +exists another macro of the same name. So a macro defined earlier may +be overwritten without any error warning. + +Macros may be re-defined using \ReNewCom{<name>}{\dots}. + +If you know \emph{why} you need to use \Macro{def} you will probably +know about the pros and cons of this command. Then, you may as well +ignore this subsection. + +\subsection{Should I use \texttt{\textbackslash sloppy}?} +\label{sec:verw-von-textttt} + +Frankly speaking, the \Macro{sloppy} switch should not be used at all. +Most notably you shouldn't use it in the preamble of a document. If +line breaks appear in single paragraphs you should + +\begin{enumerate} +\item check whether the right hyphenation patterns, \emph{e.g.}, + \Paket{(n)german}, and T1 fonts have been loaded (see + \Doku{De-TeX-FAQ}\cite[section 5.3]{faq:02}), or the \Doku{UK + FAQ}\cite[`Hyphenation', section Q.7]{ukfaq:99}; +\item put your text in other words. You do not necessarily need to + change the sentence the line break problem appears in. It may + suffice to change the preceding, or the next sentence; +\item slightly change some parameters \TeX{} uses for line-breaking, + and page-breaking. Axel Reichert suggested the following + solution\footnote{Of course you may change these values according to + taste, but beware of fiddling with \TB\texttt{emergencystretch}. + Otherwise you'll get quite sloppy justified text as you would get + with a rather well-known text processor.} on + \News{de.comp.text.tex}:\footnote{The posting may be found as + \MID{a84us0$plqcm$7@ID-30533.news.dfncis.de}{a84us0\$plqcm\$7@ID-30533.news.dfncis.de}}: + + \begin{minipage}[t]{\linewidth} +\begin{verbatim} +\tolerance 1414 +\hbadness 1414 +\emergencystretch 1.5em +\hfuzz 0.3pt +\widowpenalty=10000 +\vfuzz \hfuzz +\raggedbottom +\end{verbatim} + % \hspace{\baselineskip} % Yup, I know this isn't correct! ;-) + \end{minipage} + \par + + Note that warnings appearing with the above settings \emph{really} + should be taken seriously. You \emph{should} consider putting your + text in other words, then. +\end{enumerate} +% +Only if this fails you may try to typeset the following paragraph more +`loosely' using the \texttt{sloppypar} environment. +\begin{figure}[htp] + % If someone should wonder about the additional \fussy or the + % missing \sloppy : Use the Source Luke! \parbox by default typesets + % \sloppy, so for the original linebreak \fussy is required. + \begin{minipage}[t]{.45\textwidth} + \centering {\fontsize{10pt}{12pt}\fontencoding{OT1}\selectfont + \fbox{\parbox{16.27em}{\fussy% + tatata tatata tatata tatata tatata tatata tata\-tata tatata tatata + tatata tatata tatata tatata tata\-tata tatata tatata tatata tatata + ta\-tatatatt\-ta tatata tatata tatata tatata tatata tatata + ta\-ta\-ta\-ta}}} + \caption{\LaTeX' s default settings}% + \label{fig:beispiel-mit-latex}% + \end{minipage}% + \hfill% + \begin{minipage}[t]{.45\textwidth} + \centering + {\fontsize{10pt}{12pt}\fontencoding{OT1}\selectfont + \fbox{\parbox{16.27em}{% + tatata tatata tatata tatata tatata tatata tata\-tata tatata tatata + tatata tatata tatata tatata tata\-tata tatata tatata tatata tatata + ta\-tatatatt\-ta tatata tatata tatata tatata tatata tatata + ta\-ta\-ta\-ta}}} + \caption{This demonstrates the effect of \texttt{\string\sloppy}} + \label{fig:beisp-mit-textttstr} + \end{minipage} +\end{figure} + +In figures~\ref{fig:beispiel-mit-latex} +and~\vref{fig:beisp-mit-textttstr} I have tried to show the effect of +\Macro{sloppy}. This also depends on the font employed. When using +Times the negative effects of \Macro{sloppy} do not show as extremely +as with, say, Computer Modern. The effect in principle, however, +should become clear. + +In \News{comp.text.tex} Markus Kohm has posted an example that shows +this effect even better. With his kind permission I quote his code +appendix~\vref{sec:beispiel-zu-sloppy}. + +%----------------------- section "Obsolete" ------------------------ +\section{Some obsolete commands and packages} +\label{sec:obsoletes} + +Markus Kohm has written a Perl script you can test your files online +with for the most common mistakes. See +\url{http://kohm.de.tf/markus/texidate.html}. Please note, however, +that this script is not a complete \TeX{} parser. This is why it will +only check for the most common mistakes. Please test your file first, +then post for help to a newsgroup, or to a mailing list. + +\subsection{Commands} +\label{sec:befehle} + +\subsubsection{Changing font style} +\label{sec:ander-des-schr} +Table~\vref{tab:befehle-zur-anderung} shows obsolete and `proper' +commands in \LaTeXe{} side by side for changing font style. Macros +called `local' only apply to their own argument whereas those called +`global/switch' will apply to all following text till the end of the +document. + +\paragraph{Why not use obsolete commands?} +\label{sec:warum-sollte-man} + +Obsolete commands do not support \LaTeXe's new font selection scheme, +or NFSS. \GMacro{bf}{foo}, for example, resets all font attributes +which had been set earlier before it prints \emph{foo} in bold face. +This is why you cannot simply define a bold-italics style by +\GMacro{it}{\Macro{bf Test}} only. (This definition will produce: +{\it\bf Test}.) On the other hand, the new commands +\LMacro{textbf}{\LMacro{textit}{Test}} will behave as expected +producing: \textbf{\textit{Test}}. Apart from that, with the former +commands there is no `italic correction', cf. for instance {\it + half}hearted (\GMacro{it}{half}\texttt{hearted}) to +\textit{half}hearted (\LMacro{textit}{half}\texttt{hearted}). + +For an overview of NFSS see \cite{fntguide}. + +\begin{table} + \begin{minipage}{\textwidth} + \renewcommand{\footnoterule}{} + \centering + \caption{Commands for changing font style} + \label{tab:befehle-zur-anderung} + \begin{tabular}{@{}lll@{}} + \toprule + \multicolumn{1}{@{}N}{obsolete}& + \multicolumn{2}{C@{}}{Replacement in \LaTeXe}\\ + \cmidrule(l){2-3} + & + \multicolumn{1}{N}{local} & + \multicolumn{1}{N@{}}{global/switch}\\ + \cmidrule(r){1-1}\cmidrule(lr){2-2}\cmidrule(l){3-3} + \GMacro{bf}{\dots} & \LMacro{textbf}{\dots} & \Macro{bfseries}\\ + --- & \LMacro{emph}{\dots} & \Macro{em}\footnote{May be useful + when defining macros. In continuous text \LMacro{emph}{\dots} + should be preferred to \Macro{em}.}\\ + \GMacro{it}{\dots} & \LMacro{textit}{\dots} & \Macro{itshape}\\ + --- & \LMacro{textmd}{\dots} & \Macro{mdseries}\\ + \GMacro{rm}{\dots} & \LMacro{textrm}{\dots} & \Macro{rmfamily}\\ + \GMacro{sc}{\dots} & \LMacro{textsc}{\dots} & \Macro{scshape}\\ + \GMacro{sf}{\dots} & \LMacro{textsf}{\dots} & \Macro{sffamily}\\ + \GMacro{sl}{\dots} & \LMacro{textsl}{\dots} & \Macro{slshape}\\ + \GMacro{tt}{\dots} & \LMacro{texttt}{\dots} & \Macro{ttfamily}\\ + --- & \LMacro{textup}{\dots} & \Macro{upshape}\\ + \bottomrule + \end{tabular} +\end{minipage} +\end{table} + +\subsubsection{Mathematical fractions (\texttt{\textbackslash over} vs. \texttt{\textbackslash frac})} +\label{sec:textb-over-vs} + +Avoid the \Macro{over} command. \Macro{over} is a \TeX{} command which +due to the syntax differing from \LaTeX's is even more complicated to +parse or which cannot be parsed at all. The \Paket{amsmath} package +redefines \verb+\frac{}{}+ which will result in error messages when +using \Macro{over}. Another point in favour of using \verb+\frac{}{}+ +is that it is easier to fill in both the fraction's numerator and +denominator, especially with more complex fractions. + +\Ersetze{\texttt{\$a \textbackslash over b\$}}% +{\texttt{\$\textbackslash frac\{a\}\{b\}\$}} + +\subsubsection{Centering text using \texttt{\textbackslash centerline}} +\label{sec:centerline} + +The \Macro{centerline} command is another \TeX{} command you should +not use. On the one hand \Macro{centerline} is incompatible with some +\LaTeX{} packages, such as \Paket{color}. On the other hand the +package may yield unexpected results. +\emph{E.g.}: +\begin{center} + \begin{minipage}[t]{.45\textwidth} +\begin{verbatim} +\begin{enumerate} +\item \centerline{An item} +\end{enumerate} +\end{verbatim} + \end{minipage}% + \hfill% +% \hspace{.05\textwidth}% + \fbox{ \begin{minipage}[t]{.45\textwidth} + \begin{enumerate} + \item \centerline{An item} + \end{enumerate} + \end{minipage}} +\end{center} +\Ersetze{\LMacro{centerline}{\dots}}% +{\parbox[t]{.3\textwidth}{% + \GMacro{centering}{\dots}\\ +\textcolor{black}{or}\\ +\Env{center}{\dots} +}} + +\paragraph{Note:} +\label{sec:anmerkung-5} + +On how to center graphics and tables see +section~\vref{sec:gleit-figure-table}. + +\subsection{Class files and packages} +\label{sec:pakete} + +\subsubsection{\Klasse{scrlettr} vs. \Klasse{scrlttr2}} +\label{sec:paketscrl-vs.-pakets} + +\Klasse{scrlettr} class from the \KOMAScript\ bundle is obsolete. It +was replaced by \Klasse{scrlttr2}. In order to produce a +layout \emph{similar} to the former \KOMAScript\ letter class use +class option \Option{KOMAold} which provides a compatibility mode. + +\sbox{\Breite}{\texttt{\textbackslash documentclass\{scrltter\}}} +\Ersetzx[\wd\Breite]{\texttt{\textbackslash documentclass\{scrlettr\}}}% +{\texttt{\textbackslash documentclass[KOMAold]\{scrlttr2\}}} + +\paragraph{Note:} +\label{sec:anmerkung-3} + +For new templates and letters use the new interface. It is definitely +more flexible. + +It is not possible to elaborate on the differences between the two +user interfaces in this overview. See \Doku{scrguien}~\cite{kohm:03} +for details. + +\subsubsection{\Paket{epsf}, \Paket{psfig}, \Paket{epsfig} vs. + \Paket{graphics}, \Paket{graphicx}} +\label{sec:grafikeinbindung} + +The \Paket{epsf} and the \Paket{psfig} packages have been replaced by +\Paket{graphics} and \Paket{graphicx}. \Paket{epsfig} is just a +wrapper\footnote{A `wrapper' here denotes a style file which itself + loads another one or more style files, hence modelling functions.} +for processing old documents which had been done using \Paket{psfig} +with the \Paket{graphicx} package. + +As \Paket{epsfig} uses \Paket{graphicx} internally \Paket{epsfig} +still \emph{may} be used. You should not use it, though, for new +documents. \Paket{graphics} or \Paket{graphicx} should be preferred, +then. \Paket{epsfig} is mainly provided for reasons of compatibility, +as mentioned above. + +For the differences between \Paket{graphics}, and \Paket{graphicx} see +\Doku{grfguide}~\cite{graphicx:99}. For hints on centering graphics see +section~\vref{sec:gleit-figure-table}. + +\sbox{\Breite}{\LMacro{psfig}{file=Bild,\dots}} +\Ersetze{\parbox[t]{\wd\Breite}{\Use{psfig}\\% + \LMacro{psfig}{file=image,\dots}}}% +{\parbox[t]{.45\textwidth}{% + \Use{graphicx}\\% + \texttt{\textbackslash includegraphics[\dots]\{image\}}}} + +\subsubsection{\Paket{doublespace} vs. \Paket{setspace}} +\label{sec:zeilenabstande} + +For changing inter-line space use the \Paket{setspace} package. +\Paket{doublespace} is obsolete. It was replaced by \Paket{setspace}. +Cf. section~\vref{sec:ander-des-zeil}. + +\Ersetze{\Use{doublespace}}{\Use{setspace}} + +\subsubsection{\Paket{fancyheadings}, \Paket{scrpage} vs. \Paket{fancyhdr}, \Paket{scrpage2}} +\label{sec:lebende-kolumn} + +The \Paket{fancyheadings} package was replaced by \Paket{fancyhdr}. +Another way to modify headings is provided by the \Paket{scrpage2} +package from the \KOMAScript\ bundle. Do not use \Paket{scrpage} for +it is obsolete. For documentation on \Paket{scrpage2} see +\Doku{scrguien}~\cite{kohm:03}. + +\Ersetze{\Use{fancyheadings}}{\Use{fancyhdr}} +\Ersetze{\Use{scrpage}}{\Use{scrpage2}} + +\subsubsection{The \Paket{caption} family of packages} +\label{sec:die-caption-famile} + +The \Paket{caption2} package should no longer be used because there is +a new version (v3.x) of \Paket{caption}. Please make sure to use the +latest version of this package by loading \Paket{caption} like this: +\Ersetze{\Use{caption}}{\UseV{caption}{2004/07/16}} + +In case you used \Paket{caption2} before, please have a look into the +package documentation \Doku{anleitung}~\cite[section~8]{caption:04}. + +\subsubsection{\Paket{isolatin}, \Paket{umlaut} vs. \Paket{inputenc}} +\label{sec:eingabe-von-umlauten} + +\paragraph{Some general notes: } +\label{sec:generelles} + +Basically there are four ways to input German \emph{umlauts} and +other non-ASCII characters: + +\begin{enumerate} +\item \verb+H{\"u}lle+: This will work on any given system anytime. + + The main disadvantages, however, are that + kerning\footnote{`Kerning' means including positive or negative + space between characters depending on which characters are to be + typeset.} between letters is disturbed badly; it is extremely + complicated to input at least in a German-language text; and it is + rather hard to read in source code. + + So this variant should \emph{always} be avoided due to the problems + as far as kerning is concerned. + +\item With \verb+H\"ulle+ or \verb+H\"{u}lle+ the aforementioned + problems as far as kerning is concerned do not appear. It can be + used on every system, too. + + However it is just as tricky to input and to read the text as with + the above variant. + + This variant does make sense, however, when defining macros or style + files for it does not require a particular text file encoding nor + any additional packages.\label{item:die-eingabe-der} + +\item With \Paket{(n)german} or the \Option{(n)german} option in + \Paket{babel} German \emph{umlauts} can be input more easily + (\verb+H"ulle+). Again this will work on all systems. As both + \Paket{babel} and \Paket{(n)german} are available on all \TeX\ + systems there should be no problems as far as compatibility is + concerned. + + However, this again is tricky to input, and the source is + comparatively hard to read. + + This variant is best for use in continuous text. But it should be + avoided in macro definitions and in preambles. + +\item Direct input (\verb+Hülle+). The advantage of this variant is + obvious. You can input and read the continuous source text just as + any other `normal' text. + + On the other hand you have to tell \LaTeX{} which input encoding is + used. There may also be problems when exchanging files between + different systems. This is \emph{not} a problem for \TeX, or \LaTeX{} + itself, but it may cause \emph{problems in displaying text in + editors} on different systems. For example, a Euro currency + symbol encoded in iso-8859-15 (latin9) may be \emph{displayed} in an + editor on a windows box (CP1252) as \textcurrency\ . + + This variant is quite good for continuous text. It should, however, + be avoided in macro definitions and in preambles. +\end{enumerate} +% +To sum it up, in macros, in preambles, and in style files +\verb+H\"ulle+, or \verb+H\"{u}lle+ should be used, while in the rest +of the text you should either use \verb+H"ulle+, or \verb+Hülle+. + +\paragraph{Input Encoding} +\label{sec:eingabekodierung-1} + +Do \emph{not} use the packages \Paket{isolatin1}, \Paket{isolatin}, or +\Paket{umlaut} for setting input encoding! Those packages are either +obsolete, or they are not available on any given system. + +Use \Paket{inputenc}. There are four options available: +\begin{description} +\item[latin1/latin9] for Unix-like systems (latin1 also works on MS + Windows and Mac OS\,X) +\item[ansinew] for MS Windows +\item[applemac] for the Macintosh\footnote{latin1 encoding is + recommended for OS\,X users, too, as it is better fit for + exchanging files cross-platform than applemac. If you do so you + should, however, check the encoding settings of your editor first. + In the long run you might like to switch to unicode, but please + note that unicode support in \Paket{inputenc} still is a work in + progress at this point of time. Some users say they are content + with \Paket{ucs} from the \textsf{unicode} package.} +\item[cp850] for OS/2 +\end{description} + +\Ersetze{\Use{isolatin1}}{\UseO{latin1}{inputenc}} +\Ersetze{\Use{umlaut}}{\UseO{latin1}{inputenc}} + +\subsubsection{\Paket{t1enc} vs. \Paket{fontenc}} +\label{sec:schriftkodierung} + +Generally speaking, the topic has been dealt with sufficiently in both +the \Doku{De-TeX-FAQ}~\cite[questions 5.3.2, 5.3.3, 10.1.10]{faq:02}, +and the \Doku{UK FAQ}~\cite[`Why use \emph{fontenc} rather than +\emph{t1enc}', question 358]{ukfaq:99}. So all that remains to be said +is that \Paket{t1enc} is obsolete and hence should be replaced by +\Paket{fontenc}. + +\Ersetze{\Use{t1enc}}{\UseO{T1}{fontenc}} + +\subsubsection{\Bst{natdin} vs. \Bst{dinat}} +\label{sec:liter-nach-din} + +Style file \Bst{natdin} was replaced by \Bst{dinat}. +\Ersetze{\Bib{natdin}}{\Bib{dinat}} + +\subsection{Fonts} +\label{sec:schriften} + +`Fonts and \LaTeX' is a troublesome topic. Most discussions in +\News{de.comp.text.tex} start with the question why fonts display so +`fuzzy' in Adobe Acrobat\textsuperscript{\textregistered} Reader. Most +answers point to the \Paket{times} or \Paket{pslatex} packages. +However, those packages use completely different sets of fonts. + +For an overview of \LaTeXe's New Font Selection Scheme, or NFSS see +\cite{fntguide}. + +For making Computer Modern fonts display just fine in \emph{acroread} +see \Doku{De-TeX-FAQ}~\cite[question 9.2.3]{faq:02}, or \Doku{UK + FAQ}~\cite[`The wrong type of fonts in PDF', question 114]{ukfaq:99}. + +\subsubsection{\Paket{times}} +\label{sec:pakettimes} + +\Paket{times} is obsolete (see \Doku{psnfss2e} \cite{psnfss:02}). It +does set \Macro{rmdefault} to Times, \Macro{sfdefault} to Helvetica, +and \Macro{ttdefault} to Courier. But it does \emph{not} use the +corresponding mathematical fonts. What's more, Helvetica is not scaled +correctly which makes it appear too big in comparison. So if you want +to use the combination Times/\/Helvetica/\/Courier you should use: + +\sbox{\Breite}{\UseO{scaled=.95}{helvet}} +\Ersetze{\Use{times}}% +{\parbox[t]{\wd\Breite}{% + \Use{mathptmx}\\ + \UseO{scaled=.90}{helvet}\\ + \Use{courier}}} + +\paragraph{Note.} +\label{sec:anmerkung-1} + +The scaling factor for \Paket{helvet} together with Times should be +somewhere between $0.90$ and $0.92$. + +\subsubsection{\Paket{mathptm}} +\label{sec:mathptm} + +\Paket{mathptm} is the predecessor to \Paket{mathptmx}. So please use +the latter for typesetting mathematical formulae in Times. + +\Ersetze{\Use{mathptm}}{\Use{mathptmx}} + +\subsubsection{\Paket{pslatex}} +\label{sec:paketpslatex} + +\Paket{pslatex} internally works like \Paket{mathptm}$+$ +\Paket{helvet} (scaled). However, it uses a Courier font scaled too +narrowly. The main disadvantage in using \Paket{pslatex} is that it +does \emph{not} work with T1 and TS1 encodings. + +\Ersetze{\Use{pslatex}}{\parbox[t]{\wd\Breite}{\Use{mathptmx}\\\UseO{scaled=.90}{helvet}\\\Use{courier}}} + +\paragraph{Note on Courier for all combinations of Times/Helvetica} +\label{sec:anmerkung-zu-allen} + +You do not have to load \Paket{courier} at all. You may use the usual +\texttt{cmtt} font for typewriter faces. + +\subsubsection{\Paket{palatino}} +\label{sec:paketpalatino} + +\Paket{palatino} behaves like \Paket{times}\,---\,apart from setting +\Macro{rmdefault} to Palatino, of course. \Paket{palatino} is +obsolete, too. This is why it should not be used any more. + +\Ersetze{\Use{palatino}}{\parbox[t]{\wd\Breite}{\Use{mathpazo}\\\UseO{scaled=.95}{helvet}\\\Use{courier}}} + +\paragraph{Note:} +\label{sec:anmerkung-2} + +Scaling factor for \Paket{helvet} in combination with Palatino should +be set to $0.95$. + +Helvetica is \emph{not} the `best' sans-serif font at all for use with +Palatino. It rather is the best \emph{freely-available} one. He that +possesses a CorelDraw\textsuperscript{\textregistered}-CD (this may +well be an older version) can use Palatino quite well along with +Frutiger\footnote{Bitstream Humanist 777, bfr}, or +Optima\footnote{Bitstream Zapf Humanist, bop}. Walter Schmidt supplies +adaptations for using some PostScript fonts with \TeX{} on his +homepage.\footnote{Fonts for \TeX: + \url{http://home.vr-web.de/was/fonts}} + +\subsubsection{\Paket{mathpple}} +\label{sec:paketmathpple} + +This package was a predecessor to \Paket{mathpazo}. It lacks some +symbol fonts. So those fonts are taken from the Euler fonts instead. +Some other symbols are not fit for use with Palatino as the font +metrics are not correct. For details cf. +\Doku{psnfss2e}~\cite{psnfss:02}. + +\subsubsection{Typesetting upright greek letters} +\label{sec:aufr-griech-buchst} + +The passages I have marked as red in the following are not obsolete in +the sense of `you should not use this any more', but now editing text +is made much easier by \Paket{upgreek}. For some more hints on usage +please see the documentation \Doku{upgreek}~\cite{upgreek:01}. + +\minisec{The \Paket{pifont} tricks}\nopagebreak[4] +\sbox{\Breite}{\NewCom{uppi}{\LMacro{Pisymbol}{psy}\{112\}}} +\Ersetzx[\wd\Breite]{% + \Use{pifont}\\ + \NewCom{uppi}{\LMacro{Pisymbol}{psy}\{112\}}\\ + \Macro{uppi}\\ + \textcolor{black}{or}\\ + \NewCom[{[1]}]{upgreek}{\%\\ + ~\Macro{usefont}\{U\}\{psy\}\{m\}\{n\}\#1}\\ + \LMacro{upgreek}{p} +}% +{% + \Use{upgreek}\\ + \$\Macro{uppi}\$ +} + +\minisec{The \Paket{babel} trick} + +\Ersetzx[\wd\Breite]{% + \UseO{greek,\dots}{babel}\\ + \NewCom[{[1]}]{upgreek}{\%\\ + ~\LMacro{foreignlanguage}{greek}\{\#1\}}\\ + \LMacro{upgreek}{p} + } + {% + \Use{upgreek}\\ + \$\Macro{uppi}\$ +} + +\subsubsection{\Paket{euler} vs. \Paket{eulervm}} +\label{sec:euler-eulervm} + +Use \Paket{eulervm} instead of \Paket{euler} for mathematical +typesetting. \Paket{eulervm} is a \LaTeX{} package for using the +eulervm fonts. These are virtual math fonts based on both the Euler +and the CM fonts. consuming less of \TeX's resources and supplying +some improved math symbols. Improved \texttt{$\backslash$hslash} and +\texttt{$\backslash$hbar} are also supplied. Please see the package +documentation \Doku{eulervm}~\cite{eulervm:04} for details. + +\Ersetze{\Use{euler}}{\parbox[t]{\wd\Breite}{\Use{eulervm}}} + +%-------------------- section "Miscellanous" --------------------- +\section{Miscellaneous} +\label{sec:verschiedenes} + +This section\,---\,apart from~\vref{sec:der-anhang}\,---\,gives some more +general advice than the `deadly sins' section, pp.\,\pageref{sec:todsunden}\,ff. + +\subsection{Floats\,---\,`figure', `table'} +\label{sec:gleit-figure-table} + +For centering a float environment we recommend you use +\Macro{centering} instead of \newline\LMacro{begin}{center} \dots{} +\LMacro{end}{center} because the latter will include an additional +vertical skip you can do without in most cases. +\sbox{\Breite}{\LMacro{includegraphics}{bild}} +\Ersetze{\parbox[t]{\wd\Breite}{% + \Env{figure}{\Env{center}{\LMacro{includegraphics}{bild}}} }}% +{\parbox[t]{\wd\Breite}{% + \Env{figure}{\Macro{centering}\\% + \LMacro{includegraphics}{bild}} }} + +\paragraph{Note:} +\label{sec:anmerkung-4} + +However, when centering a region within continuous text or within a +\verb+titlepage+ environment this additional space may be welcome! + +\subsection{The appendix} +\label{sec:der-anhang} + +The appendix is introduced by the \Macro{appendix} \emph{command}. +Note that this is \emph{not an environment}. + +\sbox{\Breite}{\LMacro{begin}{appendix}} +\Ersetze{\parbox[t]{\wd\Breite}{% + \Env{appendix}% + {\LMacro{section}{Blub}}}}% +{\parbox[t]{.33\textwidth}{% + \Macro{appendix}\\ + \LMacro{section}{Blub} }} + +\subsection{Mathematical typesetting} +\label{sec:mathematiksatz} + +Generally speaking, you should use \Paket{amsmath} for advanced +mathematical typesetting, providing a number of new environments replacing +\texttt{eqnarray} in the first place. The main advantages of the +package are these: + +\begin{itemize} +\item Spacing within and around environments is more consistent. +\item Equation numbering will be placed in a way so that they will not + be printed over any more. +\item Some new environments, \emph{e.g.}, \texttt{split}, provide a + solution to split up long equations easily. +\item It is easy to define new operators (similar to \Macro{sin}, + etc.)\ with proper spacing. +\end{itemize} + +\paragraph{Warning:} +\label{sec:warnung} + +When using \Paket{amsmath} you should \emph{never} use the +\texttt{displaymath}, \texttt{eqnarray}, or \texttt{eqnarray*} +environments because those are not supported by \Paket{amsmath}. +Otherwise this would lead to inconsistent spacing. + +\texttt{\textbackslash [\dots\textbackslash]} is adapted correctly by +\Paket{amsmath}. So it may be used instead of \texttt{displaymath}. +\texttt{eqnarray}, and \texttt{eqnarray*} may be replaced by +\texttt{align}, or \texttt{align*}. For a complete overview of +\Paket{amsmath} see \Doku{amsldoc}~\cite{amsldoc:99}. + +\sbox{\Breite}{\LMacro{includegraphics}{bild}} +\Ersetze{% + \parbox[t]{\wd\Breite}{% + \Env{eqnarray}{% + a \&=\& b \textbackslash\textbackslash\\ + b \&=\& c \textbackslash\textbackslash\\ + a \&=\& c + } + }}% + {\parbox[t]{\wd\Breite}{% + \Env{align}{% + a \&= b \textbackslash\textbackslash\\ + b \&= c \textbackslash\textbackslash\\ + a \&= c + } + }} + + +\subsection{How to use \texttt{\TB graphicspath}} +\label{sec:die-verwendung-von} + +There are several reasons why you should avoid the +\Macro{graphicspath} macro. Replace it by setting environment variable +\texttt{TEXINPUTS}:\footnote{Cf. David Carlisle's answer on Markus + Kohm's `Bug-Report' at\newline + \url{http://www.latex-project.org/cgi-bin/ltxbugs2html?pr=latex/2618}} +\begin{enumerate} +\item There are \emph{different} separators in path names on different + platforms. While MS Windows and Unices both use a slash `/', a colon + `:' was used on Macintosh systems before Mac OS~X. +\item \TeX{} search takes longer than with using the kpathsea library + (with today's fast chips this is not as important an argument as it + used to be). +\item \TeX's memory is limited, and every picture uses part of this + memory. What's more, memory is not cleared during the compiling + process. +\end{enumerate} +% +In a Bourne shell use +\begin{verbatim} +$ TEXINPUTS=PictureDir:$TEXINPUTS latex datei.tex +\end{verbatim} +or add to \verb+~/.profile+ +\begin{verbatim} +export TEXINPUTS=./PictureDir:$TEXINPUTS +\end{verbatim}%$ +In the latter case the files in \texttt{PictureDir} will be found +within the current working directory. + +\noindent +Up to MS~Windows~98 the environment variable is set by adding +\begin{verbatim} +set TEXINPUTS=.\PictureDir;%TEXINPUTS% +\end{verbatim} +to your \texttt{autoexec.bat}. On MS Windows~NT-based systems +according to the `Microsoft Knowledge Base' the variable can be set by +rightclicking at \textsf{My Computer $\rightarrow$ System Properties + $\rightarrow$ Advanced $\rightarrow$ Environment + variables}.\footnote{On Windows~2000 you may use: + \textsf{Start} $\rightarrow$ Settings $\rightarrow$ Control Panel + $\rightarrow$ System.} + +The above are only some suggestions on how to proceed. I am well aware +that \texttt{TEXINPUTS} may be set in different ways. Please see the +documentation of your operating system, or of your \TeX{} distribution +for more. + +\subsection{Language-specific macros\,---\,\texttt{\textbackslash*name}} +\label{sec:die-macroname-makros} + +From time to time the question comes up in \News{de.comp.text.tex} how +to modify, \emph{e.g.}, the `References' heading to `Literaturliste' +or to something else. So I have compiled those macros in +table~\vref{tab:von-paketng-btw}. They have been taken from the +\Paket{german} package. Users who want to adapt macro output to other +languages may as well refer to this table as an example. + +So if you want to change the heading `List of Figures' to, say, +`Pictures' you may use the following command: +\begin{verbatim} +\renewcommand*{\listfigurename}{Pictures} +\end{verbatim} +The other macros are changed in the same way respectively. With +\Paket{babel} use the \Macro{addto} macro. For more details see the +\Doku{De-TeX-FAQ}~\cite{faq:02}. + +\begin{table} + \begin{minipage}{\textwidth} + \centering + \caption{Macros defined by \Paket{(n)german} or by \Paket{babel} + with the \Option{(n)german} option} + \label{tab:von-paketng-btw} + \begin{tabular}{@{}lll@{}} + \toprule + \multicolumn{1}{@{}N}{Name of macro} & + \multicolumn{1}{N}{Original definition} & + \multicolumn{1}{N@{}}{Usual output in German} \\ + \cmidrule(r){1-1}\cmidrule(lr){2-2}\cmidrule(l){3-3} + \Macro{prefacename} & Preface & Vorwort \\ + \Macro{refname}\footnote{In \texttt{article} class only.} + & References & Literatur \\ + \Macro{abstractname} & Abstract & Zusammenfassung \\ + \Macro{bibname}\footnote{In \texttt{report} and + \texttt{book} classes only.} + & Bibliography & Literaturverzeichnis \\ + \Macro{chaptername} & Chapter & Kapitel \\ + \Macro{appendixname} & Appendix & Anhang \\ + \Macro{contentsname} & Contents & Inhaltsverzeichnis \\ + \Macro{listfigurename} & List of Figures & Abbildungsverzeichnis \\ + \Macro{listtablename} & List of Tables & Tabellenverzeichnis \\ + \Macro{indexname} & Index & Index \\ + \Macro{figurename} & Figure & Abbildung \\ + \Macro{tablename} & Table & Tabelle \\ + \Macro{partname} & Part & Teil \\ + \Macro{enclname} & encl & Anlage(n) \\ + \Macro{ccname} & cc & Verteiler \\ + \Macro{headtoname} & To & An \\ + \Macro{pagename} & Page & Seite \\ + \Macro{seename} & see & siehe \\ + \Macro{alsoname} & see also & siehe auch \\ + \bottomrule + \end{tabular} + \end{minipage} +\end{table} +\clearpage +\appendix + +\begin{thebibliography}{99}\addcontentsline{toc}{section}{References}% + +\bibitem{amsldoc:99} \textsc{American Mathematical Society}: + \emph{User's Guide for the {\texttt{amsmath}} Package}. December 1999, + Version~2.0. \biburl{CTAN://macros/latex/required/amslatex/}. + +\bibitem{graphicx:99} \textsc{David~P. Carlisle}: \emph{Packages in the + `graphics' bundle}. January 1999. + \biburl{CTAN://macros/latex/required/graphics/}. + +\bibitem{ukfaq:99}\textsc{Robin Fairbairns}: \emph{The UK \TeX\ FAQ. + Your 407 Questions Answered.} WWW, Version~3.16, 30 June 2006, + \biburl{http://www.tex.ac.uk/faq}. + +\bibitem{kohm:03} \textsc{Markus Kohm}, \textsc{Frank Neukam} und + \textsc{Axel Kielhorn}: \emph{The KOMA-Script Bundle}. + \Doku{scrguien}. + \biburl{CTAN://macros/latex/supported/koma-script/}. + +\bibitem{clsguide} \textsc{The \LaTeX3 Project}: \LaTeXe{} for + class and package writers. 1999. + \biburl{CTAN://macros/latex/doc/clsguide.pdf} + +\bibitem{fntguide} \textsc{The \LaTeX3 Project}: \LaTeXe{} font + selection. 2000. + \biburl{CTAN://macros/latex/doc/fntguide.pdf} + +\bibitem{usrguide} \textsc{The \LaTeX3 Project}: \LaTeXe{} for + authors. 2001. + \biburl{CTAN://macros/latex/doc/usrguide.pdf} + +\bibitem{faq:02} \textsc{Bernd Raichle}, \textsc{Rolf Niepraschk} und + \textsc{Thomas Hafner}: \emph{Fragen und Antworten (FAQ) über das + Textsatzsystem {\TeX\ }und DANTE, Deutschsprachige + Anwendervereinigung {\TeX\ }e.V.} WWW, Version~72. September 2003, + \biburl{http://www.dante.de/faq/de-tex-faq/}. + +\bibitem{upgreek:01} \textsc{Walter Schmidt}: \emph{The + {\textsf{upgreek}} package for {\LaTeXe}}. May 2001, Version~1.0. + \biburl{CTAN://macros/latex/contrib/supported/was/}. + +\bibitem{psnfss:02} \textsc{Walter Schmidt}: \emph{Using common + PostScript fonts with {\LaTeX}}. April 2002, PSNFSS version 9.0. + \biburl{CTAN://macros/latex/required/psnfss/psnfss2e.pdf} + +\bibitem{eulervm:04} \textsc{Walter Schmidt}: \emph{The Euler Virtual Math + Fonts for use with {\LaTeX}}. Januar 2004, Version~3.0a. + \biburl{CTAN://fonts/eulervm/} + +\bibitem{l2kurz:99} \textsc{Walter Schmidt}, \textsc{Jörg Knappen}, + \textsc{Hubert Partl} und \textsc{Irene Hyna}: + \emph{{\LaTeXe}-Kurzbeschreibung}. April 1999, Version~2.1. + \biburl{CTAN://info/lshort/german/}. English Translation available + at \biburl{CTAN://info/lshort/english/} + +\bibitem{caption:04} \textsc{Axel Sommerfeld}: + \emph{Setzen von Abbildungs- und Tabellenbeschriftungen mit dem + caption-Paket}. Juli 2004, Version~3.0c. + \biburl{CTAN://macros/latex/contrib/caption/}. +\end{thebibliography} +\begin{center}$\ast$\ $\ast$\ $\ast$\end{center} +\bigskip +%--------------------------------------------------------------------- +\section{An example illustrating the effect of the \texttt{\TB sloppy} + command} +\label{sec:beispiel-zu-sloppy} +This is the example Markus Kohm published earlier: +\begin{bspcode}{\MID{8557097.gEimXdBtjU@ID-107054.user.dfncis.de}{8557097.gEimXdBtjU@ID-107054.user.dfncis.de}}% +\footnotesize +\begin{verbatim} +\documentclass{article} + +\setlength{\textwidth}{20em} +\setlength{\parindent}{0pt} +\begin{document} +\typeout{First without \string\sloppy\space and underfull \string\hbox} + +tatata tatata tatata tatata tatata tatata ta\-ta\-tata +tatata tatata tatata tatata tatata tatata tata\-tata +tatata tatata tatata tatata ta\-tatatatt\-ta +tatata tatata tatata tatata tatata tatata ta\-ta\-ta\-ta + +\typeout{done.} + +\sloppy +\typeout{Second with \string\sloppy\space and underfull \string\hbox} + +tatata tatata tatata tatata tatata tatata ta\-ta\-tata +tatata tatata tatata tatata tatata tatata tata\-tata +tatata tatata tatata tatata ta\-tatatatt\-ta +tatata tatata tatata tatata tatata tatata ta\-ta\-ta\-ta + +\typeout{done.} +\end{document} +\end{verbatim} +\end{bspcode} + +\clearpage +%--------------------------------------------------------------------- +\setlength{\columnsep}{2em} +\setlength{\columnseprule}{.5pt} +\begin{multicols}{2} +\section{GNU Free Documentation Licence} +\label{sec:fdl} + +\tiny + +\begin{center} + + Version 1.2, November 2002 + + + Copyright \copyright 2000,2001,2002 Free Software Foundation, Inc. + + \bigskip + + 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + + \bigskip + + Everyone is permitted to copy and distribute verbatim copies + of this license document, but changing it is not allowed. +\end{center} + +\subsubsection*{Preamble} + +The purpose of this License is to make a manual, textbook, or other +functional and useful document "free" in the sense of freedom: to +assure everyone the effective freedom to copy and redistribute it, +with or without modifying it, either commercially or noncommercially. +Secondarily, this License preserves for the author and publisher a way +to get credit for their work, while not being considered responsible +for modifications made by others. + +This License is a kind of "copyleft", which means that derivative +works of the document must themselves be free in the same sense. It +complements the GNU General Public License, which is a copyleft +license designed for free software. + +We have designed this License in order to use it for manuals for free +software, because free software needs free documentation: a free +program should come with manuals providing the same freedoms that the +software does. But this License is not limited to software manuals; +it can be used for any textual work, regardless of subject matter or +whether it is published as a printed book. We recommend this License +principally for works whose purpose is instruction or reference. + +\subsubsection*{1. APPLICABILITY AND DEFINITIONS} + +This License applies to any manual or other work, in any medium, that +contains a notice placed by the copyright holder saying it can be +distributed under the terms of this License. Such a notice grants a +world-wide, royalty-free license, unlimited in duration, to use that +work under the conditions stated herein. The \textbf{"Document"}, below, +refers to any such manual or work. Any member of the public is a +licensee, and is addressed as \textbf{"you"}. You accept the license if you +copy, modify or distribute the work in a way requiring permission +under copyright law. + +A \textbf{"Modified Version"} of the Document means any work containing the +Document or a portion of it, either copied verbatim, or with +modifications and/or translated into another language. + +A \textbf{"Secondary Section"} is a named appendix or a front-matter section of +the Document that deals exclusively with the relationship of the +publishers or authors of the Document to the Document's overall subject +(or to related matters) and contains nothing that could fall directly +within that overall subject. (Thus, if the Document is in part a +textbook of mathematics, a Secondary Section may not explain any +mathematics.) The relationship could be a matter of historical +connection with the subject or with related matters, or of legal, +commercial, philosophical, ethical or political position regarding +them. + +The \textbf{"Invariant Sections"} are certain Secondary Sections whose titles +are designated, as being those of Invariant Sections, in the notice +that says that the Document is released under this License. If a +section does not fit the above definition of Secondary then it is not +allowed to be designated as Invariant. The Document may contain zero +Invariant Sections. If the Document does not identify any Invariant +Sections then there are none. + +The \textbf{"Cover Texts"} are certain short passages of text that are listed, +as Front-Cover Texts or Back-Cover Texts, in the notice that says that +the Document is released under this License. A Front-Cover Text may +be at most 5 words, and a Back-Cover Text may be at most 25 words. + +A \textbf{"Transparent"} copy of the Document means a machine-readable copy, +represented in a format whose specification is available to the +general public, that is suitable for revising the document +straightforwardly with generic text editors or (for images composed of +pixels) generic paint programs or (for drawings) some widely available +drawing editor, and that is suitable for input to text formatters or +for automatic translation to a variety of formats suitable for input +to text formatters. A copy made in an otherwise Transparent file +format whose markup, or absence of markup, has been arranged to thwart +or discourage subsequent modification by readers is not Transparent. +An image format is not Transparent if used for any substantial amount +of text. A copy that is not "Transparent" is called \textbf{"Opaque"}. + +Examples of suitable formats for Transparent copies include plain +ASCII without markup, Texinfo input format, \LaTeX{} input format, SGML +or XML using a publicly available DTD, and standard-conforming simple +HTML, PostScript or PDF designed for human modification. Examples of +transparent image formats include PNG, XCF and JPG. Opaque formats +include proprietary formats that can be read and edited only by +proprietary word processors, SGML or XML for which the DTD and/or +processing tools are not generally available, and the +machine-generated HTML, PostScript or PDF produced by some word +processors for output purposes only. + +The \textbf{"Title Page"} means, for a printed book, the title page itself, +plus such following pages as are needed to hold, legibly, the material +this License requires to appear in the title page. For works in +formats which do not have any title page as such, "Title Page" means +the text near the most prominent appearance of the work's title, +preceding the beginning of the body of the text. + +A section \textbf{"Entitled XYZ"} means a named subunit of the Document whose +title either is precisely XYZ or contains XYZ in parentheses following +text that translates XYZ in another language. (Here XYZ stands for a +specific section name mentioned below, such as \textbf{"Acknowledgements"}, +\textbf{"Dedications"}, \textbf{"Endorsements"}, or \textbf{"History"}.) +To \textbf{"Preserve the Title"} +of such a section when you modify the Document means that it remains a +section "Entitled XYZ" according to this definition. + +The Document may include Warranty Disclaimers next to the notice which +states that this License applies to the Document. These Warranty +Disclaimers are considered to be included by reference in this +License, but only as regards disclaiming warranties: any other +implication that these Warranty Disclaimers may have is void and has +no effect on the meaning of this License. + +\subsubsection*{2. VERBATIM COPYING} + +You may copy and distribute the Document in any medium, either +commercially or noncommercially, provided that this License, the +copyright notices, and the license notice saying this License applies +to the Document are reproduced in all copies, and that you add no other +conditions whatsoever to those of this License. You may not use +technical measures to obstruct or control the reading or further +copying of the copies you make or distribute. However, you may accept +compensation in exchange for copies. If you distribute a large enough +number of copies you must also follow the conditions in section 3. + +You may also lend copies, under the same conditions stated above, and +you may publicly display copies. + +\subsubsection*{3. COPYING IN QUANTITY} + +If you publish printed copies (or copies in media that commonly have +printed covers) of the Document, numbering more than 100, and the +Document's license notice requires Cover Texts, you must enclose the +copies in covers that carry, clearly and legibly, all these Cover +Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on +the back cover. Both covers must also clearly and legibly identify +you as the publisher of these copies. The front cover must present +the full title with all words of the title equally prominent and +visible. You may add other material on the covers in addition. +Copying with changes limited to the covers, as long as they preserve +the title of the Document and satisfy these conditions, can be treated +as verbatim copying in other respects. + +If the required texts for either cover are too voluminous to fit +legibly, you should put the first ones listed (as many as fit +reasonably) on the actual cover, and continue the rest onto adjacent +pages. + +If you publish or distribute Opaque copies of the Document numbering +more than 100, you must either include a machine-readable Transparent +copy along with each Opaque copy, or state in or with each Opaque copy +a computer-network location from which the general network-using +public has access to download using public-standard network protocols +a complete Transparent copy of the Document, free of added material. +If you use the latter option, you must take reasonably prudent steps, +when you begin distribution of Opaque copies in quantity, to ensure +that this Transparent copy will remain thus accessible at the stated +location until at least one year after the last time you distribute an +Opaque copy (directly or through your agents or retailers) of that +edition to the public. + +It is requested, but not required, that you contact the authors of the +Document well before redistributing any large number of copies, to give +them a chance to provide you with an updated version of the Document. + +\subsubsection*{4. MODIFICATIONS} + +You may copy and distribute a Modified Version of the Document under +the conditions of sections 2 and 3 above, provided that you release +the Modified Version under precisely this License, with the Modified +Version filling the role of the Document, thus licensing distribution +and modification of the Modified Version to whoever possesses a copy +of it. In addition, you must do these things in the Modified Version: + +\begin{itemize} +\item[A.] + Use in the Title Page (and on the covers, if any) a title distinct + from that of the Document, and from those of previous versions + (which should, if there were any, be listed in the History section + of the Document). You may use the same title as a previous version + if the original publisher of that version gives permission. + +\item[B.] + List on the Title Page, as authors, one or more persons or entities + responsible for authorship of the modifications in the Modified + Version, together with at least five of the principal authors of the + Document (all of its principal authors, if it has fewer than five), + unless they release you from this requirement. + +\item[C.] + State on the Title page the name of the publisher of the + Modified Version, as the publisher. + +\item[D.] + Preserve all the copyright notices of the Document. + +\item[E.] + Add an appropriate copyright notice for your modifications + adjacent to the other copyright notices. + +\item[F.] + Include, immediately after the copyright notices, a license notice + giving the public permission to use the Modified Version under the + terms of this License, in the form shown in the Addendum below. + +\item[G.] + Preserve in that license notice the full lists of Invariant Sections + and required Cover Texts given in the Document's license notice. + +\item[H.] + Include an unaltered copy of this License. + +\item[I.] + Preserve the section Entitled "History", Preserve its Title, and add + to it an item stating at least the title, year, new authors, and + publisher of the Modified Version as given on the Title Page. If + there is no section Entitled "History" in the Document, create one + stating the title, year, authors, and publisher of the Document as + given on its Title Page, then add an item describing the Modified + Version as stated in the previous sentence. + +\item[J.] + Preserve the network location, if any, given in the Document for + public access to a Transparent copy of the Document, and likewise + the network locations given in the Document for previous versions + it was based on. These may be placed in the "History" section. + You may omit a network location for a work that was published at + least four years before the Document itself, or if the original + publisher of the version it refers to gives permission. + +\item[K.] + For any section Entitled "Acknowledgements" or "Dedications", + Preserve the Title of the section, and preserve in the section all + the substance and tone of each of the contributor acknowledgements + and/or dedications given therein. + +\item[L.] + Preserve all the Invariant Sections of the Document, + unaltered in their text and in their titles. Section numbers + or the equivalent are not considered part of the section titles. + +\item[M.] + Delete any section Entitled "Endorsements". Such a section + may not be included in the Modified Version. + +\item[N.] + Do not retitle any existing section to be Entitled "Endorsements" + or to conflict in title with any Invariant Section. + +\item[O.] + Preserve any Warranty Disclaimers. +\end{itemize} + +If the Modified Version includes new front-matter sections or +appendices that qualify as Secondary Sections and contain no material +copied from the Document, you may at your option designate some or all +of these sections as invariant. To do this, add their titles to the +list of Invariant Sections in the Modified Version's license notice. +These titles must be distinct from any other section titles. + +You may add a section Entitled "Endorsements", provided it contains +nothing but endorsements of your Modified Version by various +parties\,---\,for example, statements of peer review or that the text +has been approved by an organization as the authoritative definition +of a standard. + +You may add a passage of up to five words as a Front-Cover Text, and a +passage of up to 25 words as a Back-Cover Text, to the end of the list +of Cover Texts in the Modified Version. Only one passage of +Front-Cover Text and one of Back-Cover Text may be added by (or +through arrangements made by) any one entity. If the Document already +includes a cover text for the same cover, previously added by you or +by arrangement made by the same entity you are acting on behalf of, +you may not add another; but you may replace the old one, on explicit +permission from the previous publisher that added the old one. + +The author(s) and publisher(s) of the Document do not by this License +give permission to use their names for publicity for or to assert or +imply endorsement of any Modified Version. + +\subsubsection*{5. COMBINING DOCUMENTS} + +You may combine the Document with other documents released under this +License, under the terms defined in section 4 above for modified +versions, provided that you include in the combination all of the +Invariant Sections of all of the original documents, unmodified, and +list them all as Invariant Sections of your combined work in its +license notice, and that you preserve all their Warranty Disclaimers. + +The combined work need only contain one copy of this License, and +multiple identical Invariant Sections may be replaced with a single +copy. If there are multiple Invariant Sections with the same name but +different contents, make the title of each such section unique by +adding at the end of it, in parentheses, the name of the original +author or publisher of that section if known, or else a unique number. +Make the same adjustment to the section titles in the list of +Invariant Sections in the license notice of the combined work. + +In the combination, you must combine any sections Entitled "History" +in the various original documents, forming one section Entitled +"History"; likewise combine any sections Entitled "Acknowledgements", +and any sections Entitled "Dedications". You must delete all sections +Entitled "Endorsements". + +\subsubsection*{6. COLLECTIONS OF DOCUMENTS} + +You may make a collection consisting of the Document and other documents +released under this License, and replace the individual copies of this +License in the various documents with a single copy that is included in +the collection, provided that you follow the rules of this License for +verbatim copying of each of the documents in all other respects. + +You may extract a single document from such a collection, and distribute +it individually under this License, provided you insert a copy of this +License into the extracted document, and follow this License in all +other respects regarding verbatim copying of that document. + +\subsubsection*{7. AGGREGATION WITH INDEPENDENT WORKS} + +A compilation of the Document or its derivatives with other separate +and independent documents or works, in or on a volume of a storage or +distribution medium, is called an "aggregate" if the copyright +resulting from the compilation is not used to limit the legal rights +of the compilation's users beyond what the individual works permit. +When the Document is included in an aggregate, this License does not +apply to the other works in the aggregate which are not themselves +derivative works of the Document. + +If the Cover Text requirement of section 3 is applicable to these +copies of the Document, then if the Document is less than one half of +the entire aggregate, the Document's Cover Texts may be placed on +covers that bracket the Document within the aggregate, or the +electronic equivalent of covers if the Document is in electronic form. +Otherwise they must appear on printed covers that bracket the whole +aggregate. + +\subsubsection*{8. TRANSLATION} + +Translation is considered a kind of modification, so you may +distribute translations of the Document under the terms of section 4. +Replacing Invariant Sections with translations requires special +permission from their copyright holders, but you may include +translations of some or all Invariant Sections in addition to the +original versions of these Invariant Sections. You may include a +translation of this License, and all the license notices in the +Document, and any Warranty Disclaimers, provided that you also include +the original English version of this License and the original versions +of those notices and disclaimers. In case of a disagreement between +the translation and the original version of this License or a notice +or disclaimer, the original version will prevail. + +If a section in the Document is Entitled "Acknowledgements", +"Dedications", or "History", the requirement (section 4) to Preserve +its Title (section 1) will typically require changing the actual +title. + +\subsubsection*{9. TERMINATION} + +You may not copy, modify, sublicense, or distribute the Document except +as expressly provided for under this License. Any other attempt to +copy, modify, sublicense or distribute the Document is void, and will +automatically terminate your rights under this License. However, +parties who have received copies, or rights, from you under this +License will not have their licenses terminated so long as such +parties remain in full compliance. + +\subsubsection*{10. FUTURE REVISIONS OF THIS LICENSE} + +The Free Software Foundation may publish new, revised versions +of the GNU Free Documentation License from time to time. Such new +versions will be similar in spirit to the present version, but may +differ in detail to address new problems or concerns. See +http://www.gnu.org/copyleft/. + +Each version of the License is given a distinguishing version number. +If the Document specifies that a particular numbered version of this +License "or any later version" applies to it, you have the option of +following the terms and conditions either of that specified version or +of any later version that has been published (not as a draft) by the +Free Software Foundation. If the Document does not specify a version +number of this License, you may choose any version ever published (not +as a draft) by the Free Software Foundation. + +\subsubsection*{ADDENDUM: How to use this License for your documents} + +To use this License in a document you have written, include a copy of +the License in the document and put the following copyright and +license notices just after the title page: + +\begin{quote} + Copyright \copyright YEAR YOUR NAME. + Permission is granted to copy, distribute and/or modify this document + under the terms of the GNU Free Documentation License, Version 1.2 + or any later version published by the Free Software Foundation; + with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. + A copy of the license is included in the section entitled "GNU + Free Documentation License". +\end{quote} + +If you have Invariant Sections, Front-Cover Texts and Back-Cover Texts, +replace the "with...Texts." line with this: + +\begin{quote} + with the Invariant Sections being LIST THEIR TITLES, with the + Front-Cover Texts being LIST, and with the Back-Cover Texts being LIST. +\end{quote} + +If you have Invariant Sections without Cover Texts, or some other +combination of the three, merge those two alternatives to suit the +situation. + +If your document contains nontrivial examples of program code, we +recommend releasing these examples in parallel under your choice of +free software license, such as the GNU General Public License, +to permit their use in free software. + +\end{multicols} +%-------------------------------------------------------------------- +\section{\Doku{l2tabuen} revision history} + +\begin{description} +\item[v1.8.5.7] Some minor changes by \emph{Gernot Hassenpflug} to + English typography and style. +\item[v1.8.5.6] Adapted to the UK \TeX{} FAQ v3.16. +\item[v1.8.5.5] Minor fix in the section on \Macro{graphicspath} as to + the correct notation regarding Mac OS~X. Thanks to \emph{Stephen + Eglen}. Adapted to the UK \TeX{} FAQ v3.15a. +\item[v1.8.5.4] Minor additions and changes in source code applied. + Additions to the section on \texttt{\textbackslash baselinestretch}. + Thanks to \emph{Karl Berry}. +\item[v1.8.5.3] Adapted to the UK \TeX{} FAQ v3.13b. \emph{Legal + Notice} modified again, hopefully for the benefit of Debian users + and maintainers (\emph{'There are no invariant sections in this + document.'}). +\item[v1.8.5.2] Legal notice modified. +\item[v1.8.5.1] Some typos fixed in the section on + `graphicspath'. Thanks to \emph{Jos\'{e} Carlos Santos}. +\item[v1.8.5] Adapted to the UK \TeX{} FAQ v3.13. +\item[v1.8.4] GNU FDL made applicable to \Doku{l2tabuen}. `Revision + history' added. +\end{description} +\begin{center}$\ast$\ $\ast$\ $\ast$\end{center} +\end{document} +%%% Local variables: +%%% mode: LaTeX +%%% TeX-master: t +%%% coding: iso-8859-1 +%%% End: diff --git a/info/l2tabu/french/README b/info/l2tabu/french/README new file mode 100644 index 0000000000..5d51ff46e5 --- /dev/null +++ b/info/l2tabu/french/README @@ -0,0 +1,10 @@ +Fichier README pour la version française de +l2tabu + +Ceci est l'adaptation française de la version 2.3 de l2tabu, réalisée à partir +de la version allemande d'origine, de la version italienne et de la version +française précédente (1.7). Je remercie l’auteur de celle-ci, le TeXnicien de +surface, pour ses commentaires et ses précieux conseils. + +-- +Bernard Alfonsi diff --git a/info/l2tabu/french/l2tabufr.pdf b/info/l2tabu/french/l2tabufr.pdf Binary files differnew file mode 100644 index 0000000000..e0f78d6171 --- /dev/null +++ b/info/l2tabu/french/l2tabufr.pdf diff --git a/info/l2tabu/french/l2tabufr.tex b/info/l2tabu/french/l2tabufr.tex new file mode 100644 index 0000000000..daedc7de03 --- /dev/null +++ b/info/l2tabu/french/l2tabufr.tex @@ -0,0 +1,1470 @@ +%%%------------------------------------------------------------------ +%%% Filename: l2tabufr.tex +%%% Author: Marc Ensenbach <Marc.Ensenbach@post.rwth-aachen.de> +%%% Orig. Author: Mark Trettin <Mark.Trettin@gmx.de> +%%% Created: 07 Mär 2005 13:36:50 +%%% Last Modif.: 20 Sep 2011 +%%% Version: 2.3 +%%% +%%% Copyright (C) 2005 by Mark Trettin +%%% Copyright (C) 2010 by Marc Ensenbach +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%%% Traduction française : Bernard Alfonsi, à partir de la traduction de la version 1.7 +%%% par le TeXnicien de surface, de la version allemande 2.3 et de sa traduction italienne. + +%%% Créée le 12-7-2013 +%%%------------------------------------------------------------------ + +\documentclass[fontsize=11pt, paper=a4, pagesize, captions=tableheading, numbers=enddot, toc=graduated, footnotes=multiple]{scrartcl}% +%--------------- Configuration de base (français, 8bit) ---------------- +\usepackage[utf8]{inputenc} % Saisie directe des umlauts, etc. +\usepackage[T1]{fontenc} % Polices T1 +\usepackage{numprint} +\usepackage[autostyle, french=guillemets,german=guillemets]{csquotes} +\MakeAutoQuote{«}{»}% Autoquotes pour csquotes.sty +\usepackage{comment} +% -------------------------------- Polices --------------------------------- +\usepackage[scaled=.88]{beramono} % Bera-Monospace +\usepackage[scaled=.86]{berasans} % Bera Sans-Serif +\usepackage[osf]{mathpazo} % Palatino est la police par défaut +\linespread{1.05}\selectfont % Palatino requiert un interlignage plus grand +%%% Ce qui suit n’est pas très propre, mais ça marche (ici : Palatino) +\providecommand{\lining}{\fontfamily{ppl}\selectfont} +\providecommand{\oldstyle}{\fontfamily{fplj}\selectfont} +\DeclareTextFontCommand{\textln}{\lining} +\DeclareTextFontCommand{\textos}{\oldstyle} + +%------------ Extensions supplémentaires (graphiques, tableaux) --------------- +\usepackage{xspace} % espaces automatiques après les macros +\usepackage{booktabs,array} % tableaux plus avenants +\usepackage[french]{varioref} % modifié pour la version publique, + % car la version actuelle de fancy, et + % varioref ne fonctionnent pas ensemble + % (toujours pas ?!) + +\usepackage{textcomp} % Symboles supplémentaires +\usepackage[nofancy]{rcsinfo} % Données RCSdans les titres +\usepackage{varwidth} % Für die Ersetze-Umgebungen, +\usepackage{calc} % Pour calculer +\usepackage{amsmath, amssymb} +\usepackage{graphicx} +%--------------------------- Mise en forme --------------------------- +%%% Captions +\addtokomafont{pagehead}{\small\itshape} +\addtokomafont{sectioning}{\rmfamily} +\addtokomafont{caption}{\footnotesize\itshape} +\addtokomafont{captionlabel}{\scshape}% modifié par B. A. +\addtokomafont{descriptionlabel}{\rmfamily} +\setcapindent{1em} +\deffootnote{2.25em}{1.75em}{\thefootnotemark\enspace} +%%% Titres +\reversemarginpar +\renewcommand*{\othersectionlevelsformat}[1]{% + \makebox[0pt][r]{\csname the#1\endcsname\autodot\enskip}} +\renewcommand*{\captionformat}{~--~}%%ajout de B. A. +% --------------------------------- Couleurs----------------------------------- +\usepackage{color} +\definecolor{grau}{gray}{0.45} +\definecolor{rot}{rgb}{0.75,0.00,0.00} +\definecolor{blau}{rgb}{0.16,0.24,0.64} +\definecolor{gruen}{rgb}{0.18,0.58,0.08} +\definecolor{linkcolor}{rgb}{0,0,0.42} + +%--------------------------- Options PDF --------------------------- +\ifpdfoutput{% %Requiert les classes KOMA-Script + \usepackage{hyperref} % réglages de hyperref pour pdf[pagebackref] + \hypersetup{% + pdfauthor={(c) 2003, 2004, 2005, 2006, 2007 Mark Trettin, +2009, 2010, 2011 Marc Ensenbach},% + pdftitle={ Liste des péchés des utilisateurs de LaTeX 2e ou Commandes et extensions obsolètes, et autres erreurs},% + pdfsubject={Quelques conseils à propos de LaTeX 2e},% + bookmarksopen=true,% + %backref=true, + linktocpage=true, + urlcolor=linkcolor, + citecolor=linkcolor, + linkcolor=linkcolor, + colorlinks=true, + } + \usepackage{microtype} +%% Ultérieurement, il nous faudra la possibilité de désactiver la microtypographie% +%% pour les exemples qui démontreront le comportement standard de LaTeX [Marc] + \SetExpansion[context=slbsp, factor=0]{encoding={OT1, T1, TS1}}{} + \newcommand{\EMail}[1]{\href{mailto:#1?Subject=[l2tabu.pdf]}{courriel : \texttt{#1}}} + \newcommand{\News}[1]{\href{news:#1}{\texttt{#1}}} +%% Cette définition est fumeuse, il faudra que j’y réfléchisse de nouveau. :-( +%% Je ferai cela plus tard [Marc] + \newcommand{\MID}[2]{\href{http://groups.google.com/groups?as_umsgid=#1}% + {Message-ID: \texttt{<#2>}}} +%--------------------------- Options PS---------------------------- +}{% + \usepackage{hyperref} + \newcommand{\EMail}[1]{\href{mailto:#1}{\texttt{#1}}} + \newcommand{\News}[1]{\href{news:#1}{\texttt{#1}}} + \newcommand{\MID}[2]{\href{M-ID: <#1>}{Message-ID: \texttt{<#2>}}} + } +%-------------------------- Nouvelles commandes -------------------------- +%%% Volées à scrguide ;-) +\DeclareRobustCommand*{\Macro}[1]{\mbox{\texttt{\char`\\#1}}} +\DeclareRobustCommand*{\LMacro}[2]{\mbox{\texttt{\char`\\#1\{#2\}}}} +\DeclareRobustCommand*{\GMacro}[2]{\mbox{\texttt{\{\char`\\#1\ #2\}}}} + +%%% DANTE +\providecommand{\CTANserver}{ftp.dante.de} +%%% Fait de CTAN:// un alias de ftp://\CTANserver/tex-archive/ +\makeatletter +\def\url@#1{\expandafter\url@@#1\@nil} +\def\url@@#1://#2\@nil{% + \def\@tempa{#1}\def\@tempb{CTAN}\ifx\@tempa\@tempb + \hyper@linkurl{\Hurl{#1:#2}}{ftp://\CTANserver/tex-archive/#2}% + \else + \hyper@linkurl{\Hurl{#1://#2}}{#1://#2}% + \fi +} +\makeatother + +%%% Logo XeLaTeX (\XeTeX adapté du logo dtk) +\newcommand{\XeLaTeX}{\smash{X\kern-.1em\lower.5ex\hbox{\reflectbox{E}}\kern-.07em\LaTeX}} + +%%% de moi pour \dots +\pdfstringdefDisableCommands{% + \edef\dots{\string...}% +} + +%%% Hack tout à fait rudimentaire pour qu’une url tienne sur une seule ligne +%%% *sans* espacement supplémentaire +\newcommand{\biburl}[1]{\hfill\\URL:~\url{#1}} + +%%% Commandes +\newcommand{\zB}{zum Beispiel\xspace}%raccourci associé à l’allemand : par exemple +\newcommand{\ZB}{Zum Beispiel\xspace}%idem : Par exemple +\newcommand{\bzw}{beziehungsweise\xspace}%idem : respectivement +%%% documentation : SansSerif +\newcommand{\Doku}[1]{\textsf{#1}\xspace} +%%% extension , classe, style bibliographique : SansSerif +\newcommand{\Paket}[1]{\textsf{#1.sty}\xspace} +\newcommand{\PakeH}[1]{#1.sty\xspace} +\newcommand{\Klasse}[1]{\textsf{#1.cls}\xspace} +\newcommand{\KlassH}[1]{#1.cls\xspace} +\newcommand{\Bst}[1]{\textsf{#1.bst}\xspace} +\newcommand{\BstH}[1]{#1.bst\xspace} +%%% Options : SansSerif +\newcommand{\Option}[1]{\textsf{#1}\xspace} + +\newcommand{\TB}{\textbackslash} + +%%% Cela ne me plaît plus. Suggestion ? +%%% Non. J’y réfléchirai plus tard. [Marc] +\newcommand{\schlecht}[1][!]{\marginline{\texttt{#1}}} + +%%%% Ambiente "NON\dots MA" +%\newenvironment{Ers}[1][\linewidth]{% +% \par\smallskip\noindent\textcolor{rot}{\textbf{\textsf{NON:}}\marginline{$ +% \triangleright$}}~\rahmenpr[#1]}% +%{\endrahmenpr\hfill} +%\newenvironment{Dur}[1][\linewidth]{% +%\noindent\textcolor{gruen}{\textbf{\textsf{MA:}}}~\rahmenpg[#1]}% +%{\endrahmenpg\noindent} +% +%% Ambiente "Schecht" +%\newenvironment{Schlecht}[1][\linewidth]{% +% \par\smallskip\rahmenpr[#1]}% +%{\endrahmenpr\par\noindent} +% +%% Ambienti "rahmenlength" e "rahmenpg" +%\newsavebox{\rahmenbox} +%\setlength{\fboxrule}{0.6pt} +%\newlength{\rahmenlength} +%\newenvironment{rahmenpr}[1][\linewidth]{% +% \setlength{\rahmenlength}{#1-2\fboxsep-2\fboxrule}% +% \begin{lrbox}{\rahmenbox}\begin{varwidth}[t]{\rahmenlength}} +% {\end{varwidth}\end{lrbox}\noindent\fcolorbox{rot}{white}{\usebox{\rahmenbox}}\vspace*{.5ex}} +%\newenvironment{rahmenpg}[1][\linewidth]{% +% \setlength{\rahmenlength}{#1-2\fboxsep-2\fboxrule}% +% \begin{lrbox}{\rahmenbox}\begin{varwidth}[t]{\rahmenlength}} +% {\end{varwidth}\end{lrbox}\noindent\fcolorbox{gruen}{white}{\usebox{\rahmenbox}}\vspace*{.5ex}} + +%%%Environnement « Remplacez » +\newenvironment{Ers}[1][\linewidth]{% + \par\bigskip\noindent\marginline{\textcolor{gruen}{\boldmath $\triangleright$}}\begin{tabular}[t]{@{}p{0.5\textwidth}@{}}\textcolor{rot}{\textbf{\textsf{Remplacez~:}}% +}\\[2pt] \rahmenpr[#1]}% +{\endrahmenpr\end{tabular}} +% % «... par : » +\newenvironment{Dur}[1][0.5\textwidth]{% +\noindent\begin{tabular}[t]{@{}p{0.5\textwidth - 0.5em}@{}}\textcolor{gruen}{\textbf{\textsf{par~:}}}\\[2pt]\rahmenpg[#1]}% +{\endrahmenpg\end{tabular}\smallskip\noindent} + +%%% Environnement Schlecht (« mauvais ») +\newenvironment{Schlecht}[1][\linewidth]{% + \par\medskip\rahmenpr[#1]}% +{\endrahmenpr\par\noindent} + +%%% Environnements « rahmenpr » et « rahmenpg » +\newsavebox{\rahmenbox} +\setlength{\fboxrule}{0.6pt} +\setlength{\fboxsep}{1ex} %% ajouté par moi — au lieu de 3 pt +\newlength{\rahmenlength} + +\newenvironment{rahmenpr}[1][0.5\linewidth]{% + \setlength{\rahmenlength}{#1-2\fboxsep-2\fboxrule}% + \begin{lrbox}{\rahmenbox}\begin{varwidth}[t]{\rahmenlength}} + {\end{varwidth}\end{lrbox}\noindent\fcolorbox{rot}{white}{\usebox{\rahmenbox}}\vspace*{.5ex}} + +\newenvironment{rahmenpg}[1][0.5\linewidth]{% + \setlength{\rahmenlength}{#1-2\fboxsep-2\fboxrule}% + \begin{lrbox}{\rahmenbox}\begin{varwidth}[t]{\rahmenlength}} + {\end{varwidth}\end{lrbox}\noindent\fcolorbox{gruen}{white}{\usebox{\rahmenbox}}\vspace*{.5ex}} + +% Environnement description : espacement un peu plus petit entre deux items +\newenvironment{description*}{% + \description% + \setlength{\itemsep}{0pt}}% + {\enddescription} +\newsavebox{\Quelle} + +% Environnement « Exemple de code » +\newenvironment{bspcode}[1]{% + \sbox{\Quelle}{\footnotesize Source : #1} + \center + \rule{\linewidth}{1.5pt} +}{% + \rule{\linewidth}{1.5pt} + \usebox{\Quelle} + \endcenter% +} + +%------------------- Définitions de colonnes pour tableaux-------------------- +% Requiert l’extension array +\newcolumntype{F}{>{\footnotesize}l}%% N dans l’original, mais déjà pris par numprint (B. A.) + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +\usepackage[ngerman, frenchb]{babel} % Motifs de césure français +\frenchbsetup{ReduceListSpacing = true, IndentFirst = false, }% +\addto{\captionsfrench}{\renewcommand*{\pagename}{p.}\renewcommand{\figurename}{Fig.}} +%%% ------------- macros pour la traduction française ------------- +\newcommand{\NDT}{[T\textsubscript{dS}].} % ça c'est moi ;) +\newcommand{\PakeT}[1]{\textsf{\textsl{#1.sty}}}% +\renewcommand{\thefootnote}{\lining\arabic{footnote}} +\renewcommand{\labelenumi}{\lining\arabic{enumi}.} +\renewcommand{\thesection}{\lining\arabic{section}} + +\def\reftextfaraway#1{p.~\pageref{#1}}% redéfinition de varioref +%%%-----------– extensions supplémentaires ------------------- +\usepackage[para]{threeparttable} +\renewcommand{\TPTtagStyle}{\textit} +\usepackage[shortlabels]{enumitem} + +\makeatletter +\newcommand{\oldstyleroman}[1]{\expandafter\@oldstyleroman#1\@nil} +\def\@oldstyleroman#1#2\@nil{% + \ifcat$\detokenize{#2}$% + \expandafter\@firstoftwo + \else + \expandafter\@secondoftwo + \fi + {\if#1ij\else#1\fi}% si #2 est vide + {#1\@oldstyleroman#2\@nil}% si #2 n'est pas vide +} +\def\scroman#1{\expandafter\@scroman\csname c@#1\endcsname} +\def\@scroman#1{{\scshape\romannumeral #1}} +\def\osroman#1{\expandafter\@osroman\csname c@#1\endcsname} +\def\@osroman#1{\oldstyleroman{\romannumeral #1}} +%%\def\osroman#1{\expandafter\@osroman\csname c@#1\endcsname} +%%\def\@osroman#1{{\shortromannumeral #1}} +\makeatother +% +%\usepackage{modroman} + +\raggedbottom + +%----------------------- début du document ----------------------- + +\begin{document} +%\begin{Form}\end{Form} +\pagestyle{headings} +%%% RCS Info for version control +\rcsInfo $Id: l2tabu.tex,v 2.3 2011/09/20 09:18:00 yvon Exp $ +%%%----------------------------- Page de titre ---------------------------- + +\pagenumbering{osroman} +\begin{titlepage} +\pdfbookmark[1]{Page de titre}{tit} +\begin{flushleft} + \noindent + \rule{\linewidth}{1pt}% + \vspace{2\baselineskip} + {\LARGE\bfseries + Liste des péchés des utilisateurs de \LaTeXe\\[1ex] + \large + \quad ou\\[0.5\baselineskip] + Commandes et extensions obsolètes, et autres erreurs}\\ + \vspace{2\baselineskip} + \noindent + \rule{\linewidth}{1pt}% +\end{flushleft} + \vspace{\baselineskip} +\begin{flushright} + \textit{Marc Ensenbach, Mark Trettin}\\ + \EMail{Marc.Ensenbach@post.rwth-aachen.de}\\[1.5\baselineskip] + Version \rcsInfoRevision\ du \rcsInfoLongDate\\[1.5\baselineskip] + {\footnotesize Traduction française de Bernard Alfonsi\\ + \EMail{bernard.alfonsi@free.fr}}\\[4\baselineskip] +\end{flushright} + \vspace{\baselineskip} + \begin{center} + \let\footnoterule\relax + \begin{minipage}{.9\linewidth} + \small + \begin{center} + \textbf{Résumé} + \end{center} + \noindent + +%%%%%%%%%%%%% Traduction de l’introduction italienne %%%%%%%%%%%%%%% +% Elle correspond dans une large mesure à la version originale allemande la plus récente et, hormis des modifications et ajouts mineurs, ne s’en écarte de façon significative que dans la section \vref{sec:die-verwendung-von}, qui a été complètement récrite. Les parties modifiées ont été indiquées en note, à la demande explicite de l’auteur. Le traducteur, qui s’est servi des remarques soulevées à ce sujet par les membres du \GuIT, désire remercier ici tout particulièrement Claudio Beccari et Tommaso Gordini. Enfin, ma reconnaissance va à l’auteur, Marc Ensenbach, qui a lu avec soin cette version italienne et fait des remarques supplémentaires. +%%%%%%%%%%%%% Fin de l’\/introduction italienne %%%%%%%%%%%%%%%%%%% + \emph{Ceci est la version française de «l2tabu». — } +La rédaction de ce bref aperçu a été suscitée par une discussion dans le newsgroup \TeX{} de langue allemande\footnote{\News{de.comp.text.tex}}, où revenaient de façon récurrente des extensions et des commandes obsolètes ou «mauvaises». + +Nous essayons dans cet article de montrer les erreurs les plus communes et de proposer des solutions différentes. Cet article n’entend pas remplacer des introductions comme \Doku{l2kurz}~\cite{l2kurz-12} ni \Doku{De-TeX-FAQ}\footnote{\url{http://projekte.dante.de/DanteFAQ/WebHome}}, ni \Doku{The UK \TeX{} FAQ}~\cite{ukfaq-13}, mais offrir un simple aperçu. + +Nous serions reconnaissants de vos suggestions, améliorations et commentaires. + \end{minipage} + \end{center} + \vfill +\end{titlepage} +%------------------------ Fin de la page de titre ---------------------------- + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%Copyright +{\setlength{\parindent}{0pt} +Copyright \copyright{} 2003--2007 by Mark Trettin, 2009--2011 by Marc Ensenbach. \medskip + +This material may be distributed only subject to the terms and conditions set forth in the \emph{Open Publication License}, v1.0 or later (the latest version is presently available at \url{http://www.opencontent.org/openpub/}). +\medskip + +Cette documentation peut être distribuée seulement aux termes et conditions de l’\emph{Open Publication License}, v1.0 ou postérieure (la version la plus récente est actuellement disponible à l’adresse : \url{http://www.opencontent.org/openpub/}). +\medskip + +Les noms de \emph{software} et de \emph{hardware} mentionnés dans cet article sont pour la plupart, des marques déposées, soumises, comme telles, aux dispositions légales. +\vfill + +Nous remercions : \\ +Ralf Angeli, +Christoph Bier, +Christian Faulhammer, +Jürgen Fenn\footnote{Traduction anglaise : \url{CTAN://info/l2tabu/english/l2tabuen.pdf}}, +Ulrike Fischer, +Ralf Heckmann, +Yvon Henel\footnote{Traduction française : \url{CTAN://info/l2tabu/french/l2tabufr.pdf}}, +Yvonne Hoffmüller, +David Kastrup, +Markus Kohm, +Thomas Lotze, +Gonzalo Medina Arellano\footnote{Traduction espagnole : \url{CTAN://info/l2tabu/spanish/l2tabues.pdf}}, +Frank Mittelbach, +Heiko Oberdiek, +Mauro Sacchetto\footnote{Traduction italienne : \url{CTAN://info/l2tabu/italian/l2tabuit.pdf}}, +Walter Schmidt, +Uwe Siart, +Stefan Stoll, +Knut Wenzig, +Emanuele Zannarini\footnote{Traducteur de la première version italienne, 2005} +et Reinhard Zierke, \\ +pour leurs conseils, remarques et corrections. Au cas où nous aurions oublié quelqu’un, qu’il veuille bien nous envoyer un courriel. \medskip + +\emph{Traduction française à partir de la version 2.3, de sa traduction italienne et de la traduction française de la version 1.7 faite par Le \TeX nicien de surface. } +%%%% À compléter… +} + +\clearpage +\tableofcontents +\clearpage +\pagenumbering{arabic} + +\section{«Péchés mortels»} +\label{sec:todsunden} + +Dans cette section, nous avons recueilli les erreurs sans doute les plus graves qui apparaissent très régulièrement sur \News{de.comp.text.tex}, laissant les habitués devant cette alternative : devenir rouges de colère ou fondre en larmes. + +\subsection{\Paket{a4}, \Paket{a4wide}} +\label{sec:paketa4-paketa4wide} + +On ne devrait plus utiliser \emph{aucune} de ces deux extensions. Vous devriez les éliminer sans les remplacer dans vos sources \LaTeX. Elles sont remplacées par l'option de classe \Option{a4paper} pour les classes standard, ou par l’option analogue \Option{paper=a4} pour \KOMAScript{} à compter de la version 3. La mise en page que produisent ces extensions est plus que critiquable d'un point de vue typographique. Pire, il y a plus d'une version de ces extensions dans la nature et toutes ces versions sont incompatibles entre elles. Elles fournissent différentes dispositions pour l’empagement. On ne peut même pas être sûr qu’un document, compilé sur un autre système, aura le même – mauvais – aspect. + +\subsection{Modifier la mise en page} +\label{sec:layoutanderungen} + +Les marges produites par les classes standard – \Klasse{article},\Klasse{report}, \Klasse{book}– semblent souvent trop grandes. Dans ce cas vous devriez utiliser les classes – \Klasse{scrartcl}, \Klasse{scrreprt}, \Klasse{scrbook} – du paquet \KOMAScript, ou bien l'extension \Paket{typearea} qui est contenue dans \KOMAScript. La documentation incluse \Doku{scrguide}~\cite{kohm-12} dans le paquet donne de nombreuses informations complémentaires. + +Si l’on doit vraiment utiliser un empagement différent de celui produit par l'extension \Paket{typearea}, il faut alors plutôt utiliser l’extension \Paket{geometry}. Il ne faut pas tenter de modifier la mise en page à coups de \Macro{oddsidemargin} \& C\up{ie}. L’extension \Paket{anysize} est obsolète, et l’extension \Paket{vmargin}, autrefois recommandée, devrait être évitée, car elle peut produire des effets secondaires indésirables\footnote{Cf aussi \MID{uirrzdr16.fsf@uwe-siart.de}{uirrzdr16.fsf@uwe-siart.de}}. + +Il ne faudrait changer \Macro{hoffset} ou \Macro{voffset} sous aucun prétexte, à moins que de comprendre parfaitement le fonctionnement interne de \TeX. + +\subsection{Changer les extensions et les classes} +\label{sec:ander-von-paket} + +Il ne faut jamais changer directement les classes \LaTeX\ – par exemple \Klasse{article}, \Klasse{scrbook}, \&c. – ou les extensions-fichiers de style, par exemple \Paket{varioref}, \Paket{color} ! Ou bien on écrit une «classe-conteneur», ou son propre fichier \texttt{.sty}, ou bien on \emph{copie} les fichiers de classe ou de style, on modifie la \emph{copie} et on la sauvegarde dans un fichier \emph{différent} avec un nom de fichier \emph{différent}. + +Pour un exemple d’écriture d’une classe-conteneur, voyez \Doku{De-TeX-FAQ} sur l’adaptation des classes de documents\footnote{\url{http://projekte.dante.de/DanteFAQ/Dokumentenklasse}}, ou \Doku{UK FAQ}\cite{ukfaq-13} («Installing \LaTeX\ files», section J). + +\paragraph{Indication.} +\label{sec:hinweis} +En général, de telles classes et extensions supplémentaires devraient être installées dans l’arborescence \TeX{} locale ou bien dans l’arborescence personnelle (présente dans le répertoire \texttt{\$HOME} des systèmes Unix), afin que les changements ne soient pas écrasés lors d’une mise à jour de votre distribution \TeX. Si ces modifications sont utilisées pour un projet spécifique, que vous avez l’intention de transmettre, elles peuvent aussi bien être sauvegardées dans le répertoire de travail du projet. + +\subsection{Modification de l'interligne avec \texttt{\textbackslash baselinestretch}} + +\label{sec:ander-des-zeil} +De manière générale, les modifications des paramètres devraient s’effectuer au niveau le plus haut possible. Par conséquent, les modifications de l’interlignage peuvent s’effectuer à trois niveaux : +\begin{enumerate} +\item Utiliser l’extension \Paket{setspace}. +\item Utiliser la commande \LaTeX{} \LMacro{linespread}{<Facteur>}. +\item Redéfinir \Macro{baselinestretch}. +\end{enumerate} +Une redéfinition de paramètres comme \Macro{baselinestretch} opère au plus bas niveau, et devrait donc être réservée aux extensions. Une meilleure méthode, précisément parce qu’elle a été expressément prévue pour cela, consiste à utiliser la commande \LMacro{linespread}{<Facteur>}. La meilleure façon de procéder est cependant d’utiliser l’extension \Paket{setspace}, qui veille, lors de modifications de l’interlignage, à maintenir les espacements corrects dans les notes de bas de page ou les environnements de listes, pour lesquels les modifications ne sont le plus souvent pas souhaités. + +Si donc, on a besoin d’un interligne plus important (par exemple, 1,5 ou 2), on recourra avant tout à l’extension \Paket{setspace}. Si en revanche, on ne souhaite faire que des ajustements minimes pour une police de caractères autre que Computer Modern (par exemple Palatino), alors il sera plus judicieux d’employer \LMacro{linespread}{<Facteur>}. + +Dans le cas de Palatino, on pourra utiliser par exemple \LMacro{linespread}{1.05}. + +\subsection{Indentation et espace entre les paragraphes + – \texttt{\TB parindent}, \texttt{\TB parskip}} +\label{sec:absatz-und-abst} + +Il peut être parfois judicieux de changer le renfoncement – ou alinéa\footnote{Appelé encore, improprement, par décalque de l'anglais : «indentation»\NDT}– c'est-à -dire le retrait de la première ligne d'un paragraphe – \Macro{parindent}. On devrait cependant respecter ce qui suit : + +\begin{itemize} +\item la modification de l’alinéa s’exprime avec une unité dépendant du caractère («em») et non avec une unité absolue («mm»). Cette «dépendance» signifie en l’occurrence que, non seulement l’alinéa varie avec la taille de la police, mais aussi avec la police employée, puisque la largeur de 1\,em est adaptée au cas par cas, pour chaque police, par son créateur. + +\item il faut utiliser la syntaxe de \LaTeX{}, car c’est elle qui pose le moins de problèmes. Par exemple, elle est plus facile à «parser\footnote{Faire l’analyse syntaxique, décomposer.}» pour un programme ou un script externe, la maintenance en est plus simple pour l’utilisateur, et il n’y a pas d’incompatibilité avec d’autres extensions comme \Paket{calc}. +\end{itemize} + \begin{Ers} + \Macro{parindent}\texttt{=1em} + \end{Ers} +\begin{Dur} + \LMacro{setlength}{\Macro{parindent}\}\{1em} + \end{Dur} +Toutefois si à l'alinéa vous préférez un espace vertical additionnel pour marquer le début d'un nouveau paragraphe, \emph{n'utilisez pas} simplement : + +\begin{Schlecht} +\begin{verbatim} +\setlength{\parindent}{0pt} +\setlength{\parskip}{\baselineskip} +\end{verbatim} +\end{Schlecht}% +\vspace{0.2ex}\\ +car \Macro{parskip} a aussi une incidence sur les environnements de liste, la table des matières et les en-tête. + +L'extension \Paket{parskip}et les classes \KOMAScript\ s'efforcent néanmoins d'éviter ces effets secondaires. Pour savoir comment utiliser les options de \KOMAScript\ (\Option{parskip}, \Option{halfparskip}, \&c.), voir \Doku{scrguien}~\cite{kohm-12}. Lorsque l'on utilise une des classes de \KOMAScript\, on \emph{ne doit pas} charger \Paket{parskip} par surcroît. + +\subsection{Mettre en évidence les formules mathématiques avec \texttt{\$\$\,\textellipsis\,\$\$}} +\label{sec:abges-form-mit} + +S'il vous plaît, ne le faites pas ! \texttt{\$\$\,\textellipsis\,\$\$} est une commande plain\TeX{} qui devrait être évitée en \LaTeX. Cela rendrait incohérents les espacements verticaux des formules ainsi mises en évidence, — voir aussi la section~\vref{sec:mathematiksatz} ; notez l'avertissement concernant \texttt{displaymath} en rapport avec l'extension \Paket{amsmath}. De plus, l'option de classe \Option{fleqn} ne fonctionne plus dans un tel cas. + +\begin{Ers} +\verb|$$ ... $$| +\end{Ers} +\begin{Dur} +\begin{verbatim} +\[ ... \] +\end{verbatim} + ou (seulement avec \Paket{amsmath}) +\begin{verbatim} +\begin{equation*} + ... +\end{equation*} +\end{verbatim} +ou bien (seulement sans \Paket{amsmath}) +\begin{verbatim} +\begin{displaymath} + ... +\end{displaymath} +\end{verbatim} +\end{Dur} + +\subsection{\texttt{\TB def} \& \texttt{\TB newcommand}} +\label{sec:def-vs.-newcommand} + +Les macros devraient \emph{toujours} être définies à l'aide de \verb+\newcommand{<name>}{...}+ et \emph{pas} avec \Macro{def}\LMacro{<name>}{…}\footnote{Voir aussi \cite{clsguide-06}, section 2.7.2, et \cite{usrguide-05}, section 3.4.}. + +Le problème principal avec \Macro{def} est qu'aucun contrôle de l'existence d'une macro de même nom n'est effectué, de sorte qu’une macro définie précédemment peut être remplacée sans le moindre avertissement. + +Des macros déjà existantes peuvent être redéfinies à l'aide de \\ +\verb+\renewcommand{<name>}{...}+. + +Celui qui sait précisément \emph{pourquoi} il a besoin d'utiliser \Macro{def}, celui-là en connaîtra aussi les avantages et les inconvénients, et peut ne pas tenir compte de cette section. + +\subsection{Utilisation de \texttt{\TB sloppy}} +\label{sec:verw-von-textttt} + +De manière générale, le commutateur \Macro{sloppy} ne devrait jamais être utilisé, en particulier dans le préambule du document. Pour résoudre des problèmes de coupure de ligne dans certains paragraphe, il faut : + +\begin{enumerate}[\lining 1\up{o},wide] +\item vérifier si les motifs de césure corrects (par exemple à l’aide de \Paket{babel}), et les polices T1 ont été chargés – pour l'allemand \Paket{(n)german} (voir aussi la \Doku{FAQ} sur la coupure des mots\footnote{\url{http://projekte.dante.de/DanteFAQ/Silbentrennung}} ou \Doku{UK FAQ}\cite{ukfaq-13}, «Hyphenation», section P.7) et pour le français \Option{french} de \Paket{babel} ; + +\item utiliser l’extension \Paket{microtype}. Celle-ci modifie légèrement l’espacement entre caractères afin d’améliorer la mise en page. Cette modification automatique n’est possible qu’avec pdf\TeX{} à partir de la version 1.20 et ne fonctionne que pour la création d’un fichier PDF, mais pas si pdf\TeX{} fonctionne en mode DVI ; + + \item reformuler le texte. Il n'est pas toujours nécessaire de changer la phrase dans laquelle apparaît le problème de coupure de ligne. Souvent il suffit de changer/déplacer la phrase précédente ou la suivante ; + +\item ajuster modérément les paramètres que \TeX{} utilise pour les calculs des coupures de ligne. Axel Reichert a posté\footnote{Voir le message \MID{a84us0$plqcm$7@ID-30533.news.dfncis.de}{a84us0\$plqcm\$7@ID-30533.news.dfncis.de}.} une fois, sur \News{de.comp.text.tex}, ses ajustements personnels, avec lesquels il évite les principaux problèmes de coupure de ligne tout en préservant une bonne mise en page. (On doit à partir de là faire vraiment attention aux avertissements qui apparaissent et les supprimer en reformulant le texte.) + + \begin{minipage}[t]{0.9\linewidth} +\begin{verbatim} +\tolerance 1414 +\hbadness 1414 +\emergencystretch 1.5em +\hfuzz 0.3pt +\widowpenalty=10000 +\vfuzz \hfuzz +\raggedbottom +\end{verbatim} +% \hspace{\baselineskip} % Oui, je sais, c'est de la triche ! + \end{minipage} +\end{enumerate} + +%%%%%%Paragraphe rajouté de la version italienne en lieu et place d’une note de bas de page +Naturellement, on peut modifier ces valeurs en fonction des goûts personnels. En fait, des diverses valeurs de paramètres adoptées par Reichert, \Macro{clubpenalty} et \Macro{widowpenalty} servent à réduire le nombre de veuves et d’orphelines possibles, tandis que \Macro{hbadness} permet à \TeX{} de produire des messages en rapport avec des lignes trop pleines ou trop vides. En somme, la majeure partie des paramètres de Reichert permet de réduire les avertissements (\emph{warning}) de \TeX{} quand les lignes ne sont pas parfaitement composées, mais seuls \Macro{tolerance} et \Macro{emergencystretch} ont un quelconque effet sur la coupure des mots. Enfin, \Macro{raggedbottom} ne joue aucun rôle dans la coupure des mots, mais bien plutôt dans l’empagement. Avant tout, cependant, on devrait faire attention à la façon de modifier \Macro{emergencystretch}, faute de quoi l’on risque d’obtenir un paragraphe avec des blancs indus, comme il arrive avec un logiciel de traitement de texte bien connu\footnote{Ce paragraphe a été ajouté par le traducteur italien.}. +%%%%%%%%%% Fin du rajout%%%%%%%%%%% + +Ce n'est que si cela ne suffisait pas que vous pourriez demander un paragraphe composé de manière plus lâche avec l'environnement \texttt{sloppypar}. + +\begin{figure}[htp] + % Falls sich jemand über das zusätzliche \fussy bzw. das fehlende + % \sloppy wundert: Use the Source Luke! \parbox setzt per default + % \sloppy, so dass man für einen originalen Umbruch \fussy benötigt. + % Weiter muss für die Beispiele die Laufweitenänderung durch das + % microtype-Paket deaktiviert werden, damit das Standardverhalten von + % LaTeX demonstriert werden kann. [Marc] + \begin{minipage}[t]{.48\textwidth} + \centering + \linespread{1.0} + {\fontsize{10pt}{12pt}\fontencoding{OT1}\selectfont + \fbox{\parbox{17.61em}{\microtypecontext{expansion=slbsp}\fussy% + tatata tatata tatata tatata tatata tatata tata\-tata tatata tatata + tatata tatata tatata tatata tata\-tata tatata tatata tatata tatata + ta\-tatatatt\-ta tatata tatata tatata tatata tatata tatata + ta\-ta\-ta\-ta}}}% + \caption{Exemple avec les valeurs standard de \LaTeX}% + \label{fig:beispiel-mit-latex}% + \end{minipage}% + \hfill% + \begin{minipage}[t]{.48\textwidth} + \centering + \linespread{1.0} + {\fontsize{10pt}{12pt}\fontencoding{OT1}\selectfont + \fbox{\selectlanguage{ngerman}\parbox{17.61em}{\microtypecontext{expansion=slbsp}% + tatata tatata tatata tatata tatata tatata tata\-tata tatata tatata + tatata tatata tatata tatata tata\-tata tatata tatata tatata tatata + ta\-tatatatt\-ta tatata tatata tatata tatata tatata tatata + ta\-ta\-ta\-ta}}}% + \caption{Exemple avec \texttt{\string\sloppy}}% + \label{fig:beisp-mit-textttstr} + \end{minipage} +\end{figure} + +Dans les figures~\ref{fig:beispiel-mit-latex} et \vref{fig:beisp-mit-textttstr}, nous avons tenté de présenter l'effet de \Macro{sloppy}. + +Markus Kohm a publié sur \News{comp.text.tex} un exemple qui en montre l'effet très clairement. Avec sa permission, il est reproduit en annexe (voir Annexe~\vref{sec:beispiel-zu-sloppy}). + +%----------------------- section "Obsolete" ------------------------ +\clearpage +\section{Commandes, classes et extensions obsolètes} +\label{sec:obsoletes} + +Markus Kohm a écrit un \emph{script} Perl avec lequel on peut chercher en ligne (\url{http://kohm.de.tf/markus/texidate.html}) les erreurs les plus courantes dans ses fichiers. + +Il est cependant à noter que ce \emph{script} n'est pas un parseur complet de \TeX{} et par conséquent ne cherchera que les erreurs les plus évidentes. Veuillez vérifier votre fichier avant de demander secours dans un forum ou sur une liste de diffusion. D’abord tester, poster ensuite. +\subsection{Commandes} +\label{sec:befehle} + +\subsubsection{Modification du style de caractères} +\label{sec:ander-des-schr} + +La table~\vref{tab:befehle-zur-anderung} présente en vis-à -vis les commandes obsolètes et les commandes actuelles de \LaTeX\ pour changer le style des caractères. Les macros appelées «locales» ne s'appliquent qu'à leur argument, tandis que celles appelées «globales» ou «commutateurs» s'appliquent à tout le texte jusqu'à la fin du groupe dont elles font partie. +% + \begin{center}% La mise en page du paragraphe a été modifiée :-\ +\begin{threeparttable} + \caption{Commandes pour changer le style de caractères} +\label{tab:befehle-zur-anderung} + \begin{tabular}{@{}lll@{}} + \addlinespace + \toprule + \multicolumn{1}{@{}F}{Obsolète}& + \multicolumn{2}{F@{}}{Remplacé en \LaTeXe{} par}\\ + \cmidrule(l){2-3} + & + \multicolumn{1}{F}{local} & + \multicolumn{1}{F@{}}{global/commutateur}\\ + \cmidrule(r){1-1}\cmidrule(lr){2-2}\cmidrule(l){3-3} + \GMacro{rm}{…} & \LMacro{textrm}{…} & \Macro{rmfamily}\\ + \GMacro{sf}{…} & \LMacro{textsf}{…} & \Macro{sffamily}\\ + \GMacro{tt}{…} & \LMacro{texttt}{…} & \Macro{ttfamily}\\ + \GMacro{it}{…} & \LMacro{textit}{…} & \Macro{itshape}\\ + \GMacro{sc}{…} & \LMacro{textsc}{…} & \Macro{scshape}\\ + \GMacro{sl}{…} & \LMacro{textsl}{…} & \Macro{slshape}\\ + \GMacro{bf}{…} & \LMacro{textbf}{…} & \Macro{bfseries}\\ + \hphantom{\{} — & \LMacro{textmd}{…} & \Macro{mdseries}\\ + \hphantom{\{} — & \LMacro{textup}{…} & \Macro{upshape}\\ + \hphantom{\{} — & \LMacro{emph}{…} & \Macro{em}\tnote{a}\\ + \bottomrule + \end{tabular} + \begin{tablenotes}\footnotesize% + \item[a] Utile dans les définitions de macros. Dans un texte, ce n’est pas \GMacro{em}{…} qu’on doit employer, mais \LMacro{emph}{…}. + \end{tablenotes} +\end{threeparttable} +\end{center} + +\paragraph{Pourquoi ne faut-il pas utiliser de commandes obsolètes ?} +\label{sec:warum-sollte-man} + +Les commandes obsolètes ne supportent pas le système de gestion des fontes\footnote{NFSS : New Font Selection Scheme, ou «Nouveau Schéma de Sélection des Fontes». Le \Doku{fntguide}~\cite{fntguide-05} en donne une vue d’ensemble. } de \LaTeXe{}. Par exemple, \GMacro{bf}{foo}, annule tous les attributs de fonte déjà spécifiés avant d'imprimer \emph{foo} en gras. C'est pourquoi vous ne pouvez pas obtenir de l'italique gras à l'aide de \GMacro{it}{\Macro{bf Test}} (la définition mentionnée produit {\it\bf Test}). En revanche, les nouvelles commandes \LMacro{textbf}{\LMacro{textit}{Test}} se comporteront comme escompté et produiront : \textbf{\textit{Test}}. En outre, avec les anciennes commandes, il n'y a pas de «correction italique» : comparez par exemple {\it neuf}hampes (\GMacro{it}{neuf}\texttt{hampe}) et \textit{neuf}hampes (\LMacro{textit}{neuf}\texttt{hampes}). + +\subsubsection{Fractions mathématiques (\texttt{\textbackslash over} + \& \texttt{\textbackslash frac})} +\label{sec:textb-over-vs} + +On devrait éviter la commande \Macro{over}. \Macro{over} est une commande \TeX\ qui est difficile à analyser ou qui ne peut pas être analysée du tout du fait de sa syntaxe très différente de celle de \LaTeX. En particulier, l'extension \Paket{amsmath} redéfinit \verb+\frac{}{}+ et l'utilisation de \Macro{over} produira des messages d'erreur . Un autre argument en faveur de \verb+\frac{}{}+ est qu'il est plus facile de composer le numérateur et le dénominateur d'une fraction, notamment pour des fractions un peu complexes. + +\begin{Ers} + \verb+$a \over b$+ +\end{Ers} +\begin{Dur} +\verb+$\frac{a}{b}$+ +\end{Dur} + +\subsubsection{Centrer du texte avec \texttt{\textbackslash centerline}} +\label{sec:centerline} + +La commande \Macro{centerline} est une autre commande \TeX\ que l'on devrait éviter en \LaTeX. D'une part \Macro{centerline} est incompatible avec quelques extensions de \LaTeX{} (par exemple \Paket{color}) ; d'autre part, elle peut produire des effets indésirables ou inattendus : +\begin{center} + \begin{minipage}[t]{.45\textwidth} +\begin{verbatim} +\begin{enumerate} +\item \centerline{Premier point} +\end{enumerate} +\end{verbatim} + \end{minipage}% + \hfill% + + \fbox{ \begin{minipage}[t]{.45\textwidth} + \begin{enumerate} + \item \centerline{Premier point} + \end{enumerate} + \end{minipage}} +\end{center} +\begin{Ers} + \LMacro{centerline}{\textellipsis} +\end{Ers} +\begin{Dur} + \GMacro{centering}{\textellipsis\,}\\ {\small ou bien}\\ + \begin{varwidth}[t]{\linewidth} +\begin{verbatim} +\begin{center} + ... +\end{center} +\end{verbatim} + \end{varwidth} +\end{Dur} + +\paragraph{Note.} +\label{sec:anmerkung-5} + +Pour des précisions sur le centrage de graphiques et de tables, voir section~\vref{sec:gleit-figure-table}. + +\subsection{Fichiers de classes et d'extensions} +\label{sec:pakete} + +\subsubsection{\Klasse{scrlettr} \& \Klasse{scrlttr2}} +\label{sec:paketscrl-vs.-pakets} + +La classe \Klasse{scrlettr} du paquet \KOMAScript\ est obsolète et a été remplacée par \Klasse{scrlttr2}. Afin de produire une mise en page \emph{semblable} à celle de l'ancienne classe de lettre de \KOMAScript\, on peut utiliser l'option de classe \Option{KOMAold} qui fournit un mode de compatibilité. +\begin{Ers} + \verb+\documentclass{scrlettr}+ +\end{Ers} +\begin{Dur} + \verb+\documentclass[KOMAold]{scrlttr2}+ +\end{Dur} + +\paragraph{Note.} +\label{sec:anmerkung-3} + +Pour de nouveaux modèles de lettres, on devrait utiliser la nouvelle interface, qui est bien plus flexible. + +Développer les différences entre les deux interfaces utilisateurs sort du cadre de cet aperçu. Nous renvoyons à \Doku{scrguien}~\cite{kohm-12} pour les détails. + +\subsubsection{\Paket{epsf}, \Paket{psfig}, \Paket{epsfig}\& \Paket{graphics}, \Paket{graphicx}} +\label{sec:grafikeinbindung} + +Les extensions \Paket{epsf} et \Paket{psfig} ont été remplacées par les extensions \Paket{graphics} et \Paket{graphicx} respectivement. \Paket{epsfig}est juste une enveloppe\footnote{Une enveloppe, anglais \emph{wrapper}, désigne ici un fichier de style qui lui-même charge un ou plusieurs fichiers de style et, ce faisant, donne accès à leurs fonctionnalités.} pour permettre d’utiliser l'extension \Paket{graphicx} avec d'anciens documents écrits avec \Paket{psfig}. + +Comme \Paket{epsfig} utilise \Paket{graphicx} en interne, on \emph{peut} encore utiliser \Paket{epsfig}. On ne devrait pas, toutefois, l'utiliser pour de nouveaux documents. Pour cela les extensions \Paket{graphics} ou \Paket{graphicx} sont préférables. \Paket{epsfig} est fourni essentiellement pour assurer la compatibilité comme mentionné ci-dessus. + +Pour les différences entre \Paket{graphics} et \Paket{graphicx}, voyez \Doku{grfguide}~\cite{graphicx-05}. Pour des précisions sur le centrage des graphiques voyez section~\vref{sec:gleit-figure-table}. +\clearpage +%\begin{center} +%\begin{tabular}{@{}r@{\qquad}l@{}} +\begin{Ers}% +\begin{verbatim} +\usepackage{psfig} +\psfig{file=image,...} +\end{verbatim} +\end{Ers} +% & +\begin{Dur} + \begin{verbatim} +\usepackage{graphicx} +\includegraphics[...]{image} +\end{verbatim} +\end{Dur} +%\end{tabular} +%\end{center} + +\subsubsection{\Paket{doublespace} \& \Paket{setspace}} +\label{sec:zeilenabstande} + +Pour changer l'interlignage, utilisez l'extension \Paket{setspace}. L'extension \Paket{doublespace} est obsolète, et remplacée précisément par \Paket{setspace}. Voyez aussi la section~\vref{sec:ander-des-zeil}. +\begin{Ers} + \verb|\usepackage{doublespace}| +\end{Ers} +\begin{Dur} + \verb|\usepackage{setspace}| +\end{Dur} + +\subsubsection{\Paket{fancyheadings}, \Paket{scrpage} \& \Paket{fancyhdr}, \Paket{scrpage2}} +\label{sec:lebende-kolumn} + +L'extension \Paket{fancyheadings} a été remplacée par \Paket{fancyhdr}. Une autre manière de modifier les entêtes est fournie par l'extension \Paket{scrpage2} du paquet \KOMAScript. Notez, une fois encore, que \Paket{scrpage} ne doit pas être utilisé. Pour une documentation sur \Paket{scrpage2}, voir \Doku{scrguien}~\cite{kohm-12}. + +\begin{Ers} + \verb+\usepackage{fancyheadings}+ +\end{Ers} +\begin{Dur} + \verb+\usepackage{fancyhdr}+ +\end{Dur} +\begin{Ers} + \verb+\usepackage{scrpage}+ +\end{Ers} +\begin{Dur} + \verb+\usepackage{scrpage2}+ +\end{Dur} + +\subsubsection{La famille d’extensions \PakeH{caption}} +\label{sec:die-caption-famile} +L’extension \Paket{caption2} ne doit plus être utilisée, car il existe une nouvelle version (V.3x) de l’extension \Paket{caption}. Prendre soin toutefois de ne pas utiliser une version trop ancienne de l’extension. Pour s’en assurer, charger l’extension comme suit : +\begin{Ers} + \verb+\usepackage{caption}+ +\end{Ers} +\begin{Dur} + \verb+\usepackage{caption}[2008/08/24]+ +\end{Dur} + +Si l’on a utilisé auparavant \Paket{caption2}, il faut absolument prendre connaissance de la nouvelle documentation ~\cite[Section~C.2]{caption-11}. + +\subsubsection{\Paket{isolatin}, \Paket{umlaut} \& \Paket{inputenc}} +\label{sec:eingabe-von-umlauten} + +\paragraph{Quelques notes générales.} +\label{sec:generelles} +Il y a essentiellement quatre façons de saisir les \emph{umlauts} allemands et les autres caractères non-ASCII\footnote{Comme les lettres accentuées françaises \NDT}. + +\begin{enumerate}[wide] +\item \verb+H{\"u}lle+ (\verb+{\'E}tage+). L’avantage de cette saisie est qu’elle fonctionne toujours et sur n’importe quel système. + + Ses inconvénients, toutefois, sont que le crénage\footnote{Espace positive ou négative insérée entre deux caractères en fonction du couple de caractères.} entre les lettres est gravement perturbé ; qu’elle est très pénible à saisir à tout le moins dans un texte en allemand ; enfin que le code obtenu est fort peu lisible. + + Aussi cette variante devrait \emph{toujours} être évitée, du fait des problèmes créés pour le crénage. + + \item Avec \verb+H\"ulle+ ou \verb+H\"{u}lle+ (\verb!\'Etage! ou \verb!\'{E}tage!) les problèmes mentionnés ci-dessus (crénage) n'apparaissent pas. Cette saisie est elle aussi utilisable sur tous les systèmes. + + L’inconvénient est que la saisie est aussi laborieuse, et que le code obtenu est encore moins lisible que la variante précédente. + + Cette variante est la plus judicieuse dans des définitions de macros ou dans des fichiers de style car elle est indépendante du codage et de toute extension.\label{item:die-eingabe-der} + +\item Avec l'extension \Paket{(n)german} ou l'option \Option{(n)german} de l'extension \Paket{babel}, on peut saisir les \emph{umlauts} allemands en tapant simplement \verb+H"ulle+. Une fois de plus, l'avantage est que cela fonctionne avec tous les systèmes. Comme les extensions \Paket{babel} ou \Paket{(n)german} sont disponibles sur tous les systèmes \TeX, il ne devrait pas non plus y avoir de problème de compatibilité.\footnote{Il n'y a pas d'équivalent à cette saisie pour les accents du français avec \Paket{babel} et \Option{frenchb} \NDT} + + L’inconvénient est, encore, que la saisie est malcommode et le code-source est plutôt difficile à lire. + + Cette variante s’utilise relativement bien pour le corps du texte. Mais on devrait l'éviter dans les définitions de macro ou les préambules. + +\item L'entrée directe – \verb+Hülle+ (\verb!Étage!). Les avantages de cette variante sont patents. Le texte-source s’écrit et se lit «normalement». + + L’inconvénient est qu’il faut dire à \LaTeX\ quel est le codage d'entrée utilisé et qu’il peut aussi y avoir des problèmes lors de l'échange de fichiers entre systèmes différents. Cela \emph{n'est pas} un problème pour \TeX\ ou \LaTeX\ eux-mêmes, mais cela peut créer des \emph{difficultés d'affichage du texte-source dans les éditeurs de texte} sur des systèmes divers. Par exemple, le symbole de l'euro codé en \textln{iso-8859-15} (\textln{latin9}) peut être \emph{représenté} par {\fontfamily{cmr}\selectfont\textcurrency}{} dans un éditeur sous Windows (\textln{CP1252}). + + Cette variante fonctionne très bien pour le corps du texte. Il vaut mieux, cependant, l'éviter dans les définitions de macros ou les préambules. +\end{enumerate} +% +En résumé, dans les macros, préambules et fichiers de style, on devrait utiliser \verb+H\"ulle+ ou \verb+H\"{u}lle+, tandis qu'ailleurs dans le texte on peut utiliser soit \verb+H"ulle+ soit \verb+Hülle+. + +\paragraph{Codage d'entrée.} +\label{sec:eingabekodierung-1} + +Pour dire à \LaTeX\ quel codage d'entrée est employé dans un fichier, il \emph{ne faut pas} utiliser les extensions \Paket{isolatin1}, \Paket{isolatin} ou \Paket{umlaut} ! Ces extensions sont obsolètes ou ne sont pas disponibles sur tous les systèmes. + +On doit utiliser l'extension \Paket{inputenc} avec les options suivantes\footnote{pour ce qui nous occupe ici \NDT} : + +\begin{description*} +\item[\Option{latin1/latin9}] pour les systèmes de type unix (\Option{latin1} fonctionne aussi sous Microsoft~Windows et Mac~OS~X) ; + +\item[\Option{ansinew}] pour Microsoft~Windows ; + +\item[\Option{applemac}] pour Mac\footnote{Sous OS~X, \Option{latin1/latin9} devrait être utilisé, car ce codage est plus approprié pour des échanges de fichiers avec des utilisateurs d’autres systèmes d’exploitation. Cependant, il faut impérativement vérifier l’encodage utilisé par son éditeur de texte.} ; +\item[\Option{cp850}] pour \textln{OS/2} ; + +\item[\Option{utf8}] pour les systèmes de type Unix \enquote{modernes} et plus généralement pour les systèmes d’exploitation (et les éditeurs) qui supportent Unicode (UTF-8) \footnote{C’est le cas de Windows depuis Windows XP et de MacOS X. (B. A.)}. +\end{description*} + +\begin{Ers} + \verb|\usepackage{isolatin1}| +\end{Ers} +\begin{Dur} + \verb|\usepackage[latin1]{inputenc}| +\end{Dur} +\begin{Ers} + \verb|\usepackage{umlaut}| +\end{Ers} +\begin{Dur} + \verb+\usepackage[latin1]{inputenc}+ +\end{Dur} + +\paragraph{Note.} +La méthode indiquée ci-dessus pour déclarer le codage d’entrée s’emploie avec les moteurs \LaTeX{} «classiques», comme pdf\LaTeX{}. Les développements récents que constituent \XeLaTeX{} et Lua\LaTeX{} traitent les fichiers unicode sans qu’on ait à déclarer l’encodage. Tous deux peuvent déjà être utilisés en production, mais ils requièrent en règle générale qu’on récrive les «vieux» fichiers \LaTeX{} pour la partie concernant le choix de la langue et des polices de caractère, et ils n’atteignent pas encore les mêmes possibilités que pdf\LaTeX{} en matière de microtypographie. + +\subsubsection{\Paket{t1enc} \& \Paket{fontenc}} +\label{sec:schriftkodierung} + +L'extension \Paket{t1enc} est obsolète et devrait par conséquent être remplacée par \Paket{fontenc}. +\begin{Ers} + \verb|\usepackage{t1enc}| +\end{Ers} +\begin{Dur} + \verb|\usepackage[T1]{fontenc}| +\end{Dur} + +\subsubsection{\Bst{natdin} \& \Bst{dinat}} +\label{sec:liter-nach-din} + +L’auteur de \Bst{dinat} recommande de remplacer \Bst{dinat} par \Bst{natdin} car le développement de \Bst{dinat} a été arrêté et \Bst{natdin} a été grandement amélioré. + +\begin{Ers} + \verb|dinat.bst| +\end{Ers} +\begin{Dur} + \verb|natdin.bst| +\end{Dur} + +\paragraph{Note.} +Dans les versions précédentes de ce document, nous avions fait la recommandation exactement inverse ; celle-ci se fondait sur l’état du développement de l’époque. Les améliorations apportées depuis à \Bst{natdin} justifient maintenant la préférence accordée à cette dernière extension. + +\subsubsection{\PakeH{glossary} \& \PakeH{glossaries}} +\label{sec:glossar} + +L’extension \Paket{glossary} est obsolète ; son auteur lui a fourni pour successeur l’extension \Paket{glossaries}. Des détails sur les changements se trouvent dans \cite{glossaries-12}. + +\subsubsection{\PakeH{SIstyle}, \PakeH{SIunits} \& \PakeH{siunitx}} +\label{sec:einheiten} + +Les extensions \Paket{SIstyle} et \Paket{SIunits}, utiles à la composition des unités physiques, ne sont plus développées. Les fonctionnalités des deux extensions ont été réunies dans leur successeur \Paket{siunitx}. Sa grande souplesse permet à \Paket{siunitx} de remplacer aussi des extensions comme \Paket{unitsdef}, \Paket{units}, \Paket{fancyunits} et \Paket{fancynum}. +\begin{Ers} +\begin{verbatim} +\usepackage{SIunits} +\unit{1}{\metre} +\end{verbatim} +\end{Ers} +\begin{Dur} +\begin{verbatim} +\usepackage{siunitx} +\SI{1}{\metre} +\end{verbatim} +\end{Dur} + +\subsubsection{\PakeH{subfigure}, \PakeH{subfig} \& \PakeH{subcaption}} +\label{sec:subfigures} + +Les extensions \Paket{subfigure} et \Paket{subfig} ne sont plus développées et sont incompatibles avec quelques extensions actuelles comme \Paket{hyperref} et \Paket{caption}. En remplacement, il est conseillé d’utiliser \Paket{subcaption}. + +\begin{Ers} +\begin{verbatim} +\usepackage{subfig} +\begin{figure} +\subfloat[][Text]{Bild} +\end{figure} +\end{verbatim} +\end{Ers} +\begin{Dur} +\begin{verbatim} +\usepackage{caption} +\usepackage{subcaption} +\begin{figure} +\begin{subfigure}{Breite} +Bild\caption{Text} +\end{subfigure} +\end{figure} +\end{verbatim} +\end{Dur} + +\subsection{Caractères} +\label{sec:schriften} + +Le sujet «fontes et \LaTeX{}» est, sur \News{de.comp.text.tex}, une source intarissable~d'«allégresse»\footnote{Ainsi que sur \News{fr.comp.text.tex} et \News{comp.text.tex} d'ailleurs \NDT}, la plupart du temps suscitée par la question : «Pourquoi les caractères apparaissent-ils si pixellisés dans Adobe Reader ?». Les réponses \emph{fausses} les plus fréquentes renvoient aux extensions \Paket{times} ou \Paket{pslatex}. Toutefois, avec ces extensions, non seulement on utilise des polices complètement différentes, mais, comme ces extensions sont obsolètes, on soulève de nouveaux problèmes. Si, comme recommandé dans la section \ref{sec:ae}, on utilise\footnote{Via l’extension \Paket{lmodern} \NDT} Latin Modern pour remplacer (quasi) à l’identique la police «standard» de \LaTeX{} (c’est-à -dire Computer Modern), alors l’aspect pixellisé des caractères dans Adobe Reader disparaît. + +Le \Doku{fntguide}~\cite{fntguide-05} donne des informations générales sur le «New Font Selection Scheme» (NFSS) de \LaTeXe{} + +\subsubsection{\Paket{times}} +\label{sec:pakettimes} + +L'extension \Paket{times} est obsolète (voir \Doku{psnfss2e}\cite{psnfss-04}). Elle définit \Macro{rmdefault} comme étant la police «Times», \Macro{sfdefault} comme «Helvetica» et \Macro{ttdefault} comme «Courier», sans toutefois leur associer les polices mathématiques correspondantes. De plus, Helvetica n'est pas réduite correctement et apparaît trop grande. Si l’on désire utiliser la combinaison Times/\/Helvetica/\/Courier il faut alors faire ce qui suit : +\begin{Ers} + \verb|\usepackage{times}| +\end{Ers} +\begin{Dur} +\begin{verbatim} +\usepackage{mathptmx} +\usepackage[scaled=.92]{helvet} +\usepackage{courier} +\end{verbatim} +\end{Dur} + +\paragraph{Note.} +\label{sec:anmerkung-1} + +Le facteur de réduction de \Paket{helvet}, combinée avec Times, devrait être pris entre \numprint{0,90} et \numprint{0,92}. + +\subsubsection{\Paket{mathptm}} +\label{sec:mathptm} + +L'extension \Paket{mathptm} est le prédécesseur de \Paket{mathptmx}. \ + +\begin{Ers} + \verb+\usepackage{mathptm}+ +\end{Ers} +\begin{Dur} + \verb+\usepackage{mathptmx}+ +\end{Dur} + +\subsubsection{\Paket{pslatex}} +\label{sec:paketpslatex} + +L'extension \Paket{pslatex} fonctionne en interne comme \Paket{mathptm}$+$ \Paket{helvet} (réduit). Toutefois, elle utilise un Courier trop étroit. Le principal inconvénient de \Paket{pslatex} est qu'il \emph{ne fonctionne pas} avec les codages T1 et TS1. + +\begin{Ers} + \verb+\usepackage{pslatex}+ +\end{Ers} +\begin{Dur} +\begin{verbatim} +\usepackage{mathptmx} +\usepackage[scaled=.92]{helvet} +\usepackage{courier} +\end{verbatim} +\end{Dur} + +\paragraph{Note sur les combinaisons de Times \& Helvetica.} +\label{sec:anmerkung-zu-allen} + +On peut aussi bien en rester à la police \texttt{cmtt} pour une police type «machine à écrire», et ne pas charger du tout l'extension \Paket{courier}. + +\subsubsection{\Paket{palatino}} +\label{sec:paketpalatino} + +L'extension \Paket{palatino} se comporte comme \Paket{times} – hormis qu'elle définit naturellement \Macro{rmdefault} comme «Palatino». C'est pourquoi on ne devrait plus l'utiliser. +\begin{Ers} + \verb+\usepackage{palatino}+ +\end{Ers} +\begin{Dur} +\begin{verbatim} +\usepackage{mathpazo} +\usepackage[scaled=.95]{helvet} +\usepackage{courier} +\end{verbatim} +\end{Dur} + +\paragraph{Note.} +\label{sec:anmerkung-2} + +Le facteur de réduction pour \Paket{helvet} en combinaison avec la fonte Palatino devrait être fixé à \numprint{0,95}. + +«Helvetica» \emph{n'est pas} la meilleure linéale à associer à «Palatino» et doit être vue, autant que possible, comme une «vieille» association, même si elle a longtemps constitué le complément \emph{disponible librement} le mieux assorti à «Palatino». Depuis lors, on dispose des polices Vera/Bera Sans – à notre avis un meilleur choix. + +Celui qui possède un CD CorelDraw\textsuperscript{\textregistered}, même ancien\footnote{Les polices fournies avec les versions anciennes de CorelDraw\textsuperscript{\textregistered} ne contiennent pas encore de symbole euro !}, peut aussi très bien utiliser «Palatino» avec « Frutiger\footnote{Bitstream «Humanist 777». }» ou «Optima\footnote{Bitstream «Zapf Humanist». }». Walter Schmidt a publié sur sa page personnelle\footnote{Fonts für \TeX : \url{http://cq131a.de/}} % mise à jour de’ l’adresse du site % + les outils nécessaires pour utiliser ces polices (extensions \Paket{bfr} et \Paket{bop}). + +\subsubsection{\Paket{mathpple}} +\label{sec:paketmathpple} + +Cette extension est le prédécesseur de \Paket{mathpazo}. Il lui manque quelques symboles et ils sont pris dans la fonte Euler. D'autres symboles ne conviennent pas bien à Palatino et quelques métriques de la fonte sont incorrectes. Pour plus de précisions, voir \Doku{psnfss2e}~\cite{psnfss-04}. + +\begin{Ers} + \verb+\usepackage{mathpple}+ +\end{Ers} +\begin{Dur} + \verb+\usepackage{mathpazo}+ +\end{Dur} + +\subsubsection{\PakeH{utopia}} +\label{sec:paketutopia} + +L’extension \Paket{utopia} ne devrait plus être utilisée, car son successeur \Paket{fourier} offre une meilleure interface avec la police Utopia. Pour plus de précisions, voir \Doku{psnfss2e}~\cite{psnfss-04}. + +\begin{Ers} + \verb+\usepackage{utopia}+ +\end{Ers} +\begin{Dur} + \verb+\usepackage{fourier}+ +\end{Dur} + +\subsubsection{Obtenir des lettres grecques droites} +\label{sec:aufr-griech-buchst} + +Les passages marqués en rouge ci-après ne sont pas obsolètes dans le sens où «vous ne devriez plus utiliser cela», mais de nos jours, +l'édition d'un texte est simplifiée par l'extension \PakeT{upgreek}\footnote{L'extension \Paket{fourier} admet une option \texttt{upright} qui donne les lettres grecques bas de casse, les capitales grecques et romaines droites en mode mathématique \NDT}\footnote{Les extensions \Paket{kpfonts}, \Paket{mathdesign} et \Paket{MinionPro} ont les mêmes possibilités que \Paket{fourier} (B. A.)}. Pour des précisions sur son utilisation, consultez comme toujours la documentation \Doku{upgreek}~\cite{upgreek-03}. + +\minisec{Les trucs de \PakeH{pifont}}\nopagebreak[4] +\begin{Ers} +\begin{verbatim} +\usepackage{pifont} +\newcommand{\uppi}{% + \Pisymbol{psy}{112}} + ... +\uppi +\end{verbatim} +ou bien +\begin{verbatim} +\newcommand[1]{\upgreek}{% + \usefont{U}{psy}{m}{n}#1} + ... +\upgreek{p} +\end{verbatim} +\end{Ers} +\begin{Dur} +\begin{verbatim} +\usepackage{upgreek} + ... +$\uppi$ +\end{verbatim} +\end{Dur} + +\minisec{Les trucs de \PakeH{babel}} +\begin{Ers} +\begin{verbatim} +\usepackage[greek,...]{babel} +\newcommand{\upgreek}[1]{% + \foreignlanguage{greek}{#1}} + ... +\upgreek{p} +\end{verbatim} +\end{Ers} +\begin{Dur} +\begin{verbatim} +\usepackage{upgreek} + ... +$\uppi$ +\end{verbatim} +\end{Dur} + +\subsubsection{\PakeH{euler} \& \PakeH{eulervm}} +\label{sec:euler-vs-euler} +L’extension \Paket{euler} devrait être remplacée par \Paket{eulervm}, car celle-ci règle des problèmes de compatibilité avec d’autres extensions et apporte quelques améliorations de détail : + +\begin{itemize} +\item \Macro{hbar} (\Macro{hslash} dans cette police) fonctionne maintenant correctement ; +\item des caractères mathématiques gras, y compris des symboles grecs sont disponibles. +\end{itemize} +% +Pour des informations plus précises, voir \Doku{eulervm}~\cite{eulervm-05}. +\begin{Ers} + \verb+\usepackage{euler}+ +\end{Ers} +\begin{Dur} + \verb+\usepackage{eulervm}+ +\end{Dur} + +\subsubsection{\PakeH{ae}, \PakeH{aecompl} et \PakeH{zefonts}} +\label{sec:ae} +L’extension \Paket{ae} (ainsi que \Paket{aecompl}) et \Paket{zefonts}servent de solution de fortune pour un problème en relation avec les umlaut et autres lettres accentuées lorsqu’on utilise la police standard de \LaTeX{} (Computer Modern). Or celles-ci utilisent le codage OT1, et donc les lettres accentuées doivent être constituées de deux signes («ü» est, sommairement, la combinaison de «u» et de «\"\ \kern-0.3em»). L’algorithme de coupure des mots est perturbé par ces lettres, ce qui entraîne que, par exemple, les mots avec un umlaut ne peuvent être coupés. Les extensions \Paket{ae} et \Paket{zefonts} remédient à ce problème en recourant à ce qu’on appelle des fontes virtuelles. + +Un autre problème, connexe au précédent, n’est cependant pas résolu par les extensions mentionnées : si l’on produit un fichier PDF, les lettres accentuées n’en demeurent pas moins composées de deux signes, ce qui entraîne que la recherche ou le copier-coller dans le document de mots avec un umlaut ne sera pas traité correctement. + +Les problèmes que nous venons de décrire ne surviennent plus si l’on utilise une police au codage T1 et au format «type 1»\footnote{Bien noter que même si les dénominations T1 et type 1 se ressemblent, elles ne désignent pas la même chose : T1 décrit l’encodage des caractères du côté de \LaTeX{}, tandis que «type 1» déclare comment les caractères sont représentés dans le fichier PDF. C’est pourquoi l’utilisation d’une police au codage T1 résout le problème de coupure des mots avec umlaut, mais pas nécessairement le problème de la recherche des umlauts dans un fichier PDF.}. C’est pourquoi ont été récemment dessinées les polices de caractères cm-super et Latin Modern. Comme cette dernière est plus conforme à l’originale Computer Modern, il est recommandé de remplacer CM par Latin Modern. + +\begin{Ers} +\begin{verbatim} +\usepackage{ae} +\end{verbatim} +ou +\begin{verbatim} +\usepackage{zefonts} +\end{verbatim} +\end{Ers} +\begin{Dur} +\begin{verbatim} +\usepackage[T1]{fontenc} +\usepackage{lmodern} +\end{verbatim} +\end{Dur} + +%-------------------- section « Varia » --------------------- +\section{Mélanges} +\label{sec:verschiedenes} + +Cette section – à l’exception de \vref{sec:der-anhang} – présente des trucs et des précisions plus généraux que ceux regroupés sous le titre de « péchés». + +\subsection{Flottants – «figure», «table»} +\label{sec:gleit-figure-table} + +Pour centrer un flottant on devrait utiliser la commande \Macro{centering} plutôt que l'environnement \LMacro{begin}{center}…\LMacro{end}{center} car celui-ci introduit un espace vertical additionnel qui n’est la plupart du temps pas souhaité. + +\begin{Ers} +\begin{verbatim} +\begin{figure} + \begin{center} + \includegraphics{image} + \end{center} +\end{figure} +\end{verbatim} +\end{Ers} +\begin{Dur} +\begin{verbatim} +\begin{figure} + \centering + \includegraphics{image} +\end{figure} +\end{verbatim} +\end{Dur} + +\paragraph{Note.} +\label{sec:anmerkung-4} + +Toutefois, lorsqu'il s'agit de centrer une région dans le corps du texte ou dans un environnement \verb+titlepage+, cet espace additionnel peut naturellement être tout à fait souhaité. + +\subsection{Annexes} +\label{sec:der-anhang} + +Les annexes sont introduites par le commutateur \Macro{appendix}. Ce \emph{n'est pas} un environnement. + +\begin{Ers} +\begin{verbatim} +\begin{appendix} +\section{Blub} +\end{appendix} +\end{verbatim} +\end{Ers} +\begin{Dur} +\begin{verbatim} +\appendix +\section{Blub} +\end{verbatim} +\end{Dur} + +\subsection{Mathématiques} +\label{sec:mathematiksatz} + +De manière générale, pour la typographie mathématique avancée, on devrait utiliser l'extension \Paket{amsmath}, éventuellement complétée par \Paket{mathtools}\footnote{Il suffit alors de charger cette dernière (B. A.)}. Elle procure de nouveaux environnements qui doivent avant tout remplacer \verb+eqnarray+. Les avantages de l'extension sont les suivants : + +\begin{itemize} +\item les espacements à l’intérieur et autour des environnements sont plus cohérents ; +\item les numéros des équations sont placés de telle sorte qu'ils ne seront plus surchargés par les expressions mathématiques ; +\item de nouveaux environnements (par exemple \texttt{split}), permettent de mettre en page facilement de longues équations ; +\item il est possible de définir facilement de nouveaux opérateurs, analogues à \Macro{sin}, avec des espacements appropriés. +\end{itemize} + +\paragraph{Avertissement.} +\label{sec:warnung} + +En utilisant l'extension \Paket{amsmath}, on ne devrait \emph{en aucun cas} faire usage des environnements \texttt{displaymath}, \texttt{eqnarray} ni \texttt{eqnarray*}, car ils ne sont pas supportés par \Paket{amsmath} et il en résulterait des espacements incohérents (comparer les figures~\ref{fig:beisp-fur-texttt} et \vref{fig:beisp-fur-texttt-1}). + +L’extension \Paket{amsmath} adapte correctement \verb+\[...\]+ et peut donc s'utiliser au lieu de \texttt{displaymath}. On peut remplacer \texttt{eqnarray} et \texttt{eqnarray*} en première approximation par \texttt{align} ou \texttt{align*}. Pour un panorama complet de \Paket{amsmath}, consulter \Doku{amsldoc}~\cite{amsldoc-99}. + +\begin{Ers} +\begin{verbatim} +\begin{eqnarray} + a &=& b\\ + b &=& c\\ + a &=& c +\end{eqnarray} +\end{verbatim} +\end{Ers} +\begin{Dur} +\begin{verbatim} +\begin{align} + a &= b\\ + b &= c\\ + a &= c +\end{align} +\end{verbatim} +\end{Dur} +\begin{figure} + \centering + \begin{minipage}[t]{.45\linewidth} + \begin{eqnarray*} + a &=& b\\ + b &=& c\\ + a &=& c + \end{eqnarray*} + \caption{Exemple avec \texttt{eqnarray*}} + \label{fig:beisp-fur-texttt} + \end{minipage}\hfill + \begin{minipage}[t]{.45\linewidth} + \begin{align*} + a &= b\\ + b &= c\\ + a &= c + \end{align*} + \caption{Exemple avec \texttt{align*}} + \label{fig:beisp-fur-texttt-1} + \end{minipage} +\end{figure} + +\subsection[L’utilisation de \texttt{\TB graphicspath}]{L’utilisation de \texttt{\TB graphicspath}\footnotemark} +\label{sec:die-verwendung-von} +\footnotetext{Cette section ne correspond pas à la version originale allemande, mais à la traduction italienne, entièrement récrite par Mauro Sacchetto. La traduction de la version allemande se trouve en annexe. } + +%% %%%%%% Version allemande + +%La macro fort répandue \Macro{graphicspath} devrait être évitée et remplacée par la variable d’environnement \texttt{TEXINPUTS} pour les raisons suivantes \footnote{Cf. la réponse de David Carlisle au rapport de bogue de Markus Kohm : \url{http://www.latex-project.org/cgi-bin/ltxbugs2html?pr=latex/2618}}: +%\begin{enumerate} +%%%\item Les séparateurs de répertoire dépendent de la plate-forme +%% %Windows/Unixs : « \texttt{/} », Macs : « \texttt{:} ». +%\item La recherche par \TeX{} dure davantage que si cette tâche est confiée à la bibliothèque kpathsea (avec les processeurs actuels, cela n’a plus la même importance). +%\item Chaque image consomme une partie de la mémoire allouée à \TeX{} et celle-ci n’est plus disponible durant toute la compilation. +%\end{enumerate} +%% +%Dans un Bourne-shell, on peut utiliser la commande suivante : +%\begin{verbatim} +%[luser@host]> TEXINPUTS=Rep_Images: latex datei.tex +%\end{verbatim} +%ou ajouter cette ligne dans \verb+$HOME/.profile+ : +%\begin{verbatim} +%export TEXINPUTS=./Rep_Images: +%\end{verbatim}%$ +%Cette ligne assure que les fichiers de \texttt{Rep_Images} sous le répertoire de travail seront bien trouvés. +% +%Sous +%Dans Microsoft~Windows ($\le 98$), on fixe la variable d’environnement au moyen de : +%\begin{verbatim} +%set TEXINPUTS=.\Rep_Image; +%\end{verbatim} +%ou bien : +%\begin{verbatim} +%set TEXINPUTS=./Rep_Images; +%\end{verbatim} +%pour MiK\TeX{} dans le fichier \texttt{autoexec.bat}. Dans Windows~NT\textln{4} et Windows~2000, on peut fixer les variables d’environnement en allant dans \textsf{Panneau de configuration $\rightarrow$ Système $\rightarrow$ Environnement}, et dans Windows~XP, \textsf{Panneau de configuration $\rightarrow$ Système $\rightarrow$ Avancé $\rightarrow$ Variables d’environnement} +% +%Ces procédures sont données à titre d’exemples. Nous sommes conscients qu’on peut adapter \texttt{TEXINPUTS} de différentes façons ou par le biais d’autres fichiers. On trouvera plus de précisions dans la documentation du système d’exploitation ou de la distribution \TeX{}. + +%%%%%%%% Version italienne + +Il faut préciser que, pour des raisons de sécurité liées avant tout, mais pas exclusivement, à Windows, les versions les plus récentes de \TeX{} (que ce soit MiKTeX ou TeX Live depuis la version 2009) acceptent une version de \TeX{} réduite, protégée de l’exécution de la commande \Macro{write18} (qui équivaut à donner une instruction : de façon précise, l’argument de \Macro{write18} est interprété comme si c’était une ligne de commande). \TeX{} permet d’exécuter pleinement un certain nombre d’instructions (qui concernent entre autres Bib\TeX{}, epstopdf, \&c.), en exécute d’autres en mode restreint et enfin n’en exécute pas du tout d’autres encore (comme la suppression de fichiers), qui doivent être autorisées par l’utilisateur\footnote{À moins de ne pas éliminer toutes les limitations de \Macro{write18} en lui indiquant explicitement dans la ligne de commande que l’éditeur envoie au système d’exploitation pour lancer des commandes comme \texttt{pdflatex} : option \texttt{-shell-escape} de TeX Live et option \texttt{-enable-write18} de MiKTeX. Toutefois, il faut être conscient des risques que comporte une telle opération pour la sécurité du système tout entier. }. + +En conséquence, les programmes ne peuvent plus utiliser de chemins absolus (c’est-à -dire qui partent de la racine du disque dur), mais seulement des chemins relatifs au répertoire dans lequel se trouve le fichier principal du document. + +La macro fort répandue \Macro{graphicspath} présente l’avantage qu’une fois exécutée, elle évite de devoir spécifier à chaque fois le ou les répertoires où se trouvent les images. Elle devrait toutefois être évitée parce qu’elle présente pour le moins des limites : + +\begin{enumerate} +\item La recherche par \TeX{} du fichier graphique à traiter dure plus longtemps que si cette recherche était confiée à la librairie \texttt{kpathsea}, à laquelle \TeX{} recourt normalement pour la recherche de fichiers, même si avec les processeurs actuels, l’augmentation de durée est négligeable. + +\item Les noms de fichiers sans leur chemin doivent être soigneusement différenciés dans Windows, qui ne distingue pas entre lettres minuscules et majuscules ; cette différenciation doit avoir lieu même si d’éventuels fichiers homonymes se trouvent dans des sous-répertoires. +\end{enumerate} + + De tels problèmes ne se posent pas si tous les fichiers graphiques se trouvent dans un seul sous-répertoire de celui qui contient le fichier principal du document ; on peut donc alors continuer d’utiliser \Macro{graphicspath} en toute sécurité. Si en revanche les parties d’un document complexe, par exemple les chapitres, se trouvent chacune dans son propre sous-répertoire, et si chaque partie conserve à son tour ses propres images dans un sous-sous-répertoire, la situation se montre très confuse et inutilement compliquée par rapport à celle que l’on peut avoir en incluant chaque fichier graphique en spécifiant son nom complet avec chemin et extension\footnote{Avant 2009, il était conseillé de ne pas spécifier l’extension, parce que les formats de fichiers graphiques que \texttt{latex} et \texttt{pdflatex} pouvaient inclure étaient mutuellement exclusifs, et donc dans le même dossier pouvait figurer une image donnée au format \texttt{.eps} aussi bien qu’au format \texttt{.pdf}. Aussi, sans spécifier l’extension et sans modifier le fichier-source, \texttt{latex} incluait le fichier \texttt{.eps}, tandis que \texttt{pdflatex} incluait le fichier \texttt{.pdf}. Comme, à présent, \texttt{pdflatex} peut inclure des fichiers graphiques au format \texttt{.eps}, cette façon de procéder n’a plus de raison d’être, et peut même se révéler pernicieuse.}. + + La raison pour laquelle la recherche d’un fichier graphique dure plus longtemps en utilisant \Macro{graphicspath} résulte du fait que \TeX{} conserve en interne une liste des chemins spécifiés par cette commande. Dans un document complexe, avec de nombreux chapitres qui requièrent à leur tour différents chemins d’accès à leurs figures, cette recherche doit balayer récursivement tous les chemins d’accès contenus dans la liste en question et regarder dans chaque dossier spécifié par chacun de ces chemins. Si au contraire, on spécifie chaque fichier graphique avec son chemin d’accès, \TeX{} ne doit plus rien rechercher, mais pointe vers le fichier spécifique, étant donné que le nom complet du fichier est univoque. + + Le recours à la variable d’environnement \texttt{TEXINPUTS} apparaît également problématique\footnote{Cf. la réponse de David Carlisle au rapport de bogue de Markus Kohm : \url{http://www.latex-project.org/cgi-bin/ltxbugs2html?pr=latex/2618}.}. Cette variable peut être fixée selon les modalités propres aux divers systèmes d’exploitation. Bien qu’il s’agisse plus d’un ajout que d’une véritable modification de la variable \texttt{path} du système, celle-ci est de toute façon permanente et par conséquent sera modifiée pour chaque nouveau document (outre que les anciennes versions de Windows ne comportent pas la possibilité d’avoir séparément une variable \texttt{TEXINPUTS} du système et une de l’utilisateur). + +La méthode la plus sûre et efficace (et valide aussi pour \Macro{graphicspath}) consiste alors à définir des liens symboliques au moyen des commandes classiques \texttt{ln\,-s} pour les systèmes UNIX et \texttt{mklink} dans Windows Vista ou Windows 7 (cette méthode est inapplicable avec les versions précédentes de Windows, qui ne connaissent pas les liens symboliques). À la différence de ce qui se produit avec \texttt{TEXINPUTS}, de tels liens, étant locaux, n’apportent aucune modification au \texttt{path} du système. Grâce à eux, les répertoires des images paraissent (virtuellement) présents dans le répertoire du document, où qu’ils soient placés physiquement sur le disque dur, et ils sont donc identifiés par \Macro{write18}, partiellement autorisé. + +Il est toujours utile de consulter la documentation du système d’exploitation et de la distribution \TeX{} utilisés. + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%\subsection{Macros spécifiques à une langue – \texttt{\TB\protect\( \langle \textit{machin} \rangle \protect\)name}} +\subsection{Macros spécifiques à une langue : \texttt{\TB…name}} +\label{sec:die-macroname-makros} + +De temps à autre la question revient sur \News{de.comp.text.tex} de comment modifier, par exemple, «Références» en «Liste des ouvrages cités» ou autre entête. Aussi ces macros ont été rassemblées dans le tableau~\vref{tab:von-paketfr-btw}. Elles sont tirées de l'extension \Paket{frenchb}. Plus précisément, elles sont tirées des fichiers \textsf{frenchb.ldf} pour \Paket{babel} et \textsf{gloss-french.ldf} pour \Paket{polyglossia}. + +Par exemple, pour changer «Table des figures» en «Table des illustrations», on utilisera la commande suivante : +\begin{verbatim} +\renewcommand*{\listfigurename}{Table des illustrations} +\end{verbatim} + +Les autres macros se changent de manière analogue. Si l’on utilise \Paket{babel}, il faut passer par \Macro{addto}. En effet, chaque changement de langue (dans notre cas le français) appelle la commande \captionsfrench : la personnalisation serait donc perdue et le terme employé par défaut réintroduit. La commande \Macro{addto} est définie dans \Paket{babel}, mais on peut l’appliquer aussi à \Paket{polyglossia}, mais en prenant soin de charger en outre \Paket{etoolbox}. Voir aussi \Doku{De-TeX-FAQ}sur ce thème\footnote{«Meine Versuche, \Macro{figurename}, \Macro{tablename} o.\,ä. bei Verwendung des Pakets \Paket{babel} umzudefinieren, mißlingen. Was kann ich tun?», in \url{http://projekte.dante.de/DanteFAQ/Verschiedenes. }}\footnote{Et, pour le français, voyez la «Documentation sur le module frenchb de Babel» par Daniel Flipo, disponible sur \url{http://daniel.flipo.free.fr/frenchb/} \NDT}. + +La façon correcte d’écrire est par conséquent : +\begin{verbatim} +\addto{\captionsfrench}{% + \renewcommand*{\listfigurename}{Table des illustrations}} +\end{verbatim} + +Si l’on utilise \KOMAScript{}, il convient d’employer la commande équivalente fournie \Macro{renewcaptionname} : + +\begin{verbatim} +\renewcaptionname{french}{\listfigurename}{Figure} +\end{verbatim} +Cette commande doit figurer après \verb+\begin{document}+. + +\begin{table}[t!] + \centering +\begin{threeparttable} + \caption{Macros définies par \Paket{babel} et \Paket{polyglossia} + avec l'option \Option{french}}% \NDT + \label{tab:von-paketfr-btw} + \begin{tabular}{@{}lll@{}} + \addlinespace + \toprule + \multicolumn{1}{@{}F}{Nom de macro} & + \multicolumn{1}{F}{Définition originelle} & + \multicolumn{1}{F@{}}{Sortie habituelle en français} \\ + \cmidrule(r){1-1}\cmidrule(lr){2-2}\cmidrule(l){3-3} + \Macro{prefacename} & Preface & \prefacename \\ + \Macro{refname}\tnote{a} & References & \refname \\ + \Macro{abstractname} & Abstract & \abstractname\\ + \Macro{bibname}\tnote{b} & Bibliography & \bibname \\ + \Macro{chaptername} & Chapter & \chaptername \\ + \Macro{appendixname} & Appendix & \appendixname \\ + \Macro{contentsname} & Contents & \contentsname \\ + \Macro{listfigurename} & List of Figures & \listfigurename\\ + \Macro{listtablename} & List of Tables & \listtablename \\ + \Macro{indexname} & Index & \indexname \\ + \Macro{figurename} & Figure & \figurename \\ + \Macro{tablename} & Table & \tablename \\ + \Macro{partname} & Part & \partname \\ + \Macro{enclname} & encl & \enclname \\ + \Macro{ccname} & cc & \ccname \\ + \Macro{headtoname} & To & — \\ + \Macro{pagename} & Page & \pagename \\ + \Macro{seename} & see & \seename \\ + \Macro{alsoname} & see also & \alsoname \\ + \Macro{proofname} & Proof & \proofname \\ + \Macro{glossaryname} & Glossary & \glossaryname \\ + \bottomrule + \end{tabular} +\begin{tablenotes}\footnotesize + \item[a]Seulement dans la classe \texttt{article}. + + \item [b]Seulement dans les classes \texttt{report} et \texttt{book}. +\end{tablenotes} +\end{threeparttable} +\end{table} + +\clearpage +\pagestyle{plain} +\appendix +\setcounter{secnumdepth}{0} + \section{Annexe : exemple de \texttt{\TB sloppy}} +\label{sec:beispiel-zu-sloppy} +Voici le code de l'exemple que Markus Kohm a publié : +\begin{bspcode}{\MID{8557097.gEimXdBtjU@ID-107054.user.dfncis.de}{8557097.gEimXdBtjU@ID-107054.user.dfncis.de}}% +\footnotesize +\begin{verbatim} +\documentclass{article} + +\setlength{\textwidth}{20em} +\setlength{\parindent}{0pt} +\begin{document} +\typeout{First without \string\sloppy\space and underfull \string\hbox} + +tatata tatata tatata tatata tatata tatata ta\-ta\-tata +tatata tatata tatata tatata tatata tatata tata\-tata +tatata tatata tatata tatata ta\-tatatatt\-ta +tatata tatata tatata tatata tatata tatata ta\-ta\-ta\-ta + +\typeout{done.} + +\sloppy +\typeout{Second with \string\sloppy\space and underfull \string\hbox} + +tatata tatata tatata tatata tatata tatata ta\-ta\-tata +tatata tatata tatata tatata tatata tatata tata\-tata +tatata tatata tatata tatata ta\-tatatatt\-ta +tatata tatata tatata tatata tatata tatata ta\-ta\-ta\-ta + +\typeout{done.} +\end{document} +\end{verbatim} +\end{bspcode} +\vspace{2\baselineskip} + +\footnotesize +\section{\normalsize L’utilisation de \texttt{\TB graphicspath} (version allemande)} + +La macro fort répandue \Macro{graphicspath} devrait être évitée et remplacée par la variable d’environnement \texttt{TEXINPUTS} pour les raisons suivantes \footnote{Cf. la réponse de David Carlisle au rapport de bogue de Markus Kohm : \url{http://www.latex-project.org/cgi-bin/ltxbugs2html?pr=latex/2618}}: +\begin{enumerate} +%%\item Les séparateurs de répertoire dépendent de la plate-forme +% %Windows/Unixs : « \texttt{/} », Macs : « \texttt{:} ». +\item La recherche par \TeX{} dure davantage que si cette tâche est confiée à la bibliothèque kpathsea (avec les processeurs actuels, cela n’a plus la même importance). +\item Chaque image consomme une partie de la mémoire allouée à \TeX{} et celle-ci n’est plus disponible durant toute la compilation.\\ +\end{enumerate} +% +Dans un Bourne-shell, on peut utiliser la commande suivante : +\begin{verbatim} +[luser@host]> TEXINPUTS=Rep_Images: latex datei.tex +\end{verbatim} +ou ajouter cette ligne dans \verb+$HOME/.profile+ : +\begin{verbatim} +export TEXINPUTS=./Rep_Images: +\end{verbatim}% +Cette ligne assure que les fichiers de \verb+ Rep_Images+ sous le répertoire de travail seront bien trouvés.\\% + +Sous Microsoft~Windows ($ \leqslant 98$), on fixe la variable d’environnement au moyen de : +\begin{verbatim} +set TEXINPUTS=.\Rep_Image; +\end{verbatim} +ou bien : +\begin{verbatim} +set TEXINPUTS=./Rep_Images; +\end{verbatim} +pour MiK\TeX{} dans le fichier \texttt{autoexec.bat}. Dans Windows~NT\textln{4} et Windows~2000, on peut fixer les variables d’environnement en allant dans \textsf{Panneau de configuration $\rightarrow$ Système $\rightarrow$ Environnement}, et dans Windows~XP, \textsf{Panneau de configuration $\rightarrow$ Système $\rightarrow$ Avancé $\rightarrow$ Variables d’environnement} + +Ces procédures sont données à titre d’exemples. Nous sommes conscients qu’on peut adapter \texttt{TEXINPUTS} de différentes façons ou par le biais d’autres fichiers. On trouvera plus de précisions dans la documentation du système d’exploitation ou de la distribution \TeX{}. +\normalsize +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +\clearpage +\begin{thebibliography}{99} +\bibitem{amsldoc-99} \textsc{American Mathematical Society}, \emph{User's Guide for the {\texttt{amsmath}} Package}. Version~2.0, décembre 1999. +\biburl{CTAN://macros/latex/required/amslatex/}\enspace + +\bibitem{graphicx-05} David~P. \textsc{Carlisle}, \emph{Packages in the `graphics' bundle}. Novembre 2005. + \biburl{CTAN://macros/latex/required/graphics/}\enspace + +\bibitem{ukfaq-13} Robin \textsc{Fairbairns}, \emph{The UK \TeX\ FAQ. Your 459 Questions Answered.}. Version~3.26, 28 février 2013. + \biburl{http://www.tex.ac.uk/faq}\enspace + +\bibitem{kohm-12} Markus \textsc{Kohm} et Jens-Uwe \textsc{Morawski}, \emph{\KOMAScript}. Version~3.11, juillet 2012. + \biburl{CTAN://macros/latex/supported/koma-script/}\enspace + +\bibitem{clsguide-06} \textsc{The \LaTeX3 Project Team}, \emph{\LaTeXe{} for class and package writers}. Février 2006. + \biburl{CTAN://macros/latex/doc/clsguide.pdf}\enspace + +\bibitem{fntguide-05} \textsc{The \LaTeX3 Project Team}, \emph{\LaTeXe{} font selection}. Novembre 2005. + \biburl{CTAN://macros/latex/doc/fntguide.pdf}\enspace + +\bibitem{usrguide-05} \textsc{The \LaTeX3 Project Team},\emph{\LaTeXe{} for authors}. Novembre 2005. + \biburl{CTAN://macros/latex/doc/usrguide.pdf}\enspace + +\bibitem{eulervm-05} Walter \textsc{Schmidt}, \emph{The Euler Virtual Math Fonts for use with \LaTeX{}}. Version~4, janvier 2005. + \biburl{CTAN://fonts/eulervm/}\enspace + +\bibitem{upgreek-03} Walter \textsc{Schmidt}, \emph{The {\textsf{upgreek}} package for {\LaTeXe}}. Version~2.0, février 2003. + \biburl{CTAN://macros/latex/contrib/supported/was/}\enspace + +\bibitem{psnfss-04} Walter \textsc{Schmidt}, \emph{Using common PostScript fonts with {\LaTeX}}. PSNFSS version 9.2, septembre 2004. + \biburl{CTAN://macros/latex/required/psnfss/psnfss2e.pdf}\enspace + +\bibitem{l2kurz-12} Marco \textsc{Daniel}, Patrick \textsc{Gundlach}, Walter \textsc{Schmidt}, Jörg \textsc{Knappen}, Hubert \textsc{Partl} et Irene \textsc{Hyna}, \emph{{\LaTeXe}-Kurzbeschreibung}. Version~3, juillet 2012. + \biburl{CTAN://info/lshort/german/} \\ + Dernière version de la traduction française disponible à + \biburl{CTAN://info/lshort/french}\enspace + +\bibitem{caption-11} Axel \textsc{Sommerfeldt}, \emph{Customizing captions of floating environments}. Version~3.3, novembre~2011. + \biburl{CTAN://macros/latex/contrib/caption/}\enspace + +\bibitem{glossaries-12} Nicola~L.\,C. \textsc{Talbot}, \emph{Upgrading from the glossary package to the glossaries package}. Novembre~2012. + \biburl{CTAN://macros/latex/contrib/glossaries/glossary2glossaries.pdf}\enspace + +\end{thebibliography} + +\end{document} +%%% Local variables: +%%% mode: LaTeX +%%% coding: utf8 +%%% End: +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% diff --git a/info/l2tabu/german/CHANGES b/info/l2tabu/german/CHANGES new file mode 100644 index 0000000000..a62b7598bf --- /dev/null +++ b/info/l2tabu/german/CHANGES @@ -0,0 +1,61 @@ +2.3 -> 2.4 +========== +03.02.2016: * Link in Fußnote 19 (zu Abschnitt 2.3.4) aktualisiert + * in 2.2.4 Verweis auf scrlayer-scrpage statt scrpage2 + * in 2.2.6 Hinweis auf selinput.sty ergänzt + +09.12.2012: * Abschnitt 3.4 komplett überarbeitet: + \graphicspath nicht mehr grundsätzlich abgelehnt + * Abschnitt 2.2.12 neu hinzugefügt + +11.10.2011: * in 2.2.11 Inkompatibilität zu caption.sty herausgenommen, + Ersetzungsbeispiel jetzt mit subcaptionbox statt subfigure + +2.2 -> 2.3 +========== +20.09.2011: * in 1.5 KOMA-Script-Optionen auf Version 3 aktualisiert + +19.09.2011: * Abschnitt 2.2.9 neu hinzugefügt + * Abschnitt 2.2.10 neu hinzugefügt + * Abschnitt 2.2.11 neu hinzugefügt + +18.09.2011: * Link auf spanische Version von l2tabu aufgenommen + * in 1.1 Klassenoption für KOMA-Script 3 aufgenommen + * in 1.2 anysize als veraltet ergänzt + * in 2.2.6 Hinweis auf LuaLaTeX ergänzt + * in 2.3.5 Ersetze-Durch-Kästen ergänzt + * Abschnitt 2.3.6 neu eingefügt + * in 3.4 Codebeispiele für den Gebrauch von TEXINPUTS überarbeitet + * einige Tippfehler und umständliche Formulierungen verbessert + +2.1 -> 2.2 +========== +05.08.2010: * weitere Aktualisierung der Literaturverweise + +24.07.2010: * Literaturverweise auf die DE-TeX-FAQ durch Links auf aktuelle + FAQ ersetzt, dabei Abschnitt 2.2.7 und Einleitung in Abschnitt + 2.3 umformuliert, um Verweise auf teilweise veraltete + Empfehlungen in der FAQ zu vermeiden (ae.sty und Ähnliche) + * im Quelltext auf Key-Value-Syntax von KOMA-Script 3 umgestellt + +13.07.2010: * in 3.5 Hinweis auf \renewcaptionname von KOMA-Script ergänzt + +29.03.2010: * Hinweis ergänzt, dass Schriften auf älteren CorelDraw-CDs + noch kein Euro-Zeichen enthalten + +17.10.2009: * einige Tippfehler korrigiert + +14.10.2009: * Versionsnummern und Daten im Literaturverzeichnis aktualisiert + + +2.0 -> 2.1 +========== +07.10.2009: * Abschnitt 2.3.8 (ae.sty, aecompl.sty, zefonts.sty) ergänzt + +15.09.2009: * in 2.2.5 wurde das Datum im Aufruf von caption aktualisiert + * in 2.2.6 wird für XeLaTeX das entsprechende Logo verwendet + * in 3.4 wurde »unterschiedliche Pfadtrenner« als Grund für die + Vermeidung von \graphicspath gelöscht + +12.09.2009: * in 1.6 deutlicher herausgestellt, dass $$...$$ bei Verwendung von + amsmath nicht durch displaymath ersetzt werden sollte diff --git a/info/l2tabu/german/README b/info/l2tabu/german/README new file mode 100644 index 0000000000..9842e2cda2 --- /dev/null +++ b/info/l2tabu/german/README @@ -0,0 +1,7 @@ +l2tabu is a collection of \LaTeXe "sins" with hints how to correct them. +Here you can find the original German version of the document. Translations +to English, French, Italian and Spanish are available on CTAN, too. + +l2tabu ist eine Sammlung von \LaTeXe "Suenden" mit Hinweisen, wie diese +korrigiert werden koennen. Hier findet man die deutsche Originalversion +dieses Dokumentes. diff --git a/info/l2tabu/german/l2tabu.pdf b/info/l2tabu/german/l2tabu.pdf Binary files differnew file mode 100644 index 0000000000..6466cf69cd --- /dev/null +++ b/info/l2tabu/german/l2tabu.pdf diff --git a/info/l2tabu/german/l2tabu.tex b/info/l2tabu/german/l2tabu.tex new file mode 100644 index 0000000000..1142a38a00 --- /dev/null +++ b/info/l2tabu/german/l2tabu.tex @@ -0,0 +1,1690 @@ +%%%------------------------------------------------------------------ +%%% Filename: l2tabu.tex +%%% Author: Marc Ensenbach <Marc.Ensenbach@post.rwth-aachen.de> +%%% Orig. Author: Mark Trettin <Mark.Trettin@gmx.de> +%%% Created: 07 Mär 2005 13:36:50 +%%% Last Modif.: 03 Feb 2016 +%%% Version: 2.4 +%%% +%%% Copyright (C) 2005 by Mark Trettin +%%% Copyright (C) 2016 by Marc Ensenbach +%%%------------------------------------------------------------------ +%\documentclass[11pt,a4paper,pagesize,%normalheadings,% +%tablecaptionabove,pointlessnumbers,tocleft]{scrartcl} +\documentclass[fontsize=11pt,paper=a4,pagesize,captions=tableheading,numbers=noenddot,toc=flat]{scrartcl} +%--------------- Grundkonfiguration (deutsch, 8bit) ----------------- +\usepackage[ngerman]{babel} % deutsche Trennmuster +\usepackage[latin1]{inputenc} % direkte Eingabe von Umlauten & Co. +\usepackage[T1]{fontenc} % T1-Schriften +\usepackage[babel,german=guillemets]{csquotes} % Anführungenen +\MakeAutoQuote{»}{«} % Autoquotes für csquotes.sty +\usepackage[scaled=.88]{beramono} % Bera-Monospace +\usepackage[scaled=.86]{berasans} % Bera Sans-Serif +\usepackage[osf]{mathpazo} % Palatino als Standardschrift +\linespread{1.05}\selectfont % Palatino braucht mehr Durchschuss + % (hier: 5%) +%%% Das folgende ist nicht sauber, aber es funktioniert (hier: Palatino) +\providecommand{\lining}{\fontfamily{ppl}\selectfont} +\providecommand{\oldstyle}{\fontfamily{fplj}\selectfont} +\DeclareTextFontCommand{\textln}{\lining} +\DeclareTextFontCommand{\textos}{\oldstyle} +%------------ zusaetzliche Pakete (Graphik, Tabellen) --------------- +\usepackage{xspace} % Automatische Leerzeichen nach Makros +\usepackage{booktabs,array} % Schönere Tabellen +\usepackage[german]{varioref} % für die veröffentlichte Version + % geändert, da die aktuellen fancy- bzw. + % varioref-Versionenen nicht + % zusammenarbeiten. (Immer noch?!) +\usepackage{textcomp} % Zusätzliche Zeichen +\usepackage[nofancy]{rcsinfo} % RCS-Informationen im Titel +\usepackage{varwidth} % Für die Ersetze-Umgebungen, +\usepackage{calc} % Zum Rechnen +\usepackage{amsmath} +\usepackage{graphicx} +\usepackage{caption} +%--------------------------- Formatierung --------------------------- +\addtokomafont{pagehead}{\small\itshape} +\addtokomafont{sectioning}{\rmfamily} +\addtokomafont{caption}{\footnotesize\itshape} +\addtokomafont{captionlabel}{\upshape\bfseries} +\addtokomafont{descriptionlabel}{\rmfamily} +\setcapindent{1em} +%\deffootnote[1.2em]{1.7em}{1em}{\makebox[1.2em][l]{\thefootnotemark}} +\deffootnote{2.25em}{1.75em}{\thefootnotemark\enspace} +%%% Überschriften +% \renewcommand*{\othersectionlevelsformat}[1]{% +% \makebox[22pt][l]{\csname the#1\endcsname\autodot}\enskip} +\reversemarginpar +\renewcommand*{\othersectionlevelsformat}[1]{% + \makebox[0pt][r]{\csname the#1\endcsname\autodot\enskip}} + +%%% Farben +\usepackage{color} +\definecolor{grau}{gray}{0.45} +\definecolor{rot}{rgb}{0.75,0.00,0.00} +\definecolor{blau}{rgb}{0.16,0.24,0.64} +\definecolor{gruen}{rgb}{0.18,0.58,0.08} +\definecolor{linkcolor}{rgb}{0,0,0.42} + +%--------------------------- PDF Optionen --------------------------- +\ifpdfoutput{%Benötigt KOMA-Scriptklasse + \usepackage{hyperref} % hyperref Einstellungen für pdf + \hypersetup{% + pdfauthor={(c) 2003, 2004, 2005, 2006, 2007 Mark Trettin, 2009, 2010, 2011 Marc Ensenbach},% + pdftitle={Das LaTeX2e-Sündenregister oder Veraltete Befehle, Pakete und andere Fehler},% + pdfsubject={Tipps zu LaTeX2e},% + bookmarksopen=true,% Temp + %backref=true, + linktocpage=true, + urlcolor=linkcolor, + citecolor=linkcolor, + linkcolor=linkcolor, + colorlinks=true, + } + \usepackage{microtype} + %% Später müssen wir die Möglichkeit haben, die Laufweitenänderung + %% für Beispiele zu deaktivieren, die das Standardverhalten von LaTeX + %% zeigen sollen: [Marc] + \SetExpansion[context=slbsp, factor=0]{encoding={OT1, T1, TS1}}{} + \newcommand{\EMail}[1]{\href{mailto:#1?Subject=[l2tabu.pdf]}{E-Mail-Kontakt: \texttt{#1}}} + \newcommand{\News}[1]{\href{news:#1}{\texttt{#1}}} + %% Diese Definition ist Mist, da muss ich nochmal drüber nachdenken. :-( + %% Mache ich später [Marc] + \newcommand{\MID}[2]{\href{http://groups.google.com/groups?as_umsgid=#1}% + {Message-ID \texttt{<#2>}}} +%--------------------------- PS Optionen ---------------------------- +}{ + \usepackage{hyperref} + \newcommand{\EMail}[1]{\href{mailto:#1}{E-Mail: \texttt{#1}}} + \newcommand{\News}[1]{\href{news:#1}{\texttt{#1}}} + \newcommand{\MID}[2]{<#1>}{Message-ID: \texttt{<#2>}} +} +%-------------------------- neue Kommandos -------------------------- +%%% Gestohlen aus dem scrguide ;-) +\DeclareRobustCommand*{\Macro}[1]{\mbox{\texttt{\char`\\#1}}} +\DeclareRobustCommand*{\LMacro}[2]{\mbox{\texttt{\char`\\#1\{#2\}}}} +\DeclareRobustCommand*{\GMacro}[2]{\mbox{\texttt{\{\char`\\#1\ #2\}}}} +%%% DANTE +\providecommand{\CTANserver}{ftp.dante.de} +%%% Make CTAN:// be an alias of ftp://\CTANserver/tex-archive/ +\makeatletter +\def\url@#1{\expandafter\url@@#1\@nil} +\def\url@@#1://#2\@nil{% + \def\@tempa{#1}\def\@tempb{CTAN}\ifx\@tempa\@tempb + \hyper@linkurl{\Hurl{#1:#2}}{ftp://\CTANserver/tex-archive/#2}% + \else + \hyper@linkurl{\Hurl{#1://#2}}{#1://#2}% + \fi +} +\makeatother + +%%% XeLaTeX-Logo (\XeTeX aus dtklogos entliehen und angepasst) +\newcommand{\XeLaTeX}{\smash{X\kern-.1em\lower.5ex\hbox{\reflectbox{E}}\kern-.07em\LaTeX}} + +%%% von mir für \dots +\pdfstringdefDisableCommands{% + \edef\dots{\string...}% +} + +%%% Ganz, ganz kruder Hack um die URL in eine eigene Zeile zu bekommen, +%%% *ohne* zusätzlichen Abstand. :-( +\newcommand{\biburl}[1]{\hfill\\URL:~\url{#1}} + +%%% Kommandos +\newcommand{\zB}{zum Beispiel\xspace} +\newcommand{\ZB}{Zum Beispiel\xspace} +\newcommand{\bzw}{beziehungsweise\xspace} +\newcommand{\Doku}[1]{\textsf{#1}\xspace} +%%% Paket ,Klasse, Bibstil: SansSerif +\newcommand{\Paket}[1]{\textsf{#1.sty}\xspace} +\newcommand{\PakeH}[1]{#1.sty\xspace} +\newcommand{\Klasse}[1]{\textsf{#1.cls}\xspace} +\newcommand{\KlassH}[1]{#1.cls\xspace} +\newcommand{\Bst}[1]{\textsf{#1.bst}\xspace} +\newcommand{\BstH}[1]{#1.bst\xspace} +%%% Optionen: SansSerif +\newcommand{\Option}[1]{\textsf{#1}\xspace} + +\newcommand{\TB}{\textbackslash} + +% Das gefällt mir noch nicht. Vorschläge? +% Nö. Denke ich später mal drüber nach. [Marc] +\newcommand{\schlecht}[1][!]{\marginline{\texttt{#1}}} + +%%% Umgebungen für die Ersetzung +\newenvironment{Ers}[1][\linewidth]{% + \par\smallskip\noindent\textcolor{rot}{\textbf{\textsf{Ersetze:}}\marginline{$ + \triangleright$}}~\rahmenpr[#1]}% +{\endrahmenpr\hfill} + +% % ... Durch: +\newenvironment{Dur}[1][\linewidth]{% +\noindent\textcolor{gruen}{\textbf{\textsf{Durch:}}}~\rahmenpg[#1]}% +{\endrahmenpg\noindent} + +\newenvironment{Schlecht}[1][\linewidth]{% + \par\smallskip\rahmenpr[#1]}% +{\endrahmenpr\par\noindent} + +\newsavebox{\rahmenbox} + +\setlength{\fboxrule}{0.6pt} + +\newlength{\rahmenlength} +\newenvironment{rahmenpr}[1][\linewidth]{% + \setlength{\rahmenlength}{#1-2\fboxsep-2\fboxrule}% + \begin{lrbox}{\rahmenbox}\begin{varwidth}[t]{\rahmenlength}} + {\end{varwidth}\end{lrbox}\noindent\fcolorbox{rot}{white}{\usebox{\rahmenbox}}\vspace*{.5ex}} + +\newenvironment{rahmenpg}[1][\linewidth]{% + \setlength{\rahmenlength}{#1-2\fboxsep-2\fboxrule}% + \begin{lrbox}{\rahmenbox}\begin{varwidth}[t]{\rahmenlength}} + {\end{varwidth}\end{lrbox}\noindent\fcolorbox{gruen}{white}{\usebox{\rahmenbox}}\vspace*{.5ex}} + +% % Ersetze: ... +% \newenvironment{Ers}{% +% \par\noindent\textcolor{rot}{\textbf{\textsf{Ersetze:}}\marginline{$ +% \leftarrow$}}~\varwidth[t]{\linewidth}}% +% {\endvarwidth\hfill} + +% % ... Durch: +% \newenvironment{Dur}{% +% \noindent\textcolor{gruen}{\textbf{\textsf{Durch:}}}~\varwidth[t]{\linewidth}}% +% {\endvarwidth\noindent} + +% Schlechter Kot^WCode. Das gefällt mir auch noch nicht. Vorschläge? +% \newenvironment{Schlecht}{% +% \par\noindent\varwidth[t]{\linewidth}}% +% {\endvarwidth\schlecht\par\noindent} + +% Etwas kleinerer Abstand zwischen den \items +\newenvironment{description*}{% + \description% + \setlength{\itemsep}{0pt}}% + {\enddescription} +\newsavebox{\Quelle} + +% Beispielcode +\newenvironment{bspcode}[1]{% + \sbox{\Quelle}{\footnotesize Quelle: #1} + \center + \rule{\linewidth}{1.5pt} +}{% + \rule{\linewidth}{1.5pt} + \usebox{\Quelle} + \endcenter% +} +%------------------- Tabellenspaltendefinitionen -------------------- +% Benötigt array +%\newcolumntype{v}[1]{>{\raggedright\hspace{0pt}}p{#1}} % v-Spalte, wie + % p-Spalte nur + % linksbündig +%\newcolumntype{V}[1]{>{\footnotesize\raggedright\hspace{0pt}}p{#1}} +\newcolumntype{N}{>{\footnotesize}l} +%\newcolumntype{C}{>{\footnotesize}c} + +%----------------------- Beginn des Dokuments ----------------------- +\begin{document} +\pagestyle{headings} +%%% RCS Info für die Versionsangaben. +\rcsInfo $Id: l2tabu.tex,v 2.4 2016/02/03 21:52:00 marc Exp marc $ +%----------------------------- Titelseite ---------------------------- +\begin{titlepage} +\pdfbookmark[1]{Titelseite}{tit} + \raggedright + \noindent + \rule{\linewidth}{1pt}% + \vspace{2\baselineskip} + {\LARGE\bfseries + Das \LaTeXe-Sündenregister\\[1ex] + \large + oder Veraltete Befehle, Pakete und andere Fehler}\\ + \vspace{2\baselineskip} + \noindent + \rule{\linewidth}{1pt}% + \vspace{\baselineskip} + \raggedleft + \textit{Marc Ensenbach, Mark Trettin}\\ + \EMail{Marc.Ensenbach@post.rwth-aachen.de}\\[1.5\baselineskip] + Version \rcsInfoRevision\ vom \rcsInfoLongDate\\[2\baselineskip] + \vspace{\baselineskip} + \begin{center} + \let\footnoterule\relax + \begin{minipage}{.9\linewidth} + \small + \begin{center} + \textbf{Zusammenfassung} + \end{center} + \noindent + Die Erstellung dieser kleinen Übersicht wurde angeregt durch eine + Diskussion in der deutschsprachigen + \TeX"=Newsgroup\footnote{\News{de.comp.text.tex}} + über das wiederholte Auftauchen von veralteten und \enquote{schlechten} + Paketen und Befehlen. + + Wir versuchen in diesem Artikel die gängigsten Fehler zu zeigen und + Alternativen anzubieten. Diese Übersicht soll weder Einführungen wie + \Doku{l2kurz}~\cite{l2kurz:03} noch die + \Doku{De-TeX-FAQ}\footnote{\url{http://projekte.dante.de/DanteFAQ/WebHome}} + ersetzen, sondern lediglich einen kleinen Überblick bieten. + + Für Vorschläge, Verbesserungen und Kommentare sind wir dankbar. + \end{minipage} + \end{center} + \vfill +\end{titlepage} +%------------------------ Ende der Titelseite ---------------------------- +\clearpage +%%% Copyright +\noindent +Copyright \copyright{} 2003--2007 by Mark Trettin, 2009--2011 by Marc Ensenbach. +\medskip + +\noindent +This material may be distributed only subject to the terms and +conditions set forth in the \emph{Open Publication License}, v1.0 or +later (the latest version is presently available at +\url{http://www.opencontent.org/openpub/}). +\medskip + +\noindent +Die in dieser Publikation erwähnten Software- und Hardwarebezeichnungen +sind in den meisten Fällen auch eingetragene Warenzeichen und +unterliegen als solche den gesetzlichen Bestimmungen. +\vfill + +\noindent +Wir bedanken uns bei +Ralf Angeli, +Christoph Bier, +Christian Faulhammer, +Jürgen Fenn\footnote{Englische Übersetzung: \url{CTAN://info/l2tabu/english/l2tabuen.pdf}}, +Ulrike Fischer, +Ralf Heckmann, +Yvon Henel\footnote{Französische Übersetzung: \url{CTAN://info/l2tabu/french/l2tabufr.pdf}}, +Yvonne Hoffmüller, +David Kastrup, +Markus Kohm, +Thomas Lotze, +Gonzalo Medina Arellano\footnote{Spanische Übersetzung: \url{CTAN://info/l2tabu/spanish/l2tabues.pdf}}, +Frank Mittelbach, +Heiko Oberdiek, +Walter Schmidt, +Uwe Siart, +Axel Sommerfeld, +Stefan Stoll, +Knut Wenzig, +Emanuele Zannarini\footnote{Italienische Übersetzung: \url{CTAN://info/l2tabu/italian/l2tabuit.pdf}} +und Reinhard Zierke +für Tipps, Anmerkungen und Korrekturen. Falls wir jemanden vergessen +haben sollten, bitten wir um eine Mail. +\clearpage + +\enlargethispage{2\baselineskip} +\tableofcontents +\pdfbookmark[1]{Inhaltsverzeichnis}{toc} +\clearpage + +% \addsec{Vorwort zur Version \rcsInfoRevision} +% \label{sec:vorwort} + +\clearpage +\section{\enquote{Todsünden}} +\label{sec:todsunden} +In diesem Abschnitt haben wir die wohl schlimmsten Fehler +zusammengetragen, die in schöner Regelmäßigkeit in +\News{de.comp.text.tex} auftauchen und den dortigen Regulars entweder +die Zornesröte ins Gesicht oder die Tränen in die Augen treiben. +\texttt{;-)} + + +\subsection{\PakeH{a4}, \PakeH{a4wide}} +\label{sec:paketa4-paketa4wide} + +Diese \enquote{beiden} Pakete sollten nicht mehr verwendet und ersatzlos aus +dem \LaTeX-Quelltext gestrichen und durch die Klassenoption +\Option{a4paper} beziehungsweise \Option{paper=a4} für \KOMAScript{} ab +Version 3 ersetzt werden. Abgesehen davon, dass das +Layout der meisten dieser Pakete typografisch mehr als fragwürdig ist, +existieren mehrere verschiedene, zu einander inkompatible Versionen. +Man kann sich also nicht einmal sicher sein, dass auf einem anderen +Rechner das Dokument gleich (schlecht?) aussieht. + +\subsection{Layoutänderungen} +\label{sec:layoutanderungen} +Die von den Standardklassen (\Klasse{article}, \Klasse{report}, +\Klasse{book}) verwendeten Satzspiegel wirken häufig zu groß. Abhilfe +bieten die entsprechenden Klassen (\Klasse{scrartcl}, \Klasse{scrreprt}, +\Klasse{scrbook}) aus dem \KOMAScript-Paket oder das ebenfalls dort +enthaltene \Paket{typearea}. Die dazugehörige Dokumentation +\Doku{scrguide}~\cite{kohm:10} enthält viele weiterführende +Informationen. + +Wenn man wirklich einen anderen Satzspiegel als den von \zB +\Paket{typearea} erzeugten benötigt, dann sollte man bitte das Paket +\Paket{geometry} verwenden und nicht versuchen, +\enquote{zu Fuß} \Macro{oddsidemargin} \& Co. zu ändern. Das Paket +\Paket{anysize} ist veraltet, und das hier +vormals empfohlene Paket \Paket{vmargin} sollte ebenfalls vermieden +werden, da es unerwünschte Nebeneffekte erzeugen +kann.\footnote{Vergleiche auch \MID{uirrzdr16.fsf@uwe-siart.de}{uirrzdr16.fsf@uwe-siart.de}} + +Unter gar keinen Umständen sollte man an \Macro{hoffset} \bzw +\Macro{voffset} herumfummeln, außer man kennt sich sehr gut mit den +\TeX-Interna aus. + +\subsection{Änderungen von Paketen und Klassen} +\label{sec:ander-von-paket} +Niemals Dokumentklassen (\Klasse{article}, \Klasse{scrbook} usw.) oder +Styledateien (\Paket{varioref}, \Paket{color}) direkt ändern! Entweder +man bastelt sich Containerklassen \bzw{} -styles oder man \emph{kopiert} +die Klassen/Styles, ändert die Kopie und speichert diese unter +\emph{anderem} Namen ab. + +Ein Beispiel zur Erstellung von Containerklassen findet sich in der +\Doku{FAQ} zur Anpassung von Dokumentenklassen\footnote{\url{http://projekte.dante.de/DanteFAQ/Dokumentenklasse}}. + +\paragraph{Hinweis} +\label{sec:hinweis} + +Generell sollte man solche zusätzlich installierten Klassen und Pakete +entweder in den lokalen oder den \texttt{\$HOME}-\TeX-Baum speichern, +damit bei einem Upgrade der \TeX-Distribution diese Änderungen nicht +überschrieben werden. Braucht man diese Änderungen nur in dem +speziellen Projekt und möchte es weitergeben, dann kann man die +angepasste Klasse auch im aktuellen Projektverzeichnis speichern. + +\subsection{Änderung des Zeilenabstandes mittels \texttt{\TB baselinestretch}} +\label{sec:ander-des-zeil} +Anpassungen von Parametern sollten generell auf der obersten dafür +vorgesehenen Ebene der Benutzungsschnittstelle erfolgen. Eine +Änderung des Durchschusses kann auf drei Ebenen durchgeführt werden: +\begin{enumerate} +\item Verwendung des Paketes \Paket{setspace} +\item Verwendung der \LaTeX{}"=Anweisung \LMacro{linespread}{<Faktor>} +\item Umdefinition von \Macro{baselinestretch} +\end{enumerate} +Eine Umdefinition von Parametern wie \Macro{baselinestretch} stellt +die unterste Ebene dar und sollte deshalb Paketen vorbehalten bleiben. +Eine bessere, da extra dafür vorgesehene Methode, ist die Verwendung +von \LMacro{linespread}{<Faktor>}. Die beste Vorgehensweise stellt +aber die Verwendung des Paketes \Paket{setspace} dar, das sich bei der +Änderung des Durchschusses um die Beibehaltung der Abstände in +Fußnoten oder Listenumgebungen kümmert, deren Änderung meist nicht +erwünscht ist. + +Wenn man also einen größeren Durchschuss benötigt (\zB +eineinhalbzeilig oder zweizeilig), bietet sich folglich zuerst das +Paket \Paket{setspace} an. Möchte man hingegen nur kleine Anpassungen +für andere Schriften als Computer Modern (\zB Palatino) machen, dann +kann \bzw sollte man \LMacro{linespread}{<Faktor>} verwenden. + +Bei der Schrift Palatino bietet sich beispielsweise \LMacro{linespread}{1.05} +an. + +\subsection{Absatzeinzug und -abstand (\texttt{\TB{}parindent}, \texttt{\TB{}parskip})} +\label{sec:absatz-und-abst} + +Den Absatzeinzug (\Macro{parindent}) zu ändern, kann manchmal sinnvoll +sein. Man sollte dabei aber beachten, dass +\begin{itemize} +\item man den Einzug mit einer schriftabhängigen Größe (em) und nicht + mit einer absoluten Größe (mm) ändert. Die \enquote{Schriftabhängigkeit} + bedeutet hierbei nicht nur, dass sich der Einzug mit der Schriftgröße + ändert, sondern beinhaltet darüberhinaus auch eine Abhängigkeit von der + Schriftart, da die Geviertgröße $1$em vom jeweiligen Entwerfer individuell + für jede Schriftart angepasst wird. +\item man \LaTeX-Syntax verwendet, da diese die wenigsten Probleme birgt. + \ZB ist sie für externe Programme/Skripte leichter zu + parsen\footnote{syntaktisch analysieren, aufspalten}, für den Benutzer + besser zu warten, und es gibt keine Inkompatibilitäten mit anderen + Paketen (\Paket{calc}). + + \begin{Ers} + \Macro{parindent}\texttt{=1em} + \end{Ers} + \begin{Dur} + \LMacro{setlength}{\Macro{parindent}\}\{1em} + \end{Dur} +\end{itemize} +% +Wenn man hingegen \emph{keinen} Absatzeinzug, dafür aber einen +zusätzlichen Durchschuss als Absatzkennzeichnung wünscht, sollte man +\emph{nicht} einfach +% +\begin{Schlecht} +\begin{verbatim} +\setlength{\parindent}{0pt} +\setlength{\parskip}{\baselineskip} +\end{verbatim} +\end{Schlecht}% +% +verwenden, da sich \Macro{parskip} auch auf Listen, Verzeichnisse und +Überschriften auswirkt. + +Das Paket \Paket{parskip} und die \KOMAScript-Klassen treiben einigen +Aufwand, um diese Begleiterscheinungen zu vermeiden. Zur Verwendung der +verschiedenen Optionen (\Option{parskip=full}, \Option{parskip=half} usw.) +von \KOMAScript\ siehe den \Doku{scrguide}~\cite{kohm:10}. Wenn eine +der \KOMAScript-Klassen verwendet wird, muss das Paket \Paket{parskip} +\emph{nicht} noch zusätzlich geladen werden. + +\subsection{Abgesetzte Formeln mit \texttt{\$\$\dots\$\$}} +\label{sec:abges-form-mit} + +Bitte nicht! \texttt{\$\$\dots\$\$} ist ein plain\TeX-Befehl und sollte +in \LaTeX\ vermieden werden, da dadurch die vertikalen Abstände bei +abgesetzten Formeln inkonsistent werden (siehe auch +Abschnitt~\vref{sec:mathematiksatz}, insbesondere die Warnung bezüglich +\texttt{displaymath} im Zusammenhang mit \Paket{amsmath}). Ferner +funktioniert die Klassenoption \Option{fleqn} nicht mehr. +\begin{Ers} +\verb|$$...$$| +\end{Ers} +\begin{Dur} +\begin{verbatim} +\[...\] +\end{verbatim} + oder (nur bei Verwendung von \Paket{amsmath}) +\begin{verbatim} +\begin{equation*} + ... +\end{equation*} +\end{verbatim} + oder (nur ohne \Paket{amsmath}) +\begin{verbatim} +\begin{displaymath} + ... +\end{displaymath} +\end{verbatim} +\end{Dur} + +\subsection{\texttt{\TB def} vs. \texttt{\TB newcommand}} +\label{sec:def-vs.-newcommand} +Makros sollte man \emph{immer} mittels \verb+\newcommand{<name>}{...}+ +definieren und \emph{nicht} mit +\Macro{def}\LMacro{<name>}{\dots}.\footnote{Siehe auch + \cite[Abschnitt 2.7.2]{clsguide:06} und \cite[Abschnitt 3.4]{usrguide:05}} + +Das Hauptproblem von \Macro{def} ist, dass keine Überprüfung auf die +Existenz eines Makros durchgeführt wird. Es wird deshalb gegebenenfalls ohne +Fehlermeldung/""Warnung überschrieben. + +Bereits existierende Makros können mit \verb+\renewcommand{<name>}{...}+ +umdefiniert werden. + +Wer genau weiß, \emph{warum} er \Macro{def} benötigt, weiß auch um +dessen Nach- \bzw Vorteile und kann diesen Unterpunkt getrost +ignorieren. + +\subsection{Verwendung von \texttt{\TB sloppy}} +\label{sec:verw-von-textttt} + +Der Schalter \Macro{sloppy} sollte nicht verwendet werden, schon gar +nicht global in der Präambel. Wenn man in einzelnen Absätzen Probleme +mit dem Umbruch hat, gilt: +\begin{enumerate} +\item Überprüfen, ob die entsprechenden Trennmuster (z.\,B. mittels + \Paket{babel}) und T1-Schriften geladen sind (siehe auch + die \Doku{FAQ} zur Silbentrennung\footnote{\url{http://projekte.dante.de/DanteFAQ/Silbentrennung}}). +\item Paket \Paket{microtype} verwenden. Dadurch wird die Laufweite der + Buchstaben leicht angepasst, um einen besseren Umbruch zu erreichen. + Diese automatische Anpassung ist nur mit pdf\TeX{} ab Version 1.20 + möglich und funktioniert nur bei der Erzeugung einer PDF-Datei, + nicht jedoch bei der Verwendung von pdf\TeX{} im DVI-Modus. +\item Umformulieren. Man muss nicht unbedingt den Satz, in dem das + Umbruchproblem auftritt umformulieren, oft reicht es schon einen der + vorhergehenden oder nachfolgenden Sätze umzuformulieren/umzustellen. +\item Moderate Anpassung der Parameter, die \TeX{} bei der Berechnung + der Zeilenumbrüche verwendet. Axel Reichert hat in + \News{de.comp.text.tex} einmal seine persönliche + Anpassung\footnote{Man kann diese Werte natürlich nach dem + persönlichen Geschmack ändern, aber man sollte vor allem bei + \TB\texttt{emergencystretch} aufpassen. Sonst erhält man einen + löchrigen Blocksatz, wie bei einem sehr bekannten Textverarbeitungsprogramm.} + gepostet\footnote{Zu finden unter der + \MID{a84us0$plqcm$7@ID-30533.news.dfncis.de}{a84us0\$plqcm\$7@ID-30533.news.dfncis.de}}, + mit der sich die meisten Umbruchprobleme bei weiterhin gutem Layout + vermeiden lassen. (Man sollte hierbei allerdings beachten, dass nun + auftretende Warnungen \emph{wirklich} zu beherzigen und durch + Umformulieren zu beseitigen sind.): + + \begin{minipage}[t]{\linewidth} +\begin{verbatim} +\tolerance 1414 +\hbadness 1414 +\emergencystretch 1.5em +\hfuzz 0.3pt +\widowpenalty=10000 +\vfuzz \hfuzz +\raggedbottom +\end{verbatim} + \end{minipage} +\end{enumerate} +% +Erst wenn diese Punkte nicht geholfen haben, kann man versuchen, mit +der \texttt{sloppypar}"=Umgebung den nachfolgenden Absatz »lockerer« +zu setzen. + +\begin{figure}[htp] + % Falls sich jemand über das zusätzliche \fussy bzw. das fehlende + % \sloppy wundert: Use the Source Luke! \parbox setzt per default + % \sloppy, so dass man für einen originalen Umbruch \fussy benötigt. + % Weiter muss für die Beispiele die Laufweitenänderung durch das + % microtype-Paket deaktiviert werden, damit das Standardverhalten von + % LaTeX demonstriert werden kann. [Marc] + \begin{minipage}[t]{.48\textwidth} + \centering + \linespread{1.0} + {\fontsize{10pt}{12pt}\fontencoding{OT1}\selectfont + \fbox{\parbox{17.61em}{\microtypecontext{expansion=slbsp}\fussy% + tatata tatata tatata tatata tatata tatata tata\-tata tatata tatata + tatata tatata tatata tatata tata\-tata tatata tatata tatata tatata + ta\-tatatatt\-ta tatata tatata tatata tatata tatata tatata + ta\-ta\-ta\-ta}}}% + \caption{Beispiel mit \LaTeX s Standardwerten}% + \label{fig:beispiel-mit-latex}% + \end{minipage}% + \hfill% + \begin{minipage}[t]{.48\textwidth} + \centering + \linespread{1.0} + {\fontsize{10pt}{12pt}\fontencoding{OT1}\selectfont + \fbox{\parbox{17.61em}{\microtypecontext{expansion=slbsp}% + tatata tatata tatata tatata tatata tatata tata\-tata tatata tatata + tatata tatata tatata tatata tata\-tata tatata tatata tatata tatata + ta\-tatatatt\-ta tatata tatata tatata tatata tatata tatata + ta\-ta\-ta\-ta}}}% + \caption{Beispiel mit \texttt{\string\sloppy}}% + \label{fig:beisp-mit-textttstr} + \end{minipage} +\end{figure} + +In den Abbildungen~\ref{fig:beispiel-mit-latex} und +\vref{fig:beisp-mit-textttstr} wird versucht, den Effekt von +\Macro{sloppy} darzustellen. Markus Kohm hat in \News{comp.text.tex} ein +Beispiel veröffentlicht, welches den Effekt sehr deutlich zeigt. Es +ist mit seiner Erlaubnis angehängt (siehe +Anhang~\vref{sec:beispiel-zu-sloppy}). + +%----------------------- Abschnitt Obsoletes ------------------------ +\clearpage +\section{Veraltete Befehle, Klassen und Pakete} +\label{sec:obsoletes} + +Markus Kohm hat ein Perl-Script geschrieben, mit dem man online auf +\url{http://kohm.de.tf/markus/texidate.html} seine Dateien auf die +häufigsten Fehler überprüfen kann. + +Allerdings ist zu beachten, dass es keinen vollständigen \TeX-Parser +enthält und deshalb nur die »offensichtlichen« Fehler +überprüfen kann. Erst testen, dann posten. + +\subsection{Befehle} +\label{sec:befehle} + +\subsubsection{Änderung des Schriftstils} +\label{sec:ander-des-schr} +In Tabelle~\vref{tab:befehle-zur-anderung} sind die alten und aktuellen +Befehle zur Änderung des Schriftstils gegenüber gestellt. Die als +»lokal« bezeichneten Makros wirken nur auf ihr Argument, wohingegen +die als »global/Schalter« bezeichneten sich auf den gesamten +folgenden Text bis zum Ende der aktuellen Gruppe auswirken. + +\begin{table}[htp]% Absatzumbruch hatte sich verändert :-\ + \begin{minipage}{\textwidth} + \renewcommand{\footnoterule}{} + \centering + \caption{Befehle zur Änderung des Schriftstils} + \label{tab:befehle-zur-anderung} + \begin{tabular}{@{}lll@{}} + \toprule + \multicolumn{1}{@{}N}{veraltet}& + \multicolumn{2}{N@{}}{Ersatz in \LaTeXe}\\ + \cmidrule(l){2-3} + & + \multicolumn{1}{N}{lokal} & + \multicolumn{1}{N@{}}{global/Schalter}\\ + \cmidrule(r){1-1}\cmidrule(lr){2-2}\cmidrule(l){3-3} + \GMacro{bf}{\dots} & \LMacro{textbf}{\dots} & \Macro{bfseries}\\ + --- & \LMacro{emph}{\dots} & + \Macro{em}\footnote{Nützlich in Makrodefinitionen. Innerhalb des + Texts sollte nicht \GMacro{em}{\dots}, sondern + \LMacro{emph}{\dots} verwendet werden.}\\ + \GMacro{it}{\dots} & \LMacro{textit}{\dots} & \Macro{itshape}\\ + --- & \LMacro{textmd}{\dots} & \Macro{mdseries}\\ + \GMacro{rm}{\dots} & \LMacro{textrm}{\dots} & \Macro{rmfamily}\\ + \GMacro{sc}{\dots} & \LMacro{textsc}{\dots} & \Macro{scshape}\\ + \GMacro{sf}{\dots} & \LMacro{textsf}{\dots} & \Macro{sffamily}\\ + \GMacro{sl}{\dots} & \LMacro{textsl}{\dots} & \Macro{slshape}\\ + \GMacro{tt}{\dots} & \LMacro{texttt}{\dots} & \Macro{ttfamily}\\ + --- & \LMacro{textup}{\dots} & \Macro{upshape}\\ + \bottomrule + \end{tabular} +\end{minipage} +\end{table} + +\paragraph{Warum sollte man die alten Befehle nicht verwenden?} +\label{sec:warum-sollte-man} + +Die alten Befehle unterstützen nicht die +Schriftverwaltung\footnote{NFSS: New Font Selection Scheme. Einen Überblick über das NFSS gibt der +\Doku{fntguide}~\cite{fntguide:05}.} von \LaTeXe. +\GMacro{bf}{foo} \zB setzt alle schon vorhandenen +Schriftattribute zurück, bevor es »foo« fett druckt. Das führt dazu, +dass man nicht einfach einen fett-kursiven Stil durch +\GMacro{it}{\Macro{bf Test}} definieren kann. (Die angegebene Definition +erzeugt: {\it\bf Test}.). Die aktuellen Befehle +\LMacro{textbf}{\LMacro{textit}{Test}} hingegen verhalten sich wie +erwartet und erzeugen: \textbf{\textit{Test}}. Ferner gibt es bei den alten Befehlen keine »Italic-Korrektur«, +\zB\ {\it fünf}hundert +(\GMacro{it}{fünf}\texttt{hundert}) und \textit{fünf}hundert +(\LMacro{textit}{fünf}\texttt{hundert}). + + +\subsubsection{Mathematische Brüche (\texttt{\TB over} vs. \texttt{\TB frac})} +\label{sec:textb-over-vs} +Der Befehl \Macro{over} sollte vermieden werden. +\Macro{over} ist ein \TeX-Befehl, der durch die von \LaTeX\ abweichende +Syntax schlechter \bzw nicht parsbar ist. Insbesondere das Paket +\Paket{amsmath} definiert \verb+\frac{}{}+ um, und man erhält +Fehlermeldungen bei der Verwendung von \Macro{over}. Ein weiteres +Argument für die Verwendung von \verb+\frac{}{}+ ist die für den +Benutzer -- vorallem bei komplexeren Brüchen -- einfachere Zuordnung von +Zähler und Nenner. +\begin{Ers} + \verb+$a \over b$+ +\end{Ers} +\begin{Dur} + \verb+$\frac{a}{b}$+ +\end{Dur} +\subsubsection{Zentrierung mit \texttt{\TB centerline}} +\label{sec:centerline} +Der Befehl \Macro{centerline} ist ebenfalls ein \TeX-Befehl und sollte +in \LaTeX\ vermieden werden. Einerseits ist \Macro{centerline} +inkompatibel zu einigen \LaTeX-Paketen (z.\,B. \Paket{color}), und +andererseits kann die Verwendung zu unerwünschten \bzw unerwarteten +Effekten führen: +\begin{center} + \begin{minipage}[t]{.45\textwidth} +\begin{verbatim} +\begin{enumerate} +\item\centerline{Ein Punkt} +\end{enumerate} +\end{verbatim} + \end{minipage}% + \hfill% +% \hspace{.05\textwidth}% + \fbox{ \begin{minipage}[t]{.45\textwidth} + \begin{enumerate} + \item \centerline{Ein Punkt} + \end{enumerate} + \end{minipage}} +\end{center} +\begin{Ers} + \LMacro{centerline}{\dots} +\end{Ers} +\begin{Dur} + \GMacro{centering}{\dots} oder + \begin{varwidth}[t]{\linewidth} +\begin{verbatim} +\begin{center} + ... +\end{center} +\end{verbatim} + \end{varwidth} +\end{Dur} + + +\paragraph{Anmerkung} +\label{sec:anmerkung-5} + +Einige Hinweise zur Zentrierung von Grafiken und Tabellen sind in +Abschnitt~\vref{sec:gleit-figure-table} zu finden. + +\subsection{Klassen und Pakete} +\label{sec:pakete} + +\subsubsection{\KlassH{scrlettr} vs. \KlassH{scrlttr2}} +\label{sec:paketscrl-vs.-pakets} + +Die Klasse \Klasse{scrlettr} aus dem \KOMAScript-Paket ist veraltet und +wurde durch die neue \Klasse{scrlttr2} ersetzt. Um ein \emph{ähnliches} Layout +wie die alte Klasse zu erreichen, kann man die Klassenoption +\Option{KOMAold} verwenden, die einen Kompatibilitätsmodus zur Verfügung +stellt. +\begin{Ers} + \verb+\documentclass{scrlettr}+ +\end{Ers}\par +\begin{Dur} + \verb+\documentclass[KOMAold]{scrlttr2}+ +\end{Dur} + + +\paragraph{Anmerkung} +\label{sec:anmerkung-3} +Für neue Vorlagen und Briefe, sollte aber die neue Schnittstelle +benutzt werden, da diese deutlich flexibler ist. + +Eine Erklärung der Unterschiede des Benutzerinterfaces +würde den Rahmen dieser Übersicht sprengen, deshalb wird hier auf +den \Doku{scrguide}~\cite{kohm:10} verweisen. + + +\subsubsection{\PakeH{epsf}, \PakeH{psfig}, \PakeH{epsfig} vs. + \PakeH{graphics}, \PakeH{graphicx}} +\label{sec:grafikeinbindung} + +Die Pakete \Paket{epsf} und \Paket{psfig} sind durch \Paket{graphics} +oder \Paket{graphicx} zu ersetzen. \Paket{epsfig} ist nur ein Wrapper\footnote{Hier: Ein Stylefile, +welches ein oder mehrere andere aufruft und damit Funktionen +nachbildet.} um \Paket{graphicx} für alte Dokumente, die mit +\Paket{psfig} erstellt wurden, verwenden zu können. + +Da \Paket{epsfig} intern \Paket{graphicx} benutzt, \emph{kann} man es +noch verwenden, sollte aber für neu erstellte Dokumente auf das +modernere \Paket{graphics} oder \Paket{graphicx} umsteigen. Die Syntax +der beiden letztgenannten Pakete ist deutlich flexibler. Das +Paket \Paket{epsfig} wird hauptsächlich aus Kompatibilitätsgründen +mitgeliefert. + +Zu den Unterschieden zwischen den Paketen \Paket{graphics} und +\Paket{graphicx} siehe \Doku{grfguide}~\cite{graphicx:05}. Hinweise zur +Zentrierung von Grafiken siehe Abschnitt~\vref{sec:gleit-figure-table}. +\begin{Ers} +\begin{verbatim} +\usepackage{psfig} +\psfig{file=Bild,...} +\end{verbatim} +\end{Ers} +\begin{Dur} +\begin{verbatim} +\usepackage{graphicx} +\includegraphics[...]{Bild} +\end{verbatim} +\end{Dur} + +\subsubsection{\PakeH{doublespace} vs. \PakeH{setspace}} +\label{sec:zeilenabstande} + +Um den Durchschuss zu ändern, sollte man das Paket \Paket{setspace} +verwenden. \Paket{doublespace} ist veraltet und wurde durch +\Paket{setspace} ersetzt. Bitte auch +Abschnitt~\vref{sec:ander-des-zeil} beachten. +\begin{Ers} + \verb|\usepackage{doublespace}| +\end{Ers} +\begin{Dur} + \verb|\usepackage{setspace}| +\end{Dur} + +\subsubsection{\PakeH{fancyheadings}, \PakeH{scrpage[2]} vs. \PakeH{fancyhdr}, \PakeH{scrlayer-scrpage}} +\label{sec:lebende-kolumn} + +Das Paket \Paket{fancyheadings} wurde durch \Paket{fancyhdr} ersetzt, +die Pakete \Paket{scrpage} und \Paket{scrpage2} aus dem +\KOMAScript-Bundle durch \Paket{scrlayer-scrpage}. Die Anleitung zu +\Paket{scrlayer-scrpage} befindet sich im \Doku{scrguide}~\cite{kohm:10}. + +\begin{Ers} + \verb+\usepackage{fancyheadings}+ +\end{Ers} +\begin{Dur} + \verb+\usepackage{fancyhdr}+ +\end{Dur} +\begin{Ers} + \verb+\usepackage{scrpage}+ +\end{Ers} +\begin{Dur} + \verb+\usepackage{scrlayer-scrpage}+ +\end{Dur} +\begin{Ers} + \verb+\usepackage{scrpage2}+ +\end{Ers} +\begin{Dur} + \verb+\usepackage{scrlayer-scrpage}+ +\end{Dur} + +\subsubsection{Die \PakeH{caption}-Familie} +\label{sec:die-caption-famile} +Das Pakete \Paket{caption2} sollte nicht mehr verwendet werden, da es +eine neue Version (v3.x) von \Paket{caption} gibt. Man sollte +allerdings darauf achten, dass eine nicht zu alte Version des Paketes benutzt +wird. Um dies sicherzustellen, sollte man das Paket folgendermaßen laden: +\begin{Ers} + \verb+\usepackage{caption}+ +\end{Ers} +\begin{Dur} + \verb+\usepackage{caption}[2008/08/24]+ +\end{Dur} + +Hatte man vorher \Paket{caption2} benutzt, dann sollte man unbedingt die +Dokumentation \Doku{anleitung}~\cite[Abschnitt~C.2]{caption:08} beachten. + +\subsubsection{\PakeH{isolatin}, \PakeH{umlaut} vs. \PakeH{inputenc}, \PakeH{selinput}} +\label{sec:eingabe-von-umlauten} + +\paragraph{Generelles} +\label{sec:generelles} + +Im Prinzip gibt es vier Möglichkeiten, Umlaute und andere +nicht-ASCII-Zeichen einzugeben: +\begin{enumerate} +\item \verb+H{\"u}lle+: Der Vorteil dieser Art der Eingabe ist, dass sie + immer und auf jedem System funktioniert. + + Die Nachteile hingegen sind, dass das Kerning\footnote{Einfügen + positiver \bzw negativer Abstände zwischen Zeichen in Abhängigkeit + der Zeichenkombination} zwischen den Buchstaben zerstört wird, es + in einem deutschsprachigen Text äußerst umständlich ist und dass es + äußerst schlecht lesbar ist. + + Diese Variante sollte man -- auf Grund des Kerningproblems -- + \emph{immer} vermeiden. + +\item Die Eingabe der Form \verb+H\"ulle+ \bzw \verb+H\"{u}lle+ hat die + oben genannten Kerningprobleme nicht und ist ebenfalls auf jedem + System nutzbar. + + Die Nachteile bei dieser Art, sind auch hier die aufwändige + Eingabe und schlechtere Lesbarkeit. + + Diese Variante ist die sinnvollste für + Makrodefinitionen und Stylefiles, da sie encoding- und paketunabhängig + ist.\label{item:die-eingabe-der} + +\item Mit \Paket{(n)german} \bzw der Option \Option{(n)german} beim Paket + \Paket{babel} kann man die Umlaute etwas einfacher (\verb+H"ulle+) + eingeben. Der Vorteil ist auch hier wieder, dass es auf allen + Systemen funktioniert. Da \Paket{babel} \bzw \Paket{(n)german} auf + allen \TeX-Installationen zu finden ist, sollte es auch keine + Kompatibilitätsprobleme geben. + + Die Nachteile sind auch hier die umständlichere Eingabe und + schlechtere Lesbarkeit. + + Diese Variante ist für Fließtext relativ gut verwendbar. Sollte aber + in Makrodefinitionen und Präambeln vermieden werden. + +\item Die direkte Eingabe (\verb+Hülle+). Die Vorteile liegen auf der + Hand. Der Text ist »normal« schreib- und lesbar. + + Der Nachteil ist, dass man \LaTeX\ mit der verwendeten + Eingabekodierung bekannt machen muss und dass es beim Austausch von + Dateien zwischen verschiedenen Systemen eventuell zu Problemen kommen + kann. Das ist \emph{kein} Problem für \TeX\ \bzw \LaTeX\ selbst, aber + es kann evtl. zu \emph{Darstellungsproblemen} in den Editoren auf den + verschiedenen Systemen führen. \ZB könnte ein in \textln{iso-8859-15} + (\textln{latin9}) kodierter \texteuro\ in einem Editor unter Windows (\textln{CP1252}) als + {\fontfamily{cmr}\selectfont\textcurrency}\ \emph{dargestellt} werden. + + Diese Variante ist sehr gut für Fließtext verwendbar. Sollte aber + in Makrodefinitionen und Präambeln vermieden werden. +\end{enumerate} +% +Zusammenfassend kann also gesagt werden, dass man in Makros, Präambeln +und Stylefiles die Form \verb+H\"ulle+ oder \verb+H\"{u}lle+ verwenden +sollte und im übrigen Text entweder \verb+H"ulle+ oder \verb+Hülle+. + +\paragraph{Eingabekodierung} +\label{sec:eingabekodierung-1} + +Um die verwendete Kodierung \LaTeX\ bekannt zu machen, sollte man +\emph{nicht} \Paket{isolatin1} \bzw \Paket{isolatin} oder +\Paket{umlaut} verwenden! Diese Pakete sind veraltet \bzw nicht auf +allen Systemen vorhanden. + +Korrekt ist das Paket \Paket{inputenc} mit folgenden Optionen zu benutzen: +\begin{description*} +\item[\Option{latin1/latin9}] für unixoide Systeme (\Option{latin1} ist auch unter + Microsoft~Windows und Mac~OS~X verwendbar) +\item[\Option{ansinew}] für Microsoft~Windows +\item[\Option{applemac}] für Macs\footnote{Bei der Verwendung von OS~X sollte + ebenfalls \Option{latin1/latin9} verwendet werden, da diese Kodierung besser + für den Dateiaustausch mit Benutzern anderer Betriebssysteme + geeignet ist als \Option{applemac}. Allerdings sollte unbedingt die + Eingabekodierung des verwendeten Editors beachtet werden.} +\item[\Option{cp850}] für \textln{OS/2} +\item[\Option{utf8}] für \enquote{moderne} unixoide Systeme \bzw für Systeme + (und Editoren), die Unicode (UTF-8) unterstützen +\end{description*} +\begin{Ers} + \verb|\usepackage{isolatin1}| +\end{Ers} +\begin{Dur} + \verb|\usepackage[latin1]{inputenc}| +\end{Dur} +\begin{Ers} + \verb|\usepackage{umlaut}| +\end{Ers} +\begin{Dur} + \verb+\usepackage[latin1]{inputenc}+ +\end{Dur} + +Alternativ bietet \Paket{selinput} die Möglichkeit, die Eingabekodierung über die Angabe kritischer Zeichen wie Umlaute festzulegen. + +\paragraph{Anmerkung} Die oben angegebene Methode zur Deklaration der +Eingabekodierung findet bei \enquote{klassischen} \LaTeX"=Übersetzern +wie pdf\LaTeX{} Anwendung. Die Neuentwicklungen \XeLaTeX{} und Lua\LaTeX{} +verarbeiten Unicode"=Dateien auch ohne Kodierungsangabe. Beide können bereits +produktiv eingesetzt werden, verlangen aber in der Regel ein Umschreiben +\enquote{alter} \LaTeX{}"=Dateien in Bezug auf die Sprach- und +Schriftartenwahl und besitzen auch noch nicht die mikrotypografischen +Fähigkeiten in dem Umfang, wie pdf\LaTeX{} sie bietet. + +\subsubsection{\PakeH{t1enc} vs. \PakeH{fontenc}} +\label{sec:schriftkodierung} + +Das Paket \Paket{t1enc} ist veraltet und sollte deshalb durch +\Paket{fontenc} ersetzt werden. +\begin{Ers} + \verb|\usepackage{t1enc}| +\end{Ers} +\begin{Dur} + \verb|\usepackage[T1]{fontenc}| +\end{Dur} + +\subsubsection{\BstH{natdin} vs. \BstH{dinat}} +\label{sec:liter-nach-din} + +Der Autor von \Bst{dinat} empfiehlt, \Bst{dinat} durch \Bst{natdin} zu +ersetzen, da die Weiterentwicklung von \Bst{dinat} eingestellt und +\Bst{natdin} stark verbessert wurde. +\begin{Ers} + \verb|dinat.bst| +\end{Ers} +\begin{Dur} + \verb|natdin.bst| +\end{Dur} + +\paragraph{Anmerkung} In früheren Versionen dieses Dokuments wurde +genau die gegenteilige Empfehlung gegeben, die auf dem damaligen +Entwicklungsstand beruhte. Die Verbesserungen an \Bst{natdin}, die +seither durchgeführt wurden, rechtfertigen nun die Bevorzugung von +\Bst{natdin}. + + +\subsubsection{\PakeH{glossary} vs. \PakeH{glossaries}} +\label{sec:glossar} + +Das Paket \Paket{glossary} ist veraltet; als Nachfolger wurde +von der Autorin \Paket{glossaries} bereitgestellt. +Details zum Umstieg finden sich in \cite{glossaries:11}. + + +\subsubsection{\PakeH{SIstyle} und \PakeH{SIunits} vs. \PakeH{siunitx}} +\label{sec:einheiten} + +Die Pakete \Paket{SIstyle} und \Paket{SIunits} zum Satz von physikalischen +Einheiten werden nicht mehr weiterentwickelt. Die Funktionalität beider +Pakete wurde im Nachfolger \Paket{siunitx} vereint. Aufgrund der großen +Flexibilität kann \Paket{siunitx} auch Pakete wie \Paket{unitsdef}, +\Paket{units}, \Paket{fancyunits} und \Paket{fancynum} ersetzen. +\begin{Ers} +\begin{verbatim} +\usepackage{SIunits} +\unit{1}{\metre} +\end{verbatim} +\end{Ers} +\begin{Dur} +\begin{verbatim} +\usepackage{siunitx} +\SI{1}{\metre} +\end{verbatim} +\end{Dur} + + +\subsubsection{\PakeH{subfigure} und \PakeH{subfig} vs. \PakeH{subcaption}} +\label{sec:subfigures} + +Die Pakete \Paket{subfigure} und \Paket{subfig} werden nicht mehr +weiterentwickelt und sind inkompatibel zu einigen aktuelleren Paketen wie +\Paket{hyperref}. Als Ersatz bei Kompatibilitätsproblemen empfiehlt sich +\Paket{subcaption}. +\begin{Ers} +\begin{verbatim} +\usepackage{subfig} +\begin{figure} +\subfloat[][Text]{Bild} +\end{figure} +\end{verbatim} +\end{Ers} +\begin{Dur} +\begin{verbatim} +\usepackage{caption} +\usepackage{subcaption} +\begin{figure} +\subcaptionbox{Text}{Bild} +\end{figure} +\end{verbatim} +\end{Dur} + +\subsubsection{\PakeH{csvtools} vs. \PakeH{datatool}} +\label{sec:datenbanken} + +Das Paket \Paket{csvtools} ist veraltet. Zugriffe auf CSV"=Tabellen +sollten mit dem Paket \Paket{datatool} erfolgen. + + +\subsection{Schriften} +\label{sec:schriften} + +Das Thema »Schriften und \LaTeX« ist ein Quell ewiger »Freude« in +\News{de.comp.text.tex}, meistens ausgelöst durch die Frage, warum +denn die Schrift im Acrobat~Reader so pixelig sei. Die häufigsten +\emph{falschen} Antworten auf diese Frage verweisen auf \Paket{times} +\bzw \Paket{pslatex}. Durch die Nutzung dieser Pakete werden nicht nur +gänzlich andere Schriften eingestellt, sondern auch --~da diese Pakete +veraltet sind~-- neue Probleme hervorgerufen. Wird wie im Abschnitt +\ref{sec:ae} empfohlen Latin Modern als (quasi) identisch aussehender +Ersatz für die »Standard"=\LaTeX"=Schrift« verwendet, kann das Problem +der pixeligen Darstellung der Schrift im AR nicht auftreten. + +Generelle Informationen zu \LaTeXe s New Font Selection Scheme (NFSS) +gibt der \Doku{fntguide}~\cite{fntguide:05}. + +\subsubsection{\PakeH{times}} +\label{sec:pakettimes} + +Das Paket \Paket{times} ist veraltet (siehe \Doku{psnfss2e} +\cite{psnfss:04}). Es stellt \Macro{rmdefault} auf die Schrift »Times«, +\Macro{sfdefault} auf »Helvetica« und \Macro{ttdefault} auf +»Courier« um, \emph{ohne} jedoch die passenden Mathematikschriften +einzubinden. Ferner wird die Helvetica nicht korrekt skaliert und +wirkt zu groß. Wenn man die Kombination Times/""Helvetica/""Courier +benutzten möchte, dann folgendermaßen: +\begin{Ers} + \verb|\usepackage{times}| +\end{Ers} +\begin{Dur} +\begin{verbatim} +\usepackage{mathptmx} +\usepackage[scaled=.92]{helvet} +\usepackage{courier} +\end{verbatim} +\end{Dur} + +\paragraph{Anmerkung} +\label{sec:anmerkung-1} + +Der Skalierungsfaktor für \Paket{helvet} in Kombination mit der Times +sollte zwischen $0.90$ und $0.92$ liegen. + +\subsubsection{\PakeH{mathptm}} +\label{sec:mathptm} + +Das Paket \Paket{mathptm} ist der Vorgänger von \Paket{mathptmx}. +\begin{Ers} + \verb+\usepackage{mathptm}+ +\end{Ers} +\begin{Dur} + \verb+\usepackage{mathptmx}+ +\end{Dur} + +\subsubsection{\PakeH{pslatex}} +\label{sec:paketpslatex} + +Das Paket \Paket{pslatex} arbeitet intern wie +\Paket{mathptm}$+$ \Paket{helvet} (skaliert), wobei allerdings eine zu +eng laufende Courier gewählt wird. Der Hauptnachteil von +\Paket{pslatex} ist, dass es \emph{nicht} mit T1- und TS1-Encoding +funktioniert. +\begin{Ers} + \verb+\usepackage{pslatex}+ +\end{Ers} +\begin{Dur} +\begin{verbatim} +\usepackage{mathptmx} +\usepackage[scaled=.92]{helvet} +\usepackage{courier} +\end{verbatim} +\end{Dur} + +\paragraph{Anmerkung zu allen Times/Helvetica-Kombinationen} +\label{sec:anmerkung-zu-allen} + +Man kann auch als Schreibmaschinenschrift bei der \texttt{cmtt} +bleiben, also auf das Laden von \Paket{courier} verzichten. + +\subsubsection{\PakeH{palatino}} +\label{sec:paketpalatino} + +Das Paket \Paket{palatino} verhält sich wie \Paket{times} (außer das +natürlich \Macro{rmdefault} auf »Palatino« gesetzt wird) und sollte +deshalb nicht mehr benutzt werden. +\begin{Ers} + \verb+\usepackage{palatino}+ +\end{Ers} +\begin{Dur} +\begin{verbatim} +\usepackage{mathpazo} +\usepackage[scaled=.95]{helvet} +\usepackage{courier} +\end{verbatim} +\end{Dur} + +\paragraph{Anmerkung} +\label{sec:anmerkung-2} +Der Skalierungsfaktor für \Paket{helvet} in Kombination mit der Schrift +Palatino sollte $0.95$ betragen. + +Die »Helvetica« ist \emph{nicht} die optimale serifenlose Schrift in +Kombination mit der »Palatino«, aber die oben genannte Ersetzung soll +sich so weit wie möglich am »alten« Paket orientieren. Ferner war die +»Helvetica« lange Zeit die passendste, \emph{freiverfügbare} serifenlose +Schrift zur »Palatino«. Mittlerweile stellt die »Vera/Bera Sans« eine -- +unserer Meinung nach -- bessere Alternative dar. + +Wer eine (auch ältere\footnote{Die Schriften, die mit älteren Versionen +von CorelDraw\textsuperscript{\textregistered} ausgeliefert werden, +enthalten noch kein Euro"=Zeichen!}) +CorelDraw\textsuperscript{\textregistered}-CD +besitzt, kann die »Palatino« auch sehr gut mit den Schriften +»Frutiger«\footnote{Bitstream »Humanist 777«, bfr} oder +»Optima«\footnote{Bitstream »Zapf Humanist«, bop} kombinieren. Walter +Schmidt hat auf seiner Homepage\footnote{Fonts für \TeX: + \url{http://cq131a.de/fonts.html}} die entsprechenden +\TeX-Anpassungen veröffentlicht. + +\subsubsection{\PakeH{mathpple}} +\label{sec:paketmathpple} + +Dieses Paket ist der Vorläufer von \Paket{mathpazo}. Ihm fehlen +einzelne Zeichen, die Schriften werden aus den Euler-Fonts genommen, +andere Zeichen passen nicht gut zu Palatino und die Zeichenabstände +sind zum Teil falsch. Genaueres siehe +\Doku{psnfss2e}~\cite{psnfss:04}. + +\begin{Ers} + \verb+\usepackage{mathpple}+ +\end{Ers} +\begin{Dur} + \verb+\usepackage{mathpazo}+ +\end{Dur} + +\subsubsection{\PakeH{utopia}} +\label{sec:paketutopia} + +Das Paket \Paket{utopia} sollte nicht mehr verwendet werden, da +sein Nachfolger \Paket{fourier} ein verbessertes Interface zur +Schriftart Utopia bietet. Genaueres siehe +\Doku{psnfss2e}~\cite{psnfss:04}. + +\begin{Ers} + \verb+\usepackage{utopia}+ +\end{Ers} +\begin{Dur} + \verb+\usepackage{fourier}+ +\end{Dur} + +\subsubsection{Aufrechte griechische Buchstaben} +\label{sec:aufr-griech-buchst} + +Die im folgenden rot markierten Passagen sind nicht veraltet im Sinne +von »man soll sie nicht mehr benutzen«, aber es gibt nun mit dem Paket +\Paket{upgreek} eine Vereinfachung der Eingabe. Hinweise zur Benutzung +bitte wie immer der Dokumentation \Doku{upgreek}~\cite{upgreek:03} +entnehmen. + +\minisec{Die \PakeH{pifont}-Tricks}\nopagebreak[4] +\begin{Ers} +\begin{verbatim} +\usepackage{pifont} +\newcommand{\uppi}{% + \Pisymbol{psy}{112}} + ... +\uppi +\end{verbatim} +beziehungsweise +\begin{verbatim} +\newcommand[1]{\upgreek}{% + \usefont{U}{psy}{m}{n}#1} + ... +\upgreek{p} +\end{verbatim} +\end{Ers} +\begin{Dur} +\begin{verbatim} +\usepackage{upgreek} + ... +$\uppi$ +\end{verbatim} +\end{Dur} + +\minisec{Der \PakeH{babel}-Trick} +\begin{Ers} +\begin{verbatim} +\usepackage[greek,...]{babel} +\newcommand{\upgreek}[1]{% + \foreignlanguage{greek}{#1}} + ... +\upgreek{p} +\end{verbatim} +\end{Ers} +\begin{Dur} +\begin{verbatim} +\usepackage{upgreek} + ... +$\uppi$ +\end{verbatim} +\end{Dur} +\subsubsection{\PakeH{euler} vs. \PakeH{eulervm}} +\label{sec:euler-vs-euler} +Das Paket \Paket{euler} sollte durch \Paket{eulervm} ersetzt werden, da +es Kompatibilitätsprobleme mit anderen Paketen ausräumt und einige +Detailverbesserungen enthält: +% +\begin{itemize} +\item \Macro{hbar} (\Macro{hslash} bei dieser Schrift) funktioniert nun sauber +\item Fette Mathematikschriften inklusive griechische Symbole sind möglich. +\end{itemize} +% +Genauere Informationen siehe \Doku{eulervm}~\cite{eulervm:05}. +\begin{Ers} + \verb+\usepackage{euler}+ +\end{Ers} +\begin{Dur} + \verb+\usepackage{eulervm}+ +\end{Dur} + +\subsubsection{\PakeH{ae}, \PakeH{aecompl} und \PakeH{zefonts}} +\label{sec:ae} +Die Pakete \Paket{ae} (zusammen mit \Paket{aecompl}) und \Paket{zefonts} +dienten als Notbehelf für ein +Problem im Zusammenhang mit Umlauten und anderen akzentuierten Buchstaben +bei Verwendung der \LaTeX"=Standardschrift Computer Modern (CM). Da diese in +der sogenannten OT1"=Kodierung vorliegt und somit akzentuierte Buchstaben +durch zwei Zeichen dargestellt werden müssen (etwa »ü« als Kombination von »u« +und »\"\ \kern-0.3em«), wird bei diesen Buchstaben der Trennalgorithmus von +\LaTeX{} durcheinandergebracht, was dazu führt, dass beispielsweise Wörter mit +Umlauten nicht getrennt werden können. Dieses Problem beheben \Paket{ae} +und \Paket{zefonts} durch die Verwendung sogenannter virtueller Fonts. + +Ein weiteres Problem in diesem Zusammenhang wird durch die genannten +Pakete jedoch nicht behoben: Wird eine PDF"=Datei erzeugt, stehen +in dieser immer noch die aus zwei Zeichen zusammengesetzten Buchstaben, +was zur Folge hat, dass Wörter mit Umlauten beim Suchen oder +Kopieren aus dem Dokument nicht korrekt behandelt werden. + +Die hier beschriebenen Probleme treten nicht auf, wenn eine Schrift +in T1"=Kodierung und Type"=1"=Format verwendet +wird.\footnote{Man beachte, dass T1 und Type 1 trotz der ähnlichen Bezeichnung +nicht dasselbe bedeuten: T1 beschreibt die Kodierung der Schrift auf der +\LaTeX"=Seite, während Type 1 eine Aussage darüber macht, wie die Buchstaben +in der PDF"=Datei repräsentiert sind. Somit behebt die Verwendung einer +Schrift in T1"=Kodierung das Problem mit der Trennung von Wörtern mit Umlauten, +aber nicht notwendigerweise das Problem mit dem Suchen von Umlauten in einer +PDF"=Datei.} Dazu wurden in letzter Zeit die Schriftfamilien cm-super und +Latin Modern entworfen. Da Letztere sich stärker an der originalen Computer +Modern orientiert, wird empfohlen, die CM durch Latin Modern zu +ersetzen. +\begin{Ers} +\begin{verbatim} +\usepackage{ae} +\end{verbatim} +beziehungsweise +\begin{verbatim} +\usepackage{zefonts} +\end{verbatim} +\end{Ers} +\begin{Dur} +\begin{verbatim} +\usepackage[T1]{fontenc} +\usepackage{lmodern} +\end{verbatim} +\end{Dur} + +%-------------------- Abschnitt "Verschiedenes" --------------------- +\clearpage +\section{Verschiedenes} +\label{sec:verschiedenes} + +Dieser Abschnitt enthält -- mit Ausnahme von \vref{sec:der-anhang} -- +eher allgemeine Tipps und Hinweise als »Sünden«. +\subsection{Gleitumgebungen -- »figure«, »table«} +\label{sec:gleit-figure-table} + +Um den Inhalt einer Gleitumgebung zu zentrieren, sollte man +\Macro{centering} an Stelle der \verb+center+-Umgebung +verwenden, da diese zusätzlichen vertikalen Abstand einfügt, der +meistens nicht erwünscht ist. +\begin{Ers} +\begin{verbatim} +\begin{figure} + \begin{center} + \includegraphics{bild} + \end{center} +\end{figure} +\end{verbatim} +\end{Ers} +\begin{Dur} +\begin{verbatim} +\begin{figure} + \centering + \includegraphics{bild} +\end{figure} +\end{verbatim} +\end{Dur} + +\paragraph{Anmerkung} +\label{sec:anmerkung-4} + +Wenn man innerhalb des Fließtextes oder der \verb+titlepage+-Umgebung +einen Bereich zentrieren möchte, kann dieser zusätzliche Abstand +natürlich durchaus erwünscht sein. + +\subsection{Der Anhang} +\label{sec:der-anhang} + +Der Anhang wird mit dem \emph{Schalter} \Macro{appendix} eingeleitet. +Er ist \emph{keine} Umgebung. +\begin{Ers} +\begin{verbatim} +\begin{appendix} +\section{Blub} +\end{appendix} +\end{verbatim} +\end{Ers} +\begin{Dur} +\begin{verbatim} +\appendix +\section{Blub} +\end{verbatim} +\end{Dur} +\subsection{Mathematiksatz} +\label{sec:mathematiksatz} + +Generell sollte man für komplizierteren Mathematiksatz \Paket{amsmath}, +gegebenenfalls ergänzt durch \Paket{mathtools}, +benutzen. Es bietet neue Umgebungen, die vor allem \verb+eqnarray+ +ersetzen sollen. Die Vorteile des Paketes: +\begin{itemize} +\item Abstände innerhalb und außerhalb von Umgebungen sind + konsistenter. +\item Gleichungsnummern werden so positioniert, dass sie nicht mehr + überdruckt werden. +\item Die neuen Umgebungen (\zB \texttt{split}) ermöglichen es, + lange Gleichungen einfacher zu umbrechen. +\item Einfache Möglichkeit, neue Operatoren (ähnlich wie \Macro{sin} + usw.) mit sauberen Zeichenabständen zu definieren. +\end{itemize} + + +\paragraph{Warnung} +\label{sec:warnung} + +Bei der Verwendung des Paketes~\Paket{amsmath} sollte man die Umgebungen +\texttt{displaymath}, \texttt{eqnarray} und \texttt{eqnarray*} +\emph{keinesfalls} weiterverwenden, da diese von \Paket{amsmath} nicht +unterstützt werden %Die Folge wäre wieder inkonsistente Abstände. +und deshalb wieder inkonsistente Abstände ergäben (siehe die +Abbildungen~\vrefrange{fig:beisp-fur-texttt}{fig:beisp-fur-texttt-1}). + +Die \verb+\[...\]+-Umgebung wird von \Paket{amsmath} +korrekt angepasst und kann an Stelle von \texttt{displaymath} genutzt +werden. \texttt{eqnarray} und \texttt{eqnarray*} kann in erster +Näherung durch \texttt{align} \bzw \texttt{align*} ersetzt werden. Für +eine vollständige Übersicht der Möglichkeiten von \Paket{amsmath} +sei auf die Dokumentation \Doku{amsldoc}~\cite{amsldoc:99} verwiesen. +\begin{Ers} +\begin{verbatim} +\begin{eqnarray} + a &=& b\\ + b &=& c\\ + a &=& c +\end{eqnarray} +\end{verbatim} +\end{Ers} +\begin{Dur} +\begin{verbatim} +\begin{align} + a &= b\\ + b &= c\\ + a &= c +\end{align} +\end{verbatim} +\end{Dur} +\begin{figure} + \centering + \begin{minipage}[t]{.45\linewidth} + \begin{eqnarray*} + a &=& b\\ + b &=& c\\ + a &=& c + \end{eqnarray*} + \caption{Beispiel für \texttt{eqnarry*}} + \label{fig:beisp-fur-texttt} + \end{minipage}\hfill + \begin{minipage}[t]{.45\linewidth} + \begin{align*} + a &= b\\ + b &= c\\ + a &= c + \end{align*} + \caption{Beispiel für \texttt{align*}} + \label{fig:beisp-fur-texttt-1} + \end{minipage} +\end{figure} + +\subsection{Die Verwendung von \texttt{\TB graphicspath}} +\label{sec:die-verwendung-von} + +An dieser Stelle wurde in früheren Versionen dieses Dokuments empfohlen, +das Macro~\Macro{graphicspath} nicht zu verwenden und stattdessen mit der +Umgebungsvariable \texttt{TEXINPUTS} zu arbeiten. Die Gründe gegen +\Macro{graphicspath} (Speicherbedarf, Platt\-form\-abhängigkeit) wurden +inzwischen weitgehend ausgeräumt, so dass von seiner Verwendung nicht +mehr grundsätzlich abgeraten werden muss.\footnote{Die Vor- und Nachteile +von \Macro{graphicspath} im Vergleich zu \texttt{TEXINPUTS} wurden in +\News{de.comp.text.tex} etwa in den Diskussionen beginnend mit +\MID{9o2balFu3aU1@mid.dfncis.de}{9o2balFu3aU1@mid.dfncis.de} und +\MID{abgd0vF62j1U1@mid.dfncis.de}{abgd0vF62j1U1@mid.dfncis.de} +diskutiert.} Man beachte aber die korrekte Syntax für Einträge von +\Macro{graphicspath}. Für Portabilität benutze man »\texttt{/}« als +Pfadtrenner und verzichte auf absolute Pfadangaben. + +\subsection{Die \texttt{\TB...name}-Makros} +\label{sec:die-macroname-makros} + +Da in \News{de.comp.text.tex} von Zeit zu Zeit danach gefragt wird, +wie man \zB »Literatur« in »Quellenverzeichnis« ändern +kann, sind in Tabelle~\vref{tab:von-paketng-btw} die +entsprechenden Makros zusammengestellt. Sie sind aus \Paket{german} +entnommen. + +Um beispielsweise das »Abbildungsverzeichnis« in +»Abbildungen« umzubennen, +benutzt man folgenden Befehl: +\begin{verbatim} +\renewcommand*{\listfigurename}{Abbildungen} +\end{verbatim} +Die anderen Makros lassen sich analog umbenennen. Bei der Verwendung +von \Paket{babel} muss man mit \Macro{addto} arbeiten. Siehe auch die +\Doku{De-TeX-FAQ} zu diesem +Thema\footnote{»Meine Versuche, \Macro{figurename}, \Macro{tablename} o.\,ä. bei Verwendung des Pakets \Paket{babel} umzudefinieren, mißlingen. Was kann ich tun?« in \url{http://projekte.dante.de/DanteFAQ/Verschiedenes}}. + +\begin{verbatim} +\addto{\captionsngerman}{% + \renewcommand*{\listfigurename}{Abbildungen}} +\end{verbatim} +Bei der Verwendung von \KOMAScript{} empfiehlt es sich, den dort +bereitgestellten Befehl \Macro{renewcaptionname} zu benutzen: + +\begin{verbatim} +\renewcaptionname{ngerman}{\listfigurename}{Abbildungen} +\end{verbatim} +(Dieser Befehl muss nach \verb|\begin{document}| ausgeführt werden.) + +\begin{table} + \begin{minipage}{\textwidth} + \renewcommand{\footnoterule}{} + \centering + \caption{Von \Paket{(n)german} \bzw \Paket{babel} mit der Option + \Option{(n)german} definierte Makros} + \label{tab:von-paketng-btw} + \begin{tabular}{@{}lll@{}} + \toprule + \multicolumn{1}{@{}N}{Makroname} & + \multicolumn{1}{N}{Original Definition} & + \multicolumn{1}{N@{}}{deutsche Ausgabe} \\ + \cmidrule(r){1-1}\cmidrule(lr){2-2}\cmidrule(l){3-3} + \Macro{prefacename} & Preface & Vorwort \\ + \Macro{refname}\footnote{Nur in den \texttt{article}-Klassen} + & References & Literatur \\ + \Macro{abstractname} & Abstract & Zusammenfassung \\ + \Macro{bibname}\footnote{Nur in den \texttt{report}- und + \texttt{book}-Klassen} + & Bibliography & Literaturverzeichnis \\ + \Macro{chaptername} & Chapter & Kapitel \\ + \Macro{appendixname} & Appendix & Anhang \\ + \Macro{contentsname} & Contents & Inhaltsverzeichnis \\ + \Macro{listfigurename} & List of Figures & Abbildungsverzeichnis \\ + \Macro{listtablename} & List of Tables & Tabellenverzeichnis \\ + \Macro{indexname} & Index & Index \\ + \Macro{figurename} & Figure & Abbildung \\ + \Macro{tablename} & Table & Tabelle \\ + \Macro{partname} & Part & Teil \\ + \Macro{enclname} & encl & Anlage(n) \\ + \Macro{ccname} & cc & Verteiler \\ + \Macro{headtoname} & To & An \\ + \Macro{pagename} & Page & Seite \\ + \Macro{seename} & see & siehe \\ + \Macro{alsoname} & see also & siehe auch \\ + \bottomrule + \end{tabular} + \end{minipage} +\end{table} + +% \subsection{Welche Grafikformate für welches \LaTeX?} +% \label{sec:welche-graf-fur} +% Dieser Unterabschnitt gehört -- streng gennommen -- hier auch nicht +% hinein, aber da ich +% \begin{enumerate} +% \item die ein oder andere Mail mit der Bitte um Aufnahme erhalten habe +% und +% \item diese Frage in \News{de.comp.text.tex} ebenfalls recht häufig +% auftaucht beziehungsweise +% \item immer mal wieder die falschen Grafikformate benutzt werden, +% \end{enumerate} +% habe ich mich entschlossen hier eine kleine Übersicht aufzunehmen. + +% \subsubsection{Generelles zu Grafikformaten} +% \label{sec:generelles-1} + +% Zurerst muss man sich im Klaren sein, um was für einen Typ von Grafik es +% sich überhaupt handelt. + + +% \paragraph{Vektorgrafiken} +% \label{sec:vektorgrafiken} + +% Selbsterstellte Zeichnungen, Diagramme oder Plots sollten im Allgemeinen +% als \emph{Vektorgrafik} vorliegen/erzeugt werden und auch als solche +% eingebunden werden. + +% Fotos + +\clearpage +\appendix + +\section{Beispiel zu \texttt{\TB sloppy}} +\label{sec:beispiel-zu-sloppy} +Hier ist der Beispiel-Code, welchen Markus Kohm veröffentlicht hat: +\begin{bspcode}{\MID{8557097.gEimXdBtjU@ID-107054.user.dfncis.de}{8557097.gEimXdBtjU@ID-107054.user.dfncis.de}}% +\small +\begin{verbatim} +\documentclass{article} + +\setlength{\textwidth}{20em} +\setlength{\parindent}{0pt} +\begin{document} +\typeout{First without \string\sloppy\space and underfull \string\hbox} + +tatata tatata tatata tatata tatata tatata ta\-ta\-tata +tatata tatata tatata tatata tatata tatata tata\-tata +tatata tatata tatata tatata ta\-tatatatt\-ta +tatata tatata tatata tatata tatata tatata ta\-ta\-ta\-ta + +\typeout{done.} + +\sloppy +\typeout{Second with \string\sloppy\space and underfull \string\hbox} + +tatata tatata tatata tatata tatata tatata ta\-ta\-tata +tatata tatata tatata tatata tatata tatata tata\-tata +tatata tatata tatata tatata ta\-tatatatt\-ta +tatata tatata tatata tatata tatata tatata ta\-ta\-ta\-ta + +\typeout{done.} +\end{document} +\end{verbatim} +\end{bspcode} + +\clearpage +\raggedright +\begin{thebibliography}{99} +\bibitem{amsldoc:99} \textsc{American Mathematical Society}: + \emph{User's Guide for the {\texttt{amsmath}} Package}. Dezember 1999, + Version~2.0. \biburl{CTAN://macros/latex/required/amslatex/}. + +\bibitem{graphicx:05} \textsc{David~P. Carlisle}: \emph{Packages in the + `graphics' bundle}. November 2005. + \biburl{CTAN://macros/latex/required/graphics/}. + +\bibitem{kohm:10} \textsc{Markus Kohm} und \textsc{Jens-Uwe Morawski}: + \emph{\KOMAScript}. Juni 2010, Version~3.06. + \biburl{CTAN://macros/latex/supported/koma-script/}. + +\bibitem{clsguide:06} \textsc{The \LaTeX3 Project Team}: \emph{\LaTeXe{} for + class and package writers}. Februar 2006. + \biburl{CTAN://macros/latex/doc/clsguide.pdf} + +\bibitem{fntguide:05} \textsc{The \LaTeX3 Project Team}: \emph{\LaTeXe{} font + selection}. November 2005. + \biburl{CTAN://macros/latex/doc/fntguide.pdf} + +\bibitem{usrguide:05} \textsc{The \LaTeX3 Project Team}: \emph{\LaTeXe{} for + authors}. November 2005. + \biburl{CTAN://macros/latex/doc/usrguide.pdf} + +%\bibitem{faq:03} \textsc{Bernd Raichle}, \textsc{Rolf Niepraschk} und +% \textsc{Thomas Hafner}: \emph{Fragen und Antworten (FAQ) über das +% Textsatzsystem {\TeX\ }und DANTE, Deutschsprachige +% Anwendervereinigung {\TeX\ }e.V.} WWW, September 2003, Version~72. +% \biburl{http://www.dante.de/faq/de-tex-faq/}. + +\bibitem{eulervm:05} \textsc{Walter Schmidt}: \emph{The Euler Virtual Math + Fonts for use with {\LaTeX}}. Januar 2005, Version~4.0. + \biburl{CTAN://fonts/eulervm/} + +\bibitem{upgreek:03} \textsc{Walter Schmidt}: \emph{The + {\textsf{upgreek}} package for {\LaTeXe}}. Februar 2003, Version~2.0. + \biburl{CTAN://macros/latex/contrib/was/}. + +\bibitem{psnfss:04} \textsc{Walter Schmidt}: \emph{Using common + PostScript fonts with {\LaTeX}}. September 2004, PSNFSS Version~9.2. + \biburl{CTAN://macros/latex/required/psnfss/psnfss2e.pdf} + +\bibitem{l2kurz:03} \textsc{Walter Schmidt}, \textsc{Jörg Knappen}, + \textsc{Hubert Partl} und \textsc{Irene Hyna}: + \emph{{\LaTeXe}-Kurzbeschreibung}. April 2003, Version~2.3. + \biburl{CTAN://info/lshort/german/}. + +\bibitem{caption:08} \textsc{Axel Sommerfeld}: + \emph{Anpassen der Abbildungs- und Tabellenbeschriftungen mit Hilfe des + caption-Pakets}. April 2008. + \biburl{CTAN://macros/latex/contrib/caption/}. + +\bibitem{glossaries:11} \textsc{Nicola~L.\,C. Talbot}, + \emph{Upgrading from the glossary package to the glossaries package}. + April 2011. + \biburl{CTAN://macros/latex/contrib/glossaries/glossary2glossaries.pdf}. +\end{thebibliography} +\end{document} + +%%% Local variables: +%%% coding: iso-8859-1 +%%% mode: LaTeX +%%% TeX-master: t +%%% End: +%%% Local variables: diff --git a/info/l2tabu/italian/l2tabuit.pdf b/info/l2tabu/italian/l2tabuit.pdf Binary files differnew file mode 100644 index 0000000000..3de495233c --- /dev/null +++ b/info/l2tabu/italian/l2tabuit.pdf diff --git a/info/l2tabu/italian/l2tabuit.tex b/info/l2tabu/italian/l2tabuit.tex new file mode 100644 index 0000000000..5917d6f23f --- /dev/null +++ b/info/l2tabu/italian/l2tabuit.tex @@ -0,0 +1,1800 @@ +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%%% Filename: l2tabuit.tex %%% +%%% Author: Marc Ensenbach <Marc.Ensenbach@post.rwth-aachen.de> %%% +%%% Orig. Author: Mark Trettin <Mark.Trettin@gmx.de> %%% +%%% Created: 07 Mär 2005 13:36:50 %%% +%%% Last Modif.: 20 Sep 2011 %%% +%%% Version: 2.3 %%% +%%% %%% +%%% Copyright (C) 2005 by Mark Trettin %%% +%%% Copyright (C) 2010 by Marc Ensenbach %%% +%%% %%% +%%% Italian translation by Mauro Sacchetto <mauro.sacchetto@gmail.com> %%% +%%% Created : January, 26th 2012 %%% +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + +\documentclass[fontsize=11pt,paper=a4,pagesize,captions=tableheading,% +numbers=noenddot,toc=flat]{scrartcl} + +% -------------------------------- Codifica ---------------------------------- +\usepackage[T1]{fontenc} +\usepackage{textcomp} +\usepackage[latin1]{inputenc} +\usepackage[italian]{babel} +\usepackage[babel]{csquotes} +\MakeAutoQuote{«}{»} + +% -------------------------------- Caratteri --------------------------------- +\usepackage[scaled=.88]{beramono} +\usepackage[scaled=.86]{berasans} +\usepackage[osf]{mathpazo} +\linespread{1.05}\selectfont +\providecommand{\lining}{\fontfamily{ppl}\selectfont} +\providecommand{\oldstyle}{\fontfamily{fplj}\selectfont} +\DeclareTextFontCommand{\textln}{\lining} +\DeclareTextFontCommand{\textos}{\oldstyle} + +% ------------------------------ Grafica e tabelle --------------------------- +\usepackage{xspace} +\usepackage{booktabs,array} +\usepackage[italian]{varioref} +\usepackage[nofancy]{rcsinfo} +\usepackage{varwidth} +\usepackage{calc} +\usepackage{amsmath} +\usepackage{graphicx} +\usepackage{alltt} +\usepackage{guit} + +% ------------------------------- Formattazione ------------------------------ +\addtokomafont{pagehead}{\small\itshape} +\addtokomafont{sectioning}{\rmfamily} +\addtokomafont{caption}{\footnotesize\itshape} +\addtokomafont{captionlabel}{\upshape\bfseries} +\addtokomafont{descriptionlabel}{\rmfamily} +\setcapindent{1em} +\deffootnote{2.25em}{1.75em}{\thefootnotemark\enspace} +\reversemarginpar +\renewcommand*{\othersectionlevelsformat}[1]{% + \makebox[0pt][r]{\csname the#1\endcsname\autodot\enskip}} + +% --------------------------------- Colori ----------------------------------- +\usepackage{color} +\definecolor{grau}{gray}{0.45} +\definecolor{rot}{rgb}{0.75,0.00,0.00} +\definecolor{blau}{rgb}{0.16,0.24,0.64} +\definecolor{gruen}{rgb}{0.18,0.58,0.08} +\definecolor{linkcolor}{rgb}{0,0,0.42} + +% ---------------------------------- Nuovi comandi --------------------------- +%%% scrguide +\DeclareRobustCommand*{\Macro}[1]{\mbox{\texttt{\char`\\#1}}} +\DeclareRobustCommand*{\LMacro}[2]{\mbox{\texttt{\char`\\#1\{#2\}}}} +\DeclareRobustCommand*{\GMacro}[2]{\mbox{\texttt{\{\char`\\#1\ #2\}}}} +%%% DANTE +\providecommand{\CTANserver}{ftp.dante.de} +%%% Alias CTAN:// per ftp://\CTANserver/tex-archive/ +\makeatletter +\def\url@#1{\expandafter\url@@#1\@nil} +\def\url@@#1://#2\@nil{% + \def\@tempa{#1}\def\@tempb{CTAN}\ifx\@tempa\@tempb + \hyper@linkurl{\Hurl{#1:#2}}{ftp://\CTANserver/tex-archive/#2}% + \else + \hyper@linkurl{\Hurl{#1://#2}}{#1://#2}% + \fi +} +\makeatother +%%% Logo XeLaTeX +\newcommand{\XeLaTeX}{\smash{X\kern-.1em\lower.5ex\hbox{\reflectbox{E}}\kern-.07em\LaTeX}} +%%% URL +\newcommand{\biburl}[1]{\hfill\\URL:~\url{#1}} +\newcommand{\acr}[1]{\textsc{\textls{#1}}} +\newcommand{\texdoc}[1]{consultabile con \texttt{texdoc~#1}} +%%% Comandi +\newcommand{\Doku}[1]{\textsf{#1}\xspace} +\newcommand{\Paket}[1]{\textsf{#1}\xspace} +\newcommand{\PakeH}[1]{#1\xspace} +\newcommand{\Klasse}[1]{\textsf{#1.cls}\xspace} +\newcommand{\KlassH}[1]{#1.cls\xspace} +\newcommand{\Bst}[1]{\textsf{#1.bst}\xspace} +\newcommand{\BstH}[1]{#1.bst\xspace} +\newcommand{\Option}[1]{\textsf{#1}\xspace} +\newcommand{\TB}{\textbackslash} +\newcommand{\schlecht}[1][!]{\marginline{\texttt{#1}}} + +%%% Ambiente "NON ... MA" +\newenvironment{Ers}[1][\linewidth]{% + \par\smallskip\noindent\textcolor{rot}{\textbf{\textsf{NON:}}\marginline{$ + \triangleright$}}~\rahmenpr[#1]}% +{\endrahmenpr\hfill} +\newenvironment{Dur}[1][\linewidth]{% +\noindent\textcolor{gruen}{\textbf{\textsf{MA:}}}~\rahmenpg[#1]}% +{\endrahmenpg\noindent} + +% Ambiente "Schecht" +\newenvironment{Schlecht}[1][\linewidth]{% + \par\smallskip\rahmenpr[#1]}% +{\endrahmenpr\par\noindent} + +% Ambienti "rahmenlength" e "rahmenpg" +\newsavebox{\rahmenbox} +\setlength{\fboxrule}{0.6pt} +\newlength{\rahmenlength} +\newenvironment{rahmenpr}[1][\linewidth]{% + \setlength{\rahmenlength}{#1-2\fboxsep-2\fboxrule}% + \begin{lrbox}{\rahmenbox}\begin{varwidth}[t]{\rahmenlength}} + {\end{varwidth}\end{lrbox}\noindent\fcolorbox{rot}{white}{\usebox{\rahmenbox}}\vspace*{.5ex}} +\newenvironment{rahmenpg}[1][\linewidth]{% + \setlength{\rahmenlength}{#1-2\fboxsep-2\fboxrule}% + \begin{lrbox}{\rahmenbox}\begin{varwidth}[t]{\rahmenlength}} + {\end{varwidth}\end{lrbox}\noindent\fcolorbox{gruen}{white}{\usebox{\rahmenbox}}\vspace*{.5ex}} + +% Ambiente "description" +\newenvironment{description*}{% + \description% + \setlength{\itemsep}{0pt}}% + {\enddescription} +\newsavebox{\Fonte} + +%%% Ambiente "esempi" +\newenvironment{bspcode}[1]{% + \sbox{\Fonte}{\footnotesize Fonte: #1} + \center + \rule{\linewidth}{1.5pt} +}{% + \rule{\linewidth}{1.5pt} + \usebox{\Fonte} + \endcenter% +} +\newcolumntype{N}{>{\footnotesize}l} + +%%% Ambiente "tabpar" +\makeatletter +\newsavebox{\@tabparbox} +\newenvironment{tabpar}[3][t] + {\long\def\@tabparagraph{#3}\def\@tabparopt{#1}% + \begin{lrbox}{\@tabparbox} + \begin{tabular}{#2}} + {\end{tabular}\end{lrbox}% + \parbox{\wd\@tabparbox}{ + \if t\@tabparopt + \@tabparagraph\par\smallskip + \fi + \usebox{\@tabparbox}\par + \if b\@tabparopt + \smallskip\@tabparagraph + \fi}} +\makeatother + +% -------------------------------- Opzioni PDF ------------------------------- +\ifpdfoutput{ + \usepackage{hyperref} + \hypersetup{% + pdfauthor={(c) 2003, 2004, 2005, 2006, 2007 Mark Trettin, 2009, 2010,% + 2011 Marc Ensenbach},% + pdftitle={Elenco dei peccati degli utenti di \LaTeXe, ovvero Comandi e% + pacchetti obsoleti e altri errori},% + pdfsubject={Trucchi per LaTeX2e},% + bookmarksopen=true,% + backref=true, + linktocpage=true, + urlcolor=linkcolor, + citecolor=linkcolor, + linkcolor=linkcolor, + colorlinks=true, + } + \usepackage{microtype} + \SetExpansion[context=slbsp, factor=0]{encoding={OT1, T1, TS1}}{} + \newcommand{\EMail}[1]{\href{mailto:#1?Subject=[l2tabu.pdf]}{e-mail: +\texttt{#1}}} + \newcommand{\News}[1]{\href{news:#1}{\texttt{#1}}} + \newcommand{\MID}[2]{\href{http://groups.google.com/groups?as_umsgid=#1}% + {Message-ID: \texttt{<#2>}}} +%%% \dots +%%% \dots +\pdfstringdefDisableCommands{% + \edef\dots{\string...}% +} + +% ----------------------------------- Opzioni PS ----------------------------- +}{ + \usepackage{hyperref} + \newcommand{\EMail}[1]{\href{mailto:#1}{E-Mail: \texttt{#1}}} + \newcommand{\News}[1]{\href{news:#1}{\texttt{#1}}} + \newcommand{\MID}[2]{<#1>}{Message-ID: \texttt{<#2>}} +} + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + +% ---------------------------- Inizio del documento -------------------------- +\begin{document} +\pagestyle{headings} +\rcsInfo $Id: l2tabu.tex,v 2.3 2011/09/20 10:18:00 marc Exp marc $ + +% -------------------------------- Frontespizio ------------------------------ +\begin{titlepage} +\pdfbookmark[1]{Frontespizio}{tit} + \raggedright + \noindent + \rule{\linewidth}{1pt}% + \vspace{2\baselineskip} + {\LARGE\bfseries + Elenco del peccati degli utenti di \LaTeXe\\[1ex] + \large + ovvero Comandi e pacchetti obsoleti e altri errori}\\ + \vspace{2\baselineskip} + \noindent + \rule{\linewidth}{1pt}% + \vspace{\baselineskip} + \raggedleft + \textit{Marc Ensenbach, Mark Trettin}\\ + \EMail{Marc.Ensenbach@post.rwth-aachen.de}\\[1.5\baselineskip] + Versione \rcsInfoRevision\ del \rcsInfoLongDate\\[1.5\baselineskip] + \footnotesize Traduzione italiana dall'originale\\tedesco di Mauro Sacchetto\\ + \EMail{mauro.sacchetto@gmail.com}\\[2\baselineskip] + \vspace{\baselineskip} + \begin{center} + \let\footnoterule\relax + \begin{minipage}{.9\linewidth} + \small + \begin{center} + \textbf{Sommario} + \end{center} + \noindent + {\em Questa è la traduzione italiana di «l2tabu». + \medskip + + Essa corrisponde in larga misura al più recente originale tedesco e se + ne discosta significativamente, a parte modifiche e aggiunte minori, + solo per la sezione \vref{sec:die-verwendung-von}, che è stata + completamente riscritta. Le parti modificate sono indicate in nota, + dietro esplicita richiesta dell'autore. Il traduttore, che si è valso + dei rilievi mossi a questo proposito dai membri del \GuIT, desidera qui + ringraziare in particolar modo Claudio Beccari e Tommaso Gordini. Un + riconoscimento finale va all'autore, Marc Ensenbach, che ha letto con + accuratezza questa versione italiana fornendo ulteriori rilievi. + [N.\,d.\,T.]} + \medskip + + Lo stimolo per scrivere questo breve sommario è sorto da una discussione + nel \TeX-Newsgroup di lingua tedesca\footnote{\News{de.comp.text.tex}} + sul perdurante ricorso a pacchetti e comandi obsoleti e \enquote{superati}. + \medskip + + In questo articolo cerchiamo di indicare gli errori più comuni e + soluzioni alternative. Questo compendio non intende rimpiazzare né guide + introduttive come \Doku{l2kurz}~\cite{l2kurz:03} né le + \Doku{De-TeX-FAQ}\footnote{\url{http://projekte.dante.de/DanteFAQ/WebHome}}, + ma semplicemente offrire un breve sommario. + \medskip + + Saremo grati per ogni suggerimento, miglioria e commento. + \end{minipage} + \end{center} + \vfill +\end{titlepage} +% ----------------------------- Fine Frontespizio ---------------------------- + +% ----------------------------- Inizio Copyright ---------------------------- +\clearpage + +\noindent +Copyright \copyright{} 2003--2007 by Mark Trettin, 2009--2011 by Marc Ensenbach. +\medskip + +\noindent +This material may be distributed only subject to the terms and +conditions set forth in the \emph{Open Publication License}, v1.0 or +later (the latest version is presently available at +\url{http://www.opencontent.org/openpub/}). +\medskip + +\noindent +Le denominazioni software e hardware presenti in questo articolo sono, nella +maggior parte dei casi, anche marchi registrati e perciò soggette come tali +alle normative vigenti. +\vfill + +\noindent +Ringraziamo +Ralf Angeli, +Christoph Bier, +Christian Faulhammer, +Jürgen Fenn\footnote{Traduzione inglese: \url{CTAN://info/l2tabu/english/l2tabuen.pdf}}, +Ulrike Fischer, +Ralf Heckmann, +Yvon Henel\footnote{Traduzione francese: \url{CTAN://info/l2tabu/french/l2tabufr.pdf}}, +Yvonne Hoffmüller, +David Kastrup, +Markus Kohm, +Thomas Lotze, +Gonzalo Medina Arellano\footnote{Traduzione spagnola: \url{CTAN://info/l2tabu/spanish/l2tabues.pdf}}, +Frank Mittelbach, +Heiko Oberdiek, +Mauro Sacchetto\footnote{Traduzione italiana: \url{CTAN://info/l2tabu/italian/l2tabuit.pdf}}, +Walter Schmidt, +Uwe Siart, +Stefan Stoll, +Knut Wenzig, +Emanuele Zannarini\footnote{Traduttore della prima versione italiana, 2005}, +e Reinhard Zierke +per i trucchi, le osservazioni e le correzioni. Chi fosse stato dimenticato ci +spedisca una mail. +% -------------------------------- Fine Copyright ---------------------------- + +\clearpage +\enlargethispage{2\baselineskip} +\phantomsection +\pdfbookmark[1]{Indice}{toc} +\tableofcontents + +% ---------------------- Sezione 1: "Peccati mortali" ------------------------ +\clearpage +\section{\enquote{Peccati mortali}} +\label{sec:todsunden} +In questa sezione abbiamo raccolto i peggiori errori che si incontrano con +allarmante frequenza in \News{de.comp.text.tex} e che fanno arrossire di +rabbia gli esperti di quel newsgroup o che fanno venir loro le lacrime agli +occhi \texttt{;-)} + +\subsection{\PakeH{a4}, e \PakeH{a4wide}} +\label{sec:paketa4-paketa4wide} +Questi pacchetti, \emph{tutti e due}, non dovrebbero essere più usati e vanno +definitivamente eliminati dai sorgenti di \LaTeX. Devono essere sostituiti +dall'opzione di classe \Option{a4paper} per le classi standard o dall'analoga +opzione \Option{paper=a4} per \KOMAScript{} a partire dalla versione 3. Va +considerato che il layout prodotto da questi due pacchetti è più che +discutibile da un punto di vista tipografico e che ne esistono varie versioni, +incompatibili l'una con l'altra. Perciò non si può mai essere sicuri che, +compilato in un altro sistema, il documento risulti uguale. + +\subsection{Modifiche del layout} +\label{sec:layoutanderungen} +I margini di pagina impostati dalle classi standard (\Klasse{article}, +\Klasse{report}, \Klasse{book}) appaiono di solito troppo ampi. Se non +soddisfano, si può ricorrere alle corrispondenti classi (\Klasse{scrartcl}, +\Klasse{scrreprt}, \Klasse{scrbook}) del pacchetto \KOMAScript{} oppure al +pacchetto \Paket{typearea}, contenuto nella collezione di \KOMAScript. La +relativa documentazione \Doku{scrguide}~\cite{kohm:10} contiene molte altre +informazioni. + +Se davvero si avesse bisogno di margini di pagina diversi da quelli impostati +ad esempio da \Paket{typearea}, si dovrebbe ricorrere al pacchetto +\Paket{geometry} e non produrre modifiche \enquote{fatte a mano} con +\Macro{oddsidemargin} \& C. Il pacchetto \Paket{anysize} è obsoleto e il +pacchetto \Paket{vmargin}, qui un tempo raccomandato, dovrebbe allo stesso +modo essere evitato, poiché può produrre effetti collaterali +indesiderati\footnote{Cfr. anche +\MID{uirrzdr16.fsf@uwe-siart.de}{uirrzdr16.fsf@uwe-siart.de}}. + +Infine, non vanno mai modificate le impostazioni regolate da \Macro{hoffset} +e da \Macro{voffset}, a meno che non si conosca molto bene il funzionamento +interno di \TeX. + +\subsection{Modifiche di pacchetti e classi} +\label{sec:ander-von-paket} +Non si devono mai modificare direttamente le classi di documento +(\Klasse{article}, \Klasse{scrbook} ecc.) oppure i file di stile +(\Paket{varioref}, \Paket{color})! O si è in grado di costruirsi una classe +propria basata su classi preesistenti o file di stile, oppure è meglio +\emph{copiare} classi e stili, modificare le copie e salvarle con un +\emph{altro} nome. + +Un esempio su come costruire classi basate su classi preesistenti si trova +nelle \Doku{FAQ} sulla personalizzazione delle classi di +documento\footnote{\url{http://projekte.dante.de/DanteFAQ/Dokumentenklasse}}. + +\paragraph{Suggerimento} +\label{sec:hinweis} +In generale, tali classi e pacchetti aggiuntivi dovrebbero essere installati +o nell'albero locale o nell'albero personale (presente nella \texttt{\$HOME} +degli utenti dei sistemi Unix) di \TeX{}, perché con un aggiornamento della +distribuzione \TeX{} queste modifiche andrebbero perse. Se tali modifiche +servono solo per un progetto particolare, ma potrebbero poi essere diffuse ad +altri, allora la classe personalizzata può essere inclusa nell'attuale +directory del progetto. + +\subsection{Modifica dell'interlinea mediante \texttt{\TB baselinestretch}} +\label{sec:ander-des-zeil} +In generale, le modifiche dei parametri dovrebbero essere effettuate al +livello più elevato disponibile all'utente. Pertanto una modifica +dell'interlinea può essere compiuta da tre livelli: + +\begin{enumerate} +\item ridefinendo \Macro{baselinestretch}. +\item usando il comando \LaTeX{} \LMacro{linespread}{<Fattore>}; +\item usando il pacchetto \Paket{setspace}; +\end{enumerate} + +Una ridefinizione di parametri come \Macro{baselinestretch} opera al livello +più basso e dovrebbe pertanto essere riservata ai pacchetti. + +Un metodo migliore, proprio perché espressamente destinato a questo scopo, è +l'utilizzo di \LMacro{linespread}{<Fattore>}. + +Tuttavia il miglior modo di procedere utilizzare del pacchetto +\Paket{setspace} che, quando modifica l'interlinea, si preoccupa di mantenere +gli spazi corretti nelle note a piè di pagina o negli elenchi, ambienti la cui +modifica nella maggior parte dei casi può essere indesiderata. + +Se pertanto si ha bisogno di una maggiore interlinea (ad esempio una volta e +mezza o il doppio), si ricorra innanzitutto al pacchetto \Paket{setspace}. Se +invece si volessero semplicemente apportare dei piccoli aggiustamenti per +caratteri diversi dal predefinito Computer Modern (come Palatino), allora +sarebbe più opportuno usare \LMacro{linespread}{<Fattore>}. + +Nel caso del Palatino si può utilizzare un aggiustamento pari a +\LMacro{linespread}{1.05}. + +\subsection{Rientro di capoverso e spaziatura fra paragrafi +(\texttt{\TB{}parindent}, \texttt{\TB{}parskip})} +\label{sec:absatz-und-abst} +A volte può non essere insensato modificare il rientro della prima riga dei +capoversi (regolato dal parametro \Macro{parindent}). Si dovrebbe tuttavia +tener presente che: + +\begin{itemize} +\item il rientro va modificato con una misura che dipende dal carattere (em) +e non con una misura assoluta (mm). \enquote{Dipendenza dal carattere} qui +significa che il rientro si modifica in base non soltanto alla dimensione, +ma anche al tipo di carattere, poiché l'ampiezza di $1$em è adattata da +ciascun disegnatore di caratteri caso per caso a ciascun tipo di carattere; +\item va usata la sintassi di \LaTeX, perché comporta meno problemi. Ad +esempio è più facile da verificare per programmi o script +esterni\footnote{Analizzare sintatticamente, scorporare.} e più semplice da +mantenere per l'utente. E così si può prevenire ogni incompatibilità con altri +pacchetti (come \Paket{calc}). + + \begin{Ers} + \Macro{parindent}\texttt{=1em} + \end{Ers} + \begin{Dur} + \LMacro{setlength}{\Macro{parindent}\}\{1em} + \end{Dur} +\end{itemize} + +Se non si desiderasse \emph{alcun} rientro, ma una distanza aggiuntiva fra +paragrafi come segno di cesura, \emph{non} si dovrebbe utilizzare +semplicemente + +\begin{Schlecht} +\begin{verbatim} +\setlength{\parindent}{0pt} +\setlength{\parskip}{\baselineskip} +\end{verbatim} +\end{Schlecht}% + +\noindent poiché \Macro{parskip} agisce anche su elenchi, indici e testatine. + +Il pacchetto \Paket{parskip} e le classi \KOMAScript{} aggiungono dello spazio +per evitare questi effetti collaterali. Sull'utilizzo delle diverse opzioni +(\Option{parskip=full}, \Option{parskip=half} ecc.) di \KOMAScript{} cfr. la +\Doku{scrguide}~\cite{kohm:10}. Se si utilizza una delle classi di +\KOMAScript{} \emph{non} si deve caricare in aggiunta il pacchetto +\Paket{parskip}. + +\subsection{Separazione delle formule dal testo con \texttt{\$\$\dots\$\$}} +\label{sec:abges-form-mit} +Per favore no! \texttt{\$\$\dots\$\$} è un comando di plain \TeX{} e dovrebbe +essere evitato in \LaTeX, perché rende inconsistente lo spazio verticale tra +le formule matematiche in display e il testo circostante (cfr. anche la +sezione~\vref{sec:mathematiksatz}, in particolare l'Avvertimento relativo a +\texttt{displaymath} usato insieme a \Paket{amsmath}). Inoltre, l'opzione di +classe \Option{fleqn} non funziona più. + +\begin{Ers} +\verb|$$...$$| +\end{Ers} +\begin{Dur} +\begin{verbatim} +\[...\] +\end{verbatim} + oppure (solo con \Paket{amsmath}) +\begin{verbatim} +\begin{equation*} + ... +\end{equation*} +\end{verbatim} + oppure (solo senza \Paket{amsmath}) +\begin{verbatim} +\begin{displaymath} + ... +\end{displaymath} +\end{verbatim} +\end{Dur} + +\subsection{\texttt{\TB def} vs. \texttt{\TB newcommand}} +\label{sec:def-vs.-newcommand} +Le macro dovrebbero essere definite \emph{sempre} mediante\\ +\verb+\newcommand{<nome>}{definizione}+\\ e \emph{non} con +\Macro{def}\LMacro{<nome>}{<definizione>}\footnote{Cfr. anche +\cite[Sezione 2.7.2]{clsguide:06} e \cite[Sezione 3.4]{usrguide:05}}. + +Il problema fondamentale di \Macro{def} è che non permette di controllare +l'esistenza di una macro definita in precedenza. Questa potrebbe pertanto +essere sovrascritta senza alcuna notifica o senza un avvertimento. + +Inoltre, è sempre possibile ridefinire le macro già esistenti col comando:\\ +\verb+\renewcommand{<name>}{...}+. + +Chi sa a sufficienza del \emph{perché} ha bisogno di \Macro{def}, conosce +anche i vantaggi e gli svantaggi di tale soluzione e può ignorare +tranquillamente questa sezione. + +\subsection{Utilizzo di \texttt{\TB sloppy}} +\label{sec:verw-von-textttt} + +Il commutatore \Macro{sloppy} non dovrebbe essere usato, e segnatamente in +modo globale all'interno del preambolo. Se in alcuni paragrafi sorgessero dei +problemi con la sillabazione, allora: + +\begin{enumerate} +\item verificare se sono stati impostati i corretti strumenti di sillabazione + (ad esempio mediante \Paket{babel}) e i caratteri T1 (cfr. anche le + \Doku{FAQ} sulla + sillabazione\footnote{\url{http://projekte.dante.de/DanteFAQ/Silbentrennung}}); +\item usare il pacchetto \Paket{microtype} che adatta leggermente l'ampiezza + delle lettere per produrre una migliore divisione in sillabe. Questo + adattamento automatico è possibile solo con pdf\TeX{} a partire dalla + versione 1.20 e funziona solo per la creazione di un file PDF, non invece + con l'utilizzo di pdf\TeX{} nella modalità DVI; +\item riformulare il testo. Non è assolutamente necessario modificare la frase + in cui è presente il problema di sillabazione: spesso è sufficiente + riformulare o spostare le frasi precedenti o quelle successive; +\item modificare leggermente il parametro che adotta \TeX{} per il calcolo + dell'impaginazione delle righe. Axel Reichert ha postato in + \News{de.comp.text.tex}\footnote{Reperibile in + \MID{a84us0$plqcm$7@ID-30533.news.dfncis.de}{a84us0\$plqcm\$7@ID-30533.news.dfncis.de}} + la sua personale modifica, grazie alla quale si evitano i principali + problemi di sillabazione in un buon layout: + + \begin{minipage}[t]{\linewidth} +\begin{verbatim} +\tolerance 1414 +\hbadness 1414 +\emergencystretch 1.5em +\hfuzz 0.3pt +\widowpenalty=10000 +\vfuzz \hfuzz +\raggedbottom +\end{verbatim} + \end{minipage} +\medskip + +Naturalmente questi valori possono essere modificati secondo il gusto +personale. In realtà, dei vari campi adottati da Reichert, \Macro{clubpenalty} +e \Macro{widowpenalty} servono per ridurre il numero delle possibili righe +orfane e vedove, mentre \Macro{hbadness} consente a \TeX{} di fornire messaggi +in relazione a righe troppo piene o troppo vuote. In sostanza, la maggior +parte delle impostazioni di Reichert è atta a ridurre gli avvisi +(\emph{warning}) che \TeX{} emette quando le righe non sono perfettamente +composte, ma solo \Macro{tolerance} ed \Macro{emergencystretch} hanno un +qualche effetto sulla sillabazione. Infine, \Macro{raggedbottom} non gioca +alcun ruolo nel regolare la sillabazione, ma piuttosto l'impaginazione. Prima +di tutto però si dovrebbe fare attenzione a come modificare +\Macro{emergencystretch}, altrimenti si otterrà un paragrafo pieno di spazi +non dovuti, come succede in un noto programma di elaborazione del +testo\footnote{Questo paragrafo è un'aggiunta del traduttore.}. + +Si dovrebbero tuttavia considerare \emph{seriamente} gli avvisi o +\emph{Warning} che sorgono ed eliminarli tramite riformulazioni: +\end{enumerate} + +Soltanto se questi metodi non producono alcun risultato si può cercare di +impostare il paragrafo in modo più ``lasco'' con l'ambiente +\texttt{sloppypar}, come nell'esempio seguente: + +\begin{figure}[htp] + \begin{minipage}[t]{.48\textwidth} + \centering + \linespread{1.0} + {\fontsize{10pt}{12pt}\fontencoding{OT1}\selectfont + \fbox{\parbox{17.61em}{\microtypecontext{expansion=slbsp}\fussy% + tatata tatata tatata tatata tatata tatata tata\-tata tatata tatata + tatata tatata tatata tatata tata\-tata tatata tatata tatata tatata + ta\-tatatatt\-ta tatata tatata tatata tatata tatata tatata + ta\-ta\-ta\-ta}}}% + \caption{Comportamento con i valori standard di \LaTeX}% + \label{fig:beispiel-mit-latex}% + \end{minipage}% + \hfill% + \begin{minipage}[t]{.48\textwidth} + \centering + \linespread{1.0} + {\fontsize{10pt}{12pt}\fontencoding{OT1}\selectfont + \fbox{\parbox{17.61em}{\microtypecontext{expansion=slbsp}% + tatata tatata tatata tatata tatata tatata tata\-tata tatata tatata + tatata tatata tatata tatata tata\-tata tatata tatata tatata tatata + ta\-tatatatt\-ta tatata tatata tatata tatata tatata tatata + ta\-ta\-ta\-ta}}}% + \caption{Comportamento con \texttt{\string\sloppypar}}% + \label{fig:beisp-mit-textttstr} + \end{minipage} +\end{figure} + +Nelle immagini~\ref{fig:beispiel-mit-latex} e \vref{fig:beisp-mit-textttstr} +si cerca di mostrare l'effetto di \Macro{sloppy}. In \News{comp.text.tex} +Markus Kohm ha pubblicato un esempio che mostra l'effetto in modo assai chiaro. +Esso è riportato (con l'autorizzazione dell'Autore) +nell'Appendice~\vref{sec:beispiel-zu-sloppy}). + +% ---------------------- Sezione 2: "Pacchetti obsoleti"---------------------- +\clearpage +\section{Comandi, classi e pacchetti obsoleti} +\label{sec:obsoletes} +Markus Kohm ha redatto uno script in Perl col quale si possono verificare on +line i propri file per rintracciare gli errori più comuni +(\url{http://kohm.de.tf/markus/texidate.html}). + +Tuttavia bisogna notare che tale script non è un analizzatore +(\,\emph{parser}) \TeX{} completo e che pertanto esso è in grado di rilevare +solo gli errori più ovvi e diffusi. Prima provare, poi postare. + +\subsection{Comandi} +\label{sec:befehle} + +\subsubsection{Modifica dello stile del carattere} +\label{sec:ander-des-schr} +Nella Tabella \vref{tab:befehle-zur-anderung} sono affiancati i vecchi e i +nuovi comandi atti a modificare lo stile del carattere. Quelli vecchi non +hanno mai funzionato in modo adeguato, anche perché il loro effetto quando +sono dati in serie è piuttosto imprevedibile. Essi pertanto non vanno mai +usati. + +Ci sono validi sostituti che producono anche il corretto effetto cumulativo: +ad esempio con \verb+\sffamily\itshape+ si sceglie un font senza grazie +inclinato (cosa che non sarebbe avvenuta con \verb+\sf\it+). Tuttavia è +consigliabile usare la forma dichiarativa solo per lunghi tratti di testo +all'interno di un ambiente; per tratti brevi o singole parole è meglio +adottare i comandi con argomento (come \Macro{textit}, \Macro{textsf} ecc.), +che inoltre liberano dal problema di chiudere i gruppi aperti. Si ricordi +infatti che la sintassi corretta per \Macro{sffamily} e simili è +\verb+{\sffamily ...}+, dove le graffe possono essere sostituite dai +delimitatori di un ambiente. Le forme dichiarative sono comode solo in un +caso: le celle di una tabella composta con \Paket{tabular}\footnote{Questo +paragrafo è il precedente sono stati modificati dal traduttore.}. + +\begin{table} +\centering +\caption{Macro per modificare lo stile del carattere.} +\label{tab:befehle-zur-anderung} +\begin{tabpar}[b]{lll} + {\footnotesize\textsuperscript{\itshape a} Utile nella definizioni di macro. +All'interno + del testo non si dovrebbe usare \GMacro{em}{\dots}, bens\`i +\LMacro{emph}{\dots}.} +\toprule +\multicolumn{1}{c}{Obsolete} & \multicolumn{2}{c}{Sostituite in \LaTeXe{} da} +\\ +\cmidrule(l){2-3} & comandi & dichiarazioni \\ +\cmidrule(r){1-1} \cmidrule(lr){2-2} \cmidrule(l){3-3} +\GMacro{rm}{\dots} & \LMacro{textrm}{\dots} & \Macro{rmfamily} \\ +\GMacro{sf}{\dots} & \LMacro{textsf}{\dots} & \Macro{sffamily} \\ +\GMacro{tt}{\dots} & \LMacro{texttt}{\dots} & \Macro{ttfamily} \\ +\GMacro{it}{\dots} & \LMacro{textit}{\dots} & \Macro{itshape} \\ +\GMacro{sc}{\dots} & \LMacro{textsc}{\dots} & \Macro{scshape} \\ +\GMacro{sl}{\dots} & \LMacro{textsl}{\dots} & \Macro{slshape} \\ +\GMacro{bf}{\dots} & \LMacro{textbf}{\dots} & \Macro{bfseries} \\ +--- & \LMacro{textmd}{\dots} & \Macro{mdseries} \\ +--- & \LMacro{textup}{\dots} & \Macro{upshape} \\ +--- & \LMacro{emph}{\dots} & +\Macro{em}\textsuperscript{\itshape a} \\ +\bottomrule +\end{tabpar} +\end{table} + +%\ctable[ +%caption = Macro per modificare lo stile del carattere., +%label=tab:befehle-zur-anderung, +%mincapwidth = \columnwidth, +%pos = h ]{lll}{ +%\tnote{Utile nella definizioni di macro. All'interno del testo non si dovrebbe +%usare \GMacro{em}{\dots}, bensì \LMacro{emph}{\dots}.} +%}{ +%\toprule +%\multicolumn{1}{c}{Obsolete} & \multicolumn{2}{c}{Sostituite in \LaTeXe{} da} \\ +%\cmidrule(l){2-3} & locali & globali/commutative \\ +%\cmidrule(r){1-1} \cmidrule(lr){2-2} \cmidrule(l){3-3} +%\GMacro{rm}{\dots} & \LMacro{textrm}{\dots} & \Macro{rmfamily} \\ +%\GMacro{sf}{\dots} & \LMacro{textsf}{\dots} & \Macro{sffamily} \\ +%\GMacro{tt}{\dots} & \LMacro{texttt}{\dots} & \Macro{ttfamily} \\ +%\GMacro{it}{\dots} & \LMacro{textit}{\dots} & \Macro{itshape} \\ +%\GMacro{sc}{\dots} & \LMacro{textsc}{\dots} & \Macro{scshape} \\ +%GMacro{sl}{\dots} & \LMacro{textsl}{\dots} & \Macro{slshape} \\ +%\GMacro{bf}{\dots} & \LMacro{textbf}{\dots} & \Macro{bfseries} \\ +%--- & \LMacro{textmd}{\dots} & \Macro{mdseries} \\ +%--- & \LMacro{textup}{\dots} & \Macro{upshape} \\ +%--- & \LMacro{emph}{\dots} & \Macro{em}\tmark \\ +%\bottomrule +%} + +\paragraph{Perché non si dovrebbero usare i comandi obsoleti?} +\label{sec:warum-sollte-man} +I comandi obsoleti non supportano le funzionalità del nuovo sistema di +selezione dei font\footnote{NFSS: New Font Selection Scheme. Un panorama del +NFSS è offerto da \Doku{fntguide}~\cite{fntguide:05}.} di \LaTeXe. Ad esempio, +\GMacro{bf}{foo} annulla tutte le impostazioni già fornite prima di stampare +«foo» in nero. Ne consegue che non si può definire uno stile corsivo nero +mediante \GMacro{it}{\Macro{bf Test}} (questa definizione produce: +{\it\bf Test}). + +I nuovi comandi \LMacro{textbf}{\LMacro{textit}{Test}} si comportano come +atteso e producono: \textbf{\textit{Test}}. Inoltre nei vecchi comandi non c'è +nessuna «correzione» per il corsivo, ad esempio {\it raf}forzare +(\GMacro{it}{raf}\texttt{forzare}) e \textit{raf}forzare +(\LMacro{textit}{raf}\texttt{forzare}). + +\subsubsection{Frazioni matematiche (\texttt{\TB over} vs. \texttt{\TB frac})} +\label{sec:textb-over-vs} +Il comando \Macro{over} non dovrebbe essere usato. \Macro{over} è un comando +di \TeX, il quale, a causa della sintassi differente da quella di \LaTeX{}, si +può analizzare con più difficoltà o non si può analizzare affatto. In +particolare il pacchetto \Paket{amsmath} ridefinisce \verb+\frac{}{}+, +cosicché se si usa \verb+\over+ si riceverà un messaggio di errore. Un'altra +ragione per usare \verb+\frac{}{}+ è che per l'utente -- soprattutto nel caso +di frazioni complesse -- è più semplice comporre numeratore e denominatore. + +\begin{Ers} + \verb+$a \over b$+ +\end{Ers} +\begin{Dur} + \verb+$\frac{a}{b}$+ +\end{Dur} + +\subsubsection{Centratura con \texttt{\TB centerline}} +\label{sec:centerline} +Il comando \Macro{centerline}\ è ancora una volta un comando di \TeX{} e +dovrebbe essere evitato in \LaTeX. Da un lato \Macro{centerline} è +incompatibile con alcuni pacchetti di \LaTeX{} (ad esempio \Paket{color}) e +dall'altro il suo utilizzo può produrre effetti indesiderati o inattesi: + +\begin{center} + \begin{minipage}[t]{.45\textwidth} +\begin{verbatim} +\begin{enumerate} +\item\centerline{Punto uno} +\end{enumerate} +\end{verbatim} + \end{minipage}% + \hfill% + \fbox{ \begin{minipage}[t]{.45\textwidth} + \begin{enumerate} + \item \centerline{Punto uno} + \end{enumerate} + \end{minipage}} +\end{center} +\begin{Ers} + \LMacro{centerline}{\dots} +\end{Ers} +\begin{Dur} + \GMacro{centering}{\dots} oppure + \begin{varwidth}[t]{\linewidth} +\begin{verbatim} +\begin{center} + ... +\end{center} +\end{verbatim} + \end{varwidth} +\end{Dur} + +Si noti tuttavia che la dichiarazione \Macro{centering}, a differenza +dell'ambiente definito da \verb+\begin{center} ... \end{center}+, non agisce +finché il capoverso non sia teminato esplicitamente mediante \verb+\par+ +oppure con una riga vuota o ancora implicitamente mediante comandi successivi. + +\paragraph{Nota} +\label{sec:anmerkung-5} +Alcune osservazioni sulla centratura di oggetti grafici e di tabelle si +leggono nella Sezione~\vref{sec:gleit-figure-table}. + +\subsection{Classi e pacchetti} +\label{sec:pakete} + +\subsubsection{\KlassH{scrlettr} vs. \KlassH{scrlttr2}} +\label{sec:paketscrl-vs.-pakets} +La classe \Klasse{scrlettr} del pacchetto \KOMAScript\ è obsoleta e +dev'essere sostituita dalla nuova \Klasse{scrlttr2}. Per produrre un layout +\emph{simile} a quello della vecchia classe si può caricare l'opzione di +classe \Option{KOMAold}, che fornisce una modalità compatibile. + +\begin{Ers} + \verb+\documentclass{scrlettr}+ +\end{Ers}\par +\begin{Dur} + \verb+\documentclass[KOMAold]{scrlttr2}+ +\end{Dur} + +\paragraph{Nota} +\label{sec:anmerkung-3} +Per nuovi testi e lettere si dovrebbe tuttavia adottare la nuova interfaccia, +poiché è molto più flessibile. + +Una spiegazione delle differenze fra le due interfacce utente esula dagli +intenti di questo compendio, perciò rinviamo a \Doku{scrguide}~\cite{kohm:10}. + +\subsubsection{\PakeH{epsf}, \PakeH{psfig}, \PakeH{epsfig} vs. + \PakeH{graphics}, \PakeH{graphicx}} +\label{sec:grafikeinbindung} +I pacchetti \Paket{epsf} e \Paket{psfig} vanno sostituiti con \Paket{graphics} +o con \Paket{graphicx}. \Paket{epsfig} è solo un wrapper\footnote{Qui: un file +di stile che ne carica un altro o alcuni altri.} per \Paket{graphicx}, la cui +funzione è consentire l'utilizzo di \Paket{graphicx} per documenti vecchi +che sono stati composti con \Paket{psfig}. + +Dal momento che \Paket{epsfig} invoca \Paket{graphicx}, si \emph{può} usare +ancora, ma per documenti nuovi si dovrebbe ricorrere ai più recenti +\Paket{graphics} o \Paket{graphicx}. La sintassi degli ultimi due pacchetti +citati è estremamente flessibile. Il pacchetto \Paket{epsfig} è fornito +essenzialmente per motivi di compatibilità. + +Sulle differenze fra i pacchetti \Paket{graphics} e \Paket{graphicx} si veda +\Doku{grfguide}~\cite{graphicx:05}. Per una sintesi sulla centratura di +oggetti grafici cfr. la Sezione~\vref{sec:gleit-figure-table}. + +\begin{Ers} +\begin{verbatim} +\usepackage{psfig} +\psfig{file=figura,...} +\end{verbatim} +\end{Ers} +\begin{Dur} +\begin{verbatim} +\usepackage{graphicx} +\includegraphics[...]{figura} +\end{verbatim} +\end{Dur} + +\subsubsection{\PakeH{doublespace} vs. \PakeH{setspace}} +\label{sec:zeilenabstande} +Per modificare l'interlinea si dovrebbe usare il pacchetto \Paket{setspace}. +\Paket{doublespace} è obsoleto e dovrebbe essere rimpiazzato appunto con +\Paket{setspace}. Vedere con attenzione anche la +Sezione~\vref{sec:ander-des-zeil}. + +\begin{Ers} + \verb|\usepackage{doublespace}| +\end{Ers} +\begin{Dur} + \verb|\usepackage{setspace}| +\end{Dur} + +\subsubsection{\PakeH{fancyheadings}, \PakeH{scrpage} vs. \PakeH{fancyhdr}, + \PakeH{scrpage2}} +\label{sec:lebende-kolumn} +Il pacchetto \Paket{fancyheadings} è stato sostituito da \Paket{fancyhdr}. Un +altro modo per personalizzare le testatine è usare il pacchetto +\Paket{scrpage2} di \KOMAScript. Anche in questo caso bisogna prestare +attenzione a non usare \Paket{scrpage}. La documentazione di \Paket{scrpage2} +si trova in \Doku{scrguide}~\cite{kohm:10}. + +\begin{Ers} + \verb+\usepackage{fancyheadings}+ +\end{Ers} +\begin{Dur} + \verb+\usepackage{fancyhdr}+ +\end{Dur} +\begin{Ers} + \verb+\usepackage{scrpage}+ +\end{Ers} +\begin{Dur} + \verb+\usepackage{scrpage2}+ +\end{Dur} + +\subsubsection{La famiglia di pacchetti \PakeH{caption}} +\label{sec:die-caption-famile} +Il pacchetto \Paket{caption2} non dovrebbe più essere usato, perché ne esiste +una nuova versione (la 3.x). Si dovrebbe prestare attenzione a non usare una +versione troppo vecchia del pacchetto. Per esserne sicuri, caricare il +pacchetto nel seguente modo: + +\begin{Ers} + \verb+\usepackage{caption}+ +\end{Ers} +\begin{Dur} + \verb+\usepackage{caption}[2008/08/24]+ +\end{Dur} + +Chi avesse utilizzato in precedenza \Paket{caption2}, dovrebbe assolutamente +prendere visione della la nuova documentazione~\cite[Sezione~C.2]{caption:08}. + +\subsubsection{\PakeH{isolatin}, \PakeH{umlaut} vs. \PakeH{inputenc}} +\label{sec:eingabe-von-umlauten} + +\paragraph{Osservazioni generali} +\label{sec:generelles} +In generale, ci sono quattro possibilità per inserire Umlaut e altri caratteri +non ASCII: + +\begin{enumerate} +\item \verb+H{\"u}lle+: Il vantaggio di questo modo di procedere è che + funziona sempre e su tutti i sistemi.\\ + Per contro, gli svantaggi sono che la crenatura\footnote{La spaziatura + positiva o negativa fra le lettere in relazione alle combinazioni di segni.} + risulta disturbata, che nei testi tedeschi questa è di gran lunga la + modalità più complicata di digitare e che il codice si legge con notevole + difficoltà.\\ + Questa variante -- in ragione del problema alla crenatura -- dovrebbe + \emph{sempre} essere evitata. + +\item L'immissione nella forma \verb+H\"ulle+ o anche \verb+H\"{u}lle+ non + presenta il problema di crenatura sopra menzionato e si può adottare + tranquillamente su qualunque sistema.\\ + Gli svantaggi di questo modo di procedere sono anche qui l'immissione + complicata e la cattiva leggibilità del codice.\\ + Questa variante è la più indicata nella definizione delle macro e nei file + di stile, perché è indipendente dalla codifica e dai pacchetti + caricati.\label{item:die-eingabe-der} + +\item Con \Paket{(n)german} oppure con l'opzione \Option{(n)german} del + pacchetto \Paket{babel} si possono produrre le Umlaut digitando + (\verb+H"ulle+). Il vantaggio è ancora una volta che questo metodo funziona + in tutti i sistemi. Poiché \Paket{babel} o anche \Paket{(n)german} sono + disponibili in tutte le installazioni di \TeX, non dovrebbe aversi nemmeno + alcun problema di compatibilità.\\ + Gli svantaggi sono anche qui l'immissione complicata e la cattiva + leggibilità del codice.\\ + Questa variante funziona relativamente bene nel corpo di testo, ma dovrebbe + essere evitata nella definizione delle macro e nei preamboli. + +\item L'inserimento diretto (\verb+Hülle+). I vantaggi qui sono evidenti. Il + codice è scritto e si legge in modo ``normale''.\\ + Lo svantaggio è che bisogna suggerire a \LaTeX{} quale codifica di + immissione si sta usando e che potrebbero sorgere eventuali problemi nello + scambio di file tra sistemi diversi. Questo non è in sé un problema per + \TeX{} o per \LaTeX{}, ma potrebbe causare dei \emph{problemi di + visualizzazione} agli editor in sistemi diversi. Ad esempio, \texteuro{} + codificato in \textln{iso-8859-15} (\textln{latin9}) potrebbe essere + \emph{visualizzato} come {\fontfamily{cmr}\selectfont\textcurrency}{} in un + editor per Windows (\textln{CP1252}).\\ + Questa variante funziona ottimamente per testi lunghi. Dovrebbe tuttavia + essere evitata nella definizione di macro e nei preamboli. +\end{enumerate} + +Riassumendo, possiamo pertanto dire che nelle macro, nei preamboli e nei file +di stile dovrebbe essere adottata la forma \verb+H\"ulle+ oppure +\verb+H\"{u}lle+ e all'interno del testo o \verb+H"ulle+ oppure \verb+Hülle+. + +\paragraph{Codifica dell'input} +\label{sec:eingabekodierung-1} +Per suggerire a \LaTeX{} quale codifica impostare \emph{non} si dovrebbe usare +\Paket{isolatin1} e nemmeno \Paket{isolatin} oppure \Paket{umlaut}. Questi +pacchetti sono obsoleti e nemmeno disponibili in tutti i sistemi. + +È corretto invece utilizzare il pacchetto \Paket{inputenc} con le seguenti +opzioni: + +\begin{description*} +\item[\texttt{latin1/latin9}] per sistemi Unix (\Option{latin1} è disponibile +anche in Microsoft Windows e Mac~OS~X); +\item[\texttt{ansinew}] per Microsoft~Windows; +\item[\texttt{applemac}] per Mac\footnote{Nell'utilizzo di OS~X si dovrebbe + allo stesso modo adottare \texttt{latin1/latin9}, perché questa codifica + è più adatta di \texttt{applemac} allo scambio con utenti di altri + sistemi operativi. Tuttavia si dovrebbe prestare grande attenzione alla + codifica di input degli editor utilizzati.}; +\item[\texttt{cp850}] per \textln{OS/2}; +\item[\texttt{utf8}] per \enquote{moderni} sistemi Unix e in generale per + sistemi (ed editor) che adottano Unicode. + +\end{description*} +\begin{Ers} + \verb|\usepackage{isolatin1}| +\end{Ers} +\begin{Dur} + \verb|\usepackage[latin1]{inputenc}| +\end{Dur} +\begin{Ers} + \verb|\usepackage{umlaut}| +\end{Ers} +\begin{Dur} + \verb+\usepackage[latin1]{inputenc}+ +\end{Dur} + +\paragraph{Nota} Il metodo sopra illustrato per dichiarare la codifica di +input si usa nel \enquote{classico} utilizzo di motori per \LaTeX{} come +pdf\LaTeX. I recenti sviluppi \XeLaTeX\ e Lua\LaTeX{} elaborano file +codificati in Unicode anche senza dichiarare la codifica. Entrambi gli ultimi +motori citati possono essere impiegati produttivamente, ma richiedono di +solito una riscrittura dei «vecchi» sorgenti \LaTeX{} in relazione alla scelta +della lingua e dei tipi di carattere e non possiedono ancora le capacità di +microtipografia nella misura in cui ne gode pdf\LaTeX. + +\subsubsection{\PakeH{t1enc} vs. \PakeH{fontenc}} +\label{sec:schriftkodierung} +Il pacchetto \Paket{t1enc} è obsoleto e dovrebbe pertanto essere sostituito da +\Paket{fontenc}. + +\begin{Ers} + \verb|\usepackage{t1enc}| +\end{Ers} +\begin{Dur} + \verb|\usepackage[T1]{fontenc}| +\end{Dur} + +\subsubsection{\BstH{natdin} vs. \BstH{dinat}} +\label{sec:liter-nach-din} +L'autore di \Bst{dinat} raccomanda di sostituirlo con \Bst{natdin}, perché il +primo non è più stato sviluppato di recente, mentre il secondo è stato +enormemente migliorato. + +\begin{Ers} + \verb|dinat.bst| +\end{Ers} +\begin{Dur} + \verb|natdin.bst| +\end{Dur} + +\paragraph{Nota} In versioni precedenti di questo documento abbiamo fatto la +raccomandazione esattamente opposta, che si fondava sullo stato di sviluppo di +allora. I miglioramenti a \Bst{natdin} che sono stati prodotti in seguito +giustificano ora la preferenza a favore di quest'ultimo pacchetto. + +\subsubsection{\PakeH{glossary} vs. \PakeH{glossaries}} +\label{sec:glossar} +Il pacchetto \Paket{glossary} è obsoleto; come successore è stato creato dalla +stessa autrice \Paket{glossaries}. Dettagli sulla modifica si trovano in +\cite{glossaries:11}. + +\subsubsection{\PakeH{SIstyle} e \PakeH{SIunits} vs. \PakeH{siunitx}} +\label{sec:einheiten} +I pacchetti \Paket{SIstyle} und \Paket{SIunits}, utili alla composizione delle +unità fisiche, non sono più stati sviluppati. Le funzionalità di entrambi i +pacchetti sono unificate nel successore \Paket{siunitx}. In ragione della sua +notevole flessibilità, \Paket{siunitx} può sostituire anche pacchetti come +\Paket{unitsdef}, \Paket{units}, \Paket{fancyunits} e \Paket{fancynum}. + +\begin{Ers} +\begin{verbatim} +\usepackage{SIunits} +\unit{1}{\metre} +\end{verbatim} +\end{Ers} +\begin{Dur} +\begin{verbatim} +\usepackage{siunitx} +\SI{1}{\metre} +\end{verbatim} +\end{Dur} + +\subsubsection{\PakeH{subfigure} e \PakeH{subfig} vs. \PakeH{subcaption}} +\label{sec:subfigures} +I pacchetti \Paket{subfigure} e \Paket{subfig} non sono più sviluppati e sono +incompatibili con alcuni pacchetti attuali come \Paket{hyperref} e +\Paket{caption}. Come sostituto si suggerisce \Paket{subcaption}. + +\begin{Ers} +\begin{verbatim} +\usepackage{subfig} +\begin{figure} +\subfloat[][testo]{figura} +\end{figure} +\end{verbatim} +\end{Ers} +\begin{Dur} +\begin{verbatim} +\usepackage{caption} +\usepackage{subcaption} +\begin{figure} +\begin{subfigure}{larghezza} +figura\caption{testo} +\end{subfigure} +\end{figure} +\end{verbatim} +\end{Dur} + +\subsection{Caratteri} +\label{sec:schriften} +Il tema «Caratteri e \LaTeX» è fonte di «gioia» perenne in +\News{de.comp.text.tex}, e in generale si avvia con la domanda: «perché i +caratteri appaiano così frastagliati in Acrobat Reader?». Le più frequenti ma +\emph{sbagliate} risposte a questa domanda raccomandano di risolvere il +problema ricorrendo a \Paket{times} oppure a \Paket{pslatex}. Il fatto è che +con l'utilizzo di questi pacchetti non solo si impostano caratteri +completamenti diversi, ma pure -- dal momento che questi pacchetti sono +obsoleti -- sorgono nuovi problemi. Se, come suggerito nella sezione +\ref{sec:ae}, si utilizza Latin Modern come sostituto (quasi) identico per il +carattere «standard» di \LaTeX{} (cioè Computer Modern), allora il problema +dell'aspetto frastagliato dei caratteri in Adobe Reader non si presenta. + +La \Doku{fntguide}~\cite{fntguide:05} fornisce informazioni generali sul New +Font Selection Scheme (NFSS) di \LaTeXe. + +\subsubsection{\PakeH{times}} +\label{sec:pakettimes} +Il pacchetto \Paket{times} è obsoleto (si veda \Doku{psnfss2e} +\cite{psnfss:04}). Esso imposta \Macro{rmdefault} per il carattere Times, +\Macro{sfdefault} per Helvetica e \Macro{ttdefault} per Courier \emph{senza} +tuttavia impostare i corrispondenti caratteri matematici. Inoltre l'Helvetica +non è correttamente scalato e appare troppo grande. Se si volesse adottare la +combinazione Times/"Helvetica/"Courier, si dovrebbe allora fare così: + +\begin{Ers} + \verb|\usepackage{times}| +\end{Ers} +\begin{Dur} +\begin{verbatim} +\usepackage{mathptmx} +\usepackage[scaled=.92]{helvet} +\usepackage{courier} +\end{verbatim} +\end{Dur} + +\paragraph{Nota} +\label{sec:anmerkung-1} +Il fattore di scalatura per \Paket{helvet} in combinazione con Times dovrebbe +essere compreso fra $0.90$ e $0.92$. + +\subsubsection{\PakeH{mathptm}} +\label{sec:mathptm} +Il pacchetto \Paket{mathptm} è il predecessore di \Paket{mathptmx} e dunque +non va più usato. + +\begin{Ers} + \verb+\usepackage{mathptm}+ +\end{Ers} +\begin{Dur} + \verb+\usepackage{mathptmx}+ +\end{Dur} + +\subsubsection{\PakeH{pslatex}} +\label{sec:paketpslatex} +Il pacchetto \Paket{pslatex} include al suo interno \Paket{mathptm}$+$ +\Paket{helvet} (scalato) e tuttavia adotta un Courier scalato in modo +eccessivo. Il principale svantaggio di \Paket{pslatex} è che \emph{non} +funziona con le codifiche T1 e TS1. + +\begin{Ers} + \verb+\usepackage{pslatex}+ +\end{Ers} +\begin{Dur} +\begin{verbatim} +\usepackage{mathptmx} +\usepackage[scaled=.92]{helvet} +\usepackage{courier} +\end{verbatim} +\end{Dur} + +\paragraph{Nota su tutte le combinazioni Times/Helvetica} +\label{sec:anmerkung-zu-allen} +Ci si può anche limitare all'uso di \texttt{cmtt} per un effetto da «macchina +da scrivere», col che non serve più caricare \Paket{courier}. + +\subsubsection{\PakeH{palatino}} +\label{sec:paketpalatino} +Il pacchetto \Paket{palatino} si comporta come \Paket{times} (a parte +ovviamente l'impostazione di \Macro{rmdefault} a Palatino) e non dovrebbe +pertanto essere più utilizzato. + +\begin{Ers} + \verb+\usepackage{palatino}+ +\end{Ers} +\begin{Dur} +\begin{verbatim} +\usepackage{mathpazo} +\usepackage[scaled=.95]{helvet} +\usepackage{courier} +\end{verbatim} +\end{Dur} + +\paragraph{Nota} +\label{sec:anmerkung-2} +Il fattore di scalatura per \Paket{helvet} in combinazione col carattere +Palatino dovrebbe essere impostato a $0.95$. + +In realtà, nonostante l'Helvetica \emph{non} sia il carattere migliore da +combinare con il Palatino, anche se ne è stato a lungo il complemento più +adatto liberamente disponibile e gratuito, la sostituzione sopra suggerita +assomiglia per quanto possibile al «vecchio» accostamento. Nel frattempo +sono stati resi disponibili i Vera/Bera Sans --\,un'alternativa a nostro +avviso migliore. + +Chi possieda un CD di CorelDraw\textsuperscript{\textregistered} (anche +vecchio\footnote{I caratteri che sono forniti con le versioni più vecchie di +CorelDraw non contengono ancora alcun carattere per l'Euro!}) può combinare +molto felicemente il Palatino con i caratteri Frutiger\footnote{Bitstream +Humanist 777, pacchetto \textsf{bfr} per \TeX{} creato da Walter Schmid.} +oppure Optima\footnote{Bitstream Zapf Humanist, pacchetto \textsf{bop} per +\TeX{} creato da Walter Schmid.}. Nella sua homepage\footnote{Schriften für +\TeX: \url{http://home.vr-web.de/was/fonts}} Walter Schmidt ha pubblicato i +corrispondenti adattamenti (pacchetti \textsf{bfr} e \textsf{bop}) per usare +questi caratteri con \TeX. + +\subsubsection{\PakeH{mathpple}} +\label{sec:paketmathpple} +Questo pacchetto è il predecessore di \Paket{mathpazo}. Manca di alcuni +caratteri, che vengono allora mutuati dai font Euler, altri caratteri non +si adattano bene al Palatino e alcune metriche del carattere non sono +corrette. Per più ampie informazioni cfr. \Doku{psnfss2e}~\cite{psnfss:04}. + +\begin{Ers} + \verb+\usepackage{mathpple}+ +\end{Ers} +\begin{Dur} + \verb+\usepackage{mathpazo}+ +\end{Dur} + +\subsubsection{\PakeH{utopia}} +\label{sec:paketutopia} +Il pacchetto \Paket{utopia} non dovrebbe più essere utilizzato perché il suo +successore \Paket{fourier} presenta un'interfaccia migliore. Per informazioni +più precise cfr. \Doku{psnfss2e}~\cite{psnfss:04}. + +\begin{Ers} + \verb+\usepackage{utopia}+ +\end{Ers} +\begin{Dur} + \verb+\usepackage{fourier}+ +\end{Dur} + +\subsubsection{Lettere greche matematiche non inclinate} +\label{sec:aufr-griech-buchst} +I passaggi che seguono, segnati in rosso, non vanno intesi nel senso di «non +si deve più fare così», ma che ora il pacchetto \Paket{upgreek} offre un modo +più facile per immettere i caratteri greci. Per consigli sull'utilizzo si +consulti sempre la documentazione \Doku{upgreek}~\cite{upgreek:03}. + +\minisec{Il trucco \PakeH{pifont}\nopagebreak[4]} +\begin{Ers} +\begin{verbatim} +\usepackage{pifont} +\newcommand{\uppi}{% + \Pisymbol{psy}{112}} + ... +\uppi +\end{verbatim} + +oppure + +\begin{verbatim} +\newcommand[1]{\upgreek}{% + \usefont{U}{psy}{m}{n}#1} + ... +\upgreek{p} +\end{verbatim} +\end{Ers} +\begin{Dur} +\begin{verbatim} +\usepackage{upgreek} + ... +$\uppi$ +\end{verbatim} +\end{Dur} + +\minisec{Il trucco di \PakeH{babel}} +\begin{Ers} +\begin{verbatim} +\usepackage[greek,...]{babel} +\newcommand{\upgreek}[1]{% + \foreignlanguage{greek}{#1}} + ... +\upgreek{p} +\end{verbatim} +\end{Ers} +\begin{Dur} +\begin{verbatim} +\usepackage{upgreek} + ... +$\uppi$ +\end{verbatim} +\end{Dur} + +\subsubsection{\PakeH{euler} vs. \PakeH{eulervm}} +\label{sec:euler-vs-euler} +Il pacchetto \Paket{euler} dovrebbe essere sostituito con \Paket{eulervm}, +perché il primo presenta dei problemi di compatibilità con altri pacchetti e +manca di alcuni miglioramenti nei dettagli: + +\begin{itemize} +\item \Macro{hbar} (\Macro{hslash} in questo carattere) funziona ora in modo + migliore; +\item sono disponibili caratteri matematici in nero che includono simboli + greci. +\end{itemize} + +Per informazioni più precise cfr. \Doku{eulervm}~\cite{eulervm:05}. + +\begin{Ers} + \verb+\usepackage{euler}+ +\end{Ers} +\begin{Dur} + \verb+\usepackage{eulervm}+ +\end{Dur} + +\subsubsection{\PakeH{ae}, \PakeH{aecompl} e \PakeH{zefonts}} +\label{sec:ae} +I pacchetti \Paket{ae} (insieme a \Paket{aecompl}) e \Paket{zefonts} servono +da soluzione di ripiego per un problema che riguarda le Umlaut e altre lettere +accentate e che sorge quando si utilizzano i caratteri standard di \LaTeX, e +cioè i Computer Modern (CM). Poiché questi esistono solo nella codifica OT1, +le lettere accentate e i caratteri particolari delle lingue diverse +dall'inglese, inesistenti in quella codifica, vengono ``costruiti'' con i +segni corrispondenti (una \emph{ü}, cioè, risulta dalla sovrapposizione di +`\,\"{}\,' a `u' e così via). Questi caratteri composti confondono l'algoritmo +di sillabazione di \LaTeX, il che fa sì che ad esempio le parole con l'Umlaut +non riescano a essere sillabate. I pacchetti \Paket{ae} e \Paket{zefonts} +risolvono questo problema con l'utilizzo dei cosiddetti font virtuali. + +Un altro problema, a questo connesso, non viene invece risolto con i pacchetti +citati: se si produce un file PDF, in quest'ultimo i caratteri composti +vengono visualizzati in modo (apparentemente) corretto, ma le parole con +l'Umlaut non sono trattate correttamente nelle ricerche all'interno del file o +se vengono copiate e incollate. + +I problemi qui descritti non si presentano se si utilizza un carattere con +codifica T1 e in formato Type 1\footnote{Si deve notare che T1 e Type 1, +nonostante si chiamino in modo simile, non hanno affatto lo stesso +significato: T1 descrive la codifica del carattere dal versante di \LaTeX, +mentre Type 1 è una dichiarazione su come i caratteri vengono rappresentati +nel file PDF. Perciò l'utilizzo di un carattere nella codifica T1 risolve il +problema della sillabazione delle parole con l'Umlaut, ma non necessariamente +quello della ricerca delle Umlaut in un file PDF.}. Perciò di recente sono +stati progettate le famiglie di caratteri cm-super e Latin Modern. Poiché +quest'ultima famiglia si comporta in modo più solido degli originali Computer +Modern, raccomandiamo di sostituire i CM con Latin Modern. + +\begin{Ers} +\begin{verbatim} +\usepackage{ae} +\end{verbatim} +oppure +\begin{verbatim} +\usepackage{zefonts} +\end{verbatim} +\end{Ers} +\begin{Dur} +\begin{verbatim} +\usepackage[T1]{fontenc} +\usepackage{lmodern} +\end{verbatim} +\end{Dur} + +%--------------------------- Sezione 3: "Miscellanea" ------------------------ +\clearpage +\section{Miscellanea} +\label{sec:verschiedenes} +Questa sezione -- con l'eccezione di \vref{sec:der-anhang} -- presenta +trucchi e consigli più generali di quelli compresi sotto il titolo di +«peccati». + +\subsection{Oggetti flottanti -- «figure», «table»} +\label{sec:gleit-figure-table} +Per centrare un oggetto flottante si dovrebbe utilizzare \Macro{centering} in +luogo dell'ambiente \verb+center+, poiché questo introduce fra l'oggetto +stesso e il testo circostante uno spazio verticale aggiuntivo che nella +maggior parte dei casi può risultare indesiderato. + +\begin{Ers} +\begin{verbatim} +\begin{figure} + \begin{center} + \includegraphics{bild} + \end{center} +\end{figure} +\end{verbatim} +\end{Ers} +\begin{Dur} +\begin{verbatim} +\begin{figure} + \centering + \includegraphics{bild} +\end{figure} +\end{verbatim} +\end{Dur} + +\paragraph{Nota} +\label{sec:anmerkung-4} +Se tuttavia si tratta di centrare una regione all'interno del corpo del testo +o dell'ambiente \verb+titlepage+, allora questo spazio aggiuntivo può essere +naturalmente voluto. + +\subsection{L'appendice} +\label{sec:der-anhang} +L'appendice viene introdotta dal \emph{comando} \Macro{appendix}. \emph{Non si +tratta} di un ambiente. + +\begin{Ers} +\begin{verbatim} +\begin{appendix} +\section{Blub} +\end{appendix} +\end{verbatim} +\end{Ers} +\begin{Dur} +\begin{verbatim} +\appendix +\section{Blub} +\end{verbatim} +\end{Dur} + +\subsection{Formule matematiche} +\label{sec:mathematiksatz} +In generale, per la tipografia matematica avanzata si deve usare +\Paket{amsmath}, eventualmente integrato con \Paket{mathtools}. Esso presenta +nuovi ambienti, che sostituiscono innanzitutto \verb+eqnarray+. Vantaggi del +pacchetto: + +\begin{itemize} +\item gli spazi all'interno e intorno agli ambienti sono consistenti; +\item la numerazione delle equazioni è posizionata in modo da non sovrapporsi + mai all'espressione matematica; +\item i nuovi ambienti (ad esempio \texttt{split}) consentono di spezzare + facilmente lunghe equazioni; +\item possono essere definiti con facilità nuovi operatori (analogamente a + \Macro{sin} ecc.) con spaziature più adatte. +\end{itemize} + +\paragraph{Avvertimento} +\label{sec:warnung} +Se si utilizza il pacchetto~\Paket{amsmath} non si dovrebbe \emph{mai} fare +uso degli ambienti \texttt{displaymath}, \texttt{eqnarray} e +\texttt{eqnarray*}, in quanto essi sono incompatibili con \Paket{amsmath} e +così si genererebbero ancora una volta spaziature inconsistenti (cfr. le +Figure~\vrefrange{fig:beisp-fur-texttt}{fig:beisp-fur-texttt-1}). + +Invece l'ambiente \verb+\[...\]+ è correttamente adeguato da \Paket{amsmath} e +può essere usato in luogo di \texttt{displaymath}. Gli ambienti +\texttt{eqnarray} e \texttt{eqnarray*} possono essere sostituiti con una prima +approssimazione rispettivamente da \texttt{align} e \texttt{align*}. Per una +trattazione completa delle possibilità di \Paket{amsmath} si consulti la +documentazione \Doku{amsldoc}~\cite{amsldoc:99}. + +\begin{Ers} +\begin{verbatim} +\begin{eqnarray} + a &=& b\\ + b &=& c\\ + a &=& c +\end{eqnarray} +\end{verbatim} +\end{Ers} +\begin{Dur} +\begin{verbatim} +\begin{align} + a &= b\\ + b &= c\\ + a &= c +\end{align} +\end{verbatim} +\end{Dur} +\begin{figure} + \centering + \begin{minipage}[t]{.45\linewidth} + \begin{eqnarray*} + a &=& b\\ + b &=& c\\ + a &=& c + \end{eqnarray*} + \caption{Esempio per \texttt{eqnarry*}} + \label{fig:beisp-fur-texttt} + \end{minipage}\hfill + \begin{minipage}[t]{.45\linewidth} + \begin{align*} + a &= b\\ + b &= c\\ + a &= c + \end{align*} + \caption{Esempio per \texttt{align*}} + \label{fig:beisp-fur-texttt-1} + \end{minipage} +\end{figure} + +\subsection{L'uso di \texttt{\TB graphicspath}} +\label{sec:die-verwendung-von} +Bisogna\footnote{Questa sezione è stata interamente riscritta dal traduttore.} +premettere che, per motivi di sicurezza relativi soprattutto ma non +esclusivamente a Windows, le più recenti versioni di \TeX{} (sia MiKTeX sia +Tex Live dalla versione 2009) accettano una versione ridotta e protetta +dell'esecuzione del comando \Macro{write18} (che equivale a impartire una +qualche istruzione: l'argomento di \Macro{write18} è cioè interpretato come se +fosse una linea di comando). \TeX{} consente di eseguire pienamente un certo +numero di istruzioni (che riguardano fra gli altri Bib\TeX, epstopdf, ecc.), +ne esegue altre in modo ristretto e infine non ne esegue affatto altre ancora +(come la cancellazione di file), che devono essere autorizzate +dall'utente\footnote{A meno di non eliminare tutte le limitazioni allo stesso +\Macro{write18} indicandolo espressamente nella riga di comando che l'editor +invia al sistema operativo per lanciare comandi come \texttt{pdflatex}: +opzione \texttt{-shell-escape} di TeX Live e opzione \texttt{-enable-write18} +di MiKTeX. Tuttavia in questo caso è necessario essere consapevoli dei rischi +che tale operazione comporta per la sicurezza dell'intero sistema.}. + +Di conseguenza i programmi non possono più usare percorsi assoluti (che cioè +partono dalla radice del disco fisso), ma solo percorsi relativi alla +directory dove risiede il file principale del documento. + +La diffusa macro \Macro{graphicspath}, la cui comodità risiede nel fatto che, +una volta impostata, evita di dover specificare ogni volta la/le directory in +cui si trovano le immagini, dovrebbe essere evitata perché presenta quanto +meno dei limiti: + +\begin{enumerate} +\item la ricerca da parte di \TeX{} del file grafico da elaborare dura più a + lungo rispetto a quando tale ricerca è affidata alla libreria + \texttt{kpathsea }a cui ricorre normalmente \TeX{} per la ricerca dei file, + anche se con gli attuali processori l'aumento di tempo è trascurabile; +\item i nomi dei file specificati senza percorso devono essere accuratamente + distinti in Windows, che non fa distinzione fra lettere minuscole e + maiuscole; questa distinzione deve avere luogo anche se eventuali file + omonimi si trovano in subdirectory diverse. +\end{enumerate} + +Tali problemi non si manifestano se tutti i file grafici si trovano in una +sola subdirectory di quella dove si trova il file principale del documento: +perciò si può continuare a usare \Macro{graphicspath} in tutta sicurezza. Se +invece un documento complesso avesse le sue parti (ad esempio i capitoli) +collocate nelle proprie rispettive subdirectory e se ogni parte conservasse a +sua volta le proprie immagini in una subsubdirectory, la situazione si +presenterebbe molto confusa e inutilmente complicata rispetto a quello che si +potrebbe avere includendo ogni file grafico speficandone il nome completo di +percorso e di estensione\footnote{Prima del 2009 veniva consigliato di non +specificare l'estensione, perché \texttt{latex} e \texttt{pdflatex} potevano +includere file grafici di formato mutuamente esclusivo; quindi era possibile +che nella stessa cartella una certa immagine fosse presente sia in formato +\texttt{.eps} sia in formato \texttt{.pdf}. Anche senza specificare +l'estensione e senza modificare il file sorgente, \texttt{latex} avrebbe +incorporato il file \texttt{.eps} mentre \texttt{pdflatex} il file +\texttt{.pdf}. Poiché attualmente anche \texttt{pdflatex} può incorporare file +in formato \texttt{.eps}, questo modo di procedere non ha più ragione +d'essere, anzi può risultare dannoso}. + +Il motivo per cui la ricerca del file grafico dura più a lungo usando +\Macro{graphicspath} discende dal fatto che \TeX{} conserva al suo interno una +lista di percorsi specificati con questo comando. In un documento complesso, +con molti capitoli che richiedano a loro volta percorsi diversi per le loro +figure, la ricerca avviene scandendo ricorsivamente tutti i percorsi contenuti +in quella lista e ricercando in ogni cartella specificata da ciascuno di +questi percorsi. Invece se si specifica ogni file grafico con il suo percorso +\TeX{} non deve ricercare nulla, ma punta al file specifico in quanto il nome +completo del file è univoco. + +Egualmente problematico appare il ricorso alla variabile di ambiente +\texttt{TEXINPUTS}\footnote{Cfr. Risposta di David Carlisle al «Bug-Report» di +Markus Kohm: +\url{http://www.latex-project.org/cgi-bin/ltxbugs2html?pr=latex/2618}}. +Questa variabile può essere impostata nelle modalità proprie dei vari sistemi +operativi. Benché si tratti più di un'aggiunta che di una modifica vera e +propria del percorso di sistema, essa è comunque permanente e pertanto andrà +modificata per ogni nuovo documento (oltre al fatto che in vecchie versioni di +Windows non esista la possibilità di avere distintamente una variabile +\texttt{TEXINPUTS} di sistema e una di utente). + +Il metodo maggiormente sicuro ed efficiente (valido anche per +\Macro{graphicspath}) consiste allora nel definire dei link simbolici mediante +i classici comandi \texttt{ln -s} per i sistemi UNIX e \texttt{mklink} in +Windows Vista o in Windows 7 (questo procedimento è irrealizzabile nelle +precedenti versioni di Windows, che non conoscono i link simbolici). A +differenza di quanto accadeva con \texttt{TEXINPUTS}, tali link, in quanto +locali, non apportano nessuna modifica ai percorsi di sistema. Grazie a essi +nella/e directory del documento risultano (virtualmente) presenti, dovunque +siano fisicamente collocate all'interno del disco fisso, le directory delle +immagini, che dunque sono individuabili da \Macro{write18} parzialmente +abilitato. + +È sempre opportuno consultare la documentazione del sistema operativo e della +distribuzione \TeX{} utilizzati. + +\subsection{Le macro \texttt{\TB...name}} +\label{sec:die-macroname-makros} +Poiché in \News{de.comp.text.tex} si domanda di tanto in tanto come si possa +modificare a esempio «Bibliografia» in «Elenco delle fonti», nella +Tabella~\vref{tab:von-paketng-btw} sono indicate le macro (italiane) +corrispondenti. Più precisamente, esse sono tratte dai file +\textsf{italian.ldf} per \Paket{babel} e \textsf{gloss-italian.ldf} per +\Paket{polyglossia}. + +Ad esempio, per rinominare l'«Elenco delle figure» come «Figure», si adotti +il comando seguente: + +\begin{verbatim} +\renewcommand*{\listfigurename}{Figure} +\end{verbatim} + +Le altre macro si possono rinominare in modo analogo. Se si adotta +\Paket{babel} è opportuno operare con \Macro{addto}. Infatti a ogni +reimpostazione della lingua (nel nostro caso l'italiano) viene reiterato il +comando \Macro{captionsitalian}: la personalizzazione andrebbe così persa e +reintrodotto il termine di default. Il comando \Macro{addto} è definito in +\Paket{babel}, ma si può applicare anche a \Paket{polyglossia} prestando però +attenzione a caricare in aggiunta \Paket{etoolbox} o simili. Cfr. anche le +\Doku{De-TeX-FAQ} su questo tema\footnote{«I miei tentativi di ridefinire +\Macro{figurename}, \Macro{tablename} e simili con l'utilizzo del pacchetto +\Paket{babel} falliscono. Che cosa posso fare?» in +\url{http://projekte.dante.de/DanteFAQ/Verschiedenes}}. + +La scrittura corretta è pertanto: + +\begin{verbatim} +\addto{\captionsitalian}{% + \renewcommand*{\listfigurename}{Figure}} +\end{verbatim} + +A chi adotta \KOMAScript{} raccomandiamo di usare l'equivalente comando\\ +\Macro{renewcaptionname}: + +\begin{verbatim} +\renewcaptionname{italian}{\listfigurename}{Figure} +\end{verbatim} + +Questo comando dev'essere dato dopo \verb+\begin{document}+. + +\begin{table} + \begin{minipage}{\textwidth} + \renewcommand{\footnoterule}{} + \centering + \caption{Le macro definite da \Paket{babel} e \Paket{polyglossia} con + l'opzione \Option{italian}} + \label{tab:von-paketng-btw} + \begin{tabular}{@{}lll@{}} + \toprule + \multicolumn{1}{@{}N}{Nome della macro} & + \multicolumn{1}{N}{Definizione originale} & + \multicolumn{1}{N@{}}{Resa italiana} \\ + \cmidrule(r){1-1}\cmidrule(lr){2-2}\cmidrule(l){3-3} + \Macro{prefacename} & Preface & Prefazione \\ + \Macro{refname}\footnote{Solo nella classe \texttt{article}.} + & References & Riferimenti bibliografici \\ + \Macro{abstractname} & Abstract & Sommario \\ + \Macro{bibname}\footnote{Solo nelle classi \texttt{report} e \texttt{book}.} + & Bibliography & Bibliografia \\ + \Macro{chaptername} & Chapter & Capitolo \\ + \Macro{appendixname} & Appendix & Appendice \\ + \Macro{contentsname} & Contents & Indice \\ + \Macro{listfigurename} & List of Figures & Elenco delle figure \\ + \Macro{listtablename} & List of Tables & Elenco delle tabelle \\ + \Macro{indexname} & Index & Indice analitico \\ + \Macro{figurename} & Figure & Figura \\ + \Macro{tablename} & Table & Tabella \\ + \Macro{partname} & Part & Parte \\ + \Macro{enclname} & encl & Allegati \\ + \Macro{ccname} & cc & e~p.~c. \\ + \Macro{headtoname} & To & Per \\ + \Macro{pagename} & Page & Pag. \\ + \Macro{seename} & see & vedi \\ + \Macro{alsoname} & see also & vedi anche \\ + \Macro{proofname} & Proof & Dimostrazione \\ + \Macro{glossaryname} & Glossary & Glossario \\ + \bottomrule + \end{tabular} + \end{minipage} +\end{table} + +\clearpage +\appendix + +\section{Esempio di \texttt{\TB sloppy}} +\label{sec:beispiel-zu-sloppy} +Questo è il codice di esempio che Markus Kohm ha pubblicato in +\News{de.comp.text.tex}: + +\begin{bspcode}{\MID{8557097.gEimXdBtjU@ID-107054.user.dfncis.de}{8557097.gEimXdBtjU@ID-107054.user.dfncis.de}}% +\small +\begin{verbatim} +\documentclass{article} + +\setlength{\textwidth}{20em} +\setlength{\parindent}{0pt} +\begin{document} +\typeout{First without \string\sloppy\space and underfull \string\hbox} + +tatata tatata tatata tatata tatata tatata ta\-ta\-tata +tatata tatata tatata tatata tatata tatata tata\-tata +tatata tatata tatata tatata ta\-tatatatt\-ta +tatata tatata tatata tatata tatata tatata ta\-ta\-ta\-ta + +\typeout{done.} + +\sloppy +\typeout{Second with \string\sloppy\space and underfull \string\hbox} + +tatata tatata tatata tatata tatata tatata ta\-ta\-tata +tatata tatata tatata tatata tatata tatata tata\-tata +tatata tatata tatata tatata ta\-tatatatt\-ta +tatata tatata tatata tatata tatata tatata ta\-ta\-ta\-ta + +\typeout{done.} +\end{document} +\end{verbatim} +\end{bspcode} + +\clearpage +\phantomsection +\addcontentsline{toc}{section}{\refname} +\raggedright + +\begin{thebibliography}{99} +\bibitem{amsldoc:99} + American Mathematical Society, + \emph{User's Guide for the {\texttt{amsmath}} Package}, + versione~2.0, + febbraio~2002 + (\texdoc{amsmath}). + \biburl{CTAN://macros/latex/required/amslatex/} + +\bibitem{graphicx:05} + Carlisle, David\,P. e The \LaTeX3 Project, + \emph{Packages in the `graphics' bundle}, + novembre 2005 + (\texdoc{graphicx}). + \biburl{CTAN://macros/latex/required/graphics/} + +\bibitem{kohm:10} + Kohm, Markus e Morawski, Jens-Uwe, + \emph{\KOMAScript, a versatile \LaTeXe{} bundle}, + versione~3, + maggio~2011 + (\texdoc{scrguien}). + \biburl{CTAN://macros/latex/supported/koma-script/} + +\bibitem{clsguide:06} + The \LaTeX3 Project, + \emph{\LaTeXe{} for class and package writers}, + febbraio 2006 + (\texdoc{clsguide}). + \biburl{CTAN://macros/latex/doc/clsguide.pdf} + +\bibitem{fntguide:05} + \LaTeX3 Project Team, + \emph{\LaTeXe{} font selection}, + novembre 2005 + (\texdoc{fntguide}). + \biburl{CTAN://macros/latex/doc/fntguide.pdf} + +\bibitem{usrguide:05} + \LaTeX3 Project Team, + \emph{\LaTeXe{} for authors}, + novembre 2005 + (\texdoc{usrguide}). + \biburl{CTAN://macros/latex/doc/usrguide.pdf} + +\bibitem{eulervm:05} + Schmidt, Walter, + \emph{The Euler Virtual Math Fonts for use with \LaTeX{}}, + versione~4, + gennaio 2005 + (\texdoc{eulervm}). + \biburl{CTAN://fonts/eulervm/} + +\bibitem{upgreek:03} + Schmidt, Walter, + \emph{The {\textsf{upgreek}} package for \LaTeXe{}}, + versione~2.0, + febbraio~2003 + (\texdoc{upgreek}). + \biburl{CTAN://macros/latex/contrib/upgreek/} + +\bibitem{psnfss:04} + Schmidt, Walter, + \emph{Using common PostScript fonts with \LaTeX{}}, + \acr{psnnfss} versione~9.2, + settembre 2004 + (\texdoc{psnfss2e}). + \biburl{CTAN://macros/latex/required/psnfss/psnfss2e.pdf} + +\bibitem{l2kurz:03} + Schmidt, Walter, Knappen, Jörg, Partl, Hubert e Hyna, Irene, + \emph{\LaTeXe{}-Kurzbeschreibung}, + versione~2.3, + aprile~2003 + (\texdoc{l2kurz2}). + \biburl{CTAN://info/lshort/german/} + +\bibitem{caption:08} + Sommerfeldt, Axel, + \emph{Anpassen der Abbildungs- und Tabellenbeschriftungen mit Hilfe des + caption-Paketes}, + versione~3.2e, + novembre~2011 + (\texdoc{caption-deu}). + \biburl{CTAN://macros/latex/contrib/caption/}\\ + Disponibile allo stesso indirizzo anche nella versione inglese + \emph{Customizing captions of floating environments using the caption + package}. + +\bibitem{glossaries:11} + Talbot, Nicola~L.\,C., + \emph{Upgrading from the glossary package to the glossaries package}, + aprile~2011 + (\texdoc{glossary2glossaries}). + \biburl{CTAN://macros/latex/contrib/glossaries/glossary2glossaries.pdf} + +\end{thebibliography} +\end{document} diff --git a/info/l2tabu/spanish/README b/info/l2tabu/spanish/README new file mode 100644 index 0000000000..2ba8bd09c1 --- /dev/null +++ b/info/l2tabu/spanish/README @@ -0,0 +1,6 @@ +This directory contains the Spanish version of l2tabu. The files +l2tabues.tex and l2tabues.pdf are included. + +This material is Public Domain. + +Gonzalo Medina
\ No newline at end of file diff --git a/info/l2tabu/spanish/l2tabues.pdf b/info/l2tabu/spanish/l2tabues.pdf Binary files differnew file mode 100644 index 0000000000..82b26c767f --- /dev/null +++ b/info/l2tabu/spanish/l2tabues.pdf diff --git a/info/l2tabu/spanish/l2tabues.tex b/info/l2tabu/spanish/l2tabues.tex new file mode 100644 index 0000000000..0c7d8048ec --- /dev/null +++ b/info/l2tabu/spanish/l2tabues.tex @@ -0,0 +1,1022 @@ +% -*- modo: LaTeX; codifiación: utf8 -*- +%%%------------------------------------------------------------------ +%%% Filename: l2tabu.tex +%%% Author: Mark Trettin <Mark.Trettin@gmx.de> +%%% Created: 17 Feb 2003 19:01:58 +%%% Time-stamp: <2004-06-17 08:36:16 yvon>Por favor +%%% Version: $Id: l2tabu.tex,v 1.7 2004/02/07 14:53:39 mark Exp $ +%%% +%%% Copyright (C) 2003 by Mark Trettin +%%%------------------------------------------------------------------ +%%% TODO: +%%% - \input{../asdf/} anstelle von \input ../asdf/ +%%%------------------------------------------------------------------ +%%% Filename: l2tabues.tex para la traducción al español **** +%%% translator: Gonzalo Medina **** +%%% version 1.1 **** +%%%------------------------------------------------------------------ + +\documentclass[11pt,a4paper,pagesize,tablecaptionabove,abstracton,pointlessnumbers]{scrartcl} +%--------------- Configuración Básica (Español, 8bit) ---------------- +\usepackage[spanish,activeacute]{babel} % Españolización +\usepackage[utf8]{inputenc} % Entrada directa de tildes, etc. +\usepackage[T1]{fontenc} % Fuentes T1 +\usepackage{mathptmx} % Times/Maths \rmdefault +\usepackage[scaled=.90]{helvet} % Helvetica resucido \sfdefault +\usepackage{courier} % Courier \ttdefault +\newcommand{\TimesRant}{Ah s\'i (me adelanto a cualquier cr\'itica), he utilizado Times/Helvetica\footnote{Acrobat Reader lo identifica como Arial.}/Courier, pero \'unicamente para reducir al m\'aximo la extensi\'on de este documento. \texttt{;-)}} + +\usepackage{multicol} + +\typearea[current]{current} % calcular el área de texto (typearea) +%------------ Paquetes adicionales (gráficas, cuadros) --------------- +\usepackage{xspace} % espacios después de los comandos +\usepackage{booktabs,array} % cuadros mejorados +\usepackage[spanish]{varioref} % modifyed for the version publicised + % as current versionf of fancy, and + % varioref do not work together + % (still not?!) +\usepackage{textcomp} % caracteres adicionales +\usepackage[nofancy]{rcsinfo} % Información RCS en el tÃtulo +\usepackage{enumerate} +\usepackage{fancyvrb} % para usar \verb en un pie de página +\usepackage{calc} % para calcular +\usepackage{eurosans} % el Euro +%--------------------------- Formato --------------------------- +%%% Rótulos (captions) +\setkomafont{caption}{\normalcolor\small\sffamily\slshape} +\setkomafont{captionlabel}{\normalcolor\upshape\small\sffamily\bfseries} +%--------------------------- Opciones para PDF --------------------------- +\ifpdfoutput{% % requiere una clase KOMA-Script + \usepackage{hyperref} % configuración de hyperref para pdf + \hypersetup{% + pdfauthor={(c) 2007 Gonzalo Medina},% + pdftitle={l2tabusp -- Una guia esencial para el uso de \LaTeXe},% + pdfsubject={Algunos consejos para el uso de LaTeX2e},% + bookmarksopen=true,% Temp + backref=true,% + pdffitwindow=true,% + pdfpagelayout=OneColumn,% + colorlinks=true,% + linkcolor=red,% + linktocpage=true,% + backref=true,% + pdfstartview=FitH,% + bookmarksopen=true,% + bookmarksopenlevel=2,% + bookmarksnumbered=false,% + urlcolor=blue% + }% + \usepackage[activate=normal]{pdfcprot} % character protruding using pdftex + \newcommand{\EMail}[1]{\href{mailto:#1?Subject=[l2tabu.pdf]}{email: \texttt{#1}}} + \newcommand{\News}[1]{\href{news:#1}{\texttt{#1}}} + \newcommand{\MID}[2]{\href{http://groups.google.com/groups?as_umsgid=#1}% + {Message-ID: \texttt{<#2>}}} + % \usepackage{color} % Para vista preliminar-latex + }% +%--------------------------- Opciones para PS ---------------------------- + {% + \usepackage{hyperref} + \newcommand{\EMail}[1]{\href{mailto:#1}{Email: \texttt{#1}}} + \newcommand{\News}[1]{\href{news:#1}{\texttt{#1}}} + \newcommand{\MID}[2]{\href{M-ID: <#1>}{Message-ID: \texttt{<#2>}}} + } +\usepackage{xcolor} % +%-------------------------- Nuevos comandos -------------------------- +%%% documentación: SansSerif +\newcommand{\gl}{\guillemotleft} +\newcommand{\gr}{\guillemotright} +\newcommand{\qd}{\textquestiondown} +\newcommand{\TB}{\textbackslash} +\newcommand{\Doku}[1]{\textsf{#1}\xspace} +%%% Paket ,Klasse, Bibstil (paquetes, clases, estilo bib): SansSerif, Slanted +%\newcommand{\Paket}[2][sty]{\textsf{\textsl{#2.#1}}\xspace} +\newcommand{\Paket}[1]{\textsf{\textsl{#1.sty}}\xspace} +\newcommand{\Klasse}[1]{\textsf{\textsl{#1.cls}}\xspace} +\newcommand{\Bst}[1]{\textsf{\textsl{#1.bst}}\xspace} +%%% Opciones: SansSerif +\newcommand{\Option}[1]{\textsf{#1}\xspace} +%%% \Use{graphicx} --> \usepackage{graphicx} +%%% \UseO{dvips}{graphicx} --> \usepackage[dvips]{graphicx} +\newcommand{\Use}[1]{\texttt{\textbackslash usepackage\{#1\}}} +\newcommand{\UseO}[2]{\texttt{\TB usepackage[#1]\{#2\}}} +\newcommand{\UseV}[2]{\texttt{\TB usepackage\{#1\}[#2]}} +\newcommand{\UseOV}[3]{\texttt{\TB usepackage[#1]\{#2\}[#3]}} +%%% Pies de página +\deffootnote{2.5em}{1em}{\thefootnotemark\ \ \ }% +\setlength{\footnotesep}{12pt} +%%% No utilizar frenchspacing +\nonfrenchspacing +%%% BibliografÃa +\newcommand{\Bib}[1]{\texttt{\textbackslash bibliographystyle\{#1\}}} +%%% entorno TODO: redefinir, se ve no muy correcto +\newcommand{\Env}[2]{\raggedright\texttt{\textbackslash begin\{#1\}\\ + #2\\ \textbackslash end\{#1\}}} +%%% \newcommand +\newcommand{\NewCom}[3][]{\texttt{\textbackslash newcommand{#1}\{\textbackslash#2\}\{#3\}}} +\newcommand{\ReNewCom}[3][]{\texttt{\textbackslash renewcommand{#1}\{\textbackslash#2\}\{#3\}}} +%%% Tomado de scrguide ;-) +\DeclareRobustCommand*{\Macro}[1]{\mbox{\texttt{\char`\\#1}}} +\DeclareRobustCommand*{\LMacro}[2]{\mbox{\texttt{\char`\\#1\{#2\}}}} +\DeclareRobustCommand*{\GMacro}[2]{\mbox{\texttt{\{\char`\\#1\ #2\}}}} +% DANTE +\providecommand{\CTANserver}{ftp.dante.de} +% Hacer de CTAN:// un alias de ftp://\CTANserver/tex-archive/ +\makeatletter +\def\url@#1{\expandafter\url@@#1\@nil} +\def\url@@#1://#2\@nil{% + \def\@tempa{#1}\def\@tempb{CTAN}\ifx\@tempa\@tempb + \hyper@linkurl{\Hurl{#1:#2}}{ftp://\CTANserver/tex-archive/#2}% + \else + \hyper@linkurl{\Hurl{#1://#2}}{#1://#2}% + \fi +} +\makeatother +%%% Colores +\definecolor{gruen}{rgb}{0,0.55,0} +\definecolor{rot}{rgb}{1,0,0} +\newcommand{\FIXME}[1]{\marginline{FIXME: #1!}} +\newsavebox{\Quelle} + +\newenvironment{bspcode}[1]{% + \sbox{\Quelle}{\footnotesize Fuente: #1} + \center + \rule{\linewidth}{1.5pt} +}{% + \rule{\linewidth}{1.5pt} + \usebox{\Quelle} + \endcenter% +} + +%%% Comandos para remplazar FIXME: +\newcommand{\Ersetze}[2]{\par\noindent Remplace: \textcolor{red}{#1} + con \textcolor{gruen}{#2}} +\newcommand{\Ersetzx}[3][.5\textwidth]{% + \par\noindent% + \begin{minipage}[t]{#1} + \raggedright + Remplace:\\ + \textcolor{rot}{#2} + \end{minipage}% + \hfill% + \begin{minipage}[t]{(\linewidth - #1)-.02\linewidth} + \raggedright + con\\ + \textcolor{gruen}{#3} + \end{minipage}% +} +% Ancho de los comandos "Ersetze" :-( +\newsavebox{\Breite} +%%% Un hack de Heiko Oberdiek para acroread bajo Linux +\pdfstringdefDisableCommands{% + \edef\quotedblbase{\string"}% + \edef\textquotedblleft{\string"}% +} +%%% Un hack bastante rudimentario para escribir una URL en una sola +%%% lÃnea *sin* espacios adicionales. :-( +\newcommand{\biburl}[1]{\hfill\\URL:~\url{#1}} +%------------------- Definición de columnas en los cuadros --------------- +% needs array +\newcolumntype{v}[1]{>{\raggedright\hspace{0pt}}p{#1}} % v column, como + % p column, pero + % justificado a derecha +\newcolumntype{V}[1]{>{\footnotesize\raggedright\hspace{0pt}}p{#1}} +\newcolumntype{N}{>{\footnotesize}l} +\newcolumntype{C}{>{\footnotesize}c} + + +%%% ------------- Comandos para la traducción al español ------------- + +\newcommand{\NDT}{[N.~del~T.]} +\SaveVerb{ejemplo}=p'etalo= + +%----------------------------- TÃtulo ------------------------------ +\title{Una gu\'ia esencial para el correcto uso de \LaTeXe\\[1em] + \LARGE\mdseries\rmfamily Paquetes y comandos obsoletos} + +\author{Versi\'on original en alem\'an\\ + de Mark Trettin\thanks{\EMail{Mark.Trettin@gmx.de}}% + \and + Traducci\'on al espa~nol\\ + de Gonzalo Medina\thanks{\EMail{gmedinaar@unal.edu.co}}.} + + +\date{\today} + +% \rcsInfoRevision\ \\ +% \rcsInfoLongDate} +%----------------------- Comienzo del documento ----------------------- +\begin{document} +%\begin{Form}\end{Form} +\pagestyle{headings} +%%% RCS Info para control de la versión +%\rcsInfo $Id: l2tabues.tex,v 1.1 2007/12/07 00:00:00 gmedina Exp $ +\maketitle +\begin{abstract} + \noindent + \emph{Esta es la versi'on en espa~nol de l2tabu.} Al leer el foro germano-parlante\footnote{\News{de.comp.text.tex}} dedicado a \TeX\ he encontrado numerosas discusiones sobre paquetes y comandos obsoletos o \gl inapropiados\gr. Por esta raz'on decid'i escribir esta peque~na introducci'on al uso pr'actico y correcto de \LaTeX\ en la que intento mostrar los errores m'as comunes en la utilizaci'on de \LaTeX\ y brindo algunas sugerencias para evitar cometerlos. + Esta gu'ia no pretende en modo alguno remplazar otros documentos introductorios como \Doku{lshort}~\cite{l2kurz:99} o \Doku{De-TeX-FAQ}~\cite[version 72]{faq:02} o incluso \Doku{UK FAQ}~\cite[version 3.9]{ukfaq:99}. + + Sus sugerencias y comentarios ser'an bienvenidos. \TimesRant +\end{abstract} + +%%% Copyright +{\setlength{\parindent}{0pt} + \footnotesize +\vfill +Copyright \copyright{} 2003, 2004, 2007 de Mark Trettin y Gonzalo Medina. +\medskip + +This material may be distributed only subject to the terms and conditions set +forth in the \emph{Open Publication License}, v1.0 or later (the latest +version is presently available at \url{http://www.opencontent.org/openpub/}). + +Este material puede ser distribu'ido solamente bajo los t'erminos y condiciones definidos en \emph{Open Publication License} versi'on 1.0 o posterior (la versi'on m'as reciente de esta licencia est'a disponible en\\ \url{http://www.opencontent.org/openpub/}). + +\bigskip + +%% Agradecimientos +Deseo agradecer a +Christoph Bier, +Christian Faulhammer, +Jürgen Fenn\footnote{Traducci'on al ingl'es: \url{CTAN://info/l2tabu/english/l2tabuen.pdf}}, +Yvon Henel\footnote{Traducci'on al franc'es: \url{CTAN://info/l2tabu/french/l2tabufr.pdf}}, +Yvonne Hoffmuller, +David Kastrup, +Markus Kohm, +Thomas Lotze, +Frank Mittelbach, +Heiko Oberdiek, +Walter Schmidt, +Stefan Stoll, +Emanuele Zannarini\footnote{Traducci'on al italiano: \url{CTAN://info/l2tabu/italian/l2tabuit.pdf}}, +Gonzalo Medina\footnote{Traducci'on al espa~nol: \url{CTAN://info/l2tabu/spanish/l2tabues.pdf}} +y a +Reinhard Zierke +por sus sugerencias, comentarios y correcciones. + +Por favor enviar sus comentarios sobre la versi'on en espa~nol directamente a \EMail{gmedinaar@unal.edu.co}. +Si he olvidado mencionar a alguna persona que haya contribuido a este documento, por favor, enviarme un correo.}\par + +\clearpage +\tableofcontents +\enlargethispage{\baselineskip} +\clearpage + +%----------------------- sección "Pecados capitales" ------------------------ +\section{\gl Pecados Capitales\gr} + +\label{sec:todsunden} +En esta secci'on he agrupado algunos de los peores errores que reiterativamente aparecen en el grupo de discusi'on \News{de.comp.text.tex}; errores que hacen que los usuarios regulares de este grupo estallen en c'olera o lloren a m'as no poder. \texttt{;-)} + +\subsection{\Paket{a4}, \Paket{a4wide}} +\label{sec:paketa4-paketa4wide} + +Estos \gl dos\gr\ paquetes no deben usarse. Deben eliminarse, sin pensarlo dos veces, de sus archivos fuentes de \LaTeX; en su lugar, debe utilizarse la opci'on \Option{a4paper}. Tipogr'aficamemente, estos paquetes (u otros semejantes) producen dise~nos de p'agina poco apropiados. Peor a'un, existen diversas versiones de estos paquetes, incompatibles entre s'i, que producen resultados inconsistentes en la marginaci'on. La utilizaci'on de estos paquetes no permite garantizar, por lo tanto, que su documento tenga el mismo (\qd mal?) aspecto al ser compilado en distintos sistemas. + +\Ersetze{\Paket{a4}, \normalcolor o \color{red} \Paket{a4wide}}{opci'on de clase \Option{a4paper}} + +\subsection{C'omo cambiar el dise~no de la p'agina} +\label{sec:layoutanderungen} +Las m'argenes de las clases est'andar (\Klasse{article}, \Klasse{report}, \Klasse{book}) son demasiado anchas para impresi'on en formato A4 (cr'itica frecuente entre algunos usuarios, particularmente los europeos). En este caso deben utilizarse las clases \Klasse{scrartcl}, \Klasse{scrreprt} y \Klasse{scrbook} de la colecci'on \KOMAScript{} . Estas clases se crearon teniendo en cuenta el punto de vista tipogr'afico europeo. Otra opci'on es utilizar el paquete \Paket{typearea} que es parte de \KOMAScript{}. La documentaci'on incluida en el paquete brinda informaci'on adicional. De hecho, este documento se escribi'o utilizando la clase \Klasse{scrartcl}. + +Si es indispensable utilizar m'argenes diferentes de las obtenidas con el paquete \Paket{typearea} entonces han de usarse los paquetes \Paket{geometry} o \Paket{vmargin} ya que 'estos producen proporciones razonables al ajustar las m'argenes de la p'agina. Para cambiar el dise~no de la p'agina, \emph{no} debe modificarse el comando \Macro{oddsidemargin} u otros semejantes. + +Bajo ninguna circunstancia deben modificarse \Macro{hoffset} o \Macro{voffset}, +a menos que realmente se entienda la manera en que \TeX{} se comportar'a frente a estos cambios. + +\subsection{Modificaci\'on de paquetes y clases} +\label{sec:ander-von-paket} +Los archivos de clase \LaTeX{} (por ejemplo, \Klasse{article}, \Klasse{scrbook}) jam'as deben modificarse directamente as'i como tampoco los paquetes (archivos de estilo, por ejemplo, \Paket{varioref}, \Paket{color}). Si no se desea crear una \gl clase contenedora\gr, ni un archivo \texttt{.sty} propio, el camino a seguir es \emph{copiar} la clase o el archivo de estilo, editar \emph{la copia} y guardarla como un archivo \emph{diferente}, escogiendo un nombre distinto al original. + +Para crear una clase contenedora, v'ease \Doku{De-TeX-FAQ}~\cite[pregunta 5.1.5]{faq:02}. + +\paragraph{Sugerencia.} +\label{sec:hinweis} + +Todo archivo o paquete adicional deber'a instalarse en el 'arbol \texttt{texmf} local de su directorio \texttt{\$HOME}. De lo contrario, estos cambios se perder'an al realizar una actualizaci'on de su distribuci'on \TeX{}. Aquellos archivos de estilo o paquetes que vayan a ser utilizados exclusivamente en un proyecto en particular o aquellos que deban compartirse al trabajar en un proyecto com'un pueden ser guardados tambi'en en el directorio actual de trabajo. V'ease \Doku{De-TeX-FAQ}~\cite[pregunta 5.1.4]{faq:02} o \Doku{UK FAQ}\cite[\textit{Installing \LaTeX{} files}, secci'on K, \textit{Where to put new files}, pregunta 90]{ukfaq:99}. + +\subsection{Cambios al interlineado modificando \texttt{\textbackslash + baselinestretch}} +\label{sec:ander-des-zeil} + +Siguiendo una buena regla pr'actica, los par'ametros relativos a un documento deben modificarse al nivel \gl m'as alto posible\gr\ dentro de la interfaz del usuario. Las modificaciones al interlineado pueden realizarse en tres niveles: +\begin{enumerate} + \item Bien sea mediante el paquete \Paket{setspace} + \item o utilizando el comando \LMacro{linespread}{<factor>} + \item o redefiniendo \Macro{baselinestretch}. +\end{enumerate} +La redefinici'on de par'ametros tales como \Macro{baselinestretch} se realiza al nivel m'as bajo de \LaTeX{}, por lo que es conveniente dejar que un paquete se encargue de la modificaci'on. El comando \Macro{linespread} fue creado con el fin de permitir modificaciones al interlineado y, por lo tanto, es una alternativa mejor que la soluci'on anterior. La soluci'on ideal, sin embargo, es la utilizaci'on del paquete \Paket{setspace} que se encarga de conservar el interlineado en los pies de p'agina y en las listas (interlineado que usualmente no se desea modificar). + +La manera m'as sencilla de obtener un interlineado doble o 1.5 es por medio del paquete \Paket{setspace}. Sin embargo, se puede utilizar \LMacro{linespread}{<factor>} si tan solo se desea utilizar una fuente distinta a Computer Modern. Por ejemplo, es conveniente utilizar \LMacro{linespread}{1.05} si se quiere usar la fuente Palatino. + +\subsection{La sangr'ia y la separaci'on entre p'arrafos: \texttt{\textbackslash{}parindent} y \texttt{\textbackslash{}parskip}} +\label{sec:absatz-und-abst} + +Puede que sea necesario cambiar la sangr'ia\footnote{Espacio adicional que se utiliza para se~nalar la primera l'inea de un p'arrafo}(\Macro{parindent}). En caso de ser asÃ, deben seguirse las siguientes recomendaciones: +\begin{itemize} + \item Nunca se deben utilizar longitudes absolutas (por ejemplo, \gl mm\gr) para modificar la sangr'ia. Siempre se deben usar longitudes que dependan del tama~no de la fuente como, por ejemplo, \gl em\gr. Esto 'ultimo \emph{no} significa que al cambiar la sangr'ia, se modificar'a autom'aticamente el el tama~no de la fuente, sino m'as bien que al variar el tama~no de la fuente se obtendr'a una sangr'ia compatible con el nuevo tama~no. + \item Siempre deben usarse comandos \LaTeX{}. De esta manera ser'a m'as f'acil el an'alisis sint'actico\footnote{En ingl'es, \textit{parse} \NDT} de los archivos \LaTeX{} por medio de un programa externo o \textit{script}. As'i el c'odigo de su documento ser'a m'as f'acil de leer y de corregir y se evitar'an problemas de compatibilidad con otros paquetes (por ejemplo, \Paket{calc}). + \Ersetze{\Macro{parindent}\texttt{=1em}}{\LMacro{setlength}{\Macro{parindent}}\{1em\}} +\end{itemize} +% +Si para evidenciar el inicio de un nuevo p'arrafo se prefiere utilizar espacio adicional en lugar de usar la sangr'ia, \emph{no} debe utilizarse +\color{red} +\begin{verbatim} +\setlength{\parindent}{0pt} +\setlength{\parskip}{\baselineskip} +\end{verbatim} +\normalcolor +% +El par'ametro \Macro{parskip} no debe modificarse ya que tambi'en afectar'a los entornos de listas, la tabla de contenidos, los encabezados, etc. + +El paquete \Paket{parskip} as'i como las clases incluidas en la colección \KOMAScript\ +permiten, hasta cierto punto, evitar estos efectos secundarios. Para consultar c'omo utilizar estas opciones (\Option{parskip}, \Option{halfparskip}, etc.)\ de las clases \KOMAScript{} v'ease \Doku{scrguien}~\cite{kohm:03}. Cuando se utiliza alguna de las clases del paquete \KOMAScript{} \emph{no} es necesario cargar el paquete \Paket{parskip}. + +\subsection{Separaci'on de las f'ormulas matem'aticas del texto normal utilizando \texttt{\$\$\dots\$\$}} +\label{sec:abges-form-mit} + +!`Nunca debe utilizarse \texttt{\$\$\dots\$\$}! Este comando pertenece a Plain \TeX{} y su uso producir'a alteraciones en el espaciamiento vertical al interior de las f'ormulas ocasionando inconsistencias. Esta es la raz'on por la que no debe ser utilizado en \LaTeX{} (ver secci'on~\vref{sec:mathematiksatz}; n'otese la advertencia al respecto del uso conjunto de \texttt{displaymath} y del paquete \Paket{amsmath}). Adicionalmente, el uso de \texttt{\$\$\dots\$\$} har'a que la opci'on de clase \Option{fleqn} no tenga efecto. + +\Ersetze{\texttt{\$\$\dots\$\$}}{% +\parbox[t]{.3\textwidth}{% +\Macro{[}\texttt{\dots}\Macro{]}\\ +\textcolor{black}{o}\\ +\Env{displaymath}{\dots}}} + +\subsection{\texttt{\textbackslash def} versus \texttt{\textbackslash newcommand}} +\label{sec:def-vs.-newcommand} + +\emph{Siempre} debe utilizarse \NewCom{<nombre>}{\dots}\footnote{V'eanse \cite[secci'on 2.7.2]{clsguide}, \cite[secci'on 3.4]{usrguide}.} para definir nuevos comandos. + +\emph{Nunca} debe usarse \Macro{def}\LMacro{<nombre>}{\dots}. El problema pricipal con \Macro{def} es que al usarlo no se realiza ninguna verificaci'on para determinar la existencia de otro comando con el mismo nombre y, por lo tanto, un comando definido previamente puede ser remplazado sin aviso alguno. Los comandos ya existentes deben redefinirse con \ReNewCom{<nombre>}{\dots}. + +Si se utiliza \Macro{def} sabiendo \emph{por qu'e} se debe usar, probablemente se tiene plena consciencia del pro y el contra de este comando; en este caso, se puede hacer caso omiso de lo dicho en esta subsecci'on. + +\subsection{El uso de \texttt{\textbackslash sloppy}} +\label{sec:verw-von-textttt} + +Francamente hablando, el comando \Macro{sloppy} \emph{no} debe ser usado indiscriminadamente en parte alguna del documento y, con mayor raz'on, su uso debe evitarse en el pre'ambulo de un documento. Para solucionar problemas debidos a un salto de l'inea indeseado en un p'arrafo dado, se deben seguir los siguientes pasos: + +\begin{enumerate} + \item Verificar que hayan sido cargados los patrones correctos de separaci'on sil'abica (\Paket{babel} con opci'on \Option{spanish}) y las fuentes T1 (v'ease \Doku{De-TeX-FAQ}\cite[secci'on 5.3]{faq:02}) o \Doku{UKFAQ}\cite[\textit{Hyphenation}, secci'on Q.7]{ukfaq:99}. + + \item Reformular el texto utilizando otras palabras. No necesariamente se debe modificar la frase en que aparece el problema; puede ser suficiente cambiar la frase siguiente o la anterior. + + \item Modificar levemente algunos de los par'ametros que controlan la manera en que \TeX{} produce los saltos de l'inea y de p'agina. Axel Reichert ha sugerido en el grupo de discusi'on \News{de.comp.text.tex}\footnote{El mensaje original puede encontrarse en\\ \MID{a84us0$plqcm$7@ID-30533.news.dfncis.de}{a84us0\$plqcm\$7@ID-30533.news.dfncis.de}} la siguiente soluci'on:\footnote{Por supuesto, estos valores pueden cambiarse seg'un el gusto personal, pero ha de tenerse especial cuidado con \TB\texttt{emergencystretch}. De lo contrario, se pueden obtener p'arrafos con texto espaciado de manera excesivamente \gl libre\gr\ o \gl flexible\gr\ (como sucede con un muy conocido procesador de textos).} + + \begin{minipage}[t]{\linewidth} + \begin{verbatim} +\tolerance 1414 +\hbadness 1414 +\emergencystretch 1.5em +\hfuzz 0.3pt +\widowpenalty=10000 +\vfuzz \hfuzz +\raggedbottom + \end{verbatim} + % \hspace{\baselineskip} % Yup, I know this isn't correct! ;-) + \end{minipage} + \par + + Téngase presente que las eventuales advertencias causadas (en la fase de compilaci'on) por los ajustes anteriores \emph{deben} ser tomadas en cuenta \emph{seriamente}. Por lo tanto, \emph{siempre} se debe considerar el reformular el texto de otro modo o con otras palabras. +\end{enumerate} +% +Solamente en el caso en que todo lo mencionado anteriormente no sea útil, se puede intentar escribir el p'arrafo en que se presenta el problema utilizando el entorno \texttt{sloppypar} de manera que el texto resulte m'as \gl libre\gr. +\begin{figure}[htp] + % If someone should wonder about the additional \fussy or the + % missing \sloppy : Use the Source Luke! \parbox by default typesets + % \sloppy, so for the original linebreak \fussy is required. + \begin{minipage}[t]{.45\textwidth} + \centering {\fontsize{10pt}{12pt}\fontencoding{OT1}\selectfont + \fbox{\parbox{16.27em}{\fussy% + tatata tatata tatata tatata tatata tatata tata\-tata tatata tatata + tatata tatata tatata tatata tata\-tata tatata tatata tatata tatata + ta\-tatatatt\-ta tatata tatata tatata tatata tatata tatata + ta\-ta\-ta\-ta}}} + \caption{Configuraci'on est'andar de \LaTeX}% + \label{fig:beispiel-mit-latex}% + \end{minipage}% + \hfill% + \begin{minipage}[t]{.45\textwidth} + \centering + {\fontsize{10pt}{12pt}\fontencoding{OT1}\selectfont + \fbox{\parbox{16.27em}{% + tatata tatata tatata tatata tatata tatata tata\-tata tatata tatata + tatata tatata tatata tatata tata\-tata tatata tatata tatata tatata + ta\-tatatatt\-ta tatata tatata tatata tatata tatata tatata + ta\-ta\-ta\-ta}}} + \caption{Resultado obtenido con \texttt{\string\sloppy}} + \label{fig:beisp-mit-textttstr} + \end{minipage} +\end{figure} + +En las figuras~\ref{fig:beispiel-mit-latex} +y~\vref{fig:beisp-mit-textttstr} he tratado de ilustrar el efecto producido por +\Macro{sloppy}. Dependiendo de la fuente utilizada, este efecto se notar'a en mayor o menor grado: al utilizar Times los efectos negativos de \Macro{sloppy} no son tan notorios como con, por ejemplo, al usar Computer Modern. En cualquier caso, este efecto debe resultar evidente. + +Markus Kohm ha enviado al grupo de discusi'on \News{comp.text.tex}, un ejemplo que muestra este efecto negativo de manera a'un m'as clara. Con su permiso, transcribo el c'odigo del ejemplo en el ap'endice~\vref{sec:beispiel-zu-sloppy}. + +%----------------------- sección "Obsoletos" ------------------------ +\section{Algunos paquetes y comandos obsoletos} +\label{sec:obsoletes} + +Markus Kohm ha escrito un programa (\textit{script}) en Perl que permite buscar en l'inea los errores m'as comunes en sus archivos. V'ease \url{http://kohm.de.tf/markus/texidate.html}. Debe tenerse presente, sin embargo, que este \textit{script} no es un analizador sint'actico completo de \TeX\ y, por lo tanto, buscar'a 'unicamente los errores m'as comunes. Antes de solicitar ayuda en un foro o en una lista de difusi'on, por favor realice una revisi'on de sus archivos utilizando este \textit{script}. + +\subsection{Comandos} +\label{sec:befehle} + +\subsubsection{C'omo cambiar el estilo de la fuente} +\label{sec:ander-des-schr} +En la tabla~\vref{tab:befehle-zur-anderung} se presentan los comandos obsoletos y los comandos \gl convenientes\gr\ para cambiar el estilo de la fuente en \LaTeXe. Los comandos denominados \gl locales\gr\ solo se aplican a su propio argumento mientras que aquellos denominados \gl globales/de intercambio\gr\ se aplican a todo el texto subsiguiente hasta el fin del documento. + +\paragraph{\qd Por qu'e no deben utilizarse comandos obsoletos?} +\label{sec:warum-sollte-man} + +Los comandos obsoletos no tienen en cuenta el nuevo esquema de selecci'on de fuentes de \LaTeXe, o NFSS. Por ejemplo, al utilizar \GMacro{bf}{foo} se anulan todos los atributos de la fuente que hayan sido previamente definidos antes de imprimir \emph{foo} en negrilla. Por esta raz'on no se puede definir un estilo negrilla-cursiva utilizando 'unicamente +\GMacro{it}{\Macro{bf Prueba}}. (Esta definici'on producir'a: +{\it\bf Prueba}.) De otro lado, los nuevos comandos \LMacro{textbf}{\LMacro{textit}{Prueba}} tendr'an el comportamiento esperado y producir'an: \textbf{\textit{Prueba}}. Aparte de esto, con los antiguos comandos no hay \gl correcci'on de cursiva\gr; compare, por ejemplo, {\it + ref}lejar (\GMacro{it}{ref}\texttt{lejar}) con +\textit{ref}lejar (\LMacro{textit}{ref}\texttt{lejar}). + +Para mayor informaci'on sobre el esquema NFSS v'ease \cite{fntguide}. + +\begin{table} + \begin{minipage}{\textwidth} + \renewcommand{\footnoterule}{} + \centering + \caption{Comandos para cambiar el estilo de la fuente} + \label{tab:befehle-zur-anderung} + \begin{tabular}{@{}lll@{}} + \toprule + \multicolumn{1}{@{}N}{Obsoleto}& + \multicolumn{2}{C@{}}{Remplazo en \LaTeXe}\\ + \cmidrule(l){2-3} + & + \multicolumn{1}{N}{local} & + \multicolumn{1}{N@{}}{global/de intercambio}\\ + \cmidrule(r){1-1}\cmidrule(lr){2-2}\cmidrule(l){3-3} + \GMacro{bf}{\dots} & \LMacro{textbf}{\dots} & \Macro{bfseries}\\ + --- & \LMacro{emph}{\dots} & \Macro{em}\footnote{Puede ser 'util al definir comandos. En texto normal, es preferible usar \LMacro{emph}{\dots} + en lugar de \Macro{em}.}\\ + \GMacro{it}{\dots} & \LMacro{textit}{\dots} & \Macro{itshape}\\ + --- & \LMacro{textmd}{\dots} & \Macro{mdseries}\\ + \GMacro{rm}{\dots} & \LMacro{textrm}{\dots} & \Macro{rmfamily}\\ + \GMacro{sc}{\dots} & \LMacro{textsc}{\dots} & \Macro{scshape}\\ + \GMacro{sf}{\dots} & \LMacro{textsf}{\dots} & \Macro{sffamily}\\ + \GMacro{sl}{\dots} & \LMacro{textsl}{\dots} & \Macro{slshape}\\ + \GMacro{tt}{\dots} & \LMacro{texttt}{\dots} & \Macro{ttfamily}\\ + --- & \LMacro{textup}{\dots} & \Macro{upshape}\\ + \bottomrule + \end{tabular} +\end{minipage} +\end{table} + +\subsubsection{Fracciones matem'aticas: \texttt{\textbackslash over} versus \texttt{\textbackslash frac}} +\label{sec:textb-over-vs} + +El uso del comando \Macro{over} debe evitarse. \Macro{over} es un comando \TeX{} y su sintaxis difiere de la de \LaTeX\ por lo cual su aparici'on en un documento hace que el an'alisis sint'actico del mismo sea dif'icil (o incluso imposible). El paquete \Paket{amsmath} redefine el comando \verb+\frac{}{}+ y esto ocasiona mensajes de error cuando se utiliza \Macro{over}. Otro argumento a favor del uso de \verb+\frac{}{}+ es que facilita la escritura del numerador y el denominador de una fracci'on, especialmente si 'esta es compleja. + +\Ersetze{\texttt{\$a \textbackslash over b\$}}% +{\texttt{\$\textbackslash frac\{a\}\{b\}\$}} + +\subsubsection{Centrar texto con \texttt{\textbackslash centerline}} +\label{sec:centerline} + +El comando \Macro{centerline} es otro comando \TeX{} que no debe ser utilizado. En primer lugar, \Macro{centerline} es incompatible con algunos paquetes \LaTeX{} (por ejemplo, \Paket{color}) y, en segundo lugar, este comando puede producir resultados inesperados. +\emph{Por ejemplo}: +\begin{center} + \begin{minipage}[t]{.45\textwidth} +\begin{verbatim} +\begin{enumerate} +\item \centerline{Un Ãtem} +\end{enumerate} +\end{verbatim} + \end{minipage}% + \hfill% +% \hspace{.05\textwidth}% + \fbox{ \begin{minipage}[t]{.45\textwidth} + \begin{enumerate} + \item \centerline{Un Ãtem} + \end{enumerate} + \end{minipage}} +\end{center} +\Ersetze{\LMacro{centerline}{\dots}}% +{\parbox[t]{.3\textwidth}{% + \GMacro{centering}{\dots}\\ +\textcolor{black}{o}\\ +\Env{center}{\dots} +}} + +\paragraph{Nota.} +\label{sec:anmerkung-5} + +Para centrar gr'aficas y cuadros, v'ease la secci'on~\vref{sec:gleit-figure-table}. + +\subsection{Archivos y paquetes de clase} +\label{sec:pakete} + +\subsubsection{\Klasse{scrlettr} versus \Klasse{scrlttr2}} +\label{sec:paketscrl-vs.-pakets} + +La clase \Klasse{scrlettr} perteneciente a la colecci'on \KOMAScript\ es ahora obsoleta y ha sido remplazada por la clase \Klasse{scrlttr2}. Para obtener una estructura del documento \emph{similar} a la de la clase obsoleta \Klasse{scrlettr} se puede usar la opci'on de clase \Option{KOMAold} que activa una modalidad compatible. + +\sbox{\Breite}{\texttt{\textbackslash documentclass\{scrltter\}}} +\Ersetzx[\wd\Breite]{\texttt{\textbackslash documentclass\{scrlettr\}}}% +{\texttt{\textbackslash documentclass[KOMAold]\{scrlttr2\}}} + +\paragraph{Nota.} +\label{sec:anmerkung-3} + +Para cartas y plantillas nuevas se debe utilizar la nueva interfaz ya que es definitivamente m'as flexible. + +En este documento es imposible profundizar en la discusi'on acerca de las diferencias entre las dos interfaces existentes. Para mayor informaci'on v'ease \Doku{scrguien}~\cite{kohm:03}. + +\subsubsection{\Paket{epsf}, \Paket{psfig}, \Paket{epsfig} versus + \Paket{graphics}, \Paket{graphicx}} +\label{sec:grafikeinbindung} + +Los paquetes \Paket{epsf} y \Paket{psfig} han sido remplazados, respectivamente, por los paquetes \Paket{graphics} y \Paket{graphicx}. El paquete \Paket{epsfig} tan solo es una \gl envoltura\gr\footnote{Una \gl envoltura\gr\ (en ingl'es, \gl wrapper\gr) es un archivo \Paket{} que a su vez carga uno o m'as archivos de estilo, modelando as'i funciones.} que se encarga de invocar al paquete \Paket{graphicx} para procesar documentos en los que se utilizaba el paquete \Paket{psfig}. + +El paquete \Paket{epsfig} aun \emph{puede} utilizarse ya que \Paket{epsfig} carga internamente el paquete \Paket{graphicx}. Sin embargo, no debe ser utilizado para documentos nuevos en los que es preferible utilizar \Paket{graphics} o \Paket{graphicx}. Como se mencion'o antes, el paquete \Paket{epsfig} se mantiene solo por razones de compatibilidad. + +V'ease \Doku{grfguide}~\cite{graphicx:99} para consultar las diferencias entre \Paket{graphics} y \Paket{graphicx}. V'eanse las recomendaciones para el centrado de gr'aficas en la secci'on~\vref{sec:gleit-figure-table}. + +\sbox{\Breite}{\LMacro{psfig}{file=Bild,\dots}} +\Ersetze{\parbox[t]{0.35\textwidth}{\Use{psfig}\\% + \LMacro{psfig}{file=image,\dots}}}% +{\parbox[t]{.45\textwidth}{% + \Use{graphicx}\\% + \texttt{\textbackslash includegraphics[\dots]\{image\}}}} + +\subsubsection{\Paket{doublespace} versus \Paket{setspace}} +\label{sec:zeilenabstande} + +Para cambiar el interlineado utilice el paquete \Paket{setspace}. +El paquete \Paket{doublespace} es obsoleto y fue sustituido por \Paket{setspace}. +V'ease la secci'on~\vref{sec:ander-des-zeil}. + +\Ersetze{\Use{doublespace}}{\Use{setspace}} + +\subsubsection{\Paket{fancyheadings}, \Paket{scrpage} versus \Paket{fancyhdr}, \Paket{scrpage2}} +\label{sec:lebende-kolumn} + +El paquete \Paket{fancyheadings} ha sido remplazado por \Paket{fancyhdr}. Una forma alternativa de modificar los encabezados es utilizando el paquete \Paket{scrpage2} de la colecci'on \KOMAScript. No utilice el paquete obsoleto \Paket{scrpage}. Para mayor informaci'on sobre el paquete \Paket{scrpage2} v'ease \Doku{scrguien}~\cite{kohm:03}. + +\Ersetze{\Use{fancyheadings}}{\Use{fancyhdr}} +\Ersetze{\Use{scrpage}}{\Use{scrpage2}} + +\subsubsection{La familia de paquetes \Paket{caption}} +\label{sec:die-caption-famile} + +El paquete \Paket{caption2} no debe ser utilizado pues existe una nueva versi'on (v3.x) del paquete \Paket{caption}. Aseg'urese de utilizar la 'ultima versi'on de este paquete cargando \Paket{caption} de la manera siguiente: +\Ersetze{\Use{caption}}{\UseV{caption}{2007/11/04}} + +Si sol'ia utilizar el paquete \Paket{caption2}, revise la documentaci'on del paquete \Paket{caption}: \Doku{caption}~\cite[secci'on~8]{caption:04}. + +\subsubsection{\Paket{isolatin}, \Paket{umlaut} versus \Paket{inputenc}} +\label{sec:eingabe-von-umlauten} + +\paragraph{Algunas consideraciones generales.} +\label{sec:generelles} + +B'asicamente, existen cuatro formas de obtener las \emph{umlauts} del alem'an\footnote{As'i como las \emph{vocales tildadas} del espa~nol \NDT} y los otros caracteres no pertenecientes al conjunto ASCII. + +\begin{enumerate} + \item \verb+H{\"u}lle+: tiene la ventaja de funcionar siempre y sobre cualquier tipo de sistema. + + Sus principales desventajas, sin embargo, son que el cran\footnote{El ajuste del espaciado entre caracteres que puede ser positivo o negativo y depende de cu'ales ser'an impresos. En ingl'es, \textit{kerning}.} entre letras se ve afectado de forma negativa; la digitaci'on del texto es bastante dispendiosa y la lectura del c'odigo fuente se dificulta. + + El uso de esta variante \emph{siempre} debe evitarse debido a los problemas que origina con el cran. + + \item Con las opciones \verb+H\"ulle+ o \verb+H\"{u}lle+ desaparece el problema con el cran mencionado anteriormente. Cualquiera de estas dos variantes puede usarse en todos los sistemas. + + Sin embargo, la digitaci'on del texto y la lectura del c'odigo son tan poco naturales como con la variante anterior. + + Esta variante es apropiada para definir comandos o archivos de estilo ya que es \emph{independiente} de la codificaci'on utilizada y no requiere de paquetes adicionales.\label{item:die-eingabe-der} + + \item Con el paquete \Paket{(n)german} o con la opci'on \Option{(n)german} del paquete \Paket{babel} las \textit{umlauts} del alem'an se pueden insertar f'acilmente\footnote{Para el caso del espa~nol, la opci'on \Option{activeacute} del paquete \Paket{babel} permite escribir las tildes de manera an'aloga, por ejemplo \UseVerb*{ejemplo} \NDT}: \verb+H"ulle+. Nuevamente, esta alternativa funciona en todos los sistemas. Ya que todo sistema \TeX\ incluye los paquetes \Paket{babel} y \Paket{(n)german}, no se deben presentar problemas de compatibilidad. + + Sin embargo, como antes, la digitaci'on del texto y la lectura del c'odigo pueden ser relativamente dif'iciles. + + Esta variante es conveniente para texto continuo pero debe evit'arsela en la definici'on de comandos y en los pre'ambulos. + + \item Digitaci'on directa (\verb+Hülle+). La ventaja de esta variante es obvia. El c'odigo del archivo fuente se puede digitar y leer \gl normalmente\gr. + + Por otro lado, con esta variante se le debe indicar a \LaTeX{} la codificación de entrada que se est'a utilizando. Adem'as, pueden presentarse problemas al intercambiar archivos entre sistemas diferentes. Esto, en sÃ, \emph{no} es un problema para \TeX\ o para \LaTeX{}, pero puede ocasionar \emph{problemas con la visualizaci'on del texto en editores} sobre sistemas diferentes. Por ejemplo, el s'imbolo para el Euro en la codificación iso-8859-15 (latin9) puede ser \emph{mostrado} como {\fontencoding{OT1}\fontfamily{cmr}\selectfont\textcurrency} en un editor que trabaje en un ambiente Windows (CP1252). + + Esta variante es bastante c'omoda para texto normal; sin embargo, su uso debe evitarse en la definici'on de comandos o en el pre'ambulo de un documento. +\end{enumerate} +% +Para resumir, en comandos, en pre'ambulos y en archivos de estilo se debe utilizar +\verb+H\"ulle+ o \verb+H\"{u}lle+, mientras que en el resto del documento se debe utilizar \verb+H"ulle+ o \verb+Hülle+. + +\paragraph{Codificaci'on de la entrada} +\label{sec:eingabekodierung-1} + +\emph{No se deben} utilizar los paquetes \Paket{isolatin1}, \Paket{isolatin} o \Paket{umlaut} para indicar a \LaTeX\ la codificaci'on de entrada que ser'a utilizada. Estos paquetes son obsoletos y podr'ian no estar disponibles en todo sistema. + +Debe usarse el paquete \Paket{inputenc}, con sus cuatro opciones: +\begin{description} + \item[latin1/latin9/utf8] para sistemas de tipo Unix (latin1 tambi'en est'a disponible para MS~Windows y Mac OS\,X). + \item[ansinew] para MS Windows. + \item[applemac] para Macintosh\footnote{Se recomienda a los usuarios de Macintosh~OS\,X la utilizaci'on de la codificaci'on latin1 ya que permite evitar problemas de compatibilidad cuando se intercambian documentos entre plataformas diferentes. Si se usa esta opci'on, lo primero que debe hacerse es revisar la configuraci'on del editor utilizado. A la larga, se puede optar por utilizar la codificaci'on unicode, pero se debe tener en cuenta que el soporte que brinda el paquete \Paket{inputenc} para esta opci'on es hasta el momento provisional. Algunos usuarios se han declarado satisfechos al utilizar el paquete \Paket{ucs} incluido en el paquete \textsf{unicode}.} + \item[cp850] para OS/2. +\end{description} + +\Ersetze{\Use{isolatin1}}{\UseO{latin1}{inputenc}} +\Ersetze{\Use{umlaut}}{\UseO{latin1}{inputenc}} + +\subsubsection{\Paket{t1enc} versus \Paket{fontenc}} +\label{sec:schriftkodierung} + +En general, este tema ha sido tratado detalladamente tanto en \Doku{De-TeX-FAQ}~\cite[preguntas 5.3.2, 5.3.3, 10.1.10]{faq:02}, +como en \Doku{UK FAQ}~\cite[\gl Why use \emph{fontenc} rather than +\emph{t1enc}\gr, pregunta 358]{ukfaq:99}. Por lo tanto, es suficiente mencionar aqu'i que el paquete \Paket{t1enc} es obsoleto y debe remplazarse por \Paket{fontenc}. + +\Ersetze{\Use{t1enc}}{\UseO{T1}{fontenc}} + +\subsubsection{\Bst{natdin} versus \Bst{dinat}} +\label{sec:liter-nach-din} + +El archivo de estilo \Bst{natdin} fue remplazado por \Bst{dinat}. +\Ersetze{\Bib{natdin}}{\Bib{dinat}} + +\subsection{Fuentes} +\label{sec:schriften} + +\gl Fuentes y \LaTeX\gr\ es un tema complejo que genera debate y despierta inter'es. La mayor parte de las discusiones que ocurren en el grupo \News{de.comp.text.tex} contienen la pregunta \qd Por qu'e los caracteres se ven tan +\gl borrosos\gr\ al utilizar Adobe Acrobat\textsuperscript{\textregistered} Reader? La mayor'ia de las respuestas se centran en el uso de los paquetes \Paket{times} o \Paket{pslatex} aunque, no obstante, 'estos utilizan conjuntos de fuentes completamente diferentes. + +Para mayor informaci'on sobre el Nuevo Esquema de Selecci'on de Fuentes (NFSS) utilizado por \LaTeXe, v'ease \cite{fntguide}. + +Para lograr que las fuentes de la familia Computer Modern se representen n'itidamente al utilizar \emph{acroread}, v'ease \Doku{De-TeX-FAQ}~\cite[pregunta 9.2.3]{faq:02} o \Doku{UK FAQ}~\cite[\gl The wrong type of fonts in PDF\gr, pregunta 114]{ukfaq:99}. + +\subsubsection{\Paket{times}} +\label{sec:pakettimes} + +El paquete \Paket{times} es obsoleto (v'ease \Doku{psnfss2e} \cite{psnfss:02}). Este paquete establece la familia Times como \Macro{rmdefault}, Helvetica como \Macro{sfdefault} y Courier como \Macro{ttdefault} pero \emph{no} utiliza las fuentes correspondientes en modo matem'atico. Adem'as, los caracteres de la familia Helvetica no son reducidos apropiadamente lo cual hace que parezcan muy grandes en comparaci'on con los de las otras familias. Para usar la combinaci'on Times/\/Helvetica/\/Courier se debe utilizar: + +\sbox{\Breite}{\UseO{scaled=.95}{helvet}} +\Ersetze{\Use{times}}% +{\parbox[t]{\wd\Breite}{% + \Use{mathptmx}\\ + \UseO{scaled=.90}{helvet}\\ + \Use{courier}}} + +\paragraph{Nota.} +\label{sec:anmerkung-1} + +El factor de reducci'on para \Paket{helvet} junto con Times debe ser un n'umero comprendido entre $0.90$ y $0.92$. + +\subsubsection{\Paket{mathptm}} +\label{sec:mathptm} + +El paquete \Paket{mathptm} es el predecesor de \Paket{mathptmx}; por lo tanto, se debe utilizar este 'ultimo para escribir f'ormulas matem'aticas en Times. + +\Ersetze{\Use{mathptm}}{\Use{mathptmx}} + +\subsubsection{\Paket{pslatex}} +\label{sec:paketpslatex} + +Internamente, el paquete \Paket{pslatex} funciona como \Paket{mathptm}$+$ +\Paket{helvet} (escalado). Sin embargo, utiliza una fuente Courier escalada de manera muy estrecha. El inconveniente principal al utilizar el paquete \Paket{pslatex} es que \emph{no} funciona con las codificaciones T1 y TS1. + +\Ersetze{\Use{pslatex}}{\parbox[t]{\wd\Breite}{\Use{mathptmx}\\\UseO{scaled=.90}{helvet}\\\Use{courier}}} + +\paragraph{Note sobre la fuente Courier para todas las combinaciones de Times/Helvetica.} +\label{sec:anmerkung-zu-allen} + +Debe evitarse utilizar el paquete \Paket{courier}. Para la fuente Typewriter (tipo \gl m'aquina de escribir\gr) se puede seguir utilizando \texttt{cmtt}. + +\subsubsection{\Paket{palatino}} +\label{sec:paketpalatino} + +El paquete \Paket{palatino} se comporta de manera similar a \Paket{times}, salvo que, naturalmente, se establece la familia Palatino como \Macro{rmdefault}. El paquete \Paket{palatino} tambi'en es obsoleto y, por lo tanto, su uso debe evitarse. + +\Ersetze{\Use{palatino}}{\parbox[t]{\wd\Breite}{\Use{mathpazo}\\\UseO{scaled=.95}{helvet}\\\Use{courier}}} + +\paragraph{Note:} +\label{sec:anmerkung-2} + +El factor de escala para el paquete \Paket{helvet} junto con la fuente Palatino debe ser de $0.95$. + +Helvetica \emph{no} es la \gl mejor\gr\ fuente sans-serif para usar conjuntamente con Palatino; es tan solo la mejor fuente sans-serif disponible \emph{gratuitamente}. Quien posea un CD de CorelDraw\textsuperscript{\textregistered} (as'i sea una versi'on vieja) puede utilizar Palatino bastante bien junto con +Frutiger\footnote{Bitstream Humanist 777, bfr} u +Optima\footnote{Bitstream Zapf Humanist, bop}. Walter Schmidt en su \textit{homepage} brinda adaptaciones que permiten utilizar algunas fuentes PostScript en \TeX.\footnote{Fonts for \TeX: \url{http://home.vr-web.de/was/fonts}} + +\subsubsection{\Paket{mathpple}} +\label{sec:paketmathpple} + +Este paquete era el predecesor de \Paket{mathpazo}. Algunos s'imbolos que hacen falta son tomados de las fuentes Euler. Algunos otros s'imbolos no se adaptan al uso con la familia Palatino ya que la m'etrica de las fuentes no es la correcta. Para mayor informaci'on, v'ease \Doku{psnfss2e}~\cite{psnfss:02}. + +\subsubsection{Escritura de letras griegas en estilo vertical} +\label{sec:aufr-griech-buchst} + +En lo que sigue, los paquetes que he ersaltado con color rojo no son obsoletos en el sentido de \gl no deben usarse de ahora en adelante\gr, sino que en la actualidad el paquete \Paket{upgreek} hace m'as f'acil la labor de edici'on de texto\footnote{El paquete \Paket{fourier} brinda la opci'on + \texttt{upright} que permite escribir las letras griegas y las romanas may'usculas en estilo vertical. \NDT}. Para consejos sobre su uso, v'ease \Doku{upgreek}~\cite{upgreek:01}. + +\minisec{Trucos para el paquete \Paket{pifont}}\nopagebreak[4] +\sbox{\Breite}{\NewCom{uppi}{\LMacro{Pisymbol}{psy}\{112\}}} +\Ersetzx[\wd\Breite]{% + \Use{pifont}\\ + \NewCom{uppi}{\LMacro{Pisymbol}{psy}\{112\}}\\ + \Macro{uppi}\\ + \textcolor{black}{o}\\ + \NewCom[{[1]}]{upgreek}{\%\\ + ~\Macro{usefont}\{U\}\{psy\}\{m\}\{n\}\#1}\\ + \LMacro{upgreek}{p} +}% +{% + \Use{upgreek}\\ + \$\Macro{uppi}\$ +} + +\minisec{Trucos para el paquete \Paket{babel}} + +\Ersetzx[\wd\Breite]{% + \UseO{greek,\dots}{babel}\\ + \NewCom[{[1]}]{upgreek}{\%\\ + ~\LMacro{foreignlanguage}{greek}\{\#1\}}\\ + \LMacro{upgreek}{p} + } + {% + \Use{upgreek}\\ + \$\Macro{uppi}\$ +} + +\subsubsection{\Paket{euler} versus \Paket{eulervm}} +\label{sec:euler-eulervm} + +En lugar del paquete \Paket{euler}, utilice el paquete \Paket{eulervm} para expresiones matem'aticas. \Paket{eulervm} es un paquete \LaTeX{} que permite usar las fuentes +eulervm, fuentes virtuales para uso matem'atico basadas tanto en las fuentes Euler como en las CM. Este paquete consume menos de los recursos asignados a \TeX\ y brinda algunos s'imbolos matem'aticos mejorados as'i como comandos \texttt{$\backslash$hslash} y +\texttt{$\backslash$hbar} perfeccionados. Para mayor informaci'on, v'ease la documentaci'on del paquete \Doku{eulervm}~\cite{eulervm:04}. + +\Ersetze{\Use{euler}}{\parbox[t]{.35\textwidth}{\Use{eulervm}}} + +%-------------------- sección "Miscelánea" --------------------- +\section{Miscel'anea} +\label{sec:verschiedenes} + +En esta secci'on (exceptuando la subsecci'on~\vref{sec:der-anhang}) se presentan sugerencias de car'acter m'as general que las presentadas en la secci'on \gl pecados capitales\gr, p'agina \pageref{sec:todsunden}. + +\subsection{Objetos flotantes: \gl figure\gr\ y \gl table\gr} +\label{sec:gleit-figure-table} + +Para centrar un entorno de tipo flotante, es recomendable utilizar +\Macro{centering} en lugar de \newline\LMacro{begin}{center} \dots{} +\LMacro{end}{center} ya que este 'ultimo entorno a~nadir'a espacio vertical indeseado en la mayor'ia de los casos. +\sbox{\Breite}{\LMacro{includegraphics}{bild}} +\Ersetze{\parbox[t]{\wd\Breite}{% + \Env{figure}{\Env{center}{\LMacro{includegraphics}{bild}}} }}% +{\parbox[t]{\wd\Breite}{% + \Env{figure}{\Macro{centering}\\% + \LMacro{includegraphics}{bild}} }} + +\paragraph{Nota.} +\label{sec:anmerkung-4} + +Sin embargo, si se desea centrar una regi'on con texto continuo o dentro de un entorno +\verb+titlepage+ !`este espacio vertical adicional puede resultar 'util! + +\subsection{Ap'endices} +\label{sec:der-anhang} + +Los ap'endices se introducen por medio del \emph{comando} \Macro{appendix}. +T'engase presente que 'este \emph{no es un entorno}. + +\sbox{\Breite}{\LMacro{begin}{appendix}} +\Ersetze{\parbox[t]{\wd\Breite}{% + \Env{appendix}% + {\LMacro{section}{Blub}}}}% +{\parbox[t]{.33\textwidth}{% + \Macro{appendix}\\ + \LMacro{section}{Blub} }} + +\subsection{Escritura de expresiones matem'aticas} +\label{sec:mathematiksatz} + +En t'erminos generales, para escribir expresiones matem'aticas complejas debe utilizarse el paquete \Paket{amsmath} que ofrece varios entornos para sustituir \texttt{eqnarray}. Otras ventajas de este paquete son las siguientes: + +\begin{itemize} + \item El espaciamiento interno y externo a los entornos es m'as consistente. + \item La numeraci'on de las ecuaciones se coloca de tal manera que ya no se presentan superposiciones. + \item Algunos entornos nuevos, por ejemplo \texttt{split}, permiten descomponer f'acilmente las ecuaciones largas. + \item Es f'acil definir nuevos operadores con espaciamiento correcto (de manera similar a \Macro{sin}, etc.) +\end{itemize} + +\paragraph{Advertencia:} +\label{sec:warnung} + +Cuando se utilice el paquete \Paket{amsmath} \emph{nunca} deben usarse los entornos \texttt{displaymath}, \texttt{eqnarray} o \texttt{eqnarray*} ya que 'estos no est'an soportados por \Paket{amsmath}. En caso de utilizarlos, se pueden obtener inconsistencias en el espaciamiento. + +El paquete \Paket{amsmath} implementa de manera apropiada \texttt{\textbackslash [\dots\textbackslash]} que debe usarse en vez de \texttt{displaymath}. +Los entornos \texttt{eqnarray} y \texttt{eqnarray*} deben remplazarse por \texttt{align} o \texttt{align*}, respectivamente. Para una discusi'on detallada del paquete \Paket{amsmath} v'ease \Doku{amsldoc}~\cite{amsldoc:99}. + +\sbox{\Breite}{\LMacro{includegraphics}{bild}} +\Ersetze{% + \parbox[t]{\wd\Breite}{% + \Env{eqnarray}{% + a \&=\& b \textbackslash\textbackslash\\ + b \&=\& c \textbackslash\textbackslash\\ + a \&=\& c + } + }}% + {\parbox[t]{\wd\Breite}{% + \Env{align}{% + a \&= b \textbackslash\textbackslash\\ + b \&= c \textbackslash\textbackslash\\ + a \&= c + } + }} + + +\subsection{C'omo utilizar \texttt{\TB graphicspath}} +\label{sec:die-verwendung-von} + +A continuaci'on se presentan algunas razones por las cu'ales debe evitarse la utilizaci'on del comando \Macro{graphicspath}. En lugar de utilizar este comando se debe configurar la variable de entorno +\texttt{TEXINPUTS}:\footnote{Con respecto a la respuesta de David Carlisle al \gl Bug-Report\gr\ enviado por Markus Kohm a\newline + \url{http://www.latex-project.org/cgi-bin/ltxbugs2html?pr=latex/2618}} +\begin{enumerate} + \item Diferentes plataformas utilizan \emph{distintos} separadores para los nombres de las rutas. De hecho, mientras que MS~Windows y los sistemas de tipo Unix utilizan el caracter \textit{slash} \gl /\gr, los sistemas Macintosh anteriores a Mac OS~X utilizaban los dos puntos \gl :\gr. + \item El algoritmo de b'usqueda de \TeX{}\ resulta m'as lento que el implementado por la librer'ia kpathsea (aunque con la velocidad que brindan los chips actuales este argumento ya no es tan importante como sol'ia serlo). + \item La memoria asignada a \TeX\ es limitada y cada figura utiliza parte de esta memoria. Adem'as, la memoria no se libera durante el proceso de compilaci'on. +\end{enumerate} +% +En una consola, la variable de entorno \texttt{TEXINPUTS} se configura de la siguiente manera: +\begin{verbatim} +$ TEXINPUTS=Imagenes:$TEXINPUTS latex datei.tex +\end{verbatim} +donde \texttt{Imagenes} es el nombre del directorio que contiene las im'agenes que van a ser incluidas en el documento. Otra posibilidad es agregar a \verb+~/.profile+ la siguiente l'inea: +\begin{verbatim} +export TEXINPUTS=./Imagenes:$TEXINPUTS +\end{verbatim}%$ +En este 'ultimo caso, los archivos contenidos en el directorio \texttt{Imagenes} ser'an encontrados como si estuvieran dentro del directorio actual de trabajo. + +\noindent +Para sistemas no superiores a MS~Windows~98 la variable de entorno se configura agregando +\begin{verbatim} +set TEXINPUTS=.\PictureDir;%TEXINPUTS% +\end{verbatim} +al archivo \texttt{autoexec.bat}. En sistemas con tecnolog'ia MS Windows NT la variable se configura en \textsf{Mi Equipo $\rightarrow$ Propiedades del Sistema $\rightarrow$ Avanzadas $\rightarrow$ Variables de entorno}.\footnote{Para Windows~XP se puede utilizar \textsf{Inicio} $\rightarrow$ Panel de Control $\rightarrow$ Sistema $\rightarrow$ Opciones Avanzadas $\rightarrow$ Variables de entorno.} + +Estas son tan solo algunas sugerencias sobre c'omo proceder; de hecho, es posible configurar la variable \texttt{TEXINPUTS} de diversas maneras. Para mayor información consulte la documentaci'on de su sistema operativo o de su distribuci'on de \TeX. + +\subsection{Macros espec'ificos de un idioma: \texttt{\textbackslash*name}} +\label{sec:die-macroname-makros} + +De vez en cuando surge en los foros de discusi'on la cuesti'on de c'omo modificar, por ejemplo, el t'itulo \gl References\gr\ para obtener \gl Referencias Bibliogr'aficas\gr\ u otras variantes. Con este fin, en el cuadro~\vref{tab:von-paketng-btw} he recopilado los comandos necesarios para realizar estos cambios. + +Por ejemplo, para cambiar el t'itulo \gl List of Figures\gr, que en español es \gl Lista de Figuras\gr, por \gl Figuras\gr, se puede utilizar el siguiente comando: +\begin{verbatim} +\renewcommand*{\listfigurename}{Figuras} +\end{verbatim} +Los otros comandos se modifican de manera an'aloga. Cuando en el pre'ambulo se carga el paquete \Paket{babel} se debe utilizar el comando \Macro{addto}. Para m'as detalles, v'ease \Doku{De-TeX-FAQ}~\cite{faq:02} o la documentaci'on del paquete \Paket{babel} + +\begin{verbatim} +\addto{\captionsspanish}{% + \renewcommand*{\listfigurename}{Figuras}} +\end{verbatim} + +\begin{table} + \begin{minipage}{\textwidth} + \centering + \caption{Comandos definidos por el paquete \Paket{babel} con la opci'on \Option{spanish}} + \label{tab:von-paketng-btw} + \begin{tabular}{@{}lll@{}} + \toprule + \multicolumn{1}{@{}N}{Nombre del comando} & + \multicolumn{1}{N}{Definici'on original} & + \multicolumn{1}{N@{}}{\Paket{babel} con opci'on \Option{spanish}} \\ + \cmidrule(r){1-1}\cmidrule(lr){2-2}\cmidrule(l){3-3} + \Macro{prefacename} & Preface & \prefacename \\ + \Macro{refname}\footnote{Solo en la clase \texttt{article}.} + & References & \refname \\ + \Macro{abstractname} & Abstract & \abstractname \\ + \Macro{bibname}\footnote{Solo en las clases \texttt{report} y + \texttt{book}.} + & Bibliography & Bibliograf'ia \\ + \Macro{chaptername} & Chapter & \chaptername \\ + \Macro{appendixname} & Appendix & \appendixname \\ + \Macro{contentsname} & Contents & \contentsname \\ + \Macro{listfigurename} & List of Figures & \listfigurename \\ + \Macro{listtablename} & List of Tables & \listtablename \\ + \Macro{indexname} & Index & \indexname \\ + \Macro{figurename} & Figure & \figurename \\ + \Macro{tablename} & Table & \tablename \\ + \Macro{partname} & Part & \partname \\ + \Macro{enclname} & encl & \enclname \\ + \Macro{ccname} & cc & \ccname \\ + \Macro{headtoname} & To & \headtoname \\ + \Macro{pagename} & Page & \pagename \\ + \Macro{seename} & see & \seename \\ + \Macro{alsoname} & see also & \alsoname \\ + \bottomrule + \end{tabular} + \end{minipage} +\end{table} +\clearpage +\appendix + +\section{Un ejemplo que ilustra el efecto del comando \texttt{\TB sloppy}} +\label{sec:beispiel-zu-sloppy} +Este es el ejemplo que Markus Kohm public'o: +\begin{bspcode}{\MID{8557097.gEimXdBtjU@ID-107054.user.dfncis.de}{8557097.gEimXdBtjU@ID-107054.user.dfncis.de}}% +\footnotesize +\begin{verbatim} +\documentclass{article} + +\setlength{\textwidth}{20em} +\setlength{\parindent}{0pt} +\begin{document} +\typeout{First without \string\sloppy\space and underfull \string\hbox} + +tatata tatata tatata tatata tatata tatata ta\-ta\-tata +tatata tatata tatata tatata tatata tatata tata\-tata +tatata tatata tatata tatata ta\-tatatatt\-ta +tatata tatata tatata tatata tatata tatata ta\-ta\-ta\-ta + +\typeout{done.} + +\sloppy +\typeout{Second with \string\sloppy\space and underfull \string\hbox} + +tatata tatata tatata tatata tatata tatata ta\-ta\-tata +tatata tatata tatata tatata tatata tatata tata\-tata +tatata tatata tatata tatata ta\-tatatatt\-ta +tatata tatata tatata tatata tatata tatata ta\-ta\-ta\-ta + +\typeout{done.} +\end{document} +\end{verbatim} +\end{bspcode} + +\clearpage +\begin{thebibliography}{99}\addcontentsline{toc}{section}{Referencias}% + +\bibitem{amsldoc:99} \textsc{American Mathematical Society}: + \emph{User's Guide for the {\texttt{amsmath}} Package}. Diciembre 1999, + Versi'on~2.0. \biburl{CTAN://macros/latex/required/amslatex/}. + +\bibitem{graphicx:99} \textsc{David~P. Carlisle}: \emph{Packages in the + \gl graphics\gr\ bundle}. Enero 1999. + \biburl{CTAN://macros/latex/required/graphics/}. + +\bibitem{ukfaq:99}\textsc{Robin Fairbairns}: \emph{The UK \TeX\ FAQ. + Your 407 Questions Answered.} WWW, Versi'on~3.16, junio 30 de 2006, + \biburl{http://www.tex.ac.uk/faq}. + +\bibitem{kohm:03} \textsc{Markus Kohm}, \textsc{Frank Neukam} y + \textsc{Axel Kielhorn}: \emph{The KOMA-Script Bundle}. + \Doku{scrguien}. + \biburl{CTAN://macros/latex/supported/koma-script/}. + +\bibitem{clsguide} \textsc{The \LaTeX3 Project}: \LaTeXe{} for + class and package writers. 1999. + \biburl{CTAN://macros/latex/doc/clsguide.pdf} + +\bibitem{fntguide} \textsc{The \LaTeX3 Project}: \LaTeXe{} font + selection. 2000. + \biburl{CTAN://macros/latex/doc/fntguide.pdf} + +\bibitem{usrguide} \textsc{The \LaTeX3 Project}: \LaTeXe{} for + authors. 2001. + \biburl{CTAN://macros/latex/doc/usrguide.pdf} + +\bibitem{faq:02} \textsc{Bernd Raichle}, \textsc{Rolf Niepraschk} y + \textsc{Thomas Hafner}: \emph{Fragen und Antworten (FAQ) über das + Textsatzsystem {\TeX\ }und DANTE, Deutschsprachige + Anwendervereinigung {\TeX\ }e.V.} WWW, Versi'on~72. Septiembre 2003, + \biburl{http://www.dante.de/faq/de-tex-faq/}. + +\bibitem{upgreek:01} \textsc{Walter Schmidt}: \emph{The + {\textsf{upgreek}} package for {\LaTeXe}}. Mayo 2001, Versi'on~1.0. + \biburl{CTAN://macros/latex/contrib/supported/was/}. + +\bibitem{psnfss:02} \textsc{Walter Schmidt}: \emph{Using common + PostScript fonts with {\LaTeX}}. Abril 2002, PSNFSS versi'on 9.0. + \biburl{CTAN://macros/latex/required/psnfss/psnfss2e.pdf} + +\bibitem{eulervm:04} \textsc{Walter Schmidt}: \emph{The Euler Virtual Math + Fonts for use with {\LaTeX}}. Enero 2004, Versi'on~3.0a. + \biburl{CTAN://fonts/eulervm/} + +\bibitem{l2kurz:99} \textsc{Walter Schmidt}, \textsc{Jörg Knappen}, + \textsc{Hubert Partl} e \textsc{Irene Hyna}:\\ + \emph{{\LaTeXe}-Kurzbeschreibung}. Abril 1999, Versi'on~2.1. + \biburl{CTAN://info/lshort/german/}. Traducci'on al ingl'es disponible en \biburl{CTAN://info/lshort/english/} + +\bibitem{caption:04} \textsc{Axel Sommerfeld}: + \emph{Setzen von Abbildungs- und Tabellenbeschriftungen mit dem + caption-Paket}. Julio 2004, Versi'on~3.0c. + \biburl{CTAN://macros/latex/contrib/caption/}. +\end{thebibliography} +\begin{center}$\ast$\ $\ast$\ $\ast$\end{center} +\bigskip +%--------------------------------------------------------------------- +\end{document} +%%% Variables locales: +%%% modo: LaTeX +%%% TeX-master: t +%%% codificación: utf8 +%%% Fin: |