summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r--Master/texmf-dist/doc/latex/horoscop/README84
-rw-r--r--Master/texmf-dist/doc/latex/horoscop/horoscop.pdfbin0 -> 696390 bytes
2 files changed, 84 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/horoscop/README b/Master/texmf-dist/doc/latex/horoscop/README
new file mode 100644
index 00000000000..0f1f53d116b
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/horoscop/README
@@ -0,0 +1,84 @@
+This is version 0.92 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.
+ * 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.
+
+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.
+
+CONTACT AND LINKS
+
+LaTeX astrology page: http://ansuz.sooke.bc.ca/entry/107
+GitHub repository: http://github.com/mskala/horoscop
+Online demo: http://ansuz.sooke.bc.ca/astrology/makechart.php
+
+Matthew Skala
+mskala@ansuz.sooke.bc.ca
+http://ansuz.sooke.bc.ca/
diff --git a/Master/texmf-dist/doc/latex/horoscop/horoscop.pdf b/Master/texmf-dist/doc/latex/horoscop/horoscop.pdf
new file mode 100644
index 00000000000..34bff09192f
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/horoscop/horoscop.pdf
Binary files differ