summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/xetex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2006-06-19 22:49:18 +0000
committerKarl Berry <karl@freefriends.org>2006-06-19 22:49:18 +0000
commit446616af78c68a47b3851065c2121bab5a96ad53 (patch)
treed0d19399424d93ae6e99d635428049ce428f475a /Master/texmf-dist/doc/xetex
parent315f6e8cf21d3f57aaefe05b58147de728d5ede0 (diff)
fontspec update, and put under xetex
git-svn-id: svn://tug.org/texlive/trunk@1706 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/xetex')
-rw-r--r--Master/texmf-dist/doc/xetex/fontspec/README48
-rw-r--r--Master/texmf-dist/doc/xetex/fontspec/fontspec-example.tex55
-rw-r--r--Master/texmf-dist/doc/xetex/fontspec/fontspec.pdfbin0 -> 1971940 bytes
3 files changed, 103 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/xetex/fontspec/README b/Master/texmf-dist/doc/xetex/fontspec/README
new file mode 100644
index 00000000000..b9f6e1b014b
--- /dev/null
+++ b/Master/texmf-dist/doc/xetex/fontspec/README
@@ -0,0 +1,48 @@
+--------------------------
+THE FONTSPEC PACKAGE v1.10
+
+The fontspec package only works with XeTeX, a unicode capable TeX-variant. It provides an automatic and unified interface for loading fonts in LaTeX. XeTeX allows a direct interface to system-installed fonts, so no manual font installation is required.
+
+This package also provides access to the large number of font features available with AAT and OpenType fonts, including upper and lower case numbers, proportional and monospaced numbers, swash letters, vulgar fractions, ligature control, and many others.
+
+It also provides an interface to set the XeTeX font mappings, font colour, relative font scaling, inter-word space scaling, and more.
+
+------------------------
+SUMMARY OF USER COMMANDS
+
+Font families may be selected individually with the command
+ \fontspec[<font options>]{<font name>}
+
+Commands for selecting fonts efficiently can be created with
+ \newfontinstance\myfont[<font options>]{<font name>}
+
+Default document fonts are selected with
+ \setromanfont[<font options>]{<font name>}
+ \setsansfont[<font options>]{<font name>}
+ \setmonofont[<font options>]{<font name>}
+
+Fonts to be used in maths are defined with
+ \setmathrm[<font options>]{<font name>}
+ \setmathsf[<font options>]{<font name>}
+ \setmathtt[<font options>]{<font name>}
+ \setboldmathrm[<font options>]{<font name>}
+
+Features to be used for every subsequently defined font are specified with
+ \defaultfontfeatures{<default font options>}
+
+Features may be added to the font currently in use with
+ \addfontfeatures{<font options to add>}
+ \addfontfeature{<...>} does the same thing
+
+Features not provided for out of the box may be defined with
+ \newAATfeature{<feature tag>}{<feature code>}{<selector code>}
+ \newICUfeature{<feature tag>}{[+|-]<4 letter feature string>}
+ \newfontfeature{<feature tag>}{<arbitrary XeTeX font options>}
+
+Features can be renamed and feature options can be renamed with
+ \aliasfontfeature{<current feature>}{<new feature>}
+ \aliasfontfeatureoption{<feature>}{<current option>}{<new option>}
+
+--------------
+Will Robertson
+2006 \ No newline at end of file
diff --git a/Master/texmf-dist/doc/xetex/fontspec/fontspec-example.tex b/Master/texmf-dist/doc/xetex/fontspec/fontspec-example.tex
new file mode 100644
index 00000000000..2aed92a6fc3
--- /dev/null
+++ b/Master/texmf-dist/doc/xetex/fontspec/fontspec-example.tex
@@ -0,0 +1,55 @@
+
+\documentclass[12pt]{article}
+
+\usepackage{euler,fontspec,graphicx}
+
+\defaultfontfeatures{Scale=MatchLowercase ,Mapping=tex-text}
+\setromanfont{Hoefler Text}
+\setsansfont{Gill Sans}
+\setmonofont{Lucida Sans Typewriter}
+
+%% Define the \XeTeX logo:
+\DeclareRobustCommand\XeTeX{%
+ \mbox{\smash{%
+ X\lower.5ex\hbox{\kern-.12em\reflectbox{E}}\kern-.1667em
+ T\kern -.1667em\lower .5ex\hbox {E}\kern -.12em X}}\@}
+%% The logo should be defined on a per-document basis
+%% so that its parameters may be fine tuned for the fonts used.
+
+\begin{document}
+\pagestyle{empty}
+
+\section{The basics of the \textsf{fontspec} package}
+
+The \textsf{fontspec} package enables automatic font selection for \LaTeX{} documents typeset with \XeTeX{}. The basic command is\\
+\indent \verb|\fontspec[font features]{Mac OS X font display name}|.\\
+As an example:
+
+\begin{center}
+ \Large
+ \fontspec[
+ Colour = 0000CC,
+ Numbers = OldStyle,
+ VerticalPosition = Ordinal,
+ Variant = 2
+ ]{Apple Chancery}
+ My 1st example of Apple Chancery
+\end{center}
+
+The default roman, sans serif, and typewriter fonts may be set with the \verb|\setromanfont|, \verb|\setsansfont| and \verb|\setmonofont| commands, respectively, as shown in the preamble. They take the same syntax as the \verb|\fontspec| package. All expected font shapes are available:
+
+\begin{center}
+ {\scshape Small caps and \itshape small caps italic\dots}\\
+ {\sffamily\bfseries Bold sans serif and \itshape bold italic sans serif\dots}
+\end{center}
+
+With the roman and sans serif fonts set in the preamble, text fonts in math mode are also changed: $\cos(n\pi)=\pm 1$. The maths typeface `Euler' has been used in this document (with the \textsf{euler} package---note that the \textsf{eulervm} package will not work in \XeTeX{} because it uses virtual fonts), since the default Computer Modern maths font is rather light.
+\[
+ \mathcal F(s) = \int^\infty_0\! f(t) e^{-st}\,\mathrm{d}t
+\]
+
+You'll also notice the \verb|\defaultfontfeatures| command in the preamble. This command takes a single argument of font features that are then applied to every subsequent instance of font selection. The first argument in this case, \verb|Mapping=tex-text|, enables regular \TeX{} ligatures like \verb|``---''| for ``---''. The second automatically scales the fonts to the same x-height.
+
+Please see the documentation for font feature explanation and further package niceties.
+
+\end{document}
diff --git a/Master/texmf-dist/doc/xetex/fontspec/fontspec.pdf b/Master/texmf-dist/doc/xetex/fontspec/fontspec.pdf
new file mode 100644
index 00000000000..b9a50832149
--- /dev/null
+++ b/Master/texmf-dist/doc/xetex/fontspec/fontspec.pdf
Binary files differ