summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/randbild
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
committerNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
commite0c6872cf40896c7be36b11dcc744620f10adf1d (patch)
tree60335e10d2f4354b0674ec22d7b53f0f8abee672 /macros/latex/contrib/randbild
Initial commit
Diffstat (limited to 'macros/latex/contrib/randbild')
-rw-r--r--macros/latex/contrib/randbild/README141
-rw-r--r--macros/latex/contrib/randbild/randbild.dtx335
-rw-r--r--macros/latex/contrib/randbild/randbild.ins64
-rw-r--r--macros/latex/contrib/randbild/randbild.pdfbin0 -> 179602 bytes
4 files changed, 540 insertions, 0 deletions
diff --git a/macros/latex/contrib/randbild/README b/macros/latex/contrib/randbild/README
new file mode 100644
index 0000000000..18bf2076ad
--- /dev/null
+++ b/macros/latex/contrib/randbild/README
@@ -0,0 +1,141 @@
+[en]
+LaTeX-package 'randbild' - put little plots of curves on the margin.
+
+Author: Paul Ebermann <Paul-Ebermann@gmx.de>
+License: LPPL 1.3b or later, author-maintained
+ (see http://www.latex-project.org/lppl/).
+
+All Documentation (other than this file) is in german.
+
+This package uses 'pst-plot' from the pstricks-bundle.
+
+The typesetting of the documentation needs 'pauldoc' (from the
+same author) and 'amssymb'.
+
+The package comes as .dtx + .ins.
+Run "latex randbild.ins" to create the style file (and maybe put
+it to texmf/tex/latex/paul/, if your docstrip is configured
+accordingly), run (after that and maybe updating your TeX hash)
+"latex randbild.dtx" to create the documentation.
+
+ Usage
+-------
+
+Put
+
+ \usepackage{randbild}
+
+in the document preamble. Then you can use
+the environments 'randbild', 'randbildbasis'
+and the command \showgrid, as well as all the
+pst-plot commands.
+
+ \begin{randbild}[title]{x1,y1}{x2,y2}
+ ...
+ \end{randbild}
+puts a coordinate system, from x1 to x2
+and y1 to y2 (all units are half centimeters),
+with a box around it, and a title, on the
+margin.
+ randbildbasis (or randbild*) works the same way,
+but does not show the axes.
+ \showgrid adds a grid (dotted) - should be called
+inside of one of the environments.
+
+Inside the environments you may use the plot
+commands from pst-plot, such as \psplot, and
+\parametricplot.
+
+Example:
+
+ \begin{randbild}[Parabola]{-2,-.5}{2.2,2.5}
+ \psplot{-1.6}{1.6}{ x x mul }
+ \end{randbild}
+
+
+----------------
+[de]
+LaTeX-Paket 'randbild' - Quotientenstrukturen (und ein schöneres
+Aussehen dieser in LaTeX.)
+
+Autor: Paul Ebermann (Paul-Ebermann@gmx.de).
+Lizenz: LPPL 1.3b oder später, mit Maintenance-Status
+ "author-maintained". Siehe http://www.latex-project.org/lppl/.
+
+Geschrieben für den eigenen Gebrauch
+(-> http://www.math.hu-berlin.de/~ebermann/alg-script/),
+aber vielleicht ist es auch für andere von Nutzen.
+
+Das Paket benötigt 'pst-plot' aus der 'pstricks'-Sammlung.
+Zum Setzen der Dokumentation wird das Paket 'pauldoc'
+(vom selben Autor) benötigt.
+
+Das Paket kommt als .dtx + .ins.
+Mit "latex randbild.ins" wird die .sty-Datei erstellt (und
+eventuell gleich nach texmf/tex/latex/paul/ installiert,
+wenn docstrip entsprechend eingerichtet ist), mit
+latex randbild.dtx kann (danach und eventuell nach einer
+Aktualisierung der TeX-Dateidatenbank) die Dokumentation neu
+erstellt werden.
+
+Zur Verwendung siehe randbild.pdf.
+----------------
+[eo-h]
+LaTeX-pakajho 'randbild' - etaj bildoj che la pagh-margheno
+ en LaTeX.
+
+Autoro: Paulo Ebermann (Paul-Ebermann@gmx.de).
+Licenzo: LPPL 1.3, 'author-maintained'
+ (-> http://www.latex-project.org/lppl/).
+
+Kreitaj por propra uzo, sed eble iom de ghi ankau
+uzeblas por aliaj.
+
+La dokumentaro (escepte tiu chi dosiero) estas nur en la germana
+lingvo.
+
+La pakajho bezonas la pakajhon 'pst-plot' el la pstricks-kolekto.
+Por krei la dokumentadon vi krome bezonas 'pauldoc' (de la sama
+autoro).
+
+La pakajho venas en .dtx + .ins.
+Voku "latex randbild.ins" por krei la .sty-dosieron (kaj
+eble meti ghin al texmf/tex/latex/paul/, se via docstrip estis
+konfigurita laue), voku "latex randbild.dtx" por rekrei
+la dokumentaron.
+
+ Uzado
+-------
+
+Metu
+
+ \usepackage{randbild}
+
+en la komencon de la dokumento (antau \begin{document}).
+
+Poste vi povas uzi la "chirkauojn" 'randbild' kaj
+"randbildbasis" (au "randbild*"), la komandon
+\showgrid kaj chiujn komandojn el 'pst-plot'.
+
+ \begin{randbild}[titolo]{x1,y1}{x2,y2}
+ ...
+ \end{randbild}
+kreas koordinatan sistemon de x1 ghis x2 kaj
+de y1 ghis y2 (chiuj unuoj estas duonaj centimetroj),
+kun kadro chirkau ghi kaj titolo sub ghi, en la
+rando de la pagho.
+ randbildbasis (= randbild*) funkcias same, sed ne
+montras la aksojn de la koordinata sistemo.
+
+ \showgrid montras kradon (el punktoj) - ghi estu uzata
+ene de la "chirkauoj".
+Tie vi ankau povas uzu la plot-komandojn el pst-plot,
+kiel \psplot kaj \parametricplot.
+
+Ekzemplo:
+
+ \begin{randbild}[Parabolo]{-2,-.5}{2.2,2.5}
+ \psplot{-1.6}{1.6}{ x x mul }
+ \end{randbild}
+
+
diff --git a/macros/latex/contrib/randbild/randbild.dtx b/macros/latex/contrib/randbild/randbild.dtx
new file mode 100644
index 0000000000..2ba65bbe00
--- /dev/null
+++ b/macros/latex/contrib/randbild/randbild.dtx
@@ -0,0 +1,335 @@
+% \iffalse meta-comment -*- coding: iso-8859-1 -*-
+%
+%% (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
+%<package>\NeedsTeXFormat{LaTeX2e}[2003/12/01]
+%<package>\ProvidesPackage{randbild}
+%<package> [2007/05/15 v0.2 Bild am Seitenrand (PE)]
+%
+%<*driver>
+\documentclass[draft]{ltxdoc}
+\usepackage{randbild}
+\usepackage{pauldoc}
+\begin{document}
+ \DocInput{randbild.dtx}
+\end{document}
+%</driver>
+% \fi
+%
+% \CheckSum{49}
+%
+%
+% \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}
+% \DescribeEnv{randbild*}
+% Die Umgebung 'randbildbasis' funktioniert genauso wie 'randbild', nur
+% wird kein Achsenkreuz gezeichnet. Ein alternativer Name dafür ist
+% 'randbild*' (weil ich jetzt schon mindestens zum fünften Mal diesen Namen
+% verwendet habe, als ich 'randbildbasis' haben wollte).
+%
+% \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}
+%
+% \changes{v0.2}{2006/09/19}{Verwendung von \cs{@bsphack}
+% und \cs{@Esphack} (bei 'randbild' und 'randbildbasis'),
+% um die Umgebungen an der Verwendungsstelle
+% unbemerkbar zu machen.
+% Außerdem wurden einige überflüssige Leerzeichen (bzw. Zeilenenden)
+% entfernt.}
+% \begin{environment}{randbild}
+% Die wichtigste (und namensgebende) Umgebung dieses Paketes.
+% \begin{macrocode}
+\newenvironment*{randbild}[3][\ ]{%
+% \end{macrocode}
+% Mit '\@bsphack' (und dem '\@Esphack' am Ende) sorgen wir dafür, dass
+% die Umgebung an der Stelle, wo sie verwendet wird, keine Spuren in der
+% Ausgabe hinterlässt -- auch keine doppelten Leerzeichen o.ä.
+% \begin{macrocode}
+ \@bsphack%
+% \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}%
+ \@Esphack%
+}
+% \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}
+ \@bsphack%
+ \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}
+% \changes{v0.2}{2007/05/15}{Bugfix mit Leerzeichen: \cs{ignorespaces}.}
+% Ich habe noch nicht ganz verstanden, warum das folgende '\ignorespaces'
+% notwendig ist, wo doch eigentlich schon 'pspicture' dafür sorgt, dass
+% Leerzeichen (und Zeilenenden) ignoriert werden -- aber leider nicht in
+% Zusammenarbeit mit '\multips'.
+% Jedenfalls habe ich danach etwa zwei Stunden gesucht, bei
+% einem Beispiel wie im Rand\footnote{Für die Darstellung
+% des Beispiels hier (nach Behebung des Bugs) habe ich ein
+% explizites Leerzeichen ({\tt\char`\\\char`\ }) verwendet,
+% im Original war das nur ein ungeschützer Zeilenumbruch.}.
+% \begin{randbild*}[Beispiel]{-2,-2}{2,2}\ %
+% \psset{linewidth=0.2pt}
+% \multips(-2,0)(4,0){2}{\psline(0,-2)(0,2)}
+% \multips(0,-2)(0,4){2}{\psline(-2,0)(2,0)}
+% \end{randbild*}
+% Dieses '\ignorespaces' behebt das Problem.
+% \begin{macrocode}
+ \ignorespaces
+}{%
+% \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}%
+ }%
+ \@Esphack%
+}%
+% \end{macrocode}
+% \end{environment}
+% \begin{environment}{randbild*}
+% \changes{v0.2}{2007/04/26}{Neue Umgebung 'randbild*' als
+% Alias für 'randbildbasis'.}
+% Jetzt definieren wir uns noch einen Alias für 'randbildbasis':
+% \begin{macrocode}
+ \expandafter\let\csname randbild*\endcsname\randbildbasis
+ \expandafter\let\csname endrandbild*\endcsname\endrandbildbasis
+% \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
+%</package>
+% \end{macrocode}
+%
+% \Finale
+%\endinput
+
+
+%%% Folgendes ist nur für meinen Editor.
+%%%
+%%% Local Variables:
+%%% mode: latex
+%%% TeX-master: t
+%%% End:
diff --git a/macros/latex/contrib/randbild/randbild.ins b/macros/latex/contrib/randbild/randbild.ins
new file mode 100644
index 0000000000..a581680ef3
--- /dev/null
+++ b/macros/latex/contrib/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:
diff --git a/macros/latex/contrib/randbild/randbild.pdf b/macros/latex/contrib/randbild/randbild.pdf
new file mode 100644
index 0000000000..635d19753a
--- /dev/null
+++ b/macros/latex/contrib/randbild/randbild.pdf
Binary files differ