gnucash-docs stable: Multiple changes pushed
Frank H.Ellenberger
fell at code.gnucash.org
Sun Jul 23 00:14:47 EDT 2023
Updated via https://github.com/Gnucash/gnucash-docs/commit/c123def8 (commit)
via https://github.com/Gnucash/gnucash-docs/commit/d2986543 (commit)
via https://github.com/Gnucash/gnucash-docs/commit/187756bc (commit)
via https://github.com/Gnucash/gnucash-docs/commit/b8116969 (commit)
from https://github.com/Gnucash/gnucash-docs/commit/506602f4 (commit)
commit c123def80e3459af08b767fbcfe157b73d5dd375
Author: Christian Wehling <christian.wehling at web.de>
Date: Sat Jul 22 18:18:43 2023 +0200
F::Q, Unify the sect1-ID's
Change "finance-quote-*" to "fq-*" to get consistent html file names.
diff --git a/C/guide/ch_invest.xml b/C/guide/ch_invest.xml
index d1edc00f..732a268f 100644
--- a/C/guide/ch_invest.xml
+++ b/C/guide/ch_invest.xml
@@ -1463,8 +1463,8 @@ Income
<para>After you have verified the proper fetching of Online Quotes for your commodities, you can tell your
operating system to fetch the quotes periodically. See the section
- <ulink url="&url-docs-C;help/finance-quote-scheduler.html">Configuring for Getting Quotes
- Periodically</ulink> in the manual.
+ <ulink url="&url-docs-C;manual/fq-command-line.html">Updating Prices Automatically with &app-cli;</ulink>
+ in the manual.
</para>
</sect3>
</sect2>
diff --git a/C/manual/ch_Account-Actions.xml b/C/manual/ch_Account-Actions.xml
index 11890de4..902a5e04 100644
--- a/C/manual/ch_Account-Actions.xml
+++ b/C/manual/ch_Account-Actions.xml
@@ -582,7 +582,7 @@
</para>
<tip>
- <para>The installation of &app-fq; is described under <xref linkend="finance-quote-install" />.
+ <para>The installation of &app-fq; is described under <xref linkend="fq-install" />.
</para>
</tip>
</listitem>
diff --git a/C/manual/ch_Finance-Quote.xml b/C/manual/ch_Finance-Quote.xml
index b9e52066..d9e3fc4a 100644
--- a/C/manual/ch_Finance-Quote.xml
+++ b/C/manual/ch_Finance-Quote.xml
@@ -52,7 +52,7 @@ Translators:
<para>You can also leave out this step and manually update your stock quotes.
</para>
- <sect1 id="finance-quote-perl-install">
+ <sect1 id="fq-perl-install">
<title>Installing &app-perl;</title>
<abstract>
@@ -71,7 +71,7 @@ This is perl 5, version 30, subversion 0 (v5.30.0) built for x86_64-linux-gnu-th
</screen>
</informalexample>
If you are shown the version number of the &app-perl; interpreter, skip the next details and
- continue instead with <xref linkend="finance-quote-install" />.
+ continue instead with <xref linkend="fq-install" />.
</para>
<procedure>
@@ -143,7 +143,7 @@ This is perl 5, version 30, subversion 0 (v5.30.0) built for x86_64-linux-gnu-th
</tip>
</sect1>
- <sect1 id="finance-quote-install">
+ <sect1 id="fq-install">
<title>Installing &app-fq;</title>
<para>To determine if the &app-perl; module &app-fq; is already installed on your system, type
diff --git a/C/manual/ch_Transactions.xml b/C/manual/ch_Transactions.xml
index 369a888b..1e68ef35 100644
--- a/C/manual/ch_Transactions.xml
+++ b/C/manual/ch_Transactions.xml
@@ -157,7 +157,7 @@ Translators:
<para>The <guilabel>Currency Transfer</guilabel> pane is used to collect the needed information to enter
the amount of the <guilabel>Transfer To</guilabel> split. You may enter either a price or an
amount and <application>&appname;</application> will compute the other. If you have Online
- Price Retrieval installed (see <xref linkend="finance-quote-install"/>) you can use the
+ Price Retrieval installed (see <xref linkend="fq-install"/>) you can use the
<guilabel>Fetch Rate</guilabel> button to retrieve a current quote.
</para>
diff --git a/de/manual/ch_Finance-Quote.xml b/de/manual/ch_Finance-Quote.xml
index 2d94c2ff..15c31193 100644
--- a/de/manual/ch_Finance-Quote.xml
+++ b/de/manual/ch_Finance-Quote.xml
@@ -53,7 +53,7 @@ Translators:
<para>Sie können diesen Schritt auch weglassen und Ihre Kurse weiterhin manuell aktualisieren.
</para>
- <sect1 id="finance-quote-perl-install">
+ <sect1 id="fq-perl-install">
<title>Installieren von &app-perl;</title>
<abstract>
@@ -72,8 +72,7 @@ This is perl 5, version 30, subversion 0 (v5.30.0) built for x86_64-linux-gnu-th
</screen>
</informalexample>
Wird Ihnen die Versionsnummer des &app-perl;-Interpreters angezeigt, dann überspringen Sie
- die nächsten Angaben und fahren Sie stattdessen mit <xref linkend="finance-quote-install" />
- fort.
+ die nächsten Angaben und fahren Sie stattdessen mit <xref linkend="fq-install" /> fort.
</para>
<procedure>
@@ -146,7 +145,7 @@ This is perl 5, version 30, subversion 0 (v5.30.0) built for x86_64-linux-gnu-th
</tip>
</sect1>
- <sect1 id="finance-quote-install">
+ <sect1 id="fq-install">
<title>Installieren von &app-fq;</title>
<para>Um festzustellen, ob das &app-perl;-Modul &app-fq; bereits auf Ihrem System verfügbar ist, geben
diff --git a/de/manual/ch_Transactions.xml b/de/manual/ch_Transactions.xml
index 2eb6fa08..3208c7f2 100644
--- a/de/manual/ch_Transactions.xml
+++ b/de/manual/ch_Transactions.xml
@@ -184,7 +184,7 @@ Translators:
des Betrags des <guilabel>Buchen nach</guilabel> Buchungsteils zu erfassen. Sie können
entweder einen Wechselkurs oder einen Betrag eingeben und &app; wird das andere berechnen.
Wenn Sie den <emphasis>Online Kursabruf</emphasis> installiert haben (siehe
- <xref linkend="finance-quote-install"/>), können Sie über die Schaltfläche
+ <xref linkend="fq-install"/>), können Sie über die Schaltfläche
<guilabel>Wechselkurs abrufen</guilabel> einen aktuellen Kurs abfragen.
</para>
commit d29865439789df922bded563280c3339a489ebca
Author: Christian Wehling <christian.wehling at web.de>
Date: Tue Apr 11 16:59:02 2023 +0200
Improve documentation for gnucash-cli
insert
- entities for MAC
- new lines
- variablelist
diff --git a/C/manual/ch_Finance-Quote.xml b/C/manual/ch_Finance-Quote.xml
index 461e8b22..b9e52066 100644
--- a/C/manual/ch_Finance-Quote.xml
+++ b/C/manual/ch_Finance-Quote.xml
@@ -35,7 +35,9 @@ Translators:
<listitem>
<para>the &app-perl;-module &app-fq; with any dependencies
</para>
+ </listitem>
+ <listitem>
<para>the &app-perl;-module JSON::Parse to manage the output of &app-fq;.
</para>
</listitem>
@@ -147,7 +149,6 @@ This is perl 5, version 30, subversion 0 (v5.30.0) built for x86_64-linux-gnu-th
<para>To determine if the &app-perl; module &app-fq; is already installed on your system, type
<userinput>perldoc Finance::Quote</userinput> in a terminal window and check to see if there
is any documentation
-<!-- Fixme: https://bugs.gnucash.org/show_bug.cgi?id=798618 -->
<informalexample>
<?dbfo pgwide="1"?>
<screen language="console">
@@ -156,7 +157,7 @@ NAME
Finance::Quote - Get stock and mutual fund quotes from various exchanges
SYNOPSIS
- [...]
+ [...]
</screen>
</informalexample>
available. If you are now shown documentation, then &app-fq; is already installed and you can
@@ -231,9 +232,9 @@ SYNOPSIS
</step>
<step>
- <simpara>Open a Finder window, select <guimenu>Applications</guimenu> from the sidebar, double-click
- <guimenu>Utilities</guimenu> in the file area, then double-click on
- <guimenu>Terminal</guimenu> to open <application>Terminal</application>
+ <simpara>Open a <application>Finder</application> window, select &gm.macOS.appl; from the sidebar,
+ double-click &gmi.macOS.appl.util; in the file area, then double-click on
+ <guimenu>Terminal</guimenu> to open <application>Terminal</application>.
</simpara>
</step>
@@ -247,11 +248,11 @@ SYNOPSIS
<step>
<simpara>Type <userinput>exit</userinput> or
<keycombo>
- <keycap>Control</keycap><keycap>D</keycap>
+ &kc.ctrl;<keycap>D</keycap>
</keycombo>
to terminate the shell followed by
<keycombo>
- <keycap>Command</keycap><keycap>Q</keycap>
+ &kc.cmd;<keycap>Q</keycap>
</keycombo>
to quit <application>Terminal</application>.
</simpara>
@@ -289,30 +290,34 @@ SYNOPSIS
<para><command>gnucash-cli --quotes info</command> produces the following output:
</para>
-<!-- Fixme: https://bugs.gnucash.org/show_bug.cgi?id=798618 -->
+
<informalexample>
<?dbfo pgwide="1"?>
<screen language="console">
- $ gnucash-cli --quotes info
- Found Finance::Quote version 1.52.
- Finance::Quote sources:
- aex alphavantage amfiindia asegr asx
- aufunds australia bamosz bet bloomberg bourso
- bse bseindia canada canadamutual comdirect
- cse deka dutch dwsfunds europe
- fetch_live_currencies fidelity fidelity_direct
- finanzpartner fondsweb fool ftfunds fundata
- fundlibrary goldmoney greece hu hufund hungary
- hustock iexcloud india indiamutual known_currencies
- morningstarau morningstarch morningstarjp
- mstaruk nasdaq nseindia nyse nzx onvista
- oslobors romania seb_funds six tesouro_direto
- tiaacref tmx tradeville troweprice troweprice_direct
- tsp ukfunds unionfunds usa usfedbonds yahoo_json
- za
- </screen>
+$ gnucash-cli --quotes info
+Found Finance::Quote version 1.52.
+Finance::Quote sources:
+aex alphavantage amfiindia asegr asx
+aufunds australia bamosz bet bloomberg bourso
+bse bseindia canada canadamutual comdirect
+cse deka dutch dwsfunds europe
+fetch_live_currencies fidelity fidelity_direct
+finanzpartner fondsweb fool ftfunds fundata
+fundlibrary goldmoney greece hu hufund hungary
+hustock iexcloud india indiamutual known_currencies
+morningstarau morningstarch morningstarjp
+mstaruk nasdaq nseindia nyse nzx onvista
+oslobors romania seb_funds six tesouro_direto
+tiaacref tmx tradeville troweprice troweprice_direct
+tsp ukfunds unionfunds usa usfedbonds yahoo_json
+za
+</screen>
</informalexample>
+ <para>The latest &app-fq; version is &app-fq-vers;. Depending on the actuality of your installation
+ the list of source modules made here may differ.
+ </para>
+
<para>If there's a problem with your installation it will tell you about it. For example in this case
we're missing the Perl modules Finance::Quote and JSON::Parse:
</para>
@@ -320,10 +325,15 @@ SYNOPSIS
<informalexample>
<?dbfo pgwide="1"?>
<screen language="console">
- $ gnucash-cli --quotes info
- Failed to initialize Finance::Quote: missing_modules Finance::Quote JSON::Parse
- </screen>
+$ gnucash-cli --quotes info
+Failed to initialize Finance::Quote: missing_modules Finance::Quote JSON::Parse
+</screen>
</informalexample>
+
+ <para>In this case, &app-fq; is not installed correctly and therefore cannot be used for course retrieval with &app;.
+ Please install &app-fq; according to the instructions at
+ <xref linkend="fq-install" />.
+ </para>
</sect2>
<sect2 id="fq-print-quotes">
@@ -332,88 +342,122 @@ SYNOPSIS
<para>To display a quote for one or more stocks or the exchange rate for one or more currencies you can
use <userinput>gnucash-cli --quotes dump</userinput> as follows. It offers two output forms
for non-currency securities and one for currency exchange rates.
- <itemizedlist>
- <listitem>
- <para>Currencies use the source <userinput>currency</userinput> and require at least two ISO-4217 currency
- codes; the exchange rates are denominated in the first code. For example:
- <informalexample>
+ <variablelist>
+ <varlistentry>
+ <term>Currencies</term>
+
+ <listitem>
+ <para>Currencies use the source <userinput>currency</userinput> and require at least two ISO-4217 currency
+ codes; the exchange rates are denominated in the first code. For example:
+ <informalexample>
<?dbfo pgwide="1"?>
<screen language="console">
- $ gnucash-cli --quotes dump currency USD GBP EUR
- 1 GBP = 1.11917349089527 USD
-
- 1 EUR = 0.9717 USD
- </screen>
- </informalexample>
- </para>
- </listitem>
+$ gnucash-cli --quotes dump currency USD GBP EUR
+1 GBP = 1.11917349089527 USD
- <listitem>
- <para>Stocks
- </para>
-
- <itemizedlist>
- <listitem>
- <para>A short form displaying only the fields that GnuCash uses along with comments indicating whether the
- fields are optional or required; you can use this to determine if GnuCash will be
- able to use the quote to update your book's price database.
- <informalexample>
+1 EUR = 0.9717 USD
+</screen>
+ </informalexample>
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Stocks</term>
+
+ <listitem>
+ <itemizedlist>
+ <listitem>
+ <para>A short form displaying only the fields that &app; uses along with comments indicating whether the
+ fields are optional or required; you can use this to determine if &app; will be
+ able to use the quote to update your book's price database.
+ <informalexample>
<?dbfo pgwide="1"?>
<screen language="console">
- $ gnucash-cli --quotes dump yahoo_json AAPL
- Finance::Quote fields GnuCash uses:
- symbol: AAPL <=== required
- date: 10/14/2022 <=== recommended
- currency: USD <=== required
- last: 138.38 <=\
- nav: <=== one of these
- price: <=/
- </screen>
- </informalexample>
- </para>
- </listitem>
-
- <listitem>
- <para>With the <userinput>-v</userinput> option a possibly longer output showing all of the fields
- &app-fq; returned. This can be useful to troubleshoot problems with a &app-fq;
- source module.
- <informalexample>
+$ gnucash-cli --quotes dump yahoo_json AAPL
+Finance::Quote fields GnuCash uses:
+ symbol: AAPL <=== required
+ date: 10/14/2022 <=== recommended
+ currency: USD <=== required
+ last: 138.38 <=\
+ nav: <=== one of these
+ price: <=/
+</screen>
+ </informalexample>
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>With the <userinput>-V</userinput> option a possibly longer output showing all of the fields
+ &app-fq; returned. This can be useful to troubleshoot problems with a &app-fq;
+ source module.
+ <informalexample>
<?dbfo pgwide="1"?>
<screen language="console">
- $ ALPHAVANTAGE_API_KEY=123456789 bin/gnucash-cli -V --quotes dump alphavantage INTC
- INTC:
- method => alphavantage
- p_change => -1.9304
- high => 26.6300
- date => 10/14/2022
- currency_set_by_fq => 1
- close => 26.4200
- currency => USD
- isodate => 2022-10-14
- low => 25.7600
- success => 1
- net => -0.5100
- open => 26.4600
- symbol => INTC
- volume => 48118005
- last => 25.9100
- </screen>
- </informalexample>
- Notice that in this case we used alphavantage and provided the
- <userinput>ALPHAVANTAGE_API_KEY</userinput> on the command line. That's not
- necessary if the key is already stored in the shell environment or in GnuCash
- preferences.
- </para>
- </listitem>
- </itemizedlist>
- </listitem>
- </itemizedlist>
+$ ALPHAVANTAGE_API_KEY=123456789 bin/gnucash-cli -V --quotes dump alphavantage INTC
+INTC:
+ method => alphavantage
+ p_change => -1.9304
+ high => 26.6300
+ date => 10/14/2022
+ currency_set_by_fq => 1
+ close => 26.4200
+ currency => USD
+ isodate => 2022-10-14
+ low => 25.7600
+ success => 1
+ net => -0.5100
+ open => 26.4600
+ symbol => INTC
+ volume => 48118005
+ last => 25.9100
+</screen>
+ </informalexample>
+
+ <note>
+ <para>Notice that in this case we used alphavantage and provided the
+ <userinput>ALPHAVANTAGE_API_KEY</userinput> on the command line. That's not
+ necessary if the key is already stored in the shell environment or in &app;
+ preferences.
+ </para>
+ </note>
+ </para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ </varlistentry>
+ </variablelist>
</para>
</sect2>
<sect2 id="fq-auto-quote">
<title>Updating Prices Automatically with &app-cli;</title>
+ <para>With the command <command>gnucash-cli --quotes get &user-datafile;</command>
+ <footnote>
+ <simpara>The old command <command>gnucash --add-price-quotes &user-datafile;</command> is obsolete as of &app; 5.0.
+ </simpara>
+ </footnote>
+ you can receive the current prices of your foreign exchange and securities and write them directly into your
+ &app;-file without starting the user interface. This enables an automatic, regular updating of the prices.
+ <note>
+ <para>The command fails if exclusive access to the data file is not possible, for example,
+ the data file is opened in another &app; instance, or the last session for the file crashed.
+ </para>
+ </note>
+ </para>
+
+ <para>The specified file &user-datafile; depends on the name and location of your
+ data file. This can be determined from the name displayed in the top frame of the &app;
+ window before the <quote>-</quote>.
+ <tip>
+ <para>The file name can also be found in the list of recently opened files in the &gm.file;menu.
+ If you hover the mouse pointer on the menu item numbered 1 in the list of recently opened files,
+ the full file name is displayed in the <guilabel>statusbar</guilabel>.
+ </para>
+ </tip>
+ </para>
+
<para>You have to register the &app-cli; with a scheduler in order to get Online Quotes automatically and
periodically. The method depends on your OS.
</para>
@@ -435,15 +479,21 @@ SYNOPSIS
<step>
<para>Add the following line to your crontab:
<informalexample>
-<screen>0 16 * * 5 gnucash-cli --quotes get &user-datafile; > /dev/null 2>&1</screen>
+<?dbfo pgwide="1"?>
+<screen>
+0 16 * * 5 gnucash-cli --quotes get &user-datafile; > /dev/null 2>&1
+</screen>
</informalexample>
<important>
<para>On &lin; if there is no graphic session that has already started the dbus, running on your computer
at the time of the quote request, you must do the entry as follows instead:
<informalexample>
-<screen>0 16 * * 5 env `dbus-launch` sh -c 'trap "kill $DBUS_SESSION_BUS_PID" EXIT;
-gnucash-cli --quotes get &user-datafile; > /dev/null 2>&1</screen>
+<?dbfo pgwide="1"?>
+<screen>
+0 16 * * 5 env `dbus-launch` sh -c 'trap "kill $DBUS_SESSION_BUS_PID" EXIT;
+gnucash-cli --quotes get &user-datafile; > /dev/null 2>&1
+</screen>
</informalexample>
(Do not copy the line breaks into the crontab, they were inserted here only for
the purpose of readability).
@@ -460,17 +510,12 @@ gnucash-cli --quotes get &user-datafile; > /dev/null 2>&1</screen>
</para>
<step>
- <simpara>Select
- <menuchoice>
- <guimenu>Start</guimenu><guisubmenu>Windows Administrative
- Tools</guisubmenu><guimenuitem>Task Scheduler</guimenuitem>
- </menuchoice>
- .
+ <simpara>Select &mc.winOS.sys.tasks;
</simpara>
</step>
<step>
- <simpara>Select <guimenuitem>Create Task</guimenuitem>.
+ <simpara>Select &gmi.winOS.sys.task;.
</simpara>
</step>
commit 187756bc8f283e2ee687368904ecab5e6f4a31a5
Author: Christian Wehling <christian.wehling at web.de>
Date: Mon Apr 10 15:30:07 2023 +0200
L10n:de: Update docu for integrating price quotes into gnucash-cli
diff --git a/de/manual/ch_Finance-Quote.xml b/de/manual/ch_Finance-Quote.xml
index 37577b23..2d94c2ff 100644
--- a/de/manual/ch_Finance-Quote.xml
+++ b/de/manual/ch_Finance-Quote.xml
@@ -36,6 +36,11 @@ Translators:
<para>das &app-perl;-Module &app-fq; mit allen Abhängigkeiten.
</para>
</listitem>
+
+ <listitem>
+ <para>das &app-perl;-Module JSON::Parse um die Ausgabe von &app-fq; zu steuern.
+ </para>
+ </listitem>
</itemizedlist>
<note>
@@ -53,11 +58,11 @@ Translators:
<abstract>
<para>Abhängig von dem verwendeten Betriebssystem ist der Aufwand für die Installation von &app-perl;
- schnell erledigt und wird in diesem Abschnitt beschrieben.
+ gering und wird in diesem Abschnitt beschrieben.
</para>
</abstract>
- <para>Um zu überprüfen ob auf Ihrem System &app-perl; bereits installiert ist, rufen Sie den Befehl
+ <para>Um zu überprüfen ob &app-perl; bereits auf Ihrem System installiert ist, rufen Sie den Befehl
<userinput>perl -v</userinput> im Terminal auf.
<!-- Fixme: https://bugs.gnucash.org/show_bug.cgi?id=798618 -->
<informalexample>
@@ -118,7 +123,7 @@ This is perl 5, version 30, subversion 0 (v5.30.0) built for x86_64-linux-gnu-th
</step>
<step>
- <para>Zu Ausführung beötigen Sie <emphasis>Administratorenrechte</emphasis>, die im Dialog abgefragt
+ <para>Zur Ausführung benötigen Sie <emphasis>Administratorenrechte</emphasis>, die im Dialog abgefragt
werden. Die Installation kann mehr als 15 Minuten dauern.
</para>
</step>
@@ -135,8 +140,8 @@ This is perl 5, version 30, subversion 0 (v5.30.0) built for x86_64-linux-gnu-th
<para>Es empfiehlt sich anschließend, das Verzeichnis in dem &app; installiert ist, unter &win; z.B.
<userinput><replaceable>C:\Programme (x86)\gnucash\bin</replaceable></userinput>, zu Ihrer
<envar>PATH</envar>-Umgebungsvariable hinzuzufügen. Auf diese Weise ist es für Sie
- einfacher, bei Bedarf die <xref linkend="finance-quote-helper" /> zu nutzen. Hierzu
- informieren Sie sich bitte in den Unterlagen zu Ihrem Betriebssystem.
+ einfacher, bei Bedarf die <xref linkend="fq-command-line" /> zu nutzen. Hierzu informieren
+ Sie sich bitte in den Unterlagen zu Ihrem Betriebssystem.
</para>
</tip>
</sect1>
@@ -156,12 +161,12 @@ NAME
Finance::Quote - Get stock and mutual fund quotes from various exchanges
SYNOPSIS
- [...]
+ [...]
</screen>
</informalexample>
angezeigt, dann ist &app-fq; installiert und Sie können, wie in
- <xref linkend="finance-quote-scheduler" /> beschrieben, den automatisierten Kursabruf
- konfigurieren. Wenn nicht, dann gibt Ihnen dieser Abschnitt eine Anleitung zur Installation.
+ <xref linkend="fq-auto-quote" /> beschrieben, den automatisierten Kursabruf konfigurieren.
+ Wenn nicht, dann gibt Ihnen dieser Abschnitt eine Anleitung zur Installation.
</para>
<para>Die Installation von &app-fq; unterscheidet sich von einem Betriebssystem zum anderen. Für die
@@ -192,18 +197,16 @@ SYNOPSIS
</step>
<step>
- <simpara>Als nächstes aktualisieren Sie mit <userinput>sudo gnc-fq-update</userinput> oder <userinput>su -c
- gnc-fq-update</userinput> mit Root-Rechten &app-fq;. Die richtige Syntax ist von der
- jeweiligen Distribution abhängig. Weitere Informationen finden Sie im nächsten Kapitel
- unter <xref linkend="gnc-fq-update" />.
+ <simpara>Als nächstes aktualisieren Sie &app-fq; mit <userinput>sudo gnc-fq-update</userinput>. Die richtige
+ Syntax ist von der jeweiligen Distribution abhängig.
</simpara>
</step>
<step>
- <simpara>Führen Sie <userinput>gnc-fq-check</userinput> aus, um zu prüfen, ob &app-fq; richtig installiert
- ist. Wenn dies so ist, dann werden die Versionsnummer sowie die von &app-fq; verwendbaren
- Quellen für eine Kursabfrage aufgelistet. Bei Problemen mit der Installation von &app-fq;
- wird eventuell eine Lösung vorgeschlagen.
+ <simpara>Führen Sie <userinput>gnucash-cli --quotes info</userinput> aus, um zu prüfen, ob &app-fq; richtig
+ installiert ist. Wenn dies so ist, dann werden die Versionsnummer sowie die von &app-fq;
+ verwendbaren Quellen für eine Kursabfrage aufgelistet. Bei Problemen mit der Installation
+ von &app-fq; wird eventuell eine Lösung vorgeschlagen.
</simpara>
</step>
</procedure>
@@ -211,6 +214,12 @@ SYNOPSIS
<procedure>
<title>Unter &mac;</title>
+ <note>
+ <para>Sie müssen mit einer Benutzerkennung angemeldet sein, die den Mac administrieren kann, um dieses
+ Vorgehen anzuwenden.
+ </para>
+ </note>
+
<step>
<simpara>Beenden Sie &app;.
</simpara>
@@ -230,14 +239,31 @@ SYNOPSIS
</step>
<step>
- <simpara>Führen Sie die Anwendung <emphasis>Update Finance Quote</emphasis> im &app; dmg aus.
+ <simpara>Öffnen Sie ein <application>Finder</application>-Fenster, wählen &gm.macOS.appl; in der
+ <emphasis>Seitenleiste</emphasis>, klicken doppelt auf &gmi.macOS.appl.util; in der
+ <emphasis>Dateifläche</emphasis> und öffnen mit Doppelkick eine
+ <application>Terminal</application>-Anwendung.
</simpara>
+ </step>
- <para>Sie können es von der dmg ausführen oder in denselben Ordner kopieren, in den Sie &app; kopiert
- haben. Es öffnet sich ein Terminalfenster und führt ein Skript für Sie aus, das Ihnen
- eine Reihe von Fragen stellt. Akzeptieren Sie bei jeder Frage die Vorgabe, es sei denn,
- Sie wissen, was Sie tun.
- </para>
+ <step>
+ <simpara>In der Termianlanwendung tragen Sie <userinput>sudo
+ /Applications/Gnucash.app/Contents/Resources/bin/gnc-fq-update</userinput> ein. Das Skript
+ stellt viele Fragen, die alle mit den Vorgabewerten beantwortet werden können.
+ </simpara>
+ </step>
+
+ <step>
+ <simpara>Geben Sie <userinput>exit</userinput> ein oder Betätigen Sie
+ <keycombo>
+ &kc.ctrl;<keycap>D</keycap>
+ </keycombo>
+ um die Shell zu beenden, gefolgt von
+ <keycombo>
+ &kc.cmd; <keycap>Q</keycap>
+ </keycombo>
+ damit die Terminalanwendung geschlossen wird.
+ </simpara>
</step>
</procedure>
@@ -257,338 +283,286 @@ SYNOPSIS
</procedure>
</sect1>
- <sect1 id="finance-quote-helper">
- <title>Hilfsprogramme zur Symbolsuche und Aktualisierung</title>
+ <sect1 id="fq-command-line">
+ <title>Verwendung von &app-cli; für Tests und Automatisierung</title>
<abstract>
- <para>&app; bietet Hilfsprogramme, die Sie bei der Auswahl der richtigen Symbole und der Verifikation für
- die gewünschte Online- Kursquelle unterstützen. Ein weiteres Skript führt die erstmalige
- Installation durch oder bringt &app-fq; auf den aktuellen Stand. Und letztendlich stehen
- auch Tools zur Fehleranalyse bereit.
+ <para>&app; enthält die Befehlszeilenanwendung &app-cli;, die in einer Terminalsitzung verwendet werden
+ kann, um die Version und die unterstützten Quellmodule zu prüfen, Kurse oder Wechselkurse
+ für ausgewählte Wertpapiere oder Währungen anzuzeigen und alle Kurse in einem Buch zu
+ aktualisieren, ohne die grafische Benutzeroberfläche zu starten.
</para>
</abstract>
- <procedure>
- <title>&app-perl; Skripts unter &win; ausführen</title>
+ <sect2 id="fq-check-version">
+ <title>Anzeige der &app-fq; Version und der unterstützten Quellen</title>
- <step>
- <simpara>Öffnen Sie ein <application>CMD</application>- oder <application>Powershell </application>-Fenster:
- Klicken Sie auf &gm.win; und geben Sie entweder <userinput>cmd</userinput> oder
- <userinput>powershell</userinput> ein und wählen Sie den entsprechenden Menüpunkt. Das
- muss nicht als Administrator ausgeführt werden.
- </simpara>
- </step>
+ <para><userinput>gnucash-cli --quotes info</userinput> erzeugt die folgende Ausgabe:
+ </para>
- <step>
- <simpara>Da, wie zuvor empfohlen, das &app;-Verzeichnis in die <envar>PATH</envar> Umgebungsvariable
- eingetragen wurde, müssen Sie jetzt nur noch jedem gnc-fq-xxx &app-perl; Skriptbefehl
- <quote>Perl</quote> und ein Leerzeichen voranstellen, z.B. <userinput>perl
- gnc-fq-check</userinput>. Andernfalls müssen Sie den Befehl in der Form
- <userinput><replaceable> C:\strawberry-perl\bin\</replaceable>perl.exe
- <replaceable>C:\Programme (x86)\gnucash\bin\ </replaceable>gnc-fq-check</userinput>
- ausführen.
- </simpara>
- </step>
- </procedure>
+ <informalexample>
+<?dbfo pgwide="1"?>
+<screen language="console">
+$ gnucash-cli --quotes info
+Found Finance::Quote version 1.52.
+Finance::Quote sources:
+aex alphavantage amfiindia asegr asx
+aufunds australia bamosz bet bloomberg bourso
+bse bseindia canada canadamutual comdirect
+cse deka dutch dwsfunds europe
+fetch_live_currencies fidelity fidelity_direct
+finanzpartner fondsweb fool ftfunds fundata
+fundlibrary goldmoney greece hu hufund hungary
+hustock iexcloud india indiamutual known_currencies
+morningstarau morningstarch morningstarjp
+mstaruk nasdaq nseindia nyse nzx onvista
+oslobors romania seb_funds six tesouro_direto
+tiaacref tmx tradeville troweprice troweprice_direct
+tsp ukfunds unionfunds usa usfedbonds yahoo_json
+za
+</screen>
+ </informalexample>
- <sect2 id="gnc-fq-check">
- <title>gnc-fq-check</title>
+ <para>Die neueste &app-fq; Version ist &app-fq-vers;. Entsprechend der Aktualität Ihrer Installation
+ kann sich die hier gemachte Auflistung der Quellenmodule unterscheiden.
+ </para>
+
+ <para>Wenn es ein Problem mit Ihrer Installation gibt, werden Sie darauf hingeweisen. In dem nachfolgend
+ aufgeführtem Fall fehlen zum Beispiel die &app-perl;-Module Finance::Quote und JSON::Parse:
+ </para>
- <abstract>
- <para>Dieses Programm liefert die Versionsnummer des derzeit installierten &app-fq; Moduls sowie eine
- Liste der über &app-fq; verfügbaren Quellen. Es informiert Sie auch, wenn es ein Problem
- mit Ihrer Installation gibt und schlägt eventuell eine Lösung vor.
- </para>
- </abstract>
-<!-- Fixme: https://bugs.gnucash.org/show_bug.cgi?id=798618 -->
<informalexample>
<?dbfo pgwide="1"?>
<screen language="console">
-$ gnc-fq-check
-Can't locate Mozilla/CA.pm in @INC (you may need to install the Mozilla::CA module)
-(@INC contains: /usr/lib/perl5/site_perl/5.30.1/x86_64-linux-thread-multi /usr/
-lib/perl5/site_perl/5.30.1 /usr/lib/perl5/vendor_perl/5.30.1/x86_64-linux-thread-multi
-/usr/lib/perl5/vendor_perl/5.30.1 /usr/lib/perl5/5.30.1/x86_64-linux-thread-multi
-/usr/lib/perl5/5.30.1 /usr/lib/perl5/site_perl)
-at /usr/lib/perl5/vendor_perl/5.30.1/Finance/Quote/Tiaacref.pm line 33.
-Compilation failed in require at (eval 303) line 1.
-BEGIN failed--compilation aborted at (eval 303) line 1.
- at /usr/local/bin/gnc-fq-check line 91.
-("1.47" "adig" "aex" "aiahk" "alphavantage" "amfiindia" "asegr" "asia" "asx"
-"australia" "bamosz" "bet" "bmonesbittburns" "bourso" "brasil" "bse" "bsero" "canada"
-"canadamutual" "citywire" "cominvest" "cse" "deka" "dutch" "dwsfunds" "europe"
-"fetch_live_currencies" "fidelity" "fidelity_direct" "fidelityfixed" "financecanada"
-"finanzpartner" "finland" "fool" "france" "ftfunds" "ftportfolios" "ftportfolios_direct"
-"fundlibrary" "goldmoney" "greece" "hex" "hu" "hufund" "hungary" "hustock" "indiamutual"
-"known_currencies" "lerevenu" "maninv" "morningstar" "morningstarjp" "mstaruk" "nasdaq"
-"nyse" "nz" "nzx" "platinum" "romania" "seb_funds" "sixfunds" "sixshares"
-"stockhousecanada_fund" "tdefunds" "tdwaterhouse" "tiaacref" "tnetuk" "troweprice"
-"troweprice_direct" "trustnet" "tsp" "tsx" "uk_unit_trusts" "ukfunds" "unionfunds"
-"usa" "usfedbonds" "vanguard" "vwd" "yahoo" "yahoo_asia" "yahoo_australia"
-"yahoo_brasil" "yahoo_europe" "yahoo_json" "yahoo_nz" "yahoo_yql" "za" "za_unittrusts")
+$ gnucash-cli --quotes info
+Failed to initialize Finance::Quote: missing_modules Finance::Quote JSON::Parse
</screen>
</informalexample>
- <para>Der erste Teil ist die Fehlermeldung über ein fehlendes &app-perl;-Modul Mozilla/CA.pm. Am Ende in
- Klammern steht die normale Ausgabe der aktuell installierten &app-fq;-Version
- <footnote>
- <para>Die neueste &app-fq; Version ist &app-fq-vers;.
- </para>
- </footnote>
- und eine Liste der verfügbaren Kursdaten-Quellen.
+ <para>In diesem Fall ist &app-fq; nicht richtig installiert und kann so nicht für den Kursabruf mit &app;
+ genutzt werden. Bitte installieren Sie &app-fq; entsprechend der Anleitung unter
+ <xref linkend="fq-install" />.
</para>
-
- <tip>
- <para>Wenn ein Fehler angezeigt wird, lesen Sie den nächsten Abschnitt <xref linkend="gnc-fq-update" />.
- Ansonsten fahren Sie mit <xref linkend="gnc-fq-dump" /> fort.
- </para>
- </tip>
</sect2>
- <sect2 id="gnc-fq-update">
- <title>gnc-fq-update</title>
+ <sect2 id="fq-print-quotes">
+ <title>Anzeige von Kursen in einem Terminalfenster</title>
+
+ <para>Um einen Kurs für eine oder mehrere Aktien oder den Wechselkurs für eine oder mehrere Währungen
+ anzuzeigen, können Sie <userinput>gnucash-cli --quotes dump</userinput> wie folgt
+ verwenden. Es bietet eine Ausgabeform für Devisenkurse und zwei für Aktien und
+ Wertpapiere.
+ <variablelist>
+ <varlistentry>
+ <term>Währungen</term>
+
+ <listitem>
+ <para>Für den Abruf von Devisenkursen wird die Quelle <userinput>currency</userinput> verwendet, welche
+ mindestens zwei ISO-4217-Währungscodes erfordern; die Wechselkurse werden in der
+ ersten Währung angegeben.
+ <footnote>
+ <para>Seit &app-fq; 1.41 ist die Standardquelle für Währungen <quote>Alpha Vantage</quote>. Lesen Sie
+ auch die Hinweise zu <xref linkend="gnc-tbl-fq-currency-source" />.
+ </para>
+ </footnote>
+ Zum Beispiel:
+ <informalexample>
+<?dbfo pgwide="1"?>
+<screen language="console">
+$ gnucash-cli --quotes dump currency USD GBP EUR
+1 GBP = 1.11917349089527 USD
- <abstract>
- <para>Dieses Programm installiert oder aktualisiert das &app-fq; Softwaremodul und löst bei Bedarf die
- Abhängigkeiten zu weiteren Softwarepaketen auf.
- <note>
- <para>Windows-Benutzer sind im Allgemeinen besser beraten, wenn sie das Update-Tool &mc.winOS.inst-fq;
- ausführen.
- </para>
- </note>
- </para>
- </abstract>
+1 EUR = 0.9717 USD
+</screen>
+ </informalexample>
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>Wertpapiere</term>
+
+ <listitem>
+ <itemizedlist>
+ <listitem>
+ <para>Eine Kurzform, die nur die Felder anzeigt, die &app; benötigt, ergänzt mit Kommentaren, die
+ angeben, ob die Felder empfohlen oder erforderlich sind; damit können Sie
+ herausfinden, ob &app; in der Lage sein wird die Kursangaben zu verwenden, um
+ die Kursdatenbank Ihres Buches zu aktualisieren.
+ <informalexample>
+<?dbfo pgwide="1"?>
+<screen language="console">
+$ gnucash-cli --quotes dump yahoo_json AAPL
+Finance::Quote fields GnuCash uses:
+ symbol: AAPL <=== required
+ date: 10/14/2022 <=== recommended
+ currency: USD <=== required
+ last: 138.38 <=\
+ nav: <=== one of these
+ price: <=/
+</screen>
+ </informalexample>
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>Mit der Option <userinput>-V</userinput> wird eine möglicherweise längere Ausgabe mit allen
+ Datenfeldern von &app-fq; zurückgegeben. Dies kann nützlich sein, um Probleme
+ mit einem &app-fq; Quellmodul zu beheben.
+ <informalexample>
+<?dbfo pgwide="1"?>
+<screen language="console">
+$ ALPHAVANTAGE_API_KEY=123456789 bin/gnucash-cli -V --quotes dump alphavantage INTC
+INTC:
+ method => alphavantage
+ p_change => -1.9304
+ high => 26.6300
+ date => 10/14/2022
+ currency_set_by_fq => 1
+ close => 26.4200
+ currency => USD
+ isodate => 2022-10-14
+ low => 25.7600
+ success => 1
+ net => -0.5100
+ open => 26.4600
+ symbol => INTC
+ volume => 48118005
+ last => 25.9100
+</screen>
+ </informalexample>
+
+ <note>
+ <para>Beachten Sie, dass wir in diesem Fall als Quelle alphavantage verwendet und den
+ <userinput>ALPHAVANTAGE_API_KEY</userinput> in der Befehlszeile angegeben
+ haben. Das ist nicht notwendig, wenn der Schlüssel bereits in der
+ Umgebungsvariable der Shell oder in den &app;-Einstellungen gespeichert ist.
+ </para>
+ </note>
+ </para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </sect2>
- <note>
- <para>Dieses Programm erfordert für eine Installation unter &lin; oder &mac; Superuser- oder
- Administratorrechte, aber nicht in &win;.
- </para>
- </note>
+ <sect2 id="fq-auto-quote">
+ <title>Automatisierte Abfrage von Kursen mit &app-cli;</title>
- <para><userinput>gnc-fq-update</userinput> startet &app-perl;s Standardmodul
- <acronym><ulink url="&url-cpan;">CPAN</ulink></acronym>
+ <para>Mit dem Kommando <command>gnucash-cli --quotes get &user-datafile;</command>
<footnote>
- <simpara>Siehe <ulink url="&url-cpan;misc/cpan-faq.html">CPAN Frequently Asked Questions</ulink> für weitere
- Informationen.
+ <simpara>Der alte Befehl <command>gnucash --add-price-quotes &user-datafile;</command> ist seit &app; 5.0
+ nicht mehr verfügbar!
</simpara>
</footnote>
- um die Installation vorzunehmen. Wenn Sie CPAN zum ersten Mal verwenden, müssen Sie es
- konfigurieren, wobei Sie auf den meisten Systemen jedoch die Standardvorgaben akzeptieren
- und die erste Frage <computeroutput>Are you ready for manual configuration?
- [yes]</computeroutput> mit <userinput>no</userinput> beantworten können, damit &app-fq;
- erfolgreich installiert wird.
- </para>
- </sect2>
-
- <sect2 id="gnc-fq-dump">
- <title>gnc-fq-dump</title>
-<!-- Todo: insert link to wiki and/or guide -->
- <abstract>
- <para>Dieses Programm liefert Kursdaten für eine Quelle und eine Liste von Symbolen in einem Format, das
- für Menschen leicht zu lesen ist. Es ist nützlich, um zu überprüfen, ob eine bestimmte
- Online-Kursquelle erreichbar ist und funktioniert.
- </para>
- </abstract>
-
- <para>Mit Hilfe diesen Befehls können Sie überprüfen, ob das <xref linkend="tool-ge-Symbol" />, welches
- Sie für Ihr Wertpapier zum Online-Kursabruf verwenden möchten, bei der gewünschten
- <xref linkend="tool-ge-TypeQuoteSource" /> funktioniert.
- </para>
-
- <tip>
- <para>Mit <userinput>gnc-fq-dump</userinput> können Sie Symbole schneller als aus &app; heraus
- überprüfen, wenn während des Abrufs mit &app; ein Fehler auftritt. Dies kann Sie davor
- bewahren, &app; mit aktiviertem Debug-Logging laufen zu lassen, während Sie ein nicht
- funktionierendes Symbol überprüfen.
- </para>
- </tip>
-
- <itemizedlist>
- <listitem>
- <para>Um ausführliche Inforamtionen zu einem Wertpapier zu erhalten, führen Sie in der Befehlszeile
- einen Befehl in dieser Form aus:
- <cmdsynopsis>
- <command>gnc-fq-dump</command>
- <arg choice="opt">
- -v
- </arg>
-
- <arg choice="plain">
- <replaceable>Quelle</replaceable>
- </arg>
-
- <arg choice="plain" rep="repeat">
- <replaceable>Symbol</replaceable>
- </arg>
- </cmdsynopsis>
- zum Beispiel <command>gnc-fq-dump -v yahoo_json IBM</command>.
+ können Sie die aktuellen Kurse Ihrer Devisen und Wertpapiere abrufen und direkt in ihre
+ &app;-Datendatei schreiben ohne die Benutzeroberfläche zu starten. Somit ist eine
+ automatische, regelmäßige Aktualisierung der Kursdatenbank möglich.
+ <note>
+ <para>Der Befehl schlägt fehl, wenn kein exclusiver Zugriff auf die Datendatei möglich ist, z.B. weil
+ die Datendatei in einer anderen &app; Instanz geöffnet ist oder die letzte Sitzung für
+ die Datei abgestürzt ist.
</para>
- </listitem>
-
- <listitem>
- <para>Zum Abrufen eines Wechselkurses führen Sie folgenden Befehl aus: <command>gnc-fq-dump
- <optional>-v</optional> currency USD EUR</command>
- <footnote>
- <para>Seit &app-fq; 1.41 ist die Standardquelle für Währungen <quote>Alpha Vantage</quote>. Lesen Sie
- auch die Hinweise zu <xref linkend="gnc-tbl-fq-currency-source" />.
- </para>
- </footnote>
+ </note>
+ </para>
- <footnote>
- <para>Die alten Yahoo-Währungen sind immer noch verfügbar als <command>gnc-fq-dump yahoo_json
- USDEUR=X</command>.
- </para>
- </footnote>
+ <para>Die angegebene Datei &user-datafile; ist abhängig von dem Namen und dem Speicherort Ihrer
+ Datendatei. Dies lässt sich anhand des Namens feststellen, der im oberen Rahmen des &app;
+ Fensters vor dem <quote>-</quote> angezeigt wird.
+ <tip>
+ <para>Der Dateiname ist auch in der Liste der zuletzt geöffneten Dateien im &gm.file;-Menü zu finden.
+ Wenn Sie den Mauszeiger über dem Menüeintrag mit der Nummer 1 in der Liste der zuletzt
+ geöffneten Dateien platzieren, wird in der <guilabel>Statusleiste</guilabel> die
+ vollständige Dateibezeichnung angezeigt.
</para>
- </listitem>
- </itemizedlist>
-
- <para>Um zu testen, ob &app-fq; für Währungen innerhalb von &app; funktioniert,
- <orderedlist numeration="arabic">
- <listitem>
- <para>nehmen Sie eine Buchung zwischen dem gewünschtem Handelsgut und der Buchwährung,
- </para>
- </listitem>
-
- <listitem>
- <para>machen einen Rechtsklick darauf, und dann
- </para>
- </listitem>
-
- <listitem>
- <para>wählen Sie im Kontextmenü die Option &gmi.ac.ed-ex;.
- </para>
- </listitem>
- </orderedlist>
- Der <xref linkend="trans-win-enter" /> wird angezeigt. Klicken Sie auf die Schaltfläche
- <guilabel>Wechselkurs abrufen</guilabel>, und wenn alles gut läuft, wird der aktuelle Kurs
- in das Feld für den Wechselkurs eingetragen.
+ </tip>
</para>
- </sect2>
-
- <sect2 id="gnc-fq-helper">
- <title>gnc-fq-helper</title>
- <para>Dies ist ein Skript, das &app; zum Abrufen von Kursen verwendet und musss normalerweise vom Benutzer
- nicht verwendet werden. Sollte der Abruf eines Kurses in &app; zu einem Fehlverhalten
- führen, kann mit diesem Skript eine Diagnose durchgeführt werden und hilft Entwicklern bei
- der Entscheidung, ob der Fehler in &app; oder &app-fq; liegt.
+ <para>Sie müssen den Befehl &app-cli; bei einem Scheduler (Zeitplaner) eintragen, um die Onlinekurse
+ automatisch und regelmäßig zu erhalten. Die Methode hängt von Ihrem Betriebssystem ab.
</para>
- </sect2>
- </sect1>
- <sect1 id="finance-quote-scheduler">
- <title>Automatisierte Abfrage von Kursen</title>
+ <example>
+ <title>Automatischer Kursabruf jeden Freitag um 16:00 Uhr</title>
- <para>Mit dem Kommando <command>gnucash-cli --quotes get &user-datafile;</command>
- <footnote>
- <simpara>Der Befehl für den Online-Kursabruf wurde ab &app; 4.0 geändert. Der alte Befehl <command>gnucash
- --add-price-quotes &user-datafile;</command> ist immer noch verfügbar, aber er ist
- veraltet und wird in einer zukünftigen Version entfernt werden. Wenn Sie ein Upgrade von
- &app; 3.11 oder einer früheren Version durchgeführt haben, wird empfohlen, den neuen
- Befehl <command>gnucash-cli</command> zu verwenden.
- </simpara>
- </footnote>
- können Sie die aktuellen Kurse Ihrer Devisen und Wertpapiere abrufen und direkt in ihre
- &app;-Datendatei schreiben ohne die Benutzeroberfläche zu starten. Somit ist eine
- automatische, regelmäßige Aktualisierung der Kursdatenbank möglich.
- <note>
- <para>Der Befehl schlägt fehl, wenn kein exclusiver Zugriff auf die Datendatei möglich ist, z.B. weil
- die Datendatei in einer anderen &app; Instanz geöffnet ist oder die letzte Sitzung für
- die Datei abgestürzt ist.
- </para>
- </note>
- </para>
+ <procedure>
+ <title>Unter &lin; und &mac;</title>
- <para>Die angegebene Datei &user-datafile; ist abhängig von dem Namen und dem Speicherort Ihrer
- Datendatei. Dies lässt sich anhand des Namens feststellen, der im oberen Rahmen des &app;
- Fensters vor dem <quote>-</quote> angezeigt wird.
- <tip>
- <para>Der Dateiname ist auch in der Liste der zuletzt geöffneten Dateien im &gm.file;-Menü zu finden.
- Wenn Sie den Mauszeiger über dem Menüeintrag mit der Nummer 1 in der Liste der zuletzt
- geöffneten Dateien platzieren, wird in der <guilabel>Statusleiste</guilabel> die
- vollständige Dateibezeichnung angezeigt.
- </para>
- </tip>
- </para>
+ <para>Eintragen des Befehls zum Kursabruf per <command>gnucash-cli</command> mittels
+ <application>cron</application>.
+ </para>
- <para>Sie müssen den Befehl <command>gnucash-cli</command> bei einem Scheduler (Zeitplaner) eintragen, um
- die Onlinekurse automatisch und regelmäßig zu erhalten. Die Methode hängt von Ihrem
- Betriebssystem ab.
- </para>
+ <step>
+ <simpara>Führen Sie das Kommando <command>crontab -e</command> aus.
+ </simpara>
+ </step>
- <example>
- <title>Automatischer Kursabruf jeden Freitag um 16:00 Uhr</title>
+ <step>
+ <para>Fügen Sie die folgende Zeile in Ihre crontab ein:
+ <informalexample>
+<?dbfo pgwide="1"?>
+<screen>
+0 16 * * 5 gnucash-cli --quotes get &user-datafile; > /dev/null 2>&1
+</screen>
+ </informalexample>
- <procedure>
- <title>Unter &lin; und &mac;</title>
+ <important>
+ <para>Läuft unter &lin; auf Ihrem Rechner zu dem Zeitpunkt des Kursabrufs keine graphische
+ Benutzeroberfläche, die bereits den dbus gestartet hat, so müssen Sie den
+ Eintrag stattdessen wie folgt vornehmen:
+ <informalexample>
+<?dbfo pgwide="1"?>
+<screen>
+0 16 * * 5 env `dbus-launch` sh -c 'trap "kill $DBUS_SESSION_BUS_PID" EXIT;
+gnucash-cli --quotes get &user-datafile; > /dev/null 2>&1
+</screen>
+ </informalexample>
+ (Den Zeilenumbruch nicht in die crontab übernehmen, der wurde hier nur zum
+ Zwecke der Lesbarkeit eingefügt.)
+ </para>
+ </important>
+ </para>
+ </step>
+ </procedure>
- <para>Eintragen des Befehls zum Kursabruf per <command>gnucash-cli</command> mittels
- <application>cron</application>.
- </para>
+ <procedure>
+ <title>Unter &win;</title>
- <step>
- <simpara>Führen Sie das Kommando <command>crontab -e</command> aus.
- </simpara>
- </step>
-
- <step>
- <para>Fügen Sie die folgende Zeile in Ihre crontab ein:
- <informalexample>
-<screen>0 16 * * 5 gnucash-cli --quotes get &user-datafile; > /dev/null 2>&1</screen>
- </informalexample>
-
- <important>
- <para>Läuft auf Ihrem Rechner zu dem Zeitpunkt des Kursabrufs keine graphische Benutzeroberfläche, die
- bereits den dbus gestartet hat, so müssen Sie den Eintrag stattdessen wie folgt
- vornehmen:
- <informalexample>
-<screen>0 16 * * 5 env `dbus-launch` sh -c 'trap "kill $DBUS_SESSION_BUS_PID" EXIT;
-gnucash-cli --quotes get &user-datafile; > /dev/null 2>&1</screen>
- </informalexample>
- (Die Zeilenumbrüche nicht in die crontab übernehmen, die wurden hier nur zum
- Zwecke der Lesbarkeit eingefügt.)
- </para>
- </important>
+ <para>Anlegen des Kursabrufs per <command>gnucash-cli</command> mit der Aufgabenplanung.
</para>
- </step>
- </procedure>
- <procedure>
- <title>Unter &win;</title>
-
- <para>Anlegen des Kursabrufs per <command>gnucash-cli</command> mit der Aufgabenplanung.
- </para>
-
- <step>
- <simpara>Wählen Sie &mc.winOS.sys.tasks; .
- </simpara>
- </step>
+ <step>
+ <simpara>Wählen Sie &mc.winOS.sys.tasks;.
+ </simpara>
+ </step>
- <step>
- <simpara>Klicken Sie auf &gmi.winOS.sys.task;.
- </simpara>
- </step>
+ <step>
+ <simpara>Klicken Sie auf &gmi.winOS.sys.task;.
+ </simpara>
+ </step>
- <step>
- <simpara>Geben Sie die entsprechenden Angaben im Fenster <guilabel>Aufgabe erstellen</guilabel> ein.
- </simpara>
- </step>
- </procedure>
+ <step>
+ <simpara>Geben Sie die entsprechenden Angaben im Fenster <guilabel>Aufgabe erstellen</guilabel> ein.
+ </simpara>
+ </step>
+ </procedure>
- <para>Passen Sie die Zeit an den Börsenschluss an und bedenken Sie, dass bei
- <emphasis>Fondskursen</emphasis> das Netto-Anlagevermögen (NAV) deutlich nach
- Börsenschluss ermittlet wird. Eine Beschreibung zu den Typen finden Sie unter
- <xref linkend="tool-price" />.
+ <para>Passen Sie die Zeit an den Börsenschluss an und bedenken Sie, dass bei
+ <emphasis>Fondskursen</emphasis> das Netto-Anlagevermögen (NAV) deutlich nach
+ Börsenschluss ermittlet wird. Eine Beschreibung zu den Typen finden Sie unter
+ <xref linkend="tool-price" />.
<!-- FIXME: adjust the link to a proper ID -->
- </para>
- </example>
+ </para>
+ </example>
- <para>Einige Benutzer haben im &app; Wiki unter
- <ulink url="&url-wiki-de;Aktienhandel">Aktienhandel</ulink> und ausführlicher im
- englischsprachigen Wiki
- <ulink url="&url-wiki-OQ;#Updating_enabled_Quotes_from_outside_GnuCash">Online Quotes Page on
- GnuCash Wiki</ulink> ihre Erfahrungen und weiter Ergänzungen zusammengestellt.
- </para>
+ <para>Einige Benutzer haben im &app; Wiki unter
+ <ulink url="&url-wiki-de;Aktienhandel">Aktienhandel</ulink> und ausführlicher im
+ englischsprachigen Wiki
+ <ulink url="&url-wiki-OQ;#Updating_enabled_Quotes_from_outside_GnuCash">Online Quotes Page
+ on GnuCash Wiki</ulink> ihre Erfahrungen und weiter Ergänzungen zusammengestellt.
+ </para>
+ </sect2>
</sect1>
</chapter>
commit b811696911e0bc7dfcbbb24e9a71b1df3b935416
Author: Christian Wehling <christian.wehling at web.de>
Date: Tue Apr 11 16:23:57 2023 +0200
docbook: entities for GUI-struct-elements of MAC-Applications
diff --git a/docbook/gnc-docbookx.dtd b/docbook/gnc-docbookx.dtd
index e599839d..9d4a9d73 100644
--- a/docbook/gnc-docbookx.dtd
+++ b/docbook/gnc-docbookx.dtd
@@ -58,9 +58,9 @@ https://www.w3.org/2003/entities/2007/w3centities-f.ent
<!ENTITY appname "GnuCash"> <!-- This should be used, where no further markup is desired, e.g. in GUI elements, URLs -->
<!ENTITY app "<application>&appname;</application>"> <!-- This should
be used in normal text -->
-<!ENTITY app-cli "<command>gnucash-cli</command>">
<!ENTITY app-aqb "<application>AqBanking</application>">
<!ENTITY app-aoo "<application>Apache OpenOffice</application>">
+<!ENTITY app-cli "<application>gnucash-cli</application>">
<!ENTITY app-fq "<application>Finance::Quote</application>">
<!ENTITY app-gfa "<application>Gnucash for Android</application>">
<!ENTITY app-lo "<application>LibreOffice</application>">
diff --git a/docbook/gnc-gui-C.dtd b/docbook/gnc-gui-C.dtd
index 959cc2c6..81da22df 100644
--- a/docbook/gnc-gui-C.dtd
+++ b/docbook/gnc-gui-C.dtd
@@ -403,6 +403,8 @@
<!ENTITY % gmi.macOS.sys.gen.lang "<guimenuitem>Language & Region</guimenuitem>">
<!ENTITY % gsm.macOS.gc "<guisubmenu>GnuCash</guisubmenu>">
<!ENTITY % gmi.macOS.gc.pref "<guimenuitem>Preference</guimenuitem>">
+<!ENTITY % gm.macOS.appl "<guimenu>Applications</guimenu>">
+<!ENTITY % gmi.macOS.appl.util "<guimenuitem>Utilities</guimenuitem>">
<!-- keycaps for keycombos and shortcuts -->
<!ENTITY % kc.alt '<keycap function="alt">Alt</keycap>'>
diff --git a/docbook/gnc-gui-de.dtd b/docbook/gnc-gui-de.dtd
index 9b93cf4d..16fabb11 100644
--- a/docbook/gnc-gui-de.dtd
+++ b/docbook/gnc-gui-de.dtd
@@ -403,6 +403,8 @@
<!ENTITY % gmi.macOS.sys.gen.lang "<guimenuitem>Sprache und Region</guimenuitem>">
<!ENTITY % gsm.macOS.gc "<guisubmenu>GnuCash</guisubmenu>">
<!ENTITY % gmi.macOS.gc.pref "<guimenuitem>Einstellungen</guimenuitem>">
+<!ENTITY % gm.macOS.appl "<guimenu>Programme</guimenu>">
+<!ENTITY % gmi.macOS.appl.util "<guimenuitem>Dienstprogramme</guimenuitem>">
<!-- keycaps for keycombos and shortcuts -->
<!ENTITY % kc.alt '<keycap function="alt">Alt</keycap>'>
diff --git a/docbook/gnc-gui-struct.dtd b/docbook/gnc-gui-struct.dtd
index 44a08d36..ec11a3a9 100644
--- a/docbook/gnc-gui-struct.dtd
+++ b/docbook/gnc-gui-struct.dtd
@@ -403,6 +403,8 @@
<!ENTITY gmi.macOS.sys.gen.lang "%gmi.macOS.sys.gen.lang;">
<!ENTITY gsm.macOS.gc "%gsm.macOS.gc;">
<!ENTITY gmi.macOS.gc.pref "%gmi.macOS.gc.pref;">
+<!ENTITY gm.macOS.appl "%gm.macOS.appl;">
+<!ENTITY gmi.macOS.appl.util "%gmi.macOS.appl.util;">
<!-- keycaps for keycombos and shortcuts -->
<!ENTITY kc.alt "%kc.alt;">
Summary of changes:
C/guide/ch_invest.xml | 4 +-
C/manual/ch_Account-Actions.xml | 2 +-
C/manual/ch_Finance-Quote.xml | 267 ++++++++++--------
C/manual/ch_Transactions.xml | 2 +-
de/manual/ch_Finance-Quote.xml | 601 +++++++++++++++++++---------------------
de/manual/ch_Transactions.xml | 2 +-
docbook/gnc-docbookx.dtd | 2 +-
docbook/gnc-gui-C.dtd | 2 +
docbook/gnc-gui-de.dtd | 2 +
docbook/gnc-gui-struct.dtd | 2 +
10 files changed, 455 insertions(+), 431 deletions(-)
More information about the gnucash-changes
mailing list