gnucash-docs maint: Chapter "Online-Quotes" created.
Frank H.Ellenberger
fell at code.gnucash.org
Fri Dec 17 22:31:11 EST 2021
Updated via https://github.com/Gnucash/gnucash-docs/commit/13fa2d9a (commit)
from https://github.com/Gnucash/gnucash-docs/commit/af600017 (commit)
commit 13fa2d9a518ff3cecced048b8359c74538dfe5a7
Author: Christian Wehling <christian.wehling at web.de>
Date: Mon Sep 27 21:46:52 2021 +0200
Chapter "Online-Quotes" created.
* Description of the installation and configuration of F::Q (moved from
Help_ch_Account-Actions-xml).
* Some passages taken from guide/C/ch_invest.xml in PR #192. (Author
usamimikamen-sk)
* adjust some internal references
diff --git a/docbook/gnc-docbookx.dtd b/docbook/gnc-docbookx.dtd
index 2948f8a6..a3fa4127 100644
--- a/docbook/gnc-docbookx.dtd
+++ b/docbook/gnc-docbookx.dtd
@@ -145,12 +145,14 @@ own entity definitions to use across all of our DocBook pages. -->
<!-- b) Third party URLs: -->
<!ENTITY url-av "https://www.alphavantage.co/"> <!-- A F::Q source, which requires registration -->
+<!ENTITY url-cpan "https://www.cpan.org/"> <!-- Comprehensive Perl Archive Network -->
<!ENTITY url-gh "https://github.com/"> <!-- we want to reference our libs, too. -->
<!ENTITY url-gh-we "https://github.com/Gnucash/"> <!-- Our project page -->
<!ENTITY url-gh-gc "https://github.com/Gnucash/gnucash/"> <!-- Our program repo -->
<!ENTITY url-gh-gc-maint "https://github.com/Gnucash/gnucash/tree/maint/"> <!-- Append the desired path -->
<!ENTITY url-gnome-dev "https://developer.gnome.org/"> <!-- Append the desired topic -->
<!ENTITY url-gnu "https://www.gnu.org/"> <!-- Append the desired topic -->
+<!ENTITY url-repo "https://repology.org/project/"> <!-- The packaging hub, append the desired project -->
<!ENTITY url-wp-de "https://de.wikipedia.org/wiki/"> <!-- Append the desired topic -->
<!ENTITY url-wp-en "https://en.wikipedia.org/wiki/"> <!-- Append the desired topic -->
<!ENTITY url-wp-it "https://it.wikipedia.org/wiki/"> <!-- Append the desired topic -->
diff --git a/manual/C/CMakeLists.txt b/manual/C/CMakeLists.txt
index c4b56972..a737bc20 100644
--- a/manual/C/CMakeLists.txt
+++ b/manual/C/CMakeLists.txt
@@ -9,6 +9,7 @@ set (entities
Help_ch_Tools_Assistants.xml
Help_ch_Reports.xml
Help_ch_Customize.xml
+ ch_Finance-Quote.xml
Help_chtacctseg.xml
Help_chartofaccts.xml
Help_legal.xml
diff --git a/manual/C/Help_ch_Account-Actions.xml b/manual/C/Help_ch_Account-Actions.xml
index e4affc45..b49abfd4 100644
--- a/manual/C/Help_ch_Account-Actions.xml
+++ b/manual/C/Help_ch_Account-Actions.xml
@@ -38,8 +38,7 @@
<warning>
<para>The Accounts Payable and Accounts Receivable types are used internally by &app;’s business
features. Transactions involving these accounts should not be added, changed or deleted in
- any way other than by using
- <itemizedlist>
+ any way other than by using<itemizedlist>
<listitem>
<para>post/unpost bill/invoice/voucher or
</para>
@@ -329,8 +328,7 @@
chart of accounts is as a tree. The main branches represent entire categories or groups, while
the leaves of the tree denote individual bank accounts or expense categories. When a summary
report is requested, typically only the main branches are shown in the report, rather than the
- individual accounts. For example, a chart of accounts might look like the following:
- <xi:include href="Help_chtacctseg.xml"/>
+ individual accounts. For example, a chart of accounts might look like the following:<xi:include href="Help_chtacctseg.xml"/>
</para>
<note id="accts-code">
@@ -369,11 +367,9 @@
<sect1 id="acct-create">
<title>Creating a New Account</title>
- <para>To create a new account go to
- <menuchoice>
+ <para>To create a new account go to<menuchoice>
<guimenu>Actions</guimenu><guimenuitem>New Account...</guimenuitem>
- </menuchoice>
- or click the <guibutton>New</guibutton> <emphasis>Toolbar</emphasis> icon in the Account Tree
+ </menuchoice>or click the <guibutton>New</guibutton> <emphasis>Toolbar</emphasis> icon in the Account Tree
Window. The <guilabel>New Account</guilabel> dialog will be opened.
</para>
@@ -422,11 +418,9 @@
provides a way of connecting the account to stock information if it is one of the currency,
mutual fund or stock account types. It can also be flagged as a
<link linkend="accts-placeholder">Placeholder</link> account. It displays if it is flagged
- as a <guilabel>Tax Related</guilabel> account (which is set through the
- <menuchoice>
+ as a <guilabel>Tax Related</guilabel> account (which is set through the<menuchoice>
<guimenu>Edit</guimenu><guimenuitem>Tax Report Options</guimenuitem>
- </menuchoice>
- dialog).
+ </menuchoice>dialog).
</para>
<para>There are seven fields in the <guilabel>Identification</guilabel> section of this tab.
@@ -521,12 +515,10 @@
<para>The <guilabel>Tax Related</guilabel> check-box means that an account has been flagged to be included
in the Tax Schedule Report. This flag is only displayed on the <guilabel>Edit
Account</guilabel> dialog and is set in the <guilabel>Income Tax Information</guilabel>
- dialog (
- <menuchoice>
+ dialog (<menuchoice>
<guimenu>Edit</guimenu><guimenuitem>Tax Report Options</guimenuitem>
- </menuchoice>
- ). For related reports see the examples like <guilabel>Tax Schedule Report and TXF
- Export</guilabel> in (<xref linkend="report-regional"/>).
+ </menuchoice>). For related reports see the examples like <guilabel>Tax Schedule Report and TXF Export</guilabel>
+ in (<xref linkend="report-regional"/>).
</para>
<para>The <guilabel>Placeholder</guilabel> check-box sets an account to read-only status and prevents the
@@ -541,12 +533,10 @@
</note>
<para>The <guilabel>Hidden</guilabel> check box hides an account (and any sub-accounts) in the account
- tree. To reset this option, you will first need to open the
- <menuchoice>
+ tree. To reset this option, you will first need to open the<menuchoice>
<guimenu>View</guimenu><guimenuitem>Filter By...</guimenuitem>
- </menuchoice>
- dialog for the account tree and check the <guilabel>Show hidden accounts</guilabel> option.
- Doing so will allow you to select the account and reopen this dialog.
+ </menuchoice>dialog for the account tree and check the <guilabel>Show hidden accounts</guilabel> option. Doing so
+ will allow you to select the account and reopen this dialog.
</para>
<note id="accts-hidden">
@@ -560,8 +550,7 @@
</para>
<para>The next pane contains an account tree to choose a <guilabel>Parent Account</guilabel>. To create a
- new account tree select <guilabel>New top level account</guilabel>.
- <note>
+ new account tree select <guilabel>New top level account</guilabel>.<note>
<para>The available choices in the <guilabel>Account Type</guilabel> pane depends on the selected account
in the <guilabel>Parent Account</guilabel> pane. For example if the <guilabel>Parent
Account</guilabel> is <emphasis>Assets</emphasis> you will see only
@@ -570,235 +559,118 @@
</para>
</note>
</para>
+ </sect2>
- <sect3 id="Online-price-setup">
- <title>Steps to enable Online price updating</title>
-
- <orderedlist>
- <listitem>
- <para>&app; relies on an external tool to retrieve online quotes. This tool is a Perl module named
- &app-fq; and has to be installed on your computer independently
- from &app;. The first step in enabling online price updating should thus be to ensure
- &app-fq; is properly installed.
- </para>
+ <sect2 id="accts-online-quotes">
+ <title>Steps to enable Online Quotes updating</title>
- <para>To determine if the Perl module &app-fq; is already installed on
- your system, type <quote>perldoc Finance::Quote</quote> in a terminal window and check
- to see if there is any documentation available. If you see the documentation, then the
- module is installed, if you do not see the documentation, then it has not been
- installed.
- </para>
+ <orderedlist>
+ <listitem>
+ <para>&app; uses an external tool to retrieve online courses. This tool is a Perl module called &app-fq;
+ and must be installed independently of &app; on your computer.
+ </para>
- <para>Installing &app-fq; differs from one operating system to another.
- For the various supported systems, you can follow these guidelines:
+ <tip>
+ <para>The installation of &app-fq; is described under <xref linkend="finance-quote-install" />.
</para>
+ </tip>
+ </listitem>
- <itemizedlist>
- <listitem>
- <para>&lin;: Most &lin; distributions (like Fedora, openSuse,
- Mandriva, Ubuntu, and so on) have a package in their software repositories for the
- &app-fq; perl module. So in most cases, you can
- simply use your preferred package manager (yum, apt, rpm, synaptics, yast,...) to
- install the module. The name of the package may vary from one distribution to
- another. It’s often called something like <quote>perl-Finance-Quote</quote>.
- </para>
- </listitem>
-
- <listitem>
- <para>&win;: &app-fq; on
- &win; requires perl to be installed already. If you haven’t done so, you
- should first install ActivePerl, or more recently, Strawberry Perl.
- </para>
+ <listitem>
+ <para>Create the Account for the mutual fund or stock with it listed in the
+ <guilabel>Security/Currency</guilabel> field, as described above.
+ </para>
- <para>The &win; installer from the &app; home page comes with a small helper program to install
- &app-fq; for you. You can find it in the Start
- Menu under the &app; group and is called <quote>Install Online Price
- Retrieval</quote>.
- </para>
- </listitem>
+ <tip>
+ <para>When creating these accounts it is a good time to create income accounts to track dividends, capital
+ gains (long and short) and expense account(s) for tracking commissions and losses (if
+ you track losses as expenses).
+ </para>
+ </tip>
+ </listitem>
- <listitem>
- <para>&mac;: If you have installed &app; from the installer found
- on the &app; home page, &app-fq; is already
- installed for you.
- </para>
- </listitem>
+ <listitem>
+ <para>Create the mutual fund or stock with either the <guilabel>Security Editor</guilabel> for existing
+ stock/funds or the <guilabel>New Security/Currency</guilabel> dialog for a new
+ stock/fund.
+ </para>
- <listitem>
- <para>If none of the above applies to your setup, you can try these alternative, more generic
- instructions:
- </para>
+ <para>Select <guilabel>Get Online Quotes</guilabel>, <guilabel>Type of Quote Source</guilabel> and
+ <guilabel>Timezone.</guilabel>
+ </para>
- <orderedlist>
- <listitem>
- <para>Close any &app; applications you have running.
- </para>
- </listitem>
-
- <listitem>
- <para>Locate the folder where &app; is installed by searching for <quote>gnc-fq-update</quote> (without
- the quotes).
- </para>
- </listitem>
-
- <listitem>
- <para>Change to that directory, open a root shell and run the command <command>gnc-fq-update</command>.
- This will launch a Perl CPAN update session that will go out onto the Internet
- and install the &app-fq; module and its
- dependencies on your system. The gnc-fq-update program is interactive,
- however, with most systems you should be able to answer <quote>no</quote> to
- the first question: <quote>Are you ready for manual configuration?
- [yes]</quote> and the update will continue automatically from that point.
- </para>
- </listitem>
- </orderedlist>
- </listitem>
- </itemizedlist>
-
- <para>After installation is complete, you should run the <quote>gnc-fq-check</quote> test program, in the
- same directory, distributed with &app; to test if
- &app-fq; is installed and working properly.
- </para>
+ <para>Online currency quotes require that the check-box for Online quotes and the timezone be selected in
+ the Security screen and the Security Editor check-box for "get quote" box is checked for
+ those currencies that are to be downloaded.
+ </para>
- <note>
- <para>If you feel uncomfortable about performing any of these steps, please either email the &app;-user
- mailing list (<email>gnucash-user at gnucash.org</email>) for help or come to the &app;
- IRC channel on irc.gnome.org. More information is available on the &app; Wiki FAQ
- for example <ulink url="&url-wiki-faq-quot;" /> You can also leave out this step and
- manually update your stock prices.
+ <itemizedlist>
+ <listitem>
+ <para><guilabel>Get Online Quotes</guilabel> This check-box is to enable this security/fund to have quotes
+ downloaded from an online source.
</para>
- </note>
- </listitem>
-
- <listitem>
- <para>Create the Account for the mutual fund or stock with it listed in the
- <guilabel>Security/Currency</guilabel> field, as described above.
- </para>
+ </listitem>
- <tip>
- <para>When creating these accounts it is a good time to create income accounts to track dividends, capital
- gains (long and short) and expense account(s) for tracking commissions and losses
- (if you track losses as expenses).
+ <listitem>
+ <para><guilabel>Type of Quote Source</guilabel> use the radio buttons to select the type of source for the
+ Online quotes. <guilabel>Multiple:</guilabel> quote sources like
+ <quote>Europe</quote> should be used if fail-over to multiple sites are desirable.
+ <guilabel>Single:</guilabel> selections will only return information from the
+ specified source.
</para>
- </tip>
- </listitem>
-
- <listitem>
- <para>Create the mutual fund or stock with either the <guilabel>Security Editor</guilabel> for existing
- stock/funds or the <guilabel>New Security/Currency</guilabel> dialog for a new
- stock/fund.
- </para>
-
- <para>Select <guilabel>Get Online Quotes</guilabel>, <guilabel>Type of Quote Source</guilabel> and
- <guilabel>Timezone.</guilabel>
- </para>
-
- <para>Online currency quotes require that the check-box for Online quotes and the timezone be selected in
- the Security screen and the Security Editor check-box for "get quote" box is checked
- for those currencies that are to be downloaded.
- </para>
-
- <itemizedlist>
- <listitem>
- <para><guilabel>Get Online Quotes</guilabel> This check-box is to enable this security/fund to have quotes
- downloaded from an online source.
- </para>
- </listitem>
-
- <listitem>
- <para><guilabel>Type of Quote Source</guilabel> use the radio buttons to select the type of source for the
- Online quotes. <guilabel>Multiple:</guilabel> quote sources like
- <quote>Europe</quote> should be used if fail-over to multiple sites are desirable.
- <guilabel>Single:</guilabel> selections will only return information from the
- specified source.
- </para>
-
- <para>After selecting the type of source for price quotes, select a quote source from the pull-down menu.
- For details on currently supported sources see <xref linkend="fq-sources"></xref>.
- </para>
- <note>
- <para>Note that Yahoo will provide price quotes for many mutual funds including Fidelity, T.Rowe Price and
- Vanguard, and that the quoted prices at Yahoo should be identical to those that
- may be found at the source sites.
- </para>
- </note>
-
- <para>If you are outside the US and use one of the different Yahoo sources or multiple sources containing
- Yahoo, you should append the market code for the security such as PA for Paris, BE
- for Berlin, etc. Example: 12150.PA (a Peugeot security in the Paris market).
- <xref linkend="gnc-tbl-fq-yahoo-exchange-codes"></xref> below lists suffixes for
- various markets around the world.
- </para>
-
- <para>Pseudo-symbols for TIAA-CREF funds are listed in table <xref linkend="PsSymbs-TIAA-CREF"></xref>.
- </para>
- </listitem>
+ <para>After selecting the type of source for price quotes, select a quote source from the pull-down menu.
+ For details on currently supported sources see <xref linkend="fq-sources"></xref>.
+ </para>
- <listitem>
- <para><guilabel>Timezone for these quotes:</guilabel> Select the timezone for the source of the online
- quotes you are receiving. For example, Yahoo normally quotes Eastern timezone, so
- choose America/New York if you use that quote source.
+ <note>
+ <para>Note that Yahoo will provide price quotes for many mutual funds including Fidelity, T.Rowe Price and
+ Vanguard, and that the quoted prices at Yahoo should be identical to those that
+ may be found at the source sites.
</para>
- </listitem>
- </itemizedlist>
- </listitem>
-
- <listitem>
- <para>Select a commodity to the Price Editor.
- </para>
- </listitem>
-
- <listitem>
- <para>Select <guibutton>Get Quotes</guibutton> in the Price Editor.
- </para>
- </listitem>
-
- <listitem>
- <para>Check the latest price for the selected security.
- </para>
- </listitem>
- </orderedlist>
-
- <para>If you wish to update price quotes from the command line, you can do so by the following command:
- </para>
+ </note>
- <para><userinput>gnucash --add-price-quotes <gnucash-file-name></userinput>
- </para>
+ <para>If you are outside the US and use one of the different Yahoo sources or multiple sources containing
+ Yahoo, you should append the market code for the security such as PA for Paris, BE
+ for Berlin, etc. Example: 12150.PA (a Peugeot security in the Paris market).
+ <xref linkend="gnc-tbl-fq-yahoo-exchange-codes"></xref> below lists suffixes for
+ various markets around the world.
+ </para>
- <para>The command <userinput>gnucash --add-price-quotes <gnucash-file-name></userinput> can be used
- to fetch the current prices of your stocks. The file specified
- <quote><gnucash-file-name></quote> will depend on the name and location of your data
- file. This can be determined by the name displayed in the top frame of the &app; window,
- before the <quote>-</quote>. The file name can also be found under <guimenu>File</guimenu>
- in the list of recently opened file; the first item, numbered 1, is the name of the
- currently open file.
- </para>
+ <para>Pseudo-symbols for TIAA-CREF funds are listed in table <xref linkend="PsSymbs-TIAA-CREF"></xref>.
+ </para>
+ </listitem>
- <para>This can be automated in &mac; by creating a crontab entry. For example, to update your file every
- Friday evening (18:00) after markets close (modify the time accordingly for your time
- zone), you could add the following to your personal crontab:
- </para>
+ <listitem>
+ <para><guilabel>Timezone for these quotes:</guilabel> Select the timezone for the source of the online
+ quotes you are receiving. For example, Yahoo normally quotes Eastern timezone, so
+ choose America/New York if you use that quote source.
+ </para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
- <para><userinput>0 18 * * 5 /path/to/gnucash --add-price-quotes /path/to/gnucash-filename > /dev/null
- 2>&1'</userinput>
- </para>
+ <listitem>
+ <para>Select a commodity to the Price Editor.
+ </para>
+ </listitem>
- <para>For &lin;, which needs dbus, usually started by the desktop manager, to communicate with dconf or
- gconf:
- </para>
+ <listitem>
+ <para>Select <guibutton>Get Quotes</guibutton> in the Price Editor.
+ </para>
+ </listitem>
- <para><userinput>0 18 * * 5 env `dbus-launch` sh -c 'trap "kill $DBUS_SESSION_BUS_PID" EXIT;
- /path/to/gnucash --add-price-quotes /path/to/gnucash-filename > /dev/null
- 2>&1'</userinput>
- </para>
+ <listitem>
+ <para>Check the latest price for the selected security.
+ </para>
+ </listitem>
+ </orderedlist>
- <para>Remember that Mutual Fund <quote>prices</quote> are really <quote>Net Asset Value</quote> and
- require several hours after the exchange closes before being available. If NAVs are
- downloaded before the current days NAVs are determined, yesterday’s NAVs are
- retrieved.
- </para>
- </sect3>
+ <para>Remember that Mutual Fund <quote>prices</quote> are really <quote>Net Asset Value</quote> and
+ require several hours after the exchange closes before being available. If NAVs are
+ downloaded before the current days NAVs are determined, yesterday’s NAVs are
+ retrieved.
+ </para>
</sect2>
<sect2 id="open-balance">
@@ -860,15 +732,13 @@
<para>The <guilabel>Edit Account</guilabel> dialog consists of just the <guilabel>General</guilabel> tab.
This tab has the same information that was described in <xref linkend="acct-create"></xref>.
- To access the <guilabel>Edit Account</guilabel> dialog go to
- <menuchoice>
+ To access the <guilabel>Edit Account</guilabel> dialog go to<menuchoice>
<shortcut>
<keycombo>
<keycap>Ctrl</keycap><keycap>E</keycap>
</keycombo>
</shortcut> <guimenu>Edit</guimenu><guimenuitem>Edit Account</guimenuitem>
- </menuchoice>
- or click the <guibutton>Edit</guibutton> <emphasis>Toolbar</emphasis> icon in the Account Tree
+ </menuchoice>or click the <guibutton>Edit</guibutton> <emphasis>Toolbar</emphasis> icon in the Account Tree
Window.
</para>
</sect1>
@@ -1200,11 +1070,9 @@
<para>A side effect of removing an account that contains transactions is that you will end up with
unbalanced accounts. This will be indicated in the account by a gray check-box next to the
- debit and credit amounts. You can automatically repair these unbalanced accounts by using the
- <menuchoice>
+ debit and credit amounts. You can automatically repair these unbalanced accounts by using the<menuchoice>
<guimenu>Actions</guimenu><guimenuitem>Check & Repair</guimenuitem>
- </menuchoice>
- menu. This will automatically assign the unbalanced amounts to a new account named
+ </menuchoice>menu. This will automatically assign the unbalanced amounts to a new account named
<emphasis role="bold">Imbalance. </emphasis>
</para>
</sect1>
@@ -1224,28 +1092,23 @@
<tip>
<para>The Reconcile window is accessed from the account tree window or the account register window by
- selecting
- <menuchoice>
+ selecting<menuchoice>
<guimenu><accel>A</accel>ctions</guimenu><guimenuitem><accel>R</accel>econcile…</guimenuitem>
- </menuchoice>
- .
+ </menuchoice>.
</para>
</tip>
<note>
- <para>If you are reconciling an Liability Account of type <guilabel>credit card</guilabel> using a credit card statement
- you have the option of using
- the <guilabel>Transfer Funds</guilabel> dialogue that opens automatically and enter a credit card payment.
- You can change this behaviour in the <guilabel>&appname; Preferences</guilabel> from the
- menu
- <menuchoice>
+ <para>If you are reconciling an Liability Account of type <guilabel>credit card</guilabel> using a credit
+ card statement you have the option of using the <guilabel>Transfer Funds</guilabel> dialogue
+ that opens automatically and enter a credit card payment. You can change this behaviour in
+ the <guilabel>&appname; Preferences</guilabel> from the menu<menuchoice>
<guimenu><accel>E</accel>dit</guimenu><guimenuitem>Pr<accel>e</accel>ferences</guimenuitem>
- </menuchoice>
- in the <guilabel>Register</guilabel> tab by activating the checkbox
- <guilabel>Automatic credit card payment</guilabel>. (see <xref linkend="prefs-reg" />)
+ </menuchoice>in the <guilabel>Register</guilabel> tab by activating the checkbox <guilabel>Automatic credit card
+ payment</guilabel>. (see <xref linkend="prefs-reg" />)
</para>
</note>
-
+
<para>The <emphasis>Summary Bar</emphasis> at the bottom of the Account Register Window indicates the
amounts of <guilabel>Present</guilabel> (Balance), <guilabel>Future</guilabel> (Balance),
<guilabel>Cleared</guilabel> (Transactions), <guilabel>Reconciled</guilabel> (Transactions)
@@ -1511,20 +1374,16 @@
opened.
</para>
- <para>If you wish to postpone the reconciliation until later use the
- <menuchoice>
+ <para>If you wish to postpone the reconciliation until later use the<menuchoice>
<shortcut>
<keycombo>
<keycap>Ctrl</keycap><keycap>P</keycap>
</keycombo>
</shortcut> <guimenu><accel>R</accel>econcile</guimenu><guimenuitem>Postpone</guimenuitem>
- </menuchoice>
- menu item or pressing the <guibutton>Postpone</guibutton> icon. If you wish to cancel the
- reconciliation use the
- <menuchoice>
+ </menuchoice>menu item or pressing the <guibutton>Postpone</guibutton> icon. If you wish to cancel the
+ reconciliation use the<menuchoice>
<guimenu><accel>R</accel>econcile</guimenu><guimenuitem>Cancel</guimenuitem>
- </menuchoice>
- menu item or press the <guibutton>Cancel</guibutton> icon.
+ </menuchoice>menu item or press the <guibutton>Cancel</guibutton> icon.
</para>
<para>All previous commands are also available in the <guilabel>Reconcile</guilabel> dialog menu.
@@ -1535,15 +1394,13 @@
reflect each selected transaction until the <guilabel>Ending Balance</guilabel>
<emphasis>equals</emphasis> the <guilabel>Reconciled Balance</guilabel> and the
<guilabel>Difference</guilabel> is <emphasis>zero</emphasis>. Once this is done select the
- <guibutton>Finish</guibutton> button or
- <menuchoice>
+ <guibutton>Finish</guibutton> button or<menuchoice>
<shortcut>
<keycombo>
<keycap>Ctrl</keycap><keycap>W</keycap>
</keycombo>
</shortcut> <guimenu><accel>R</accel>econcile</guimenu><guimenuitem>Finish</guimenuitem>
- </menuchoice>
- to finish the reconcile process.
+ </menuchoice>to finish the reconcile process.
</para>
</sect2>
</sect1>
diff --git a/manual/C/Help_ch_Tools_Assistants.xml b/manual/C/Help_ch_Tools_Assistants.xml
index 323dbd1a..9428dcf3 100644
--- a/manual/C/Help_ch_Tools_Assistants.xml
+++ b/manual/C/Help_ch_Tools_Assistants.xml
@@ -5298,7 +5298,7 @@
</para>
<para>Detailed instructions are in the section on Creating New Accounts.
- <xref linkend="Online-price-setup"></xref>
+ <xref linkend="accts-online-quotes"></xref>
</para>
</sect2>
</sect1>
diff --git a/manual/C/Help_ch_Transactions.xml b/manual/C/Help_ch_Transactions.xml
index 29622957..03eb72e2 100644
--- a/manual/C/Help_ch_Transactions.xml
+++ b/manual/C/Help_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="Online-price-setup"/>) you can use the
+ Price Retrieval installed (see <xref linkend="finance-quote-install"/>) you can use the
<guilabel>Fetch Rate</guilabel> button to retrieve a current quote.
</para>
diff --git a/manual/C/ch_Finance-Quote.xml b/manual/C/ch_Finance-Quote.xml
new file mode 100644
index 00000000..1b218d69
--- /dev/null
+++ b/manual/C/ch_Finance-Quote.xml
@@ -0,0 +1,265 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE chapter SYSTEM "gnc-docbookx.dtd">
+<!-- (Do not remove this comment block.)
+Version: 1.0.0
+Last modified: August 08th 2021
+
+Maintainers:
+ xxx
+Author:
+ TANIGUCHI Yasuaki <yasuakit at gmail.com>
+ Christian Wehling <christian.wehling at web.de>
+Translators:
+ (translators put your name and email here)
+-->
+<chapter id="finance-quote"
+ xmlns:xi="http://www.w3.org/2001/XInclude">
+ <title>The Online Quote update</title>
+
+ <para>If you have more than a couple of commodities, you will tire of having to update their quotes
+ constantly. &app; has the ability to automatically download the most recent quote for your
+ commodities using the Internet. This is accomplished through the &app-perl; module &app-fq;,
+ which must be installed in order to activate this feature.
+ </para>
+
+ <sect1 id="finance-quote-install">
+ <title>Installing &app-fq;</title>
+
+ <para>To determine if the &app-perl; module &app-fq; is already installed on your system, type
+ <command>perldoc Finance::Quote</command> in a terminal window and check to see if there is
+ any documentation available. If you are now shown documentation, then &app-fq; is already
+ installed and you can configure periodical quotes update as described in
+ <xref linkend="finance-quote-scheduler" />. If no documentation is displayed, you will have to
+ continue with this chapter.
+ </para>
+
+ <itemizedlist>
+ <title>Prerequisites for an Online Quote update with &app-fq;</title>
+
+ <listitem>
+ <para>the &app-perl; language interpreter,
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>the &app-perl;-module &app-fq; and
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>any dependencies required by the &app-fq; module.
+ </para>
+ </listitem>
+ </itemizedlist>
+
+ <note>
+ <para>If you feel uncomfortable about performing any of these steps, please either email the &app;-user
+ mailing list (<email>gnucash-user at gnucash.org</email>) for help or come to the &app; IRC
+ channel on irc.gnome.org. You can also find more information in the &app; wiki at
+ <ulink url="&url-wiki-OQ;">Online Quotes</ulink>. You can also leave out this step and
+ manually update your stock quotes.
+ </para>
+ </note>
+
+ <para>The installation of &app-perl; is not the focus of this manual. A detailed description can be found
+ in the &app; Wiki at <ulink url="&url-wiki-OQ;#Perl">Perl</ulink>.
+ </para>
+
+ <para>The process of installing &app-fq; depends on the system. For the different supported systems, you
+ can follow the instructions below:
+ </para>
+
+ <procedure>
+ <title>Installing &app-fq; on &lin;</title>
+
+ <step>
+ <simpara>Close &app;.
+ </simpara>
+ </step>
+
+ <step>
+ <simpara>Run the <command>gnc-fq-check</command> command to verify that the program is already in a directory
+ that is entered in the PATH environment variable.<footnote>
+ <simpara>If you’ve installed &app; packages provided by your distribution,
+ <filename>gnc-fq-check</filename> must be on your PATH. The currentness of your
+ distribution can be checked under
+ <ulink url="&url-repo;perl:finance-quote/versions"><citetitle>&app-fq;-
+ versions</citetitle></ulink>.
+ </simpara>
+ </footnote>
+ </simpara>
+
+ <substeps>
+ <step>
+ <simpara>If <filename>gnc-fq-check</filename> is not in your PATH, search the folder where &app; is installed
+ and change to that directory.
+ </simpara>
+ </step>
+
+ <step>
+ <simpara>It is a good idea to include the current directory in the PATH environment variable. Please refer to
+ the documentation for your distribution for more information.
+ </simpara>
+ </step>
+ </substeps>
+ </step>
+
+ <step>
+ <simpara>Next, update with <command>sudo gnc-fq-update</command> or <command>su -c gnc-fq-update</command>
+ with root privileges &app-fq; It depends on your distribution.
+ </simpara>
+
+ <para>This will launch a &app-perl; <acronym><ulink url="&url-cpan;">CPAN</ulink></acronym><footnote>
+ <simpara>See <ulink url="&url-cpan;misc/cpan-faq.html">CPAN Frequently Asked Questions</ulink> for
+ details.
+ </simpara>
+ </footnote>module internally. When you launch the CPAN module for the first time, you must setup and configure
+ it. However, on the most systems if you accept the default settings or answer the first
+ question <computeroutput>Are you ready for manual configuration? [yes]</computeroutput>
+ with <userinput>no</userinput>, you will be able to install &app-fq; successfully.
+ </para>
+ </step>
+
+ <step>
+ <simpara>Run <command>gnc-fq-dump</command> to check &app-fq; works properly. This program returns the
+ version number of &app-fq; module currently installed as well as a list of sources
+ available via the &app-fq; module. It will also inform you if there is a problem with your
+ installation or if it is missing, and may suggest a fix.
+ </simpara>
+ </step>
+ </procedure>
+
+ <procedure>
+ <title>Installing &app-fq; on &mac;</title>
+
+ <step>
+ <simpara>Close &app;.
+ </simpara>
+ </step>
+
+ <step>
+ <simpara>Install Xcode if it is not installed.
+ </simpara>
+
+ <simpara>XCode is an optional item from your &mac; distribution DVD.
+ </simpara>
+ </step>
+
+ <step>
+ <simpara>Run the <emphasis>Update Finance Quote</emphasis> app in the &app; dmg.
+ </simpara>
+
+ <para>You can run it from the dmg or copy it to the same folder to which you copied &app;. It will open a
+ Terminal window and run a script for you which will ask lots of questions. Accept the
+ default for each unless you know what you’re doing.
+ </para>
+ </step>
+ </procedure>
+
+ <procedure>
+ <title>Installing &app-fq; on &win;</title>
+
+ <step>
+ <simpara>Close &app;.
+ </simpara>
+ </step>
+
+ <step>
+ <simpara>Run<menuchoice>
+ <guimenu>Start</guimenu> <guisubmenu>&app;</guisubmenu> <guimenuitem>Install Online
+ Price Retrieval</guimenuitem>
+ </menuchoice>.
+ </simpara>
+
+ <para>The &win; installer from the <ulink url="&url-www;download.phtml">&app; homepage</ulink>. also comes
+ with a small utility that installs &app-fq; for you.
+ </para>
+ </step>
+ </procedure>
+ </sect1>
+
+ <sect1 id="finance-quote-scheduler">
+ <title>Configuring for Getting Online Quotes Periodically</title>
+
+ <para>The command <command>gnucash-cli --quotes get
+ <filename><replaceable>${HOME}/gnucash-filename</replaceable></filename></command><footnote>
+ <simpara>The Online Quotes Retrieval command has been changed from &app; 4.0. The old command
+ <command>gnucash --add-price-quotes
+ <filename><replaceable>${HOME}/gnucash-filename</replaceable></filename></command> is
+ still available, but it is deprecated and will be removed in the future release. If you've
+ upgraded from &app; 3.11 or previous version, it is recommended to use the new command
+ <command>gnucash-cli</command>.
+ </simpara>
+ </footnote>can be used to fetch the current quotes of your stocks and write them directly into your &app;-data
+ file.
+ </para>
+
+ <para>The file specified <filename><replaceable>${HOME}/gnucash-filename</replaceable></filename> will
+ depend on the name and location of your data file. This can be determined by the name
+ displayed in the top frame of the &app; window, before the <quote>-</quote>.<tip>
+ <para>The file name can also be found under <guimenu>File</guimenu> in the recently opened file list. If
+ you place the mouse over the menu item with the number 1 in the list of recently opened
+ files, the complete file name is displayed in the <guilabel>status bar</guilabel>.
+ </para>
+ </tip>
+ </para>
+
+ <para>You have to register the <command>gnucash-cli</command> with a scheduler in order to get Online
+ Quotes automatically and periodically. The method depends on your OS. For example, suppose you
+ want to update your file on 16:00 on every Friday.
+ </para>
+
+ <procedure>
+ <title>Automated quote retrieval on &lin; and &mac;</title>
+
+ <para>Register <command>gnucash-cli</command> with <application>cron</application>.
+ </para>
+
+ <step>
+ <simpara>Run <command>crontab -e</command>.
+ </simpara>
+ </step>
+
+ <step>
+ <para>Add the following line to your crontab:<informalexample>
+<screen>0 16 * * 5 gnucash-cli --quotes get <replaceable>${HOME}/gnucash-filename</replaceable> > /dev/null 2>&1</screen>
+ </informalexample><warning>
+ <para>If there is no X session running on your computer at the time of the quote request, you must do the
+ call as follows instead:<screen>0 16 * * 5 env `dbus-launch` sh -c 'trap "kill $DBUS_SESSION_BUS_PID" EXIT; gnucash-cli --quotes get <replaceable>${HOME}/gnucash-filename</replaceable> > /dev/null 2>&1</screen>
+ </para>
+ </warning>
+ </para>
+ </step>
+ </procedure>
+
+ <procedure>
+ <title>Automated quote retrieval on &win;</title>
+
+ <para>Register <command>gnucash-cli</command> with Task Scheduler.
+ </para>
+
+ <step>
+ <simpara>Select<menuchoice>
+ <guimenu>Start</guimenu><guisubmenu>Windows Administrative
+ Tools</guisubmenu><guimenuitem>Task Scheduler</guimenuitem>
+ </menuchoice>.
+ </simpara>
+ </step>
+
+ <step>
+ <simpara>Select <guimenuitem>Create Task</guimenuitem>.
+ </simpara>
+ </step>
+
+ <step>
+ <simpara>Enter the appropirate items on <guilabel>Create Task</guilabel> Window.
+ </simpara>
+ </step>
+ </procedure>
+
+ <para>For more information, see the wiki at
+ <ulink url="&url-wiki-OQ;#Updating_enabled_Quotes_from_outside_GnuCash">Online Quotes Page on
+ GnuCash Wiki</ulink>.
+ </para>
+ </sect1>
+</chapter>
diff --git a/manual/C/gnucash-help.xml b/manual/C/gnucash-help.xml
index afe2670e..3a5f00f8 100644
--- a/manual/C/gnucash-help.xml
+++ b/manual/C/gnucash-help.xml
@@ -524,6 +524,9 @@
<!-- subchapters:
Help_txf-ategories.xml
-->
+
+ <xi:include href="ch_Finance-Quote.xml" />
+
<xi:include href="Help_tips-appendix.xml" />
<xi:include href="Help_fdl-appendix.xml" />
diff --git a/manual/de/CMakeLists.txt b/manual/de/CMakeLists.txt
index 39626ea5..c63c8bc5 100644
--- a/manual/de/CMakeLists.txt
+++ b/manual/de/CMakeLists.txt
@@ -9,6 +9,7 @@ set (entities
Help_ch_Tools_Assistants.xml
Help_ch_Reports.xml
Help_ch_Customize.xml
+ ch_Finance-Quote.xml
Help_fdl-appendix.xml
Help_legal.xml
para-assist-buttons.xml
diff --git a/manual/de/Help_ch_Account-Actions.xml b/manual/de/Help_ch_Account-Actions.xml
index ddc43980..e8614ecd 100644
--- a/manual/de/Help_ch_Account-Actions.xml
+++ b/manual/de/Help_ch_Account-Actions.xml
@@ -94,12 +94,10 @@
</entry>
<entry namest="c3" nameend="c4">
- <para>Die Auswertung
- <menuchoice>
+ <para>Die Auswertung<menuchoice>
<guimenu>Be<accel>r</accel>ichte</guimenu><guisubmenu><accel>A</accel>ktiva &
Passiva</guisubmenu><guimenuitem><accel>B</accel>ilanz</guimenuitem>
- </menuchoice>
- gibt Ihnen eine Ãœbersicht zu jedem beliebigen <emphasis>Stichtag</emphasis>.
+ </menuchoice>gibt Ihnen eine Ãœbersicht zu jedem beliebigen <emphasis>Stichtag</emphasis>.
</para>
</entry>
</row>
@@ -169,8 +167,7 @@
Finanzinstitut geführt werden. Einige dieser Konten können Zinsen tragen. Diese
Kontoart eignet sich auch für das <emphasis>PayPal</emphasis>-Konto sowie Debit-
und andere Guthaben-Karten wie z.B. <emphasis>Bonus-Meilen</emphasis> und
- <emphasis>Geldkarte</emphasis>.
- <footnote>
+ <emphasis>Geldkarte</emphasis>.<footnote>
<para>Für einige dieser Konten besteht die Möglichkeit, per Online-Banking Aufträge an das
Geldinstitute zu senden sowie Buchungen abzurufen und zu importieren. (siehe
hierzu auch <xref linkend="trans-online" />)
@@ -182,13 +179,11 @@
<row>
<entry namest="c2" rowsep="1">
- <para>(Offene) Forderungen
- <footnote id="fn-receivables-kat">
+ <para>(Offene) Forderungen<footnote id="fn-receivables-kat">
<para><warning>
<para>Die Kontenarten Verbindlichkeiten und Forderungen werden zur Verwaltung offener Rechnungen, auch
<quote>offene Posten</quote> genannt, verwendet. Buchungen, die diese Konten
- betreffen, sollten ausschließlich durch Verwendung von
- <itemizedlist spacing="compact">
+ betreffen, sollten ausschließlich durch Verwendung von<itemizedlist spacing="compact">
<listitem>
<para>einbuchen/ausbuchen von Lieferantenrechnung/Rechnung/Auslagenerstattung oder
</para>
@@ -198,12 +193,9 @@
<para>verarbeiten von Zahlung
</para>
</listitem>
- </itemizedlist>
- hinzugefügt, geändert oder gelöscht werden.
+ </itemizedlist>hinzugefügt, geändert oder gelöscht werden.
</para>
- </warning>
-
- <tip>
+ </warning><tip>
<para>Legen Sie nur ein Konto pro benötigter Währung an. Die verschiedenen Kunden, bzw Lieferanten hält
&app; automatisch auseinander.
</para>
@@ -238,13 +230,10 @@
<entry namest="c3">
<para>Die Aktie ist ein Wertpapier, das den Anteil an einer Aktiengesellschaft oder einer
- Kommanditgesellschaft auf Aktien (KGaA) verbrieft.
- <footnote>
+ Kommanditgesellschaft auf Aktien (KGaA) verbrieft.<footnote>
<para><ulink url="&url-wp-de;Aktie"/>
</para>
- </footnote>
-
- <footnote>
+ </footnote><footnote>
<para><tip>
<para>Solange Kryptowährungen von &app; nicht als Währungen unterstützt werden, wird empfohlen, sie
ebenfalls als Aktie anzulegen.
@@ -348,8 +337,7 @@
<row rowsep="1">
<entry namest="c1" nameend="c2">
- <para>Erfolgskonten
- <footnote id="fn-quick-kat">
+ <para>Erfolgskonten<footnote id="fn-quick-kat">
<para>Wird in <application>Quicken</application> bzw. <application>Lexware FinanzManager</application> und
anderen, nicht auf doppelter Buchführung basierenden, Programmen als
<quote>Kategorie</quote> bezeichnet.
@@ -360,14 +348,12 @@
<entry namest="c3" nameend="c4">
<para>Bei Bedarf können Sie auf der nächsten Kontoebene die Unterscheidung zwischen
- steuerpflichtig/-frei, bzw. steuerabzugsfähig oder nicht, einfügen. Die Auswertung
- <menuchoice>
+ steuerpflichtig/-frei, bzw. steuerabzugsfähig oder nicht, einfügen. Die Auswertung<menuchoice>
<guimenu>Be<accel>r</accel>ichte</guimenu><guisubmenu>Aufwand &
<accel>E</accel>rtrag</guisubmenu><guimenuitem>Gewi<accel>n</accel>n- und
Verlustrechnung</guimenuitem>
- </menuchoice>
- gibt Ihnen eine Übersicht für jeden beliebigen <emphasis>Zeitraum</emphasis> wie
- z.B. das Geschäftsjahr.
+ </menuchoice>gibt Ihnen eine Übersicht für jeden beliebigen <emphasis>Zeitraum</emphasis> wie z.B. das
+ Geschäftsjahr.
</para>
</entry>
</row>
@@ -380,8 +366,7 @@
<entry namest="c3">
<para>Einnahmen jeder Art, die Sie z.B. durch Gehalt, geldwerte Vorteile (Dienstwagen), Zinsen, Dividenden
- oder auch Geschenke usw. haben. <footnoteref linkend="fn-quick-kat" />
-<!-- footnoteref funktioniert in Yelp nicht ! -->
+ oder auch Geschenke usw. haben. <footnoteref linkend="fn-quick-kat" /><!-- footnoteref funktioniert in Yelp nicht ! -->
</para>
</entry>
@@ -535,8 +520,7 @@
dargestellt und nicht die Einzelkonten.
</para>
- <para>Eine Kontenhierarchie könnte beispielsweise wie folgt aussehen:
- <xi:include href="Help_chtacctseg.xml"/>
+ <para>Eine Kontenhierarchie könnte beispielsweise wie folgt aussehen:<xi:include href="Help_chtacctseg.xml"/>
</para>
<tip id="accts-code">
@@ -556,12 +540,10 @@
vermeiden um eine Eindeutigkeit zu erzielen. Es bietet sich an, bei der Festlegung der
Kontonummern zunächst die Ziffern zu verwenden. Reichen die nicht aus, können Sie auch die
Buchstaben <quote>a</quote> bis <quote>z</quote> benutzen. &app; kann Sie bei der
- Nummerierung Ihre Konten unterstützen. Verwenden Sie hierfür den Assistenten
- <menuchoice>
+ Nummerierung Ihre Konten unterstützen. Verwenden Sie hierfür den Assistenten<menuchoice>
<guimenu><accel>B</accel>earbeiten</guimenu><guimenuitem>Unterkonten neu
<accel>n</accel>ummerieren…</guimenuitem>
- </menuchoice>
- zu Hilfe. Ein Beispiel ist in <xref linkend="chart-renumber" /> beschrieben
+ </menuchoice>zu Hilfe. Ein Beispiel ist in <xref linkend="chart-renumber" /> beschrieben
</para>
</tip>
<!-- FIXME Is this section still valid? -->
@@ -580,22 +562,18 @@
</para>
<tip>
- <para>Sie können den Assistenten später erneut ausführen. Hierfür gehen Sie im Menü zu
- <menuchoice>
+ <para>Sie können den Assistenten später erneut ausführen. Hierfür gehen Sie im Menü zu<menuchoice>
<shortcut>
<keycombo>
<keycap>Strg</keycap><keycap>N</keycap>
</keycombo>
</shortcut> <guimenu><accel>D</accel>atei</guimenu> <guimenuitem><accel>N</accel>eue
Datei</guimenuitem>
- </menuchoice>
- falls Sie eine neue Datei erstellen wollen. Wenn Sie den Assistenten innerhalb der
- geöffneten Datei laufen lassen wollen, benutzen Sie stattdessen
- <menuchoice>
+ </menuchoice>falls Sie eine neue Datei erstellen wollen. Wenn Sie den Assistenten innerhalb der geöffneten Datei
+ laufen lassen wollen, benutzen Sie stattdessen<menuchoice>
<guimenu><accel>A</accel>ktionen</guimenu><guimenuitem>Konten<accel>h</accel>ierachie
hinzufügen</guimenuitem>
- </menuchoice>
- wenn das Kontenhierarchie- Register angezeigt wird.
+ </menuchoice>wenn das Kontenhierarchie- Register angezeigt wird.
</para>
</tip>
@@ -688,17 +666,14 @@
<para><note>
<para>Dieser Dialogschritt wird <emphasis>nicht</emphasis> angezeigt, wenn Sie den Assistenten in der
- Kontenansicht einer bestehen &app;-Datei mit dem Menüpunkt
- <menuchoice>
+ Kontenansicht einer bestehen &app;-Datei mit dem Menüpunkt<menuchoice>
<guimenu><accel>A</accel>ktionen</guimenu><guimenuitem>Konten<accel>h</accel>ierachie
hinzufügen</guimenuitem>
- </menuchoice>
- starten.
+ </menuchoice>starten.
</para>
- </note>
- In diesem Schritt können Sie generelle Einstellungen für die &app;-Datei vornehmen, die
- in der Datei gespeichert werden und somit für alle Benutzer gelten. Der Dialog wird
- ausführlich in <xref linkend="book-options" /> beschrieben.
+ </note>In diesem Schritt können Sie generelle Einstellungen für die &app;-Datei vornehmen, die in der
+ Datei gespeichert werden und somit für alle Benutzer gelten. Der Dialog wird ausführlich
+ in <xref linkend="book-options" /> beschrieben.
</para>
</step>
@@ -711,12 +686,10 @@
<para>Die Dropdown-Liste ist standardmäßig auf die Währung eingestellt, die in der Registerkarte
<xref linkend="prefs-accounts"/> in den <guilabel>&appname; Einstellungen</guilabel>
- eingestellt ist. Sie erreichen diesen Dialog im Menü
- <menuchoice>
+ eingestellt ist. Sie erreichen diesen Dialog im Menü<menuchoice>
<guimenu><accel>B</accel>earbeiten</guimenu><guimenuitem><accel>E</accel>instellungen</guimenuitem>
- </menuchoice>
- . Wenn Sie stattdessen für Ihre Konten eine andere Standardwährung verwenden wollen,
- wählen Sie diese aus der Liste aus.
+ </menuchoice>. Wenn Sie stattdessen für Ihre Konten eine andere Standardwährung verwenden wollen, wählen Sie
+ diese aus der Liste aus.
</para>
</step>
@@ -916,12 +889,10 @@
<sect1 id="acct-create">
<title>Neues Konto erstellen</title>
- <para>Um ein neues Konto anzulegen wählen Sie in der Kontenübersicht in dem Menü
- <menuchoice>
+ <para>Um ein neues Konto anzulegen wählen Sie in der Kontenübersicht in dem Menü<menuchoice>
<guimenu>A<accel>k</accel>tionen</guimenu><guimenuitem>Neues
<accel>K</accel>onto…</guimenuitem>
- </menuchoice>
- oder klicken auf die Schaltfläche <guibutton>Neu</guibutton> in der
+ </menuchoice>oder klicken auf die Schaltfläche <guibutton>Neu</guibutton> in der
<guilabel>Werkzeugleiste</guilabel> und der Dialog <guilabel>Neues Konto</guilabel> wird
geöffnet.
</para>
@@ -952,8 +923,7 @@
<listitem>
<para>Soll das Konto Fremdwährungen oder Wertpapiere aufnehmen? Dann benötigen Sie pro Währung
- vielleicht auch noch zusätzlich ein Konto für die Buchungen des Anfangsbestands.
- <tip>
+ vielleicht auch noch zusätzlich ein Konto für die Buchungen des Anfangsbestands.<tip>
<para><computeroutput>Eigenkapital</computeroutput> und seine temporären Varianten
<computeroutput>Ertrag</computeroutput> und <computeroutput>Aufwand</computeroutput>
sollten grundsätzlich in der Basiswährung geführt werden.
@@ -979,12 +949,10 @@
verknüpfen falls es sich um ein Währungs-, Investmentfonds- oder Aktienkonto handelt.
Weiterhin kann es als ein <xref linkend="accts-placeholder" />-Konto markiert werden und
zusätzlich wird angezeigt, wenn es als <guilabel>Steuerrelevant</guilabel> gekennzeichnet
- ist (was in dem
- <menuchoice>
+ ist (was in dem<menuchoice>
<guimenu><accel>B</accel>earbeiten</guimenu><guimenuitem><accel>O</accel>ptionen
Steuerbericht</guimenuitem>
- </menuchoice>
- -Dialog erfolgt).
+ </menuchoice>-Dialog erfolgt).
</para>
<para>Im oberen Abschnitt <guilabel>Identifizierung</guilabel> dieser Registerkarte stehen sieben
@@ -1052,8 +1020,7 @@
<para>Ähnlich der Kontonummer bietet der Typ, der intern Namensraum heißt, eine Möglichkeit, seine
Investments sachlich zu sortieren. Grundsätzlich bietet es sich an, sie nach
Risiko zu gruppieren. Zum Beispiel kann als erste Ebene der Typ des Wertpapiers
- angegeben werden und als optionale 2. Ebene die Nominalwährung.
-<screen>:
+ angegeben werden und als optionale 2. Ebene die Nominalwährung.<screen>:
|
+--Bond
| |--CHF
@@ -1136,17 +1103,13 @@
<para>Das <guilabel>Steuerrelevant</guilabel> Kontrollkästchen bedeutet, dass das Konto ausgewählt
wurde, um in einem Steuer-Bericht berücksichtigt zu werden. Dieses Kennzeichen wird hier
- nur angezeigt und ist im Dialog <guilabel>Optionen Steuerbericht</guilabel> einzustellen (
- <menuchoice>
+ nur angezeigt und ist im Dialog <guilabel>Optionen Steuerbericht</guilabel> einzustellen (<menuchoice>
<guimenu><accel>B</accel>earbeiten</guimenu><guimenuitem><accel>O</accel>ptionen
Steuerbericht</guimenuitem>
- </menuchoice>
- ). Der dazu gehörige Bericht ist im Menü
- <menuchoice>
+ </menuchoice>). Der dazu gehörige Bericht ist im Menü<menuchoice>
<guimenu>Be<accel>r</accel>ichte</guimenu><guimenuitem><accel>S</accel>teuer-Bericht &
Elster-Export</guimenuitem>
- </menuchoice>
- zu finden. Siehe auch <xref linkend="report-regional"/>.
+ </menuchoice>zu finden. Siehe auch <xref linkend="report-regional"/>.
</para>
<para id="accts-placeholder" xreflabel="Platzhalter">Das Kontrollkästchen <guilabel>Platzhalter</guilabel> setzt für ein Konto den Status
@@ -1173,14 +1136,12 @@
</note>
<para>Das Kontrollkästchen <guilabel>Versteckt</guilabel> blendet ein Konto (und alle Unterkonten) in der
- Kontenübersicht aus. Um diese Option zurückzusetzen, müssen Sie zunächst den
- <menuchoice>
+ Kontenübersicht aus. Um diese Option zurückzusetzen, müssen Sie zunächst den<menuchoice>
<guimenu><accel>A</accel>nsicht</guimenu><guimenuitem><accel>F</accel>iltern
nach…</guimenuitem>
- </menuchoice>
- Dialog für den Kontenbaum öffnen und die Option <guilabel>Versteckte Konten
- anzeigen</guilabel> aktivieren. Auf diese Weise können Sie das Konto auswählen und diesen
- Dialog erneut öffnen.
+ </menuchoice>Dialog für den Kontenbaum öffnen und die Option <guilabel>Versteckte Konten anzeigen</guilabel>
+ aktivieren. Auf diese Weise können Sie das Konto auswählen und diesen Dialog erneut
+ öffnen.
</para>
<note>
@@ -1211,8 +1172,7 @@
</para>
<para>Der rechte Bereich enthält die Auswahl des <guilabel>Hauptkontos</guilabel>. Zum Erstellen eines
- neuen Kontenbaums, wählen Sie <guilabel>Neues Konto der obersten Ebene</guilabel>.
- <note>
+ neuen Kontenbaums, wählen Sie <guilabel>Neues Konto der obersten Ebene</guilabel>.<note>
<para>Die verfügbaren Auswahlmöglichkeiten im Bereich <guilabel>Kontoart</guilabel> hängen von dem
ausgewählten Konto im Bereich <guilabel>Hauptkonto</guilabel> ab. (vgl.
<xref linkend="acct-types" />) Dies dient dazu, die Struktur der Kontenübersicht
@@ -1220,201 +1180,187 @@
</para>
</note>
</para>
-<!-- FIXME: this is to be inserted after the move to a new chapter
- <sect3 id="accts-Online-price">
- <title>Benutzen der Online-Kursaktualisierung</title>
- -->
+ </sect2>
+<!-- FIXME: this is to be inserted after the move to a new chapter -->
+ <sect2 id="accts-online-quotes">
+ <title>Verwenden der Online-Kursaktualisierung</title>
- <sect3 id="Online-price-setup">
- <title>Vorgehensweise zur Aktivierung der Online-Preisaktualisierung</title>
+ <orderedlist spacing="compact">
+ <listitem>
+ <para>&app; bedient sich eines externen Tools zum Abrufen von Online-Kursen. Dieses Tool ist ein
+ &app-perl;-Modul namens &app-fq; und muss zusätzlich zu &app; auf Ihrem Computer
+ installiert werden.
+ </para>
- <orderedlist spacing="compact">
- <listitem>
- <para>&app; bedient sich eines externen Tools zum Abrufen von Online-Kursen. Dieses Tool ist ein
- &app-perl;-Modul namens &app-fq; und muss zusätzlich zu &app; auf Ihrem Computer
- installiert werden.
+ <tip>
+ <para>Die Installation wird in <xref linkend="finance-quote-install" /> detailiert beschrieben.
</para>
+ </tip>
+ </listitem>
- <tip>
- <para>Die Installation wird in
-<!-- <xref linkend="suggest-online-price" /> -->
- detailiert beschrieben.
- </para>
- </tip>
- </listitem>
-<!-- FIXME source: Delete some sections referring to F::Q -->
- <listitem>
- <para>Legen Sie das Konto für den Investmentfonds bzw. die Aktie an und stellen Sie sicher, dass das
- gewünschte Papier im Feld <guilabel>Wertpapier/Währung</guilabel>, wie oben
- beschrieben, aufgeführt wird.
+ <listitem>
+ <para>Legen Sie das Konto für den Investmentfonds bzw. die Aktie an und stellen Sie sicher, dass das
+ gewünschte Papier im Feld <guilabel>Wertpapier/Währung</guilabel>, wie oben
+ beschrieben, aufgeführt wird.
+ </para>
+
+ <tip>
+ <para>Das Einrichten dieser Konten ist ein guter Zeitpunkt, Einkommenskonten zur Verfolgung von
+ Dividenden, Kapitalgewinne, aus lang- und kurzfristigen Anlagen, sowie Aufwandskonten
+ zur Erfassung von Provisionen und Verlusten (Wenn Sie Verluste als Ausgaben verbuchen)
+ anzulegen.
</para>
+ </tip>
+ </listitem>
- <tip>
- <para>Das Einrichten dieser Konten ist ein guter Zeitpunkt, Einkommenskonten zur Verfolgung von
- Dividenden, Kapitalgewinne, aus lang- und kurzfristigen Anlagen, sowie
- Aufwandskonten zur Erfassung von Provisionen und Verlusten (Wenn Sie Verluste als
- Ausgaben verbuchen) anzulegen.
- </para>
- </tip>
- </listitem>
+ <listitem>
+ <para>Legen Sie das Wertpapier an. Verwenden Sie entweder den<menuchoice>
+ <guimenu><accel>W</accel>erkzeug</guimenu><guimenuitem><accel>W</accel>ertpaper-Editor</guimenuitem>
+ </menuchoice>für bestehende Aktien/Fonds oder, wie oben beschrieben, den <guilabel>Neue
+ Wertpapier/Währung</guilabel> Dialog für eine neue Aktie/Fonds.
+ </para>
- <listitem>
- <para>Legen Sie das Wertpapier an. Verwenden Sie entweder den
- <menuchoice>
- <guimenu><accel>W</accel>erkzeug</guimenu><guimenuitem><accel>W</accel>ertpaper-Editor</guimenuitem>
- </menuchoice>
- für bestehende Aktien/Fonds oder, wie oben beschrieben, den <guilabel>Neue
- Wertpapier/Währung</guilabel> Dialog für eine neue Aktie/Fonds.
- </para>
+ <para>Wählen Sie <guilabel>Börsenkurse online abrufen</guilabel>, die <guilabel>Art der
+ Kursabruf-Quelle</guilabel> und die <guilabel>Zeitzone</guilabel>.
+ </para>
- <para>Wählen Sie <guilabel>Börsenkurse online abrufen</guilabel>, die <guilabel>Art der
- Kursabruf-Quelle</guilabel> und die <guilabel>Zeitzone</guilabel>.
- </para>
+ <para>Online-Währungskurse erfordern, dass das Kontrollkästchen für die <guilabel>Art der
+ Kursabruf-Quelle</guilabel> und die <guilabel>Zeitzone</guilabel> im Dialog
+ <guilabel>Währung</guilabel> ausgewählt werden, nachdem das Kontrollkästchen für
+ <guilabel>Börsenkurse online abrufen</guilabel> im Währungs-Editor für die
+ Währungen, die heruntergeladen werden sollen, aktivert ist.
+ </para>
- <para>Online-Währungskurse erfordern, dass das Kontrollkästchen für die <guilabel>Art der
- Kursabruf-Quelle</guilabel> und die <guilabel>Zeitzone</guilabel> im Dialog
- <guilabel>Währung</guilabel> ausgewählt werden, nachdem das Kontrollkästchen für
- <guilabel>Börsenkurse online abrufen</guilabel> im Währungs-Editor für die
- Währungen, die heruntergeladen werden sollen, aktivert ist.
- </para>
+ <variablelist spacing="compact">
+ <varlistentry>
+ <term><guilabel>Börsenkurse online abrufen</guilabel></term>
- <variablelist spacing="compact">
- <varlistentry>
- <term><guilabel>Börsenkurse online abrufen</guilabel></term>
+ <listitem>
+ <para>Diese Option steht nur dann zur Verfügung, wenn die Kontoart <emphasis>Devisenhandel</emphasis>,
+ <emphasis>Investmentfonds</emphasis> oder <emphasis>Aktienkonto</emphasis> ist.
+ Sie bewirkt, dass für dieses Konto die Kurse von einer Online-Datenquelle
+ heruntergeladen werden können.
+ </para>
+ </listitem>
+ </varlistentry>
- <listitem>
- <para>Diese Option steht nur dann zur Verfügung, wenn die Kontoart <emphasis>Devisenhandel</emphasis>,
- <emphasis>Investmentfonds</emphasis> oder <emphasis>Aktienkonto</emphasis> ist.
- Sie bewirkt, dass für dieses Konto die Kurse von einer Online-Datenquelle
- heruntergeladen werden können.
- </para>
- </listitem>
- </varlistentry>
+ <varlistentry>
+ <term><guilabel>Art der Kursabruf-Quelle</guilabel></term>
- <varlistentry>
- <term><guilabel>Art der Kursabruf-Quelle</guilabel></term>
+ <listitem>
+ <para>Verwenden Sie die Optionsfelder, um die Quelle für die Online-Kurse auszuwählen.
+ </para>
- <listitem>
- <para>Verwenden Sie die Optionsfelder, um die Quelle für die Online-Kurse auszuwählen.
- </para>
+ <variablelist spacing="compact">
+ <varlistentry>
+ <term><guilabel>Einzel</guilabel></term>
- <variablelist spacing="compact">
- <varlistentry>
- <term><guilabel>Einzel</guilabel></term>
+ <listitem>
+ <para>Diese Auswahl ruft die Daten nur aus der angegebenen Quelle ab.
+ </para>
+ </listitem>
+ </varlistentry>
- <listitem>
- <para>Diese Auswahl ruft die Daten nur aus der angegebenen Quelle ab.
- </para>
- </listitem>
- </varlistentry>
+ <varlistentry>
+ <term><guilabel>Mehrere Kursquellen</guilabel></term>
- <varlistentry>
- <term><guilabel>Mehrere Kursquellen</guilabel></term>
+ <listitem>
+ <para>Kursquellen wie <quote>Europa</quote> sollten verwendet werden, wenn eine Ausfallsicherung
+ gegenüber mehreren Datenquellen erwünscht ist.
+ </para>
- <listitem>
- <para>Kursquellen wie <quote>Europa</quote> sollten verwendet werden, wenn eine Ausfallsicherung
- gegenüber mehreren Datenquellen erwünscht ist.
+ <caution>
+ <para>Die Option <guilabel>Mehrere Kursquellen</guilabel> ist nur sinnvoll, wenn alle ausgewählten
+ Quellen das gleiche Symbol für Ihre Wertpapier verwenden.
</para>
+ </caution>
+ </listitem>
+ </varlistentry>
- <caution>
- <para>Die Option <guilabel>Mehrere Kursquellen</guilabel> ist nur sinnvoll, wenn alle ausgewählten
- Quellen das gleiche Symbol für Ihre Wertpapier verwenden.
- </para>
- </caution>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><guilabel>unbekannt</guilabel></term>
+ <varlistentry>
+ <term><guilabel>unbekannt</guilabel></term>
<!-- Maintainers: To add, modify, remove sources
edit https://github.com/Gnucash/gnucash/blob/maint/libgnucash/engine/gnc-commodity.c
and update the appendix. -->
- <listitem>
- <para>&app; hat hier kein Hintergrundwissen über die Quelle. Das kann zwei verschiedene Gründe haben.
- Sie versuchen eine Quelle zu verwenden, die
- <itemizedlist>
- <listitem>
- <para>es <emphasis>nicht mehr</emphasis> in &app-fq; gibt oder
- </para>
- </listitem>
-
- <listitem>
- <para>neu in &app-fq; ist, aber <emphasis>noch nicht</emphasis> in &app; eingepflegt wurde.
- </para>
- </listitem>
- </itemizedlist>
- Überprüfen Sie, ob <command>gnc-fq-check</command> Ihre Quelle listet
- und schlagen Sie in <xref linkend="fq-sources" /> die Umsetzung der Namen
- nach.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
+ <listitem>
+ <para>&app; hat hier kein Hintergrundwissen über die Quelle. Das kann zwei verschiedene Gründe haben.
+ Sie versuchen eine Quelle zu verwenden, die<itemizedlist>
+ <listitem>
+ <para>es <emphasis>nicht mehr</emphasis> in &app-fq; gibt oder
+ </para>
+ </listitem>
- <para>Nachdem Sie die Art der Quelle für Kursangebote ausgewählt haben, wählen Sie eine Datenquelle aus
- dem Pulldown-Menü. Details zu den derzeit unterstützten Datenquellen finden
- Sie unter <xref linkend="fq-sources"></xref>.
- </para>
+ <listitem>
+ <para>neu in &app-fq; ist, aber <emphasis>noch nicht</emphasis> in &app; eingepflegt wurde.
+ </para>
+ </listitem>
+ </itemizedlist>Überprüfen Sie, ob <command>gnc-fq-check</command> Ihre Quelle listet und schlagen Sie in
+ <xref linkend="fq-sources" /> die Umsetzung der Namen nach.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
- <note>
- <para>Die Kursdatenquelle <quote>Yahoo</quote> liefert dabei auch die Kurse für die übrigen genannten
- Unternehmen (z.B. Fidelity Investments, T.Rowe Price und The Vanguard Group)
- und gibt den Kurs normalerweise zeitverzögert zur Original-Datenquelle an.
- </para>
- </note>
-
- <para>Beachten Sie allerdings, dass Sie bei Verwendung von <quote>Yahoo as JSON</quote> zusätzlich das
- Börsenplatzkürzel des Wertpapiers anfügen sollten, z.B. <quote>PA</quote>
- für Paris, <quote>BE</quote> für Berlin usw. Beispiel: 12150.PA (ein
- Peugeot-Papier am Pariser Markt).
- <xref linkend="gnc-tbl-fq-yahoo-exchange-codes"></xref> enthält eine Liste von
- Suffixen für verschiedene Märkte auf der ganzen Welt.
- </para>
+ <para>Nachdem Sie die Art der Quelle für Kursangebote ausgewählt haben, wählen Sie eine Datenquelle aus
+ dem Pulldown-Menü. Details zu den derzeit unterstützten Datenquellen finden Sie
+ unter <xref linkend="fq-sources"></xref>.
+ </para>
- <para>Pseudo-Symbole für den amerikanischen Lehrer-Pensionsfond TIAA-CREF-Fonds sind in der Tabelle
- <xref linkend="PsSymbs-TIAA-CREF"></xref> aufgeführt.
+ <note>
+ <para>Die Kursdatenquelle <quote>Yahoo</quote> liefert dabei auch die Kurse für die übrigen genannten
+ Unternehmen (z.B. Fidelity Investments, T.Rowe Price und The Vanguard Group) und
+ gibt den Kurs normalerweise zeitverzögert zur Original-Datenquelle an.
</para>
- </listitem>
- </varlistentry>
+ </note>
- <varlistentry>
- <term><guilabel>Zeitzone dieser Kurse</guilabel></term>
+ <para>Beachten Sie allerdings, dass Sie bei Verwendung von <quote>Yahoo as JSON</quote> zusätzlich das
+ Börsenplatzkürzel des Wertpapiers anfügen sollten, z.B. <quote>PA</quote> für
+ Paris, <quote>BE</quote> für Berlin usw. Beispiel: 12150.PA (ein Peugeot-Papier
+ am Pariser Markt). <xref linkend="gnc-tbl-fq-yahoo-exchange-codes"></xref>
+ enthält eine Liste von Suffixen für verschiedene Märkte auf der ganzen Welt.
+ </para>
- <listitem>
- <para>Wählen Sie die Zeitzone für die Quelle der von Ihnen empfangenen Online-Börsenkurse.
- Beispielsweise verwendet Yahoo gewöhnlich die US-Eastern-Zeitzone, wählen Sie
- also <quote>America/New York</quote>, wenn Sie diese Börsenkursquelle
- verwenden.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
- </listitem>
+ <para>Pseudo-Symbole für den amerikanischen Lehrer-Pensionsfond TIAA-CREF-Fonds sind in der Tabelle
+ <xref linkend="PsSymbs-TIAA-CREF"></xref> aufgeführt.
+ </para>
+ </listitem>
+ </varlistentry>
- <listitem>
- <para>Fügen Sie ein Wertpapier zum <guilabel>Kurs-Editor</guilabel> hinzu. Einzelheiten werden im
- Abschnitt <xref linkend="tool-price" /> beschrieben.
- </para>
- </listitem>
+ <varlistentry>
+ <term><guilabel>Zeitzone dieser Kurse</guilabel></term>
- <listitem>
- <para>Betätigen Sie <guibutton>Kurse abrufen</guibutton> in der <guilabel>Kurs-Datenbank</guilabel>.
- </para>
- </listitem>
+ <listitem>
+ <para>Wählen Sie die Zeitzone für die Quelle der von Ihnen empfangenen Online-Börsenkurse.
+ Beispielsweise verwendet Yahoo gewöhnlich die US-Eastern-Zeitzone, wählen Sie
+ also <quote>America/New York</quote>, wenn Sie diese Börsenkursquelle verwenden.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </listitem>
- <listitem>
- <para>Prüfen Sie den aktuellen Preis für das ausgewählte Wertpapier.
- </para>
- </listitem>
- </orderedlist>
-<!-- FIXME source: Delete some sections referring to F::Q -->
- <para>Denken Sie daran, dass die <quote>Kurse</quote> von Investmentfonds in Wirklichkeit der
- <quote>Nettoanteilswert</quote> ist. und erst mehrere Stunden nach Börsenschluss
- verfügbar sind. Wenn die <quote>Kurse</quote> aktualisiert werden, bevor die
- Nettoanteilswerte des aktuellen Tages ermittelt werden, werden die Werte von gestern
- abgerufen.
- </para>
- </sect3>
+ <listitem>
+ <para>Fügen Sie ein Wertpapier zum <guilabel>Kurs-Editor</guilabel> hinzu. Einzelheiten werden im
+ Abschnitt <xref linkend="tool-price" /> beschrieben.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>Betätigen Sie <guibutton>Kurse abrufen</guibutton> in der <guilabel>Kurs-Datenbank</guilabel>.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>Prüfen Sie den aktuellen Preis für das ausgewählte Wertpapier.
+ </para>
+ </listitem>
+ </orderedlist>
+
+ <para>Denken Sie daran, dass die <quote>Kurse</quote> von Investmentfonds in Wirklichkeit der
+ <quote>Nettoanteilswert</quote> ist. und erst mehrere Stunden nach Börsenschluss verfügbar
+ sind. Wenn die <quote>Kurse</quote> aktualisiert werden, bevor die Nettoanteilswerte des
+ aktuellen Tages ermittelt werden, werden die Werte von gestern abgerufen.
+ </para>
</sect2>
<sect2 id="open-balance">
@@ -1430,12 +1376,10 @@ and update the appendix. -->
</para>
<para>Wenn Sie ihre &app;-Datei über einen längeren Zeitraum fortlaufend nutzen, können Sie mit Hilfe
- des <xref linkend="tool-close-book" /> (
- <menuchoice>
+ des <xref linkend="tool-close-book" /> (<menuchoice>
<guimenu><accel>W</accel>erkzeug</guimenu><guimenuitem>Buch<accel>a</accel>bschluss</guimenuitem>
- </menuchoice>
- ) den Anfangsbestand automatisch berechnen lassen. Hierbei ist der Abschlußsaldo der
- vorherigen Periode der Anfangsbestand der neuen Periode.
+ </menuchoice>) den Anfangsbestand automatisch berechnen lassen. Hierbei ist der Abschlußsaldo der vorherigen
+ Periode der Anfangsbestand der neuen Periode.
</para>
<!-- FIXME source: insert Link to "Guide" -->
<note>
@@ -1509,16 +1453,14 @@ and update the appendix. -->
<para>Das Dialogfenster <guilabel>Konto bearbeiten</guilabel> besteht nur aus der Karteiseite
<guilabel>Allgemeines</guilabel>. Diese Karteiseite enthält dieselben Informationen wie im
zuvor beschriebenen Dialog <xref linkend="acct-create"></xref>. Um das Dialogfenster
- <guilabel>Konto bearbeiten</guilabel> zu öffnen, wählen Sie
- <menuchoice>
+ <guilabel>Konto bearbeiten</guilabel> zu öffnen, wählen Sie<menuchoice>
<shortcut>
<keycombo>
<keycap>Strg</keycap><keycap>E</keycap>
</keycombo>
</shortcut> <guimenu><accel>B</accel>earbeiten</guimenu> <guimenuitem>Konto
<accel>b</accel>earbeiten</guimenuitem>
- </menuchoice>
- oder klicken Sie die <guibutton>Bearbeiten</guibutton> Schaltfläche in der
+ </menuchoice>oder klicken Sie die <guibutton>Bearbeiten</guibutton> Schaltfläche in der
<guilabel>Werkzeugleiste</guilabel> des Fensters <quote>Account</quote> an.
</para>
</sect1>
@@ -1844,24 +1786,20 @@ and update the appendix. -->
<sect1 id="acct-delete">
<title>Konto löschen</title>
<!-- FIXME source: new behavior, it open a new dialog "account delete" -->
- <para>Wenn Sie ein Konto löschen wollen, dann können Sie dies mit
- <menuchoice>
+ <para>Wenn Sie ein Konto löschen wollen, dann können Sie dies mit<menuchoice>
<shortcut> <keycap>Entf</keycap> </shortcut> <guimenu><accel>B</accel>earbeiten</guimenu>
<guimenuitem>Konto <accel>l</accel>öschen…</guimenuitem>
- </menuchoice>
- vornehmen oder Sie betätigen die <guibutton>Löschen</guibutton> Schaltfläche in der
+ </menuchoice>vornehmen oder Sie betätigen die <guibutton>Löschen</guibutton> Schaltfläche in der
<guilabel>Werkzeugleiste</guilabel> des Fensters <quote>Account</quote>.
</para>
<tip>
<para>Es empfiehlt sich, dass Sie vor dem Löschen eines Kontos die &app;-Datei speichern. Habe Sie aus
- Versehen ein Konto gelöscht, so können Sie mit dem Befehl
- <menuchoice>
+ Versehen ein Konto gelöscht, so können Sie mit dem Befehl<menuchoice>
<guimenu><accel>D</accel>atei</guimenu> <guimenuitem>Änderungen
ver<accel>w</accel>erfen</guimenuitem>
- </menuchoice>
- sich aus der Bedrouille befreien. &app; bietet Ihnen dann in einem Dialog an, ob Sie die
- Änderungen verwerfen möchten und die Datei erneut laden wollen.
+ </menuchoice>sich aus der Bedrouille befreien. &app; bietet Ihnen dann in einem Dialog an, ob Sie die Änderungen
+ verwerfen möchten und die Datei erneut laden wollen.
</para>
</tip>
@@ -2002,22 +1940,18 @@ and update the appendix. -->
abgleichen, haben Sie die Möglichkeit, mit Hilfe des sich automatisch öffnenden
<guilabel>Buchen</guilabel>-Dialogs eine Ãœberweisung zum Bezahlen der offenen Rechnung zu
erfassen. Dieses Verhalten können Sie in den <guilabel>&app; Einstellungen</guilabel> im
- Menü
- <menuchoice>
+ Menü<menuchoice>
<guimenu><accel>B</accel>earbeiten</guimenu><guimenuitem><accel>E</accel>instellungen</guimenuitem>
- </menuchoice>
- im Reiter <guilabel>Kontobuch</guilabel> durch betätigen des Kontrollkästchens
+ </menuchoice>im Reiter <guilabel>Kontobuch</guilabel> durch betätigen des Kontrollkästchens
<guilabel>Automatische Kreditkartenbezahlung</guilabel> beeinflussen.
</para>
</note>
<tip>
<para>Das Fenster <guilabel>Abgleichen</guilabel> wird aus der Kontohierarchie oder dem Buchungsfenster
- aufgerufen, indem Sie im Menü
- <menuchoice>
+ aufgerufen, indem Sie im Menü<menuchoice>
<guimenu>A<accel>k</accel>tionen</guimenu><guimenuitem><accel>A</accel>bgleichen…</guimenuitem>
- </menuchoice>
- auswählen oder Sie verwenden die <guibutton>Abgleichen</guibutton> Schaltfläche in der
+ </menuchoice>auswählen oder Sie verwenden die <guibutton>Abgleichen</guibutton> Schaltfläche in der
<guilabel>Werkzeugleiste</guilabel>.
</para>
</tip>
@@ -2052,10 +1986,8 @@ and update the appendix. -->
<note>
<para>Die Schaltfläche <guibutton>Zahlung Habenzins eingeben…</guibutton> wird angezeigt, wenn Sie ein
- Konto vom Typ <emphasis>Bank</emphasis> abgleichen.
-<!-- FIXME source: insert description of the account typ liability -->
- Wohingegen bei Abgleich eines Kontos vom Typ <emphasis>Fremdkapital</emphasis> die
- Schaltfläche mit <guibutton>Zahlung Sollzins eingeben…</guibutton> beschriftet wird.
+ Konto vom Typ <emphasis>Bank</emphasis> abgleichen.<!-- FIXME source: insert description of the account typ liability -->Wohingegen bei Abgleich eines Kontos vom Typ <emphasis>Fremdkapital</emphasis> die Schaltfläche mit
+ <guibutton>Zahlung Sollzins eingeben…</guibutton> beschriftet wird.
</para>
</note>
@@ -2108,12 +2040,10 @@ and update the appendix. -->
<note>
<para>Wenn Sie die Option <guilabel>Buchungsüberschriften aus Rechnungswesen</guilabel> in dem Abschnitt
- <guilabel>Konten</guilabel> im &app; Menü
- <menuchoice>
+ <guilabel>Konten</guilabel> im &app; Menü<menuchoice>
<guimenu><accel>B</accel>earbeiten</guimenu>
<guimenuitem><accel>E</accel>instellungen</guimenuitem>
- </menuchoice>
- aktiviert haben, werden die beiden Listenbereiche mit <guilabel>Soll</guilabel> und
+ </menuchoice>aktiviert haben, werden die beiden Listenbereiche mit <guilabel>Soll</guilabel> und
<guilabel>Haben</guilabel> anstelle von <guilabel>Gutschrift</guilabel> und
<guilabel>Belastung</guilabel> bezeichnet sein.
</para>
@@ -2186,11 +2116,9 @@ and update the appendix. -->
<tip>
<para>Sie können alle Buchungen gleichzeit in einem der beiden Bereiche auswählen und als abgeglichen
kennzeichnen, indem Sie auf eine Buchung im gewünschten Bereich klicken und dann die
- Tastenkombination
- <keycombo action='simul'>
+ Tastenkombination<keycombo action='simul'>
<keycap>Strg</keycap><keycap>A</keycap><keycap>Leertaste</keycap>
- </keycombo>
- betätigen. Dies schaltet den Status des Abgleichs für alle Buchungen im Fensterbereich
+ </keycombo>betätigen. Dies schaltet den Status des Abgleichs für alle Buchungen im Fensterbereich
gleichzeitig entweder auf markiert oder nicht markiert. Der Vorgang kann wiederholt
werden, um den gewünschten Status für die Geschäftsvorgänge im Fensterbereich zu
erreichen.
@@ -2272,21 +2200,17 @@ and update the appendix. -->
geöffnet.
</para>
- <para>Wenn Sie den Abgleich bis zu einem späteren Zeitpunkt unterbechen wollen, wählen Sie im Menü
- <menuchoice>
+ <para>Wenn Sie den Abgleich bis zu einem späteren Zeitpunkt unterbechen wollen, wählen Sie im Menü<menuchoice>
<shortcut>
<keycombo>
<keycap>Strg</keycap><keycap>P</keycap>
</keycombo>
</shortcut>
<guimenu><accel>A</accel>bgleichen…</guimenu><guimenuitem><accel>U</accel>nterbrechen</guimenuitem>
- </menuchoice>
- oder verwenden die Schaltfläche <guibutton>Unterbrechen</guibutton>. Zum Abbrechen des
- Abgleichvorgangs verwenden Sie den Menüpunkt
- <menuchoice>
+ </menuchoice>oder verwenden die Schaltfläche <guibutton>Unterbrechen</guibutton>. Zum Abbrechen des
+ Abgleichvorgangs verwenden Sie den Menüpunkt<menuchoice>
<guimenu><accel>A</accel>bgleichen…</guimenu><guimenuitem><accel>A</accel>bbrechen</guimenuitem>
- </menuchoice>
- oder drücken Sie <guibutton>Abbrechen</guibutton>.
+ </menuchoice>oder drücken Sie <guibutton>Abbrechen</guibutton>.
</para>
<!-- FIXME source: delete sentence -->
<para>Wählen Sie jeden nicht abgeglichenen Geschäftsvorgang, der sich auf dem Kontoauszug wiederfindet,
@@ -2295,16 +2219,14 @@ and update the appendix. -->
gewählten Geschäftsvorgängen, bis am Ende der <guilabel>Schlusssaldo</guilabel> gleich
dem <guilabel>abgeglichenem Saldo</guilabel> ist und die <guilabel>Differenz</guilabel> Null
beträgt. Sobald dies erreicht ist, betätigen Sie die Schaltfläche
- <guibutton>Fertig</guibutton> oder den Befehl
- <menuchoice>
+ <guibutton>Fertig</guibutton> oder den Befehl<menuchoice>
<shortcut>
<keycombo>
<keycap>Strg</keycap><keycap>F</keycap>
</keycombo>
</shortcut>
<guimenu><accel>A</accel>bgleichen…</guimenu><guimenuitem><accel>F</accel>ertig</guimenuitem>
- </menuchoice>
- um den Abgleich zu beenden.
+ </menuchoice>um den Abgleich zu beenden.
</para>
</sect2>
</sect1>
@@ -2317,15 +2239,12 @@ and update the appendix. -->
wird, da es sich um ein festes Format handelt. Falls ein Konto mit der
<guilabel>vollständigen Kontobezeichnung</guilabel> bisher nicht existiert, wird es erstellt,
sofern die Währung oder das Wertpapier, in dem es notiert wird, bereits im Programm oder
- Ihrer &app;-Datei definiert ist.
- <note>
+ Ihrer &app;-Datei definiert ist.<note>
<para>Eine weitere Möglichkeit, Konten zu importieren, bietet der Assistent für das
<xref linkend="trans-import-qif" />. Im Zuge diese Importvorgangs werden ebenfalls Konten
in Ihre &app;-Datendatei importiert.
</para>
- </note>
-
- <itemizedlist spacing="compact">
+ </note><itemizedlist spacing="compact">
<para>Falls das Konto bereits existiert, werden diese vier Felder aktualisiert:
</para>
@@ -2461,15 +2380,12 @@ and update the appendix. -->
<title><guilabel>Benutzerdefinierter regulärer Ausdruck</guilabel></title>
<para>Mit Auswahl dieser Option öffnet sich ein kleines Eingabefenster in dem Sie einen <quote>regulären
- Ausdruck</quote>
- <footnote>
+ Ausdruck</quote><footnote>
<para>Für weitere Informationen können Sie den Artikel
<ulink url="https://de.wikipedia.org/wiki/Regul%C3%A4rer_Ausdruck">Regulärer
Ausdruck</ulink> im Wikipedia lesen.
</para>
- </footnote>
- , auch als <foreignphrase><abbrev>RegEx</abbrev></foreignphrase> bekannt, eingeben
- können.
+ </footnote>, auch als <foreignphrase><abbrev>RegEx</abbrev></foreignphrase> bekannt, eingeben können.
</para>
</step>
</substeps>
@@ -2623,33 +2539,32 @@ and update the appendix. -->
<sect2 id="acct-export-xml">
<title>Konten in ein neues &appname;-Buch exportieren</title>
- <para>Mit dem Menüpunkt
- <menuchoice>
+ <para>Mit dem Menüpunkt<menuchoice>
<guimenu><accel>D</accel>atei</guimenu><guisubmenu>E<accel>x</accel>portieren</guisubmenu><guimenuitem><accel>K</accel>onten
exportieren</guimenuitem>
- </menuchoice>
- können Sie Ihre vollständige &app;-Kontenhierarchie in eine <acronym>XML</acronym>- oder
+ </menuchoice>können Sie Ihre vollständige &app;-Kontenhierarchie in eine <acronym>XML</acronym>- oder
<acronym>SQLite3</acronym>-Datei oder auch in eine Datenbank exportieren. Mit dieser
Funktion haben Sie die Möglichkeit z.B. am Ende eines Jahres einen Buchabschluss
vorzunehmen und mit einer leeren &app;-Datei in das neue Jahr zu starten.
</para>
- <para>Es wird der übliche Datei-Speichern-Dialog geöffnet, der im oberen Bereich ein Auswahlfeld für die
- Datenausgabe im <guilabel>XML</guilabel> oder <guilabel>SQLite3</guilabel>-Format anbietet. Haben
- Sie bereits konfigurierte Datenbank-Systeme installiert, so werden diese ebenfalls hier zur
- Auswahl angeboten.
+ <para>Es wird der übliche Datei-Speichern-Dialog geöffnet, der im oberen Bereich ein Auswahlfeld für
+ die Datenausgabe im <guilabel>XML</guilabel> oder <guilabel>SQLite3</guilabel>-Format
+ anbietet. Haben Sie bereits konfigurierte Datenbank-Systeme installiert, so werden diese
+ ebenfalls hier zur Auswahl angeboten.
</para>
<table id="Account-Export-Dialog">
<title>Dialog zum Exportieren von Konten</title>
<tgroup align="left" cols="2">
- <colspec colwidth="0.5*"/>
- <colspec colwidth="0.5*"/>
+ <colspec colwidth="0.5*"/>
+
+ <colspec colwidth="0.5*"/>
<tbody>
<row valign="top">
- <entry>
+ <entry>
<para><figure>
<title>Exportieren in Datei</title><screenshot>
<mediaobject>
@@ -2711,13 +2626,10 @@ and update the appendix. -->
</varlistentry>
</variablelist>
- <para>Die exportierte Datei kann über
- <menuchoice>
+ <para>Die exportierte Datei kann über<menuchoice>
<guimenu><accel>D</accel>atei</guimenu><guimenuitem>Ö<accel>f</accel>fnen</guimenuitem>
- </menuchoice>
- in &app; geöffnet werden. Sie müssen dann noch für alle Konten manuell die
- Anfangsbestände eintragen.
- <tip>
+ </menuchoice>in &app; geöffnet werden. Sie müssen dann noch für alle Konten manuell die Anfangsbestände
+ eintragen.<tip>
<para>Öffnen sie hierfür z.B. eine 2. Instanz von &app;, um die Schlussbilanz der alten Datei als
Anfangsbestand in die neue Datei zu übertragen.
</para>
@@ -2734,12 +2646,10 @@ and update the appendix. -->
Kontenstruktur zur Verfügung zu haben.
</para>
- <para>Hierzu wählen Sie im Menü
- <menuchoice>
+ <para>Hierzu wählen Sie im Menü<menuchoice>
<guimenu><accel>D</accel>atei</guimenu><guisubmenu>E<accel>x</accel>portieren</guisubmenu><guimenuitem>Konten<accel>h</accel>ierarchie
nach CSV exportieren…</guimenuitem>
- </menuchoice>
- und es öffnet sich ein Dialog für die <guilabel>Export-Einstellungen</guilabel>.
+ </menuchoice>und es öffnet sich ein Dialog für die <guilabel>Export-Einstellungen</guilabel>.
</para>
<figure pgwide="1">
diff --git a/manual/de/Help_ch_Customize.xml b/manual/de/Help_ch_Customize.xml
index d9eb8042..e37298d5 100644
--- a/manual/de/Help_ch_Customize.xml
+++ b/manual/de/Help_ch_Customize.xml
@@ -1356,8 +1356,7 @@ Translators:
hier ein persönlicher Schlüssel eingetragen werden. Der Schlüssel kann auf der
<ulink url="&url-av;">Alpha Vantage Website</ulink> beantragt werden.
<tip>
-<!-- FIXME: When PR #206 has been merged this xref has to adjust to "online-quotes" -->
- <para>Die Kursaktualisierung mit &app-fq; wird in <xref linkend="Online-price-setup" /> beschrieben.
+ <para>Die Kursaktualisierung mit &app-fq; wird in <xref linkend="finance-quote" /> beschrieben.
</para>
</tip>
<tip>
diff --git a/manual/de/Help_ch_Tools_Assistants.xml b/manual/de/Help_ch_Tools_Assistants.xml
index 49361167..d975f784 100644
--- a/manual/de/Help_ch_Tools_Assistants.xml
+++ b/manual/de/Help_ch_Tools_Assistants.xml
@@ -5301,7 +5301,7 @@
</para>
<para>Detailed instructions are in the section on Creating New Accounts.
- <xref linkend="Online-price-setup"></xref>
+ <xref linkend="accts-online-quotes"></xref>
</para>
</sect2>
</sect1>
diff --git a/manual/de/Help_ch_Transactions.xml b/manual/de/Help_ch_Transactions.xml
index f6298de0..03d2b432 100644
--- a/manual/de/Help_ch_Transactions.xml
+++ b/manual/de/Help_ch_Transactions.xml
@@ -193,7 +193,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="Online-price-setup"/>), können Sie über die Schaltfläche
+ <xref linkend="finance-quote-install"/>), können Sie über die Schaltfläche
<guilabel>Wechselkurs abrufen</guilabel> einen aktuellen Kurs abfragen.
</para>
diff --git a/manual/de/ch_Finance-Quote.xml b/manual/de/ch_Finance-Quote.xml
new file mode 100644
index 00000000..bbfc343f
--- /dev/null
+++ b/manual/de/ch_Finance-Quote.xml
@@ -0,0 +1,277 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE chapter SYSTEM "gnc-docbookx.dtd">
+<!-- (Do not remove this comment block.)
+Version: 1.0.0
+Last modified: August 08th 2021
+
+Maintainers:
+ xxx
+Author:
+ TANIGUCHI Yasuaki <yasuakit at gmail.com>
+ Christian Wehling <christian.wehling at web.de>
+Translators:
+ Christian Wehling <christian.wehling at web.de>
+-->
+<chapter id="finance-quote"
+ xmlns:xi="http://www.w3.org/2001/XInclude">
+ <title>Die Online-Kursaktualisierung</title>
+
+ <para>Wenn Sie mehr als ein paar Devisen und Wertpapiere besitzen, werden Sie es bald leid sein, die Kurse
+ ständig per Hand aktualisieren zu müssen. &app; bietet Ihnen die Möglichkeit, automatisch den
+ aktuellsten Kurs für Ihre Devisen und Wertpapiere über das Internet herunterzuladen. Hierfür
+ wird das &app-perl;-Modul &app-fq; verwendet.
+ </para>
+
+ <sect1 id="finance-quote-install">
+ <title>Installieren von &app-fq;</title>
+
+ <para>Um festzustellen, ob das &app-perl;-Modul &app-fq; bereits auf Ihrem System installiert ist, geben
+ Sie <command>perldoc Finance::Quote</command> in einem Terminalfenster ein. Wird Ihnen jetzt
+ eine Dokumentation 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 müssen Sie sich mit diesem Kapitel weiter beschäftigen.
+ </para>
+
+ <itemizedlist>
+ <title>Die Vorraussetzungen für eine Online-Kursaktualisierung mit &app-fq; sind</title>
+
+ <listitem>
+ <para>ein &app-perl; Interpreter,
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>das &app-perl;-Module &app-fq; selber und
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>alle Abhängigkeiten, die für das Modul &app-fq; erforderlich sind.
+ </para>
+ </listitem>
+ </itemizedlist>
+
+ <note>
+ <para>Wenn Sie sich bei der Durchführung mit den nachfolgend beschriebenen Schritte nicht sicher fühlen,
+ senden Sie bitte ihre Frage entweder per E-Mail an die deutschsprachige &app;-user
+ Mailingliste (<email>gnucash-de at gnucash.org</email>) oder besuchen Sie den &app; IRC-Kanal
+ auf irc.gnome.org. Weitere Informationen finden Sie auch im &app; Wiki unter
+ <ulink url="&url-wiki-de;Aktienhandel">Aktienhandel</ulink>. Sie können diesen Schritt auch
+ weglassen und Ihre Aktienkurse manuell aktualisieren.
+ </para>
+ </note>
+
+ <para>Die Installation von &app-perl; liegt nicht im Fokus dieser Anleitung. Eine ausführliche
+ Beschreibung ist im englischsprachigen &app; Wiki unter
+ <ulink url="&url-wiki-OQ;#Perl">Perl</ulink> zu finden.
+ </para>
+
+ <para>Die Installation von &app-fq; unterscheidet sich von einem Betriebssystem zum anderen. Für die
+ verschiedenen unterstützten Systeme, können Sie die folgenden Anweisungen befolgen:
+ </para>
+
+ <procedure>
+ <title>Installieren von &app-fq; unter &lin;</title>
+
+ <step>
+ <simpara>Beenden Sie &app;.
+ </simpara>
+ </step>
+
+ <step>
+ <simpara>Führen Sie den Befehl <command>gnc-fq-check</command> aus, um zu überprüfen, ob das Programm
+ bereits in einem Verzeichnis liegt, welches in der Umgebungsvariable PATH eingetragen ist.<footnote>
+ <simpara>Wenn Sie die von Ihrer Distribution bereitgestellten &app; Pakete installiert haben, sollte
+ <filename>gnc-fq-check</filename> bereits in Ihrem PATH sein. Die Aktualität ihrer
+ Distribution können Sie unter
+ <ulink url="&url-repo;perl:finance-quote/versions"><citetitle>&app-fq;-
+ Versionen</citetitle></ulink> nachlesen.
+ </simpara>
+ </footnote>
+ </simpara>
+
+ <substeps>
+ <step>
+ <simpara>Wenn <filename>gnc-fq-check</filename> nicht in Ihrem PATH ist, suchen Sie den Ordner, in dem &app;
+ installiert ist und wechseln in dieses Verzeichnis.
+ </simpara>
+ </step>
+
+ <step>
+ <simpara>Es bietet sich an, das aktuelle Verzeichnis in der PATH-Umgebungsvariable aufzunehmen. Hierzu
+ informieren Sie sich bitte in den Unterlagen zu Ihrer Distribution.
+ </simpara>
+ </step>
+ </substeps>
+ </step>
+
+ <step>
+ <simpara>Als nächstes aktualisieren Sie mit <command>sudo gnc-fq-update</command> oder <command>su -c
+ gnc-fq-update</command> mit Root-Rechten &app-fq;. Die richtige Syntax ist von der
+ jeweiligen Distribution abhängig.
+ </simpara>
+
+ <para>Dadurch wird ein internes &app-perl;
+ <acronym><ulink url="&url-cpan;">CPAN</ulink></acronym><footnote>
+ <simpara>Siehe <ulink url="&url-cpan;misc/cpan-faq.html">CPAN Frequently Asked Questions</ulink>
+ für weitere Informationen.
+ </simpara>
+ </footnote>Modul gestartet um die Installation vorzunehmen. Wenn Sie das CPAN zum ersten Mal starten, müssen
+ Sie es einrichten und konfigurieren. Auf den meisten Systemen können Sie jedoch die
+ Standardeinstellungen akzeptieren und die erste Frage <computeroutput>Are you ready for
+ manual configuration? [yes]</computeroutput> mit <userinput>no</userinput> beantworten
+ damit &app-fq; erfolgreich installiert wird.
+ </para>
+ </step>
+
+ <step>
+ <simpara>Führen Sie <command>gnc-fq-check</command> 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>
+
+ <procedure>
+ <title>Installieren von &app-fq; in &mac;</title>
+
+ <step>
+ <simpara>Beenden Sie &app;.
+ </simpara>
+ </step>
+
+ <step>
+ <simpara>Installieren Sie XCode, falls noch nicht geschehen.
+ </simpara>
+
+ <simpara>XCode ist ein optionales Element auf Ihrer &mac; Distributions-DVD.
+ </simpara>
+ </step>
+
+ <step>
+ <simpara>Führen Sie die Anwendung <emphasis>Update Finance Quote</emphasis> im &app; dmg aus.
+ </simpara>
+
+ <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>
+ </procedure>
+
+ <procedure>
+ <title>Installieren von &app-fq; unter &win;</title>
+
+ <step>
+ <simpara>Beenden Sie &app;.
+ </simpara>
+ </step>
+
+ <step>
+ <simpara>Führen Sie<menuchoice>
+ <guimenu>Start</guimenu> <guisubmenu>&app;</guisubmenu> <guimenuitem>Online-Preisabfrage
+ installieren</guimenuitem>
+ </menuchoice>aus.
+ </simpara>
+
+ <para>Das &win;-Installationsprogramm von der <ulink url="&url-www;download.phtml">&app; Homepage</ulink>
+ wird zusätzlich mit einem kleinen Hilfsprogramm geliefert, das &app-fq; für Sie
+ installiert.
+ </para>
+ </step>
+ </procedure>
+ </sect1>
+
+ <sect1 id="finance-quote-scheduler">
+ <title>Automatisierte Abfrage von Online-Kursen</title>
+
+ <para>Mit dem Kommando <command>gnucash-cli --quotes get
+ <filename><replaceable>${HOME}/gnucash-filename</replaceable></filename></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
+ <filename><replaceable>${HOME}/gnucash-filename</replaceable></filename></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.
+ </para>
+
+ <para>Die angegebene Datei <filename><replaceable>${HOME}/gnucash-filename</replaceable></filename> 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
+ <guimenu>Datei</guimenu>-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>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. Nehmen wir zum Beispiel an Sie möchten Ihre Datei jeden Freitag um 16:00
+ Uhr aktualisieren. (Passen Sie die Zeit an den Börsenschluss an.)
+ </para>
+
+ <procedure>
+ <title>Automatisierter Kursabruf unter &lin; und &mac;</title>
+
+ <para>Eintragen des Befehls zum Kursabruf per <command>gnucash-cli</command> mittels
+ <application>cron</application>.
+ </para>
+
+ <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 <replaceable>${HOME}/gnucash-filename</replaceable> > /dev/null 2>&1</screen>
+ </informalexample><warning>
+ <para>Läuft auf Ihrem Rechner zu dem Zeitpunkt des Kursabrufs keine X-Session, so müssen Sie den Aufruf
+ stattdessen wie folgt ausführen:<screen>0 16 * * 5 env `dbus-launch` sh -c 'trap "kill $DBUS_SESSION_BUS_PID" EXIT; gnucash-cli --quotes get <replaceable>${HOME}/gnucash-filename</replaceable> > /dev/null 2>&1</screen>
+ </para>
+ </warning>
+ </para>
+ </step>
+ </procedure>
+
+ <procedure>
+ <title>Automatisierter Kursabruf unter &win;</title>
+
+ <para>Anlegen des Kursabrufs per <command>gnucash-cli</command> mit der Aufgabenplanung.
+ </para>
+
+ <step>
+ <simpara>Wählen Sie<menuchoice>
+ <guimenu>Start</guimenu><guisubmenu>Systemsteuerung</guisubmenu><guimenuitem>Aufgabenplanung</guimenuitem>
+ </menuchoice>.
+ </simpara>
+ </step>
+
+ <step>
+ <simpara>Klicken Sie auf <guimenuitem>Aufgabe erstellen</guimenuitem>.
+ </simpara>
+ </step>
+
+ <step>
+ <simpara>Geben Sie die entsprechenden Angaben im Fenster <guilabel>Aufgabe erstellen</guilabel> ein.
+ </simpara>
+ </step>
+ </procedure>
+
+ <para>Weitere Informationen finden Sie im Wiki unter
+ <ulink url="&url-wiki-de;Aktienhandel#Automatisierter_Kursabruf_mittels_cron">Automatisierter
+ Kursabruf mittels cron</ulink> und auf
+ <ulink url="&url-wiki-OQ;#Updating_enabled_Quotes_from_outside_GnuCash">Online Quotes Page on
+ GnuCash Wiki</ulink>.
+ </para>
+ </sect1>
+</chapter>
diff --git a/manual/de/gnucash-help.xml b/manual/de/gnucash-help.xml
index 149aa072..03659d1e 100644
--- a/manual/de/gnucash-help.xml
+++ b/manual/de/gnucash-help.xml
@@ -495,6 +495,8 @@
<xi:include href="Help_ch_Reports.xml" />
<xi:include href="Help_ch_Customize.xml" />
+
+ <xi:include href="ch_Finance-Quote.xml" />
<xi:include href="Help_tips-appendix.xml" />
Summary of changes:
docbook/gnc-docbookx.dtd | 2 +
manual/C/CMakeLists.txt | 1 +
manual/C/Help_ch_Account-Actions.xml | 385 +++++++---------------
manual/C/Help_ch_Tools_Assistants.xml | 2 +-
manual/C/Help_ch_Transactions.xml | 2 +-
manual/C/ch_Finance-Quote.xml | 265 +++++++++++++++
manual/C/gnucash-help.xml | 3 +
manual/de/CMakeLists.txt | 1 +
manual/de/Help_ch_Account-Actions.xml | 566 ++++++++++++++-------------------
manual/de/Help_ch_Customize.xml | 3 +-
manual/de/Help_ch_Tools_Assistants.xml | 2 +-
manual/de/Help_ch_Transactions.xml | 2 +-
manual/de/ch_Finance-Quote.xml | 277 ++++++++++++++++
manual/de/gnucash-help.xml | 2 +
14 files changed, 915 insertions(+), 598 deletions(-)
create mode 100644 manual/C/ch_Finance-Quote.xml
create mode 100644 manual/de/ch_Finance-Quote.xml
More information about the gnucash-changes
mailing list