Download The Extreme Wide Shot and more Study notes Storytelling in PDF only on Docsity!
embrac
v0.9a 2021/02/
Upright Brackets in Emphasized Text
Clemens Niederberger
https://github.com/cgnieder/embrac/
[email protected]
Table of Contents
1 License and Requirements 1
2 Acknowledgements 1
3 About 1
4 How it Works 2
5 Adding More Brackets & Ad- justing the Kerning 3
6 Adding More Commands 6
7 biblatex Compatibility 6
8 Turn embrac Temporarily Off 6
9 Watch out! 7
10 Version History 7
Index 9
1 License and Requirements
Permission is granted to copy, distribute and/or modify this software under the terms of the LATEX Project Public License ( lppl), version 1.3c or later (http://www.latex-project.org/ lppl.txt). The software has the status “maintained.” embrac needs the the l3kernel [L3Pa] and l3packages [L3Pb].
2 Acknowledgements
I like to thank both Dominik Waßenhoven for inspiration [Waß12] and Bruno Le Floch for providing code [Flo11]. Without either of them this package probably wouldn’t exist.
3 About
Parentheses and brackets are not le ers, and it makes li le sense to speak of them as roman or italic. There are vertical parentheses and sloped ones, and the parentheses on
4 How it Works
italic fonts are almost always sloped, but vertical parentheses are generally to be preferred. That means they must come from the roman font, and may need extra spacing when used with italic le erforms. The sloped square brackets usually found on italic fonts are, if anything, even less useful than sloped parentheses. If, perish the thought, there were a book or film entitled The View from My [sic] Bed, sloped brackets might be useful as a way of indicating that the brackets and their contents are actually part of the title. Otherwise, vertical brackets should be used, no ma er whether the text is roman or italic: “The View from My [sic] Bed” and “the view from my [sic] bed.” [Bri04, p. 85]
Both this quote from The Elements of Typographic Style by Robert Bringhurst and the article “Aufrechte Klammern in kursivem Text” by Dominik Waßenhoven [Waß12] inspired this package. Indeed, embrac heavily borrows from the code Wassenhoven provided in his article. 1 The code was originally provided by Bruno Le Floch 1 answering a question on TeX.sx [Flo11]. Version 0.6: embrac tries to redefine \emph, \textit and \textsl added \textsl
in a way that neither parentheses nor square brackets are sloped. In an ideal world you of course wouldn’t need this package because the italic font you’re using would have vertical parentheses and brackets by itself.
1 \emph{This is emphasized [sic] text.} \par 2 \emph{This is emphasized text (as you can see).}
This is emphasized [sic] text. This is emphasized text (as you can see).
4 How it Works
The commands \emph, \textit and \textsl are redefined:
\emph*{〈emphasized text〉} Emphasizing text.
\textit*{〈text in italics〉} Italicizing text,
\textsl*{〈slanted text〉} Slanting text,
\textsi*{〈text in italic small caps〉} This command is only defined and thus redefined if you loaded fontspec, i. e., if you’re compiling your document with XE LATEX or LuaLATEX.
- Many thanks again for his kind permission to use it!
5 Adding More Brackets & Adjusting the Kerning
\RenewEmph{〈o〉}[〈io-kern〉,〈oo-kern〉]{〈c〉}[〈ic-kern〉,〈oc-kern〉] Renew the kerning values for a given pair of brackets. See below for the difference to \ChangeEmph. \DeleteEmph{〈o〉}{〈c〉} Remove a pair of brackets from treatment. In the above descriptions 〈o〉 means opening bracket and 〈c〉 means closing bracket. The kerning arguments are all four optional and require – if given – to be a length. If they’re not given \AddEmph and \RenewEmph insert 0pt and \ChangeEmph uses the value stored by \AddEmph or \RenewEmph before. Introduced in version 0.
To each of these commands there are two variants that are only semantically different. 2 They are all called \〈base〉OpEmph or \〈base〉ClEmph where 〈base〉 is either Add, Change, Renew or Delete. Their arguments are all the same: the half of what the main commands have for either modifying the opening or the closing symbols. \AddOpEmph{〈o〉}[〈io-kern〉,〈oo-kern〉] An an opening bracket to the treatment. \AddClEmph{〈c〉}[〈ic-kern〉,〈oc-kern〉] An a closing bracket to the treatment. They allow you to add single symbols to embrac’s mechanism instead of adding pairs. In all these commands the optional argument 〈io-kern〉 is inserted after the opening bracket (inner opening), 〈oo-kern〉 is inserted before it (outer opening). 〈ic-kern〉 is inserted before the closing bracket (inner closing), 〈oc-kern〉 after it (outer closing). embrac initially makes these definitions:
1 % add some defaults: 2 \AddEmph{[}{]}[.04em,-.12em] 3 \AddEmph{(}[-.04em]{)}[,-.15em]
This document however uses “Linux Libertine O” 3 both for the roman and the italic font and redefines them in this way (still not sure these are the best values):
1 \RenewEmph{[}[-0.045em,.02em]{]}[.055em,-.09em] 2 \ChangeEmph{(}[-.01em,.04em]{)}[.04em,-.05em]
You can change them as you wish, but be careful with the kerning! What’s too less for one letter might be too much for others:
- They’re also using different lists internally but you shouldn’t concern yourself with this.
- http://www.linuxlibertine.org/
5 Adding More Brackets & Adjusting the Kerning
1 \ChangeEmph{(}[.1em]{)}[.1em] 2 \emph{This is (just) emphasized text.} \par % looks OK, kind of 3 \emph{This is emphasized text (as you can see).} % looks bad
This is (just) emphasized text. This is emphasized text (as you can see).
To see why it is important to pay attention to the kerning values let’s look at how embrac’s features look without kerning (i. e., 0pt for each value), with the default settings and with the settings for this document:
No Kerning: This is emphasized [sic] text. This is emphasized text [as you can see]. This is emphasized (sic) text. This is emphasized text (as you can see). embrac’s Default Kerning: This is emphasized [sic] text. This is emphasized text [as you can see]. This is emphasized (sic)text. This is emphasized text (as you can see). Adjusted Kerning: This is emphasized [sic] text. This is emphasized text [as you can see]. This is emphasized (sic) text. This is emphasized text (as you can see). Deleting a pair removes it completely from embrac’s mechanism. All information about the pair and its kerning values will be lost. So if you want the effects to be temporary use grouping.
1 \DeleteEmph{[}{]} 2 \emph{This is emphasized [sic] text.} \par 3 \emph{This is emphasized text (as you can see).}
This is emphasized [sic] text. This is emphasized text (as you can see).
By the way: this packages provides a simple file embrac_kerning_test.tex for testing kerning values. You should find it in the same directory as this documentation.
9 Watch out!
\EmbracOn Turn embrac’s treatment on.
Both commands are local.
9 Watch out!
Please be aware that embrac does not affect \itshape nor \em (nor \it which you shouldn’t use in a LATEX document, anyway).
1 \itshape This is italic [sic] text.
This is italic [sic] text.
In cases like this one of the following commands could be used:
\emb{〈op〉}{〈cl〉}{〈text〉} Introduced in Encloses version 0.
〈text〉 with 〈op〉 and 〈cl〉. Both 〈op〉 and 〈cl〉 must be brackets known to embrac.
\embparen{〈text〉} Introduced in Encloses version 0.
〈text〉 with upright parentheses. This is the same as \emb{(}{)}{〈text〉}.
\embbracket{〈text〉} Introduced in Encloses version 0.
〈text〉 with upright brackets. This is the same as \emb{[}{]}{〈text〉}.
1 \itshape This is italic \embbracket{sic} text.
This is italic [sic] text.
10 Version History
v0.1a The command \RenewEmph has been renamed into \ChangeEmph and a new slightly different \RenewEmph has been added.
v0.2 Improved interaction with biblatex.
v0.3 Added support for fontspec’s \textsi.
References
v0.5 Don’t replace brackets in math mode.
v0.6 Added support for \textsl.
v0.7 Added support for symbols with a catcode other than 12.
v0.8 Added \embparen, \embbracket and \emb.
v0.9 Added \EmbracMakeKnown
References
[Bri04] Robert Bringhurst. The Elements of Typographic Style. Hartley & Marks, Canada, 2004. isbn: 978-0-88179-205-5.
[Flo11] Bruno Le Floch. Upright parentheses in italic text. Mar. 9, 2011. url: http://tex.stackexchange.com/a/13057/5049 (visited on 06/28/2012).
[L3Pa] The LATEX3 Project Team. l3kernel. Oct. 27, 2020 (or newer). url: https://www.ctan.org/pkg/l3kernel/.
[L3Pb] The LATEX3 Project Team. l3packages. Oct. 27, 2020 (or newer). url: https://www.ctan.org/pkg/l3packages/.
[Waß12] Dominik Wassenhoven. “Aufrechte Klammern in kursivem Text”. In: 2 (2012), pp. 51–53.
