\documentclass[a4paper]{article}
\usepackage[francais]{babel}
\usepackage{html}

\newcommand{\lien}[2]{\htmladdnormallinkfoot{#1}{#2}}
\newcommand{\bs}{\backslash}

%a mettre dans un repertoire pour_les_auteurs avec
%modele.tex, exemple-exo.tex, liste des categories, plug-and-play,


\textheight=23cm % a ajuster
\textwidth=15cm  % a ajuster 
%
\setlength{\oddsidemargin}{10.5truecm}       %half A4 width
\addtolength{\oddsidemargin}{-1truein}       %\hoffset
\addtolength{\oddsidemargin}{-.5\textwidth}
\setlength{\topmargin}{14.85truecm}          %half A4 height
\addtolength{\topmargin}{-1truein}           %\voffset
\addtolength{\topmargin}{-37truept}          %\headheight=12pt \headsep=25pt
\addtolength{\topmargin}{-.5\textheight}
%
\sloppy

\input{macros.tex}

\title{Conseils techniques pour nous envoyer vos exos
\begin{latexonly}
\footnote{Ce document est disponible sur~:\newline
\texttt{matexo.emath.fr/exemaalt/pour\_les\_auteurs/conseils\_techniques/conseils\_techniques.html}}  
\end{latexonly}
}



\begin{document}
\bodytext{bgcolor="#FFF0E7"}
\input{bandeau.tex}
\begin{rawhtml}
<!-- tableau coloré -->
<center>
<table CELLSPACING=0 WIDTH="90%" BGCOLOR="#FFFFBB" NOSAVE >
<tr NOSAVE>

<td NOSAVE ALIGN=CENTER VALIGN=CENTER>
<br>
<font size=+3>
Conseils techniques pour nous envoyer vos exos</font>
</td>
</tr>
</table></center>
<!--   Fin du titre colore       -->
\end{rawhtml}


\begin{htmlonly}
\lien{Autres formats pour ce document}{formats/}\newline
\lien{Retour vers le sommaire d'EXEMAALT}{../../entree.html}
\end{htmlonly}
\begin{latexonly}
\maketitle
\end{latexonly}



\begin{itemize}
\item Chaque exercice doit se trouver dans un fichier s\'epar\'e

\item Pour \'ecrire un exo, le plus simple est de partir du fichier
\begin{htmlonly}\lien{modele.tex}{../modele.tex}. \end{htmlonly}
\begin{latexonly}\texttt{modele.tex} disponible dans le r\'epertoire
\texttt{matexo.emath.fr/exemaalt/pour\_les\_auteurs/}
\end{latexonly}
Jetez aussi un oeil \`a 
\begin{htmlonly}\lien{l'exemple}{../exemple\_d\_exo.tex}
\end{htmlonly}%
\begin{latexonly}l'exemple\footnote{matexo.emath.fr/exemaalt/pour\_les\_auteurs/exemple\_d\_exo.tex}
\end{latexonly}.


\item Pour tester votre exercice, ins\'erez le dans le fichier
\lien{plug\_and\_play.tex}{../plug\_and\_play.tex}, et compilez-le
avec \LaTeXe{}. Attention, des erreurs dans les arguments des 
commandes \verb|\Titre|, \verb|\Theme|, etc. seront detectees par LaTeX comme
des erreurs dans \verb|\begin{exo}|. Ne vous faites pas avoir.

\item 
Pour introduire des parties, questions, sous-questions, sous-sous-questions,
utilisez les commandes 
\verb|\partie{|\textit{titre-de-la-partie}\verb|}| (partie I,II,III), 
\verb|\qst{|\textit{titre-de-la-question}\verb|}| (question 1,2,3), 
\verb|\sq| (sous-question a,b,c) 
et \verb|\ssq| (sous-sous-question i,ii,iii). 
La num\'erotation est automatique. Les commandes \verb|\sq| et \verb|\ssq| 
ont un titre optionnel~: \verb|\sq[|\textit{titre-de-la-sous-question}\verb|]|, \verb|\ssq[|\textit{titre-de-la-sous-sous-question}\verb|]|.

Par exemple, les commandes suivantes
\begin{quote}
\verb|\partie{Mod\`ele lin\'eaire}|\newline
\verb|\qst{Effet de la s\'election naturelle}|\newline
\verb|On introduit maintenant la s\'election naturelle dans le mod\`ele...|\newline
\verb|\sq Donner la matrice de l'op\'erateur de s\'election |\newline
\verb|\ssq Que se passe-t-il quand x tend vers 0 ? |\newline
\verb|\ssq Que se passe-t-il quand x tend vers 1 ? |\newline
\verb|\sq[Interpr\'etation.] Interpr\'eter le r\'esultat pr\'ec\'edent |

\end{quote}
pourront produire
\begin{quote}
\noindent{\Large\textbf{I. Mod\`ele lin\'eaire}}

\noindent{\large\textbf{Question 1. Effet de la s\'election naturelle}}

On introduit maintenant la s\'election naturelle dans le mod\`ele...\newline
\noindent\textbf{a.} Donner la matrice de l'op\'erateur de s\'election \newline
\noindent (i) Que se passe-t-il quand x tend vers 0 ?\newline
\noindent (ii) Que se passe-t-il quand x tend vers 1 ?\newline
\noindent\textbf{b. Interpr\'etation.} Interpr\'eter le r\'esultat pr\'ec\'edent
\end{quote}


\item Pour ce qui est des accents, le mieux est de nous les envoyer \verb|\`|\emph{a la TeX}~:
chaque syst\`eme d'exploitation g\`ere les accents diff\'eremment, et les accents  passent 
mal par le mail.

\item Pour \'enoncer un th\'eor\`eme, ou donner une d\'efinition, on peut
  appeler les environnements
 \verb|enonce1|,  \verb|enonce1*|,  \verb|enonce2| et
   \verb|enonce2*|. Voici un exemple pour commencer~: les commandes

   \begin{quote}
\verb|\begin{enonce1*}{Lemme}|\newline
\verb|Si une fonction est d\'erivable en un point, ...|\newline
\verb|\end{enonce1*}|\newline
\newline
\verb|\begin{enonce2}{D\'efinition}{(rappel)}|\newline
\verb|On dit qu'une fonction est \emph{affine par morceaux} si...|\newline
\verb|\end{enonce2}|\newline
   \end{quote}
produiront~:

% \noindent\textbf{Lemme}\hspace{0.4cm}
% \emph{Si une fonction $f$ est d\'erivable en un point $x_0$,
% ...}

%et

% \noindent\textbf{D\'efinition 1 (rappel)}\hspace{0.4cm}
% On dit qu'une fonction est \emph{affine par morceaux} si...
\begin{quote}
\begin{enonce1*}{Lemme}
Si une fonction est d\'erivable en un point, ...
\end{enonce1*}

\begin{enonce2}{D\'efinition}{(rappel)}
On dit qu'une fonction est \emph{affine par morceaux} si...
\end{enonce2}
\end{quote}


   La diff\'erence entre \verb|enonce1| (version \'etoil\'ee ou non) et \verb|enonce2| est la suivante~:
 \verb|enonce1|
  sert \`a produire tous les \'enonc\'es du type th\'eor\`eme, lemme, proposition,
  corollaire \textit{etc.} (pour lesquels le corps du texte est en italique)~; \verb|enonce2|
  sert \`a produire les d\'efinitions, exemples, \textit{etc.} (pour lesquels le corps du texte
  est en caracteres ``normaux'').

 Les \'enonc\'es produits par les environnements \verb|enonce1| et \verb|enonce2|
 sont num\'erot\'es, alors que les versions \'etoil\'ees produisent des \'enonc\'es non num\'erot\'es.

  L'appel aux environnements non \'etoil\'es (\'enonc\'es num\'erot\'es)
  n\'ecessite deux param\`etres~: le premier contient le texte qui apparait avant le numero
  le deuxieme contient le texte a \'ecrire apr\`es le numero. Les environnements  \verb|enonce1*| et
  \verb|enonce2*| ne n\'ecessitent qu'un seul param\`etre.


\item Conventions: les nombres r\'eels, complexes, entiers etc. sont d\'efinis par 
les commandes \verb|\bbR|, \verb|\bbC|, \verb|\bbN|...
Les commandes \verb|\cala|, \verb|\calb|, \verb|\calc|, \verb|\cald| etc... 
donnent des A,B,C,D caligraphiques.   
La liste de toutes les macros d\'efinies est contenue dans le fichier
\lien{macros.tex}{../../exos\_tries/tex/macros.tex}.

\item 
N'utilisez pas de commande exotique sans la d\'efinir dans l'exercice.
Definissez-la entre le \verb|\begin{exo}| et le \verb|\end{exo}| :
ainsi, votre commande ne sera pas d\'efinie en dehors de l'exercice, ce qui
r\'eduit les risques d'interf\'erences.


\item Le classement par niveau, th\`eme ou angle p\'edagogique n'a d'int\'er\^et
que si les cat\'egories sont un minimum standard. En particulier, la cohabitation du m\^eme
th\`eme sous diff\'erente appellations (par exemple comme 
\emph{S\'eries de Fourier} et \emph{Fourier}) est \`a proscrire.
Pour mat\'erialiser ce besoin de standardisation, nous avons choisi que chaque
th\`eme, niveau, ou type soit d\'efini par une commande \LaTeX{}.
Par exemple \verb|\Alglin| est la commande pour le th\`eme \emph{alg\`ebre lin\'eaire}.
Voici la \lien{liste des cat\'egories}{../liste\_des\_categories.tex}.
Elle n'a pas de pr\'etention \`a l'exhaustivit\'e et vous pouvez en sugg\'erer d'autres,
mais il faudrait qu'elle reste de taille mod\'er\'ee.

Pour \'eviter que tout \c ca soit trop rigide, les themes secondaires,
eux, pourront \^etre non standard et ne pas correspondre \`a une commande.


\item Chaque exercice peut correspondre \`a plusieurs angles p\'edagogiques
(idem pour les th\`emes ou angle p\'edagogiques). 
Par exemple, l'exercice sur le fait que 0,9999999...=1
est class\'e dans les angles p\'edagogiques <<\`A quoi \c ca sert>>, <<Langage>>
et <<Ludique>>.

Dans ce cas, on utilisera les commandes suivantes:\newline
\begin{quote}
\verb|\AnglePedagogique{\AQuoiCaSert}| \newline
\verb|\AnglesSecondaires{\Langage, \Ludique}|
\end{quote}
L'exercice appara\^\i tra sous les 3 cat\'egories dans l'index 
par angle p\'edagogique.
Par contre, on ne fait pas figurer un m\^eme exercice plusieurs
fois dans un recueil donn\'e. C'est pourquoi il faut donner un et un seul
angle p\'edagogique \emph{principal} (par opposition \`a \emph{secondaire})
qui servira pour le classement des exercices par angle p\'edagogique.
En bref: la commande \verb|\AnglePedagogique| (idem pour \verb|\Theme| et \verb|\Niveau|)
est obligatoire et doit avoir un unique argument (elle sert \`a trier les exos eux-m\^emes),
la commande \verb|\AnglesSecondaires| est optionnelle, peut avoir un argument vide ou multiple,
(elle sert \`a trier l'index). Idem pour \verb|\ThemesSecondaires| et \verb|\NiveauxSecondaires| !


\item 
Pour faire r\'ef\'erence \`a un exercice donn\'e, 
utiliser la commande habituelle 
\verb|\ref{|\emph{\ etiquette\ }\verb|}|
sachant que l'\'etiquette d'un exo nomm\'e \texttt{nomdefichier.tex} est
\texttt{label-nomdefichier}.

\end{itemize}

\html{\lien{Retour vers le sommaire d'EXEMAALT}{../../entree.html}}

\end{document}
