[kstars] doc: Updated documentation for Finding Objects in order to include Akarsh internet searching feature
Raphael Cojocaru
raphael.cojocaru at yahoo.com
Thu Aug 18 16:34:36 UTC 2016
Git commit c5547a11454be8f4ff1a74d9cd329ef7eb997574 by Raphael Cojocaru.
Committed on 18/08/2016 at 16:34.
Pushed by raphaelc into branch 'master'.
Updated documentation for Finding Objects in order to include Akarsh internet searching feature
M +- -- doc/find.png
A +- -- doc/find2.png
M +47 -4 doc/quicktour.docbook
http://commits.kde.org/kstars/c5547a11454be8f4ff1a74d9cd329ef7eb997574
diff --git a/doc/find.png b/doc/find.png
index 06ef9df..e67e5d3 100644
Binary files a/doc/find.png and b/doc/find.png differ
diff --git a/doc/find2.png b/doc/find2.png
new file mode 100644
index 0000000..0c24eb3
Binary files /dev/null and b/doc/find2.png differ
diff --git a/doc/quicktour.docbook b/doc/quicktour.docbook
index dd3e28a..07e74ff 100644
--- a/doc/quicktour.docbook
+++ b/doc/quicktour.docbook
@@ -253,13 +253,13 @@ Object</guilabel> tool, which can be opened by clicking on the
The <guilabel>Find Object</guilabel> window is shown below:
<screenshot>
-<screeninfo>Find Object Window</screeninfo>
+<screeninfo>Find Object Window with search online feature</screeninfo>
<mediaobject>
<imageobject>
- <imagedata fileref="find.png" format="PNG"/>
+ <imagedata fileref="find2.png" format="PNG"/>
</imageobject>
<textobject>
- <phrase>Find Object Window</phrase>
+ <phrase>Find Object Window with search online feature</phrase>
</textobject>
</mediaobject>
</screenshot>
@@ -274,7 +274,50 @@ by object type. To filter by name, enter a string in the edit box
at the top of the window; the list will then only contain names
which start with that string. To filter by type, select a type
from the combo box at the bottom of the window.
-</para><para>
+</para>
+<para>
+&kstars; provides another method for resolving the objects that are
+missing from any of its predefined catalogues, by using an internet
+connection. Thus, if you want to find an object that &kstars; is not
+aware of, you can easily do this by querying several professional
+astronomical databases as: SIMBAD, NED or VizieR. This can be done by
+entering the object's name and then press the <guibutton>or search the
+internet for ObjectName</guibutton> button. After your object is found,
+you can use it exactly as any object that is already loaded into &kstars;
+(&ie; adding it to the Observing WishList). If the object was not found
+in the online databases, then a warning dialogue will pop-up. Once you
+resolve an object by using this method, it is stored in &kstars; database,
+so if you close &kstars; and open it again, your object will still be there.
+</para>
+
+<para>
+You can choose to enable or disable this feature by checking or unchecking the
+<guibutton>Resolve names not known to &kstars; using online services</guibutton>
+check box from <guilabel>Catalogs</guilabel> tab, inside of
+<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure KStars</guimenuitem></menuchoice>
+window. If this checkbox is checked, when an object name unknown to &kstars;
+is entered in the <guilabel>Find Dialog</guilabel>, &kstars; will contact online
+services to learn about the desired object and then add it directly to &kstars;
+database. The objects acquired in this manner are stored in a fake catalog, called
+<quote>_Internet_Resolved</quote>. Thus, you can enable or disable the display of
+these objects by checking or unchecking the <quote>_Internet_Resolved</quote> catalog
+from the catalogues list. Note that you can not delete this fake catalogue, as you can
+do with a custom catalogue. If this checkbox is unchecked, then the
+<guilabel>Find Dialog</guilabel> window will be exactly the same, excepting a minor change:
+the online searching button will no longer be visible.
+</para>
+<screenshot>
+<screeninfo>Find Object Window</screeninfo>
+<mediaobject>
+ <imageobject>
+ <imagedata fileref="find.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>Find Object Window</phrase>
+ </textobject>
+</mediaobject>
+</screenshot>
+<para>
To center the display on an object, highlight the desired object in
the list, and press <guibutton>Ok</guibutton>. Note that if the
object is below the horizon, the program will warn you that you may
More information about the kde-doc-english
mailing list