Skip to content

Commit d3e11f7

Browse files
authored
Merge pull request #31 from jejust/main
Corrections and updates found during translation to French.
2 parents 4f8ce95 + 2c8b327 commit d3e11f7

27 files changed

+353
-243
lines changed

AUTHORS.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -47,6 +47,7 @@ The following people are _known_ to have contributed to the FAQ:
4747
- David Jansen
4848
- Alan Jeffrey
4949
- Regnor Jernsletten
50+
- Jérémy Just
5051
- David Kastrup
5152
- Oleg Katsitadze
5253
- Isaac Khabaza

CHANGELOG.md

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,9 +7,32 @@ file. Changes prior to the switch to Markdown format are available from
77
The format is based on [Keep a
88
Changelog](https://keepachangelog.com/en/1.0.0/).
99

10+
## 2021-04-18
11+
12+
### Added
13+
14+
- Q-prevlig: New question.
15+
16+
### Renammed
17+
18+
- Q-texcad to Q-texdraw: Added other drawing packages.
19+
20+
### Changed
21+
22+
- Q-erroradvice: Added link.
23+
- Q-spell: Removed information about VMS and MS-DOS programs. Added `Antidote` as a LaTeX-aware spell checker.
24+
- Q-recovertex: Links added.
25+
- Q-time.md: Added `datetime2`.
26+
- Q-typo-style: Added two documents.
27+
- Q-uploads: Added details about version identifiers.
28+
- Q-useMF: Correction of typos.
29+
- Q-whereFAQ: Correction of links.
30+
- Q-xspace: Correction of punctuation.
31+
1032
## 2021-04-01
1133

1234
### Added
35+
1336
- Q-arraytab: New question
1437
- Q-rule: New question
1538

FAQ-2colfloat.md

Lines changed: 17 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -8,30 +8,29 @@ permalink: /FAQ-2colfloat
88
date: 2018-05-18
99
---
1010

11-
You specified placement `[htbp]` for your full-width figure or
12-
table, but they always get placed at the top of the page… Well,
11+
You specified placement `[htbp]` for your full-width figure or table,
12+
but they always get placed at the top of the page… Well,
1313
it _is_ what the documentation says: LaTeX, unadorned, only
1414
allows full-width floats at the top of a page, or occupying (part of) a
1515
float page.
1616

1717
The package [`nidanfloat`](https://ctan.org/pkg/nidanfloat) supports `[b]` placement of a
18-
full-width figure in a two-column document even on the first page of a
19-
document.
18+
full-width figure in a two-column document even on the first page of a document.
2019

2120
Barbara Beeton's article
2221
[Placing a full-width insert at the bottom of two columns](https://tug.org/TUGboat/tb35-3/tb111beet-banner.pdf) in TUGboat 35(3)
2322
gives a manual method for doing the same.
2423

25-
The [`stfloats`](https://ctan.org/pkg/stfloats) package also ameliorates the situation somewhat, and
26-
makes LaTeX honour "[b]" placement as well.
24+
The [`stfloats`](https://ctan.org/pkg/stfloats) package also ameliorates
25+
the situation somewhat, and makes LaTeX honour "[b]" placement as well.
2726

28-
A particular problem with [`stfloats`](https://ctan.org/pkg/stfloats) and [`dblfloatfix`](https://ctan.org/pkg/dblfloatfix)
29-
is that the float will appear, at its earliest, on the page after it
30-
is specified. This has two undesirable side-effects: first, there may
31-
be no bottom float on the first page of a document, and second, float
32-
numbers may become "entangled" (particularly if you're using
33-
[`dblfloatfix`](https://ctan.org/pkg/dblfloatfix) that ensures that the early-specified bottom
34-
float is set _before_ any single column floats).
27+
A particular problem with [`stfloats`](https://ctan.org/pkg/stfloats) and
28+
[`dblfloatfix`](https://ctan.org/pkg/dblfloatfix) is that the float will appear,
29+
at its earliest, on the page after it is specified. This has two undesirable
30+
side-effects: first, there may be no bottom float on the first page of a
31+
document, and second, float numbers may become "entangled" (particularly
32+
if you're using [`dblfloatfix`](https://ctan.org/pkg/dblfloatfix) that ensures
33+
that the early-specified bottom float is set _before_ any single column floats).
3534

3635
(The FAQ team doesn't know of any package that will make
3736
LaTeX honour "[h]" placement of double-column floats, but the
@@ -40,7 +39,8 @@ something approximating the effect it would have.)
4039

4140
Prior to the LaTeX2e 2015 release, double and single column floats were maintained
4241
in separate lists and could be output in the wrong order. For these older releases
43-
[`dblfloatfix`](https://ctan.org/pkg/dblfloatfix) package combines a tidied version of the changes
44-
made in [`stfloats`](https://ctan.org/pkg/stfloats) with the
45-
[float ordering corrections](FAQ-2colfltorder) defined in
46-
[`fixltx2e`](https://ctan.org/pkg/fixltx2e).
42+
[`dblfloatfix`](https://ctan.org/pkg/dblfloatfix) package combines a tidied version
43+
of the changes made in [`stfloats`](https://ctan.org/pkg/stfloats) with the
44+
[float ordering corrections](FAQ-2colfltorder) defined in
45+
[`fixltx2e`](https://ctan.org/pkg/fixltx2e).
46+

FAQ-RCS.md

Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -5,8 +5,7 @@ permalink: /FAQ-RCS
55
redirect_from: /FAQ-rcs
66
---
77

8-
If you use RCS, CVS, `Subversion`,
9-
`Bazaar` or `Git` to maintain
8+
If you use RCS, CVS, `Subversion`, `Bazaar` or `Git` to maintain
109
your (La)TeX documents under version control, you may need some
1110
mechanism for including the version details in your document, in such
1211
a way that they can be typeset (that is, rather than just hiding them
@@ -69,8 +68,7 @@ documentation to see which suits you best.
6968
An alternative script-based approach to version control has been taken
7069
by the [`vc`](https://ctan.org/pkg/vc) bundle, that in certain situations might work more
7170
reliably than any of the packages mentioned above. The [`vc`](https://ctan.org/pkg/vc)
72-
bundle supports `Bazaar`, `Git` and
73-
`Subversion` usage and works with both LaTeX and
71+
bundle supports `Bazaar`, `Git` and `Subversion` usage and works with both LaTeX and
7472
Plain TeX. Note that [`vc`](https://ctan.org/pkg/vc) is the only option that
7573
currently claims to support `Bazaar`-controlled repositories.
7674

FAQ-errmissitem.md

Lines changed: 4 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ permalink: /FAQ-errmissitem
55
---
66

77
Sometimes, the error
8-
```latex
8+
```raw
99
Something's wrong--perhaps a missing \item
1010
```
1111
actually means what it says:
@@ -99,9 +99,8 @@ modification of the above _does_ work:
9999
```
100100
<!-- {% endraw %} -->
101101
The code above produces a box that's far too wide for the text. One
102-
may want to use something that allows
103-
[variable size boxes](FAQ-varwidth) in place of the
104-
`minipage` environment.
102+
may want to use something that allows [variable size boxes](FAQ-varwidth)
103+
in place of the `minipage` environment.
105104

106105
Oddly, although the `verbatim` environment wouldn't work
107106
inside a `\fbox` command argument (see
@@ -118,6 +117,5 @@ error:
118117
This is a case where you've simply got to be more subtle; you should
119118
either write your own macros to replace the insides of LaTeX's
120119
sectioning macros, or look for some alternative in the packages
121-
discussed in
122-
"[The style of section headings](FAQ-secthead)".
120+
discussed in "[The style of section headings](FAQ-secthead)".
123121

FAQ-erroradvice.md

Lines changed: 10 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -10,17 +10,16 @@ macroprocessors. Knuth makes light of the problem in the TeXbook,
1010
suggesting that you acquire the sleuthing skills of a latter-day
1111
Sherlock Holmes; while this approach has a certain romantic charm to
1212
it, it's not good for the "production" user of (La)TeX. This
13-
answer (derived, in part, from an article by Sebastian Rahtz in
14-
TUGboat 16(4)) offers some general guidance in dealing with TeX
13+
answer (derived, in part, from an [article by Sebastian Rahtz](http://tug.org/TUGboat/tb16-4/tb49rahtz.pdf)
14+
in TUGboat 16(4)) offers some general guidance in dealing with TeX
1515
error reports, and other answers in this section deal with common (but
1616
perplexing) errors that you may encounter. There's a long list of
1717
"hints" in Sebastian's article, including the following:
18-
18+
1919

2020
- Look at TeX errors; those messages may seem cryptic at first,
2121
but they often contain a straightforward clue to the problem. See
22-
[the structure of errors](FAQ-errstruct) for further
23-
details.
22+
[the structure of errors](FAQ-errstruct) for further details.
2423
- Read the `log` file; it contains hints to things you may
2524
not understand, often things that have not even presented as error
2625
messages.
@@ -40,16 +39,15 @@ perplexing) errors that you may encounter. There's a long list of
4039
- As a last resort, tracing can be a useful tool; reading a full
4140
(La)TeX trace takes a strong constitution, but once you know how,
4241
the trace can lead you quickly to the source of a problem. You need
43-
to have read the TeXbook (see
44-
[books about TeX](FAQ-tex-books)) in some detail, fully
45-
to understand the trace.
46-
42+
to have read the TeXbook (see [books about TeX](FAQ-tex-books))
43+
in some detail, fully to understand the trace.
44+
4745
4846
The command `\tracingall` sets up maximum tracing; it also sets
4947
the output to come to the interactive terminal, which is somewhat of
5048
a mixed blessing (since the output tends to be so vast&nbsp;&mdash; all but
5149
the simplest traces are best examined in a text editor after the event).
52-
50+
5351
5452
The LaTeX [`trace`](https://ctan.org/pkg/trace) package (first distributed with the
5553
2001 release of LaTeX) provides more manageable tracing. Its
@@ -65,7 +63,6 @@ most of the common errors are plain to the eye when you go back to the
6563
source line that TeX tells you of. If that approach doesn't work,
6664
the remaining answers in this section deal with some of the odder
6765
error messages you may encounter. You should not ordinarily need to
68-
appeal to the [wider public](FAQ-gethelp)
69-
for assistance, but if you do, be sure to
70-
report full backtraces (see `errorcontextlines` above) and so on.
66+
appeal to the [wider public](FAQ-gethelp) for assistance, but if you do,
67+
be sure to report full backtraces (see `errorcontextlines` above) and so on.
7168

FAQ-errstruct.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ is after all the arguments have been scanned.) For example:
3737
\blah and so on
3838
```
3939
produces the error report
40-
```latex
40+
```raw
4141
! Undefined control sequence.
4242
l.4 \blah
4343
and so on
@@ -48,7 +48,7 @@ while:
4848
\blah{to you}, folks
4949
```
5050
produces the error report
51-
```latex
51+
```raw
5252
! Undefined control sequence.
5353
\blah #1->\bleah
5454
#1
@@ -61,7 +61,7 @@ If the argument itself is in error, we will see things such as
6161
\blah{\bleah}, folks
6262
```
6363
producing
64-
```latex
64+
```raw
6565
! Undefined control sequence.
6666
<argument> \bleah
6767
@@ -70,7 +70,7 @@ l.5 \blah{\bleah}
7070
```
7171

7272
The prompt accepts single-character commands: the list of what's
73-
available may be had by typing `?`. One immediately valuable
73+
available may be obtained by typing `?`. One immediately valuable
7474
command is `h`, which gives you an expansion of TeXs original
7575
précis message, sometimes accompanied by a hint on what to do to
7676
work round the problem in the short term. If you simply type "return"

FAQ-hyphen.md

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -49,8 +49,7 @@ hyphenation: `\language` (which selects a hyphenation style), and
4949
engine, overriding the effect of the patterns).
5050

5151
The ordinary LaTeX user need not worry about `\language`, since
52-
it is very thoroughly managed by the [`babel`](https://ctan.org/pkg/babel) package; use of
53-
`\hyphenation` is discussed in
54-
the context of
52+
it is very thoroughly managed by the [`babel`](https://ctan.org/pkg/babel)
53+
package; use of `\hyphenation` is discussed in the context of
5554
[hyphenation failure](FAQ-nohyph).
5655

FAQ-letterspace.md

Lines changed: 6 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -20,15 +20,15 @@ text is less awful a crime; the technique used also to be used for
2020
emphasis of text set in Fraktur (or similar) fonts.
2121

2222
Straightforward macros (usable, in principle, with any TeX macro
23-
package) may be found in [`letterspacing`](https://ctan.org/pkg/letterspacing) (which is the name of
24-
the `tex` file).
23+
package) may be found in [`letterspacing`](https://ctan.org/pkg/letterspacing)
24+
(which is the name of the `tex` file).
2525

2626
A more comprehensive solution is to be found in the [`soul`](https://ctan.org/pkg/soul)
2727
package (which is optimised for use with LaTeX, but also works with
2828
Plain TeX). Soul also permits hyphenation of letterspaced text;
2929
Gill's view of such an activity is not (even apocryphally) recorded.
30-
(Spacing-out forms part of the name of [`soul`](https://ctan.org/pkg/soul); the other half
31-
is described in [another question](FAQ-underline).)
30+
(Spacing-out forms part of the name of [`soul`](https://ctan.org/pkg/soul);
31+
the other half is described in [another question](FAQ-underline).)
3232

3333
Possibly the "ultimate" in this field is the [`microtype`](https://ctan.org/pkg/microtype),
3434
which uses the micro-typography capabilities of current pdfTeX to
@@ -37,7 +37,6 @@ declared in a `\SetTracking` command. [`Microtype`](https://ctan.org/pkg/Microt
3737
"tracking" facility expands the natural spacing of the font itself,
3838
rather than inserting space between characters. Ordinarily,
3939
letter-spacing will destroy ligatures; however, this is _wrong_
40-
for some font styles (for example, `fraktur`), and the
41-
package provides a means of protecting the ligatures in a
42-
letter-spaced text.
40+
for some font styles (for example, `fraktur`), and the package provides
41+
a means of protecting the ligatures in a letter-spaced text.
4342

FAQ-parmoderr.md

Lines changed: 8 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -14,10 +14,10 @@ For example:
1414
```
1515
The error comes when you try to build something movable inside a box.
1616
Movable things, in this context, are floating environments
17-
(`figure` and `table`, for example), and
18-
`\marginpar`s. LaTeX simply doesn't have the mechanisms for
19-
floating out of boxes. In fact, floats and `\marginpar`s
20-
themselves are built out of boxes, so that they can't be nested.
17+
(`figure` and `table`, for example), and `\marginpar`s. LaTeX simply
18+
doesn't have the mechanisms for floating out of boxes. In fact, floats
19+
and `\marginpar`s themselves are built out of boxes, so that they
20+
can't be nested.
2121

2222
If your error arises from `\marginpar`, you simply have to think of
2323
an alternative way of placing the command; there is no slick solution.
@@ -37,8 +37,8 @@ the `H` placement option, provided (for example) by the
3737
<!-- {% endraw %} -->
3838
This example makes little sense as it stands; however, it is
3939
conceivable that sane uses could be found (for example, using a
40-
package such as [`algorithm2e`](https://ctan.org/pkg/algorithm2e) to place two algorithms
41-
side-by-side).
40+
package such as [`algorithm2e`](https://ctan.org/pkg/algorithm2e) to place
41+
two algorithms side-by-side).
4242

4343

4444
Another common occurrence is when the user wants a figure somewhere
@@ -64,8 +64,7 @@ The problem is, that the `tabular` environment, and the
6464
`\framebox` command restrain the `figure` environment
6565
from its natural métier, which is to float around the document.
6666

67-
The solution is simply not to use the `figure` environment
68-
here:
67+
The solution is simply not to use the `figure` environment here:
6968
```latex
7069
\begin{tabular}{|l|}
7170
\hline
@@ -78,8 +77,7 @@ serves no useful purpose; but perhaps you actually wanted a diagram
7877
and its caption framed, in a float.
7978

8079
It's simple to achieve this&nbsp;&mdash; just reverse the order of the
81-
environments (or of the `figure` environment and the
82-
command):
80+
environments (or of the `figure` environment and the command):
8381
```latex
8482
\begin{figure}
8583
\begin{tabular}{|l|}

FAQ-prevlig.md

Lines changed: 71 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,71 @@
1+
---
2+
title: Preventing a ligature
3+
category: formatting
4+
permalink: /FAQ-prevlig
5+
date: 2021-04-18
6+
---
7+
8+
This is a strength of TeX: some pairs of letters are automatically replaced
9+
by a single glyph, for aesthetic reasons, as is done in letterpress. For example,
10+
when an `f` and an `i` are placed next to each other, the hood of the `f` would
11+
normally tend collide with the tittle of the `i`, which wouldn't look very nice.
12+
TeX therefore replaces them with a new, prettier glyph: fi.
13+
This merging of glyphs is called a ligature.
14+
15+
The same mechanism is used to obtain the Spanish characters ¡ and ¿, which are
16+
typed in as `` !` `` and `` ?` ``.
17+
18+
In Cyrillic fonts used with OT2 encoding, the letter pair `sh` will produce the
19+
glyph ш (the _sha_ letter).
20+
21+
But in some cases, one may want to prevent ligatures from occurring.
22+
23+
24+
To prevent a single ligature, just separate the letters in the (La)TeX code
25+
with something that will produce nothing in the output file. For example:
26+
`\/`, `{}`, `\mbox{}`, `\null`. The T1 and OT1 font encodings also provide
27+
the `\textcompwordmark` command, which has the same purpose.
28+
29+
```latex
30+
% With the automatic ligature:
31+
offence
32+
33+
% Without it:
34+
of\/fence
35+
of{}fence
36+
of\null fence
37+
of\mbox{}fence
38+
of\textcompwordmark fence
39+
```
40+
41+
Note that, in some cases, `{}` seems to have no effect, and the ligature
42+
occurs in spite of it. This is apparently a side effect of some packages, such
43+
as [`multicol`](https://ctan.org/pkg/multicol). The other solutions may
44+
therefore be preferred.
45+
In all cases, [hyphenation](FAQ-hyphen) of the word is no longer performed
46+
automatically by TeX, and you have to [take care of it manually](FAQ-hyphexcept),
47+
if needed.
48+
49+
50+
The same solution prevents kerning between consecutive characters.
51+
Compare for example the rendering of `AV` and `A\/V`.
52+
53+
54+
In case you want to prevent ligature in you whole document,
55+
have a look at [`fontspec`](https://ctan.org/pkg/fontspec) options.
56+
It can disable all aesthetic ligatures, or disable them on a type by type basis:
57+
58+
```latex
59+
\usepackage{fontspec}
60+
61+
\defaultfontfeatures{
62+
Ligatures={
63+
NoCommon,
64+
NoRequired,
65+
NoContextual,
66+
NoHistoric,
67+
NoDiscretionary
68+
}
69+
}
70+
```
71+

0 commit comments

Comments
 (0)