diff options
author | Karl Berry <karl@freefriends.org> | 2009-03-28 22:52:37 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2009-03-28 22:52:37 +0000 |
commit | 48066adf939ff889ed9e33a4a8e5ede53db58d28 (patch) | |
tree | 98aec5997b916cfc7614afb4f0f21477f5a6a39a /Master/texmf-dist/doc/latex/pst-calendar | |
parent | 88e63a5d68668d620c783cdbf51e0c5bab111b7c (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/Changes | 7 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/pst-calendar/README | 13 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/pst-calendar/pst-calendar-docDE.ltx | 226 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/pst-calendar/pst-calendar-docDE.pdf | bin | 0 -> 138683 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/pst-calendar/pst-calendar-docDE.tex | 131 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/pst-calendar/pst-calendar-docFR.pdf | bin | 0 -> 164316 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/pst-calendar/pst-calendar-docFR.tex | 382 |
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 Binary files differnew file mode 100644 index 00000000000..86ae9dbb863 --- /dev/null +++ b/Master/texmf-dist/doc/latex/pst-calendar/pst-calendar-docDE.pdf 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 Binary files differnew file mode 100644 index 00000000000..f522579e219 --- /dev/null +++ b/Master/texmf-dist/doc/latex/pst-calendar/pst-calendar-docFR.pdf 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} |