You need to install Luaharfbuzz
first. It is best to use luarocks
option, as we can load it directly.
Run make install
to set correct paths in which luaharfbuzz
will be
searched. The library will be installed in yout local TEXMF tree.
This is just a proof of concept of using Harfbuzz library with LuaLaTeX. Context and Luaotfload tries to do glyph shaping with Lua functions, but it is lot of really hard work and complex scripts such as Arabic doesn't seem to be supported fully.
\documentclass{article}
\usepackage{harfbuzz}
\begin{document}
\font\libertine={Linux Libertine O} at 12pt
\libertine
\SetFontOption{features}{}
Normal text with Libertine: finance, grafika, 2015, 1/2
\SetFontOption{features}{+zero}
Zero: 2015
\SetFontOption{features}{+onum}
Oldstyle: 2015
\SetFontOption{features}{+frac}
Fractions: 1/2, 1/4
\SetFontOption{features}{+smcp}
Hello world in small caps
\font\italic={Linux Libertine O/I} at 12pt
\italic Text in italic font
\font\arabic={amiri:script=arab;language=ara} at 12pt
\libertine
\SetFontOption{features}{}
Arabic text
{\pardir TRT \textdir TRT
\arabic مقالة اليوم المختارة}
Kerning and features: VLTAVA finance
\stopharfbuzz Without shaping: VLTAVA finance
\end{document}
You can define font families which can be used in standard LaTeX commands such
as \textit
, \textbf
or \textsc
. The commands are:
\MainFamily[font options]{font name}
\SansFamily[font options]{font name}
\MonoFamily[font options]{font name}
example:
\documentclass{article}
\usepackage{harfbuzz}
\MainFamily[script=latn;+onum;]{TeX Gyre Termes}
\MonoFamily{Inconsolatazi4}
\begin{document}
\section{Section}
Ligatures: finance 12345 \textit{diacritics: příliš} {\itshape font switch}
\textsc{Small caps} \textit{\textbf{bold italic} italic} \texttt{monospace}
\begin{verbatim}
for k,v in ipairs(t) do print(k,v) end
\end{verbatim}
\[ \frac{\sqrt{a^2 +b ^ 2}}{c^2} \]
\end{document}
Fonts are loaded using Luaotfload
libraries, which means that you can use
fonts in both your system font directories and in TeX tree. Also, Luatfload
syntax
\font\fontname= {System font name/Style:features} at size
is supported.
Classical tfm
and vf
fonts are supported, but without any text shaping,
obviously. To enable text shaping, use \startharfbuzz
, to stop it, use
\stopharfbuzz
. Shaping is enabled by default.
You can set harfbuzz options with \SetFontOption
, most useful options are
features
, script
and language
. All values must be valid OpenType names.
See files in examples
directory for various examples of usage.
% Copyright 2015 Michal Hoftich
This work may be distributed and/or modified under the conditions of the LaTeX Project Public License, either version 1.3 of this license or (at your option) any later version. The latest version of this license is in http://www.latex-project.org/lppl.txt and version 1.3 or later is part of all distributions of LaTeX version 2005/12/01 or later.
This work has the LPPL maintenance status `maintained'.
The Current Maintainer of this work is Michal Hoftich