Debian Codegraph @

texmf-dist/source/latex/intexgral/intexgral-fr.dtx

raw
1 % \iffalse meta-comment
2 %
3 % Copyright (C) 2025 Valentin Dao
4 %
5 % This file may be distributed and/or modified under the
6 % conditions of the LaTeX Project Public License, either
7 % version 1.3 of this license or (at your option) any later
8 % version. The latest version of this license is in:
9 %
10 % http://www.latex-project.org/lppl.txt
11 %
12 % and version 1.3c or later is part of all distributions of
13 % LaTeX version 2008-05-04 or later.
14 %
15 % This work has the LPPL maintenance status 'maintained'
16 % and the current maintainer is Valentin Dao ([email protected]).
17 %
18 % This work consists of the files intexgral.ins, intexgral-fr.dtx and intexgral-en.dtx, along with the derived files intexgral.sty, intexgral-fr.pdf, and intexgral-en.pdf.
19 %
20 % The repository of this work can be found at:
21 %
22 % https://github.com/ankaa3908/intexgral
23 %
24 %<*driver>
25 % \fi
26 % \iffalse
27 \documentclass[11pt, a4paper]{l3doc}
28
29 \usepackage{amsmath}
30
31 \usepackage{fontspec}
32 \usepackage{unicode-math}
33
34 \setmainfont{ChronicleTextG3}[
35 Extension = .otf,
36 UprightFont = *-Roman-Pro,
37 ItalicFont = *-Italic-Pro,
38 BoldFont = *-Bold-Pro,
39 BoldItalicFont = *-BoldIta-Pro,
40 ]
41
42 \setsansfont{Whitney}[
43 Extension = .otf,
44 UprightFont = *-Medium,
45 ItalicFont = *-MediumItalic,
46 BoldFont = *-Bold,
47 BoldItalicFont = *-BoldItalic,
48 UprightFeatures =
49 {
50 StylisticSet = 1,
51 StylisticSet = 10,
52 StylisticSet = 11,
53 },
54 BoldFeatures =
55 {
56 StylisticSet = 1,
57 StylisticSet = 10,
58 StylisticSet = 11,
59 },
60 ItalicFeatures =
61 {
62 StylisticSet = 1,
63 StylisticSet = 10,
64 StylisticSet = 11,
65 StylisticSet = 8,
66 StylisticSet = 9
67 }
68 ]
69
70 \newfontface{\smbold}{Whitney-Semibold.otf}
71
72 \setmonofont{MonaspaceArgon}[
73 Scale = 0.8,
74 Extension = .otf,
75 UprightFont = *-Medium,
76 UprightFeatures =
77 {
78 CharacterVariant = {1:0,31:1},
79 Ligatures = Common,
80 Contextuals = Alternate
81 },
82 BoldFont = *-SemiBold,
83 ItalicFont = *-MediumItalic,
84 BoldItalicFont = *-SemiBoldItalic
85 ]
86
87 \setmathfont{NewCMMath-Regular.otf}
88
89 \usepackage{intexgral}
90 \RenewDifferential{\odif}{\symup{d}}
91
92 \usepackage[
93 a4paper,
94 marginparwidth = 30mm,
95 top = 3cm,
96 bottom = 2cm,
97 left = 44mm,
98 right = 30mm,
99 marginparsep = 2mm,
100 ]{geometry}
101
102 \usepackage{fancyhdr}
103 \fancyhf{}
104 \fancyfoot[C]{\small\sffamily\itshape---\space\thepage\space\kern0.4mm\/---}
105 \renewcommand{\headrulewidth}{0pt}
106 \pagestyle{fancy}
107
108 \usepackage{fontawesome5}
109 \usepackage{microtype}
110
111 \usepackage[addtotoc]{abstract}
112
113 \usepackage[silence, infograb]{codedescribe}
114 \PkgInfoSetAliases
115
116 \definecolor{RoyalBlue}{RGB}{0, 35, 102}
117 \definecolor{RoyalRed}{RGB}{157, 16, 45}
118 \definecolor{RoyalGreen}{HTML}{48845F}
119 \definecolor{urlcolour}{HTML}{B42F5E}
120
121 \definecolor{packagecolour}{HTML}{B86B00}
122 \definecolor{keycolour}{HTML}{004766}
123 \definecolor{macrocolour}{HTML}{047658}
124 \definecolor{optioncolour}{HTML}{630476}
125
126 \newlabelset{french}
127 {
128 new = \NoAutoSpacing\textsf{nouveau},
129 update = \NoAutoSpacing\textsf{mise à jour},
130 note = \NoAutoSpacing\textsf{N.B},
131 remark = \NoAutoSpacing\textsf{remarque},
132 and = \NoAutoSpacing\textsf{et},
133 or = \NoAutoSpacing\textsf{ou},
134 months =
135 {
136 janvier, février, mars, avril,
137 mai, juin, juillet, août,
138 septembre, octobre, novembre, décembre
139 }
140 }
141
142 \selectlabelset{french}
143
144 \lstset{
145 gobble=2,
146 alsoletter={*-}
147 }
148
149 \setnewcodekey{intexgral}{
150 ruleht = 0,
151 texcsstyle = \bfseries\color{RoyalBlue},
152 texcs2 =
153 {
154 integral,
155 IntegralSetup,
156 differentials,
157 intexgralsetup,
158 },
159 texcs2style = \color{macrocolour},
160 emph =
161 {
162 true,
163 false,
164 default,
165 nested,
166 product,
167 },
168 keywd =
169 {
170 equation,
171 limits,
172 limits*,
173 mode,
174 symbol,
175 nint,
176 llimit,
177 ulimit,
178 domain,
179 domain*,
180 boundary,
181 variables,
182 jacobian,
183 diff-vec,
184 diff-star,
185 diff-symb,
186 diff-options,
187 defaultvar,
188 defaultvar*,
189 vectorstyle,
190 domainstyle,
191 symbolskip,
192 hide-diff,
193 single,
194 double,
195 triple,
196 quadruple,
197 contour,
198 surface,
199 volume
200 },
201 codeprefix = {},
202 resultprefix = {}
203 }
204
205 \defgroupfmt{code}{color=macrocolour}
206 \defobjectfmt{pkg}{pkg}{color=packagecolour, font=\sffamily}
207 \defobjectfmt{option}{option}{color=optioncolour, shape preadj=thin, shape posadj=thin, noshape}
208 \defgroupfmt{keys}{color=keycolour, noshape}
209
210 \usepackage{luacode}
211
212 \begin{luacode}
213 function fontcopyright(fontname)
214 local font = fontloader.open(kpse.find_file(fontname, 'opentype fonts'))
215 if font then
216 local metrics = fontloader.to_table(font)
217 local copyright = metrics.copyright:gsub("https?://%S+$", "")
218 local copyright = copyright:gsub("Copyright%s%(C%)", "\\copyright\\")
219 local copyright = copyright:gsub("&", "\\&")
220 tex.print('\\textit{' .. metrics.fullname .. '}\\par')
221 if not string.find(copyright, "missing") then
222 tex.print(copyright)
223 end
224 end
225 end
226 \end{luacode}
227
228 \usepackage{changelog}
229 \usepackage{enumitem}
230 \renewenvironment{changelogitemize}
231 {\begin{itemize}[label=\raisebox{0.5ex}{$\scriptscriptstyle\blacktriangleright$}]}
232 {\end{itemize}}
233
234 \usepackage[normalem]{ulem}
235
236 \usepackage{polyglossia}
237 \setmainlanguage[
238 variant = french,
239 autospacetypewriter = false,
240 frenchfootnote = true
241 ]{french}
242
243 \usepackage{csquotes}
244 \usepackage[perpage]{footmisc}
245
246 \usepackage{titlesec}
247 \titleformat*{\section}{\sffamily\LARGE\bfseries}
248 \titleformat*{\subsection}{\sffamily\Large\bfseries}
249 \titleformat*{\subsubsection}{\smbold\large}
250
251 \DeclareTranslation{French}{changelog}{Historique des modifications}
252
253 \setlength{\parindent}{0pt}
254
255 \usepackage[totoc=true, columnsep=25pt]{idxlayout}
256
257 \usepackage{hyperref}
258 \hypersetup{
259 pdfauthor = {Valentin Dao},
260 pdftitle = {L'extension intexgral},
261 pdfcreator = {LuaLaTeX with hyperref package},
262 colorlinks = true,
263 linkcolor = RoyalBlue,
264 urlcolor = urlcolour,
265 }
266
267 \usepackage{cleveref}
268
269 \EnableCrossrefs
270
271 \begin{document}
272 \DocInput{intexgral-fr.dtx}
273 \end{document}
274 %</driver>
275 % \fi
276 %
277 % \PkgInfoGet{intexgral}{author}{\fileauthor}
278 % \PkgInfoGet{intexgral}{version}{\fileversion}
279 % \PkgInfoGet{intexgral}{date}{\filedate}
280 % \PkgInfoGet{intexgral}{creation}{\filecreationdate}
281 %
282 % \ExplSyntaxOn
283 % \seq_gset_split:Nne \g_tmpa_seq { - } { \filedate }
284 % \seq_reverse:N \g_tmpa_seq
285 % \xdef\filedate{ \seq_use:Nnnn \g_tmpa_seq {} { - } { - } }
286 % \seq_gclear:N \g_tmpa_seq
287 % \seq_gset_split:Nne \g_tmpa_seq { - } { \filecreationdate }
288 % \seq_reverse:N \g_tmpa_seq
289 % \xdef\filecreationdate{ \seq_use:Nnnn \g_tmpa_seq {} { - } { - } }
290 % \ExplSyntaxOff
291 %
292 % \tstitle{^^A
293 % title = {{\huge L'extension \href{https://ctan.org/pkg/intexgral}{\textsf{intexgral}}}\medbreak {\Large v\fileversion}},
294 % author = {\fileauthor\footnote{E-mail: \href{mailto:[email protected]}{\ttfamily [email protected]}}},
295 % date = {\the\day\ifnum\day=1\textsuperscript{er}\fi\space\tsdate}
296 % }
297 %
298 % \begin{center}
299 % \rule{12.5cm}{0.6pt}
300 % \begin{abstract}
301 % Tandis que la composition d'intégrales est très fréquente en \LaTeX, cette dernière s'avère souvent peu pratique. Lorsque l'expression se complexifie, il devient alors difficile d'en modifier les différents éléments dans un code source peu lisible. Pour répondre à ce problème, le package \tsobj[pkg]{intexgral} met à disposition une macro centrale dont le seul argument est l'intégrande. Tout le reste (les symboles, les bornes, les variables d'intégration\dots) pourra aisément être modifié grâce à une interface \tsobj[meta]{clé=valeur}. Contrairement à la méthode classique, où l'utilisateur choisit l'ordre des bornes avec les caractères actifs \verb|_| et \verb|^|, le package a dû fixer une convention. Ainsi, pour les deux clés gérant les bornes qui seront présentées, l'entrée supposée sera \verb|_|\tsobj[meta]{borne inférieure}\verb|^|\tsobj[meta]{borne supérieure}. Ce package étant écrit en \tsobj[pkg]{expl3}, il dépend donc des packages \LaTeX3 \tsobj[pkg]{l3kernel} et \tsobj[pkg]{l3package}. De plus, \tsobj[pkg]{intexgral} utilise le package \tsobj[pkg]{derivative}\footnote{Disponible sur \textsc{ctan} sous: \url{https://ctan.org/pkg/derivative}} afin de faciliter la manipulation de différentielles, ainsi que le package \tsobj[pkg]{pkginfograb}\footnote{Disponible sur \textsc{ctan} sous: \url{https://ctan.org/pkg/pkginfograb}}.
302 % \end{abstract}
303 % \rule{12.5cm}{0.6pt}
304 % \end{center}
305 %
306 % \newpage
307 % \tableofcontents
308 % \newpage
309 %
310 % \subsection*{Licence}
311 %
312 % \copyright\ 2025 Valentin Dao, publié sous la \LaTeX\ Project Public License (\textsc{lppl}) 1.3c
313 %
314 % \subsection*{Polices}
315 %
316 % \directlua{fontcopyright('ChronicleTextG3-Roman-Pro.otf')}
317 %
318 % \vspace*{\baselineskip}
319 %
320 % \begingroup
321 % \sffamily
322 % \directlua{fontcopyright('Whitney-Medium.otf')}
323 % \endgroup
324 %
325 % \vspace*{\baselineskip}
326 %
327 % \begingroup
328 % \ttfamily
329 % \directlua{fontcopyright('MonaspaceArgon-Medium.otf')}
330 % \copyright\ 2023, GitHub \url{https://github.com/githubnext/monaspace}
331 % \endgroup
332 %
333 % \subsection*{Dépôt}
334 %
335 % \href{https://github.com/ankaa3908/intexgral/tree/main}{\faGithub\ Voir dépôt GitHub}.
336 %
337 % \subsection*{Remerciements}
338 %
339 % Un grand merci à Plante et Slurpy de m'avoir accompagné dans cette aventure que fut l'apprentissage de \TeX, vos conseils ont été précieux. Je tiens également à remercier Anthony pour avoir toujours gentiment révisé les nouvelles versions et m'avoir donné des idées pour celles à venir.
340 %
341 % \newpage
342 %
343 % \section{Options de package}
344 %
345 % \begin{codedescribe}[macro, new={v2.0.0}]{\intexgralsetup}
346 % \begin{codesyntax}
347 % \tsobj[macro]{\intexgralsetup}\tsargs[marg]{options de package}
348 % \end{codesyntax}
349 % Ces options peuvent être déclarées de façon classique avec \tsobj[macro]{\usepackage} ou bien avec \tsobj[macro]{\intexgralsetup} dans le préambule.
350 % \end{codedescribe}
351 %
352 % \begin{codedescribe}[key]{invert-limits}
353 % \begin{codesyntax}[key]
354 % \tsobj[key]{invert-limits}=\tsobj[option, meta or]{true,\uline{false}}
355 % \end{codesyntax}
356 % Cette clé permet d’inverser la convention d’ordre des limites. Le document ne peut suivre qu’une seule convention.
357 % \end{codedescribe}
358 %
359 % \begin{codedescribe}[key, update={v3.0.0}]{invert-diff}
360 % \begin{codesyntax}[key]
361 % \tsobj[key]{invert-diff}=\tsobj[option, meta or]{true,\uline{false}}
362 % \end{codesyntax}
363 % Il est courant de voir les variables d'intégration placées avant l’intégrande dans les articles de physique. Cette clé intervertit donc leurs positionnements.
364 % \end{codedescribe}
365 %
366 % \begin{codedescribe}[key, new={v3.0.0}]{limits-mode}
367 % \begin{codesyntax}[key]
368 % \tsobj[key]{limits-mode}=\tsobj[option, meta or]{limits,\uline{nolimits}}
369 % \end{codesyntax}
370 % Applique \tsobj[macro]{\limits} ou \tsobj[macro]{\nolimits} à toutes les intégrales.
371 % \end{codedescribe}
372 %
373 % \begin{codedescribe}[key]{italic, upright}
374 % \begin{codesyntax}[key]
375 % \tsobj[key]{italic}=\tsobj[option, meta or]{true,\uline{false}}
376 % \tsobj[key]{upright}=\tsobj[option, meta or]{\uline{true},false}
377 % \end{codesyntax}
378 % Ce sont les deux clés du package \tsobj[pkg]{derivative}.
379 % \end{codedescribe}
380 %
381 % \section{Présentation de la macro principale}
382 %
383 % \begin{codedescribe}[macro, update={v3.0.0}]{\integral}
384 % \begin{codesyntax}
385 % \tsmacro{\integral}[list de clés]{intégrande}
386 % \end{codesyntax}
387 % Cette macro est celle qui permet de composer les intégrales. Elle doit naturellement être utilisée en mode mathématique uniquement. En voici un premier exemple sous sa forme la plus simple:
388 % \end{codedescribe}
389 %
390 % \begin{codestore}[1]
391 % \begin{equation}
392 % \integral{x}
393 % \end{equation}
394 % \end{codestore}
395 %
396 % \tsdemo*[intexgral]{1}
397 %
398 % Puisque cette macro est axée autour de l'utilisation de clés, la première partie de cette documentation les présentera en les regroupant par domaines. La seconde partie quant à elle introduira les quelques macros annexes qui viennent compléter l'usage de certaines clés. Le reste de ce document exposera les autres fonctionnalités du package.
399 %
400 % \section{Liste des clés}
401 %
402 % \subsection{Bornes d'intégration}
403 %
404 % \subsubsection{Définir les bornes}
405 %
406 % \begin{codedescribe}[key]{limits, limits*}
407 % \begin{codesyntax}[key]
408 % \tsobj[key]{limits}=\tsargs[marg]{liste-mixte}, \tsargs[arg]{mot-clé}
409 % \tsobj[key]{limits*}=\tsargs[marg]{liste-mixte}, \tsargs[arg]{mot-clé}
410 % \end{codesyntax}
411 % Cette clé détermine les bornes d'intégration à utiliser en suivant la convention édictée dans le résumé. Sous sa forme la plus simple, la valeur de la clé prend comme argument une liste d'éléments séparés par une virgule (\emph{comma-separated values} ou \tsobj[meta]{csv-list}\footnotemark[1]).
412 % \end{codedescribe}
413 %
414 % \begin{codestore}[2]
415 % \begin{equation}
416 % \integral[limits={1, 10}]{f(x)}
417 % \end{equation}
418 % \end{codestore}
419 %
420 % \tsdemo*[intexgral]{2}
421 %
422 % L'avantage notable de la clé \tsobj[key]{limits} est qu'on peut lui spécifier les bornes d'intégration de plusieurs intégrales, et le package compose automatiquement les symboles correspondants. Pour séparer les paires de bornes, il faut utiliser le point-virgule (\emph{semicolon-separated values} ou \tsobj[meta]{ssv-list}\footnotemark[1]).
423 %
424 % \footnotetext[1]{On entend donc par \tsobj[meta]{liste-mixte} le fait que \tsobj[key]{limits} puisse accepter un ensemble de \tsobj[meta]{csv-list} dans une \tsobj[meta]{ssv-list} plus globale.}
425 %
426 % \begin{codestore}[3]
427 % \begin{equation}
428 % \integral[limits={1, 2; 3, 4}, variables={x, y}]{f(x, y)}
429 % \end{equation}
430 % \end{codestore}
431 %
432 % \tsdemo*[intexgral]{3}
433 %
434 % Il est également possible de renseigner des bornes prédéfinies à l'aide de mots-clés (voir \cref{subsec:limits}). Enfin, la variante étoilée permet d'exprimer les bornes de l'intégrale sous forme d'intervalle. Le cas échéant, le sens des crochets s'adapte automatiquement à la présence de $\pm$\verb|\infty|
435 %
436 % \begin{codestore}[4]
437 % \begin{equation}
438 % \integral[limits*={1, 10}]{f(x)}
439 % \end{equation}
440 % \end{codestore}
441 %
442 % \tsdemo*[intexgral]{4}
443 %
444 % \subsection{Modes d'affichage}
445 %
446 % \begin{codedescribe}[key, new={v3.0.0}]{mode}
447 % \begin{codesyntax}[key]
448 % \tsobj[key]{mode}=\tsobj[option, meta or]{\uline{default},nested,product}
449 % \end{codesyntax}
450 % \emph{Uniquement} lorsque la clé \tsobj[key]{limits} est employée, il est possible d'alterner entre trois styles d'affichage distincts. Chacun d'entre eux est entièrement compatible avec l'option \tsobj[key]{invert-diff}.
451 % \begin{describelist*}{option}
452 % \describe{default}{Compose l'ensemble des symboles, puis l'intégrande, puis les variables d'intégration. La macro opérant par défaut dans ce mode, il n'est donc pas nécessaire d'utiliser la clé avec cette valeur.}
453 % \describe{nested}{Compose une intégrale \emph{imbriquée} où symbole et intégrande alternent avant que tous les variables d'intégrations soient écrits.}
454 % \describe{product}{Compose un produit d'intégrales où symbole, intégrande et variables d'intégration alternent.}
455 % \end{describelist*}
456 % Bien sûr, rien ne vous empêche pour le mode produit d'utiliser plusieurs fois la macro \tsobj[macro]{\integral} d'affilée pour produire le même résultat que dans l'exemple ci-dessous. Pour celles et ceux qui préféreraient cependant obtenir le résultat avec une seule macro, cette méthode est permise.
457 % \begin{tsremark}[\textcolor{RoyalRed}{Important:}]
458 % pour les deux derniers modes, l'intégrande sera, d'une certaine manière, \emph{découpée}. Afin de correctement effectuer cette action, il faut avoir recours à la même méthode qu'avec \tsobj[key]{limits}, c'est-à-dire en employant le point-virgule.
459 % \end{tsremark}
460 % \end{codedescribe}
461 %
462 % \begin{center}
463 % \textsc{mode}\kern1ex \tsobj[option]{default}
464 % \end{center}
465 %
466 % \begin{codestore}[5]
467 % \begin{equation}
468 % \integral[limits={1, 2; 3, 4; 5, 6}, variables={x, y, z}, mode=default]{xyz}
469 % \end{equation}
470 % \end{codestore}
471 %
472 % \tsdemo*[intexgral]{5}
473 %
474 % \begin{center}
475 % \textsc{mode}\kern1ex \tsobj[option]{nested}
476 % \end{center}
477 %
478 % \begin{codestore}[6]
479 % \begin{equation}
480 % \integral[limits={1, 2; 3, 4; 5, 6}, variables={z, y, x}, mode=nested]{x;y;z}
481 % \end{equation}
482 % \end{codestore}
483 %
484 % \tsdemo*[intexgral]{6}
485 %
486 % \begin{center}
487 % \textsc{mode}\kern1ex \tsobj[option]{product}
488 % \end{center}
489 %
490 % \begin{codestore}[7]
491 % \begin{equation}
492 % \integral[limits={1, 2; 3, 4; 5, 6}, variables={x, y, z}, mode=product]{x;y;z}
493 % \end{equation}
494 % \end{codestore}
495 %
496 % \tsdemo*[intexgral]{7}
497 %
498 % Pour bien fonctionner, il est évident que les clés \tsobj[key]{limits} et \tsobj[key]{variables} (voir \ref{subsubsec:variables}), ainsi que l'intégrande, doivent avoir le même nombre d'éléments. Si ce n’est pas le cas, la compilation n’échouera pas, mais l’expression de l’intégrale risque de ne plus avoir aucun sens. De nombreux messages d’avertissement seront là pour vous en informer.
499 %
500 % \subsection{Symbole (et encore des bornes)}
501 %
502 % Les clés \tsobj[key]{limits(*)} se révèlent très utiles lorsque l'on souhaite composer une intégrale définie. Néanmoins, cela couvre seulement les expressions finales où les bornes de chaque variable ont été spécifiées. Pour des cas plus généraux --- les intégrales indéfinies donc \nobreak--- elles sont relativement malcommodes. Pour composer une intégrale double sur une surface $S$, on devrait écrire \verb|limits={,;S,}|. Il va sans dire que c'est assez mal adapté pour l'utilisateur et peu optimal pour le package. Par ailleurs, le glyphe ne serait pas correct. L'ensemble des clés à suivre propose donc une façon de facilement modifier le symbole ainsi que les bornes.
503 %
504 % \subsubsection{Sélectionner le symbole}
505 %
506 % \begin{codedescribe}[key, update={v3.0.0}]{symbol}
507 % \begin{codesyntax}[key]
508 % \tsobj[key]{symbol}=\tsobj[meta]{séquence de contrôle}
509 % \end{codesyntax}
510 % Cette clé accepte une macro désignant un symbole d'intégration. Tout symbole préalablement défini par une séquence de contrôle est recevable. Si vous tentez d'en utiliser une qui n'est pas définie, elle sera substituée à \tsobj[macro]{\int} et un message d'avertissement sera émis.
511 % \begin{tsremark}[\textcolor{RoyalGreen}{Remarque:}]
512 % à part la vérification de l'exis tence de la macro, aucun contrôle particulier n'est effectué et la valeur de la clé est utilisée telle quelle pour composer le symbole. Ceci implique notamment deux choses. Tout d'abord, le symbole va dépendre de la façon dont il est défini. Par exemple, \tsobj[pkg]{amsmath} et \tsobj[pkg]{unicode-math} ne définissent pas \tsobj[macro]{\iint} de la même manière. Le résultat sera donc différent. De plus, si vous renseignez comme argument de la clé une macro \emph{définie} mais ne correspondant pas à un symbole intégral, le package n'en tiendra pas compte et utilisera quand même le symbole donné. Outre l'incohérence mathématique que cela peut représenter, il est susceptible que cela mène, sous certaines circonstances, à des erreurs de bas niveau.
513 % \end{tsremark}
514 % \end{codedescribe}
515 %
516 % \begin{codestore}[8]
517 % \begin{equation}
518 % \integral[symbol=\iint, llimit=S, variables={x, y}]{f(x, y)}
519 % \end{equation}
520 % \end{codestore}
521 %
522 % \tsdemo*[intexgral]{8}
523 %
524 % \subsubsection{Générer beaucoup d'intégrales}
525 %
526 % \begin{codedescribe}[key]{nint}
527 % \begin{codesyntax}[key]
528 % \tsobj[key]{nint}=\tsobj[meta]{entier}
529 % \end{codesyntax}
530 % Cette clé accepte un entier $n$ qui permet de composer $n$ intégrales. Il est conseillé d'avoir recours à cette clé seulement si le nombre de symboles dépasse 4 afin de privilégier les glyphes définis par la police mathématique utilisée.
531 % \end{codedescribe}
532 %
533 % \begin{codestore}[9]
534 % \begin{equation}
535 % \integral[nint=5, llimit=\Omega, variables={x_1, x_2, x_3, x_4, x_5}]{f(x_1, x_2, x_3, x_4, x_5)}
536 % \end{equation}
537 % \end{codestore}
538 %
539 % \tsdemo*[intexgral]{9}
540 %
541 % \subsubsection{Définir des bornes ponctuellement}
542 %
543 % \begin{codedescribe}[key, update={v3.0.0}]{llimit, ulimit}
544 % \begin{codesyntax}[key]
545 % \tsobj[key]{llimit}=\tsobj[meta]{borne inférieure}
546 % \tsobj[key]{ulimit}=\tsobj[meta]{borne supérieure}
547 % \end{codesyntax}
548 % Ces deux clés permettent de spécifier les bornes inférieures et supérieures respectivement. Elles ne sont adaptées que si un seul symbole est affiché. Si vous avez besoin de spécifier les deux bornes, la clé \tsobj[key]{limits} devra être privilégiée.
549 % \end{codedescribe}
550 %
551 % \begin{codestore}[10]
552 % \begin{equation}
553 % \integral[llimit={x^2 + y^2 \leq 1}, variables={x, y}]{f(x, y)}
554 % \end{equation}
555 % \end{codestore}
556 %
557 % \tsdemo*[intexgral]{10}
558 %
559 % \subsubsection{Motifs récurrents de bornes}
560 %
561 % Les bornes suivent parfois des schémas courants qui peuvent se généraliser avec des clés, évitant ainsi de surcharger l'argument de \tsobj[key]{llimit}.
562 %
563 % \begin{codedescribe}[key, update={v3.0.0}]{domain, domain*}
564 % \begin{codesyntax}[key]
565 % \tsobj[key]{domain}=\tsargs[marg]{*-liste}
566 % \tsobj[key]{domain*}=\tsargs[marg]{*-liste}
567 % \end{codesyntax}
568 % Ces clés acceptent une liste dont le délimiteur est un astérisque. Ensuite, chaque élément de la liste est analysé de la façon suivante:
569 % \begin{itemize}[label=\textemdash]
570 % \item Le premier token de l’item se voit passer \tsobj[macro]{\mathbb} (précédé d’\tsobj[macro]{\uppercase} au cas où la touche \textsc{shift} serait trop loin pour vos doigts).
571 % \item Les tokens restants --- qui peuvent être vides --- sont placés comme exposant (ou en indice pour la variante étoilée de la clé).
572 % \end{itemize}
573 % \end{codedescribe}
574 %
575 % \begin{codestore}[11]
576 % \begin{equation}
577 % \integral[symbol=\iint, domain={r*r}, variables={x, y}]{xy}
578 % \end{equation}
579 % \end{codestore}
580 %
581 % \tsdemo*[intexgral]{11}
582 %
583 % \begin{codedescribe}[key]{boundary}
584 % \begin{codesyntax}[key]
585 % \tsobj[key]{boundary}=\tsargs[marg]{borne inférieure}
586 % \end{codesyntax}
587 % Cette clé place simplement le symbole $\partial\,$ avant la borne inférieure.
588 % \end{codedescribe}
589 %
590 % \begin{codestore}[12]
591 % \begin{equation}
592 % \integral[symbol=\oint, boundary=S, diff-vec]{G(\vec r)}
593 % \end{equation}
594 % \end{codestore}
595 %
596 % \tsdemo*[intexgral]{12}
597 %
598 % \subsection{Différentielles}
599 %
600 % \subsubsection{Spécifier les variables d'intégration}\label{subsubsec:variables}
601 %
602 % \begin{codedescribe}[key, update={v3.0.0}]{variables}
603 % \begin{codesyntax}[key]
604 % \tsobj[key]{variables}=\tsargs[marg]{liste-csv}, \tsobj[meta]{mot-clé}, \tsobj[option]{none}
605 % \end{codesyntax}
606 % Cette clé permet de définir les variables d'une intégrale sous forme d'une \tsobj[meta]{csv-list}. La clé peut, tout comme \tsobj[key]{limits}, accepter un mot-clé comme argument. Ce comportement est aussi expliqué plus tard (voir \cref{subsec:variablekey})
607 % \begin{tsremark}[\textcolor{RoyalGreen}{Remarque:}]
608 % si aucune variable d'intégration n'est renseignée, c'est-à-dire que \tsobj[key]{variables} n'est pas appelée, le package place automatiquement \enquote{$\odif{x}$} (ou \enquote{$\odif{\vec{r}}$} si \tsobj[key]{diff-vec} est actif). De plus, si \tsobj[option]{none} est passé comme valeur, aucune variable d'intégration ne sera affichée.
609 % \end{tsremark}
610 % \end{codedescribe}
611 %
612 % \begin{codestore}[13]
613 % \begin{equation}
614 % \integral[variables=t]{t^2}
615 % \end{equation}
616 % \end{codestore}
617 %
618 % \tsdemo*[intexgral]{13}
619 %
620 % \subsubsection{Inclure le jacobien}
621 %
622 % \begin{codedescribe}[key]{jacobian}
623 % \begin{codesyntax}[key]
624 % \tsobj[key]{jacobian}
625 % \end{codesyntax}
626 % Cette clé active l'affichage du jacobien lorsque défini par \tsobj[macro]{\NewVariableKeyword}.
627 % \end{codedescribe}
628 %
629 % \begin{codestore}[14]
630 % \begin{equation}
631 % \integral[limits={0, R; 0, 2\pi; 0, \pi}, variables=spherical, mode=product, jacobian]{;;}
632 % \end{equation}
633 % \end{codestore}
634 %
635 % \tsdemo*[intexgral]{14}
636 %
637 % Comme évoqué plus tôt, \tsobj[pkg]{derivative} est utilisé par le package pour composer les différentielles. L'ensemble des clés à suivre, dont le nom portera le préfixe \enquote{\texttt{diff-}}\footnote{Quoique la clé \tsobj[key]{diff-vec} ne soit pas liée à \tsobj[pkg]{derivative}.}, vous permettent ainsi d'appliquer les fonctionnalités de la macro \tsobj[macro]{\odif}.
638 %
639 % \subsubsection{Modifier le symbole des différentielles}
640 %
641 % \begin{codedescribe}[key]{diff-symb}
642 % \begin{codesyntax}[key]
643 % \tsobj[key]{diff-symb}=\tsargs[meta]{macro de différentielle}
644 % \end{codesyntax}
645 % Cette clé permet de modifier le style des différentielles parmi ceux définis par \tsobj[macro]{\NewDifferential}.
646 % \end{codedescribe}
647 %
648 % \begin{codestore}[15]
649 % \NewDifferential{\feynmandiff}{\mathcal{D}}
650 % \begin{equation}
651 % \integral[variables={q(t)}, diff-symb=\feynmandiff]{e^{+\dfrac{\imath S[q(t)]}{\hbar}}}
652 % \end{equation}
653 % \end{codestore}
654 %
655 % \tsdemo*[intexgral]{15}
656 %
657 % \subsubsection{Réaliser une intégrale curviligne}
658 %
659 % \begin{codedescribe}[key]{diff-vec}
660 % \begin{codesyntax}[key]
661 % \tsobj[key]{diff-vec}
662 % \end{codesyntax}
663 % Cette clé applique un vecteur à chaque variable d'intégration en plus d'un point médian. Elle n'est compatible qu'avec le mode \tsobj[option]{default}.
664 % \end{codedescribe}
665 %
666 % \begin{codestore}[16]
667 % \begin{equation}
668 % \integral[double=S, variables=S, diff-vec]{\vec F}
669 % \end{equation}
670 % \end{codestore}
671 %
672 % \tsdemo*[intexgral]{16}
673 %
674 % \subsubsection{Opter pour la variante étoilée}
675 %
676 % \begin{codedescribe}[key]{diff-star}
677 % \begin{codesyntax}[key]
678 % \tsobj[key]{diff-star}
679 % \end{codesyntax}
680 % Activer cette clé revient à utiliser \tsobj[macro]{\odif*} ou ses variantes.
681 % \end{codedescribe}
682 %
683 % \begin{codestore}[17]
684 % \begin{equation}
685 % \integral[double, variables={x, y}, diff-star]{x^2 \exp(y)}
686 % \end{equation}
687 % \end{codestore}
688 %
689 % \tsdemo*[intexgral]{17}
690 %
691 % \subsubsection{Désigner des options}
692 %
693 % \begin{codedescribe}[key]{diff-options}
694 % \begin{codesyntax}[key]
695 % \tsobj[key]{diff-options}=\tsargs[marg]{liste clé-valeur}
696 % \end{codesyntax}
697 % Cette clé accepte une liste de clés telle qu’elle aurait été écrite comme argument optionnel de \tsobj[macro]{\odif} ou ses variantes. Pour illustrer, \verb|diff-options={order={2, 3}, var=all}| sera interprété comme \verb|\odif[order={2, 3}, var=all]{...}|.
698 % \end{codedescribe}
699 %
700 % \begin{codestore}[18]
701 % \begin{equation}
702 % \integral[diff-options={order=4}]{\bar\psi(x)(\imath\gamma^\mu\partial_\mu-m)\psi(x)}
703 % \end{equation}
704 % \end{codestore}
705 %
706 % \tsdemo*[intexgral]{18}
707 %
708 % \section{Macros annexes}
709 %
710 % En plus de la large gamme de clés définies par le package, quelques macros viennent également améliorer leurs usages.
711 %
712 % \subsection{Emplacements personnalisés des différentielles}
713 %
714 % \begin{codedescribe}[macro]{\differentials}
715 % \begin{codesyntax}[macro]
716 % \tsobj[macro]{\differentials}
717 % \end{codesyntax}
718 % Bien que l’option \tsobj[key]{invert-diff} existe, il est souvent souhaitable de pouvoir placer les différentielles où l’on veut. Par exemple, il est fréquent de les voir au numérateur d'une fraction lorsque celui-ci vaut 1. Pour répondre à ce besoin, le package met à disposition la macro \tsobj[macro]{\differentials}. Pour les modes \tsobj[option]{default} et \tsobj[option]{nested}, la macro compose toutes les différentielles d'un coup. Avec \tsobj[option]{product}, il faudra répéter la macro entre chaque point-virgule.
719 % \end{codedescribe}
720 %
721 % \begin{codestore}[19]
722 % \begin{equation}
723 % \integral{\frac{\differentials}{x}}
724 % \end{equation}
725 % \end{codestore}
726 %
727 % \tsdemo*[intexgral]{19}
728 %
729 % \subsection{Retour sur la clé \emph{limits}}\label{subsec:limits}
730 %
731 % \begin{codedescribe}[macro]{\NewLimitsKeyword, \RenewLimitsKeyword, \ProvideLimitsKeyword, \DeclareLimitsKeyword}
732 % \begin{codesyntax}[macro]
733 % \tsobj[macro]{\NewLimitsKeyword}\tsargs[marg]{mot-clé}\tsargs[marg]{bornes}
734 % \end{codesyntax}
735 % Il est courant de devoir renseigner les mêmes bornes dans une intégrale. Pour faciliter leur écriture, les clés \tsobj[key]{limits(*)} acceptent, en plus des bornes explicites, un mot-clé en désignant une paire prédéfinie par l’une de ces quatre macros:
736 % \begin{describelist*}{macro}
737 % \describe{\NewLimitsKeyword}{Crée un nouveau mot-clé et émet une erreur s’il existe déjà.}
738 % \describe{\RenewLimitsKeyword}{Redéfinit un mot-clé et émet une erreur s’il n’existe pas déjà.}
739 % \describe{\ProvideLimitsKeyword}{Ne crée un nouveau mot-clé que s’il n’existe pas déjà. Aucun message ne sera émis dans le cas échéant.}
740 % \describe{\DeclareLimitsKeyword}{Crée un nouveau mot-clé quoi qu’il en soit, écrasant toute définition préalable.}
741 % \end{describelist*}
742 % Voici la liste des mots-clés déjà définis par le package et les bornes qu'ils contiennent:
743 % \begin{describelist*}{option}
744 % \describe{ab}{$a, b$}
745 % \describe{unit}{$0, 1$}
746 % \describe{real}{$-\infty, +\infty$}
747 % \describe{positive}{$0, +\infty$}
748 % \describe{negative}{$-\infty, 0$}
749 % \describe{circle}{$0, 2\pi$}
750 % \describe{sircle}{$0, \pi$}
751 % \describe{qcircle}{$0, \frac\pi 2$}
752 % \describe{height}{$0, H$}
753 % \describe{radius}{$0, R$}
754 % \describe{length}{$0, L$}
755 % \describe{time}{$0, T$}
756 % \end{describelist*}
757 % \begin{tsremark}[\textcolor{RoyalGreen}{Remarque:}]
758 % les mots-clés contiennent les \emph{deux} bornes d'une intégrale en même temps. Ils doivent donc être précédés et/ou suivis de point-virgule.
759 % \end{tsremark}
760 % \begin{tsremark}[\textcolor{RoyalRed}{Important:}]
761 % dû à l'implémentation de \tsobj[macro]{\NewLimitsKeyword} et ses variantes, l'utilisateur \emph{doit} suivre la convention d'ordre des bornes du package, même si \tsobj[key]{invert-limits} est fixé à \tsobj[option]{true}
762 % \end{tsremark}
763 % On pourrait donc modifier l’expression d'une l’intégrale de la façon suivante:
764 % \end{codedescribe}
765 %
766 % \begin{codestore}[20]
767 % \begin{equation}
768 % \integral[limits={radius;circle;scircle}, variables={\rho, z, \phi}]{\rho z \phi}
769 % \end{equation}
770 % \end{codestore}
771 %
772 % \tsdemo*[intexgral]{20}
773 %
774 % Il est tout à fait possible de mélanger ces mots-clés avec la syntaxe plus explicite de \tsobj[key]{limits}.
775 %
776 % \begin{codestore}[21]
777 % \begin{equation}
778 % \integral[limits={time; 34, 40; height}, variables={h, \omega, t}]{h \omega t}
779 % \end{equation}
780 % \end{codestore}
781 %
782 % \tsdemo*[intexgral]{21}
783 %
784 % \subsection{Retour sur la clé \emph{variables}}\label{subsec:variablekey}
785 %
786 % \begin{codedescribe}[macro]{\NewVariableKeyword, \RenewVariableKeyword, \ProvideVariableKeyword, \DeclareVariableKeyword}
787 % \begin{codesyntax}[macro]
788 % \tsobj[macro]{\NewVariableKeyword}\tsargs[marg]{mot-clé}\tsargs[marg]{variables}\tsargs[oarg]{jacobien}
789 % \end{codesyntax}
790 % De façon similaire, les mêmes groupes de variables réapparaissent souvent. On peut donc également définir des mots-clés contenant un ensemble de variables d'intégration préenregistrés. Les variantes de cette macro ont le même comportement que pour \tsobj[macro]{\NewLimitsKeyword}. La seule différence est qu'il est ici possible de définir un jacobien, sous forme d'une \tsobj[meta]{csv-list} si besoin. Son affichage est ensuite contrôlé par la clé \tsobj[key]{jacobian} expliquée précédemment. Voici la liste des mots-clés de variables déjà définis par le package, avec le jacobien pour certains:
791 % \begin{describelist*}{option}
792 % \describe{cartesian}{$x, y, z$}
793 % \describe{planar}{$x, y$}
794 % \describe{polar}{$r, \theta \: (r)$}
795 % \describe{cylindrical}{$r, \theta, z \: (r)$}
796 % \describe{spherical}{$r, \theta, \phi \: (r^2, \sin\theta)$}
797 % \end{describelist*}
798 % \end{codedescribe}
799 %
800 % \begin{codestore}[22]
801 % \begin{equation}
802 % \integral[triple=V, variables=spherical]{f(x, y, z)}
803 % \end{equation}
804 % \end{codestore}
805 %
806 % \tsdemo*[intexgral]{22}
807 %
808 % \subsection{Retour sur la clé \emph{symbol}}
809 %
810 % \begin{codedescribe}[macro, new={v3.0.0}]{\NewSymbolKeyword, \RenewSymbolKeyword, \ProvideSymbolKeyword, \DeclareSymbolKeyword}
811 % \begin{codesyntax}[macro]
812 % \tsobj[macro]{\NewSymbolKeyword}\tsargs[marg]{clé}\tsargs[marg]{symbole}
813 % \end{codesyntax}
814 % Afin de composer des intégrales indéfinies, le package offre essentiellement deux clés: \tsobj[key]{symbol} et \tsobj[key]{llimit}. Bien qu'elles soient simples d'utilisation, il demeure toujours laborieux de les écrire toutes les deux avec leurs valeurs. C'est pourquoi \tsobj[pkg]{intexgral} met à disposition des clés dites \emph{raccourcies}, dont le but est de combiner l'action de sélection du symbole et des bornes. Contrairement aux deux macros précédentes, il s'agit ici de créer de toutes nouvelles clés, et non simplement des valeurs spécifiques attribuées à \tsobj[key]{symbol}. Toutes seules, ces clés modifient le symbole intégral. La valeur de ces clés correspondra elle à la borne inférieure. Voici la liste de l'ensemble des \emph{clé-symbole} définie par le package:
815 % \begin{describelist*}{key}
816 % \describe{single}{symbole utilisé = \tsobj[macro]{\int}}
817 % \describe{double}{symbole utilisé = \tsobj[macro]{\iint}}
818 % \describe{triple}{symbole utilisé = \tsobj[macro]{\iiint}}
819 % \describe{quadruple}{symbole utilisé = \tsobj[macro]{\iiiint}}
820 % \describe{contour}{symbole utilisé = \tsobj[macro]{\oint}}
821 % \describe{surface}{symbole utilisé = \tsobj[macro]{\oiint}}
822 % \describe{volume}{symbole utilisé = \tsobj[macro]{\oiiint}}
823 % \end{describelist*}
824 % \begin{tsremark}[\textcolor{RoyalRed}{Important:}]
825 % offrir la possibilité de créer soi-même une clé à la macro \tsobj[macro]{\integral} représente un risque qui sera mieux expliqué dans la prochaine section. Retenez pour l'instant que toutes ces macros\footnote{À l'exception de \tsobj[macro]{\DeclareSymbolKeyword} qui suppose que l'utilisateur sait ce qu'il fait.} émettront un message d'avertissement si vous tentez de créer une nouvelle \emph{clé-symbole} portant le même nom qu'un groupe de bornes définies.
826 % \end{tsremark}
827 % \end{codedescribe}
828 %
829 % \begin{codestore}[23]
830 % \begin{equation}
831 % \integral[contour=\mathcal{C}, diff-vec]{f(\vec r)}
832 % \end{equation}
833 % \end{codestore}
834 %
835 % \tsdemo*[intexgral]{23}
836 %
837 % \section{Syntaxe \emph{spéciale}}
838 %
839 % \subsection{Présentation de la syntaxe}
840 %
841 % \begin{codedescribe}[macro, new={v3.0.0}]{\integral}
842 % \NoAutoSpacing
843 % \begin{codesyntax}
844 % \tsmacro{\integral}[limits:variables(+j):mode]{intégrande}
845 % \end{codesyntax}
846 % \AutoSpacing
847 % En ce qui concerne les intégrales définies, l'utilisateur sera amené à employer au maximum quatre clés pour les composer: \tsobj[key]{limits}, \tsobj[key]{variables}, \tsobj[key]{mode} et \tsobj[key]{jacobian}. On peut néanmoins leur reprocher la même chose qu'avant; écrire ces quatre clés, pouvant recevoir des arguments assez longs, va à l'encontre de l'objectif principal de ce package. Ainsi, l'utilisateur peut désigner comme argument optionnel d'\tsobj[macro]{\integral}, une syntaxe dite \emph{spéciale} qui n'est propre qu'à \tsobj[pkg]{intexgral}. La logique est la suivante:
848 % \begin{itemize}[label=\textemdash]
849 % \item Vous spécifiez un argument \emph{valide} de la clé \tsobj[key]{limits}
850 % \item Vous spécifiez un argument \emph{valide} de la clé \tsobj[key]{variables}
851 % \item Vous spécifiez un argument \emph{valide} de la clé \tsobj[key]{mode}
852 % \end{itemize}
853 % Et vous séparez le tout d'un deux points. Voyons un exemple pour mieux comprendre.
854 % \end{codedescribe}
855 %
856 % \begin{codestore}[24]
857 % \begin{equation}
858 % \integral[1, 2; 4, 5:y, x:nested]{x; y}
859 % \end{equation}
860 % \end{codestore}
861 %
862 % \tsdemo*[intexgral]{24}
863 %
864 % On entend par \emph{argument valide} le fait que toutes les formes de valeurs acceptées par les quatre clés peuvent être pareillement adoptées par la syntaxe spéciale. Cela comprend donc les mots-clés.
865 %
866 % \begin{codestore}[25]
867 % \begin{equation}
868 % \integral[radius;circle;scircle:spherical:product]{r;\theta;\phi}
869 % \end{equation}
870 % \end{codestore}
871 %
872 % \tsdemo*[intexgral]{25}
873 %
874 % Afin d'inclure le jacobien, il suffit d'écrire \texttt{+j} après l'argument de \tsobj[key]{variables}. Le mode peut aussi être indiqué à l'aide d'une initiale seulement.
875 %
876 % \begin{codestore}[26]
877 % \begin{equation}
878 % \integral[radius;circle;scircle:spherical+j:p]{;;}
879 % \end{equation}
880 % \end{codestore}
881 %
882 % \tsdemo*[intexgral]{26}
883 %
884 % Il est important de répéter que dans la configuration classique de l'argument optionnel, il n'est bien sûr pas obligatoire de renseigner les quatre clés citées. Il en va de même pour cette syntaxe. Puisque la clé \tsobj[key]{mode} n'est pas nécessaire pour \tsobj[option]{default}, cette partie peut être omise.
885 %
886 % \begin{codestore}[27]
887 % \begin{equation}
888 % \integral[1, 2; 3, 4:x, y]{xy}
889 % \end{equation}
890 % \end{codestore}
891 %
892 % \tsdemo*[intexgral]{27}
893 %
894 % Vous pouvez aussi toujours profiter du placement automatique du \enquote{$\odif{x}$} avec cette syntaxe en faisant abstraction de \tsobj[key]{variables}.
895 %
896 % \begin{codestore}[28]
897 % \begin{equation}
898 % \integral[1, 10]{x}
899 % \end{equation}
900 % \end{codestore}
901 %
902 % \tsdemo*[intexgral]{28}
903 %
904 % \subsection{Fonctionnement de la syntaxe}
905 %
906 % Du point de vue de l'utilisateur, il est relativement simple de choisir quelle syntaxe adopter. Toutefois, le package doit pouvoir distinguer les deux. Sans trop rentrer dans les détails\footnote{Les plus courageux d'entre vous sont tout de même invités à lire le code source.} de l'implémentation, il est porté à votre intention que le package tente d'extraire la première clé de l'argument optionnel\footnote{Ou du moins, le groupe de tokens qu'il pense correspondre à une clé.} et vérifie si elle existe. C'est pourquoi, si vous créez une clé avec \tsobj[macro]{\NewSymbolKeyword} dont le nom pourra probablement servir de bornes d'intégrations, \tsobj[pkg]{intexrgal} peut faussement évaluer la nature de l'argument optionnel.
907 %
908 % \section{Paramètres annexes}
909 %
910 % \begin{codedescribe}[macro, new={v3.0.0}]{\IntegralSetup}
911 % \begin{codesyntax}[macro]
912 % \tsmacro{\IntegralSetup}{liste de paramètres}
913 % \end{codesyntax}
914 % Cette macro permet, sous la syntaxe \tsobj[meta]{clé=valeur}, de modifier des paramètres liés à certaines clés. Toutes les assignations effectuées sont locales et la macro peut donc être placée dans un groupe si besoin. Voici un exemple de la macro avec les assignations par défaut du package:
915 % \end{codedescribe}
916 %
917 % \begin{codestore}[defaultparam]
918 % \IntegralSetup
919 % {
920 % defaultvar = {x},
921 % defaultvar* = {r},
922 % vectorstyle = \vec,
923 % domainstyle = \mathbb,
924 % symbolskip = {-6mu},
925 % hide-diff = false
926 % }
927 % \end{codestore}
928 %
929 % \tscode*[intexgral]{defaultparam}
930 %
931 % \begin{codedescribe}[key]{defaultvar, defaultvar*}
932 % \begin{codesyntax}[key]
933 % \tsobj[key]{defaultvar}=\tsargs[marg]{variables}
934 % \end{codesyntax}
935 % Cette clé modifie la variable d'intégration insérée automatiquement lorsque \tsobj[key]{variables} n'est pas utilisée. L'argument peut tout à fait correspondre à un mot clé défini par \tsobj[macro]{\NewVariableKeyword}. La variante étoilée de la clé contrôle la variable d'intégration à composer avec \tsobj[key]{diff-vec}.
936 % \end{codedescribe}
937 %
938 % \begin{codedescribe}[key]{vectorstyle}
939 % \begin{codesyntax}[key]
940 % \tsobj[key]{vectorstyle}=\tsobj[meta]{séquence de contrôle}
941 % \end{codesyntax}
942 % Cette clé modifie la macro à appliquer aux variables quand \tsobj[key]{diff-vec} est en action. Il est donc possible d'altérer le style du vecteur: gras, souligné, ou même un autre style d'un package particulier, \tsobj[pkg]{esvect} par exemple.
943 % \end{codedescribe}
944 %
945 % \begin{codedescribe}[key]{domainstyle}
946 % \begin{codesyntax}[key]
947 % \tsobj[key]{domainstyle}=\tsobj[meta]{séquence de contrôle}
948 % \end{codesyntax}
949 % Semblablement, on peut changer la macro à appliquer pour les clés \tsobj[key]{domain(*)}.
950 % \end{codedescribe}
951 %
952 % \begin{codedescribe}[key]{symbolskip}
953 % \begin{codesyntax}[key]
954 % \tsobj[key]{symbolskip}=\tsobj[meta]{muexpr}
955 % \end{codesyntax}
956 % Lorsque le mode \tsobj[option]{default} est en vigueur, le package insère un crénage entre les symboles pour légèrement les rapprocher. La dimension par défaut ($-6$mu) peut ainsi être ajustée selon la police mathématique en vigueur.
957 % \end{codedescribe}
958 %
959 % \begin{codedescribe}[key]{hide-diff}
960 % \begin{codesyntax}[key]
961 % \tsobj[key]{hide-diff}=\tsobj[option, meta or]{true,\uline{false}}
962 % \end{codesyntax}
963 % Lorsqu'une large partie du document nécessite de ne pas inclure les différentielles, il est possible de prolonger dans la durée l'action plus ponctuelle de \tsobj[key]{variables}\texttt{=}\tsobj[option]{none}.
964 % \end{codedescribe}
965 %
966 % \newpage
967 %
968 % \phantomsection
969 % \addcontentsline{toc}{section}{Historique des modifications}
970 % \begin{changelog}[sectioncmd=\section*]
971 %
972 % \begin{version}[v=3.0.1, date=02-01-2026]
973 % \fixed
974 % \item Bug avec le jacobien dans la syntaxe spéciale (\href{https://github.com/ankaa3908/intexgral/issues/3}{problème \#3}).
975 % \item Documentation anglaise et française (\href{https://github.com/ankaa3908/intexgral/issues/4}{problème \#4}, \href{https://github.com/ankaa3908/intexgral/problèmes/6}{problème \#6} et \href{https://github.com/ankaa3908/intexgral/issues/7}{problème \#7}).
976 % \changed
977 % \item Les mots-clés \tsobj[option]{positive} et \tsobj[option]{real} contiennent maintenant un signe $+$ (\href{https://github.com/ankaa3908/intexgral/issues/5}{problème \#5}).
978 % \end{version}
979 %
980 % \begin{version}[v=3.0.0, date=24-12-2025]
981 % \added
982 % \item Syntaxe spéciale.
983 % \item Clés \tsobj[key]{domain*} et \tsobj[key]{mode}.
984 % \item Macros \tsobj[macro]{\IntegralSetup} et \tsobj[macro]{\NewSymbolKeyword}.
985 % \removed
986 % \item Macros \tsobj[macro]{\defaultdiff}, \tsobj[macro]{\defaultdiff}, \tsobj[macro]{\defaultvdiff} et \tsobj[macro]{\vdiffstyle} en faveur de \tsobj[macro]{\IntegralSetup}.
987 % \item Clés controlant symbole et borne, maintenant gérées à un plus haut niveau avec \tsobj[macro]{\NewSymbolKeyword}.
988 % \item Clé \tsobj[key]{int-split}, en faveur de \tsobj[key]{mode}.
989 % \item Macro \tsobj[macro]{\NewInegralSymbol}.
990 % \changed
991 % \item Les noms de quelques clés (\tsobj[key]{variable} en \tsobj[key]{variables}, \tsobj[key]{lower-lim} et \tsobj[key]{upper-lim} en \tsobj[key]{llimit} et \tsobj[key]{ulimit}, \tsobj[key]{int-symb} en \tsobj[key]{symbol}, \tsobj[key]{invert-differentials} et \tsobj[key]{hide-differentials} en \tsobj[key]{invert-diff} et \tsobj[key]{hide-diff}).
992 % \item \tsobj[key]{jacobian} et \tsobj[key]{diff-star} ne nécessitent plus de valeur booléenne. Il suffit maintenant de les écrire pour activer leurs fonctionnalités.
993 % \item \tsobj[key]{hide-diff} attribué à une option locale plutôt qu'à une option de package.
994 % \item \tsobj[key]{limits-mode} attribué à une option de package plutôt qu'à une clé de macro.
995 % \end{version}
996 %
997 % \begin{version}[v=v2.0.1, date=13-09-2025]
998 % \fixed
999 % \item Problème de compatibilité entre \tsobj[pkg]{unicode-math} et \tsobj[pkg]{amssymb} selon l'ordre de chargement (\href{https://github.com/ankaa3908/intexgral/issues/2}{problème \#2}).
1000 % \end{version}
1001 %
1002 % \begin{version}[v=2.0.0, date=09-09-2025]
1003 % \added
1004 % \item Macros \tsobj[macro]{\intexgralsetup}, \tsobj[macro]{\defaultdiff},\tsobj[macro]{\defaultvdiff} et \tsobj[macro]{\vdiffstyle}.
1005 % \changed
1006 % \item Messages d'avertissement liés aux symboles non-existants. Ils ne sont maintenant provoqués que lorsque l'intégrale est composée.
1007 % \removed
1008 % \item Clé \tsobj[key]{diff-vec-style} en faveur de \tsobj[macro]{\vdiffstyle}.
1009 % \item Message d'avertissement lié à la mauvaise utilisation des points-virgules en conjonction de la clé \tsobj[key]{int-split}.
1010 % \fixed
1011 % \item Bug où l'intégrande n'était pas réinitialisée lorsque \tsobj[macro]{\integral} était employée successivement dans le même groupe \TeX\ (\href{https://tex.stackexchange.com/questions/749990/issue-with-integral-command-from-intexgral-package-in-math-mode}{détails ici}).
1012 % \item Des restes de log \tsobj[pkg]{expl3} qui n'auraient pas dû être là.
1013 % \end{version}
1014 %
1015 % \begin{version}[v=1.1.0, date=29-07-2025]
1016 % \added
1017 % \item Variantes étoilées pour les clés controlant symbole et borne (clés \tsobj[key]{single}, \tsobj[key]{contour} etc).
1018 % \end{version}
1019 %
1020 % \shortversion{v=1.0.0, date=26-07-2025, changes=Version initiale.}
1021 %
1022 % \end{changelog}
1023 %
1024 % \newpage
1025 %
1026 % \phantomsection
1027 % \PrintIndex
1028 %
1029 % \newpage
1030 %
1031 % \section*{Implémentation}
1032 % \phantomsection
1033 % \addcontentsline{toc}{section}{Implémentation}
1034 % \CodelineNumbered
1035 % \NoAutoSpacing
1036 % \hbadness=10000
1037 %
1038 % L'implémentation sera expliquée plus en détails dans une version ultérieure\dots
1039 %
1040 % \begin{macrocode}
1041 %<*package>
1042 %<@@=intexgral>
1043 \NeedsTeXFormat{LaTeX2e}
1044 \RequirePackage{expl3}[2025-05-14]
1045 \RequirePackage{pkginfograb}
1046
1047 % Package declaration
1048
1049 \pkginfograbProvidesExplPackage{intexgral}
1050 {
1051 name = {intexgral} ,
1052 author = {Valentin Dao},
1053 date = {2026-01-02} ,
1054 creation = {2025-07-26} ,
1055 version = {3.0.0} ,
1056 description = {A LaTeX package for typesetting integrals.}
1057 }
1058
1059 \msg_new:nnn { intexgral } { expl3-too-old }
1060 {
1061 Your~expl3~installation~is~too~old,~
1062 "intexgral"~requires~expl3~dated~2025-05-14~or~later.\iow_newline:
1063 Package~loading~has~been~aborted.\iow_newline:
1064 \msg_see_documentation_text:n { intexgral }
1065 }
1066
1067 % expl3 version verification
1068
1069 \@ifpackagelater{expl3}{2025-05-14}{}
1070 { \msg_critical:nn { intexgral } { expl3-too-old } }
1071
1072 % Verifies is \mathbb is defined (default domain style)
1073
1074 \hook_gput_code:nnn { begindocument/before } { . }
1075 { \cs_if_exist:NF \mathbb { \RequirePackage{amsfonts} } }
1076
1077 % Definition of data types for package options
1078
1079 \bool_new:N \l_@@_invert_limits_bool
1080 \bool_new:N \l_@@_deactivate_differentials_bool
1081 \bool_new:N \l_@@_invert_differentials_bool
1082 \tl_new:N \l_@@_limits_style_tl
1083
1084 % Package options
1085
1086 \keys_define:nn { intexgral }
1087 {
1088 invert-limits .bool_set:N = \l_@@_invert_limits_bool,
1089 invert-limits .usage:n = { preamble },
1090 invert-limits .initial:n = { false },
1091
1092 invert-diff .bool_set:N = \l_@@_invert_differentials_bool,
1093 invert-diff .usage:n = { preamble },
1094 invert-diff .initial:n = { false },
1095
1096 limits-mode .choice:,
1097 limits-mode / limits .code:n =
1098 { \tl_set_eq:NN \l_@@_limits_style_tl \tex_limits:D },
1099 limits-mode / nolimits .code:n =
1100 { \tl_set_eq:NN \l_@@_limits_style_tl \tex_nolimits:D },
1101
1102 limits-mode .usage:n = { preamble },
1103 limits-mode .initial:n = { nolimits },
1104
1105 italic .choice:,
1106 italic / true .code:n =
1107 { \PassOptionsToPackage{italic=true}{derivative} },
1108 italic / false .code:n =
1109 { \PassOptionsToPackage{italic=false}{derivative} },
1110
1111 upright .choice:,
1112 upright / true .code:n =
1113 { \PassOptionsToPackage{upright=true}{derivative} },
1114 upright / false .code:n =
1115 { \PassOptionsToPackage{upright=false}{derivative} },
1116 }
1117
1118 % Loads the package options and "derivative" package
1119
1120 \ProcessKeyOptions[intexgral]
1121
1122 \RequirePackage{derivative}
1123
1124 % Warning/Error/Info messages
1125
1126 \cs_new:Nn \@@_warning_msg_header: {
1127 (
1128 integral~no.~
1129 \int_use:N\g_@@_integral_number_int\c_space_tl
1130 \msg_line_context:
1131 )
1132 \iow_newline:
1133 }
1134
1135 \msg_new:nnnn { intexgral } { symb-key-alr-def }
1136 { Symbol~key~"\tl_trim_spaces:n{#1}"~is~already~defined. }
1137 { Use~\token_to_str:N \RenewSymbolKeyword\ instead. }
1138
1139 \msg_new:nnnn { intexgral } { symb-key-not-def }
1140 { Symbol~key~"\tl_trim_spaces:n{#1}"~is~not~defined. }
1141 { Use~\token_to_str:N \NewSymbolKeyword\ instead. }
1142
1143 \msg_new:nnnn { intexgral } { diff-group-alr-def }
1144 { Differential~group~"\tl_trim_spaces:n{#1}"~is~already~defined. }
1145 { Use~\token_to_str:N \RenewVarKeyword\ instead. }
1146
1147 \msg_new:nnnn { intexgral } { diff-group-not-def }
1148 { Differential~group~"\tl_trim_spaces:n{#1}"~is~not~defined. }
1149 { Use~\token_to_str:N \NewVarKeyword\ instead. }
1150
1151 \msg_new:nnnn { intexgral } { lim-group-alr-def }
1152 { Limits~group~"\tl_trim_spaces:n{#1}"~is~already~defined. }
1153 { Use~\token_to_str:N \RenewLimitsKeyword\ instead. }
1154
1155 \msg_new:nnnn { intexgral } { lim-group-not-def }
1156 { Limits~group~"\tl_trim_spaces:n{#1}"~is~not~defined. }
1157 { Use~\NewLimitsKeyword\ instead. }
1158
1159 \msg_new:nnn { intexgral } { key-exists-for-lim }
1160 {
1161 Symbol~key~already~defined~with~
1162 \token_to_str:N \NewLimitsKeyword\ \@@_warning_msg_header:
1163 Key~"#1"~already~exists~for~predefined~limits.~
1164 This~can~disrupt~the~functioning~of~the~special~syntax.
1165 }
1166
1167 \msg_new:nnn { intexgral } { unknown-symb }
1168 {
1169 Unknown~integral~symbol~\@@_warning_msg_header:
1170 The~symbol~\tl_trim_spaces:n{#1}~has~been~replaced~with~
1171 \token_to_str:N\int.
1172 }
1173
1174 \msg_new:nnn { intexgral } { unequal-dim }
1175 {
1176 Inconsistent~structure~\@@_warning_msg_header:
1177 The~number~of~integrals~(#1),~integrands~(#2),~and~
1178 differentials~(#3)~does~not~match.
1179 }
1180
1181 \msg_new:nnn { intexgral } { no-jacobian }
1182 {
1183 Jacobian~unavailable~\@@_warning_msg_header:
1184 A~Jacobian~was~requested~for~the~"#1"~keyword,
1185 ~but~none~was~declared~for~the~latter.
1186 }
1187
1188 \msg_new:nnn { intexgral } { diff-not-sup }
1189 {
1190 Macro~\token_to_str:N\differentials\
1191 not~supported~\@@_warning_msg_header:
1192 You~can't~use~\token_to_str:N\differentials\
1193 with~"nested"~mode~alongside~inverted~differentials.~
1194 I~will~simply~ignore~them.
1195 }
1196
1197 \msg_new:nnn { intexgral } { diff-vec-not-supp }
1198 {
1199 Key~"diff-vec"~not~supported~\@@_warning_msg_header:
1200 You~can't~use~"diff-vec"~with~"#1"~mode.~I~will~simply~ignore~this~key.
1201 }
1202
1203 \msg_new:nnn { intexgral } { use-glyph-instead }
1204 {
1205 Consider~using~the~dedicated~glyph~\@@_warning_msg_header:
1206 The~key~"nint"~was~used~with~fewer~than~
1207 5~regular~integral~signs.
1208 }
1209
1210 % Argument specifiers variants
1211
1212 \cs_generate_variant:Nn \regex_if_match:nnTF { nVTF }
1213 \cs_generate_variant:Nn \@@_new_limits_group:nn { nV }
1214 \cs_generate_variant:Nn \str_if_eq:nnTF { neTF }
1215 \cs_generate_variant:Nn \str_if_eq:nnF { neF }
1216 \cs_generate_variant:Nn \keys_if_exist:nnTF { nVTF }
1217 \cs_generate_variant:Nn \seq_use:Nn { Ne }
1218 \cs_generate_variant:Nn \str_if_eq_p:nn { en }
1219
1220 % DATA TYPES
1221
1222 \tl_new:N \l_@@_key_name_tl
1223 \tl_new:N \l_@@_integrand_tl
1224 \tl_new:N \l_@@_domain_style_tl
1225 \tl_new:N \l_@@_lower_limit_tl
1226 \tl_new:N \l_@@_upper_limit_tl
1227 \tl_new:N \l_@@_integral_symbol_tl
1228 \tl_new:N \l_@@_differential_options_i_tl
1229 \tl_new:N \l_@@_differential_options_ii_tl
1230 \tl_new:N \l_@@_vectorial_differential_style_tl
1231 \tl_new:N \l_@@_independent_differential_options_tl
1232 \tl_new:N \l_@@_domain_char_tl
1233 \tl_new:N \l_@@_domain_dimension_tl
1234 \tl_new:N \l_@@_default_differential_tl
1235 \tl_new:N \l_@@_default_vector_differential_tl
1236 \tl_const:Nn \c_@@_left_bracket_tl { [ }
1237 \tl_const:Nn \c_@@_right_bracket_tl { ] }
1238
1239 \tl_set_eq:NN \l_@@_integral_symbol_tl \int
1240
1241 \bool_new:N \l_@@_manual_differentials_bool
1242 \bool_new:N \l_@@_custom_variables_bool
1243 \bool_new:N \l_@@_separate_integral_bool
1244 \bool_new:N \l_@@_vectorial_differential_bool
1245 \bool_new:N \l_@@_jacobian_bool
1246 \bool_new:N \l_@@_starred_differential_bool
1247 \bool_new:N \l_@@_has_order_bool
1248 \bool_new:N \l_@@_has_var_bool
1249
1250 \bool_set_false:N \l_@@_vectorial_differential_bool
1251 \bool_set_false:N \l_@@_manual_differentials_bool
1252 \bool_set_false:N \l_@@_custom_variables_bool
1253 \bool_set_false:N \l_@@_separate_integral_bool
1254 \bool_set_false:N \l_@@_has_order_bool
1255 \bool_set_false:N \l_@@_has_var_bool
1256
1257 \clist_new:N \l_@@_variable_i_clist
1258 \clist_new:N \l_@@_variable_ii_clist
1259
1260 \seq_new:N \l_@@_integrand_seq
1261 \seq_new:N \l_@@_integral_symbol_seq
1262 \seq_new:N \l_@@_jacobian_seq
1263 \seq_new:N \l_@@_differential_seq
1264 \seq_new:N \l_@@_limits_seq
1265 \seq_new:N \l_@@_upper_limits_seq
1266 \seq_new:N \l_@@_lower_limits_seq
1267 \seq_new:N \l_@@_differential_var_i_seq
1268 \seq_new:N \l_@@_differential_var_ii_seq
1269 \seq_new:N \l_@@_differential_order_i_seq
1270 \seq_new:N \l_@@_differential_order_ii_seq
1271 \seq_new:N \l_@@_domain_seq
1272
1273 \str_new:N \l_@@_display_mode_str
1274
1275 \muskip_new:N \l_@@_inline_symbol_muskip
1276
1277 \prop_new:N \g_@@_limits_keyword_prop
1278 \prop_new:N \g_@@_differential_group_keyword_prop
1279
1280 \int_new:N \l_@@_integral_sequence_int
1281 \int_gzero_new:N \g_@@_integral_number_int
1282
1283 % TeX macros adapted to expl3 syntax
1284
1285 \cs_new_protected:Npn \@@_mkern:N #1
1286 { \tex_mkern:D #1 \scan_stop: }
1287
1288 \cs_new_protected:Npn \@@_mathchoice:nnnn #1#2#3#4
1289 { \mathchoice{#1}{#2}{#3}{#4} }
1290
1291 % SYMBOL
1292
1293 % General form of the symbol (glyph, limits mode, lower limit, upper limit)
1294
1295 \cs_new_protected:Npn \@@_parse_integral_symbol:
1296 {
1297 \tl_use:N \l_@@_integral_symbol_tl
1298 \tl_use:N \l_@@_limits_style_tl
1299 \c_math_subscript_token
1300 { \l_@@_lower_limit_tl }
1301 \c_math_superscript_token
1302 { \l_@@_upper_limit_tl }
1303 }
1304
1305 % Generates the symbols after <limits> is executed
1306
1307 \cs_new_protected:Nn \@@_generate_integral_sequence:
1308 {
1309 \int_set:Nn \l_@@_integral_sequence_int
1310 {
1311 \seq_if_empty:NTF \l_@@_lower_limits_seq
1312 { \seq_count:N \l_@@_upper_limits_seq }
1313 { \seq_count:N \l_@@_lower_limits_seq }
1314 }
1315 \exp_args:NV
1316 \int_step_inline:nn \l_@@_integral_sequence_int
1317 {
1318 \seq_put_right:Nn \l_@@_integral_symbol_seq
1319 {
1320 \@@_set_limits:nn
1321 { \seq_item:Nn \l_@@_lower_limits_seq { ##1 } }
1322 { \seq_item:Nn \l_@@_upper_limits_seq { ##1 } }
1323 \@@_parse_integral_symbol:
1324 }
1325 }
1326 }
1327
1328 % LIMITS
1329
1330 % Inverts the limit order convention
1331
1332 \cs_new_protected:Npn \@@_set_limits:nn #1#2
1333 {
1334 \bool_if:NTF \l_@@_invert_limits_bool
1335 {
1336 \tl_set:Nn \l_@@_lower_limit_tl { #2 }
1337 \tl_set:Nn \l_@@_upper_limit_tl { #1 }
1338 }
1339 {
1340 \tl_set:Nn \l_@@_lower_limit_tl { #1 }
1341 \tl_set:Nn \l_@@_upper_limit_tl { #2 }
1342 }
1343 }
1344
1345 % Creates a keyword containing predefined limits
1346
1347 \cs_new_protected:Npn \@@_new_limits_group:nn #1#2
1348 { \prop_put:Nnn \g_@@_limits_keyword_prop { #1 } { #2 } }
1349
1350 % Verifies if the argument corresponds to a valid keyword
1351
1352 \cs_new:Npn \@@_parse_integral_limit:n #1
1353 {
1354 \prop_if_in:NnTF \g_@@_limits_keyword_prop { #1 }
1355 { \prop_item:Nn \g_@@_limits_keyword_prop { #1 } }
1356 { #1 }
1357 }
1358
1359 % Splits the argument of the key to prepare for parsing
1360
1361 \cs_new_protected:Npn \@@_parse_limits:n #1
1362 {
1363 \tl_set:Nn \l_tmpa_tl { #1 }
1364 \seq_clear:N \l_@@_lower_limits_seq
1365 \seq_clear:N \l_@@_upper_limits_seq
1366 \seq_set_split:NnV \l_@@_limits_seq { ; } \l_tmpa_tl
1367 }
1368
1369 % Limits under regular form
1370
1371 \cs_new_protected:Nn \@@_set_limits_regular:
1372 {
1373 \seq_map_inline:Nn \l_@@_limits_seq
1374 {
1375 \clist_set:Ne \l_tmpa_clist
1376 { \@@_parse_integral_limit:n { ##1 } }
1377 \seq_put_right:Ne \l_@@_lower_limits_seq
1378 { \clist_item:Nn \l_tmpa_clist { 1 } }
1379 \seq_put_right:Ne \l_@@_upper_limits_seq
1380 { \clist_item:Nn \l_tmpa_clist { 2 } }
1381 }
1382 }
1383
1384 % Limits under interval form
1385
1386 \cs_new_protected:Npn \@@_set_limits_starred:
1387 {
1388 \seq_map_indexed_inline:Nn \l_@@_limits_seq
1389 {
1390 \clist_set:Ne \l_tmpa_clist
1391 { \@@_parse_integral_limit:n { ##2 } }
1392 \bool_if:NTF \l_@@_invert_limits_bool
1393 {
1394 \tl_set:Ne \l_@@_lower_limit_tl
1395 {
1396 \clist_item:Nn \l_tmpa_clist { 2 }
1397 \tex_mathpunct:D,
1398 \clist_item:Nn \l_tmpa_clist { 1 }
1399 }
1400 }
1401 {
1402 \tl_set:Ne \l_@@_lower_limit_tl
1403 {
1404 \clist_item:Nn \l_tmpa_clist { 1 }
1405 \tex_mathpunct:D,
1406 \clist_item:Nn \l_tmpa_clist { 2 }
1407 }
1408 }
1409 \bool_if:NTF \l_@@_invert_limits_bool
1410 { \seq_put_right:Ne \l_@@_upper_limits_seq }
1411 { \seq_put_right:Ne \l_@@_lower_limits_seq }
1412 {
1413 \str_case_e:nnF { \clist_item:Nn \l_tmpa_clist { 1 } }
1414 {
1415 { -\infty } { \tex_left:D \c_@@_right_bracket_tl }
1416 }
1417 { \tex_left:D \c_@@_left_bracket_tl }
1418 \tl_use:N \l_@@_lower_limit_tl
1419 \str_case_e:nnF { \clist_item:Nn \l_tmpa_clist { 2 } }
1420 {
1421 { +\infty } { \tex_right:D \c_@@_left_bracket_tl }
1422 }
1423 { \tex_right:D \c_@@_right_bracket_tl }
1424 }
1425 }
1426 }
1427
1428 % VARIABLES
1429
1430 % Creates a keyword containing predefined variables
1431
1432 \cs_new_protected:Npn \@@_new_differential_group:nnn #1#2#3
1433 {
1434 \prop_put:Nnn \g_@@_differential_group_keyword_prop
1435 { #1 } { #2 }
1436 \tl_if_blank:nF { #3 }
1437 {
1438 \clist_set:Nn \l_tmpa_clist { #3 }
1439 \seq_set_from_clist:cN
1440 { g_@@_#1_jacobian_seq }
1441 \l_tmpa_clist
1442 }
1443 }
1444
1445 % expl3 equivalent of \odif(*)
1446
1447 \cs_new:Npn \@@_differentials:nn #1#2
1448 {
1449 \bool_if:NTF \l_@@_starred_differential_bool
1450 { \odif*[#1]{#2} }
1451 { \odif[#1]{#2} }
1452 }
1453
1454 % Extracts the whole "order" <keyval>
1455
1456 \cs_new_protected:Npn \@@_extract_differential_order:n #1
1457 {
1458 \regex_extract_once:nnNT
1459 { order\s*=\s*\{?\s*(\d+(?:\s*,\s*\d+)*)\s*\}? }
1460 { #1 } \l_@@_differential_order_i_seq
1461 { \bool_set_true:N \l_@@_has_order_bool }
1462 \clist_set:Ne \l_tmpa_clist
1463 { \seq_item:Nn \l_@@_differential_order_i_seq { 2 } }
1464 \seq_set_from_clist:NN
1465 \l_@@_differential_order_ii_seq
1466 \l_tmpa_clist
1467 }
1468
1469 % Extracts the whole "var" <keyval>
1470
1471 \cs_new_protected:Npn \@@_extract_differential_var:n #1
1472 {
1473 \regex_extract_once:nnNTF
1474 { var\s*=\s*(none|all|\{\s*(\d+(?:\s*,\s*\d+)*\s*)\}) }
1475 { #1 }
1476 \l_@@_differential_var_i_seq
1477 { \bool_set_true:N \l_@@_has_var_bool }
1478 {
1479 \str_if_in:nnT { #1 } { var }
1480 {
1481 \seq_put_left:Nn \l_@@_differential_var_i_seq { var }
1482 \bool_set_true:N \l_@@_has_var_bool
1483 }
1484 }
1485 \clist_set:Ne \l_tmpa_clist
1486 { \seq_item:Nn \l_@@_differential_var_i_seq { 3 } }
1487 \seq_set_from_clist:NN
1488 \l_@@_differential_var_ii_seq
1489 \l_tmpa_clist
1490 }
1491
1492 % Extracts all keys other than "order" and "var"
1493
1494 \cs_new_protected:Npn \@@_remove_differential_order_and_var:n #1
1495 {
1496 \tl_set:Nn \l_@@_independent_differential_options_tl { #1 }
1497 \regex_replace_all:nnN
1498 {
1499 order\s*=\s*\{?\s*\d+(\s*,\s*\d+)*\s*\}?\s*,?
1500 |
1501 [^-]var(?:\s*=\s*(?:none|all|\{\s*\d+(?:\s*,\s*\d+)*\s*\}))?,?
1502 }
1503 { }
1504 \l_@@_independent_differential_options_tl
1505 }
1506
1507 % Reassembles the variables
1508
1509 \cs_new_protected:Npn \@@_parse_variable:nn #1#2
1510 {
1511 \clist_set:Nn \l_tmpa_clist { #2 }
1512 \seq_set_from_clist:NN \l_tmpa_seq \l_tmpa_clist
1513 \tl_if_empty:nF { #1 }
1514 {
1515 \@@_extract_differential_order:n { #1 }
1516 \@@_extract_differential_var:n { #1 }
1517 \@@_remove_differential_order_and_var:n { #1 }
1518 }
1519 \seq_map_indexed_inline:Nn \l_tmpa_seq {
1520 \tl_if_empty:nF { #1 }
1521 {
1522 \tl_put_right:NV
1523 \l_@@_differential_options_ii_tl
1524 \l_@@_independent_differential_options_tl
1525 \bool_if:NT \l_@@_has_order_bool
1526 {
1527 \tl_put_right:Ne \l_@@_differential_options_ii_tl
1528 {
1529 ,order=
1530 \seq_item:Nn \l_@@_differential_order_ii_seq { ##1 }
1531 }
1532 }
1533 \bool_if:NT \l_@@_has_var_bool
1534 {
1535 \int_compare:nNnTF
1536 { \seq_count:N \l_@@_differential_var_i_seq }
1537 =
1538 { 1 }
1539 {
1540 \tl_put_right:Nn
1541 \l_@@_differential_options_ii_tl
1542 { var }
1543 }
1544 {
1545 \str_if_eq:neF { none }
1546 { \seq_item:Nn \l_@@_differential_var_i_seq { 2 } }
1547 {
1548 \str_if_eq:neTF { all }
1549 { \seq_item:Nn
1550 \l_@@_differential_var_i_seq
1551 { 2 }
1552 }
1553 {
1554 \tl_put_right:Nn
1555 \l_@@_differential_options_ii_tl
1556 { var }
1557 }
1558 {
1559 \seq_if_in:NnT
1560 \l_@@_differential_var_ii_seq
1561 { ##1 }
1562 {
1563 \seq_pop_left:NN
1564 \l_@@_differential_var_ii_seq
1565 \l_tmpa_tl
1566 \tl_put_right:Nn
1567 \l_@@_differential_options_ii_tl
1568 { ,var }
1569 }
1570 }
1571 }
1572 }
1573 }
1574 }
1575 \seq_put_right:Ne \l_@@_differential_seq
1576 {
1577 \@@_differentials:nn
1578 { \exp_not:V \l_@@_differential_options_ii_tl }
1579 { \seq_item:Nn \l_tmpa_seq { ##1 } }
1580 }
1581 \tl_clear:N \l_@@_differential_options_ii_tl
1582 }
1583 }
1584
1585 % Executes all previous macros to push tokens into the variable sequence
1586
1587 \cs_new_protected:Npn \@@_parse_differentials:
1588 {
1589 \bool_if:NTF \l_@@_vectorial_differential_bool
1590 {
1591 \clist_map_inline:Nn \l_@@_variable_i_clist
1592 {
1593 \clist_put_right:Nn \l_@@_variable_ii_clist
1594 { \l_@@_vectorial_differential_style_tl{##1} }
1595 }
1596 \bool_if:NTF \l_@@_custom_variables_bool
1597 {
1598 \exp_args:NVV \@@_parse_variable:nn
1599 \l_@@_differential_options_i_tl
1600 \l_@@_variable_ii_clist
1601 }
1602 {
1603 \exp_args:NV \@@_parse_variable:nn
1604 \l_@@_differential_options_i_tl
1605 {
1606 \l_@@_vectorial_differential_style_tl
1607 { \l_@@_default_vector_differential_tl }
1608 }
1609 }
1610 }
1611 {
1612 \bool_if:NTF \l_@@_custom_variables_bool
1613 {
1614 \exp_args:NVV \@@_parse_variable:nn
1615 \l_@@_differential_options_i_tl
1616 \l_@@_variable_i_clist
1617 }
1618 {
1619 \exp_args:NV \@@_parse_variable:nn
1620 \l_@@_differential_options_i_tl
1621 { \l_@@_default_differential_tl }
1622 }
1623 }
1624 }
1625
1626 % SPECIAL SYNTAX
1627
1628 % Cuts off the value of a key
1629
1630 \cs_new:Npn \@@_retrieve_key_name:w #1=#2\q_stop { #1 }
1631
1632 % Extracts first key name of optional argument
1633
1634 \cs_new_protected:Npn \@@_extract_first_key_name:n #1
1635 {
1636 \clist_set:Nn \l_tmpa_clist { #1 }
1637 \tl_set:Ne \l_tmpa_tl { \clist_item:Nn \l_tmpa_clist { 1 } }
1638 \tl_if_in:NnTF \l_tmpa_tl { = }
1639 {
1640 \tl_set:Ne \l_@@_key_name_tl
1641 {
1642 \exp_last_unbraced:NV
1643 \@@_retrieve_key_name:w \l_tmpa_tl \q_stop
1644 }
1645 }
1646 { \tl_set_eq:NN \l_@@_key_name_tl \l_tmpa_tl }
1647 }
1648
1649 % Sets the keys as usual, or sets them up manually if special syntax is in use
1650
1651 \cs_new_protected:Npn \@@_parse_macro_keys:n #1
1652 {
1653 \keys_if_exist:nVTF { integral } \l_@@_key_name_tl
1654 { \keys_set:nn { integral } { #1 } }
1655 {
1656 \regex_split:nnN { : } { #1 } \l_tmpa_seq
1657 \str_if_eq:eeTF
1658 { \seq_item:Nn \l_tmpa_seq { 2 } }
1659 { +j }
1660 {
1661 \exp_args:NNne \seq_set_item:Nnn \l_tmpa_seq { 2 }
1662 { \l_@@_default_differential_tl+j }
1663 }
1664 {
1665 \int_compare:nNnT { \seq_count:N \l_tmpa_seq } < { 2 }
1666 {
1667 \seq_put_right:NV
1668 \l_tmpa_seq
1669 \l_@@_default_differential_tl
1670 }
1671 }
1672 \int_compare:nNnT { \seq_count:N \l_tmpa_seq } < { 3 }
1673 { \seq_put_right:Nn \l_tmpa_seq { d } }
1674 \seq_set_split:Nne \l_tmpb_seq
1675 { + }
1676 { \seq_item:Nn \l_tmpa_seq { 2 } }
1677 \keys_set:ne { integral }
1678 {
1679 limits = { \seq_item:Nn \l_tmpa_seq { 1 } },
1680 variables = { \seq_item:Nn \l_tmpb_seq { 1 } },
1681 mode =
1682 {
1683 \str_case:enF { \seq_item:Nn \l_tmpa_seq { 3 } }
1684 {
1685 { d } { default }
1686 { n } { nested }
1687 { p } { product }
1688 { default } { default }
1689 { nested } { nested }
1690 { product } { product }
1691 }
1692 { default }
1693 },
1694 \bool_if:nT
1695 {
1696 \int_compare_p:nNn { \seq_count:N \l_tmpb_seq } > { 1 }
1697 &&
1698 \str_if_eq_p:en { \seq_item:Nn \l_tmpb_seq { 2 } } { j }
1699 }
1700 { jacobian }
1701 }
1702 }
1703 }
1704
1705 % PRELIMINARY CONFIGURATIONS
1706
1707 % Verifies that <limits> and <variables> (and <integrand>) have the same size
1708
1709 \cs_new_protected:Nn \@@_check_sequence_size:
1710 {
1711 \int_compare:nNnTF
1712 { \seq_count:N \l_@@_integral_symbol_seq }
1713 =
1714 { \seq_count:N \l_@@_integrand_seq }
1715 {
1716 \int_compare:nNnF
1717 { \seq_count:N \l_@@_integrand_seq }
1718 =
1719 { \seq_count:N \l_@@_differential_seq }
1720 {
1721 \msg_warning:nneee { intexgral } { unequal-dim }
1722 { \seq_count:N \l_@@_integral_symbol_seq }
1723 { \seq_count:N \l_@@_integrand_seq }
1724 { \seq_count:N \l_@@_differential_seq }
1725 }
1726 }
1727 {
1728 \msg_warning:nneee { intexgral } { unequal-dim }
1729 { \seq_count:N \l_@@_integral_symbol_seq }
1730 { \seq_count:N \l_@@_integrand_seq }
1731 { \seq_count:N \l_@@_differential_seq }
1732 }
1733 }
1734
1735 % Performs preparatory actions before executing the main macro
1736
1737 \cs_new_protected:Nn \@@_integral_preconfiguration:
1738 {
1739 \int_gincr:N \g_@@_integral_number_int
1740
1741 \bool_if:NT \l_@@_separate_integral_bool
1742 {
1743 \seq_set_split:NnV
1744 \l_@@_integrand_seq
1745 { ; }
1746 \l_@@_integrand_tl
1747 }
1748
1749 \seq_if_empty:NT \l_@@_integral_symbol_seq
1750 {
1751 \seq_put_right:Nn \l_@@_integral_symbol_seq
1752 { \@@_parse_integral_symbol: }
1753 }
1754
1755 \seq_if_empty:NT \l_@@_integrand_seq
1756 {
1757 \seq_put_right:NV
1758 \l_@@_integrand_seq
1759 \l_@@_integrand_tl
1760 }
1761
1762 \bool_if:NF \l_@@_deactivate_differentials_bool
1763 { \@@_parse_differentials: }
1764
1765 \regex_if_match:nVTF { \c{differentials} } \l_@@_integrand_tl
1766 { \bool_set_true:N \l_@@_manual_differentials_bool }
1767 { \bool_set_false:N \l_@@_manual_differentials_bool }
1768
1769 \bool_if:NT \l_@@_separate_integral_bool
1770 { \@@_check_sequence_size: }
1771 }
1772
1773 % Default mode
1774
1775 \cs_new_protected:Nn \@@_print_default_integral:
1776 {
1777 \bool_if:NT \l_@@_manual_differentials_bool
1778 {
1779 \cs_set_protected:Npn \differentials
1780 { \seq_use:Nn \l_@@_differential_seq { } }
1781 }
1782 \seq_use:Nn \l_@@_integral_symbol_seq
1783 { \@@_mkern:N \l_@@_inline_symbol_muskip }
1784 \bool_if:nT
1785 {
1786 \l_@@_invert_differentials_bool
1787 &&
1788 !\l_@@_manual_differentials_bool
1789 }
1790 {
1791 \seq_use:Nn \l_@@_differential_seq { } \tex_mathop:D{} \!
1792 \bool_if:NT \l_@@_vectorial_differential_bool { \cdot \: }
1793 }
1794 \seq_use:Nn \l_@@_integrand_seq { }
1795 \bool_if:NT \l_@@_jacobian_bool
1796 { \seq_use:Nn \l_@@_jacobian_seq { } }
1797 \bool_if:nT
1798 {
1799 !\l_@@_invert_differentials_bool
1800 &&
1801 !\l_@@_manual_differentials_bool
1802 }
1803 {
1804 \bool_if:NT \l_@@_vectorial_differential_bool { \cdot }
1805 \seq_use:Nn \l_@@_differential_seq { }
1806 }
1807 }
1808
1809 % Nested mode
1810
1811 \cs_new_protected:Nn \@@_print_nested_integral:
1812 {
1813 \bool_if:NT \l_@@_manual_differentials_bool
1814 {
1815 \cs_set_protected:Npn \differentials
1816 { \seq_use:Nn \l_@@_differential_seq { } }
1817 }
1818 \bool_if:NT \l_@@_vectorial_differential_bool
1819 { \msg_warning:nnn { intexgral } { diff-vec-not-supp } { nested } }
1820 \int_step_inline:nn { \seq_count:N \l_@@_integral_symbol_seq }
1821 {
1822 \seq_item:Nn \l_@@_integral_symbol_seq { ##1 }
1823 \bool_if:NTF \l_@@_invert_differentials_bool
1824 {
1825 \bool_if:NT \l_@@_manual_differentials_bool
1826 {
1827 \msg_warning:nn { intexgral } { diff-not-sup }
1828 \cs_set_eq:NN \differentials \scan_stop:
1829 }
1830 \seq_item:Nn \l_@@_differential_seq { ##1 }
1831 \tex_mathop:D{} \!
1832 }
1833 {
1834 \seq_item:Nn \l_@@_integrand_seq { ##1 }
1835 \bool_if:NT \l_@@_jacobian_bool
1836 { \seq_item:Nn \l_@@_jacobian_seq { ##1 } }
1837 }
1838 }
1839 \bool_if:NTF \l_@@_invert_differentials_bool
1840 {
1841 \seq_use:Nn \l_@@_integrand_seq {}
1842 \bool_if:NT \l_@@_jacobian_bool
1843 { \seq_use:Nn \l_@@_jacobian_seq { } }
1844 }
1845 {
1846 \bool_if:NF \l_@@_manual_differentials_bool
1847 {
1848 \seq_use:Nn \l_@@_differential_seq {}
1849 }
1850 }
1851 }
1852
1853 % Product mode
1854
1855 \cs_new_protected:Nn \@@_print_product_integral:
1856 {
1857 \bool_if:NT \l_@@_manual_differentials_bool
1858 {
1859 \cs_set_protected:Npn \differentials
1860 {
1861 \seq_gpop_left:NN \l_tmpa_tl
1862 \tl_use:N \l_tmpa_tl
1863 }
1864 }
1865 \bool_if:NT \l_@@_vectorial_differential_bool
1866 { \msg_warning:nnn { intexgral } { diff-vec-not-supp } { product } }
1867 \int_step_inline:nn { \seq_count:N \l_@@_integral_symbol_seq }
1868 {
1869 \seq_item:Nn \l_@@_integral_symbol_seq { ##1 }
1870 \bool_if:nT
1871 {
1872 \l_@@_invert_differentials_bool
1873 &&
1874 !\l_@@_manual_differentials_bool
1875 }
1876 {
1877 \seq_item:Nn
1878 \l_@@_differential_seq { ##1 }
1879 \tex_mathop:D{} \!
1880 }
1881 \seq_item:Nn \l_@@_integrand_seq { ##1 }
1882 \bool_if:NT \l_@@_jacobian_bool
1883 { \seq_item:Nn \l_@@_jacobian_seq { ##1 } }
1884 \bool_if:nT
1885 {
1886 !\l_@@_invert_differentials_bool
1887 &&
1888 !\l_@@_manual_differentials_bool
1889 }
1890 { \seq_item:Nn \l_@@_differential_seq { ##1 } }
1891 }
1892 }
1893
1894 % General macro for typesetting
1895
1896 \cs_new_protected:Nn \@@_print_integral:
1897 {
1898 \@@_integral_preconfiguration:
1899 \str_case:VnF \l_@@_display_mode_str
1900 {
1901 { default } { \@@_print_default_integral: }
1902 { nested } { \@@_print_nested_integral: }
1903 { product } { \@@_print_product_integral: }
1904 }
1905 { \@@_print_default_integral: }
1906 \seq_gclear:N \l_@@_differential_seq
1907 }
1908
1909 % KEYS
1910
1911 \keys_define:nn { integral } {
1912
1913 % LIMITS
1914
1915 mode .choice:,
1916 mode / default .code:n =
1917 {
1918 \bool_set_false:N \l_@@_separate_integral_bool
1919 \str_set:Nn \l_@@_display_mode_str { default }
1920 },
1921 mode / nested .code:n =
1922 {
1923 \bool_set_true:N \l_@@_separate_integral_bool
1924 \str_set:Nn \l_@@_display_mode_str { nested }
1925 },
1926 mode / product .code:n =
1927 {
1928 \bool_set_true:N \l_@@_separate_integral_bool
1929 \str_set:Nn \l_@@_display_mode_str { product }
1930 },
1931 mode .default:n = { default },
1932
1933 limits .code:n =
1934 {
1935 \@@_parse_limits:n { #1 }
1936 \@@_set_limits_regular:
1937 \@@_generate_integral_sequence:
1938 },
1939
1940 limits* .code:n =
1941 {
1942 \@@_parse_limits:n { #1 }
1943 \@@_set_limits_starred:
1944 \@@_generate_integral_sequence:
1945 },
1946
1947 llimit .tl_set:N = \l_@@_lower_limit_tl,
1948
1949 ulimit .tl_set:N = \l_@@_upper_limit_tl,
1950
1951 symbol .code:n =
1952 {
1953 \cs_if_exist:NTF #1
1954 { \tl_set_eq:NN \l_@@_integral_symbol_tl #1 }
1955 {
1956 \msg_warning:nnn { intexgral } { unknown-symb } { #1 }
1957 \tl_set_eq:NN \l_@@_integral_symbol_tl \int
1958 }
1959 },
1960
1961 % SYMBOL SHORTCUT
1962
1963 nint .code:n =
1964 {
1965 \int_compare:nNnT { #1 } < { 5 }
1966 { \msg_warning:nn { intexgral } { use-glyph-instead } }
1967
1968 \tl_clear:N \l_@@_integral_symbol_tl
1969
1970 \int_step_inline:nn { #1 }
1971 {
1972 \tl_put_right:Nn \l_@@_integral_symbol_tl
1973 { \int }
1974 \int_compare:nNnT { ##1 } < { #1 }
1975 {
1976 \tl_put_right:Nn \l_@@_integral_symbol_tl
1977 {
1978 \@@_mathchoice:nnnn
1979 { \tex_mkern:D -12mu \scan_stop: }
1980 { \tex_mkern:D -8mu \scan_stop: }
1981 { \tex_mkern:D -4mu \scan_stop: }
1982 { \tex_mkern:D -2mu \scan_stop: }
1983 }
1984 }
1985 }
1986 },
1987
1988 % LIMITS SHORTCUTS
1989
1990 domain .code:n =
1991 {
1992 \tl_set:Nn \l_tmpa_tl { #1 }
1993 \seq_set_split:NnV \l_@@_domain_seq { * } \l_tmpa_tl
1994 \seq_map_inline:Nn \l_@@_domain_seq
1995 {
1996 \tl_if_empty:NF \l_@@_lower_limit_tl
1997 { \tl_put_right:Nn \l_@@_lower_limit_tl { \times } }
1998 \tl_set:Ne \l_@@_domain_char_tl
1999 { \exp_args:Ne \str_uppercase:n { \tl_head:n { ##1 } } }
2000 \tl_set:Ne \l_@@_domain_dimension_tl
2001 { \tl_tail:n { ##1 } }
2002 \tl_put_right:Ne \l_@@_lower_limit_tl
2003 {
2004 \exp_not:N \l_@@_domain_style_tl
2005 { \l_@@_domain_char_tl }
2006 \c_math_superscript_token { \l_@@_domain_dimension_tl }
2007 }
2008 }
2009 },
2010
2011 domain* .code:n =
2012 {
2013 \tl_set:Nn \l_tmpa_tl { #1 }
2014 \seq_set_split:NnV \l_@@_domain_seq { * } \l_tmpa_tl
2015 \seq_map_inline:Nn \l_@@_domain_seq
2016 {
2017 \tl_if_empty:NF \l_@@_lower_limit_tl
2018 { \tl_put_right:Nn \l_@@_lower_limit_tl { \times } }
2019 \tl_set:Ne \l_@@_domain_char_tl
2020 { \exp_args:Ne \str_uppercase:n { \tl_head:n { ##1 } } }
2021 \tl_set:Ne \l_@@_domain_dimension_tl
2022 { \tl_tail:n { ##1 } }
2023 \tl_put_right:Ne \l_@@_lower_limit_tl
2024 {
2025 \exp_not:N \l_@@_domain_style_tl
2026 { \l_@@_domain_char_tl }
2027 \c_math_subscript_token { \l_@@_domain_dimension_tl }
2028 }
2029 }
2030 },
2031
2032 boundary .code:n =
2033 { \tl_set:Nn \l_@@_lower_limit_tl { \partial #1 } },
2034
2035 % VARIABLES
2036
2037 variables .code:n =
2038 {
2039 \bool_set_true:N \l_@@_custom_variables_bool
2040 \str_if_eq:nnTF { #1 } { none }
2041 { \bool_set_true:N \l_@@_deactivate_differentials_bool }
2042 {
2043 \prop_get:NnNTF
2044 \g_@@_differential_group_keyword_prop { #1 } \l_tmpa_tl
2045 {
2046 \clist_set:NV \l_@@_variable_i_clist \l_tmpa_tl
2047 \seq_if_exist:cTF { g_@@_#1_jacobian_seq }
2048 {
2049 \seq_set_eq:Nc
2050 \l_@@_jacobian_seq
2051 { g_@@_#1_jacobian_seq }
2052 }
2053 { \msg_warning:nnn { intexgral } { no-jacobian } { #1 } }
2054 }
2055 { \clist_set:Nn \l_@@_variable_i_clist { #1 } }
2056 }
2057 },
2058
2059 jacobian .code:n =
2060 { \bool_set_true:N \l_@@_jacobian_bool },
2061 diff-vec .code:n =
2062 { \bool_set_true:N \l_@@_vectorial_differential_bool },
2063 diff-star .code:n =
2064 { \bool_set_true:N \l_@@_starred_differential_bool },
2065
2066 diff-symb .code:n =
2067 {
2068 \cs_set:Npn \@@_differentials:nn ##1##2 {
2069 \bool_if:NTF \l_@@_starred_differential_bool
2070 { #1*[##1]{##2} }
2071 { #1[##1]{##2} }
2072 }
2073 },
2074
2075 diff-options .tl_set:N = \l_@@_differential_options_i_tl,
2076 }
2077
2078 \keys_define:nn { IntegralSetup }
2079 {
2080 defaultvar .tl_set:N = \l_@@_default_differential_tl,
2081 defaultvar* .tl_set:N = \l_@@_default_vector_differential_tl,
2082 vectorstyle .tl_set:N = \l_@@_vectorial_differential_style_tl,
2083 domainstyle .tl_set:N = \l_@@_domain_style_tl,
2084 symbolskip .tl_set:N = \l_@@_inline_symbol_muskip,
2085 hide-diff .bool_set:N = \l_@@_deactivate_differentials_bool,
2086 }
2087
2088 % END USER MACROS
2089
2090 % Limits keywords
2091
2092 \NewDocumentCommand\NewLimitsKeyword{ m m }
2093 {
2094 \prop_get:NnNTF \g_@@_limits_keyword_prop { #1 } \l_tmpa_tl
2095 { \msg_error:nnn { intexgral } { lim-group-alr-def } { #1 } }
2096 {
2097 \bool_if:NTF \l_@@_invert_limits_bool
2098 {
2099 \clist_set:Nn \l_tmpa_clist { #2 }
2100 \clist_reverse:N \l_tmpa_clist
2101 \@@_new_limits_group:nV { #1 } \l_tmpa_clist
2102 }
2103 { \@@_new_limits_group:nn { #1 } { #2 } }
2104 }
2105 }
2106
2107 \NewDocumentCommand\RenewLimitsKeyword{ m m }
2108 {
2109 \prop_pop:NnNTF \g_@@_limits_keyword_prop { #1 } \l_tmpa_tl
2110 {
2111 \bool_if:NTF \l_@@_invert_limits_bool
2112 {
2113 \clist_set:Nn \l_tmpa_clist { #2 }
2114 \clist_reverse:N \l_tmpa_clist
2115 \@@_new_limits_group:nV { #1 } \l_tmpa_clist
2116 }
2117 { \@@_new_limits_group:nn { #1 } { #2 } }
2118 }
2119 { \msg_error:nnn { intexgral } { lim-group-not-def } }
2120 }
2121
2122 \NewDocumentCommand\ProvideLimitsKeyword{ m m }
2123 {
2124 \prop_get:NnNF \g_@@_limits_keyword_prop { #1 } \l_tmpa_tl
2125 {
2126 \bool_if:NTF \l_@@_invert_limits_bool
2127 {
2128 \clist_set:Nn \l_tmpa_clist { #2 }
2129 \clist_reverse:N \l_tmpa_clist
2130 \@@_new_limits_group:nV { #1 } \l_tmpa_clist
2131 }
2132 { \@@_new_limits_group:nn { #1 } { #2 } }
2133 }
2134 }
2135
2136 \NewDocumentCommand\DeclareLimitsKeyword{ m m }
2137 {
2138 \prop_pop:NnNT \g_@@_limits_keyword_prop { #1 } \l_tmpa_tl
2139 {
2140 \bool_if:NTF \l_@@_invert_limits_bool
2141 {
2142 \clist_set:Nn \l_tmpa_clist { #2 }
2143 \clist_reverse:N \l_tmpa_clist
2144 \@@_new_limits_group:nV { #1 } \l_tmpa_clist
2145 }
2146 { \@@_new_limits_group:nn { #1 } { #2 } }
2147 }
2148 }
2149
2150 % Variable keywords
2151
2152 \NewDocumentCommand\NewVariableKeyword{ m m o }
2153 {
2154 \prop_get:NnNTF \g_@@_differential_group_keyword_prop { #1 }
2155 \l_tmpa_tl
2156 { \msg_error:nnn { intexgral } { diff-group-alr-def } { #1 } }
2157 { \@@_new_differential_group:nnn { #1 } { #2 } { #3 } }
2158 }
2159
2160 \NewDocumentCommand\RenewVariableKeyword{ m m o }
2161 {
2162 \prop_pop:NnNTF \g_@@_differential_group_keyword_prop { #1 }
2163 \l_tmpa_tl
2164 {
2165 \seq_clear:c { g_@@_#1_jacobian_seq }
2166 \@@_new_differential_group:nnn { #1 } { #2 } { #3 }
2167 }
2168 { \msg_error:nnn { intexgral } { diff-group-not-def } { #1 } }
2169 }
2170
2171 \NewDocumentCommand\ProvideVariableKeyword{ m m o }
2172 {
2173 \prop_get:NnNF \g_@@_differential_group_keyword_prop { #1 }
2174 \l_tmpa_tl
2175 { \@@_new_differential_group:nnn { #1 } { #2 } { #3 } }
2176 }
2177
2178 \NewDocumentCommand\DeclareVariableKeyword{ m m o }
2179 {
2180 \prop_pop:NnNT \g_@@_differential_group_keyword_prop { #1 }
2181 \l_tmpa_tl
2182 {
2183 \seq_clear:c { g_@@_#1_jacobian_seq }
2184 \@@_new_differential_group:nnn { #1 } { #2 } { #3 }
2185 }
2186 }
2187
2188 % Symbol keys
2189
2190 \NewDocumentCommand\NewSymbolKeyword{ m m }
2191 {
2192 \prop_if_in:NnT \g_@@_limits_keyword_prop { #1 }
2193 { \msg_warning:nnn { intexgral } { key-exists-for-lim } { #1 } }
2194 \keys_if_exist:nnTF { integral } { #1 }
2195 { \msg_error:nnn { intexgral } { symb-key-alr-def } { #1 } }
2196 {
2197 \keys_define:nn { integral }
2198 {
2199 #1 .meta:n =
2200 {
2201 symbol=#2,
2202 llimit=##1
2203 },
2204 }
2205 }
2206 }
2207
2208 \NewDocumentCommand\RenewSymbolKeyword{ m m }
2209 {
2210 \prop_if_in:NnT \g_@@_limits_keyword_prop { #1 }
2211 { \msg_warning:nnn { intexgral } { key-exists-for-lim } { #1 } }
2212 \keys_if_exist:nnTF { integral } { #1 }
2213 {
2214 \keys_define:nn { integral }
2215 {
2216 #1 .undefine:
2217 #1 .meta:n =
2218 {
2219 symbol=#2,
2220 llimit=##1
2221 }
2222 }
2223 }
2224 { \msg_error:nnn { intexgral } { symb-key-not-def } }
2225 }
2226
2227 \NewDocumentCommand\ProvideSymbolKeyword{ m m }
2228 {
2229 \prop_if_in:NnT \g_@@_limits_keyword_prop { #1 }
2230 { \msg_warning:nnn { intexgral } { key-exists-for-lim } { #1 } }
2231 \keys_if_exist:nnF { integral } { #1 }
2232 {
2233 \keys_define:nn { integral }
2234 {
2235 #1 .meta:n =
2236 {
2237 symbol=#2,
2238 llimit=##1
2239 },
2240 }
2241 }
2242 }
2243
2244 \NewDocumentCommand\DeclareSymbolKeyword{ m m }
2245 {
2246 \keys_define:nn { integral }
2247 {
2248 #1 .undefine:
2249 #1 .meta:n =
2250 {
2251 symbol=#2,
2252 llimit=##1
2253 },
2254 }
2255 }
2256
2257 \NewDocumentCommand\IntegralSetup{ m }
2258 { \keys_set:nn { IntegralSetup } { #1 } }
2259
2260 \NewDocumentCommand\integral{ O{} m }
2261 {
2262 \group_begin:
2263 \tl_if_empty:nF { #1 }
2264 {
2265 \@@_extract_first_key_name:n { #1 }
2266 \@@_parse_macro_keys:n { #1 }
2267 }
2268 \tl_set:Nn \l_@@_integrand_tl { #2 }
2269 \@@_print_integral:
2270 \group_end:
2271 }
2272
2273 % Preamble only
2274
2275 \@onlypreamble\intexgralsetup
2276
2277 % Included keywords
2278
2279 % Symbol keywords
2280 \NewSymbolKeyword{single} {\int}
2281 \NewSymbolKeyword{double} {\iint}
2282 \NewSymbolKeyword{triple} {\iiint}
2283 \NewSymbolKeyword{quadruple} {\iiiint}
2284 \NewSymbolKeyword{contour} {\oint}
2285 \NewSymbolKeyword{surface} {\oiint}
2286 \NewSymbolKeyword{volume} {\oiiint}
2287
2288 % Limits keywords
2289 \NewLimitsKeyword{ab} {a, b}
2290 \NewLimitsKeyword{real} {-\infty, +\infty}
2291 \NewLimitsKeyword{positive} {0, +\infty}
2292 \NewLimitsKeyword{negative} {-\infty, 0}
2293 \NewLimitsKeyword{unit} {0, 1}
2294 \NewLimitsKeyword{circle} {0, 2\pi}
2295 \NewLimitsKeyword{scircle} {0, \pi}
2296 \NewLimitsKeyword{qcircle} {0, \frac{\pi}{2}}
2297 \NewLimitsKeyword{height} {0, H}
2298 \NewLimitsKeyword{radius} {0, R}
2299 \NewLimitsKeyword{length} {0, L}
2300 \NewLimitsKeyword{time} {0, T}
2301
2302 % Variable keywords
2303 \NewVariableKeyword{cartesian} {x, y, z}
2304 \NewVariableKeyword{planar} {x, y}
2305 \NewVariableKeyword{polar} {r, \theta} [r]
2306 \NewVariableKeyword{cylindrical} {r, \theta, z} [r]
2307 \NewVariableKeyword{spherical} {r, \theta, \phi} [r^2, \sin\theta]
2308
2309 % Default parameters
2310
2311 \IntegralSetup
2312 {
2313 defaultvar = {x},
2314 defaultvar* = {r},
2315 vectorstyle = \vec,
2316 domainstyle = \mathbb,
2317 symbolskip = {-6mu},
2318 hide-diff = false
2319 }
2320
2321 \ExplSyntaxOff
2322 % \end{macrocode}