Directory macros/latex/contrib/horoscop

This is version 1.01 of the horoscop package for typesetting astrological
charts in LaTeX.

Features include:

  * A unified interface for astrological symbols/glyphs, supporting three
    different astrological fonts as well as text abbreviations and Unicode
    astrological symbol code points.
  * Support for invoking Astrolog or Swiss Ephemeris to calculate charts. 
    Positions can also be specified manually. 
  * Loading and saving object and cusp positions into TeX macros. 
  * Typesetting of angles and positions as text. 
  * Ready-made templates for basic wheel charts, dial charts including
    multi-dials with up to four sets of objects, and decorative wheel
    charts. 
  * Optional variations of the standard templates:  aspect webs,
    highlighting for angular cusps, choice of what to include in object
    labels, and house labels inside the houses. 
  * Low-level graphics functions for plotting in polar coordinates and
    building new templates. 
  * Labels move, and where necessary houses expand, to prevent crowding. 
  * Smart rounding of angles for display. 

FILES IN THIS PACKAGE

README       - this documentation file
horoscop.dtx - documentation and style file (to be unpacked by horoscop.ins)
horoscop.ins - installation driver file
horoscop.pdf - precompiled documentation

This is a LaTeX package distributed in the traditional dtx/ins format.
Run TeX on the horoscop.ins file to extract the file horoscop.sty, which is
the package file used by LaTeX, from the combined code/documentation file
horoscop.dtx; run LaTeX on horoscop.dtx directly to typeset the
documentation.

Typesetting the documentation is not trivial; you will need all of
horoscop's dependencies, and (for really correct results) also two runs of
makeindex on the "glossary" and "index" files, and an extra run of LaTeX to
resolve links, *and* you will need to run LaTeX with shell escapes enabled
and on a system where Swiss Ephemeris is installed and working.  You are
probably better off to just read the precompiled PDF file.

DEPENDENCIES

Typesetting chart wheels requires the pict2e package (i.e. a version of it
that actually works and is not just a placeholder).  This package seems to
have been introduced in 2011 - horoscop long predates it but was much more
annoying to use before the update.  As a result of this dependency, this
version may not work on some older installations of LaTeX.

Chart *calculation* (i.e. computing the locations of the planets and other
objects based on a native's time and place of birth) requires running with
shell escapes enabled (not the default, and somewhat dangerous) and an
installation of either Swiss Ephemeris (http://www.astro.com/swisseph/) or
Astrolog (http://www.astrolog.org/astrolog.htm).  Without either of those
things, it is still possible to typeset charts, but you must do the
calculations and enter the object positions manually or write your own
software for it.  Chart calculation with external software has only been
tested under Linux, but there is no reason it shouldn't work on other
systems.

Typesetting astrological symbols requires an appropriate font.  The horoscop
package can work with the marvosym, wasysym, and starfont LaTeX packages,
with varying quality in the results; starfont is recommended and default. 
It can also use text-only substitutes if none of those packages are
available, or in XeLaTeX or LuaTeX it can use Unicode code points, in which
case font management to typeset those code points is left to the TeX
enginge to resolve.

Other, less significant, dependencies may exist; consult the PDF manual.

PUBLIC DOMAIN

The horoscop package is public domain.  External calculation software might
not be; you are responsible for any relevant licensing issues for any other
software you use.

LINKS AND TUG 2016 PRESENTATION

LaTeX astrology page:  https://ansuz.sooke.bc.ca/entry/107
Online demo:           https://edifyingfellowship.org/astro/

Skala, M. 2016.  Astrological charts with horoscop and starfont.  TUGboat,
37(2):p. 182.  Proceedings of the 37th Annual Meeting of the TeX Users
Group (TUG 2016), Toronto, Ontario, July 25-27, 2016.

PDF from proceedings:  https://tug.org/TUGboat/tb37-2/tb116skala.pdf
PDF of slides:         https://tug.org/tug2016/slides/skala.pdf
Video of talk: http://zeeba.tv/astrological-charts-with-horoscop-and-starfont/

CONTACT

Matthew Skala
mskala@ansuz.sooke.bc.ca
https://ansuz.sooke.bc.ca/