From a7d8e2d9eea346f25f88fd622a988d395b790778 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Mon, 10 Jul 2006 21:01:04 +0000 Subject: new package randbild (11apr06) git-svn-id: svn://tug.org/texlive/trunk@1800 c570f23f-e606-0410-a88d-b1316a301751 --- .../texmf-dist/source/latex/randbild/randbild.dtx | 285 +++++++++++++++++++++ .../texmf-dist/source/latex/randbild/randbild.ins | 64 +++++ 2 files changed, 349 insertions(+) create mode 100644 Master/texmf-dist/source/latex/randbild/randbild.dtx create mode 100644 Master/texmf-dist/source/latex/randbild/randbild.ins (limited to 'Master/texmf-dist/source/latex/randbild') diff --git a/Master/texmf-dist/source/latex/randbild/randbild.dtx b/Master/texmf-dist/source/latex/randbild/randbild.dtx new file mode 100644 index 00000000000..5b5e9fcd10b --- /dev/null +++ b/Master/texmf-dist/source/latex/randbild/randbild.dtx @@ -0,0 +1,285 @@ +% \iffalse meta-comment +% +%% (C) 2005-2006 Paul Ebermann +%% +%% Package randbild, zum Setzen von Bildern von Kurven am Rand +%% der Seite. +%% Die Datei randbild.dtx sowie die dazugehörige +%% randbild.ins sowie die damit generierte +%% randbild.sty stehen unter der +%% "LaTeX Project Public License" (LPPL, zu finden +%% unter http://www.latex-project.org/lppl/, sowie +%% auch in den meisten TeX-Distributionen in +%% texmf/docs/latex/base/lppl*.txt), Version 1.3b oder +%% später (nach Wahl des Verwenders). +%% +%% Der 'maintenance-status' ist (zur Zeit) 'author-maintained'. +%% +%% Das heißt u.a., die Dateien dürfen frei vertrieben werden, +%% bei Änderungen (durch andere Personen als Paul Ebermann) +%% ist aber der Name der Datei zu ändern. +% +% \fi +% +% \iffalse +%\NeedsTeXFormat{LaTeX2e}[2003/12/01] +%\ProvidesPackage{randbild} +% [2006/04/04 v0.1b Bild am Seitenrand (PE)] +% +%<*driver> +\documentclass[draft]{ltxdoc} +\usepackage{randbild} +\usepackage{pauldoc} +\begin{document} + \DocInput{randbild.dtx} +\end{document} +% +% \fi +% +% \CheckSum{34} +% +% +% \changes{v0.0}{2005/12/11}{Anfang der Fassung als DTX} +% \changes{v0.1}{2006/02/12}{erste veröffentlichte Version} +% +% \GetFileInfo{randbild.sty} +% +% +% \title{Das \pack{randbild}-Package -- Mini-Kurven auf dem Rand\thanks{% +% Dieses Dokument gehört zu \pack{randbild}~\fileversion, +% vom~\filedate.}} +% \author{Paul Ebermann\thanks{\texttt{Paul-Ebermann@gmx.de}}} +% +% \maketitle +% +% \begin{abstract} +% Dieses Paket ermöglicht es mit den beiden Umgebungen 'randbild' und 'randbildbasis', +% bequem kleine Graphen von Kurven am Seitenrand zu setzen. +% \end{abstract} +% +% \tableofcontents +% +% \section{Benutzerdoku} +% +% Dieses Paket wird wie üblich mit '\usepackage{randbild}' +% eingebunden. Optionen gibt es keine. +% +% \subsection{Befehle} +% +% \DescribeEnv{randbild} +% Dieses Package stellt die Umgebung 'randbild' zur Verfügung. +% Damit kann man kleine veranschauende Bilder auf dem Rand der +% Seite unterbringen. Verwendung: +%\begin{quote} +% ' \begin{randbild}'\oarg{Titel}\marg{$x_1,y_1$}\marg{$x_2,y_2$}\\ +% ' '\meta{inhalt}\\ +% ' \end{randbild}' +%\end{quote} +% +% Dabei geben \meta{Titel} eine Beschriftung für das Bild (kann weggelassen +% werden), \meta{$x_1,y_1$} die Koordinaten der linken unteren Ecke, +% \meta{$x_2,y_2$} die Koordinaten der rechten oberen Ecke (jeweils in +% Bildkoordinaten) an. Man sollte dabei auf die begrenzte Breite des +% Seiten-Randes achten. +% +% Das Bild erhält ein (beschriftetes) Achsenkreuz -- weitere +% graphische Elemente (also das, was man eigentlich zeichnen will) +% kommen dorthin, wo \meta{inhalt} steht. +% Dabei können alle \pack{pstricks}-Makros, wie etwa '\psplot' oder '\psline' +% verwendet werden. Siehe dazu die \pack{pstricks}-Dokumentation. +% +% Beispiel: +% \begin{randbild}[Normalparabel]{-2,-.5}{2.2,2.5} +% \psplot{-1.6}{1.6}{ x x mul } +% \end{randbild} +%\begin{verbatim} +% \begin{randbild}[Normalparabel]{-2,-.5}{2.2,2.5} +% \psplot{-1.6}{1.6}{ x x mul } +% \end{randbild} +%\end{verbatim} +% +% \DescribeEnv{randbildbasis} +% Die Umgebung 'randbildbasis' funktioniert genauso wie 'randbild', nur +% wird kein Achsenkreuz gezeichnet. +% +% \DescribeMacro{\showgrid} +% Mit dem Makro '\showgrid' kann man seinem Bild ein +% Koordinaten-Gitter hinzufügen. Es ist also innerhalb der +% Umgebungen zu verwenden. +% \begin{randbild}[Beispiel mit Gitter]{-2.5,-2.5}{2.5,2.5} +% \showgrid +% \end{randbild} +% +% \subsection{Bildkoordinaten} +% Jedes Bild erhält sein eigenes Koordinatensystem. Die Einheiten sind +% jeweils halbe Zentimeter. Die Lage des Ursprungs wird implizit durch +% die Angabe der Koordinaten der Bild-Ecken gegeben. +% +% \StopEventually{\PrintChanges\PrintIndex} +% +% \CharacterTable +% {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z +% Lower-case \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z +% Digits \0\1\2\3\4\5\6\7\8\9 +% Exclamation \! Double quote \" Hash (number) \# +% Dollar \$ Percent \% Ampersand \& +% Acute accent \' Left paren \( Right paren \) +% Asterisk \* Plus \+ Comma \, +% Minus \- Point \. Solidus \/ +% Colon \: Semicolon \; Less than \< +% Equals \= Greater than \> Question mark \? +% Commercial at \@ Left bracket \[ Backslash \\ +% Right bracket \] Circumflex \^ Underscore \_ +% Grave accent \` Left brace \{ Vertical bar \| +% Right brace \} Tilde \~} +% +% \DoNotIndex{\\,\ ,\begin,\end,\endinput,\RequirePackage, +% \newcommand,\newenvironment,\renewcommand, +% \newsavebox} +% \DoNotIndex{\ } +% +% \section{Implementation} +% +% Mit \pack{pst-plot} werden die Diagramme gezeichnet. +% \pack{pst-plot} lädt auch gleich das Basis-Package \pack{pstricks}. +% \begin{macrocode} +%<*package> +\RequirePackage{pst-plot} +% \end{macrocode} +% +% \begin{macro}{\randbild@box} +% \begin{macro}{\randbild@titel} +% In '\randbild@box' speichern wir später die Box, welche die Grafik enthält. +% In '\randbild@titel' wird der eventuelle Titel des Randbildes gespeichert. +% \begin{macrocode} +\newsavebox{\randbild@box} +\newcommand{\randbild@titel}{bla} +% \end{macrocode} +% \end{macro} +% \end{macro} +% +% \begin{environment}{randbild} +% Die wichtigste (und namensgebende) Umgebung dieses Paketes. +% \begin{macrocode} +\newenvironment*{randbild}[3][\ ]{% +% \end{macrocode} +% Wir rufen hier einfach die Umgebung 'randbildbasis' mit unseren drei Parametern auf. +% \begin{macrocode} + \begin{randbildbasis}[#1]{#2}{#3}% +% \end{macrocode} +% Da drin malen wir jetzt das Koordinatensystem. ('\tiny' bezieht +% sich auf die Größe der Beschriftungen der Achsen.) +% \begin{macrocode} + {\tiny% + \psaxes[ticksize=1pt,labelsep=2pt]{->}(0,0)(#2)(#3){}% + }% +}{% +% \end{macrocode} +% Am Ende dieser Umgebung beenden wir natürlich auch 'randbildbasis'. +% \begin{macrocode} + \end{randbildbasis} +} +% \end{macrocode} +% \end{environment} +% \begin{environment}{randbildbasis} +% \changes{v0.1}{2006/01/26}{Neu (als Abspaltung von 'randbild')} +% 'randbildbasis' macht die eigentliche Arbeit. +% \begin{macrocode} +\newenvironment*{randbildbasis}[3][\ ]{% +% \end{macrocode} +% Da wir am Ende der Umgebung leider nicht mehr auf die Parameter +% zugreifen können, müssen wir uns den Titel hier merken. +% \begin{macrocode} + \renewcommand{\randbild@titel}{#1}% +% \end{macrocode} +% Wir setzen zunächst die Maßeinheit ('unit') und die +% Linienbreite für unsere Zeichnung auf passende Werte. +% \begin{macrocode} + \psset{linewidth=.5pt,unit=0.5cm} +% \end{macrocode} +% Da es '\fbox' und '\marginpar' leider nicht in Umgebungsform gibt, müssen wir +% zunächst (mit 'lrbox') eine Box erstellen und als '\randbild@box' speichern, um +% sie nachher mit einem Rahmen versehen und in den Rand stellen zu können. +% \begin{macrocode} + \begin{lrbox}{\randbild@box}% +% \end{macrocode} +% Hier beginnen wir eine 'pspicture'-Umgebung passener Größe. Der Inhalt +% der 'randbildbasis'-Umgebung wird dann Inhalt der 'pspicture'-Umgebung, +% hier kann man also nach Herzenslust pstricks-Befehle nutzen. +% \begin{macrocode} + \begin{pspicture}(#2)(#3)% +}{% +% \end{macrocode} +% Am Ende der 'randbildbasis'-Umgebung beenden wir zunächst die 'pspicture'-Umgebung +% und dann die 'lrbox'-Umgebung (womit das alles nicht gezeichnet, sondern in +% der Box '\randbild@box' gespeichert wird). +% \begin{macrocode} + \end{pspicture}% + \end{lrbox}% +% \end{macrocode} +% Jetzt kommt die eigentliche Ausgabe. +% Wir beginnen einen "`Rand-Absatz"' \dots +% \begin{macrocode} + \marginpar{% +% \end{macrocode} +% \dots, in welchem alles (horizontal) zentriert ist. +% \begin{macrocode} + \centering% +% \end{macrocode} +% Dies betrifft zunächst das Bild ('\usebox{\randbild@box}'), welches +% am Rand rundum abgeschnitten wird (0.1 cm Abstand), und einen Rahmen +% bekommt. +% \begin{macrocode} + \fbox{\clipbox[0.2]{\usebox{\randbild@box}}}% +% \end{macrocode} +% Auf einer weiteren Zeile (mit wenig Abstand) \dots +% \begin{macrocode} + \\[0.2\psunit]% +% \end{macrocode} +% \dots{} folgt nun (in kleiner Schrift) der Titel des Bildes (der ja am Anfang +% als Parameter gesichert wurde). +% \begin{macrocode} + {\small\randbild@titel}% + }% +}% +% \end{macrocode} +% \end{environment} +% \begin{macro}{\showgrid} +% Unser Koordinatengitter ist eine Spezialisierung von 'psgrid'. +% Mit '\newpsobject' legen wir die Parameter fest. +% \begin{macrocode} + \newpsobject{showgrid}{psgrid}% + {% +% \end{macrocode} +% Wir wollen eine keine weitere Unterteilung unseres +% Gitters mit Gitterweite 1. Statt Linien malen wir je +% Einheit fünf Punkte. +% \begin{macrocode} + subgriddiv=1,% + griddots=5,% +% \end{macrocode} +% Die Dicke der (gepunkteten) Linien definieren wir hier als 0.4pt. +% Dagegen setzen wir die Größe der Beschriftung auf 0 (d.h. unsichtbar), +% da ja schon das Achsenkreuz eine Beschriftung darstellt. +% \begin{macrocode} + gridwidth=0.4pt,% + gridlabels=0pt% + } +% \end{macrocode} +% \end{macro} +% Ende. +% \begin{macrocode} +\endinput +% +% \end{macrocode} +% +% \Finale +%\endinput + + +%%% Folgendes ist nur für meinen Editor. +%%% +%%% Local Variables: +%%% mode: latex +%%% TeX-master: t +%%% End: diff --git a/Master/texmf-dist/source/latex/randbild/randbild.ins b/Master/texmf-dist/source/latex/randbild/randbild.ins new file mode 100644 index 00000000000..a581680ef39 --- /dev/null +++ b/Master/texmf-dist/source/latex/randbild/randbild.ins @@ -0,0 +1,64 @@ +%% +%% (C) 2002-2006 Paul Ebermann +%% +%% Der vollständige Urheberrechtshinweis befindet sich +%% am Begin von randbild.dtx. +%% +%% Ich gebe keine Garantie irgendeiner Art. +%% + + + +\input docstrip.tex +\usedir{tex/latex/paul} + +\Msg{**********************************************************} +\Msg{* Ich werde Dateien in \showdirectory{tex/latex/paul} } +\Msg{* installieren. Bitte stellen Sie sicher, } +\Msg{* dass dieses Verzeichnis vorhanden ist. } +\Msg{* } + +%% der folgende Text wird in jeder generierten +%% Datei am Anfang eingefügt. +\preamble + + ,--------------------------------------------------. + | Das ist eine generierte Datei. | + | | + | (c) 2005-2006 Paul Ebermann. | + '--------------------------------------------------' + +\endpreamble + + +\generate{\file{randbild.sty}{\from{randbild.dtx}{package}}} + +\Msg{#######################} +\Msg{# } +\Msg{# Um die Installation zu beenden, } +\Msg{# müssen Sie die folgenden Dateien } +\Msg{# in Ihrem TeX-Suchbaum unterbringen: } +\Msg{# } +\Msg{# randbild.sty } +\Msg{# } +\Msg{# Um eine Dokumentation zu erzeugen, } +\Msg{# benutzen Sie } +\Msg{# } +\Msg{# latex randbild.dtx } +\Msg{# } +\Msg{# Viel Spaß } +\Msg{# Paul Ebermann } +\Msg{# } +\Msg{#######################} + +\endbatchfile + + + + +%%% Folgendes ist nur für meinen Editor. +%%% +%%% Local Variables: +%%% mode: latex +%%% TeX-master: t +%%% End: -- cgit v1.2.3