1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255
1256
1257
1258
1259
1260
1261
1262
1263
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273
1274
1275
1276
1277
1278
1279
1280
1281
1282
1283
1284
1285
1286
1287
1288
1289
1290
1291
1292
1293
1294
1295
1296
1297
1298
1299
1300
1301
1302
1303
1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
1320
1321
1322
1323
1324
1325
1326
1327
1328
1329
1330
1331
1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531
1532
1533
1534
1535
1536
1537
1538
1539
1540
1541
1542
1543
1544
1545
1546
1547
1548
1549
1550
1551
1552
1553
1554
1555
1556
1557
1558
1559
1560
1561
1562
1563
1564
1565
1566
1567
1568
1569
1570
1571
1572
1573
1574
1575
1576
1577
1578
1579
1580
1581
1582
1583
1584
1585
1586
1587
1588
1589
1590
1591
1592
1593
1594
1595
1596
1597
1598
1599
1600
1601
1602
1603
1604
1605
1606
1607
1608
1609
1610
1611
1612
1613
1614
1615
1616
1617
1618
1619
1620
1621
1622
1623
1624
1625
1626
1627
1628
1629
1630
1631
1632
1633
1634
1635
1636
1637
1638
1639
1640
1641
1642
1643
1644
1645
1646
1647
1648
1649
1650
1651
1652
1653
1654
1655
1656
1657
1658
1659
1660
1661
1662
1663
1664
1665
1666
1667
1668
1669
1670
1671
1672
1673
1674
1675
1676
1677
1678
1679
1680
1681
1682
1683
1684
1685
1686
1687
1688
1689
1690
1691
1692
1693
1694
1695
1696
1697
1698
1699
1700
1701
1702
1703
1704
1705
1706
1707
1708
1709
1710
1711
1712
1713
1714
1715
1716
1717
1718
1719
1720
1721
1722
1723
1724
1725
1726
1727
1728
1729
1730
1731
1732
1733
1734
1735
1736
1737
1738
1739
1740
1741
1742
1743
1744
1745
1746
1747
1748
1749
1750
1751
1752
1753
1754
1755
1756
1757
1758
1759
1760
1761
1762
1763
1764
1765
1766
1767
1768
1769
1770
1771
1772
1773
1774
1775
1776
1777
1778
1779
1780
1781
1782
1783
1784
1785
1786
1787
1788
1789
1790
1791
1792
1793
1794
1795
1796
1797
1798
1799
1800
1801
1802
1803
1804
1805
1806
1807
1808
1809
1810
1811
1812
1813
1814
1815
1816
1817
1818
1819
1820
1821
1822
1823
1824
1825
1826
1827
1828
1829
1830
1831
1832
1833
1834
1835
1836
1837
1838
1839
1840
1841
1842
1843
1844
1845
1846
1847
1848
1849
1850
1851
1852
1853
1854
1855
1856
1857
1858
1859
1860
1861
1862
1863
1864
1865
1866
1867
1868
1869
1870
1871
1872
1873
1874
1875
1876
1877
1878
1879
1880
1881
1882
1883
1884
1885
1886
1887
1888
1889
1890
1891
1892
1893
1894
1895
1896
1897
1898
1899
1900
1901
1902
1903
1904
1905
1906
1907
1908
1909
1910
1911
1912
1913
1914
1915
1916
1917
1918
1919
1920
1921
1922
1923
1924
1925
1926
1927
1928
1929
1930
1931
1932
1933
1934
1935
1936
1937
1938
1939
1940
1941
1942
1943
1944
1945
1946
1947
1948
1949
1950
1951
1952
1953
1954
1955
1956
1957
1958
1959
1960
1961
1962
1963
1964
1965
1966
1967
1968
1969
1970
1971
1972
1973
1974
1975
1976
1977
1978
1979
1980
1981
1982
1983
1984
1985
1986
1987
1988
1989
1990
1991
1992
1993
1994
1995
1996
1997
1998
1999
2000
2001
2002
2003
2004
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
|
\DocumentMetadata{pdfstandard=A-2b, lang=fr-FR}
\documentclass[a4paper,12pt,german,english,french]{article}
% LuaTeX ONLY!
\usepackage{iftex}[2019/10/24]
\RequireLuaTeX
\usepackage{array,longtable}
\usepackage{varioref}
\renewcommand{\reftextpagerange}[2]{\pageref{#1}--\pageref{#2}}
\usepackage{url,alltt,shortvrb}
\usepackage{graphics}
\usepackage[dvipsnames]{xcolor}
%%% Fontes OpenType avec moteur LuaTeX : Erewhon/Cabin/Inconsolata
\usepackage[no-math]{fontspec}
\usepackage{realscripts}
\setmainfont{erewhon}
%\setsansfont{Cabin}[Scale=MatchLowercase]
\setmonofont{Inconsolatazi4}% voir inconsolata-doc.pdf
[Scale=MatchLowercase, HyphenChar=None, StylisticSet={2,3},
ItalicFont = *-Regular, ItalicFeatures={FakeSlant=0.225}, % 13°
SlantedFont= *-Regular, SlantedFeatures={FakeSlant=0.225},
BoldItalicFont = *-Bold, BoldItalicFeatures={FakeSlant=0.225},
BoldSlantedFont= *-Bold, BoldSlantedFeatures={FakeSlant=0.225},
]
%%% *** APRÈS fontspec ***
\usepackage{babel}
\frenchbsetup{og=«, fg=»}
\frenchbsetup{ListItemsAsPar}
\usepackage{microtype}
% Mise en page
\usepackage[textwidth=160mm,textheight=247mm,hmarginratio=1:1
]{geometry}
%
%\setlength{\parindentFFN}{0em}
\setlength{\parindent}{0mm}
\setlength{\parskip}{.5\baselineskip plus .2\baselineskip
minus .1\baselineskip}
\ifFBListItemsAsPar
\else
\setlength{\listindentFB}{0mm} % sans effet si ListItemsAsPar=true
\fi
\MakeShortVerb{\|}
% Couleurs
% \emph
\let\emphORI\emph
\renewcommand{\emph}[1]{\textcolor{BrickRed}{\emphORI{#1}}}
% verbatim : modifier \verbatim@font
\def\ColorVerb{\color{MidnightBlue}}
\makeatletter
\let\verbatim@fontORI\verbatim@font
\def\verbatim@font{\ColorVerb\verbatim@fontORI}
\makeatother
% options de frenchb :
\def\ColorArg{\color{Sepia}}
%
\newcommand*{\file}[1]{\texttt{\ColorVerb #1}}
\newcommand*{\cls}[1]{\texttt{\ColorVerb #1}}
\newcommand*{\ext}[1]{\texttt{\ColorVerb #1}}
\let\pkg\ext
\newcommand*{\exe}[1]{\texttt{\ColorVerb #1}}
\newcommand*{\opt}[1]{\texttt{\ColorVerb #1}}
\newcommand*{\bibsty}[1]{\texttt{\ColorVerb #1}}
\newcommand*{\env}[1]{\texttt{\ColorVerb #1}}
\newcommand*{\lang}[1]{\texttt{\ColorVerb #1}}
\newcommand*{\code}[1]{\texttt{\ColorVerb #1}}
\newcommand*{\argum}[1]{\textit{#1}}
\newcommand*{\meta}[1]{\textit{< #1 >}}
\newcommand*{\LEFTmargin}{\texttt{<=}}
\providecommand\marg[1]{% % from ltxdoc.cls
{\ttfamily\char`\{}\textit{\ColorArg #1}{\ttfamily\char`\}}}
\providecommand\oarg[1]{%
{\ttfamily[}\textit{\ColorArg #1}{\ttfamily]}}
\DeclareRobustCommand\cs[1]{\texttt{\ColorVerb \char`\\#1}}% from ltxdoc.cls
\newcommand*\fbo[1]{\texttt{\ColorArg #1}}
\newcommand*\fbsetup[1]{\cs{frenchsetup\{\fbo{#1}\}}}
\renewcommand*\descriptionlabel[1]{\hspace\labelsep
\normalfont\ttfamily\bfseries {\MyColor #1}}
\let\MyColor\relax
\providecommand*{\BibTeX}{%
B\textsc{i}\kern-.025em \textsc{b}\kern-.08em \TeX}%
\providecommand*{\biber}{Biber}
\providecommand*{\biblatex}{Biblatex}
% URL de mon site perso :
\begingroup
\catcode`~=12
\xdef\urlperso{http://daniel.flipo.free.fr}
\endgroup
% Adaptation des \subsubsection{} (thèmes des options de \frenchsetup{})
\makeatletter
\renewcommand\subsubsection{\@startsection{subsubsection}{3}{\z@}%
{-1ex\@minus -.5ex}%
{1ex\@minus .5ex}%
{\normalfont\normalsize\bfseries}}
\makeatother
\usepackage{hyperref}
\hypersetup{pdftitle={Mode d’emploi de babel-french},
pdfauthor={Daniel FLIPO},
colorlinks,
urlcolor=PineGreen,
linkcolor=Blue,
}
\newcommand*{\hlabel}[1]{\phantomsection\label{#1}}
% notes bas de page consécutives avec le même numéro
\newcommand*{\samefntmk}{%
\addtocounter{Hfootnote}{-1}\addtocounter{footnote}{-1}\footnotemark}
\title{Mode d’emploi du module \ext{babel-french}}
\author{\href{mailto:daniel.flipo@free.fr}{Daniel \textsc{Flipo}}}
\newcommand*{\latestversion}{3.6a}
\date{Version {\latestversion} -- \today}
\begin{document}
\maketitle
\thispagestyle{empty}
\begin{abstract}
La première version de frenchb (\textbf{french} pour \textbf{b}abel) est
sortie en 1996. La version~2, profondément remaniée, date de mai~2007.
La liste détaillée des changements intervenus depuis la version~2.6 se
trouve à la section~\ref{sec:changes-3.0} p.~\pageref{sec:changes-3.0}.
La version actuelle de frenchb (\latestversion), dont le nom officiel est
\ext{babel-french}, est conçue pour fonctionner aussi bien avec les anciens
formats TeX comme pdf(La)TeX qu’avec les nouveaux Lua(La)TeX et Xe(La)TeX.
Les mises à jour de \ext{babel-french} sont désormais affichées très
rapidement sur CTAN et immédiatement intégrées aux distributions TeXLive,
MikTeX, MacTeX, etc.
La présente documentation en français est également disponible sur CTAN,
il n’y a plus besoin de la récupérer sur mon site
personnel {\expandafter\expandafter\expandafter\url{\urlperso/babel-french}}.
\end{abstract}
\bgroup
\renewcommand{\abstractname}%
{Historique des mises à jour de cette documentation}
\newlength\mybox
\settowidth{\mybox}{5 décembre 2012}
\renewcommand{\descriptionlabel}[1]{\makebox[\mybox][l]{\textbf{#1 :}}}
\vspace{\baselineskip}\noindent
\begin{abstract}
\vspace{-\baselineskip}\noindent
\descindentFB=0pt
\begin{description}
\item[30 janvier 2018] Adaptation à la version 3.4a, voir
section~\ref{ssec:changes-3.4}.
\item[24 février 2018] Regroupement par thèmes des options de \fbsetup{}.
\item[6 juillet 2018] Nouvelle option \fbo{ListItemsAsPar},
voir p.~\pageref{ListAsPar}.
\item[24 janvier 2019] L’option \fbo{StandardListSpacing=true} est à utiliser
de préférence à \fbo{ReduceListSpacing=false},
voir p.~\pageref{listspacing}.
\item[14 mars 2019] Nouvelle commande |\NoEveryParQuote|, voir
p.~\pageref{frquote}.
\item[18 avril 2022] Nouvelle commande |\bname{}|, variante sans petites
capitales de |\bsc{}| voir p.~\pageref{bname}.
\item[11 nov. 2022] Avec Lua(La)TeX le codage |«~abc~»| ne produit plus
d’espace parasite. La redéfinition de |\shorthandoff{}|,
|\shorthandon{}| sous LuaTeX/XeTeX est supprimée.
\item[3 janvier 2023] Modification de la commande |\DecimalMathComma|,
voir p.~\pageref{decimalmathcomma}.
\item[8 mars 2023] Correction de bug dans les listes,
voir p.~\pageref{par-in-lists}.
\item[19 déc. 2023] \ext{babel-french} est maintenant compatible
avec \pkg{ucharclasses} (XeLaTeX). \file{frenchb.ins} supprimée.
\item[22 mai 2024] Adaptation à la version 3.6a, voir
section~\ref{ssec:changes-3.6}.
\end{description}
\end{abstract}
\egroup
\newpage
\renewcommand{\contentsname}{Sommaire}
\tableofcontents{}%
\label{ch-doc8}
\newpage
\section{Appel de l’extension Babel}
Babel est installé en standard dans toutes distributions LaTeX,
pour disposer des langues française et anglaise%
\footnote{En fait américaine (US-english), il existe une variante
\opt{british} pour l’anglais « britannique ».},
il suffit d’ajouter
|\usepackage[english,french]{babel}|%
\footnote{Les options \opt{frenchb} et
\opt{francais} (équivalentes à \opt{french}
depuis 2004), sont conservées pour des raisons de compatibilité, mais elles
\emph{ne devraient plus être utilisées}.}
dans le préambule du document (entre |\documentclass|
et |\begin{document}|).
Il est recommandé de déclarer les options de langues comme arguments
de |\documentclass|, elles peuvent alors être utilisées également par
d’autres extensions :\\
|\documentclass[12pt,english,french]{article}|\\
|\usepackage{varioref}|\\
|\usepackage{babel}|\\
a le même effet que\\
|\documentclass[12pt]{article}|\\
|\usepackage[french]{varioref}|\\
|\usepackage[english,french]{babel}|
La \emph{dernière} langue chargée en option de Babel ou de |\documentclass|
(le français dans les exemples ci-dessus) est la \emph{langue principale}
du document, c’est elle qui est active au début du document et
qui régit la présentation générale (listes, notes de bas de page,
retrait des premiers paragraphes) quelle que soit la langue courante.
\ext{babel-french} propose une variante \opt{acadian}, par défaut identique
à \opt{french}, mais qui peut être personnalisée indépendemment en termes de
césures, d’espacement de la ponctuation haute, etc. Les deux variantes peuvent
être utilisées en parallèle dans le même document.
Pour changer de langue en cours de document on utilise la commande standard
de \mbox{Babel} |\selectlanguage{|\argum{lang}|}|,
par exemple |\selectlanguage{british}| et pour revenir en français
|\selectlanguage{french}|\footnote{Là encore, le nom de la langue
française est \opt{french}, pas \opt{frenchb} ou \opt{français}.}.
Pour passer \emph{localement} dans une autre langue on peut utiliser
l’environnement \\
|\begin{otherlanguage}{|\argum{langue}|}|\\
\hspace*{1em}\argum{texte…}\\
|\end{otherlanguage}|\\
ou pour une courte citation dans un paragraphe\\
|\foreignlanguage{|\argum{langue}%
|}{|\argum{texte…}|}|.
Depuis la version~3.10 de Babel, une syntaxe allégée est proposée pour les
changements de langue : en ajoutant par exemple dans le préambule
|\babeltags{fr = french}|%
\footnote{Rien n’empêche de remplacer \texttt{\ColorVerb fr} par
\texttt{\ColorVerb french}, on retrouve ainsi la syntaxe de
\ext{polyglossia}.}, on peut remplacer
|\foreignlanguage{french}{texte}| par |\textfr{texte}| et\\
|\begin{otherlanguage*}{french} \end{otherlanguage*}| par\hlabel{textfr}
|\begin{fr} \end{fr}|.
|\babeltags| peut s’appliquer à plusieurs langues :
|\babeltags{fr=french, de=german}|.
\emph{Remarque importante sur les fontes.}
Le recours à \ext{babel-french} ne suffit pas pour obtenir des césures
correctes des mots accentués, il faut en outre utiliser des fontes contenant
tous les caractères spéciaux du français (â, é, ï, ù, ç, etc.) ; la façon de
le faire dépend du format utilisé :
\begin{itemize}
\item avec pdfLaTeX il convient d’ajouter dans le préambule les deux
commandes\\
|\usepackage[T1]{fontenc}|\\
|\usepackage{lmodern}|\\
rappelons que la déclaration du codage d’entrée n’est nécessaire que si
celui-ci n’est pas le codage par défaut (|utf8| depuis 2018), par exemple
|latin9| ou |latin1| ou |applemac|, etc.\\
|\usepackage[latin9]{inputenc}|
\item avec LuaLaTeX ou XeLaTeX on peut ajouter |\usepackage{fontspec}| mais
ceci est devenu facultatif avec les formats LaTeX récents (2017).
\end{itemize}
Dans les deux cas, le document sera composé avec les fontes LM ou
\textit{Latin Modern} qui sont la version moderne des fontes CM ou
\textit{Computer Modern}, fontes historiques de TeX.
Les fontes LM conviennent pour toutes les langues de l’Europe de l’ouest
(latines, anglo-saxonnes et scandinaves).\\
Rappelons qu’avec LuaLaTeX ou XeLaTeX aucun appel à
|\usepackage[...]{inputenc}| n’est à faire puisque que le texte source
\emph{doit être codé} en |utf8|.
\goodbreak
L’utilisation de fontes de la famille CM/LM n’est pas du tout indispensable,
\begin{itemize}
\item pour pdfLaTeX toute fonte PostScript en codage~T1 convient, ainsi on
pourra remplacer |lmodern|, au choix par |kpfonts|, |fourier| (Utopia),
|mathptmx| ou |txfonts| (Times), |mathpazo| ou |pxfonts| (Palatino), etc.
\item pour LuaLaTeX ou XeLaTeX, il convient de faire appel aux fontes
OpenType, l’exemple suivant sélectionne une police pour chaque famille
(romain, sans-serif, chasse fixe) et uniformise la hauteur des minuscules :\\
|\usepackage{fontspec}|\\
|\setmainfont{Erewhon}|\\
|\setsansfont[Scale=MatchLowercase]{Cabin}|\\
|\setmonofont[Scale=MatchLowercase,HyphenChar=None]{Inconsolatazi4}|
Il est recommandé d’ajouter également |\usepackage{realscript}| afin de
profiter de vraies lettres supérieures lorsqu’elles sont disponibles.
Il est également possible d’utiliser des fontes PostScript, pour plus de
détails consulter par exemple le chapitre~15 du livre
\textit{LaTeX, l’essentiel} de \bsc{D.~Bitouzé} et \bsc{J.-C.~Charpentier}.
\end{itemize}
\section{Description de la francisation par babel-french}
\label{sec:description}
Dans un document multilingue, il y a des conventions typographiques qui
changent avec la langue, comme la présence ou non d’espaces avant
la ponctuation haute et d’autres, la présentation des listes, des notes
de bas de page ou le retrait des premiers paragraphes des sections qui
devraient s’appliquer globalement à tout le document.
Depuis la version~2.2, \ext{babel-french} utilise la notion de \emph{langue
principale} qui est la \emph{dernière option} (éventuellement la seule) de
la commande |\usepackage[...]{babel}| ; c’est elle qui impose la présentation
globale du document (listes, notes de bas de page, retrait des premiers
paragraphes), les autres conventions typographiques restent locales (elles
varient selon la langue utilisée). Lorsque le français n’est pas la langue
principale, \ext{babel-french} ne modifie en rien la présentation globale du
document : celle-ci est imposée uniquement par la classe et les autres
extensions chargées.
\goodbreak
Lorsque le français est la langue principale, la présentation du
document (ou maquette) est modifiée de la façon suivante%
\footnote{Il est possible, pour chacun des points suivants, de revenir aux
réglages standard de LaTeX, voir section~\ref{sec:Perso}.} :
\begin{itemize}
\item Le premier paragraphe de chaque section est mis en retrait
comme les suivants.
\pagebreak[3]
\item Listes « \env{itemize} » :
\begin{itemize}
\item les marqueurs traditionnels du type «\textbullet» sont remplacés
par défaut par des tirets~longs «---», ou par un autre marqueur
choisi par l’utilisateur (voir section~\ref{sec:Perso}) ;
\item les espaces verticaux ajoutés par LaTeX entre les différents
éléments d’une liste (\textit{items}) sont supprimés.
\item la largeur des marges gauches dans les listes \env{itemize} est
ajustée en fonction du marqueur utilisé. Depuis la version~2.6a, le même
réglage s’applique aussi aux listes \env{enumerate} et trois paramètres
(|\listindentFB|, |\descindentFB| et |\labelwidthFB|) ont été
ajoutés pour permettre d’affiner la présentation des listes \env{itemize},
\env{enumerate} et \env{description} (voir section~\ref{ssec:lists}).
\end{itemize}
\item Par défaut les espacements verticaux de \emph{toutes} les listes
(\env{enumerate}, \env{description} mais aussi
\env{abstract}, \env{quote}, \env{quotation}, \env{verse})
sont réduits.
{\sloppy
\item Les notes de bas de page sont présentées « à la française »
comme ceci\footnote{Une note de bas de page « à la française ».}
{\FBFrenchFootnotesfalse\makeatletter\let\@footnotemark\@footnotemarkORI
au lieu de ceci\footnote{Une note de bas de page standard (classe
\cls{article}), ça jure avec la précédente, non ?}\makeatother}.
Noter, outre la présentation différente du numéro dans la note elle-même,
l’ajout de l’espace fine avant l’appel de la première note.
Le retrait des notes par rapport à la marge gauche est par défaut fixé
au maximum de |\parindent| et de 1.5em, il peut être modifié en
donnant la valeur voulue à |\parindentFFN| dans le préambule :
|\setlength{\parindentFFN}{0mm}| par exemple.
De même, le point qui suit par défaut le numéro de note, ainsi que l’espace
insécable qui sépare ce point du texte de la note peuvent être redéfinis :
ajouter dans le préambule |\renewcommand{\dotFFN}{}|,
|\renewcommand{\kernFFN}{--}| (pas de point, un tiret double sans espace
après le numéro de note).\hlabel{FFN}
\par}
\item Les légendes des figures et des tables utilisent un tiret double
à la place du «\string:», ceci pour toutes les langues, on obtient
«Figure~1~--~Légende» au lieu de «Figure~1\string:~Légende».
Il est possible de choisir un autre séparateur :
pour remplacer le tiret double «--» par un tiret triple «---»,
ajouter dans le préambule\hlabel{captionseparator}\\
|\renewcommand*{\CaptionSeparator}{\space\textemdash\space}|.
Lorsque la langue principale n’est pas le français, le séparateur «\string:»
est utilisé pour toutes les langues mais une espace insécable est en principe
ajoutée en français ; lorsque l’ajout échoue, un message est affiché dans le
fichier \file{.log}.
Certaines classes ou extensions modifient la présentation des légendes ;
parmi elles, les classes \cls{memoir}, \cls{beamer}, koma-script et AMS
et les extensions \ext{caption} et \ext{floatrow} sont compatibles avec
\ext{babel-french}.
Un avertissement est inséré dans le fichier \file{.log} lorsqu’il y a risque
de conflit avec une autre extension ou classe qui modifie la définition de
la commande |\@makecaption| ou lorsque le chargement d’une extension
intervient trop tôt ou trop tard.
\end{itemize}
En ce qui concerne les conventions typographiques locales (variables avec la
langue) la commande |\selectlanguage{french}|
produit les effets suivants :
\begin{itemize}
\item Les motifs de césures françaises sont activés.
\item Des espaces insécables et de taille adéquate sont ajoutés
automatiquement devant la ponctuation haute (|; : ! ?|)%
\footnote{Voir section~\ref{sec:Perso} p.~\pageref{sec:Perso} comment
éviter les ajouts abusifs d’espace avant ces caractères
et section~\ref{sec:active-char} p.~\pageref{sec:active-char} en cas de
problème dû aux caractères actifs.}.
Ceci impose que ces caractères soient rendus actifs (en fait dans tout le
document), \emph{sauf} avec les versions récentes de Xe(La)TeX ou Lua(La)TeX
qui disposent d’un mécanisme permettant d’accéder aux mêmes fonctionnalités
sans recours aux caractères actifs.
\item La commande |\today| retourne la date en français.
\item Les titres («caption names» en anglais) sont traduits en
français, ainsi la commande |\chapter| imprimera
« Chapitre » au lieu de « Chapter ». Voir section~\ref{ssec:captions}
p.~\pageref{ssec:captions} comment modifier ces intitulés.
\item La définition de |\dots| est modifiée%
\footnote{en mode texte seulement, en fait c’est \cs{textellipsis} qui est
modifiée.}, \emph{uniquement} avec les moteurs 8-bits (pdftex), afin de
supprimer l’espace qui suit, espace gênant devant une parenthèse par exemple.
Ceci dit, la commande |\dots| \emph{ne devrait plus être utilisée}
dès lors que le texte source est codé en utf-8 :
il est plus facile de saisir |…|%
\footnote{Il s’agit du glyphe \texttt{…} obtenu par exemple grâce à une touche
\texttt{Compose}, \emph{pas} de \texttt{...} (trois points consécutifs).}
que |\dots|, le texte source est plus lisible et on évite les
problèmes d’avalement des espaces après une commande.
Avec les moteurs Unicode (xetex, luatex), la commande |\dots| standard
utilise le glyphe de la police de sortie sans ajout d’espace,
\ext{babel-french} ne la redéfinit donc pas.
\end{itemize}
\vspace{\parskip}
La commande |\selectlanguage{english}| ramène
au comportement standard de LaTeX (typographie américaine).
Des commandes ont été prévues pour faciliter la saisie :
\begin{itemize}
\item Les guillemets français peuvent être saisis grâce à la commande
|\frquote{|\textit{texte}|}| qui affiche \frquote{\textit{texte}}
avec les espaces insécables adéquats. Il est également possible de coder
|\og texte\fg{}| (ancienne syntaxe toujours valide).
Si les caractères « et » sont accessibles au clavier%
\footnote{grâce à une touche \texttt{Compose} par exemple…},
ils peuvent être utilisés pour saisir les guillemets français, voir
la fin de la section~\ref{sec:Perso}, p.~\pageref{og-fg}.
Notez que les guillemets français ne devraient \emph{jamais} être saisis
avec |<<| et |>>| contrairement à ce qui se fait avec
{e-French} (voir section~\ref{sec:CompatFP}).
L’usage de |\frquote{}| est recommandé pour les citations longues
(c.-à-d. s’étendant sur plus d’un paragraphe) et pour les citations
imbriquées.\hlabel{frquote}
Pour les premières, |\frquote{}| insère automatiquement un guillemet ouvrant
au début de chaque paragraphe, sauf si \fbo{EveryParGuill=close} (guillemet
fermant dans ce cas) ou si \fbo{EveryParGuill=none} (aucun ajout).
Une commande |\NoEveryParQuote| permet de supprimer localement des guillemets
de début de paragraphe ajoutés inconsidérément par la commande |\frquote{}|
notamment dans les listes (après les labels) ; elle doit être utilisée dans
un environnement ou un groupe pour en limiter la portée.
Pour les citations imbriquées, plusieurs présentations sont proposées selon
les options choisies :
\enlargethispage*{\baselineskip}
\begin{itemize}
\item Les citations internes sont balisées par des guillemets anglais
``comme ceci’’ (recommandation de Aurel Ramat) sauf si
\fbo{InnerGuillSingle=true}, dans ce cas les guillemets anglais sont
remplacés par guillemets français simples \guilsinglleft\FBguillspace
comme ceci \FBguillspace\guilsinglright{} (suggestion de Jean Méron).
\item Avec les formats basés sur LuaTeX, il est possible d’insérer en début
de chaque ligne de la citation interne un guillemet dit « de suite »,
ouvrant --~comme le recommande l’Imprimerie nationale~-- avec l’option
\fbo{EveryLineGuill=open}, ou fermant (préconisé par
Jean-Pierre Lacroux) avec l’option \fbo{EveryLineGuill=close}.
Dans les deux cas l’option \fbo{InnerGuillSingle} est sans effet, la
citation interne est toujours balisée par des guillemets chevrons « et ».
\end{itemize}
Lorsque les citations internes et externes se terminent en même temps, il
est d’usage de supprimer le guillemet fermant de la citation interne. Pour
ce faire, il suffit de coder la citation interne avec |\frquote*{}| au lieu
de |\frquote{}|.
Exemple de citation imbriquée :
\vspace{\parskip}
\begin{minipage}[t]{.47\textwidth}
\hspace*{\fill}%
\fbox{\begin{minipage}[t]{.95\textwidth}
\FBInnerGuillSingletrue
\parindent=1em
Xavier raconte ainsi sa mésaventure :
\frquote{Au moment d’enregistrer mes bagages, l’hôtesse
m’a dit tout bonnement :
\frquote*{Je suis désolée, il n’y a plus de place.
Vous allez devoir attendre le prochain vol.\par
C’est un effet de ce qu’on appelle la surréservation,
ou \textit{surbooking} en anglais.}%
}%
\end{minipage}%
}\\[.2\baselineskip]
\hspace*{\fill}\fbo{InnerGuillSingle}\hspace*{\fill}
\end{minipage}
\hspace{\fill}
\begin{minipage}[t]{.47\textwidth}
\fbox{\begin{minipage}[t]{.95\textwidth}
\let\FBeverylineguill\FBguillopen
\parindent=1em
Xavier raconte ainsi sa mésaventure :
\frquote{Au moment d’enregistrer mes bagages, l’hôtesse
m’a dit tout bonnement :
\frquote*{Je suis désolée, il n’y a plus de place.
Vous allez devoir attendre le prochain vol.\par
C’est un effet de ce qu’on appelle la surréservation,
ou \textit{surbooking} en anglais.}%
}%
\end{minipage}%
}\\[.2\baselineskip]
\hspace*{\fill}LuaLaTeX + \fbo{EveryLineGuill=open}\hspace*{\fill}%
\end{minipage}
\vspace{\parskip}
Le codage est le suivant :
{\ttfamily\ColorVerb Xavier raconte… |\frquote{|Au moment… l’hôtesse m’a
dit tout bonnement : |\frquote*{|Je suis désolée, … en anglais.|}}|}
\item La commande |\up| facilite la saisie des exposants en mode texte :
|M\up{me}| imprime M\up{me},
|1\up{er}| donne 1\up{er} ; % 1\ier ;
on dispose aussi de
|\ier| |\iere| |\iers| |\ieres| |\ieme| |\iemes|
pour 1\ier, 1\iere, 1\iers, 1\ieres, 2\ieme, 2\iemes.
La commande |\up| utilise les lettres supérieures de la police lorsqu’elles
sont disponibles et les simule sinon.
On obtient de vraies lettres supérieures
\begin{itemize}
\item avec les moteurs LuaTeX et XeTeX, à condition de charger les extensions
\ext{fontspec} \emph{et} \ext{realscripts} et d’utiliser une police de type
OpenType qui connaisse la directive «sups» (c’est le cas de la plupart
d’entre-elles, il est possible de s’en assurer sous linux grâce à la
commande |otfinfo -f `kpsewhich nom_police.otf`|) ;
\item sous (pdf)LaTeX avec certaines polices type~1 expertes
(Fourier-Utopia).
\end{itemize}
De plus |\up| empêche le passage en capitales des lettres supérieures dans
les hauts de page par exemple.\hlabel{lettres-sup}
Une variante étoilée |\up*| est prévue pour les polices qui disposent d’un jeu
incomplet de lettres supérieures : la police OpenType Jenson Pro ou la police
type~1 Utopia-expert par exemple, n’ont pas de «g supérieur» ; en codant
|M\up{gr}| on obtient Mg\up{r} (Jenson) ou M\up{r} (Utopia-expert) tandis que
|M\up*{gr}| force l’utilisation de supérieures simulées ce qui pallie l’absence
du «g supérieur», le résultat est M\up*{gr}.
Pour les perfectionnistes, il est facile d’ajuster la taille et le placement
vertical des lettres supérieures simulées par |\fup|
(voir dans le code de \file{frenchb.dtx} les commandes |\FBsupS| et
|\FBsupR|).
\item Les commandes |\bname{}|\label{bname} (\textit{boxed name})
et |\bsc{}| (\textit{boxed small caps}) facilitent la saisie des noms
propres : toutes deux empêchent la coupure de leur argument, sauf au niveau
du tiret pour les noms composés ;
la seconde imprime son argument en petites capitales, ce qui est d’usage par
exemple dans les bibliographies ou les signatures.\\
Exemples : |\bname{Montesquieu}|, |Albert~\bsc{Camus}|.\\
N.B. Ces commandes ne mettent pas leur argument dans une |\mbox{}|, leur
effet n’est pas aussi radical : un |\kern0pt| inhibe toute coupure du mot
suivant, ce qui marche bien pour les noms simples ou composés avec un tiret
et a l’avantage de préserver l’expansion éventuellement faite par
\pkg{microtype}. Les patronymes à particule peuvent poser problème : coder
|Jean~\bname{de La Fontaine}| n’aurait strictement aucun effet (les coupures
après `de’, après `La’ ou `Fon-taine’ restent possibles), en revanche
|Jean~de~La~\bname{Fontaine}| empêcherait toute coupure.
\item les commandes |\primo|, |\secundo|,
|\tertio| et |\quarto| peuvent
être utilisées dans les énumérations ; elles donnent
\primo, \secundo, \tertio, \quarto.
Ensuite, |\FrenchEnumerate{6}| donne \FrenchEnumerate{6}.
\item Les abréviations de «numéro», \No, \Nos, \no{} et \nos, sont obtenues
en tapant |\No|, |\Nos|, |\no| et |\nos| ; elles incluent
une espace insécable finale : coder |\no1| ou |\no 1| suffit.
\item Le caractère \degre{} (à ne pas confondre avec le petit «o» de \No)
est saisi |\degre|, mais comme les espaces avant
et après ce caractère dépendent fortement de la police utilisée
(PostScript ou non), on emploiera |\degres| pour saisir
les températures « 20~\textdegree C » (codé |20~\degres C|
avec espace insécable) ou les titres alcooliques « 45\degres{} »
(codé |45\degres| sans espace).
Lorsque l’extension \ext{textcomp} est chargée (elle donne accès
aux « \TeX{} Companion fonts » qui contiennent un vrai symbole degré),
|\degres| utilise celui-ci (|\textdegree|).
\item \hlabel{frenchdate} La commande
|\frenchdate|\marg{année}\marg{mois}\marg{jour}, qui prend trois arguments
numériques obligatoires, affiche les dates en français :
|\frenchdate{2001}{01}{01}| donne \frenchdate{2001}{01}{01}, le résultat
est inclus par défaut dans une boîte (|\hbox|) afin de ne jamais subir de
coupure de ligne (cf.~Gouriou, Ramat). En cas de difficulté
il est possible de redéfinir, localement par exemple, les commandes
|\FBdatebox| (|\hbox| par défaut) et |\FBdatespace| (|\space| par défaut) :
|\renewcommand*{\FBdatebox}{\relax}| supprime la |\hbox| tandis que
|\renewcommand*{\FBdatespace}{~}| rend les deux espaces insécables.
L’effet de ces deux commandes appliquées simultanément est d’interdire la
coupure sur les espaces mais d’autoriser éventuellement celle du mois
(jan-vier, dé-cembre, …) qui est interdite par défaut.
\item En mode mathématique, la virgule est toujours suivie d’une espace car
elle est traitée comme un signe de ponctuation et non comme une virgule
décimale%
\footnote{Une virgule décimale peut toujours être codée \code{\{,\}} en mode
math.}.
La commande |\DecimalMathComma| supprime cette espace (mais uniquement en
français), on revient au comportement standard avec |\StandardMathComma|.
On peut l’utiliser dans un groupe pour limiter sa portée, sinon
après une commande |\DecimalMathComma|, il est nécessaire de saisir une
espace (fine) dans les listes et les intervalles par exemple |$(x,\,y)$| et
|$[0,\,1]$|.\hlabel{decimalmathcomma}
|\DecimalMathComma| peut être placée soit dans le préambule, soit dans le
corps du document \emph{en mode texte} et dans une partie \emph{en français},
son effet survit à un changement de langue (passage en anglais et retour en
français par exemple), sauf bien sûr si elle est placée dans un groupe.
Une solution alternative consiste à utiliser l’extension \ext{icomma}.
\vspace{\parskip}
\item La commande |\nombre|, destinée à formater
automatiquement les nombres entiers ou décimaux par tranches de
trois chiffres séparées par des espaces en français et par des
virgules (usage anglo-saxon), fait désormais appel à la commande
|\numprint| de l’extension du même nom.
Lors du premier appel à la commande |\nombre|,
un message est affiché dans le fichier \file{.log} indiquant comment
charger \ext{numprint}. Le chargement de \ext{numprint} n’est pas fait
par \ext{babel-french} à cause du risque de conflit d’options.
Il doit se faire \emph{après} \ext{babel}.
Les utilisateurs devraient s’habituer progressivement à utiliser
|\numprint| (ou son raccourci |\np|) à la place de |\nombre|.
\end{itemize}
\vspace{\parskip}
En ajoutant |\usepackage{xspace}| dans le préambule, les espaces suivant
les commandes
|\ier|,…, |\ieres|,
|\ieme|, |\iemes|,
|\fg| et |\dots| sont respectés sans avoir à les forcer par des |{}| ou
des~\code{\boi\textvisiblespace}. Le recours à l’extension \pkg{xspace} est
cependant une \emph{fausse simplification} car \emph{certaines} commandes sont
affectées mais \emph{pas toutes}. Un exemple extrême est fourni par la
commande |\dots| : lorsqu’elle est redéfinie par \pkg{babel-french} (moteurs
8-bits et en français seulement) on peut omettre la paire d’accolades, mais
celle-ci est indispensable dans une partie en anglais par exemple ou avec les
moteurs Unicode (|\dots| garde sa définition standard)… Il me paraît plus simple
d’éviter le recours à \pkg{xspace} et de gérer les espaces soi-même :
« |les 1\ier, 2 et 3~mai| » ou « |le 1\ier~mai| » (espace insécable).
\section{Personnalisation}
\label{sec:Perso}
La commande \fbsetup{}, appelée précédemment |\frenchbsetup{}|%
\footnote{Ce dernier nom sera gardé comme alias par souci de compatibilité,
le nouveau devrait être préféré depuis l’abandon du nom \ext{frenchb}
au profit de \ext{babel-french} pour désigner l’option \opt{french}
de babel.},
est à placer dans le préambule de chaque document après
le chargement de Babel ; elle permet de personnaliser le comportement de
\ext{babel-french} grâce au large choix parmi des options disponibles.
La syntaxe est celle de l’extension \ext{keyval}, largement
utilisée par d’autres extensions comme \ext{geometry} ou \ext{hyperref}.
Le recours à un fichier de configuration \file{frenchb.cfg} a été supprimé en
version~3.0.
\subsection[\textbackslash frenchsetup{}]{\fbsetup{\meta{options}}}
\label{ssec:frenchbsetup}
La commande \fbsetup{ShowOptions} affiche dans le fichier \file{.log} la liste
des options disponibles, nous allons parcourir cette liste et expliquer
l’effet de chacune d’elles.
Dans le cas d’une option booléenne, la mention \fbo{=true} peut être omise :
\fbsetup{ShowOptions} est équivalent à \fbsetup{ShowOptions=true}.
Dans la liste ci-dessous, l’option activée par défaut est indiquée entre
parenthèses, éventuellement suivie d’un étoile. L’étoile indique que la valeur
par défaut correspond au cas où le français \emph{est la langue principale}
(voir section~\ref{sec:description}, page~\pageref{sec:description}), et que
cette valeur est inversée sinon.
La liste étant longue, les options sont regroupées par thèmes.
\bgroup
\let\MyColor\ColorArg
\subsubsection*{Inventaire des options}
\begin{description}
\setlength{\labelsep}{0.1666em}
\item [ShowOptions=true (false)]
affiche dans le fichier \file{.log} toutes les options
disponibles, ce qui permet de retrouver leurs noms facilement.
\end{description}
\subsubsection*{Maquette générale}
\begin{description}
\item [StandardLayout=true (false*)] supprime toute action de
\ext{babel-french} sur la maquette dans le cas où le français est la
langue principale : retour aux listes standard, pas de
retrait des 1\iers{} paragraphes des sections, notes de bas de page
standard, séparateur «\string:» dans les légendes de figures et tableaux.
Lorsque le français n’est pas la langue principale, elle est sans effet.
\item [GlobalLayoutFrench=false (true*)] ne devrait plus être utilisée sauf,
lorsque le français est la langue principale, pour retrouver le comportement
des versions de \ext{babel-french} antérieures à~v2.2 : dans les parties
rédigées dans des langues autres que le français, la présentation des listes
redevient standard et la mise en retrait des 1\iers{} paragraphes des
sections est supprimée. La présentation des notes de bas de page est
toujours indépendante de la langue de travail (à la française ou standard
pour tout le document selon la langue principale).
\item [IndentFirst=false (true*)] ; par défaut, \ext{babel-french} applique un
retrait identique pour tous les paragraphes (de largeur |\parindent|),
y compris le premier de chaque section, ce qui est conforme à l’usage
français. Avec \fbo{IndentFirst=false} le retrait du premier paragraphe de
chaque section est supprimé, comme c’est l’usage en anglais, soit dans tout
le document si le français est la langue principale, soit seulement en
français.
\item [PartNameFull=false (true)] ; par défaut \ext{babel-french} numérote les
parties créées par la commande |\part| en « Première partie », « Deuxième
partie », etc. Ceci fonctionne bien pour la plupart des classes (classes
standard, classes koma-script, memoir) mais pas pour les classes AMS qui
redéfinissent la commande |\part|. L’option \fbo{PartNameFull=false} permet
de revenir à une numérotation des parties plus standard -- « Partie~I »,
« Partie~II », etc. --, ce qui supprime les risques de mauvais affichage du
genre « Première partie~1 » notamment dans la table des matières.
\end{description}
\subsubsection*{Présentation des listes}
\begin{description}
\item [ListItemsAsPar=true (false)] ; mettre cette option à \fbo{true}
est recommandé à ceux qui souhaitent une présentation des listes
conforme aux usages en vigueur à l’Imprimerie nationale, voir
p.~\pageref{ListAsPar} pour une comparaison avec la disposition par défaut.
\item [StandardListSpacing=true (false*)] ; par défaut \ext{babel-french}
modifie (en général en les réduisant, sauf pour les classes SMF)
les espaces verticaux%
\footnote{Il s’agit de \cs{itemsep}, \cs{parsep}, \cs{topsep}
et \cs{partopsep}.} \label{listspacing}
dans \emph{toutes les listes} produites à partir de l’environnement
\env{list}, en particulier les listes \env{enumerate}, \env{itemize} et
\env{description} mais aussi \env{abstract}, \env{quote}, \env{quotation},
\env{verse}… \fbo{StandardListSpacing=true} permet de revenir
aux réglages standard (ceux de la classe utilisée), elle remplace l’ancienne
option \fbo{ReduceListSpacing} en l’inversant :
\fbo{StandardListSpacing=true} équivaut à \fbo{ReduceListSpacing=false} qui
pouvait être trompeuse dans le cas des classes SMF mais qui fonctionne
toujours pour ne pas compromettre la compilation d’anciens documents.
\item [StandardItemizeEnv=true (false*)] ; par défaut l’environnement
\env{itemize} est redéfini pour qu’aucun espace vertical ne soit ajouté
à l’interligne standard entre les éléments d’une liste \env{itemize} et
pour adapter |\labelwidth| au marqueur utilisé.
L’option |StandardItemizeEnv=true| empêche cette redéfinition, ce qui est
nécessaire en cas de conflit avec une classe ou une extension qui redéfinit
aussi l’environnement \env{itemize} (\ext{enumitem} ou \ext{paralist}
par exemple%
\footnote{\ext{babel-french} met automatiquement le drapeau
\fbo{StandardItemizeEnv} à \fbo{true} lorsque l’une des extensions
\ext{enumitem} ou \ext{paralist} est chargée.}).
L’interligne entre les éléments des listes \env{itemize} est alors
légèrement augmenté si \fbo{StandardListSpacing=false} ou l’est
nettement plus (on revient au réglage de base de la classe utilisée) si
\fbo{StandardListSpacing=true}.
Les utilisateurs d’\ext{enumitem} qui souhaitent obtenir pour leurs listes
une présentation à la française, trouveront comment faire
page~\pageref{enumitem-cfg}.\hlabel{ch-enumitem}
\item [StandardEnumerateEnv=true (false*)] ; depuis la version~2.6,
\ext{babel-french} redéfinit également les environnements \env{enumerate} et
\env{description} pour que leurs marges soient les mêmes que celles des
listes \env{itemize}.
\fbo{StandardEnumerateEnv=true} empêche cette redéfinition, ce qui est
nécessaire en cas de conflit avec une classe ou une extension qui redéfinit
aussi l’environnement \env{enumerate} (\ext{enumerate}, \ext{enumitem} ou
\ext{paralist} par exemple%
\footnote{\ext{babel-french} met automatiquement le drapeau
\fbo{StandardEnumerateEnv} à \fbo{true} lorsque l’une des extensions
\ext{enumerate}, \ext{enumitem} ou \ext{paralist} est chargée.}).
\item [StandardItemLabels=true (false*)] restitue aux
marqueurs des listes \env{itemize} les valeurs standard attribuées par
la classe de document ou les extensions utilisées.
{\sloppy
\item [ItemLabels=\boi{}textbullet, \boi{}textendash,
\boi{}ding{43},... (\boi{}textemdash*)] ;
option qui permet de choisir le marqueur
utilisé dans les listes \env{itemize} en français (\emph{sauf} bien sûr
si \fbo{StandardItemLabels=true}).
Noter que |\ding{43}| suppose que l’extension \ext{pifont} soit
chargée. Cette option affecte tous les niveaux de la liste.
Les quatre options suivantes fonctionnent de même mais n’affectent elles
qu’un niveau chacune :
\par}
\item [ItemLabeli=\boi{}textbullet, \boi{}textendash,
\boi{}ding\{43\},... (\boi{}textemdash*)]
\item [ItemLabelii=\boi{}textbullet, \boi{}textendash,
\boi{}ding\{43\},... (\boi{}textemdash*)]
\item [ItemLabeliii=\boi{}textbullet, \boi{}textendash,
\boi{}ding\{43\},... (\boi{}textemdash*)]
\item [ItemLabeliv=\boi{}textbullet, \boi{}textendash,
\boi{}ding\{43\},... (\boi{}textemdash*)]
{\sloppy
\item [StandardLists=true (false*)] ; supprime toute action de
\ext{babel-french} sur les listes, elle équivaut aux quatre options
\fbo{StandardItemLabels=true}, \fbo{StandardItemizeEnv=true},
\fbo{StandardEnumerateEnv=true} et \fbo{StandardListSpacing=true}.
Lors de l’utilisation d’une classe ou d’une extension qui modifie la
présentation des listes, il peut y avoir conflit avec \ext{babel-french} ;
dans ce cas l’option \fbo{StandardLists} (ou éventuellement l’une ou l’autre
des quatre sous-options plus ciblées qu’elle regroupe) devrait régler le
problème%
\footnote{L’option \fbo{StandardLists} est automatiquement activée avec la
classe \cls{beamer}.}.
\par}
\item [ListOldLayout=true (false*)] ne devrait être utilisée que pour
recomposer d’anciens documents à l’identique, c’est-à-dire pour retrouver
la présentation des listes qui prévalait avant la version~2.6a.
\end{description}
\subsubsection*{Présentation des notes de bas de page}
\begin{description}
\item [FrenchFootnotes=false (true*)] fait revenir à la
présentation standard des notes de page, telle que définie par la classe ou
les extensions utilisées. Cette option affecte la totalité du document.
La commande |\StandardFootnotes| peut encore être utilisée
\emph{localement}, par exemple dans les environnements \env{minipage} si la
présentation «à la française» ne convient pas (notes numérotées `a’, `b’,
etc.).
\item [AutoSpaceFootnotes=false (true*)] supprime l’espace fine
insécable ajoutée par défaut avant l’appel de chaque note dans le texte
courant. Cette option affecte la totalité du document.
L’espace éventuellement ajoutée peut être ajustée, la commande par défaut
est : |\newcommand*{\FBfnmarkspace}{\kern .5\fontdimen2\font}|
\end{description}
\subsubsection*{Ponctuation haute}
\begin{description}
\item [AutoSpacePunctuation=false (true)] ; par défaut, \ext{babel-french}
corrige la faute de saisie qui consiste à omettre l’espace devant la
ponctuation haute (\string: \string; \string? \string!) en ajoutant
automatiquement une espace insécable de taille adaptée.
Toutefois, l’ajout d’espace n’a pas lieu lorsque la police courante est
à espacement fixe%
\footnote{Ceci évite en particulier les problèmes en verbatim.} :
|\texttt{http://truc}| produit \texttt{http://truc}.
Le moteur LuaTeX permet un contrôle fin de l’ajout d’espace devant le
deux-points : si ce caractère n’est pas précédé d’un espace et que celui qui
le suit est de type \textit{glyphe} (lettre, chiffre, /, \textbackslash,
etc.) aucune espace n’est ajoutée en sortie, ce qui évite les espaces
parasites dans les URLs (ftp://monsite), les chemins MSDOS
(C:\textbackslash), les horaires (10:55) et les ratios (1:1).
Avec XeTeX ou pdfTeX |http://truc| et |1:1| donnent http~://truc et 1~:1
(espace parasite avant le «:»).
Il y a une autre exception avec les moteurs LuaTeX et XeTeX :
si l’utilisateur code une espace insécable U+00A0 (\emph{pas}
\raisebox{-1ex}{\huge\code{\tild}}) ou une fine insécable
U+202F, ces caractères sont recopiés tels quels en sortie,
sans ajout d’espace par \ext{babel-french}.
Ceux qui sont sûrs de leur saisie peuvent mettre cette option à
\fbo{false} pour contrôler complètement l’ajout d’espace devant la
ponctuation haute : l’espace adéquate (toujours insécable) est ajoutée
si et seulement si un espace précède le signe de ponctuation dans le
fichier source. Ils éviteront ainsi, quel que soit le moteur utilisé,
de voir des espaces ajoutées à tort.
Autre solution pour les autres : laisser le mode par défaut et éviter,
le cas échéant, l’insertion d’espaces parasites en utilisant la commande
|\NoAutoSpacing| dans un groupe, par exemple |{\NoAutoSpacing 10:55}|
(XeTeX et pdfTeX, inutile avec LuaTeX).
\item [ThinColonSpace=true (false)] ; par défaut l’espace placée
avant le `\string:’ est une espace-mot insécable, cette option la remplace
par une espace fine insécable. Certains auteurs font ce choix pour que les
espaces précédant les quatre signes de ponctuation haute soient identiques.
Le choix par défaut correspond à la maquette de l’Imprimerie nationale,
le Guide du typographe (ex-roman) préconise lui l’espace fine devant le
`\string:’.
Il est possible de redéfinir complètement la taille des espaces précédant
la ponctuation haute (ou les guillemets français) en utilisant dans le
préambule la commande |\FBsetspaces| qui admet un argument optionnel
(pour le dialecte \lang{french} ou \lang{acadian}, son absence équivaut
à \lang{french}) et quatre arguments obligatoires : le premier précise le
type d’espace à redéfinir, il doit être |colon| (pour le~`:’), |thin|
(pour~`;’ `!’ et `?’) ou |guill| pour les guillemets chevrons),
les trois suivants sont des nombres décimaux qui définissent la largeur
(\textit{width}), l’extensibilité (\textit{stretch}) et la compressibilité
(\textit{shrink}) de l’espace exprimées en \textit{fontdimen}.
\hlabel{FBsetspaces}
Le dialecte \lang{acadian} utilise les valeurs définies pour \lang{french}
sauf présence dans le préambule de commandes spécifiques
|\FBsetspaces[acadian]|.
Exemples : les valeurs |{1}{1}{1}| correspondent à l’espace-mot justifiante
(utilisée par défaut devant le deux-points), |{0.5}{0}{0}|
à l’espace fine (utilisée par défaut devant `;’ `!’ et `?’, noter son
absence d’élasticité) et |{0.8}{0.3}{0.8}| à l’espace utilisée par défaut
à l’intérieur des guillemets.
|\FBsetspaces{colon}{0.5}{0}{0}| est équivalent
à l’option~\fbo{ThinColonSpace} (vaut pour le français et le canadien).
|\FBsetspaces[acadian]{colon}{0.5}{0}{0}| redéfinit l’espace précédant
le~`:’ en espace fine seulement pour le canadien.
|\FBsetspaces{colon}{1}{0}{0}| met une espace-mot sans élasticité devant
les~`:’.
\item [OriginalTypewriter=true (false)] ; par défaut, lorsqu’une police
à espacement fixe est utilisée (|\texttt{}|, mode verbatim, listings, etc.)
\ext{babel-french}, n’ajoute jamais d’espace avant la ponctuation haute ni
après `«’, ni avant `»’ même si ces caractères ont été activés par l’option
\fbo{og=«, fg=»}. De plus, les espaces présents dans texte source ne sont
pas modifiés, par exemple |\texttt{X != Y}| produit \texttt{X != Y} (pas
d’espace fine avant le~`!’).
Mettre cette option à \fbo{true} supprime ce comportement, ce qui peut être
utile pour recompiler à l’identique des anciens textes.
\item [UnicodeNoBreakSpaces=true (false)];\hlabel{ucs-nbsp} cette option
n’a d’effet qu’avec LuaLaTeX ; lorsqu’on la met à \fbo{true}
les espaces insécables ajoutées par \ext{babel-french} dans le fichier PDF
de sortie (ponctuation haute, guillemets, etc.) sont codées sous forme de
caractères Unicode (U+A0 ou U+202F fine) au lieu des pénalités et ressorts
de type \textit{glues}. Ceci devrait préserver ces espaces lors de la
conversion en HTML des fichiers produits par LuaLaTeX, malheureusement la
version actuelle de \exe{pdftotext} ne les restitue pas correctement.
En revanche, \exe{lwarp} (v.~0.37 et suivantes) est totalement compatible
avec \ext{babel-french} pour la conversion en HTML des fichiers PDF produits
sous XeLaTeX et pdfLaTeX : les espaces insécables sont préservées.
\end{description}
\subsubsection*{Guillemets}
\begin{description}
\item [og=«, fg=»]%
\footnote{Les valeurs affectées à \fbo{og} et \fbo{fg} sont les vrais
guillemets \fbo{«} et \fbo{»}, pas \fbo{<{}<} et \fbo{>{}>}.
Les espaces avant et après ces guillemets dans la commande
\fbsetup{} sont optionnels.} ;
\hlabel{og-fg} lorsqu’on dispose de guillemets français au
clavier (grâce à une touche \textit{compose} par exemple), cette option permet
d’utiliser directement ces guillemets à la place des commandes |\frquote{}|
ou |\og| et |\fg|.
On peut ainsi saisir \code{«guillemets»} (sans espace) ou
\code{« guillemets »} (avec espaces à l’intérieur) pour obtenir «guillemets»
avec les espaces insécables adéquates en français. En revanche, si on active
cette option,
\emph{il ne faut pas coder explicitement les espaces insécables}%
\footnote{Sauf avec le moteur LuaTeX qui permet de parer à cette
éventualité !}:
\code{«}|~|\code{guillemets}|~|\code{»} produirait avec pdfLaTeX ou XeLaTeX
une espace trop large après le guillemet ouvrant.
Les espaces insécables ne sont ajoutées que lorsque la langue
courante est le français : en allemand, le codage \code{(»Auf Deutsch«)}
produit \foreignlanguage{german}{(»Auf Deutsch«)}. %»
Ceci fonctionne en (pdf)LaTeX pour les codages d’entrée 8-bits (latin1,
latin9, ansinew, applemac,…) et pour les codages sur plusieurs octets
comme utf8 ou utf8x. Ceci fonctionne également avec LuaLaTeX et XeLaTeX ;
avec ces deux derniers toutefois, comme pour la ponctuation haute,
\ext{babel-french} respecte les espaces insécables U+00A0 et U+202F (fine).
\item [INGuillSpace=true (false)] ; force \ext{babel-french} à mettre une
espace-mot justifiante insécable après les guillemets ouvrants et avant les
guillemets fermants comme le préconise l’Imprimerie nationale. Par défaut
les espaces insérées par \ext{babel-french} sont légèrement plus étroites et
moins extensibles qu’une espace-mot.\hlabel{INGuillspace}
Cette option est équivalente à |\FBsetspaces{guill}{1}{1}{1}|, voir
p.~\pageref{FBsetspaces}.
\item [EveryParGuill=open, close, none (open)] ;
selon sa valeur, cette option
ajoute un guillemet ouvrant
\bgroup\NoAutoSpacing
(«\FBguillspace), fermant (»\FBguillspace)%
\egroup{}
ou rien au début de chaque paragraphe inclus dans une citation de premier
rang codée avec |\frquote{}|.\hlabel{everyparguill}
Lorsque \fbo{InnerGuillSingle=true}, cette option est également prise en
compte pour les citations de second rang (internes) : selon sa valeur, un
guillemet simple ouvrant
\bgroup\NoAutoSpacing
(\guilsinglleft\FBguillspace), ou fermant (\guilsinglright\FBguillspace)%
\egroup,
ou rien, est ajouté à chaque début de paragraphe.
Lorsque \fbo{InnerGuillSingle=false}, rien n’est ajouté en début de
paragraphe dans les citations de second rang.
\item [EveryLineGuill=open, close, none (none)] ;
selon sa valeur, cette option
ajoute un guillemet ouvrant, fermant, ou rien, au début de chaque ligne
d’une citation de second rang. Notez que les citations de premier et de
secong rang doivent être toutes deux codées avec |\frquote{}| et que l’ajout
automatique de guillemets au début de ligne \emph{ne fonctionne qu’avec
LuaTeX}.
Lorsque \fbo{EveryLineGuill=open} ou \fbo{close} la citation interne
est toujours balisée par des guillemets français « et », l’option suivante
est sans effet.
\item [InnerGuillSingle=true (false)] ; si \fbo{InnerGuillSingle=true}
les citations internes sont balisées comme
\guilsinglleft\FBguillspace ceci\FBguillspace\guilsinglright,
sinon comme ``cela’’.
\end{description}
\subsubsection*{Présentation des nombres}
\begin{description}
{\sloppy
\item [ThinSpaceInFrenchNumbers=true (false)] remplace le
séparateur des milliers utilisé en français par la commande
|\numprint{}| (ou son alias |\nombre{}|) pour le formatage
des nombres, par une espace fine (par défaut c’est une espace mot
insécable et sans élasticité en français).
Cette option n’a d’effet que si l’extension \ext{numprint} est chargée
(\emph{après} \ext{babel}) avec l’option \opt{autolanguage} ;
sans elle, \ext{numprint} formate les nombres indépendamment de la langue
courante et le séparateur des milliers est par défaut l’espace fine.
\par}
\end{description}
\subsubsection*{Légendes de figures et tables}
\begin{description}
\item [SmallCapsFigTabCaptions=false (true*)]; si cette option est mise
à \fbo{false}, le recours aux petites capitales dans les intitulés des
légendes de figures et tables est supprimé, on obtient « Figure » et
« Table » au lieu de « \textsc{Figure} » et « \textsc{Table} ».
Noter que le même résultat peut être obtenu en définissant |\FBfigtabshape|
comme |\relax| avant le chargement de \ext{babel}.\hlabel{scfigtab}
\item [CustomiseFigTabCaptions=false (true*)] ; si cette option est mise
à \fbo{false}, le séparateur défini par |\CaptionSeparator| est remplacé par
le séparateur par défaut (deux-points) dans les légendes des figures et des
tables, ceci pour toutes les langues. En français, \ext{babel-french} ajoute
si possible une espace insécable adéquate devant le deux-points ou affiche
un message dans le fichier \file{.log}.
\item [OldFigTabCaptions=true (false)] peut être utilisée pour retrouver
la présentation antérieure (pré~3.0) des légendes de figures et tables,
c.-à-d. |\CaptionSeparator| en français et deux-points pour les autres
langues. Cette option ne fonctionne que pour les classes standard
\cls{article}, \cls{report}, \cls{book} et rend inopérante l’option
\fbo{CustomiseFigTabCaptions}.
\end{description}
\subsubsection*{Divers : lettres supérieures et « warnings »}
\begin{description}
\item [FrenchSuperscripts=false (true)] ne devrait être utilisée que pour
recompiler des anciens fichiers à l’identique. Elle redéfinit |\up| comme
|\textsuperscript| alors que par défaut |\up| fait appel à la
commande |\fup| plus conforme aux usages francophones (voir
section~\ref{sec:description}, p.~\pageref{sec:description}.
\item [LowercaseSuperscripts=false (true)] rend possible d’avoir des lettres
supérieures en capitales (est-ce bien utile ?). Par défaut, la commande
|\up| (sauf si elle est redéfinie en |\textsuperscript| par l’option
précédente) empêche le passage en capitales des lettres supérieures dans
les hauts de pages par exemple.
\item [SuppressWarning=true (false)] peut être utilisée pour supprimer les
avertissements non essentiels émis par \ext{babel-french}.
\end{description}
\egroup
\subsubsection*{Ordre des options}
Il faut se souvenir que les options sont prises en compte dans l’ordre où
elles sont écrites dans la commande \fbsetup{}.
Exemple : un utilisateur souhaitant que \ext{babel-french} ne touche pas à la
présentation des listes ni à celle des notes de bas de page
mais ajoute un renfoncement au début des 1\iers{} paragraphes de section
peut faire \fbsetup{StandardLayout,IndentFirst}.
S’il choisissait l’ordre inverse
l’option \fbo{IndentFirst} serait annulée par \fbo{StandardLayout}.
Cet utilisateur obtiendrait également le résultat souhaité en codant\\
\fbsetup{StandardLists,FrenchFootnotes=false,AutoSpaceFootnotes=false}\\
là, l’ordre est indifférent car les options sont indépendantes.
\subsection[Traduction des intitulés]
{Traduction des intitulés (« caption names » en anglais)}
\label{ssec:captions}
Voici la liste des traductions proposées par \ext{babel-french} :
{\setcounter{LTchunksize}{30} % Pour réduire le nombre de compilations.
\setlength{\LTleft}{0pt} % Avec \extracolsep{\fill}, assure que le
\setlength{\LTright}{0pt} % tableau prend toute la largeur de page.
\setlength{\LTpost}{\smallskipamount}
\newcommand*\name[1]{%
\texttt{\ColorVerb\textbackslash#1name}%
&\texttt{\ColorVerb\textbackslash french#1name}}
\begin{longtable}{|l!{\extracolsep{\fill}}l!{\extracolsep{\fill}}l|}
\hline
Commande Babel & Commande pour le français & Intitulé par défaut en français\\*
\hline
\name{abstract} & Résumé\\*
\name{bib} & Bibliographie\\
\name{ref} & Références\\
\name{preface} & Préface\\
\name{chapter} & Chapitre\\
\name{appendix} & Annexe\\
\name{contents} & Table des matières\\
\name{listfigure} & Table des figures\\
\name{listtable} & Liste des tableaux\\
\name{index} & Index\\
\name{glossary} & Glossaire\\
\name{figure} & {\scshape Figure}\\
\name{table} & {\scshape Table}\\
\name{part} & Première partie, Deuxième partie…\\
\name{encl} & P.~J.\\
\name{cc} & Copie à \\
\name{headto} & \meta{vide}\\
\name{page} & page\\
\name{see} & voir\\
\name{also} & voir aussi\\*
\name{proof} & Démonstration\\*
\hline
\end{longtable}
}
Il est facile de modifier ces traductions : pour remplacer « Démonstration »
par « Preuve » (avec \ext{amsthm}) ajouter dans le préambule
|\def\frenchproofname{Preuve}|%
\footnote{Les puristes peuvent remplacer \cs{def} par \cs{renewcommand*}
s’ils le souhaitent.},
noter que l’ancienne syntaxe |\addto\captionsfrench{\def\proofname{Preuve}}|
fonctionne toujours.\hlabel{captionsfrench}
{\sloppy
\emph{Attention}, dans les deux cas, le nom de la langue est
\emph{obligatoirement} \opt{french}, les variantes \opt{frenchb} ou
\opt{francais} seraient sans effet ! Les commandes
|\acadianabstractname|, …, |\acadianproofname| sont, elles, définies
(comme leurs homologues françaises) et personnalisables pour le français du
Canada (option \lang{acadian}).
\par}
La modification des noms de parties est plus complexe : si on préfère
« Partie~I », « Partie~II » à « Première partie », « Deuxième partie »,
il suffit de redéfinir |\frenchpartname| comme ceci
|\def\frenchpartname{Partie}|\samefntmk{} ;
utiliser l’option \fbo{FullPartName=false} dans \fbsetup{} aboutit au même
résultat.
Si en revanche on veut que |\part{}| produise par exemple « Première phase »,
« Deuxième phase », il faut redéfinir |\frenchpartnameord| et non
|\frenchpartname| : |\def\frenchpartnameord{phase}|\samefntmk.
Le remplacement de « Deuxième » par « Seconde » est possible en codant
|\def\frenchpartsecond{Seconde}|\samefntmk{} dans le préambule.
De même il est possible de remplacer « Première » par « Premier » en codant
|\def\frenchpartfirst{Premier}|\samefntmk.
On remarquera que |\figurename| et |\tablename| sont en petites capitales en
français. Il serait préférable, notamment dans un document multilingue, de
s’en tenir à la traduction pure
(|\def\frenchfigurename{Figure}|\samefntmk,
|\def\frenchtablename{Table}|\samefntmk)
et de choisir les attributs de la police
(|\scshape| par exemple) au niveau de la classe ou d’une extension comme
\ext{captions}. L’option \fbo{SmallCapsFigTabCaptions} (p.~\pageref{scfigtab})
peut être mise à \fbo{false} pour supprimer le passage en petites capitales.
\subsection{Présentation des listes}
\label{ssec:lists}
Voici la présentation par défaut%
\footnote{L’option \fbo{ListItemsAsPar} permet une autre présentation, voir
ci-dessous p.~\pageref{ListAsPar}.}
pour les listes \env{itemize} (tiret cadratin et alignement des tirets de
premier niveau sur le retrait (|\parindent|) de début de paragraphe) :\par
{\centering
\fbox{\begin{minipage}[t]{.40\textwidth}\raggedright
\FBListItemsAsParfalse \parindent=1.5em \listindentFB=1.5em
\noindent\LEFTmargin{} Marge gauche\par
Paragraphe précédant la liste
\begin{itemize}
\item Premier élément sur plus d’une ligne…
\begin{itemize}
\item Un élément niveau 2,
\item Second élément niveau 2,
\end{itemize}
\item Second élément…
\end{itemize}
\end{minipage}}\par
}
Ceux qui préfèrent le tiret demi-cadratin (\textendash) comme marqueur peuvent
ajouter l’option \fbsetup{ItemLabels=\boi{}textendash}, d’autres options
existent voir section~\ref{ssec:frenchbsetup}.
\ext{babel-french} applique aux listes \env{enumerate} et \env{description}
les mêmes retraits horizontaux qu’aux listes \env{itemize}, tous sont donc
basés sur la largeur du marqueur choisi, |\textemdash| par défaut,
|\textendash|, ou autre.
{\sloppy
Trois paramètres dimensionnels permettent d’ajuster la présentation des
listes \env{itemize}, \env{enumerate} et \env{description} :
\begin{description}
\item [\cs{listindentFB}] dont la valeur par défaut est
|\parindent| si |\parindent| est non nul et |1.5em| (valeur standard de
|\parindent|) sinon ; |\listindentFB| permet modifier la marge gauche du
premier niveau de liste (ce qui déplace aussi les listes incluses).
Exemple : en ajoutant |\setlength{\listindentFB}{0pt}| dans le préambule,
les étiquettes de toutes les listes de premier niveau colleront à la marge
gauche au lieu d’être décalées vers la droite.
% Illustration de \parindent et \listindentFB
\vspace{\parskip}
\begin{minipage}[t]{.45\textwidth}
\fbox{\begin{minipage}[t]{0.9\textwidth}\raggedright
\FBListItemsAsParfalse \parindent=0pt \listindentFB=1.5em
\noindent\LEFTmargin{} Marge gauche\par
Paragraphe précédant la liste
\begin{itemize}
\item Premier élément sur plus d’une ligne…
\begin{itemize}
\item Un élément niveau 2,
\item Second élément niveau 2,
\end{itemize}
\item Second élément…
\end{itemize}
\end{minipage}
}\\
\hspace*{\fill}|\parindent=0pt|\hspace*{\fill}%
\end{minipage}
\hspace{\fill}
\begin{minipage}[t]{.5\textwidth}
\hspace*{\fill}
\fbox{\begin{minipage}[t]{.9\textwidth}\raggedright % .72
\FBListItemsAsParfalse \parindent=0em \listindentFB=0em
\noindent\LEFTmargin{} Marge gauche\par
Paragraphe précédant la liste
\begin{itemize}
\item Premier élément sur plus d’une ligne…
\begin{itemize}
\item Un élément niveau 2,
\item Second élément niveau 2,
\end{itemize}
\item Second élément…
\end{itemize}
\end{minipage}
}\hspace*{\fill}\\
\hspace*{\fill}|\parindent=0pt| \emph{et} |\listindentFB=0pt|\hspace*{\fill}%
\end{minipage}
\vspace{\baselineskip}
\item [\cs{labelwidthFB}] dont la valeur par défaut est la largeur de
|\FrenchLabelItem| (c.-à.d. |\textemdash| sauf changement décidé par
l’utilisateur) ; il est possible de fixer la valeur de |\labelwidthFB|
niveau par niveau, voir le second exemple ci-dessous.
% Illustration de \labelwidthFB
\bgroup
\renewcommand*{\thempfootnote}{\arabic{mpfootnote}}
\parindentFFN=4pt\relax
\begin{minipage}[t]{.45\textwidth}
\fbox{\begin{minipage}[t]{.9\textwidth}\raggedright
\FBListItemsAsParfalse \parindent=1.5em \listindentFB=1.5em
\noindent\LEFTmargin{} Marge gauche\par
Paragraphe précédant la liste
\begin{enumerate}
\item Premier élément sur plus d’une ligne…
\begin{enumerate}
\item Un élément niveau 2,
\item Second élément niveau 2,
\end{enumerate}
\item Second élément…
\end{enumerate}
\end{minipage}
}\\
\hspace*{\fill}Présentation par défaut%
\footnote{Remarquer l’alignement vertical avec l’exemple ci-dessus.}
\hspace*{\fill}
\end{minipage}
\hspace{\fill}
\begin{minipage}[t]{.5\textwidth} % .45
\stepcounter{mpfootnote}
\hspace*{\fill}
\fbox{\begin{minipage}[t]{0.9\textwidth}\raggedright
\FBListItemsAsParfalse \parindent=1.5em \listindentFB=1.5em
\noindent\LEFTmargin{} Marge gauche\par
Paragraphe précédant la liste
\begin{enumerate}
\item Premier élément sur plus d’une ligne…
\settowidth{\labelwidthFB}{(a)}%
\begin{enumerate}
\item Un élément niveau 2,
\item Second élément niveau 2,
\end{enumerate}
\item Second élément…
\end{enumerate}
\end{minipage}
}\hspace*{\fill}\\
\hspace*{\fill}|\settowidth{\labelwidthFB}{(a)}|%
\footnote{Commande à placer juste avant le second environnement
\env{enumerate}.}%
\hspace*{\fill}
\end{minipage}
\egroup
\vspace{\baselineskip}
\item [\cs{descindentFB}] dont la valeur par défaut est |\listindentFB| permet
de traiter les listes de type \env{description} différemment des autres :
pour que les étiquettes des seules listes \env{description} collent à la
marge gauche, il suffit d’ajouter dans le préambule
|\setlength{\descindentFB}{0pt}|.
% Illustration de \parindent et \descindentFB
\vspace{\parskip}
\begin{minipage}[t]{.45\textwidth}
\fbox{\begin{minipage}[t]{0.9\textwidth}\raggedright
\FBListItemsAsParfalse
\parindent=0pt \listindentFB=1.5em \descindentFB=1.5em
\noindent\LEFTmargin{} Marge gauche\par
Paragraphe précédant la liste
\begin{description}
\item [Premier] élément occupant plus d’une ligne…
\begin{itemize}
\item Un élément niveau 2,
\item Second élément niveau 2,
\end{itemize}
\item [Second] élément…
\end{description}
\end{minipage}
}\\
\hspace*{\fill}|\parindent=0pt|\hspace*{\fill}%
\end{minipage}
\hspace{\fill}
\begin{minipage}[t]{.5\textwidth}
\hspace*{\fill}
\fbox{\begin{minipage}[t]{.9\textwidth}\raggedright % .72
\FBListItemsAsParfalse
\parindent=0pt \listindentFB=1.5em \descindentFB=0pt
\noindent\LEFTmargin{} Marge gauche\par
Paragraphe précédant la liste
\begin{description}
\item [Premier] élément occupant plus d’une ligne…
\begin{itemize}
\item Un élément niveau 2,
\item Second élément niveau 2,
\end{itemize}
\item [Second] élément…
\end{description}
\end{minipage}
}\hspace*{\fill}\\
\hspace*{\fill}|\parindent=0pt| \emph{et} |\descindentFB=0pt|\hspace*{\fill}%
\end{minipage}
\end{description}
\par}
\vspace{\baselineskip}
L’option \fbo{ListItemsAsPar} propose une présentation plus conforme aux
usages typographiques français, voir par exemple ce qui est fait dans le
« Lexique des règles typographiques en usage à l’Imprimerie nationale ».
\hlabel{ListAsPar}
Les éléments des listes sont alors présentés comme des paragraphes, les
marqueurs (tirets, etc.) étant placées en retrait de la marge gauche ;
dans la présentation par défaut les étiquettes sont placées en saillie dans la
marge gauche et celle-ci est augmentée comme le montre l’exemple ci-dessous.
Noter que toute cette documentation a été compilée avec l’option
\fbo{ListItemsAsPar} dont l’effet est bien visible dans les
sections~\ref{sec:description} (listes \env{itemize}) et
\ref{sec:Perso} (listes \env{description}).
% Illustration de l’option \fbo{ListItemsAsPar}
\vspace{\parskip}
\begin{minipage}[t]{.45\textwidth}
\fbox{\begin{minipage}[t]{0.9\textwidth}\raggedright
\FBListItemsAsParfalse \parindent=1.5em \listindentFB=1.5em
\noindent\LEFTmargin{} Marge gauche\par
Paragraphe précédant la liste et qui s’étend sur deux lignes.
\begin{itemize}
\item Premier élément qui se prolonge sur plusieurs…
\begin{itemize}
\item Un élément niveau 2,
\item Second élément niveau 2 sur plus d’une ligne…
\end{itemize}
\item Second élément…
\end{itemize}
\end{minipage}
}\\
\hspace*{\fill}Présentation par défaut\hspace*{\fill}%
\end{minipage}
\hspace{\fill}
\begin{minipage}[t]{.5\textwidth}
\hspace*{\fill}
\fbox{\begin{minipage}[t]{.9\textwidth}\raggedright % .72
\FBListItemsAsPartrue \parindent=1.5em \listindentFB=1.5em
\noindent\LEFTmargin{} Marge gauche\par
Paragraphe précédant la liste et qui s’étend sur deux lignes.
\begin{itemize}
\item Premier élément qui se prolonge sur plusieurs lignes…
\begin{itemize}
\item Un élément niveau 2,
\item Second élément niveau 2 sur plus d’une ligne…
\end{itemize}
\item Second élément…
\end{itemize}
\end{minipage}
}\hspace*{\fill}\\
\hspace*{\fill}\fbo{ListItemsAsPar=true}\hspace*{\fill}%
\end{minipage}
\vspace{\baselineskip}
Enfin, pour ceux qui voudraient bénéficier des facilités offertes par
l’extension \ext{enumitem} et conserver une présentation des listes
similaire à celle obtenue par défaut avec \ext{babel-french}, je propose
les quelques lignes de code suivantes à copier-coller dans le
préambule :\hlabel{enumitem-cfg}
{%\small
|\usepackage{enumitem}|\\
|\newlength\mylabelwidth|\\
|\newcommand*{\mylabel}{\textemdash} % ou \textendash (tiret plus court)|\\
|\settowidth{\mylabelwidth}{\mylabel}|\\
|\setlist[itemize]{label=\mylabel, nosep}|\\ % nosep ou noitemsep
|\setlist[1]{labelindent=\parindent}|\\
|\setlist{labelwidth=\mylabelwidth, leftmargin=!,|\\
| itemsep=0.4ex plus 0.2ex minus 0.2ex,|\\ % enumitem ne redéfinit pas
| parsep=0.4ex plus 0.2ex minus 0.2ex,|\\ % \list, on peut s’en passer
| topsep=0.8ex plus 0.4ex minus 0.4ex,|\\ % sauf option StandardLists,
| partopsep=0.4ex plus 0.2ex minus 0.2ex}| % évidemment !
}
Pour une présentation correspondant à l’option \fbo{ListItemsAsPar=true} on
aurait :
{%\small
|\usepackage{enumitem}|\\
|\newlength\mylabelwidth|\\
|\newlength\myitemindent|\\
|\newcommand*{\mylabel}{\textemdash} % ou \textendash (tiret plus court)|\\
|\settowidth{\mylabelwidth}{\mylabel}|\\
|\setlength{\myitemindent}{\parindent}|\\
|\addtolength{\myitemindent}{\mylabelwidth}|\\
|\addtolength{\myitemindent}{\labelsep}|\\
|\setlist[itemize]{label=\mylabel, nosep}|\\
|\setlist[1]{leftmargin=0pt}|\\
|\setlist{leftmargin=\parindent, itemindent=\myitemindent,|\\
| itemsep=0.4ex plus 0.2ex minus 0.2ex,|\\ % enumitem ne redéfinit pas
| parsep=0.4ex plus 0.2ex minus 0.2ex,|\\ % \list, on peut s’en passer
| topsep=0.8ex plus 0.4ex minus 0.4ex,|\\ % sauf option StandardLists,
| partopsep=0.4ex plus 0.2ex minus 0.2ex}| % évidemment !
}
%\newpage
\section{Changements entre les versions \latestversion{} et 3.4 (2018)}
\label{sec:changes-3.0}
\subsection{Changements entre les versions \latestversion{} et 3.5s}
\label{ssec:changes-3.6}
La version 3.6a n’a plus recours à l’extension \pkg{keyval} pour gérer les
options, les commandes internes du noyau LaTeX (\pkg{ltkeys})
|\DeclareKeys{}| et |\SetKeys{}| sont utilisées.\\
L’espace fine ajoutée avant l’appel des notes de bas de pages est maintenant
personnalisable (suggestion de Thomas Savary) ; le nom de la commande est
|\FBfnmarkspace{}|, c’est une \emph{vraie} espace fine (demie espace-mot de la
police courante) contrairement à la commande LaTeX |\,| alias |\thinspace|%
\footnote{Elles sont définies pour fonctionner aussi en mode mathématique.}
précédemment utilisée qui chasse toujours 1/6em. Les deux définitions
coïncident pour les polices dont l’espace-mot vaut 1/3em, (cas le plus
courant), l’écart est infime pour celles qui chassent moins : il est par
exemple de $(1/6-1/8)12=0,5$pt en 12pt pour une police dont l’espace-mot
chasse 1/4em. Il est toujours possible de revenir à l’ancien comportement en
codant |\renewcommand\FBfnmarkspace{\,}|.
\subsection{Changements entre les versions 3.5a et 3.4d}
\label{ssec:changes-3.5}
La version 3.5a propose une nouvelle option \fbo{ListItemsAsPar} qui permet
une présentation des listes plus conforme à la tradition typographique
française, voir p.~\pageref{ListAsPar}. La présentation par défaut des listes
est inchangée.
Quelques bogues affectant la commande |\frquote{}| ont été corrigées dans les
versions 3.5b à 3.5d. Cette dernière introduit une nouvelle option
\fbo{StandardListSpacing} à utiliser à la place de \fbo{ReduceListSpacing},
voir p.~\pageref{listspacing}. La présente documentation est maintenant
incluse dans la distribution \ext{babel-french} sur CTAN.
La commande |\NoEveryParQuote| a été ajoutée en version~3.5e, voir
p.~\pageref{frquote}.
La version 3.5g corrige une bogue ancienne affectant l’usage des polices
type~1 avec Lua\-(La)TeX : tout crénage était supprimé pour ces polices depuis
la version~3.1f (2015) ; les polices OpenType elles, n’ont jamais été affectées.
La version 3.5j corrige aussi une bogue ancienne affectant les classes
koma-script, \cls{memoir} et \cls{beamer} : les redéfinitions du séparateur
des légendes de figures et tables (commandes |\captionformat|, |\captiondelim|,
etc.) sont maintenant prises en compte correctement.
À partir de la version 3.5k :
\begin{itemize}
\item La traduction française de |\figurename| et |\tablename| ne
contient plus de commande de changement de fonte comme c’est la règle.
Le passage en petites capitales a été déplacé dans |\fnum@figure| et
|\fnum@table|, ce qui a pour effet de mettre le numéro également en
petites capitales. Noter que la classe \cls{beamer} ne reconnaît pas les
commandes |\fnum@...|, les légendes ne sont donc plus en petites
capitales.
\item Le chargement de \pkg{caption} peut se faire indiféremment avant ou
après celui de \pkg{babel}.
\item La commande |\pdfstringdefDisableCommands| n’est plus utilisée :
toutes les commandes nécessitant un traitement spécial dans les
signets \pkg{hyperref} sont maintenant définies à partir de
|\textorpdfstring{}{}| (suggestion de l’équipe LaTeX3).
\end{itemize}
La commande |\bname{}| (voir section~\pageref{bname}) a été ajoutée en
version~3.5n, la documentation concernant la commande |\bsc{}| a été revue
comme celle concernant la saisie des guillemets.
À partir de la version 3.5o :
\begin{itemize}
\item Le codage (déconseillé) |«~abc~»| ne produit plus d’espace parasite
\emph{avec Lua(La)TeX}, ceci répond à la demande formulée
\href{https://tex.stackexchange.com/questions/661377/}{ici}.
\item Les commandes |\shorthandoff{}| et |\shorthandon{}| affichent maintenant
le message standard de \pkg{babel} lorsqu’elles sont exécutées (à tort) sous
LuaTeX ou XeTeX. Leur redéfinition, qui permettait de conseiller
|\NoAutoSpacing| à la place, a été supprimée à la demande de Javier Bezos,
car elle cassait la variante |\shorthandoff*{}|.
\end{itemize}
\vspace{\parskip}
Le comportement de |\DecimalMathComma| a changé en version~3.5p suite à une
remarque de Fabrice Eudes : elle peut désormais être utilisée dans le préambule.
Voir section~\ref{decimalmathcomma} p.~\pageref{decimalmathcomma} pour plus de
détails.
\vspace{\parskip}
La version 3.5q corrige un bug concernant les listes signalé par Denis
Bitouzé : les alinéas inclus dans une liste n’étaient pas distinguables.
Dorénavant |\listparindent| est défini comme |\parindent| et si|\parskip > 0|,
|\parsep| est défini comme |\parskip|. Il est possible de revenir
à l’ancienne présentation en ajoutant \emph{dans l’environnement de liste}
les commandes |\parskip=0pt| et |\parindent=0pt|.\hlabel{par-in-lists}
\vspace{\parskip}
La version 3.5r est compatible avec \pkg{ucharclasses.sty} qui est maintenant
chargé avec l’extension \pkg{fontsetup} lorsque le moteur XeTeX est utilisé.
D’autre part le fichier \file{frenchb.ins} n’est plus nécessaire pour extraire
les fichiers \file{*.ldf} de \file{frenchb.dtx} (voir~\file{README.md}).
\vspace{\parskip}
La version 3.5s désactive l’option \opt{FrenchFootnotes} lorsque l’extension
\pkg{footnotebackref} est chargée, les deux étant incompatibles ; un message
d’avertissement est affiché dans le fichier \file{.log}.
\subsection{Changements entre les versions 3.4d et 3.3d}
\label{ssec:changes-3.4}
La version 3.4a introduit une nouvelle commande |\frenchdate| (voir
p.~\pageref{frenchdate}) et corrige une bogue mineure : |\FBthousandsep| n’est
plus une espace justifiante insécable mais une espace rigide (de même valeur).
Le retour à l’ancien comportement est obtenu par l’ajout dans le préambule de
|\renewcommand*{\FBthousandsep}{~}|.
Les deux options \lang{french} et \lang{acadian} peuvent maintenant être
utilisées simultanément dans un même document ; elles ne présentent par défaut
aucune différence mais rien n’empêche de les personnaliser différemment
en ce qui concerne les motifs de césures, les légendes ou la ponctuation.
Une commande |\FBsetspaces| a été ajoutée pour faciliter le réglage des
espaces précédant la ponctuation haute et les guillemets avec la possibilité
de réglages différents selon l’option \lang{french} ou \lang{acadian}, voir
p.~\pageref{FBsetspaces}.
À partir de La version 3.4, eTeX et LuaTeX 1.0 sont requis.
\subsection{Changements entre les versions 3.3d et 3.2h}
\label{ssec:changes-3.3}
Le contrôle de l’ajout d’espace devant le deux-points a été amélioré dans la
version 3.3d mais uniquement avec le moteur LuaTeX : il n’y a plus d’ajout
d’espace parasite dans les URL (http://monsite), les chemins MSDOS
(C:\boi Mes Documents) ou les horaires (10:55).
Lors de la conversion en HTML par \exe{lwarp} (versions 0.37 et suivantes)
des fichiers compilés sous XeLaTeX ou pdfLaTeX, les espaces insécables ajoutées
par \ext{babel-french} pour la ponctuation haute et les guillemets sont
respectées.
Une nouvelle option (expérimentale) \fbo{UnicodeNoBreakSpaces} pour LuaLaTeX
a été ajoutée dans la version~3.3c, voir~\pageref{ucs-nbsp}.
{\sloppy
La version 3.3b a subi un réaménagement interne : chaque langue ou dialecte de
Babel devrait avoir son propre fichier \file{.ldf}. Ainsi pour le français il
y a dorénavant \file{french.ldf} qui contient le code principal et quatre
fichiers satellites \file{frenchb.ldf}, \file{francais.ldf}, \file{acadian.ldf}
et \file{canadien.ldf}. L’option à utiliser pour charger le français avec
Babel est toujours \opt{french} (ou \opt{acadian} pour le français du Canada
pour l’instant identique au français de base), les autres options (\opt{frenchb},
\opt{francais} ou \opt{canadien}) sont déconseillées et affichent un message
d’avertissement dans le fichier \file{.log}.\par
}
La version 3.3a disponible dans TeXLive 2017 est compatible avec LuaTeX 1.0.4
(stable) mais aussi avec la version 0.95 (beta) de TL2016.
L’espacement de la ponctuation haute et des guillemets français est maintenant
contrôlé par les \emph{commandes} |\FBcolonspace|, |\FBthinspace| et
|\FBguillspace| quel que soit le moteur utilisé (LuaTeX, XeTeX ou pdfTeX) ;
auparavant LuaTeX avait recours à des \emph{glue} |\FBcolonskip|,
|\FBthinskip| et |\FBguillskip|.
L’option \opt{french} devant être préférée à \opt{frenchb}, il m’a semblé
judicieux de renommer la commande de personnalisation |\frenchbsetup{}| en
|\frenchsetup{}|, l’ancien nom étant conservé par souci de compatibilité.
De nouvelles possibilités de personnalisation de la commande |\part{}| ont été
introduites, voir page~\pageref{ssec:captions}.
\subsection{Comment recompiler un document écrit pour
{babel-french}~2.x ?}
\label{ssec:compat-2.6}
Penser d’abord à remplacer \opt{frenchb} et \opt{francais} par \opt{french}
dans les options de Babel et dans |\selectlanguage{...}|,
|\begin{otherlanguage}{...}|, |\foreignlanguage{...}|.
Une exception toutefois : les classes SMF (\cls{smfart} et \cls{smfbook}) ne
fonctionnent qu’avec l’option \opt{frenchb}… vieux reliquat d’un passé
lointain où l’option \opt{french} de babel était ambiguë (ambiguïté levée depuis
2004).
Ajouter l’option \fbo{OldFigTabCaptions} à \fbsetup{} si on tient à avoir
deux séparateurs différents pour les légendes de figures et de tableaux,
|\CaptionSeparator| en français et deux-points pour les autres langues.
Ajouter |\listindentFB=0pt| juste avant les environnements \env{description}
si on souhaite que les étiquettes de ces environnements collent à la marge
gauche au premier niveau.
\section{Problèmes de césures}
\label{sec:cesures}
Pour vérifier que votre format LaTeX fonctionne correctement au niveau des
césures, au moins en français et en anglais, téléchargez le fichier de test
\expandafter\expandafter\expandafter\url{\urlperso/frenchb/frenchb-cesures.tex}
et suivez les instructions figurant en début de fichier.
Si les résultats du test ne sont pas corrects, vérifiez tout au début du
fichier \file{.log} dans la ligne commençant par le mot « Babel », si
« french » figure bien dans la liste des langues disponibles.
Si ce n’est pas le cas, installez le paquet appelé « collection-langfrench »
(TeXLive, MacTeX) ou « texlive-lang-french » (distributions Linux) ou
similaire. Si vous travaillez avec « tlmgr », les formats sont refaits
automatiquement, sinon il faut les faire à la main (la procédure dépend de
votre installation).
Recompilez le fichier \file{frenchb-cesures.tex}, les résultats devraient
être corrects, contactez-moi par courriel si ce n’était pas le cas.
\section{Problèmes avec les quatre caractères actifs
(\string; \string: \string! \string?)}
\label{sec:active-char}
Rappelons d’abord que ces quatre caractères \emph{ne sont pas rendus actifs}
avec les moteurs LuaTeX ou XeTeX, donc aucun problème n’est à craindre
avec ces moteurs%
\footnote{N’est-ce pas une bonne raison d’abandonner pdf(La)TeX ?},
cette section ne concerne \emph{que les vieux moteurs} TeX’82 et pdfTeX.
Normalement, le nécessaire est fait par Babel pour que les caractères rendus
actifs ne perturbent pas les autres extensions… mais il y a hélas des
exceptions (\ext{tikz}, \ext{xypic}, \ext{xcolor}, \ext{autonum}, \ext{arabtex},
\ext{cleveref} par exemple). Il faut savoir que les caractères
rendus actifs par une langue \emph{le restent dans tout le document}, repasser
en anglais par exemple ne désactive pas les \string; \string: \string!
\string? s’ils ont été rendus actifs par \ext{babel-french} !
Les espaces insécables ajoutés entre les guillemets peuvent également être
gênants.
Depuis la version~2.5, la commande à utiliser en cas de problème est
|\NoAutoSpacing|%
\footnote{Elle fonctionne avec tous les formats pdf(La)TeX, Lua(La)TeX
et Xe(La)TeX mais ne règle pas tous les problèmes de caractères actifs,
notamment dans les \texttt{\boi{}label} et autres \texttt{\boi{}caption},
voir la section~\ref{sec:Incomp} à ce sujet.
.}
\emph{dans un groupe} comme ceci :
|{\NoAutoSpacing|\\
\textit{Partie ne supportant pas les caractères actifs}\\
|}|
ou à l’intérieur d’un environnement, par exemple
|\begin{tikzpicture}\NoAutoSpacing|\\
| ... |\\
|\end{tikzpicture}|
Avec \ext{tikz} v3.0, une solution alternative consiste à ajouter
|\usetikzlibrary{babel}| dans le préambule, voir la documentation de TikZ
(\file{pgfmanual.pdf}). L’avantage de cette solution est de tenter de préserver
les caractères actifs dans les nœuds même si ça ne fonctionne pas toujours,
notamment pour le point d’exclamation.
Avec pdf(La)TeX, il est également possible de désactiver un seul ou plusieurs
caractères actifs de manière sélective grâce à la commande |\shorthandoff| de
Babel. Le mieux est de le faire \emph{localement} dans un environnement ou
dans un groupe comme ceci :
|{\shorthandoff{:!}%|\\
\textit{Partie ne supportant pas les caractères actifs `:’ et `!’}\\
|}|
\section{Incompatibilités connues et remèdes}
\label{sec:Incomp}
La liste suivante ne prétend pas être exhaustive, n’hésitez pas à me signaler
les incompatibilités que vous rencontrez afin qu’elles puissent figurer dans
cette liste.
\begin{itemize}
\item Les caractères rendus actifs par \ext{babel-french}%
\footnote{Ceci ne concerne ni Xe(La)TeX ni Lua(La)TeX qui gèrent autrement
la ponctuation haute.}
(\string; \string: \string! \string?) peuvent perturber certaines
extensions, c’est le cas de \ext{tikz}, \ext{xypic}, \ext{xcolor},
\ext{arabtex}, \ext{cleveref} par exemple, voir comment y remédier
section~\ref{sec:active-char}.
En règle générale, il vaudrait mieux éviter les caractères actifs dans les
|\label| et |\caption|, remplacer systématiquement les « \string: » par des
tirets « - » dans les |\label| est une saine précaution. Pour éviter les
problèmes de caractères actifs avec \ext{natbib} ou \ext{listings}, il
convient de charger \ext{natbib} \emph{avant} \ext{babel} et \ext{listings}
\emph{après} \ext{babel}.\hlabel{ch-doc3}
Un message est affiché dans le fichier \file{.log} lorsque l’ordre de
chargement n’est pas correct.
\ext{hyperref} ne fonctionne pas avec la commande |\cite| standard lorsque
celle-ci contient un caractère actif, charger l’extension \ext{cite} règle
le problème.
\item En LaTeX, les caractères \string; \string: \string! \string? ne sont
rendus actifs
qu’au |\begin{document}|, ainsi les espaces attendues ne sont pas
ajoutées automatiquement lorsque ces caractères sont utilisés dans des
commandes définies dans le préambule ou dans des fichiers~\file{.sty}.\\
Exemple : la commande |\title{Quelle crise?}| placée dans le
préambule imprimera « Quelle crise\string? » (sans espace)%
\footnote{Mais l’espace sera préservée si on compile en LuaLaTeX ou
en XeLaTeX puisque le mécanisme est différent.}
lors de l’appel de |\maketitle|. Il y a plusieurs parades :
\begin{itemize}
\item soit placer la commande |\title{Quelle crise?}| après le
|\begin{document}| (et avant |\maketitle|),
\item soit placer les commandes du type |\title| entre un
|\shorthandon{;:!?}| (avant) et un |\shorthandoff{;:!?}|
(après), si on tient à les laisser dans le préambule.
\end{itemize}
\item Les extensions \ext{caption}, \ext{subcaption}, \ext{floatrow}
doivent impérativement être chargées \emph{après} \ext{babel}.
En revanche \ext{beameraticle} doit être chargée \emph{avant} \ext{babel}.
À chaque fois que le bon ordre de chargement
n’est pas respecté, un avertissement le signale dans le fichier \file{.log}.
\item \ext{babel-french} modifie la présentation des listes ce qui peut
perturber les classes ou extensions qui veulent également le faire.
\ext{babel-french} s’efface automatiquement lorsqu’une des extensions
\ext{enumitem}, \ext{enumerate} ou \ext{paralist} est chargée. Pour les
autres, ou si on veut soi-même agir sur la présentation des listes, il
convient de débrayer l’action de \ext{babel-french} en utilisant la commande
\fbsetup{} avec les options adéquates (cf. section~\ref{ssec:frenchbsetup})
dans le préambule du document (après le chargement de Babel).
{\sloppy
\item Certaines classes (\cls{amsbook}, \cls{smfbook},
\cls{beamer}, etc.) redéfinissent |\part|, ce qui peut conduire à
des titres du genre « Première partie~I ». La parade consiste à ajouter
l’option \fbo{PartNameFull=false} dans \fbsetup{}.
\par}
\item L’option \opt{multiple} de l’extension \ext{footmisc} insère normalement
une virgule entre les appels de notes multiples. Pour que ce mécanisme
fonctionne avec \ext{babel-french} il faut ajouter l’option
\fbsetup{AutoSpaceFootnotes=false}, sinon \ext{babel-french} remplace la
virgule par une espace fine.
\item Dans une commande |\index{}|, les guillemets français doivent
obligatoirement être codés sous la forme |\frquote{}| (ou |\og|, |\fg|) :
\hlabel{ch-doc4}
|\index{\frquote{toto}| donne le résultat attendu, tandis que
|\index{«toto»}| provoque soit une erreur à la compilation (en LaTeX),
soit un mauvais classement de l’entrée |«toto»| dans l’index (en
XeLaTeX et LuaLaTeX).
\end{itemize}
\section{Bibliographie}
\label{sec:biblio}
Ce qui suit ne concerne \emph{pas} les bibliographies faites « à la main »
dans l’environnement \env{thebibliography}, mais celles créées à partir d’un
ou plusieurs fichiers~\file{.bib} avec \BibTeX{} ou mieux avec
\biblatex/\biber{}.
\vspace{-.5\baselineskip}
\subsection{Bibliographie avec \texorpdfstring{\BibTeX}{BibTeX}}
\label{ssec:bibtex}
\BibTeX{} est obsolète, je conseille \emph{vraiment} de passer
à \biblatex/\biber{} (voir section suivante).
Néanmoins, voici quelques indications concernant la francisation des
bibliographies créées avec \BibTeX{} :
Certains champs (les dates notamment) et certains mots-clés figurant dans les
fichiers~\file{.bib} (les «\emph{and}» des listes d’auteurs par exemple)
devraient pouvoir être affichés différemment selon le contexte (les
«\emph{and}» du fichier~\file{.bib} devraient pouvoir être transcrits en
«\emph{et}» dans le fichier~\file{.bbl} pour les références en français).
Babel n’opère pas au niveau \BibTeX, il faut donc agir
directement au niveau des bases de données~\file{.bib} et des fichiers de
style~\file{.bst}.
\begin{description}
\item [Fichiers~\file{.bib}] : s’assurer que chaque référence des bases de
données \file{.bib} utilisées comporte un champ « \code{language =
\{...\}} » définissant la langue d’origine de la référence.
\item [Fichiers~\file{.bst}] : pour remplacer les styles standard
\bibsty{alpha}, \bibsty{plain}, \bibsty{unsrt}, faire appel à l’extension
\bibsty{babelbib} et aux styles \bibsty{babalpha}, \bibsty{babplain},
\bibsty{babunsrt} (voir la documentation \file{babelbib.pdf} et le fichier
d’exemples \file{babelbibtest.tex}). Selon les options, il est possible
d’afficher chaque référence dans sa langue ou bien de les afficher toutes
dans la langue principale du document%
\footnote{Les styles francisés \file{*-fr.bst} qu’on trouve sur CTAN dans
\url{tex-archive/biblio/bibtex/contrib/bib-fr} n’offrent que
la seconde possibilité (références toutes en français).}.
Ceux qui font appel à un style de bibliographie sur mesure créé à partir de
\file{custom-bib} devront choisir l’option \opt{babel} lors de la
création du fichier \file{.bst} et ensuite adapter le fichier
\file{babelbst.tex} aux langues utilisées.
\end{description}
\subsection{Bibliographie avec \biblatex/\biber}
\label{ssec:biblatex}
La solution \biblatex/\biber{} présente des nombreux avantages par rapport
à \BibTeX{} :
\begin{itemize}
\item \biblatex{} prend en compte les options de Babel, les «\emph{and}» des
listes d’auteurs sont transcrits automatiquement en «\emph{et}» dans un
document en français ;
\item \biblatex{}, associé à \biber{}, permet le traitement des fichiers
~\file{.bib} codés en utf-8 ce qui facilite grandement la coexistence
de références à des ouvrages en français, en russe et en grec par exemple ;
\item \biblatex{} possède des options qui remplacent de nombreuses extensions
spécifiques telles que \ext{bibtopic}, \ext{bibunits}, \ext{chapterbib},
\ext{cite}, \ext{multibib}, \ext{natbib}, etc.
\end{itemize}
Pour la mise en œuvre pratique de \biblatex/\biber{}, consulter le manuel
\textit{LaTeX, l’essentiel} de \bsc{D.~Bitouzé} et \bsc{J.-C.~Charpentier} ou
la documentation en anglais \file{biblatex.pdf}.
\section[Compatibilité avec e-french]
{Compatibilité avec \ext{e-french}}
\label{sec:CompatFP}
Il est souhaitable qu’un texte saisi avec
\ext{e-french} de Bernard~\bsc{Gaulle} puisse être compilé avec un
minimum de modifications sur une machine utilisant \ext{babel-french}
et réciproquement.
En ce qui concerne les guillemets français, \ext{e-french} rend actifs les
caractères |<| et |>| afin de saisir les guillemets sous la forme |<||<| et
|>||>| tandis que \ext{babel-french} s’y refuse et utilise en interne des
macros |\og| et |\fg|.
Lorsqu’on travaille en codage~\texttt{T1} avec \ext{babel-french}, l’existence
des ligatures~|<||<| et~|>||>| permet de saisir
|<||<~|\code{guillemets français}|~>||>|,
mais les espaces insécables sont \emph{indispensables}.
Les commandes |\og| et |\fg| (ou leurs alias \fbo{«} et \fbo{»}, à condition
que ceux-ci aient été activés dans \fbsetup{}) sont préférables : elles
introduisent automatiquement des espaces insécables et plus fines pour un
meilleur rendu typographique.
Les points de suspensions sont saisis |...| avec
\ext{e-french} et |…| (ou |\dots|) avec \ext{babel-french}.
Les commandes suivantes peuvent être ajoutées au préambule pour
émuler certaines commandes de \ext{e-french} :
\begin{verbatim}
\let\numero=\no
\let\Numero=\No
\let\fsc=\bsc
\let\lsc=\bsc
\newcommand*{\french}{\leavevmode\selectlanguage{french}}
\newcommand*{\english}{\leavevmode\selectlanguage{english}}
\newcommand*{\AllTeX}{%
(L\kern-.36em\raise.3ex\hbox{\sc a}\kern-.15em)%
T\kern-.1667em\lower.7ex\hbox{E}\kern-.125emX}
\end{verbatim}
Pour ceux qui éditent leurs sources LaTeX avec emacs, une fonction Lisp
\file{french2b} opère une adaptation \emph{partielle} d’un fichier conçu pour
\ext{e-french} facilitant sa compilation avec \ext{babel-french}. L’appel
à \ext{e-french} est remplacé en un appel à \ext{babel-french}, les guillemets
|<<| et |>>| sont convertis en |\og| et |\fg| et les |...| en |…|, enfin
quelques commandes spécifiques à \ext{e-french} sont ajoutées dans le
préambule.
Cette fonction est disponible sur
\expandafter\expandafter\expandafter\url{\urlperso/frenchb/french2b.el}.
Il suffit de l’ajouter à un fichier \file{.emacs} et de l’exécuter par
|Esc x french2b| sur le fichier à convertir.
\nopagebreak
\vspace{2\baselineskip}
\nopagebreak
\hspace*{\fill}%
\begin{minipage}[b]{.5\linewidth}
\raggedleft
\href{mailto:daniel.flipo@free.fr}{Daniel \textsc{Flipo}}\\
\expandafter\expandafter\expandafter\url{\urlperso}
\end{minipage}
\end{document}
%%% Local Variables:
%%% mode: latex
%%% TeX-engine: luatex
%%% TeX-master: t
%%% coding: utf-8
%%% TeX-source-correlate-mode: t
%%% mode: flyspell
%%% ispell-local-dictionary: "francais"
%%% End:
|