summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/fonts/starfont/starfont.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/fonts/starfont/starfont.tex')
-rw-r--r--Master/texmf-dist/doc/fonts/starfont/starfont.tex225
1 files changed, 225 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/fonts/starfont/starfont.tex b/Master/texmf-dist/doc/fonts/starfont/starfont.tex
new file mode 100644
index 00000000000..62ca9a2a9a4
--- /dev/null
+++ b/Master/texmf-dist/doc/fonts/starfont/starfont.tex
@@ -0,0 +1,225 @@
+\documentclass{article}
+
+\usepackage{starfont}
+\usepackage{url}
+\usepackage{hyperref}
+
+\newcommand{\showboth}[1]{\starfontsans #1 & \starfontserif #1}
+
+\begin{document}
+\title{The \texttt{starfont} package for \LaTeX, version 1.2}
+\author{Matthew Skala\thanks{\url{mailto:mskala@ansuz.sooke.bc.ca}}}
+\date{29 September 2010}
+\maketitle
+
+\section{Introduction}
+
+This package is designed to provide two fonts named StarFont Sans and
+StarFont Serif in \LaTeX. These fonts contain a wide variety of glyphs
+suitable for typesetting astrological documents. Astrological support in
+previous \LaTeX\ packages is inadequate for a number of reasons that include
+incomplete coverage of the popular glyph set, inconsistent style between
+glyphs that need to work well when used together, simply ugly glyphs, wide
+variation in widths of glyphs (which makes trouble in tables), no
+availability in outline form to make well-behaved PDFs, and so on. These
+glyphs aren't perfect either, but they are certainly the best ones I've
+found for typesetting astrological material in \LaTeX.
+
+Given the typical use of \LaTeX\ in the scientific community and the
+relationship between the scientific community and astrology, it amuses me to
+have \LaTeX\ used for astrology. It's also convenient because I write both
+astrological and scientific documents and want to use the same tools for
+both.
+
+This is version 1.2 of the package, adding support for StarFont Serif and
+changing the commentary on copying restrictions now that it's confirmed the
+fonts are public domain. Version 1.1 dated from 29~June 2006; version 1.0
+was never widely distributed but first existed around 2003 or 2004.
+
+The fonts were designed, and distributed in TrueType form, by
+Anthony~I.P. Owen. The packaging for TeX and LaTeX was done by Matthew
+Skala. Both these authors have released their contributions to the public
+domain. As such, the contents of this package are provided ``as is,'' with
+no warranties. See the file \texttt{COPYING} for more information.
+
+\section{Using \texttt{starfont}}
+
+Install the fonts. Installing fonts is a black art; I have included, in the
+\texttt{README} file, hints on where to put the files involved, but I do not
+really understand how \LaTeX\ (and \TeX, and \texttt{dvips}, and so on)
+finds font files and I cannot give meaningful instruction to others on it.
+
+The fonts should end up installed with the names ``\texttt{fstr8x}'' for
+StarFont Sans, and `\texttt{fsts8x}'' for StarFont Serif. The
+\texttt{starfont} package defines NFSS families named ``\texttt{stf}'' and
+`\texttt{sts}''. The general approach used imitates the way the
+\texttt{marvosym} package works, and this package is to some degree
+compatible with \texttt{marvosym}.
+
+StarFont Sans is the default and recommended choice; I believe it mixes
+better with other fonts typically used in \LaTeX\ documents. However, the
+StarFont Serif version is also available via the \texttt{starfontserif}
+package option. A corresponding \texttt{starfontsans} option will be
+accepted for clarity but has no actual effect because the Sans version is
+default anyway. These options have verbose names to make it easier for them
+to inherit from a higher-level package like my \texttt{horoscop} package.
+You can also switch between the two styles inside a document using the
+\verb|\starfontsans| and \verb|\starfontserif| macros; each of these will
+change the mode for any subsequent uses of the character macros below. Both
+are shown in the sample tables below.
+
+\subsection{Luminaries and traditional planets}
+
+Here are the basics:
+
+\begin{tabular}{llll|llll}
+\verb|\Sun| & \showboth{\Sun} & Sun &
+ \verb|\Jupiter| & \showboth{\Jupiter} & Jupiter \\
+\verb|\Moon| & \showboth{\Moon} & Moon &
+ \verb|\Saturn| & \showboth{\Saturn} & Saturn \\
+\verb|\Mercury| & \showboth{\Mercury} & Mercury &
+ \verb|\Uranus| & \showboth{\Uranus} & Uranus \\
+\verb|\Venus| & \showboth{\Venus} & Venus &
+ \verb|\Neptune| & \showboth{\Neptune} & Neptune \\
+\verb|\Terra| & \showboth{\Terra} & Earth (planet) &
+ \verb|\Pluto| & \showboth{\Pluto} & Pluto \\
+\verb|\Mars| & \showboth{\Mars} & Mars
+\end{tabular}
+
+The planet Earth is referred to as ``Terra'' in the command name to
+prevent a collision with the glyph for the element Earth. Since the
+element is much more commonly referred to in astrology than the
+planet, it takes precedence for the more straightforward name. There
+are also variants of some of these glyphs:
+
+\begin{tabular}{llll|llll}
+\verb|\varMoon| & \showboth{\varMoon} & Moon &
+ \verb|\varUranus| & \showboth{\varUranus} & Uranus \\
+\verb|\varTerra| & \showboth{\varTerra} & Earth (planet) &
+ \verb|\varPluto| & \showboth{\varPluto} & Pluto
+\end{tabular}
+
+\subsection{Signs of the zodiac}
+
+\begin{tabular}{llll|llll}
+\verb|\Aries| & \showboth{\Aries} & Aries &
+ \verb|\Libra| & \showboth{\Libra} & Libra \\
+\verb|\Taurus| & \showboth{\Taurus} & Taurus &
+ \verb|\Scorpio| & \showboth{\Scorpio} & Scorpio \\
+\verb|\Gemini| & \showboth{\Gemini} & Gemini &
+ \verb|\Sagittarius| & \showboth{\Sagittarius} & Sagittarius \\
+\verb|\Cancer| & \showboth{\Cancer} & Cancer &
+ \verb|\Capricorn| & \showboth{\Capricorn} & Capricorn \\
+\verb|\Leo| & \showboth{\Leo} & Leo &
+ \verb|\Aquarius| & \showboth{\Aquarius} & Aquarius \\
+\verb|\Virgo| & \showboth{\Virgo} & Virgo &
+ \verb|\Pisces| & \showboth{\Pisces} & Pisces
+\end{tabular}
+
+The command
+\verb|\varCapricorn| produces ``\varCapricorn'' or
+``\starfontserif\varCapricorn,'' a variant symbol for
+Capricorn. This package also
+provides a \verb|\Zodiac| command similar to the one in \texttt{marvosym}:
+\verb|\Zodiac{1}|\ldots\verb|\Zodiac{12}| produce
+\starfontsans\Zodiac{1}\ldots\Zodiac{12} or
+\starfontserif\Zodiac{1}\ldots\Zodiac{12}.
+
+\subsection{Asteroids}
+
+\begin{tabular}{llll|llll}
+\verb|\Ceres| & \showboth{\Ceres} & Ceres &
+ \verb|\Amor| & \showboth{\Amor} & Amor \\
+\verb|\Pallas| & \showboth{\Pallas} & Pallas &
+ \verb|\Eros| & \showboth{\Eros} & Eros \\
+\verb|\Juno| & \showboth{\Juno} & Juno &
+ \verb|\Hidalgo| & \showboth{\Hidalgo} & Hidalgo \\
+\verb|\Vesta| & \showboth{\Vesta} & Vesta &
+ \verb|\Hygiea| & \showboth{\Hygiea} & Hygiea \\
+\verb|\Chiron| & \showboth{\Chiron} & Chiron &
+ \verb|\Psyche| & \showboth{\Psyche} & Psyche \\
+& & & & \verb|\Sappho| & \showboth{\Sappho} & Sappho
+\end{tabular}
+
+\subsection{Uranian hypothetical planets}
+
+\begin{tabular}{llll|llll}
+\verb|\Cupido| & \showboth{\Cupido} & Cupido &
+ \verb|\Apollon| & \showboth{\Apollon} & Apollon \\
+\verb|\Hades| & \showboth{\Hades} & Hades &
+ \verb|\Admetos| & \showboth{\Admetos} & Admetos \\
+\verb|\Zeus| & \showboth{\Zeus} & Zeus &
+ \verb|\Vulkanus| & \showboth{\Vulkanus} & Vulkanus \\
+\verb|\Kronos| & \showboth{\Kronos} & Kronos &
+ \verb|\Poseidon| & \showboth{\Poseidon} & Poseidon
+\end{tabular}
+
+\subsection{Derived points}
+
+\begin{tabular}{llll|llll}
+\verb|\NorthNode| & \showboth{\NorthNode} & North~Node &
+ \verb|\SouthNode| & \showboth{\SouthNode} & Sout~Node \\
+\verb|\Lilith| & \showboth{\Lilith} & Lilith &
+ \verb|\Fortune| & \showboth{\Fortune} & Fortune
+\end{tabular}
+
+\subsection{Aspects}
+
+\begin{tabular}{llll|llll}
+\verb|\Conjunction| & \showboth{\Conjunction} & Conjunction &
+ \verb|\Quincunx| & \showboth{\Quincunx} & Quincunx \\
+\verb|\Opposition| & \showboth{\Opposition} & Opposition &
+ \verb|\Semisextile| & \showboth{\Semisextile} & Semisextile \\
+\verb|\Trine| & \showboth{\Trine} & Trine &
+ \verb|\Semisquare| & \showboth{\Semisquare} & Semisquare \\
+\verb|\Square| & \showboth{\Square} & Square &
+ \verb|\Sesquiquadrate| & \showboth{\Sesquiquadrate} & Sesquiquadrate \\
+\verb|\Sextile| & \showboth{\Sextile} & Sextile
+\end{tabular}
+
+\subsection{Angles}
+
+\begin{tabular}{llll|llll}
+\verb|\ASC| & \showboth{\ASC} & Ascendant &
+ \verb|\DSC| & \showboth{\DSC} & Descendant \\
+\verb|\MC| & \showboth{\MC} & Midheaven &
+ \verb|\IC| & \showboth{\IC} & Nadir \\
+ & & & (Medium C\oe li) & & & & (Imum C\oe li) \\
+\verb|\Vertex| & \showboth{\Vertex} & Vertex &
+ \verb|\EastPoint| & \showboth{\EastPoint} & East Point
+\end{tabular}
+
+\subsection{Directions}
+
+\begin{tabular}{llll|llll}
+\verb|\Retrograde| & \showboth{\Retrograde} & Retrograde &
+ \verb|\Station| & \showboth{\Station} & Station \\
+\verb|\Direct| & \showboth{\Direct} & Direct
+\end{tabular}
+
+\subsection{Elements}
+
+\begin{tabular}{llll|llll}
+\verb|\Fire| & \showboth{\Fire} & Fire &
+ \verb|\Earth| & \showboth{\Earth} & Earth (element) \\
+\verb|\Air| & \showboth{\Air} & Air &
+ \verb|\Water| & \showboth{\Water} & Water
+\end{tabular}
+
+\subsection{Other symbols}
+
+\begin{tabular}{llll|llll}
+\verb|\Natal| & \showboth{\Natal} & Natal &
+ \verb|\Radix| & \showboth{\Radix} & Radix \\
+\verb|\Pentagram| & \showboth{\Pentagram}
+\end{tabular}
+
+There are many other symbols in the font which I don't recognize,
+including a bunch that are probably from Cosmobiology. It should be
+possible to add them easily enough by following the examples in
+\texttt{starfont.sty}. There is an encoding table (made by
+\texttt{testfont.tex}) provided in the file \texttt{table.pdf}. I
+would appreciate hearing from readers who know of good names for the
+unknown symbols.
+
+\end{document}