Add basic documentation

This commit is contained in:
Gergely Polonkai 2014-09-27 18:17:10 +02:00
parent 91d0836020
commit 2b44130235
8 changed files with 197 additions and 11 deletions

58
help/C/chart-parts.page Normal file
View File

@ -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 users 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 dont think it has any impact on the persons life. We included this information merely for educational reasons.</p>
</section>
</page>

View File

@ -5,7 +5,7 @@
id="display-themes"> id="display-themes">
<info> <info>
<revision version="0.1" date="2013-09-22" status="candidate" /> <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"> <credit type="author copyright">
<name>Gergely Polonkai</name> <name>Gergely Polonkai</name>
@ -15,8 +15,31 @@
<xi:include href="legal.xml" /> <xi:include href="legal.xml" />
<desc>Choosing the right display theme</desc> <desc>Using display themes</desc>
</info> </info>
<title>Choosing the right display theme</title> <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 doesnt show any antiscia.</p>
</item>
<item>
<title>No comets</title>
<p>This is the same as Everything, except it doesnt 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> </page>

View File

@ -5,7 +5,7 @@
id="image-export"> id="image-export">
<info> <info>
<revision version="0.1" date="2013-09-22" status="candidate" /> <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"> <credit type="author copyright">
<name>Gergely Polonkai</name> <name>Gergely Polonkai</name>
@ -15,8 +15,18 @@
<xi:include href="legal.xml" /> <xi:include href="legal.xml" />
<desc>Exporting images</desc> <desc>Exporting images of charts</desc>
</info> </info>
<title>Exporting images</title> <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> </page>

View File

@ -19,5 +19,23 @@
<desc>Astrologers' software</desc> <desc>Astrologers' software</desc>
</info> </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> </page>

View File

@ -16,10 +16,19 @@
<xi:include href="legal.xml" /> <xi:include href="legal.xml" />
<desc>What is <app>Astrognome</app>?</desc> <desc>Introduction</desc>
</info> </info>
<title>Introduction</title> <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 Systems 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> </page>

View File

@ -5,7 +5,7 @@
id="keyboard-navigation"> id="keyboard-navigation">
<info> <info>
<revision version="0.1" date="2013-09-22" status="candidate" /> <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"> <credit type="author copyright">
<name>Gergely Polonkai</name> <name>Gergely Polonkai</name>
@ -19,4 +19,33 @@
</info> </info>
<title>Navigating with the keyboard</title> <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> </page>

View File

@ -5,7 +5,7 @@
id="preferences"> id="preferences">
<info> <info>
<revision version="0.1" date="2013-09-22" status="candidate" /> <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"> <credit type="author copyright">
<name>Gergely Polonkai</name> <name>Gergely Polonkai</name>
@ -19,4 +19,30 @@
</info> </info>
<title>Preferences</title> <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> </page>

View File

@ -5,7 +5,7 @@
id="your-first-chart"> id="your-first-chart">
<info> <info>
<revision version="0.1" date="2013-09-22" status="candidate" /> <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"> <credit type="author copyright">
<name>Gergely Polonkai</name> <name>Gergely Polonkai</name>
@ -15,8 +15,21 @@
<xi:include href="legal.xml" /> <xi:include href="legal.xml" />
<desc>Your first chart</desc> <desc>Creating natal charts</desc>
</info> </info>
<title>Your first chart</title> <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 charts 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> </page>