summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/pst-calendar
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2009-03-28 22:52:37 +0000
committerKarl Berry <karl@freefriends.org>2009-03-28 22:52:37 +0000
commit48066adf939ff889ed9e33a4a8e5ede53db58d28 (patch)
tree98aec5997b916cfc7614afb4f0f21477f5a6a39a /Master/texmf-dist/doc/latex/pst-calendar
parent88e63a5d68668d620c783cdbf51e0c5bab111b7c (diff)
pst-calendar missing (from Herbert Voss, 28mar09)
git-svn-id: svn://tug.org/texlive/trunk@12554 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/pst-calendar')
-rw-r--r--Master/texmf-dist/doc/latex/pst-calendar/Changes7
-rw-r--r--Master/texmf-dist/doc/latex/pst-calendar/README13
-rw-r--r--Master/texmf-dist/doc/latex/pst-calendar/pst-calendar-docDE.ltx226
-rw-r--r--Master/texmf-dist/doc/latex/pst-calendar/pst-calendar-docDE.pdfbin0 -> 138683 bytes
-rw-r--r--Master/texmf-dist/doc/latex/pst-calendar/pst-calendar-docDE.tex131
-rw-r--r--Master/texmf-dist/doc/latex/pst-calendar/pst-calendar-docFR.pdfbin0 -> 164316 bytes
-rw-r--r--Master/texmf-dist/doc/latex/pst-calendar/pst-calendar-docFR.tex382
7 files changed, 759 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/pst-calendar/Changes b/Master/texmf-dist/doc/latex/pst-calendar/Changes
new file mode 100644
index 00000000000..884b50f3718
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/pst-calendar/Changes
@@ -0,0 +1,7 @@
+..... pst-calendar.sty
+0.47 2005-11-09 first CTAN version
+
+
+..... pst-calendar-docFR.tex
+ 2004-11-09 first CTAN version
+
diff --git a/Master/texmf-dist/doc/latex/pst-calendar/README b/Master/texmf-dist/doc/latex/pst-calendar/README
new file mode 100644
index 00000000000..cf3a6469bf2
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/pst-calendar/README
@@ -0,0 +1,13 @@
+Save the files pst-calendar.sty in a directory, which is part of your
+local TeX tree.
+Then do not forget to run texhash to update this tree.
+For more information see the documentation of your LATEX distribution
+on installing packages into your LATEX distribution or the
+TeX Frequently Asked Questions:
+(http://www.tex.ac.uk/cgi-bin/texfaq2html?label=instpackages).
+
+pst-calendar needs pstricks, fp, pst-3d, multido and pst-xkey
+which should be all part of your
+local TeX installation, otherwise get it from a CTAN server, f.ex.
+ftp://ftp.ctan.org
+
diff --git a/Master/texmf-dist/doc/latex/pst-calendar/pst-calendar-docDE.ltx b/Master/texmf-dist/doc/latex/pst-calendar/pst-calendar-docDE.ltx
new file mode 100644
index 00000000000..caa831ddd34
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/pst-calendar/pst-calendar-docDE.ltx
@@ -0,0 +1,226 @@
+\documentclass[11pt,a4paper,ngerman]{article}
+\usepackage[latin1]{inputenc}%
+\usepackage[T1]{fontenc}
+\usepackage{babel}
+\usepackage{lmodern}
+\parindent=0pt
+\parskip=5pt plus 3pt minus 2pt
+\usepackage{enumerate,longtable,url}
+\let\OldUrl=\url
+\renewcommand\url[1]{\protect\OldUrl{#1}}
+
+\usepackage[scaled]{luximono}
+%
+\usepackage{xspace,nonfloat}
+\usepackage[bottom]{footmisc}
+%
+\usepackage{tabularx}
+\usepackage{longtable}
+\usepackage{ltxtable}
+\usepackage{varioref}
+\usepackage[NewCommands,NewParameters]{ragged2e}
+\usepackage{url}
+\def\UrlFont{\ttfamily}
+\makeatletter
+%\def\verbatim@font{\small\normalfont\ttfamily}
+%
+\usepackage[dvipsnames,prologue,table]{pstricks}
+\colorlet{tableheadcolor}{gray!25}
+\colorlet{tablerowcolor}{gray!12}
+\newcommand\XCBox[1]{\fcolorbox{black}{#1}{\phantom{aa}} \small #1}
+\usepackage{pst-calendar}
+\let\PSTfileversion\fileversion
+\SpecialCoor
+\psset{griddots=10,subgriddiv=0,gridlabels=7pt}
+%
+\definecolor{hellgelb}{rgb}{1,1,0.8}
+\definecolor{shadecolor}{rgb}{0.9,0.9,0.9}
+\definecolor{sphgrau}{rgb}{0.40,0.40,0.40}
+%
+% ------------------------------- Namen Abkuerungen ----------------------
+\newcommand{\La}%
+ {L\kern-.36em
+ {\setbox0\hbox{T}%
+ \vbox to\ht0{\hbox{$\m@th$%
+ \csname S@\f@size\endcsname
+ \fontsize\sf@size\z@
+ \math@fontsfalse\selectfont
+ A}%
+ \vss}%
+ }}
+\def\AllTeX{(\La\kern-.075em)\kern-.075em\TeX\xspace}
+\def\AMS{American Mathematical Society\xspace}
+\def\AmS{$\mathcal{A}$\kern-.1667em\lower.5ex\hbox
+ {$\mathcal{M}$}\kern-.125em$\mathcal{S}$}
+\def\AmSLaTeX{\AmS-\LaTeX\xspace}
+\let\latex\LaTeX
+\let\tex\TeX
+%
+\def\BibTeX{\textsc{Bib}\kern-.08em\TeX\index{BiBTeX@Bib\TeX}}
+\def\PT{Plain \TeX\index{Plain TeX@Plain \TeX}\xspace}
+\def\PST{{\texttt{PSTricks}}\xspace}
+\def\CTAN{{\texttt{CTAN}}\index{CTAN}\xspace}
+\def\PDF{{\texttt{PDF}}\xspace}
+\def\pst{{\texttt{pstricks}}\xspace}
+\def\PS{PostScript\xspace}
+\def\CT{Con\TeX t\index{ConTeXt@Con\TeX t}\xspace}
+\def\GS{Ghostscript\index{Ghostscript}\xspace}
+\def\GeX{G\kern-.1667em\lower.5ex\hbox{E}\kern-.125emX\@}
+\def\at{\char064}
+\def\VTeX{\texttt{V\TeX}\index{VTeX@\texttt{V\protect\TeX}}}
+\newcommand*\CMD[1]{{\texttt{\textbackslash #1}}}
+\newcommand\Paket[1]{\texttt{#1}}
+\providecommand\Programm[1]{\textsf{#1}}
+\providecommand\RaggedRight{\raggedright}
+%
+\def\Index#1{\index{#1}#1}
+\index{Environment|see{Umgebung}}
+\def\eIndex#1{\index{Umgebung!#1@\texttt{#1}}\index{#1@\texttt{#1}}}
+\def\tIndex#1{\index{#1@\texttt{#1}}}
+\def\cIndex#1{\index{#1@\protect\CMD{#1}}}
+\def\pIndex#1{\index{Parameter@\textbf{Parameter}!#1@\texttt{#1}}\index{#1@\texttt{#1}}}
+\def\ppIndex#1{\index{Parameter@\textbf{Parameter}!#1@\texttt{#1}}}
+\def\sIndex#1{\index{Syntax@\textbf{Syntax}!\protect\CMD{#1}}}
+\def\csIndex#1{\sIndex{#1}\cIndex{#1}}
+\def\PIndex#1{\index{Paket@\textbf{Paket}!\texttt{#1}}}
+\def\mIndex#1{\texttt{#1}\tIndex{#1}\pIndex{#1}}
+\def\aref#1{$\rightarrow$\vref{#1}}
+\def\PSindex#1{\index{PostScript!#1}}
+\def\Makroindex#1{\index{Makro!#1@\protect\CMD{#1}}}
+\def\Optindex#1{\index{Parameter@\textbf{Parameter}!\texttt{#1}}}
+\def\ttindex#1{\index{#1@\texttt{#1}}}
+\def\vert{\ensuremath{|}}
+%
+\let\Olddegrees\textdegrees
+\def\textdegrees{\ensuremath{\mbox{\Olddegrees}}}
+\def\sa{\ensuremath{\sphericalangle}\xspace}% needs amssymb
+%
+%
+%%-------------------------------- danger ---------------------------------------------
+\usepackage{manfnt}
+\usepackage{lettrine}
+\newsavebox{\dBox}
+
+\newenvironment{dangerPar*}
+{\gdef\dangerSym{\dbend\,\dbend}\@dangerPar}
+{\end@dangerPar}
+
+\newenvironment{dangerPar}
+{\gdef\dangerSym{\dbend\phantom{\,\dbend}}\@dangerPar}
+{\end@dangerPar}
+
+\def\@dangerPar{%
+ \begin{lrbox}{\dBox}
+ \minipage[c]{\linewidth-\widthof{\dangerSym}-\columnsep}%
+}
+\def\end@dangerPar{%
+ \endminipage
+ \end{lrbox}%
+ \trivlist\item\relax
+ \noindent
+ \minipage[c]{\widthof{\dangerSym}}
+ \raisebox{\height}[.9\height][.1\height]{\dangerSym}% ???
+ \endminipage
+ \hfill
+ \minipage[c]{\wd\dBox}
+ \usebox{\dBox}
+ \endminipage%
+ \endtrivlist
+}
+\newsavebox{\bombbox}
+\sbox\bombbox{%
+ \psset{unit=.55ex}%
+ \begin{pspicture}(-4,-4)(4,4)
+ \pscircle[fillcolor=gray,fillstyle=solid]{4}
+ \rput{45}{\psscaleboxto(6,0){\textsf{\textbf{PS}}}}
+ \psellipse*(0,3.8)(1,.2)
+ \psellipse*(0,5.5)(1,.2)
+ \psframe*(-1,3.8)(1,5.5)
+ \psbezier(0,5.5)(0,7)(1,8)(3.5,8)
+ \multido{\r=-0+40}{9}{\rput{\r}(3.5,8){\psline(0,0)(.4,0)}}
+ \end{pspicture}}
+
+\newcommand\danger{%
+ \lettrine[lines=2,lraise=0.65,nindent=0pt,findent=.5em]{{\small\dbend}}}
+
+\newcommand\ddanger{%
+ \lettrine[lines=2,lraise=0.65,nindent=0pt,findent=.5em]{%
+ {\small\dbend\,\dbend}}}
+
+\newcommand\DANGER{%
+ \lettrine[lines=3,lraise=0.01,lhang=0,nindent=0pt,findent=.75em]{%
+ \usebox\bombbox}}
+%%------------------------------- Rest ------------------------------------------
+\pretolerance=500
+\tolerance=1000
+\hbadness=3000
+\vbadness=3000
+\hyphenpenalty=400
+
+%-------------------------------- Listings -------------------------------------
+\usepackage{showexpl}% not a real PSTricks package
+%
+\renewcommand{\ttdefault}{ul9}% Luxi Mono
+%\lstset{language=PSTricks,keywordstyle=\small\fontfamily{ul9}\bfseries}
+\lstset{wide=true}
+%
+%-------------------------------- Allgemein -------------------------------------
+%\addtolength\belowcaptionskip{-10pt}
+%
+\providecommand\dante{DANTE \eV}
+\providecommand\eV{e.V\kern-.18em\@ifnextchar.{}{.}}
+\def\textat{\protect\makeatletter\texttt{@}\protect\makeatother}
+
+\def\lBrace{\texttt{\{}}
+\def\rBrace{\texttt{\}}}
+\def\lBracket{\texttt{[}}
+\def\rBracket{\texttt{]}}
+%
+\newcounter{SX@refC}% for texlive8
+\def\PSTemph#1{\textit{\texttt{#1}}}
+%
+\def\LPack#1{\texttt{#1}\PIndex{#1}}
+\def\Lmenv#1{\texttt{#1}\eIndex{#1}}
+\def\Lmcs#1{\CMD{#1}\Makroindex{#1}\cIndex{#1}}
+\let\xLcs\Lmcs
+\let\Lmsyn\Lmcs
+\let\Lcs\CMD
+\let\Lit\texttt
+\def\Loption#1{\texttt{#1}\Optindex{#1}\ttindex{#1}}
+\def\LProg#1{\texttt{#1}\pIndex{#1}}
+\let\Prog\LProg
+\def\LFile#1{\texttt{#1}\tIndex{#1}}
+\def\LColor#1{\texttt{#1}\index{Farbe!#1@\texttt{#1}}}
+\def\Lindex#1{#1\index{#1}}% Ausgeben und in den Index
+\def\Lext#1{\texttt{#1}\index{Dateiendung!#1@\texttt{#1}}}
+\def\LClass#1{\texttt{#1}}
+\def\Lmnotation#1{\texttt{#1}\tIndex{#1}}
+\newcommand\Larga{}
+\DeclareRobustCommand\Larga[1]{$\langle$\PSTemph{#1}$\rangle$}
+\newcommand\LargA{}
+\DeclareRobustCommand\LargA[1]{\lBrace$\langle$\PSTemph{#1}$\rangle$\rBrace}
+\newcommand\Largs{}
+\DeclareRobustCommand\Largs[1]{\lBracket$\langle$\PSTemph{#1}$\rangle$\rBracket}
+\newcommand\Largb{}
+\DeclareRobustCommand\Largb[1]{\lBrace$\langle$\PSTemph{#1}$\rangle$\rBrace}
+\newcommand\Largr{}
+\DeclareRobustCommand\Largr[1]{\PSTemph{({#1})}}
+\DeclareRobustCommand\Largra[1]{(\Larga{#1})}
+\newcommand\Larg{}
+\DeclareRobustCommand\Larg[1]{\lBrace\texttt{#1}\rBrace}
+\def\begEnv#1{\CMD{begin\{#1\}}\tIndex{#1}}
+\def\endEnv#1{\CMD{end\{#1\}}}
+\def\OptArg{\Largs{Optionen}}
+\def\Largrao{($\langle x_0,y_0\rangle$)}
+\def\Largrai{($\langle x_1,y_1\rangle$)}
+\def\Largraii{($\langle x_2,y_2\rangle$)}
+\def\Largraiii{($\langle x_3,y_3\rangle$)}
+\def\Largran{($\langle x_n,y_n\rangle$)}
+%
+\input random
+%
+\begin{document}
+
+\input{pst-calendar-docDE}
+
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/pst-calendar/pst-calendar-docDE.pdf b/Master/texmf-dist/doc/latex/pst-calendar/pst-calendar-docDE.pdf
new file mode 100644
index 00000000000..86ae9dbb863
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/pst-calendar/pst-calendar-docDE.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/pst-calendar/pst-calendar-docDE.tex b/Master/texmf-dist/doc/latex/pst-calendar/pst-calendar-docDE.tex
new file mode 100644
index 00000000000..23522d6f7ac
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/pst-calendar/pst-calendar-docDE.tex
@@ -0,0 +1,131 @@
+\title{\texttt{PST-Calendar} - plotting calendars\\
+\footnotesize{version \PSTfileversion}}
+\author{%
+Manuel Luque\thanks{\url{Mluque5130@aol.com}} and
+Herbert Vo\ss\thanks{\url{voss@pstricks.de}}}
+\date{\today}
+\maketitle
+
+\begin{abstract}
+\texttt{pst-calendar} stellt zwei Makros für das Erstellen von Kalenderblättern
+oder Kalender-Dodekaedern. Der Monat und das Jahr können frei gewählt werden,
+wobei Kalender nur zwischen 2000 und 2099 möglich sind. Die Berechnung
+erfolgt ausschließlich mit den Makros des \LPack{fp}-Pakets.
+\end{abstract}
+
+%\tableofcontents
+
+
+\section{\LPack{pst-calendar} -- Verschiedene Kalenderoperationen}
+
+Das Paket hat die drei Optionen \Loption{french}, \Loption{english} und \Loption{ngerman}.
+Standardmäßig wird \verb+english+ ausgewählt, womit die Monats- und WOchennamen dann
+in eben dieser Sprache ausgegeben werden. Für die Dokumentation wurde \verb+ngerman+
+ausgewählt.
+
+
+Dieses Paket bietet keine Kalenderoperationen im mathematischen Sinne, sondern erlaubt
+die Ausgabe von Kalenderblättern. \LPack{pst-calendar} verfügt über speziellen Sprachanpassungen
+für Englisch (Standard),Französisch und Deutsch. Dies bezieht sich auch auf die Optionen, die
+in Tabelle~\ref{tab:calendrier:options} zusammengestellt sind.
+Es existiert keine spezielle
+\TeX-Version, sodass hier spezielle Anpassungen nötig werden, wenn nicht mit \LaTeX\
+gearbeitet wird.
+
+\Lmsyn{psCalendar}\OptArg\\
+\Lmsyn{psCalDodecaeder}\OptArg
+
+Ohne Angabe von Daten wird immer vom aktuellen Tagesdatum ausgegangen und der entsprechende Monat
+für \Lmcs{psCalendar} und die entsprechenden Monate für \Lmcs{psCalDodecaeder} ausgegeben.
+\begin{table}[htb]
+\caption{Zusammenstellung der verfügbaren Optionen für \texttt{calendrierfp}}\label{tab:calendrier:options}
+\begin{tabularx}{\linewidth}{@{}ll@{}c>{\RaggedRight}X@{}}
+\emph{Name} & \emph{Wert} & \emph{Vorgabe} & \emph{Bedeutung}\\\hline
+\Loption{Jahr} & \Larga{Integer} & \verb+\number\year+ & betrachteter Jahr\\
+\Loption{Monat} & \Larga{$1\ldots 12$} & \verb+\number\month+ & betrachteter Monat\\
+\Loption{MonatT} & \Larga{$1\ldots 12$} & \verb+\number\month+ & Markierung des aktuellen Tages im angegebenen Monat\\
+\Loption{Tag} & \Larga{$1\ldots 31$} & \verb+\number\day+ & betrachteter Monat\\
+\Loption{style} & \Larga{Monat} & \verb+\number\month+ & vorne liegender Monat beim Dodekaeder
+\end{tabularx}
+\end{table}
+
+
+\bgroup
+\begin{LTXexample}[pos=t]
+\psscalebox{0.5}{\psCalendar}
+\psscalebox{0.5}{\psCalendar[Jahr=2006,Monat=1]}
+\psscalebox{0.5}{\psCalendar[Jahr=2006,Tag=23,Monat=2,MonatT=2]}
+\end{LTXexample}
+\egroup
+
+Das einzige Problem sind die Feiertage, die bislang noch ausschließlich auf den französichen
+Vorgaben aufbauen. Die entsprechenden Kode-Sequenzen in dem Paket sind jedoch leicht zu
+erkennen und entsprechend zu ändern. Die Ausgabe eines kompletten Jahres lässt sich
+mithilfe des \Lmcs{multido}-Makros leicht realisieren.
+
+
+\begin{center}
+\bgroup
+\multido{\iM=1+3}{4}{%
+ \multido{\iMM=\iM+1}{3}{\psscalebox{0.5}{\psCalendar[Jahr=2006,Monat=\iMM]}}\\}
+\egroup
+\end{center}
+
+\begin{lstlisting}
+\multido{\iM=1+3}{4}{%
+ \multido{\iMM=\iM+1}{3}{\psscalebox{0.5}{\psCalendar[Jahr=2006,Monat=\iMM]}}\\}
+\end{lstlisting}
+
+Eine weitaus ansprechendere Ausgabe ermöglicht \Lmcs{psCalDodecaeder}, welcher die
+Monate auf den Seiten eines Dodekaeders\index{Dodekaeder} anordnet. Ohne Angabe irgendeines
+Monates beziehungsweise Jahres wird grundsätzlich vom Januar des aktuellen Jahres
+ausgegangen. Mit der Option \Loption{style}\verb+=+\Larga{Monat} kann man jederzeit
+einen anderen Monat auf die Vorderseite platzieren.
+
+\bgroup
+\begin{LTXexample}[pos=t]
+\psscalebox{0.2}{\psCalDodecaeder}\hfill
+\psscalebox{0.2}{\psCalDodecaeder[Jahr=2006,Monat=1]}\hfill
+\psscalebox{0.2}{\psCalDodecaeder[Jahr=2006,style=April]}
+\end{LTXexample}
+\egroup
+
+\begin{center}
+\bgroup
+\psscalebox{0.2}{\psCalDodecaeder[Jahr=2006,style=Januar]}\hfill
+\psscalebox{0.2}{\psCalDodecaeder[Jahr=2006,style=Februar]}\hfill
+\psscalebox{0.2}{\psCalDodecaeder[Jahr=2006,style=Maerz]}\\
+\psscalebox{0.2}{\psCalDodecaeder[Jahr=2006,style=April]}\hfill
+\psscalebox{0.2}{\psCalDodecaeder[Jahr=2006,style=Mai]}\hfill
+\psscalebox{0.2}{\psCalDodecaeder[Jahr=2006,style=Juni]}\\
+\psscalebox{0.2}{\psCalDodecaeder[Jahr=2006,style=Juli]}\hfill
+\psscalebox{0.2}{\psCalDodecaeder[Jahr=2006,style=August]}\hfill
+\psscalebox{0.2}{\psCalDodecaeder[Jahr=2006,style=September]}\\
+\psscalebox{0.2}{\psCalDodecaeder[Jahr=2006,style=Oktober]}\hfill
+\psscalebox{0.2}{\psCalDodecaeder[Jahr=2006,style=November]}\hfill
+\psscalebox{0.2}{\psCalDodecaeder[Jahr=2006,style=Dezember]}
+\egroup
+\end{center}
+
+\begin{lstlisting}
+\psscalebox{0.2}{\psCalDodecaeder[Jahr=2006,style=Januar]}\hfill
+\psscalebox{0.2}{\psCalDodecaeder[Jahr=2006,style=Februar]}\hfill
+\psscalebox{0.2}{\psCalDodecaeder[Jahr=2006,style=Maerz]}\\
+\psscalebox{0.2}{\psCalDodecaeder[Jahr=2006,style=April]}\hfill
+\psscalebox{0.2}{\psCalDodecaeder[Jahr=2006,style=Mai]}\hfill
+\psscalebox{0.2}{\psCalDodecaeder[Jahr=2006,style=Juni]}\\
+\psscalebox{0.2}{\psCalDodecaeder[Jahr=2006,style=Juli]}\hfill
+\psscalebox{0.2}{\psCalDodecaeder[Jahr=2006,style=August]}\hfill
+\psscalebox{0.2}{\psCalDodecaeder[Jahr=2006,style=September]}\\
+\psscalebox{0.2}{\psCalDodecaeder[Jahr=2006,style=Oktober]}\hfill
+\psscalebox{0.2}{\psCalDodecaeder[Jahr=2006,style=November]}\hfill
+\psscalebox{0.2}{\psCalDodecaeder[Jahr=2006,style=Dezember]}
+\end{lstlisting}
+
+\iffalse
+\nocite{*}
+\bibliographystyle{plain}
+\bibliography{pst-labo-doc}
+\fi
+
+\endinput \ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/pst-calendar/pst-calendar-docFR.pdf b/Master/texmf-dist/doc/latex/pst-calendar/pst-calendar-docFR.pdf
new file mode 100644
index 00000000000..f522579e219
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/pst-calendar/pst-calendar-docFR.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/pst-calendar/pst-calendar-docFR.tex b/Master/texmf-dist/doc/latex/pst-calendar/pst-calendar-docFR.tex
new file mode 100644
index 00000000000..cce06c5ef1f
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/pst-calendar/pst-calendar-docFR.tex
@@ -0,0 +1,382 @@
+\documentclass{article}
+\usepackage[latin1]{inputenc}%
+\usepackage[T1]{fontenc}
+\usepackage[a4paper,margin=2cm]{geometry}
+%% Manuel LUQUE <Mluque5130aol.com> %%
+%% 1 Octobre 1999 pour le dodécaèdre %%
+%% 23 avril 2003 pour le calendrier %%
+%% 26 avril : calcul de la date de Pâques %%
+%% 27 avril 20003 : repérer une date particulière,
+%% suggestion de Jean-Michel Sarlat %%
+%% jours fériés : 1 et 8 mai, 1 et 11 décembre
+%% 25 août et lundi de Pâques
+\pagestyle{empty}
+%
+\usepackage[french]{pst-calendar}
+%
+\usepackage{url}
+\newcommand\Encadre[1]{\psframebox[fillstyle=solid,fillcolor=yellow,linecolor=red]{#1}}
+\title{Calculer un calendrier avec \LaTeX{},\\
+le dessiner en 3D avec PSTricks (version 0.47)}
+\author{Manuel Luque}
+\date{\today}
+\begin{document}
+
+\maketitle
+%{\typein[\Year]{Entrez l'année (2000...2099)?}
+%\def\Year{2006}
+\begin{center}
+\psset{An=2006}
+\begin{tabular}{ll}
+\psCalendar[Mois=1]&\psCalendar[Mois=2]\\
+\psCalendar[Mois=3]&\psCalendar[Mois=4]\\
+\psCalendar[Mois=5]&\psCalendar[Mois=6]
+\end{tabular}
+
+\end{center}
+\begin{center}
+\begin{tabular}{ll}
+\psCalendar[Mois=7]&\psCalendar[Mois=8]\\
+\psCalendar[Mois=9]&\psCalendar[Mois=10]\\
+\psCalendar[Mois=11]&\psCalendar[Mois=12]
+\end{tabular}
+\end{center}
+%}
+\begin{center}
+\psscalebox{0.5}{\psCalDodecaeder[Vx=-\rd,Vy=\rc,Vz=0,viewangle=198]}
+\end{center}
+\section{Objectifs, outils et méthodes adoptés}
+\subsection{Objectifs}
+Il s'agissait de calculer avec \LaTeX{}, un calendrier valable de l'an
+2\,000 à l'an 2\,099 (je suis optimiste), puis d'adopter une méthode
+originale de représentation en 3D, en plaçant chaque mois sur l'une des
+faces d'un dodécaèdre. Un calendrier de ce type était, il y quelques années,
+offert par les visiteurs médicaux des laboratoires \textsc{Pfizer}.
+\subsection{Outils adoptés}
+Il existe déjà un calendrier écrit en \LaTeX{}, dont les calculs sont faits
+directement en \TeX{}. Il s'agit de \texttt{calendar}, écrit par Michael
+Barret et disponible sur le serveur du \texttt{CTAN} ; c'est très bien fait.
+
+Un calendrier en 3D, dessiné avec PSTricks, est déjà proposé depuis plusieurs d'années par Denis
+Girou sur : \url{http://tug.org/applications/PSTricks/More}.
+
+Donc, rien de neuf, mais revu à ma façon : pour ma part j'ai décidé d'utiliser les macros du package \texttt{fp} de Michael
+Mehlich, qui forment un excellent outil de calcul. La lecture du code écrit
+avec ce package est plus compréhensible que celui écrit en \TeX{} de base.
+
+Pour la représentation en 3d, j'ai aussi, utilisé PSTricks de Timothy Van Zandt, et
+en particulier l'extension \texttt{pst-3d}.
+\subsection{Méthode adoptée}
+La méthode de calcul des jours de semaine du calendrier est déduite de quelques
+observations :
+\begin{enumerate}
+ \item Le 1 janvier 2\,000 est un samedi. On adopte la convention de
+ représenter les jours de semaine par un numéro : j'ai choisi :
+\begin{center}
+ \renewcommand{\arraystretch}{1.5}
+ \begin{tabular}{ccccccc}
+ lundi&mardi&mercredi&jeudi&vendredi&samedi&dimanche\\ \hline
+ 1&2&3&4&5&6&7
+ \end{tabular}
+\end{center}
+ \item Une année ordinaire comprend 365 jours, or $365=52\times7+1$. Il y a
+ donc un décalage de 1~jour dans le nom des jours pour l'année suivante si
+ elle est ordinaire elle aussi. Autrement dit le 1~janvier 2\,001 devrait
+ être un dimanche ($6+1=7$). Or l'an 2\,000 est bissextile et comporte 366~jours : le
+ décalage sera de 2, le 1~janvier 2\,001 correspondra au numéro $6+2=8=1\ (modulo\ 7)$.
+ \item Sur la période retenue 2\,000/2\,099 les années divisibles par 4 :
+ 2\,000, 2\,004, 2\,008 etc. sont bissextiles. On déterminera donc si
+ l'année choisie est bissextile en testant si elle est un multiple de~4.
+\begin{verbatim}
+% test d'une année bissextile
+\FPeval{\YearBissextil}{(\psk@CalendrierA)/4}
+\FPtrunc{\YearBissextil}{\YearBissextil}{0}
+\FPeval{\YearBissextil}{(\YearBissextil)*4}
+\FPtrunc{\YearBissextil}{\YearBissextil}{0}
+\ifnum\YearBissextil=\psk@CalendrierA
+etc.
+\end{verbatim}
+ \item Pour une année choisie, on calculera le décalage par rapport à
+ 2\,000, en comptant les années et en ajoutant 1 chaque fois qu'il y aura
+ dans cet intervalle une année bissextile (en tenant compte de 2\,000).
+ \item On retient pour le début de chaque mois :
+\begin{center}
+ \renewcommand{\arraystretch}{1.5}
+ \begin{tabular}{c|c|c}
+ mois&année ordinaire&année bissextile\\ \hline
+ janvier&1&1\\
+ février&32&32\\
+ mars&60&61\\
+ avril&91&92\\
+ mai&121&122\\
+ juin&152&153\\
+ juillet&182&183\\
+ août&213&214\\
+ septembre&244&245\\
+ octobre&274&275\\
+ novembre&305&306\\
+ décembre&335&336\\
+ \end{tabular}
+\end{center}
+\end{enumerate}
+
+
+
+
+\section{L'utilisation}
+\subsection{Utilisation simple}
+Si on veut voir uniquement le mois de l'année choisie, on fera, par exemple :
+\begin{verbatim}
+\psCalendar[An=2099,Mois=12,Jour=25,MoisChoisi=12]
+\end{verbatim}
+\begin{center}
+\psCalendar[An=2099,Mois=12,Jour=25,MoisChoisi=12]
+\end{center}
+Cette étude ne teste pas si les valeurs introduites pour l'année(\texttt{An}) et le mois(\texttt{Mois}), sont correctes !
+
+Par défaut, la commande \verb+\psCalendar+ affiche le mois et l'année en
+cours et entoure la date du jour (suggestion de Jean-Michel \textsc{Sarlat}).
+
+Si on veut voir afficher, un jour d'un mois particulier, on rajoutera le
+paramètre \Encadre{\texttt{MoisChoisi=valeur}} aux autres, comme dans
+l'exemple précédent et le suivant.
+\begin{center}
+\psCalendar
+\end{center}
+\begin{verbatim}
+\psCalendar[An=2004,Mois=6,Jour=21,MoisChoisi=6]
+\end{verbatim}
+\begin{center}
+\psCalendar[An=2004,Mois=6,Jour=21,MoisChoisi=6]
+\end{center}
+\subsection{Le calendrier en 3D}
+La commande s'écrit très simplement :
+\begin{verbatim}
+\psCalDodecaeder
+\end{verbatim}
+\begin{center}
+\psscalebox{0.5}{\psCalDodecaeder}
+\end{center}
+pour avoir le calendrier de l'année en cours. Si le schéma est trop grand à
+votre goût, encadrez la commande par un \verb+\psscalebox{0.5}{\psCalDodecaeder}+
+
+Pour avoir le mois de mai face à soi, on écrira, par exemple :
+\begin{verbatim}
+\psscalebox{0.5}{\psCalDodecaeder[style=mai]}
+\end{verbatim}
+\begin{center}
+\psscalebox{0.5}{\psCalDodecaeder[style=mai]}
+\end{center}
+\verb+Vx, Vy, Vz+ sont les valeurs des paramètres de \texttt{viewpoint=-5.85 -3.62
+0} de la commande \verb+\ThreeDput+ de \verb+pst-3d+, qui sont les
+coordonnées d'un vecteur définissant la direction où se trouve
+l'observateur (la direction de la projection parallèle).
+
+On jouera aussi sur le paramètre \verb+viewangle+, pour amener la face
+observée dans le bon sens de la lecture.
+
+Pour avoir le mois de janvier face à soi, on écrira :
+\begin{verbatim}
+\psscalebox{0.35}{\psCalDodecaeder[style=janvier]}
+\end{verbatim}
+\begin{center}
+\psscalebox{0.35}{\psCalDodecaeder[style=janvier]}
+\end{center}
+Pour avoir le mois de février face à soi, on écrira :
+\begin{verbatim}
+\psscalebox{0.35}{\psCalDodecaeder[style=fevrier]}
+\end{verbatim}
+\begin{center}
+\psscalebox{0.35}{\psCalDodecaeder[style=fevrier]}
+\end{center}
+Pour avoir le mois de mars face à soi, on écrira :
+\begin{verbatim}
+\psscalebox{0.35}{\psCalDodecaeder[style=mars]}
+\end{verbatim}
+\begin{center}
+\psscalebox{0.35}{\psCalDodecaeder[style=mars]}
+\end{center}
+Pour avoir le mois d'avril face à soi, on écrira :
+\begin{verbatim}
+\psscalebox{0.35}{\psCalDodecaeder[style=avril]}
+\end{verbatim}
+\begin{center}
+\psscalebox{0.35}{\psCalDodecaeder[style=avril]}
+\end{center}
+Pour avoir le mois de juin face à soi, on écrira :
+\begin{verbatim}
+\psscalebox{0.35}{\psCalDodecaeder[style=juin]}
+\end{verbatim}
+\begin{center}
+\psscalebox{0.35}{\psCalDodecaeder[style=juin]}
+\end{center}
+Pour avoir le mois de juillet face à soi, on écrira :
+\begin{verbatim}
+\psscalebox{0.35}{\psCalDodecaeder[style=juillet]}
+\end{verbatim}
+\begin{center}
+\psscalebox{0.35}{\psCalDodecaeder[style=juillet]}
+\end{center}
+Pour avoir le mois d'août face à soi, on écrira :
+\begin{verbatim}
+\psscalebox{0.35}{\psCalDodecaeder[style=aout]}
+\end{verbatim}
+\begin{center}
+\psscalebox{0.35}{\psCalDodecaeder[style=aout]}
+\end{center}
+Pour avoir le mois de septembre face à soi, on écrira :
+\begin{verbatim}
+\psscalebox{0.35}{\psCalDodecaeder[style=septembre]}
+\end{verbatim}
+\begin{center}
+\psscalebox{0.35}{\psCalDodecaeder[style=septembre]}
+\end{center}
+Pour avoir le mois d'octobre face à soi, on écrira :
+\begin{verbatim}
+\psscalebox{0.35}{\psCalDodecaeder[style=octobre]}
+\end{verbatim}
+\begin{center}
+\psscalebox{0.35}{\psCalDodecaeder[style=octobre]}
+\end{center}
+Pour avoir le mois de novembre face à soi, on écrira :
+\begin{verbatim}
+\psscalebox{0.35}{\psCalDodecaeder[style=novembre]}
+\end{verbatim}
+\begin{center}
+\psscalebox{0.35}{\psCalDodecaeder[style=novembre]}
+\end{center}
+Pour avoir le mois de décembre face à soi, on écrira :
+\begin{verbatim}
+\psscalebox{0.35}{\psCalDodecaeder[style=decembre]}
+\end{verbatim}
+\begin{center}
+\psscalebox{0.35}{\psCalDodecaeder[style=decembre]}
+\end{center}
+Pour visualiser une année particulière, avec un mois choisi face à soi, et un jour de ce mois, (15~mai~2004) on
+fera :
+\begin{verbatim}
+\psscalebox{0.35}{\psCalDodecaeder[style=mai,An=2004,MoisChoisi=5,Jour=15]}
+\end{verbatim}
+\begin{center}
+\psscalebox{0.35}{\psCalDodecaeder[style=mai,An=2004,MoisChoisi=5,Jour=15]}
+\end{center}
+\section{Calcul de la date de Pâques}
+On trouve sur internet, à propos de ce sujet de nombreux sites. \'A partir
+de la \textit{définition} de la fête proprement dite, les formules <<
+magiques >> abondent. L'une d'elle a retenu mon attention, je l'ai
+retranscrite avec le package \texttt{fp}. Dans l'ordre, un aperçu de la
+page, puis le codage des calculs avec \texttt{fp}.
+
+Le site : \texttt{http://www.altcal.com/elmcal.html}, et un extrait :
+
+\begin{verbatim}
+Version 2.0 - 11 Nov 1998
+
+Copyright and disclaimer
+------------------------
+ This document is Copyright (C) 1998 by Claus Tondering.
+ E-mail: claus@tondering.dk.
+ The document may be freely distributed, provided this
+ copyright notice is included and no money is charged for
+ the document.
+ This document is provided "as is". No warranties are made as
+ to its correctness.
+
+G = year mod 19
+
+For the Julian calendar:
+ I = (19*G + 15) mod 30
+ J = (year + year/4 + I) mod 7
+
+For the Gregorian calendar:
+ C = year/100
+ H = (C - C/4 - (8*C+13)/25 + 19*G + 15) mod 30
+ I = H - (H/28)*(1 - (H/28)*(29/(H + 1))*((21 - G)/11))
+ J = (year + year/4 + I + 2 - C + C/4) mod 7
+
+Thereafter, for both calendars:
+L = I - J
+EasterMonth = 3 + (L + 40)/44
+EasterDay = L + 28 - 31*(EasterMonth/4)
+\end{verbatim}
+
+\hrule
+{\blue
+\begin{verbatim}
+\FPset{\Year}{1981} % placer ici l'année
+\FPeval\GY{(\Year)-19*trunc((\Year)/19,0)}
+\FPeval{\Cent}{trunc((\Year)/100,0)}
+\FPeval{\Iter}{trunc((\Cent)-trunc((\Cent)/4,0)-trunc((8*(\Cent)+13)/25,0)+
+ (\GY)*19+15,0)}
+\FPeval{\Iterdiv}{trunc((\Iter)/30,0)}
+\FPeval\Hepact{(\Iter)-30*(\Iterdiv)}
+\FPeval\Inbre{trunc((\Hepact)-trunc((\Hepact)/28,0)*
+ (1-trunc((\Hepact)/28,0))*(trunc(29/((\Hepact)+1),0)*trunc((21-(\GY))/11,0)),0)}
+\FPeval\Jnbreinter{trunc((\Year)+trunc((\Year)/4,0)+(\Inbre)+2-(\Cent)+trunc((\Cent)/4,0),0)}
+\FPeval\Jnbre{trunc((\Jnbreinter)-7*trunc((\Jnbreinter)/7,0),0)}
+\FPeval\Lnbre{trunc((\Inbre)-(\Jnbre),0)}
+\FPeval\Month{trunc(3+trunc(((\Lnbre)+40)/44,0),0)}
+\FPeval\Day{trunc((\Lnbre)+28-31*trunc((\Month)/4,0),0)}
+\ifnum\Month=4
+ \ifnum\Day>25 \FPeval{\Day}{trunc((\Day)-7,0)} \fi
+\fi
+
+P\^aques le Dimanche \FPprint\Day/\FPprint\Month/\FPprint\Year
+\end{verbatim}}
+\FPset{\Year}{1981} % placer ici l'année
+\FPeval\GY{(\Year)-19*trunc((\Year)/19,0)}
+\FPeval{\Cent}{trunc((\Year)/100,0)}
+\FPeval{\Iter}{trunc((\Cent)-trunc((\Cent)/4,0)-trunc((8*(\Cent)+13)/25,0)+
+ (\GY)*19+15,0)}
+\FPeval{\Iterdiv}{trunc((\Iter)/30,0)}
+\FPeval\Hepact{(\Iter)-30*(\Iterdiv)}
+\FPeval\Inbre{trunc((\Hepact)-trunc((\Hepact)/28,0)*
+ (1-trunc((\Hepact)/28,0))*(trunc(29/((\Hepact)+1),0)*trunc((21-(\GY))/11,0)),0)}
+\FPeval\Jnbreinter{trunc((\Year)+trunc((\Year)/4,0)+(\Inbre)+2-(\Cent)+trunc((\Cent)/4,0),0)}
+\FPeval\Jnbre{trunc((\Jnbreinter)-7*trunc((\Jnbreinter)/7,0),0)}
+\FPeval\Lnbre{trunc((\Inbre)-(\Jnbre),0)}
+\FPeval\Month{trunc(3+trunc(((\Lnbre)+40)/44,0),0)}
+\FPeval\Day{trunc((\Lnbre)+28-31*trunc((\Month)/4,0),0)}
+\ifnum\Month=4
+ \ifnum\Day>25 \FPeval{\Day}{trunc((\Day)-7,0)} \fi
+\fi
+
+\centerline{\Encadre{P\^aques tombe le dimanche
+\FPprint\Day/\FPprint\Month/\FPprint\Year}}
+
+Vous y reconnaîtrez sans peine l'algorithme initial, j'ai rajouté les trois
+dernières lignes, car l'auteur des formules précédentes semble avoir oublié
+que Pâques peut varier seulement entre le 22~mars et le 25~avril inclus
+ Sans cette correction, le programme affiche dans l'exemple précédent (1981), le dimanche 26~avril au lieu du
+ 19~avril.
+
+Pour le tester quelques dates :
+\begin{center}
+\begin{tabular}{c|c}
+1978& 26 mars \\ \hline
+1979&15 avril \\ \hline
+1980&6 avril \\ \hline
+2000&23 avril \\ \hline
+2002&31 mars \\ \hline
+2003&20 avril \\ \hline
+\end{tabular}
+\end{center}
+Ce n'est pas garanti sans erreurs, l'emploi des fonctions \texttt{trunc} ou
+\texttt{round} ou \texttt{clip} ne donnent pas à 100\% toujours, le résultat
+attendu. Par exemple si \texttt{fp} calcule $14.99999999$, alors que
+de toute évidence c'est $15$, il ne vaut mieux pas faire
+\texttt{trunc} pour avoir la partie entière, mais \texttt{round},
+car sinon on commet une erreur d'une unité en moins ! Il faudrait
+donc prévoir de tester ces cas !
+\section{Que reste-t-il à faire ? Problèmes !}
+\begin{itemize}
+ \item Placer les jours fériés du lundi de Pâques et du lundi de
+ Pentecôte.
+ \item Dessiner automatiquement le mois en cours, face à notre regard.
+ \item Prévoir un test qui limite l'année choisie à l'intervalle permis,
+ soit $[2000-2099]$.
+ \item Trouver un moyen simple, élégant et cohérent d'entourer la date choisie.
+ \item Débusquer les erreurs, si vous en trouvez\ldots
+\end{itemize}
+
+\end{document}