summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/tkz-base/latex/TKZdoc-base-initialisation.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/tkz-base/latex/TKZdoc-base-initialisation.tex')
-rw-r--r--Master/texmf-dist/doc/latex/tkz-base/latex/TKZdoc-base-initialisation.tex120
1 files changed, 53 insertions, 67 deletions
diff --git a/Master/texmf-dist/doc/latex/tkz-base/latex/TKZdoc-base-initialisation.tex b/Master/texmf-dist/doc/latex/tkz-base/latex/TKZdoc-base-initialisation.tex
index b39ac0178e3..b95c3e3fc6a 100644
--- a/Master/texmf-dist/doc/latex/tkz-base/latex/TKZdoc-base-initialisation.tex
+++ b/Master/texmf-dist/doc/latex/tkz-base/latex/TKZdoc-base-initialisation.tex
@@ -1,8 +1,8 @@
-\section{Présentation de \tkzname{tkz-base}}
+\section{Presentation of \tkzname{tkz-base}}
-\subsection{Exemple qui pose un problème }
+\subsection{Example that poses a problem }
-Le code suivant donne une erreur
+The following code gives an error
\begin{tkzltxexample}[right margin=7cm]
\begin{tikzpicture}
@@ -11,7 +11,7 @@ Le code suivant donne une erreur
\end{tkzltxexample}
{\color{red} Latex Error: ... Dimension too large.}
-En effet, l'unité par défaut est le cm or \TEX\ ne peut pas stocker une dimension supérieure à 575 cm, c'est ce qui entraîne une erreur. \TEX\ cependant, peut stocker des entiers allant jusqu'à $2^{31}-1$, aussi il est possible de travailler en premier sur des entiers puis de définir les dimensions.
+Indeed, the default unit is a centimeter or \TEX\ cannot store a dimension greater than 575 cm, which leads to an error. \TEX\ however, can store integers up to $2^{31}-1$, so it is possible to work on integers first and then define the dimensions.
\begin{tkzltxexample}[right margin=7cm]
\begin{tikzpicture}[x=0.01 cm]
@@ -21,8 +21,8 @@ En effet, l'unité par défaut est le cm or \TEX\ ne peut pas stocker une dimens
{\color{red} Latex Error: ... Dimension too large.}
-Le code précédent donne encore une erreur. En effet, 600 cm est une dimension
- et ne tient pas compte du changement d'unité. Correct est :
+The previous code still makes an error. Indeed, 600 cm is a dimension
+ and does not take into account the change of unit. Correct is:
\begin{tkzltxexample}[right margin=7cm]
\begin{tikzpicture}[x=0.01 cm]
@@ -30,12 +30,12 @@ Le code précédent donne encore une erreur. En effet, 600 cm est une dimension
\end{tikzpicture}
\end{tkzltxexample}
-Cette fois, la dimension stockée est 6 cm ce qui est acceptable. Il est possible avec \TEX\ de manipuler de grands nombres entiers, mais en revanche les dimensions ne peuvent excéder \numprint{16384} pt soit 5,75 m environ.
+This time, the stored dimension is 6 cm which is acceptable. It is possible with \TEX\ to handle large whole numbers,but, on the other hand, the dimensions cannot exceed \numprint{16384} pt or approximately 5.75 m.
-Avec \TEX, il est aussi possible de travailler avec le package \tkzname{xfp} , qui lui permet de travailler sur des intervalles plus importants, mais au prix d'une certaine lenteur. C'est la méthode que j'ai privilégiée pour certains calculs sensibles qui requièrent une bonne précision comme des calculs de mesure d'angles ou de longueur de segment, mais il est nécessaire une fois un nombre trouvé de l'attribuer à une dimension. On retrouve toujours les mêmes contraintes.
+With \TEX, it's also possible to work with the \tkzname{xfp} package. This allows him to work at longer intervals, but at the cost of a certain slowness. This is the method I have preferred for some sensitive calculations that require good precision, such as calculations to measure angles or segment length, but it is necessary once a number has been found to assign it to a dimension. We always find the same constraints.
-\subsection{Le rôle de \tkzname{tkz-base}}
-Le code suivant donne une erreur non parce que \numprint{6000000} est un trop grand nombre, mais parce que \numprint{0.000001} cm est une trop petite dimension.
+\subsection{The role of \tkzname{\tkznameofpack}}
+The following code gives an error not because \numprint{6000000} is too large, but because \numprint{0.000001} cm is too small.
{\color{red} Latex Error:}
@@ -46,70 +46,64 @@ Le code suivant donne une erreur non parce que \numprint{6000000} est un trop gr
\end{tikzpicture}
\end{tkzltxexample}
-Avec \tkzname{tkz-base}, il sera possible de travailler avec des coordonnées quelconques, mais il faudra pour cela utiliser les macros du package.
+With \tkzname{tkz-base}, it will be possible to work with any coordinates, but it will be necessary to use the macros of the package.
-\tkzNamePack{tkz-base} permet de simplifier l'utilisation d'intervalles de valeurs divers. Ce package est utilisé par plusieurs de mes packages comme \tkzname{tkz-tukey}, un package pour dessiner les représentations graphi-ques en statistiques élémentaires, \tkzNamePack{tkz-fct} qui permet de dessiner les représentations graphiques des fonctions à l'aide du logiciel \tkzname{gnuplot}, ainsi qu'avec \tkzname{tkz-euclide} pour la géométrie euclidienne.
+\tkzNamePack{tkz-base} simplifies the use of different value ranges. This package is used by several of my packages such as \tkzname{tkz-tukey}, a package for drawing graphical representations in elementary statistics, \tkzNamePack{tkz-fct} which allows to draw graphical representations of functions using \tkzname{gnuplot}, as well as with \tkzname{tkz-euclide} for Euclidean geometry.
-Premièrement, il faut savoir qu'il n'est pas nécessaire de s'occuper avec \TIKZ\ de la taille du support (bounding box), cependant il est parfois nécessaire, soit de tracer une grille, soit de tracer des axes, soit de travailler avec une unité différente que le centimètre, soit finalement de contrôler la taille de ce qui sera affiché.
- Pour cela, il faut avoir préparé le repère dans lequel vous allez travailler, c'est le rôle de \tkzNamePack{tkz-base} et de sa macro principale \tkzNameMacro{tkzInit}. Par exemple, si l'on veut travailler sur un carré de 10 cm de côté, mais tel que l'unité soit le dm alors il faudra utiliser.
+First of all, you should know that it is not necessary to deal with \TIKZ\ with the size of the support (bounding box); however it is sometimes necessary, either to draw a grid, or to draw axes, or to work with a different unit than the centimeter, or finally to control the size of what will be displayed.
+ To do this, you must have prepared the frame in which you are going to work, this is the role of \tkzNamePack{tkz-base} and its main macro \tkzNameMacro{tkzInit}. For example, if you want to work on a 10 cm square, but such that the unit is the dm then you will have to use.
\begin{tkzltxexample}[right margin=7cm]
\tkzInit[xmax=1,ymax=1,xstep=0.1,ystep=0.1]
\end{tkzltxexample}
-\tkzname{xstep=0.1} signifie que 1cm représente la graduation $0.1$ ainsi la graduation $1$ se trouve à $10$ cm de l'origine.
+\tkzname{xstep=0.1} means that 1cm represents the $0.1$ graduation so the $1$ graduation is at $10$ cm from the origin.
-En revanche pour des valeurs de $x$ comprises entre \numprint{0} et \numprint{10000} et des valeurs de $y$ comprises entre \numprint{0} et \numprint{100000}, il faudra écrire
+On the other hand, for values of $x$ between \numprint{0} and \numprint{10000} and values of $y$ between \numprint{0} and \numprint{100000}, it will be necessary to write
\begin{tkzltxexample}[right margin=6cm]
\tkzInit[xmax=10000,ymax=100000,xstep=1000,ystep=10000]
\end{tkzltxexample}
-Le résultat est toujours un carré de 10 cm de côté.
+The result is always a 10 cm square.
-Tout cela a peu de sens pour faire de la géométrie euclidienne, et dans ce cas, il est recommandé de laisser l'unité graphique égale à 1 cm. Je n'ai d'ailleurs pas testé si toutes les macros destinées à la géométrie euclidienne acceptaient d'autres valeurs que \tkzname{xstep=1} et \tkzname{ystep=1}. En revanche pour certains dessins, il est intéressant de fixer les valeurs extrêmes et de « clipper » le rectangle de définition afin de contrôler au mieux la taille de la figure.
+All this makes little sense for Euclidean geometry, and in this case it is recommended to leave the graphic unit equal to 1 cm. I have not tested whether all macros for Euclidean geometry accept other values than \tkzname{xstep=1} and \tkzname{ystep=1}. On the other hand, for some drawings, it is interesting to fix the extreme values and to "clip" the definition rectangle in order to control the size of the figure as well as possible.
-\subsection{Syntaxe de \tkzname{tkz-base}}
+\subsection{Syntax of \tkzname{tkz-base}}
-J'ai essayé de généraliser la syntaxe suivante :
+I tried to generalize the following syntax:
\begin{itemize}
- \item la syntaxe est proche de celle de \LATEX, pas besoin « ; »;
- \item toutes les macros ont un nom commençant par \tkzname{tkz};
- \item les accolades sont utilisées pour passer un paramètre qui sera la référence d'un objet créé par la macro;
- \item les parenthèses sont utilisées pour faire référence à un objet déjà créé ou bien pour un couple de coordonnées;
- \item les crochets sont nécessaires pour faire passer des arguments optionnels ou bien encore des options, certains choix sont parfois obligatoires. L'emploi de la virgule même dans un mode Math nécessite d'être protégé dans un groupe TeX;
- \item les blancs (espace) sont interdits entre [...] et (...), [...] et \{...\}, ainsi qu'entre (...) et \{...\} mais il est possible de mettre des espaces entre les arguments optionnels passés [...].
-
+ \item The syntax is close to that of \LATEX, there's no need for "; "
+ \item all the macros have names beginning with \tkzname{tkz};
+ \item braces are used to pass a parameter that will be the reference of an object created by the macro;
+ \item parentheses are used to refer to an object that has already been created or to a coordinate pair;
+ \item square brackets are necessary to pass optional arguments or options, some choices are sometimes mandatory. The use of the comma even in a Math mode requires to be protected in a TeX group;
+ \item blanks (space) are prohibited between [...] and (...), [...] and \{...\}, as well as between (...) and \{…\}, but it is possible to put spaces between past optional arguments [...].
\end{itemize}
-
-\newpage
-\section{Initialisation \tkzcname{tkzInit}}
-\subsection{La macro principale \tkzcname{tkzInit}}
-\begin{NewMacroBox}{tkzInit}{\oarg{local options}}\hypertarget{init}{}
-
-\medskip
-\begin{tabular}{lll}
-\toprule
-options & défaut & définition \\
+\section{Initialization \tkzcname{tkzInit}}
+\subsection{The main macro \tkzcname{tkzInit}}
+\begin{NewMacroBox}{tkzInit}{\oarg{local options}}\hypertarget{init}{}%
+\begin{tabular}{lll}%
+options & default & definition \\
\midrule
-\TOline{xmin} {0} {valeur minimum des abscisses en cm}
-\TOline{xmax} {10} {valeur maximum des abscisses en cm}
-\TOline{xstep}{1} {différence entre deux graduations en $x$}
-\TOline{ymin} {0} {valeur minimum des ordonnées en cm }
-\TOline{ymax} {10} {valeur maximum des ordonnées en cm}
-\TOline{ystep}{1} {différence entre deux graduations en $y$}
+\TOline{xmin} {0} {minimum value of the abscissae in cm}
+\TOline{xmax} {10} {maximum value of the abscissae in cm}
+\TOline{xstep}{1} {difference between two graduations in $x$}
+\TOline{ymin} {0} {minimum y-axis value in cm }
+\TOline{ymax} {10} {maximum y-axis value in cm}
+\TOline{ystep}{1} {difference between two graduations in $y$}
\bottomrule
\end{tabular}
\medskip
-{Le rôle de \tkzname{tkzInit} est de définir un repère \textcolor{red}{orthogonal} et une partie rectangulaire du plan dans laquelle vous allez placer vos dessins à l'aide de coordonnées cartésiennes. Le repère n'est pas obligatoirement normé.
-Cette macro permet de définir votre environnement de travail comme avec une calculatrice.}
+The role of \tkzname{tkzInit} is to define a \textcolor{red}{orthogonal} coordinates system and a rectangular part of the plane in which you will place your drawings using Cartesian coordinates. The coordinates system does not have to be normalized.
+This macro allows you to define your working environment as with a calculator.
\end{NewMacroBox}
-\subsubsection{Modification de la taille du dessin avec \tkzcname{tkzInit}}
-Cette macro prépare le terrain et définit plusieurs constantes. Il est tout à fait possible de faire une figure plus grande que le rectangle prédéfini.
-De plus, comme vous pouvez le constater, il est possible d'utiliser les commandes de \TIKZ\ au milieu de celles de \tkzname{tkz} mais {\color{red} attention aux unités ! il faut réserver cette possibilité que pour des cas exceptionnels}.
+\subsubsection{Changing the drawing size with \tkzcname{tkzInit}}
+This macro sets the stage and defines several constants. It is quite possible to make a figure larger than the predefined rectangle.
+Moreover, as you can see, it is possible to use the commands of \TIKZ\ in the middle of those of \tkzname{tkz} but {\color{red} attention to the units! This possibility must be reserved for exceptional cases only.}
\begin{tkzexample}[latex=10cm,small]
\begin{tikzpicture}
@@ -121,9 +115,9 @@ De plus, comme vous pouvez le constater, il est possible d'utiliser les commande
\end{tkzexample}
%<–––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––>
-\subsubsection{Rôle de \tkzname{xstep} , \tkzname{ystep}}
+\subsubsection{Role of \tkzname{xstep} , \tkzname{ystep}}
-\tkzHandBomb\ Attention, une graduation est représentée par 1 cm, sauf si vous redimensionnez la figure avec l'option \tkzname{scale}. Dans l'exemple ci-dessous \tkzname{xstep} = 2 correspond à 1 cm, donc entre 0 et 10, il nous faudra 5 cm. De même \tkzname{ystep}=400, il y a donc 2 cm entre 0 et 800. Il n'est pas possible d'utiliser les options de \TIKZ, \tkzname{x=...} et \tkzname{y=...}.
+\tkzHandBomb\ Warning, a graduation is represented by 1 cm, unless you resize the figure with the \tkzname{scale} option. In the example below \tkzname{xstep} = 2 corresponds to 1 cm, so between 0 and 10, we will need 5 cm. Similarly \tkzname{ystep}=400, so between 0 and 800 there are 2 cm. It is not possible to use the options of \TIKZ, \tkzname{x=...} and \tkzname{y=...}.
\medskip
\begin{tkzexample}[latex=7cm,small]
@@ -135,7 +129,7 @@ De plus, comme vous pouvez le constater, il est possible d'utiliser les commande
\end{tikzpicture}
\end{tkzexample}
-\subsection{Autre exemple avec \tkzname{xstep} et \tkzname{ystep}}
+\subsection{Another example with \tkzname{xstep} and \tkzname{ystep}}
\begin{tkzexample}[latex=7cm,small]
\begin{tikzpicture}
\tkzInit[xmax=5,xstep=1,ymax=2,ystep=.5]
@@ -144,12 +138,8 @@ De plus, comme vous pouvez le constater, il est possible d'utiliser les commande
\end{tikzpicture}
\end{tkzexample}
-\subsubsection{Origine personnalisée.}
-
-\medskip
-Il est important de remarquer que l'on peut placer un point sans rien calculer.
-
-
+\subsubsection{Customized origin.}
+It is important to note that you can place a point without calculating anything.
\begin{tkzexample}[latex=10cm,small]
\begin{tikzpicture}
\tkzInit[xmin=20,
@@ -164,15 +154,15 @@ Il est important de remarquer que l'on peut placer un point sans rien calculer.
\end{tikzpicture}
\end{tkzexample}
-\subsubsection{Utilisation des décimaux }
+\subsubsection{Use of decimals }
\medskip
-Il est préférable d'écrire les différents arguments relatifs à un axe avec le même nombre de décimales.
-\tkzname{numprint} est utilisé pour afficher les graduations correctement.
+It is preferable to write the different arguments relating to an axis with the same number of decimals.
+\tkzname{numprint} is used to display the graduations correctly.
- Dans l'exemple suivant, \tkzname{numprint} utilise les conventions françaises pour l'écriture des nombres car j'ai utilisé :
+In the following example, \tkzname{numprint} uses the English conventions for writing numbers because I used:
-\tkzcname{usepackage[french]\{babel\} }
+\tkzcname{usepackage[english]\{babel\} }
\medskip
@@ -187,10 +177,7 @@ Il est préférable d'écrire les différents arguments relatifs à un axe avec
\end{tikzpicture}
\end{tkzexample}
-\subsubsection{Valeurs négatives}
-
-\medskip
-
+\subsubsection{Negative values}
\begin{tkzexample}[latex=7cm,small]
\begin{tikzpicture}
\tkzInit[xmin = -40,
@@ -203,5 +190,4 @@ Il est préférable d'écrire les différents arguments relatifs à un axe avec
\end{tikzpicture}
\end{tkzexample}
-
\endinput