Add basic documentation
This commit is contained in:
parent
91d0836020
commit
2b44130235
|
|
@ -0,0 +1,58 @@
|
|||
<page xmlns="http://projectmallard.org/1.0/"
|
||||
xmlns:its="http://www.w3.org/2005/11/its"
|
||||
xmlns:xi="http://www.w3.org/2001/XInclude"
|
||||
type="guide" style="2column task"
|
||||
id="chart-parts">
|
||||
<info>
|
||||
<revision version="0.1" date="2014-09-27" status="candidate"/>
|
||||
<link type="guide" xref="index#chart-reading"/>
|
||||
|
||||
<credit type="author copyright">
|
||||
<name>Gergely Polonkai</name>
|
||||
<email its:translate="no">gergely@polonkai.eu</email>
|
||||
<years>2013-2014</years>
|
||||
</credit>
|
||||
|
||||
<xi:include href="legal.xml"/>
|
||||
|
||||
<desc>Parts of a natal chart</desc>
|
||||
</info>
|
||||
|
||||
<title>Parts of a natal chart</title>
|
||||
|
||||
<section>
|
||||
<title>The chart wheel</title>
|
||||
<p>The chart wheel consists of several rings.</p>
|
||||
|
||||
<list>
|
||||
<item><p>The outermost ring hold the <link xref="#planets">planets</link>.</p></item>
|
||||
<item><p>The next ring shows the symbols of the zodiac.</p></item>
|
||||
<item><p>The third ring holds the degree signs. The longest lines denote each 10°, the mid-sized ones appear at every 5°, and the small ones show every 1°.</p></item>
|
||||
<item><p>The next ring is the most wide, giving place for the <link xref="#aspects">aspect and antiscion lines</link>.</p></item>
|
||||
<item><p>The fifth ring contains the house numbers.</p></item>
|
||||
<item><p>The innermost ring contains the <link xref="#moon">Moon phase</link> at the time of the chart.</p></item>
|
||||
</list>
|
||||
</section>
|
||||
|
||||
<section id="planets">
|
||||
<title>Planets</title>
|
||||
|
||||
<p>The planets’ ring shows all the planets included in the current <link xref="display-themes">display theme</link>.</p>
|
||||
</section>
|
||||
|
||||
<section id="aspects">
|
||||
<title>Aspects and antiscia</title>
|
||||
|
||||
<p>Depending on the user’s choice, the fourth ring of the chart holds the aspect or the antiscion lines.</p>
|
||||
|
||||
<p>Aspect lines are color coded: green lines mark the harmonic, red lines the disharmonic aspects.</p>
|
||||
|
||||
<note><p>Neither the naming nor the categories are cast into stone. Some astrologer schools state that an aspect may be harmonic or disharmonic based on the planets involve.</p></note>
|
||||
</section>
|
||||
|
||||
<section id="moon">
|
||||
<title>The Moon phase</title>
|
||||
|
||||
<p>The innermost circle depicts the Moon at the time of the chart. Most schools never inspect this aspect of a moment, as they don’t think it has any impact on the person’s life. We included this information merely for educational reasons.</p>
|
||||
</section>
|
||||
</page>
|
||||
|
|
@ -5,7 +5,7 @@
|
|||
id="display-themes">
|
||||
<info>
|
||||
<revision version="0.1" date="2013-09-22" status="candidate" />
|
||||
<link type="guide" xref="index" />
|
||||
<link type="guide" xref="index#customization" />
|
||||
|
||||
<credit type="author copyright">
|
||||
<name>Gergely Polonkai</name>
|
||||
|
|
@ -15,8 +15,31 @@
|
|||
|
||||
<xi:include href="legal.xml" />
|
||||
|
||||
<desc>Choosing the right display theme</desc>
|
||||
<desc>Using display themes</desc>
|
||||
</info>
|
||||
|
||||
<title>Choosing the right display theme</title>
|
||||
|
||||
<p><app>Astrognome</app> has the concept of display themes. A display theme is a ruleset of which planets, aspects and antiscia should the chart view and the table views show.</p>
|
||||
|
||||
<p><app>Astrognome</app> has three built in themes:</p>
|
||||
|
||||
<terms>
|
||||
<item>
|
||||
<title>Everything</title>
|
||||
<p>This displays everything <app>Astrognome</app> knows about: each planet, comet, theoretical/imaginary points, everything.</p>
|
||||
</item>
|
||||
|
||||
<item>
|
||||
<title>Classic</title>
|
||||
<p>This is the classic view, used by the early astrologers. It shows planets only up to Saturn, and uses only the Ptolemaic (major) aspects. Also, it doesn’t show any antiscia.</p>
|
||||
</item>
|
||||
|
||||
<item>
|
||||
<title>No comets</title>
|
||||
<p>This is the same as Everything, except it doesn’t include the comets and dwarf planets (<app>Astrognome</app>, like most astrologers, treat Pluto as a planet, not a dwarf).</p>
|
||||
</item>
|
||||
</terms>
|
||||
|
||||
<p>You can choose the right display theme with the display theme chooser above the chart, or change the default display theme in the <link xref="preferences">Preferences</link> dialog.</p>
|
||||
</page>
|
||||
|
|
|
|||
|
|
@ -5,7 +5,7 @@
|
|||
id="image-export">
|
||||
<info>
|
||||
<revision version="0.1" date="2013-09-22" status="candidate" />
|
||||
<link type="guide" xref="index" />
|
||||
<link type="guide" xref="index#getting-started" />
|
||||
|
||||
<credit type="author copyright">
|
||||
<name>Gergely Polonkai</name>
|
||||
|
|
@ -15,8 +15,18 @@
|
|||
|
||||
<xi:include href="legal.xml" />
|
||||
|
||||
<desc>Exporting images</desc>
|
||||
<desc>Exporting images of charts</desc>
|
||||
</info>
|
||||
|
||||
<title>Exporting images</title>
|
||||
|
||||
<p><app>Astrognome</app> can save your natal charts in different image formats:</p>
|
||||
|
||||
<list>
|
||||
<item><p>SVG (vectorized, also used internally by <app>Astrognome</app>)</p></item>
|
||||
<item><p>JPEG</p></item>
|
||||
<item><p>PNG</p></item>
|
||||
</list>
|
||||
|
||||
<p>To use this feature, use <guiseq><gui style="button">Gear menu</gui> <gui style="menuitem">Export as image…</gui></guiseq>.</p>
|
||||
</page>
|
||||
|
|
|
|||
|
|
@ -19,5 +19,23 @@
|
|||
<desc>Astrologers' software</desc>
|
||||
</info>
|
||||
|
||||
<title>Astrognome Help</title>
|
||||
<title>
|
||||
<media type="image" mime="image/png" its:translate="no" src="figures/astrognome-icon.png">
|
||||
</media>
|
||||
Astrognome Help
|
||||
</title>
|
||||
|
||||
<section id="getting-started" style="2column">
|
||||
<title>Getting started</title>
|
||||
</section>
|
||||
|
||||
<section id="chart-reading" style="2column">
|
||||
<title>Reading the charts</title>
|
||||
|
||||
<note><p>Every astrologer inspects and reads charts in different ways. The goal of this section is not to teach the users of such a technique, but to describe the different parts of the charts generated by <app>Astrognome</app>.</p></note>
|
||||
</section>
|
||||
|
||||
<section id="customization" style="2column">
|
||||
<title>Customization</title>
|
||||
</section>
|
||||
</page>
|
||||
|
|
|
|||
|
|
@ -16,10 +16,19 @@
|
|||
|
||||
<xi:include href="legal.xml" />
|
||||
|
||||
<desc>What is <app>Astrognome</app>?</desc>
|
||||
<desc>Introduction</desc>
|
||||
</info>
|
||||
|
||||
<title>Introduction</title>
|
||||
|
||||
<p><app>Astrognome</app> is an astrologers' software for the GNOME Desktop.</p>
|
||||
<p><app>Astrognome</app> is an astrologers’ software for the GNOME Desktop which can be used to create natal charts.</p>
|
||||
|
||||
<p><app>Astrognome</app> can display positions of the Solar System’s planets and several comets and theoretical/imaginary points on the sky (see also <link xref="chart-parts"/>.</p>
|
||||
|
||||
<figure>
|
||||
<title>Astrognome</title>
|
||||
<desc>Screenshot of Astrognome</desc>
|
||||
<media type="image" src="figures/astrognome.png" width="700">
|
||||
</media>
|
||||
</figure>
|
||||
</page>
|
||||
|
|
|
|||
|
|
@ -5,7 +5,7 @@
|
|||
id="keyboard-navigation">
|
||||
<info>
|
||||
<revision version="0.1" date="2013-09-22" status="candidate" />
|
||||
<link type="guide" xref="index" />
|
||||
<link type="guide" xref="index#getting-started" />
|
||||
|
||||
<credit type="author copyright">
|
||||
<name>Gergely Polonkai</name>
|
||||
|
|
@ -19,4 +19,33 @@
|
|||
</info>
|
||||
|
||||
<title>Navigating with the keyboard</title>
|
||||
|
||||
<p>You can switch between views with predefined keys:</p>
|
||||
|
||||
<terms>
|
||||
<item>
|
||||
<title>List view</title>
|
||||
<p><keyseq><key>Alt</key><key>Left Arrow</key></keyseq>, or if your keyboard has one, <key>Back</key>. Naturally, this will do nothing in the list view.</p>
|
||||
</item>
|
||||
|
||||
<item>
|
||||
<title>Chart edit</title>
|
||||
<p><key>F4</key>. This, and the following keys only work if a chart is loaded (e.g. not in the list view).</p>
|
||||
</item>
|
||||
|
||||
<item>
|
||||
<title>Chart view</title>
|
||||
<p><key>F5</key></p>
|
||||
</item>
|
||||
|
||||
<item>
|
||||
<title>Aspect and antiscion tables</title>
|
||||
<p><key>F6</key></p>
|
||||
</item>
|
||||
|
||||
<item>
|
||||
<title>Point tables</title>
|
||||
<p><key>F7</key></p>
|
||||
</item>
|
||||
</terms>
|
||||
</page>
|
||||
|
|
|
|||
|
|
@ -5,7 +5,7 @@
|
|||
id="preferences">
|
||||
<info>
|
||||
<revision version="0.1" date="2013-09-22" status="candidate" />
|
||||
<link type="guide" xref="index" />
|
||||
<link type="guide" xref="index#customization" />
|
||||
|
||||
<credit type="author copyright">
|
||||
<name>Gergely Polonkai</name>
|
||||
|
|
@ -19,4 +19,30 @@
|
|||
</info>
|
||||
|
||||
<title>Preferences</title>
|
||||
|
||||
<p>You can set different aspects of <app>Astrognome</app> in the Preferences dialog, which is accessible by pressing <keyseq><key>Ctrl</key><key>P</key></keyseq>, or from <guiseq><gui style="menu">Astrognome</gui> <gui style="menuitem">Preferences</gui></guiseq>.</p>
|
||||
|
||||
<note><p>All settings, except the default house system and default display theme have immediate effects in all open Astrognome windows.</p></note>
|
||||
|
||||
<section>
|
||||
<title>New windows start maximized</title>
|
||||
|
||||
<p>If this option is enabled, newly created windows will be maximized by default.</p>
|
||||
</section>
|
||||
|
||||
<section>
|
||||
<title>Use UTF-8 characters for planet/aspect symbols</title>
|
||||
<p>The <link href="http://en.wikipedia.org/wiki/List_of_Unicode_characters">UTF-8 standard</link> lists several planet and aspect symbols. If you want to see these characters in the aspect, antiscion and point tables, check this box</p>
|
||||
</section>
|
||||
|
||||
<section>
|
||||
<title>Default house system</title>
|
||||
<p>The house system to use by default in new charts.</p>
|
||||
<note><p><app>Astrognome</app> saves the house system information with every chart. This means if you load a chart, that saved house system will be used instead of the default one.</p></note>
|
||||
</section>
|
||||
|
||||
<section>
|
||||
<title>Default display theme</title>
|
||||
<p>The default <link xref="display-themes">display theme</link> to use in newly opened charts.</p>
|
||||
</section>
|
||||
</page>
|
||||
|
|
|
|||
|
|
@ -5,7 +5,7 @@
|
|||
id="your-first-chart">
|
||||
<info>
|
||||
<revision version="0.1" date="2013-09-22" status="candidate" />
|
||||
<link type="guide" xref="index" />
|
||||
<link type="guide" xref="index#getting-started" />
|
||||
|
||||
<credit type="author copyright">
|
||||
<name>Gergely Polonkai</name>
|
||||
|
|
@ -15,8 +15,21 @@
|
|||
|
||||
<xi:include href="legal.xml" />
|
||||
|
||||
<desc>Your first chart</desc>
|
||||
<desc>Creating natal charts</desc>
|
||||
</info>
|
||||
|
||||
<title>Your first chart</title>
|
||||
|
||||
<p>Creating a natal chart is as easy as pressing <keyseq><key>Ctrl</key><key>N</key></keyseq> (or using either <guiseq><gui style="menu">Astrognome</gui> <gui style="menuitem">New chart</gui></guiseq>) and entering a name, a date and a location. To show the actual chart, press <key>F5</key> or use <guiseq><gui style="button">View menu</gui> <gui style="menuitem">Chart</gui></guiseq>.</p>
|
||||
|
||||
<figure>
|
||||
<title>Chart edit</title>
|
||||
<desc>Editing a chart’s data</desc>
|
||||
<media type="image" src="figures/chart-edit.png" width="700">
|
||||
</media>
|
||||
</figure>
|
||||
|
||||
<note>
|
||||
<p>Creating a new chart while viewing one will open a new window. If you are on the chart list screen, the current window will be used.</p>
|
||||
</note>
|
||||
</page>
|
||||
|
|
|
|||
Loading…
Reference in New Issue