diff options
Diffstat (limited to 'Master/texmf-dist/doc/metapost/mpchess/mpchess-doc-fr.tex')
-rw-r--r-- | Master/texmf-dist/doc/metapost/mpchess/mpchess-doc-fr.tex | 106 |
1 files changed, 78 insertions, 28 deletions
diff --git a/Master/texmf-dist/doc/metapost/mpchess/mpchess-doc-fr.tex b/Master/texmf-dist/doc/metapost/mpchess/mpchess-doc-fr.tex index a08aa998826..674bf9d619c 100644 --- a/Master/texmf-dist/doc/metapost/mpchess/mpchess-doc-fr.tex +++ b/Master/texmf-dist/doc/metapost/mpchess/mpchess-doc-fr.tex @@ -71,7 +71,7 @@ } \vfill \begin{center} - Version 0.4, 6 avril 2023 \\ + Version 0.5, 20 avril 2023 \\ \url{https://plmlab.math.cnrs.fr/mchupin/mpchess} \end{center} %% == Page de garde ==================================================== @@ -90,6 +90,7 @@ excellent packages \LaTeX{}. \begin{center} \url{https://plmlab.math.cnrs.fr/mchupin/mpchess} + \url{https://github.com/chupinmaxime/mpchess} \end{center} \tableofcontents @@ -119,7 +120,7 @@ de votre distribution. \end{center} -\subsection{Avec la \TeX live sous Linux ou MacOS} +\subsection{Avec la \TeX live sous Linux ou macOS} Pour installer \mpchess avec \TeX live, il vous faudra créer le répertoire \lstinline+texmf+ dans votre \lstinline+home+. @@ -398,7 +399,7 @@ autour de l’échiquier. Ceci se fait avec les commandes suivantes. \commande|set_black_player(«string»)|\index{set_black_player@\lstinline+set_black_player+}\smallskip \begin{description} - \item[\meta{string} :] est la chaîne de caractères interprétée par \LaTeX à afficher. + \item[\meta{string} :] est la chaîne de caractères interprétée par \LaTeX{} à afficher. \end{description} \begin{ExempleMP} @@ -443,8 +444,13 @@ macros permettent de générer une \lstinline+picture+ à dessiner \emph{par \subsection{Réglage du thème des pièces} -\mpchess fournit pour l’instant trois thèmes de pièces, deux emprunté à Lichess, -et l’autre emprunté au package~\package{skak}~\cite{ctan-skak}\footnote{Qui +\mpchess fournit pour l’instant trois thèmes de pièces. Le thème par défaut est +appelé \lstinline+mpchess+. Il a été designé pour ce package \hologo{METAPOST}. +Il a été proposé au projet Lichess, et a été accepté. Ainsi, vous aurez aussi +accès à l’ensemble de pièces \lstinline+mpchess+ avec Lichess\footnote{Les +projets libres se nourrissent mutuellement ! Même si évidemment, ce package a +bien plus emprunté à Lichess que le contraire.} ! Un autre thème est emprunté à +Lichess (\lstinline+cburnett+) et l’autre est emprunté au package~\package{skak}~\cite{ctan-skak}\footnote{Qui fournit le code \MF{} pour la fonte de pièces d’échec, code qui a été facilement adapté en \MP{} pour \mpchess.}. @@ -455,10 +461,9 @@ Pour choisir le thème on utilisera la commande suivante. \begin{description} \item[\meta{string}:] peut valoir: \begin{itemize} -\item \lstinline+"cburnett"+ (valeur par défaut), pour obtenir l’ensemble de pièces nommé \emph{cburnett} de Lichess; - -\item \lstinline+"mpchess"+, pour obtenir l’ensemble de pièces spécialement -conçu pour ce package ; + \item \lstinline+"mpchess"+ (valeur par défaut), pour obtenir l’ensemble de pièces spécialement + conçu pour ce package ; + \item \lstinline+"cburnett"+, pour obtenir l’ensemble de pièces nommé \emph{cburnett} de Lichess; \item \lstinline+"skak"+, pour obtenir l’ensemble de pièces du package~\package{skak}. \end{itemize} \end{description} @@ -515,7 +520,7 @@ Thème \lstinline+skak+&\\ \subsection{Trait} \mpchess indique qui a le trait entre les blancs et les noirs. Ceci ce fait par -un petit triangle coloré (blanc ou noir) à l’extrérieur du plateau (que vous +un petit triangle coloré (blanc ou noir) à l’extérieur du plateau (que vous pourrez observer dans les nombreux exemples suivants). Pour spécifier qui a le trait on utilisera les commandes suivantes. @@ -808,16 +813,16 @@ Cette commande retourne un \lstinline+numeric+. \section{Annotation} -De nombreuses commandes permettent d’annonter l’échiquier (flêche, couleur, cercle, croix, etc.). +De nombreuses commandes permettent d’annoter l’échiquier (flèche, couleur, cercle, croix, etc.). \subsection{Flèches} -La commande pour tracer des flêches sur l’échiquier est la suivante. +La commande pour tracer des flèches sur l’échiquier est la suivante. \commande|draw_arrows(«color»)(«string1»,«string2», etc.)|\index{draw_arrows@\lstinline+draw_arrows+}\smallskip \begin{description} \item[\meta{color}:] est une \lstinline+color+ \MP. -\item[\meta{string1}:] est une chaîne de caractères (entre double-quotes) consituée de deux coordonnées (lettre et chiffre) séparés par deux caractères qui peuvent être +\item[\meta{string1}:] est une chaîne de caractères (entre double-quotes) constituée de deux coordonnées (lettre et chiffre) séparés par deux caractères qui peuvent être \begin{description} \vitem+--+ pour relier les deux cases en ligne droite ; \vitem+-|+ pour relier les deux cases en ligne brisée, d’abord horizontalement puis verticalement ; @@ -840,12 +845,12 @@ draw_arrows(red)("f8--b4","g1|-f3"); endfig; \end{ExempleMP} -On pourra modifier l’épaisseur des flêches grâce à la commande suivante. +On pourra modifier l’épaisseur des flèches grâce à la commande suivante. \commande|set_arrow_width(«coeff»)|\index{set_arrow_width@\lstinline+set_arrow_width+}\smallskip \begin{description} \item[\meta{coeff}:] est un coefficient (\lstinline+numeric+) qui permet de - régler la largeur des flêches proportionnellement à la largeur d’une case de + régler la largeur des flèches proportionnellement à la largeur d’une case de l’échiquier. Par défaut, ce coefficient vaut \lstinline+0.08+. \end{description} @@ -874,7 +879,7 @@ endfig; \begin{description} \item[\meta{color}:] est une \lstinline+color+ \MP. -\item[\meta{coord1}:] est une chaîne de caractères (entre double-quotes) consituée de deux coordonnées (lettre et chiffre). +\item[\meta{coord1}:] est une chaîne de caractères (entre double-quotes) constituée de deux coordonnées (lettre et chiffre). \end{description} L’exemple suivant permet d’illustrer l’utilisation de cette commande. @@ -900,7 +905,7 @@ suivante. \begin{description} \item[\meta{color}:] est une \lstinline+color+ \MP. -\item[\meta{coord1}:] est une chaîne de caractères (entre double-quotes) consituée de deux coordonnées (lettre et chiffre). +\item[\meta{coord1}:] est une chaîne de caractères (entre double-quotes) constituée de deux coordonnées (lettre et chiffre). \end{description} L’exemple suivant permet d’illustrer l’utilisation de cette commande. @@ -927,7 +932,7 @@ suivante. \begin{description} \item[\meta{color}:] est une \lstinline+color+ \MP. - \item[\meta{coord1}:] est une chaîne de caractères (entre double-quotes) consituée de deux coordonnées (lettre et chiffre). + \item[\meta{coord1}:] est une chaîne de caractères (entre double-quotes) constituée de deux coordonnées (lettre et chiffre). \end{description} L’exemple suivant permet d’illustrer l’utilisation de cette commande. @@ -953,7 +958,7 @@ endfig; \begin{description} \item[\meta{str}:] est une chaîne de caractères (entre double-quotes) à afficher. -\item[\meta{pos}:] est une chaîne de caractères (entre double-quotes) consituée +\item[\meta{pos}:] est une chaîne de caractères (entre double-quotes) constituée d’une coordonnée (lettre et chiffre). \end{description} @@ -980,7 +985,7 @@ suivante. \subsection{Lignes principales} -\mpchess fournit une commande permettant d’afficher les fléches des coups des +\mpchess fournit une commande permettant d’afficher les flèches des coups des lignes principales d’analyses. Il y a les commandes pour les deux couleurs. \commande|draw_white_main_lines(«move1»,«move2»,etc.)|\index{draw_white_main_lines@\lstinline+draw_white_main_lines+}\smallskip @@ -989,7 +994,7 @@ lignes principales d’analyses. Il y a les commandes pour les deux couleurs. \begin{description} \item[\meta{move1}, \meta{move2}, etc.:] sont les coups à illustrer par une -flêche, en suivant la notation de type \textsc{pgn}. +flèche, en suivant la notation de type \textsc{pgn}. \end{description} Lorsqu’on utilise la lecture de format \textsc{pgn} pour la construction des positions à afficher, on pourra alors utiliser les commandes suivantes @@ -1000,12 +1005,12 @@ permettant de spécifier quelle étape de la partie on commente. \commande|draw_black_main_lines_step(«step»)(«move1»,«move2»,etc.)|\index{draw_black_main_lines_step@\lstinline+draw_black_main_lines_step+}\smallskip \begin{description} - \item[\meta{step}:] est l’étape de la partie qu’on souhaite annonter; + \item[\meta{step}:] est l’étape de la partie qu’on souhaite annoter; \item[\meta{move1}, \meta{move2}, etc.:] sont les coups à illustrer par une -flêche, en suivant la notation de type \textsc{pgn}. +flèche, en suivant la notation de type \textsc{pgn}. \end{description} -L’exemple suivant permet d’illuster l’utilisation de cette commande. +L’exemple suivant permet d’illustrer l’utilisation de cette commande. \begin{ExempleMP} input mpchess @@ -1061,7 +1066,7 @@ choisie. \commande|show_possible_moves_step(«step»)(«square»)|\index{show_possible_moves_step@\lstinline+show_possible_moves_step+}\smallskip \begin{description} - \item[\meta{step}:] est l’étape de la partie qu’on souhaite annonter; + \item[\meta{step}:] est l’étape de la partie qu’on souhaite annoter; \item[\meta{square}:] est une chaîne de caractères indiquant au format classique les coordonnées de la case où la pièce se situe. \end{description} @@ -1099,7 +1104,7 @@ On pourra faire une découpe dans l’image de l’échiquier grâce à la comma \begin{description} \item[\meta{string}:] est une chaîne de caractères (entre double-quotes) -composée de deux coordonnées (lettre et chiffre) séparé par un tiret, par +composée de deux coordonnées (lettre et chiffre) séparées par un tiret, par exemple \lstinline+"a1-c6"+. \end{description} @@ -1167,7 +1172,7 @@ draw_arrows(red)("e7--e5","g1|-f3"); \subsubsection{Avec \package{gmp}} L’utilisation de \package{gmp}~\cite{ctan-gmp} est assez similaire à celle de -\package{mpgraphics}. Quelques commandes sont toute fois différentes, mais comme +\package{mpgraphics}. Quelques commandes sont toutefois différentes, mais comme avec \package{mpgraphics}, on n’aura pas recours à \lstinline+beginfig+ et \lstinline+endfig+. Le chargement de \mpchess peut se faire au chargement du package, et le code \MP{} se trouve dans l’environnement \lstinline+mpost+. Là @@ -1198,7 +1203,8 @@ Il est tout à fait possible d’utiliser \mpchess directement dans un fichier intégrante de \hologo{LuaTeX}.} et le package \package{luamplib}. C’est d’ailleurs ce qui est fait pour écrire cette documentation. -Il suffira alors de mettre le code \MP{} dans l’environnement \lstinline+mplibcode+. +Il suffira alors de mettre le code \MP{} dans l’environnement +\lstinline+mplibcode+ comme illustré plus bas. \mpchess utilise, pour certaines fonctionnalités, l’opérateur @@ -1240,6 +1246,47 @@ endfig; \end{mplibcode} \end{document} \end{latexcode} + +\subsection{Font TrueType} + +Le package \mpchess{} fournit une fonte très simple composé d’uniquement les 12 +glyphes correspondant aux pièces noires et blanches dans la table Unicode. Pour +y avoir accès il suffit d’utiliser \hologo{LuaLaTeX} ou \hologo{XeLaTeX} et le +package \package{fontspec}. Pour faciliter son utilisation, nous proposons +quelques définitions. + +\begin{latexcode} +\documentclass{article} +\usepackage{fontspec} +\newfontfamily{\chessfont}{mpchess font} +\newcommand\bP{{\chessfont \char"265F}} % black Pawn +\newcommand\bN{{\chessfont \char"265E}} % black Knight +\newcommand\bB{{\chessfont \char"265D}} % black Bishop +\newcommand\bR{{\chessfont \char"265C}} % black Rook +\newcommand\bQ{{\chessfont \char"265B}} % black Queen +\newcommand\bK{{\chessfont \char"265A}} % black King +\newcommand\wP{{\chessfont \char"2659}} % white Pawn +\newcommand\wN{{\chessfont \char"2658}} % white Knight +\newcommand\wB{{\chessfont \char"2657}} % white Bishop +\newcommand\wR{{\chessfont \char"2656}} % white Rook +\newcommand\wQ{{\chessfont \char"2655}} % white Queen +\newcommand\wK{{\chessfont \char"2654}} % white King + +\begin{document} + +Voici l'enchainement de coups : 1. e4 e5 2. \wB c4 d6 3. \wN f3 \bB g4 4. \wN +c3 g6 5. \wN xe5 \bB xd1. + +\end{document} +\end{latexcode} + +Qui produira : + +\og{}Voici l’enchainement de coups : 1. e4 e5 2. \wB c4 d6 3. \wN f3 \bB g4 +4. \wN c3 g6 5. \wN xe5 \bB xd1.\fg{} + + + \section{To do} De nombreuses choses sont à ajouter à \mpchess. Parmi celles-ci, on peut penser @@ -1279,6 +1326,9 @@ endfig; \section{Historique} \begin{description} +\item[v0.5, 20 avril 2023:] Correction d’un bug, \textbf{changement de +l’ensemble de pièce par défaut} pour l’ensemble \lstinline+mpchess+ (qui a été +ajouté à Lichess), ajout de la fonte TrueType, et mise à jour de la documentation. \item[v0.4, 6 avril 2023:] Corrections dans la documentation, notamment la version anglaise; ajout des commandes pour visualiser les mouvements possible pour une pièce (section~\ref{sec:possiblemoves}). |