summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/support/installfont/installfont.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/support/installfont/installfont.tex')
-rw-r--r--Master/texmf-dist/doc/support/installfont/installfont.tex206
1 files changed, 206 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/support/installfont/installfont.tex b/Master/texmf-dist/doc/support/installfont/installfont.tex
new file mode 100644
index 00000000000..483ce69d534
--- /dev/null
+++ b/Master/texmf-dist/doc/support/installfont/installfont.tex
@@ -0,0 +1,206 @@
+\documentclass[10pt,a4paper]{scrartcl}
+\usepackage[english]{babel}%
+\usepackage[latin1]{inputenc}%
+\usepackage[T1]{fontenc}%
+\usepackage{textcomp}%
+\usepackage{lmodern}%
+\usepackage{typewriter}%
+\usepackage{grenoble}%
+\usepackage[leading=1.1]{nashville}
+\usepackage{tabularx}
+\usepackage{booktabs}
+\usepackage{amsmath}
+\usepackage[symbol]{footmisc}
+\usepackage{endnotes}
+\usepackage{jkdoc}%
+\usepackage{microtype}
+\usepackage{hyperref}
+\hypersetup{breaklinks=true,pdfauthor={Josef Kleber},pdftitle={A bash script for installing a LaTeX font family},pdfsubject={Documentation for the installfont(-tl) script}}
+\renewcommand{\arraystretch}{1.2}
+\newcommand\Link[2]{\href{#1}{#2}\endnote{\href{#1}{\url{#1}}}}
+\makeatletter
+\newcommand\doubledash{-\kern2pt-}
+\def\enoteformat{\rightskip\z@ \leftskip\z@ \parindent=1em\leavevmode\llap{\makeenmark}}
+\makeatother
+\begin{document}
+\setlength{\parindent}{0pt}
+\setfnsymbol{wiley}
+\renewcommand\notesname{Links}
+\title{\texttt{installfont(-tl)}}
+\Subtitle{A bash script for installing a \LaTeX{} font family}
+\Fileversion{v1.5}
+\Authorline{Package authors:}
+\Author{Josef Kleber \and Christoph Bier (TeXLive version)}
+\Refline{\href{mailto:installfont@latex.josef-kleber.de}{\texttt{installfont@latex.josef-kleber.de}}\\\href{http://latex.josef-kleber.de/en_index.htm}{\texttt{http://latex.josef-kleber.de/en\_index.htm}}}
+\maketitle
+\Headline{Abstract}
+\vspace*{3cm}
+\begin{abstract}
+With this script\footnote{This script automates the procedure described in 'Tutorial I
+The Basics' in
+\href{ftp://dante.ctan.org/tex-archive/info/Type1fonts/fontinstallationguide/fontinstallationguide.pdf}{fontinstallationguide.pdf}}
+you can install a LaTeX font family (Postscript Type1, Truetype, Opentype). It supports font series from light to ultra bold + (faked) small caps + faked slanted, but no expert fonts. The script will rename the fonts automatically (optinal) or will otherwise expect *.afm files and the font files (in Postscript Type1 format!) named in the Karl Berry scheme (e.g. 5nar8a.pfb). After running the script, you should have a working font installation in your local TeX tree.
+\footnote{The Nashville, Grenoble and Typewriter font families in this document
+were installed with installfont}
+\end{abstract}
+\clearpage
+\setkomafont{sectioning}{\normalfont\normalcolor\FFNashville}
+\Headline{Dependencies}
+\section*{Dependencies}
+For using this script the following programms have to be installed:
+\begin{itemize}
+\item Windows
+\begin{itemize}
+\item \Link{http://www.miktex.org/}{MiKTeX} or \Link{http://www.tug.org/texlive/}{TeXLive}
+\item \Link{http://www.cygwin.com/}{cygwin} or any other *nix-like environment with the same funtionality
+
+Download \texttt{setup.exe} and follow the instructions on the \texttt{cygwin} homepage
+\item for installing fonts in other formats than Postscript Type1
+\begin{itemize}
+\item Truetype
+
+Download the \Link{http://gnuwin32.sourceforge.net/packages/ttf2pt1.htm}{ttf2pt1 Installer}, install \texttt{ttf2pt1} and add the installation directory to your \texttt{PATH}
+\item Opentype
+
+Download the \Link{ftp://akagi.ms.u-tokyo.ac.jp/pub/TeX/win32/lcdf-typetools-w32.tar.bz2}{LCDF Typetools} and run (bash/cygwin)\newline\texttt{bunzip2 lcdf-typetools-w32.tar.bz2} followed by \newline\texttt{tar -xf lcdf-typetools-w32.tar} and add the \texttt{bin} directory to the \texttt{PATH}. You need to install \Link{http://www.ghostscript.com/}{Ghostscript} if you are using TeXLive!
+\end{itemize}
+\end{itemize}
+\item *nix
+\begin{itemize}
+\item \Link{http://www.tug.org/texlive/}{TeXLive}
+\item Ghostscript (pf2afm)
+\item for installing fonts in other formats than Postscript Type1
+\begin{itemize}
+\item Truetype
+
+Install the \texttt{ttf2pt1} package with your distribution package manager or download a package from a \Link{http://packages.ubuntu.com/search?lang=en&keywords=ttf2pt1}{webpage}.
+\item Opentype
+
+Install the \texttt{lcdf-typetools} package with your distribution package manager or download a package from a \Link{http://packages.ubuntu.com/search?lang=en&keywords=lcdf-typetools}{webpage}.
+\end{itemize}
+\end{itemize}
+\end{itemize}
+
+You can also convert the font manually, e.g. with \Link{http://fontforge.sourceforge.net/}{Fontforge}. Load the font, reencode the font to 'Adobe Standard' and generate the font (PS Type1 (Binary)). There's a pre-built package for \texttt{cygwin}!
+\clearpage
+\Headline{The font(s)}
+\section*{The font(s)}
+The core part of the script needs the font(s) in Postscript Type1 format and named in Karl Berry scheme. It can try to convert and to rename the font(s) and afm files for you by analyzing the afm files. If it fails\footnote{feel free to contact the author, so that another search pattern can be added to \texttt{grep} command(s)} you will have to rename the font(s) and afm files on your own. The Karl Berry scheme expects a file to be named like this:
+
+\begin{center}
+\begin{tabular}{cccc}
+$\underbrace{\text{\strut fxx}}_{\text{font family}}$ & $\underbrace{\text{\strut y(y)}}_{\text{font cut}}$ & $\underbrace{\text{\strut zz}}_{\text{font encoding}}$ & .pfb
+\end{tabular}
+\end{center}
+
+
+with the following meaning:
+
+\begin{center}
+\begin{tabularx}{\linewidth}{rlX}
+f & supplier (type foundry) & p (Adobe), l (Linotype), f (small foundries, free), ...\\
+xx & typeface & tm (Times), ch (Charter), hv (Helvetica), ...\\
+y(y) & weights/variants & r~(regular/medium), ri~(regular/medium italic), rc~(regular/medium small caps), b~(bold), bi~(bold italic), bc~(bold small caps), l~(light), li~(light italic), s~(semi bold), si~(semi bold italic), d~(demi), di~(demi italic), x~(extra bold), xi~(extra bold italic), u~(ultra bold/heavy), ui~(ultra bold/heavy italic)\\
+zz & font encoding & 8a (AdobeStandardEncoding), 8r (\TeX\ base encoding), ...\\
+\end{tabularx}
+\end{center}
+
+The script supports the cuts presented in the table. Don't copy more than these cuts into your working directory, otherwise the automatic renaming will quite likely fail! It will add faked slanted cuts and faked small caps, if there are no real small caps fonts. If you only have one font cut, it will be installed as regular font. If you want more information about Karl Berry scheme read:
+
+\medskip\texttt{texdoc fontname}
+
+\Headline{Options}
+\section*{Options}
+
+The style file created with this script offers the following options:
+
+\begin{itemize}
+\item scaled
+
+You can use the option \texttt{scaled} for scaling the font to better match with other fonts.
+
+\item leading
+
+For some fonts it might be necessary to increase the leading between lines for a better optical impression, where 1.0 means 100\%. \texttt{\string\usepackage[leading=1.1]\{nash\-ville\}} was used in this document.
+\end{itemize}
+
+\Headline{Example (Nashville)}
+\section*{Example (Nashville)}
+
+\begin{center}
+\begin{tabular}{|l|c|c|c|c|}
+\hline
+\strut Family & Series & Shape(s) & Example of Typeface & Supported Encodings\\
+\hline
+6na & l & n & \fontfamily{6na}\fontseries{l}\fontshape{n}\selectfont Nashville Light & OT1, T1, TS1\\
+6na & l & it & \fontfamily{6na}\fontseries{l}\fontshape{it}\selectfont Nashville Light & OT1, T1, TS1\\
+6na & l & sl & \fontfamily{6na}\fontseries{l}\fontshape{sl}\selectfont Nashville Light & OT1, T1, TS1\\
+6na & l & sc & \fontfamily{6na}\fontseries{l}\fontshape{sc}\selectfont Nashville Light & OT1, T1, TS1\\
+6na & m & n & Nashville & OT1, T1, TS1\\
+6na & m & it & \fontfamily{6na}\fontseries{m}\fontshape{it}\selectfont Nashville & OT1, T1, TS1\\
+6na & m & sl & \fontfamily{6na}\fontseries{m}\fontshape{sl}\selectfont Nashville & OT1, T1, TS1\\
+6na & m & sc & \fontfamily{6na}\fontseries{m}\fontshape{sc}\selectfont Nashville & OT1, T1, TS1\\
+6na & b & n & \fontfamily{6na}\fontseries{b}\fontshape{n}\selectfont Nashville Bold & OT1, T1, TS1\\
+6na & b & it & \fontfamily{6na}\fontseries{b}\fontshape{it}\selectfont Nashville Bold & OT1, T1, TS1\\
+6na & b & sl & \fontfamily{6na}\fontseries{b}\fontshape{sl}\selectfont Nashville Bold & OT1, T1, TS1\\
+6na & b & sc & \fontfamily{6na}\fontseries{b}\fontshape{sc}\selectfont Nashville Bold & OT1, T1, TS1\\
+6na & eb & n & \fontfamily{6na}\fontseries{eb}\fontshape{n}\selectfont Nashville ExtraBold & OT1, T1, TS1\\
+6na & eb & it & \fontfamily{6na}\fontseries{eb}\fontshape{it}\selectfont Nashville ExtraBold & OT1, T1, TS1\\
+6na & eb & sl & \fontfamily{6na}\fontseries{eb}\fontshape{sl}\selectfont Nashville ExtraBold & OT1, T1, TS1\\
+6na & eb & sc & \fontfamily{6na}\fontseries{eb}\fontshape{sc}\selectfont Nashville ExtraBold & OT1, T1, TS1\\
+6na & ub & n & \fontfamily{6na}\fontseries{ub}\fontshape{n}\selectfont Nashville Heavy & OT1, T1, TS1\\
+6na & ub & it & \fontfamily{6na}\fontseries{ub}\fontshape{it}\selectfont Nashville Heavy & OT1, T1, TS1\\
+6na & ub & sl & \fontfamily{6na}\fontseries{ub}\fontshape{sl}\selectfont Nashville Heavy & OT1, T1, TS1\\
+6na & ub & sc & \fontfamily{6na}\fontseries{ub}\fontshape{sc}\selectfont Nashville Heavy & OT1, T1, TS1\\
+\hline
+\end{tabular}
+\end{center}
+\clearpage
+
+\Headline{Usage}
+\section*{Usage}
+
+The script offers the following command line options:
+
+\bigskip
+\begin{tabularx}{\linewidth}{llX}
+\texttt{-f} & \texttt{\doubledash fontfamily} & Name of the LaTeX font family, e.g. ptm (Adobe Times)\\
+\texttt{-n} & \texttt{\doubledash fontname} & Font name, e.g. Adobe Times\\
+\texttt{-c} & \texttt{\doubledash fontcommand} & Name of the command that will switch to the font\\
+\texttt{-P} & \texttt{\doubledash fontscaleprefix} & prefix of the scale macro, which should be different for each font (no digits allowed)\\
+\texttt{-t} & \texttt{\doubledash fonttype} & Font type (pst1(default)|ttf|otf)\\
+\texttt{-p} & \texttt{\doubledash packagename} & Name of the LaTeX package\\
+\texttt{-d} & \texttt{\doubledash packagedate} & Date of the LaTeX package\\
+\texttt{-v} & \texttt{\doubledash packageversion} & Version of the LaTeX package\\
+\texttt{-l} & \texttt{\doubledash localtexmf} & root of your local TeX tree, e.g. \newline\texttt{/cygdrive/c/LocalTeXMF}\newline (TeXLive version default: \texttt{\$TEXMFHOME)}\\
+\texttt{-s} & \texttt{\doubledash fontsubdir} & location where the fonts and support files should be installed, e.g. \texttt{MyFonts/AdobeTimes}\\
+\texttt{-e} & \texttt{\doubledash fontencoding} & encoding of the font (default: 8a (AdobeStandardEncoding))\\
+\texttt{-o} & \texttt{\doubledash otffontfeatures} & choosing Opentype font features (default: -fkern -fliga)\\
+\texttt{-m} & \texttt{\doubledash mapfilename} & file name of the map file (without .map)\\
+\texttt{-u} & \texttt{\doubledash uninstall} & will uninstall the font family. You must specify \mbox{\texttt{\doubledash localtexmf}} and \texttt{\doubledash fontsubdir}\\
+\texttt{-R} & \texttt{\doubledash rmdefault} & installs font family as roman (serif) font family (default)\\
+\texttt{-S} & \texttt{\doubledash sfdefault} & installs font family as sans serif font family\\
+\texttt{-T} & \texttt{\doubledash ttdefault} & installs font family as typewriter font family\\
+\texttt{-O} & \texttt{\doubledash origfontname} & use original font names instead of Karl Berry names\\
+\texttt{-a} & \texttt{\doubledash admin} & set administrative mode (MiKTeX v2.8+)\\
+\texttt{-V} & \texttt{\doubledash version} & will print the version number of the script\\
+\texttt{-h} & \texttt{\doubledash help} & will print this help statement\\
+\end{tabularx}
+
+\clearpage
+To install a font family simply call the script:
+
+\bigskip
+\texttt{kleberj@home \texttildelow{}/installfont\\\$ installfont -f 5na -n 'Softmaker Nashville' -c Nashville -P MF@Sna -p nash\-ville -m nashville -O -d 2010/09/14 -v v1.0 -l /cygdrive/d/LocalTeXMF -s MyFonts/Nashville}
+\bigskip
+
+You can also put a copy of the script in your working directory and change the default values of the script variables. Then you can simply call the script with
+
+\bigskip
+\texttt{kleberj@home \texttildelow{}/installfont\\\$ installfont}
+\bigskip
+
+After running the script the font(s) should be properly installed. You can use the font just with \texttt{\textbackslash{}usepackage\{PACKAGENAME\}} or \texttt{\textbackslash{}FONTCOMMAND}.
+
+\theendnotes
+\end{document}