diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex/fontspec/README')
-rw-r--r-- | Master/texmf-dist/doc/latex/fontspec/README | 128 |
1 files changed, 128 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/fontspec/README b/Master/texmf-dist/doc/latex/fontspec/README new file mode 100644 index 00000000000..2ea58b73e4e --- /dev/null +++ b/Master/texmf-dist/doc/latex/fontspec/README @@ -0,0 +1,128 @@ +--------------------------- +THE FONTSPEC PACKAGE v2.0b1 + +This is the initial release of the fontspec package with support for LuaTeX. +(Previously, fontspec was XeTeX-only.) + +The fontspec package provides an automatic and unified interface for loading +fonts in LaTeX. XeTeX and LuaTeX (the latter through the luaotfload package) +allows a direct interface to fonts which may be loaded by their name rather +than filename, 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, ligature control, and many +others. + +This package is developed at GitHub: <http://github.com/wspr/fontspec> +Please offer suggestions and file bug reports in the issue tracker: + <http://github.com/wspr/fontspec/issues> + + +LuaTeX requirements +------------------- + +TeXLive 2010 is recommended for running this package under LuaTeX. + +This package requires the luaotfload package in order to load fonts in LuaTeX. +Version 1.08 or greater is recommended for this release. Please see +instructions in that package for font setup. That package, in turn, requires +a version of LuaTeX greater than that shipped with TeX Live 2009. + + +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 + + \newfontfamily\myfamily[<font options>]{<font name>} + \newfontface\myfont[<font options>]{<font name>} + +Default document fonts are selected with + + \setmainfont[<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>} + + + +Installation +------------ + +Here are the recommended installation methods (preferred first). + +1. If you are using TeX Live 2008 or later, use 'tlmgr install fontspec'. +Alternatively, try your (TeX or Linux) distribution's package management system. + +2. a. Grab euenc.tds.zip on the CTAN. + b. Unzip it at the root of one or your TDS trees. + c. You may need to update some filename database after, see your TeX + distribution's manual for details. + +3. a. Grab the sources from CTAN or github. + b. Run 'make install TEXMFROOT=/path/to/texmf'. + c. See 2c. + +4. Try to figure it out by looking at the Makefile and comments in the sources. + +5. For LuaTeX support you need luaotfload, it can be installed the same way. + + +Manifest +-------- + +Source files: + fontspec.dtx single file source & doc for the package + +Derived files: + fontspec.pdf. documentation + fontspec.sty LaTeX style file + fontspec.lua Lua functions for LuaTeX + fontspec.cfg default configuration file + fontspec-example.ltx LaTeX example document + + +License +------- + +Copyright 2004--2010 Will Robertson <wspr81@gmail.com> +Copyright 2009--2010 Khaled Hosny <khaledhosny@eglug.org> + +Distributable under the LaTeX Project Public License, +version 1.3c or higher (your choice). The latest version of +this license is at: http://www.latex-project.org/lppl.txt + +This work is "maintained" (as per LPPL maintenance status) +by Will Robertson. + |