gnucash-docs maint: Multiple changes pushed
Frank H.Ellenberger
fell at code.gnucash.org
Thu Jun 23 01:33:52 EDT 2022
Updated via https://github.com/Gnucash/gnucash-docs/commit/56bc8a23 (commit)
via https://github.com/Gnucash/gnucash-docs/commit/6bc43edc (commit)
via https://github.com/Gnucash/gnucash-docs/commit/8509f27f (commit)
from https://github.com/Gnucash/gnucash-docs/commit/6ddeb5db (commit)
commit 56bc8a23cbb67f3b1b05e1ee4e1c323fe8594047
Merge: 8509f27f 6bc43edc
Author: Frank H. Ellenberger <frank.h.ellenberger at gmail.com>
Date: Thu Jun 23 07:21:31 2022 +0200
Merge remote-tracking branch 'cwehli/de_help_Tools_Intro' into maint
commit 6bc43edc7a7fa6139700c5d94f5184441b9c7ffe
Author: Christian Wehling <christian.wehling at web.de>
Date: Wed May 25 21:45:10 2022 +0200
L10n:de: manual ch_Tools_Assistant: Intro
diff --git a/manual/de/Help_ch_Tools_Assistants.xml b/manual/de/Help_ch_Tools_Assistants.xml
index bec9f1e8..7b794b68 100644
--- a/manual/de/Help_ch_Tools_Assistants.xml
+++ b/manual/de/Help_ch_Tools_Assistants.xml
@@ -1,54 +1,58 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE chapter SYSTEM "gnc-gui-de.dtd">
-<!--
- (Do not remove this comment block.)
- Version: 2.0.x
- Last modified: April 15th 2007
- modified: August 12th 2006
- modified: February 28th 2005
-
+<!-- (Do not remove this comment block.)
+ Version: 4.9
+ Last modified: Juli 2022
+ modified: April 15th 2007
+ modified: August 12th 2006
+ modified: February 28th 2005
Maintainers:
- Chris Lyttle <chris at wilddev.net>
- Neil Williams <linux at codehelp.co.uk>
-
+ Chris Lyttle <chris at wilddev.net>
+ Neil Williams <linux at codehelp.co.uk>
Author:
- Chris Lyttle <chris at wilddev.net>
+ Chris Lyttle <chris at wilddev.net>
Translators:
- (translators put your name and email here)
+ Christian Wehling <christian.wehling at web.de>
-->
<chapter id="ch_AccRegTools">
- <title>Tools & Assistants</title>
-
- <para>&untranslated-de;
- </para>
+ <title>Assistenten und ähnliche Werkzeuge</title>
<abstract>
- <para>&app; offers many specialized <guimenu>Tools</guimenu>. These tools enable access to the enhanced
- functionality of &app;. They are accessed via the <guimenu>Tools</guimenu> menu from any
- window that displays the &app; standard menu. Some of these tools may be deactivated for
- several reasons:
- <itemizedlist spacing="compact">
+ <para>&app; enthält eine Reihe von Werkzeuge, um zeitaufwendige oder komplexere Vorgänge zu vereinfachen.
+ Wenn das aktuelle Fenster das Standardmenü beinhaltet, kann, sofern es keinen passenderen Kontext gibt, über das Menü &gm.tool;
+ darauf zugegriffen werden. Weitere Assistenten sind auch im Menü &gm.act; enthalten.
+ </para>
+ </abstract>
+
+ <important>
+ <para>
+ Einige dieser Werkzeuge können aus den folgenden Gründen deaktiviert sein:
+ <itemizedlist>
<listitem>
- <para>the tools is not appropriate for the current window,
+ <para>Die Werkzeuge sind nicht für das aktuelle Fenster geeignet.
</para>
</listitem>
<listitem>
- <para>the required software is not found on your system,
+ <para>&app; kann die erforderliche Software, z.B. &app-fq; für den Abruf von Online-Kursen, nicht auf Ihrem System finden.
</para>
</listitem>
<listitem>
- <para>the package maintainer disabled it in the build process.
+ <para>Der Paketbetreuer hat sie während des Erstellungsprozesses deaktiviert, z,B. &app-aqb; für das Online-Banking.
</para>
</listitem>
</itemizedlist>
- </para>
- </abstract>
+ </para>
+ </important>
+
<sect1 id="tool-find">
<title>Find</title>
+ <para>&untranslated-de;
+ </para>
+
<para>The &app; <emphasis>Find</emphasis> assistant can be used to <link linkend="tool-find-txn">find
transactions</link> or to perform <link linkend="tool-find-bsnss">business related</link>
research on your data file.
commit 8509f27f49b7dacb31bb80994baa8e874b1e32e4
Author: Christian Wehling <christian.wehling at web.de>
Date: Tue Jan 11 21:24:52 2022 +0100
F::Q Description of installing Perl
diff --git a/manual/C/ch_Finance-Quote.xml b/manual/C/ch_Finance-Quote.xml
index dd6b31a7..7577729f 100644
--- a/manual/C/ch_Finance-Quote.xml
+++ b/manual/C/ch_Finance-Quote.xml
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE chapter SYSTEM "gnc-docbookx.dtd">
+<!DOCTYPE chapter SYSTEM "gnc-gui-C.dtd">
<!-- (Do not remove this comment block.)
Version: 1.0.0
Last modified: August 08th 2021
@@ -14,7 +14,7 @@ Translators:
-->
<chapter id="finance-quote"
xmlns:xi="http://www.w3.org/2001/XInclude">
- <title>Setting up the Online Quote update</title>
+ <title>Setting up the 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
@@ -22,6 +22,107 @@ Translators:
which must be installed in order to activate this feature.
</para>
+ <itemizedlist>
+ <title>Prerequisites for an Online Quote update with &app-fq; are</title>
+
+ <listitem>
+ <para>the &app-perl; language interpreter and
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>the &app-perl;-module &app-fq; with any dependencies.
+ </para>
+ </listitem>
+ </itemizedlist>
+
+ <note>
+ <para>If you get stuck while performing the steps described here, you can reach many helpful users on the
+ channels mentioned under <xref linkend="more_help" />.
+ </para>
+ </note>
+
+ <para>You can also leave out this step and manually update your stock quotes.
+ </para>
+
+ <sect1 id="finance-quote-perl-install">
+ <title>Installing &app-perl;</title>
+
+ <para>The installation of &app-perl; is essentially dependent on the operating system used. The effort for
+ installation is low and is described in this section.
+ </para>
+
+ <para>To check if &app-perl; is already installed on your system, call the command
+ <informalexample>
+<screen>perl -v</screen>
+ </informalexample>
+ in the terminal. If you are shown the version number of the &app-perl; interpreter, then
+ continue with <xref linkend="finance-quote-install" />.
+ </para>
+
+ <procedure>
+ <title>On &lin;</title>
+
+ <step>
+ <para>On most systems &app-perl; is probably already installed. If with the previous command does not show
+ a version, then the easiest way is to use your system’s package manager for installation.
+ </para>
+ </step>
+
+ <step>
+ <para>When using the &app; &flatpak; package, &app-perl; and &app-fq; are already functionally installed.
+ </para>
+ </step>
+ </procedure>
+
+ <procedure>
+ <title>On &mac;</title>
+
+ <step>
+ <para>&app-perl; is normally already set up under &mac;.
+ </para>
+ </step>
+ </procedure>
+
+ <procedure>
+ <title>On &win;</title>
+
+ <step>
+ <para>Under &win; run the program
+ <menuchoice>
+ <guimenu>Start</guimenu> <guisubmenu>&appname;</guisubmenu> <guimenuitem>Install Online
+ Price Retrieval</guimenuitem>
+ </menuchoice>
+ to run. This will install <ulink url="&url-wp-en;Strawberry_Perl">Strawberry Perl</ulink>.
+ <footnote>
+ <para>&app; Version 2.2.6 and befor require <ulink url="&url-wp-en;ActivePerl">ActivePerl</ulink>. in
+ version 5.8.
+ </para>
+ </footnote>
+
+ <footnote>
+ <para>&app; Version 2.4 and befor require <ulink url="&url-wp-en;ActivePerl">ActivePerl</ulink> Version
+ 5.16.3 and later.
+ </para>
+ </footnote>
+ </para>
+ </step>
+
+ <step>
+ <para>For execution you need <emphasis>Administrator privilegies</emphasis>, which are requested in the
+ dialog. The installation can take more then 15 minutes.
+ </para>
+ </step>
+
+ <step>
+ <para>If during the installation the error message <computeroutput>No such file or directory
+ </computeroutput> or <computeroutput>permission denied</computeroutput> are displayed,
+ then it may help to disable the antivirus software temporarily.
+ </para>
+ </step>
+ </procedure>
+ </sect1>
+
<sect1 id="finance-quote-install">
<title>Installing &app-fq;</title>
@@ -39,45 +140,12 @@ SYNOPSIS
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
- <ulink url="&url-irc;">#&appname; IRC channel</ulink>.
- 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>
+ <title>On &lin;</title>
<step>
<simpara>Close &app;.
@@ -135,7 +203,7 @@ SYNOPSIS
</procedure>
<procedure>
- <title>Installing &app-fq; on &mac;</title>
+ <title>On &mac;</title>
<step>
<simpara>Close &app;.
@@ -162,7 +230,7 @@ SYNOPSIS
</procedure>
<procedure>
- <title>Installing &app-fq; on &win;</title>
+ <title>On &win;</title>
<step>
<simpara>Close &app;.
@@ -172,7 +240,7 @@ SYNOPSIS
<step>
<simpara>Run
<menuchoice>
- <guimenu>Start</guimenu> <guisubmenu>&app;</guisubmenu> <guimenuitem>Install Online
+ <guimenu>Start</guimenu> <guisubmenu>&appname;</guisubmenu> <guimenuitem>Install Online
Price Retrieval</guimenuitem>
</menuchoice>
. This is a small utility that installs &app-fq; for you.
@@ -182,7 +250,7 @@ SYNOPSIS
</sect1>
<sect1 id="finance-quote-scheduler">
- <title>Configuring for Getting Online Quotes Periodically</title>
+ <title>Configuring for Getting Quotes Periodically</title>
<para>The command <command>gnucash-cli --quotes get &user-datafile;</command>
<footnote>
@@ -194,8 +262,8 @@ SYNOPSIS
</simpara>
</footnote>
can be used to fetch the current quotes of your stocks and write them directly into your
- &app;-data file without starting the GUI. Thus an automatic, regular updating of the
- price database is possible.
+ &app;-data file without starting the GUI. Thus an automatic, regular updating of the price
+ database is possible.
<warning>
<para>Please note that the data file should not be open in another instance of &app; at the same time!
</para>
@@ -282,7 +350,7 @@ gnucash-cli --quotes get &user-datafile; > /dev/null 2>&1</screen>
<para>Adjust the time to the close of the stock exchange and consider <emphasis>fund quotes</emphasis>,
that the net asset value (NAV) is determined well after the markets closed. The types have
their description in <xref linkend="tool-price" />.
-<!-- FIXME: aadjust the link to a proper ID -->
+<!-- FIXME: adjust the link to a proper ID -->
</para>
</example>
diff --git a/manual/de/ch_Finance-Quote.xml b/manual/de/ch_Finance-Quote.xml
index 734fbb1c..5b780b78 100644
--- a/manual/de/ch_Finance-Quote.xml
+++ b/manual/de/ch_Finance-Quote.xml
@@ -14,14 +14,119 @@ Translators:
-->
<chapter id="finance-quote"
xmlns:xi="http://www.w3.org/2001/XInclude">
- <title>Die Online-Kursaktualisierung einrichten</title>
+ <title>Einrichtung der 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>Wenn Sie mehr als ein paar Devisen und Wertpapiere besitzen, werden Sie es vielleicht 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>
+ <itemizedlist>
+ <title>Die Vorraussetzungen für eine Online-Kursabfrage mit &app-fq; sind</title>
+
+ <listitem>
+ <para>ein &app-perl; Interpreter und
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>das &app-perl;-Module &app-fq; mit allen Abhängigkeiten.
+ </para>
+ </listitem>
+ </itemizedlist>
+
+ <note>
+ <para>Wenn Sie bei der Durchführung der hier beschriebenen Schritte nicht mehr weiterwissen,
+ können Sie auf den unter <xref linkend="more_help" /> genannten Kanäle viele hilfsbereiten
+ Anwender erreichen.
+ </para>
+ </note>
+
+ <para>Sie können diesen Schritt auch weglassen und Ihre Aktienkurse weiterhin manuell aktualisieren.
+ </para>
+
+ <sect1 id="finance-quote-perl-install">
+ <title>Installieren von &app-perl;</title>
+
+ <para>Die Installation von &app-perl; ist im wesentlichen von dem verwendeten Betriebssystem abhängig.
+ Der Aufwand zur Installation ist gering und wird in diesem Abschnitt beschrieben.
+ </para>
+
+ <para>Um zu überprüfen ob auf Ihrem System &app-perl; schon bereits installiert ist, rufen Sie den Befehl
+ <informalexample>
+<screen>perl -v</screen>
+ </informalexample>
+ im Terminal auf. Wird Ihnen die Versionsnummer des &app-perl;-Interpreters angezeigt, dann
+ machen Sie mit <xref linkend="finance-quote-install" /> weiter.
+ </para>
+
+ <procedure>
+ <title>Unter &lin;</title>
+
+ <step>
+ <para>Bei den meisten Systemen ist &app-perl; wahrscheinlich bereits installiert. Wird mit dem vorherigen
+ Befehl keine Version angezeigt wird, dann verwenden Sie am einfachsten die Paketverwaltung
+ Ihres Systems zur Installation.
+ </para>
+ </step>
+
+ <step>
+ <para>Verwenden Sie das &app; &flatpak; Paket sind &app-perl; und &app-fq; bereits funktionsfähig
+ installiert.
+ </para>
+ </step>
+ </procedure>
+
+ <procedure>
+ <title>Unter &mac;</title>
+
+ <step>
+ <para>&app-perl; ist unter &mac; normalerweise schon eingerichtet.
+ </para>
+ </step>
+ </procedure>
+
+ <procedure>
+ <title>Unter &win;</title>
+
+ <step>
+ <para>Unter &win; führen Sie das Programm
+ <menuchoice>
+ <guimenu>Start</guimenu> <guisubmenu>&appname;</guisubmenu>
+ <guimenuitem>Online-Preisabfrage installieren</guimenuitem>
+ </menuchoice>
+ aus. Dies wird <ulink url="&url-wp-en;Strawberry_Perl">Strawberry Perl</ulink>
+ installieren.
+ <footnote>
+ <para>&app; Version 2.2.6 und früher benötigen <ulink url="&url-wp-en;ActivePerl">ActivePerl</ulink> in
+ Version 5.8.
+ </para>
+ </footnote>
+
+ <footnote>
+ <para>&app; Version 2.4 und früher benötigen <ulink url="&url-wp-en;ActivePerl">ActivePerl</ulink> ab
+ Version 5.16.3.
+ </para>
+ </footnote>
+ </para>
+ </step>
+
+ <step>
+ <para>Zu Ausführung beötigen Sie <emphasis>Administratorenrechte</emphasis>, die im Dialog abgefragt
+ werden. Die Installation kann mehr als 15 Minuten dauern.
+ </para>
+ </step>
+
+ <step>
+ <para>Werden während der Installation die Fehlermeldung <computeroutput>No such file or directory
+ </computeroutput> oder <computeroutput>permission denied</computeroutput> angezeigt, dann
+ kann es helfen das Antivirenprogramm vorübergehend zu deaktiviern.
+ </para>
+ </step>
+ </procedure>
+ </sect1>
+
<sect1 id="finance-quote-install">
<title>Installieren von &app-fq;</title>
@@ -39,47 +144,12 @@ SYNOPSIS
konfigurieren. Wenn nicht, dann gibt Ihnen dieser Abschnitt eine Anleitung zur Installation.
</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
- <ulink url="&url-irc;">#&appname; IRC-Kanal</ulink>.
- 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>
+ <title>Unter &lin;</title>
<step>
<simpara>Beenden Sie &app;.
@@ -124,8 +194,8 @@ SYNOPSIS
</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
+ die Standardvorgaben 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>
@@ -140,7 +210,7 @@ SYNOPSIS
</procedure>
<procedure>
- <title>Installieren von &app-fq; in &mac;</title>
+ <title>Unter &mac;</title>
<step>
<simpara>Beenden Sie &app;.
@@ -168,7 +238,7 @@ SYNOPSIS
</procedure>
<procedure>
- <title>Installieren von &app-fq; unter &win;</title>
+ <title>Unter &win;</title>
<step>
<simpara>Beenden Sie &app;.
@@ -178,8 +248,8 @@ SYNOPSIS
<step>
<simpara>Führen Sie
<menuchoice>
- <guimenu>Start</guimenu> <guisubmenu>&app;</guisubmenu> <guimenuitem>Online-Preisabfrage
- installieren</guimenuitem>
+ <guimenu>Start</guimenu> <guisubmenu>&appname;</guisubmenu>
+ <guimenuitem>Online-Preisabfrage installieren</guimenuitem>
</menuchoice>
aus. Dies ist ein kleines Hilfsprogramm, das &app-fq; für Sie installiert.
</simpara>
@@ -188,7 +258,7 @@ SYNOPSIS
</sect1>
<sect1 id="finance-quote-scheduler">
- <title>Automatisierte Abfrage von Online-Kursen</title>
+ <title>Automatisierte Abfrage von Kursen</title>
<para>Mit dem Kommando <command>gnucash-cli --quotes get &user-datafile;</command>
<footnote>
@@ -200,10 +270,11 @@ SYNOPSIS
</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.
+ &app;-Datendatei schreiben ohne die Benutzeroberfläche zu starten. Somit ist eine
+ automatische, regelmäÃige Aktualisierung der Kursdatenbank möglich.
<warning>
- <para>Beachten Sie bitte, dass die Datendatei nicht gleichzeitig in einer anderen Instanz von &app; geöffnet sein darf!
+ <para>Beachten Sie bitte, dass die Datendatei nicht gleichzeitig in einer anderen Instanz von &app;
+ geöffnet sein darf!
</para>
</warning>
</para>
@@ -296,9 +367,11 @@ gnucash-cli --quotes get &user-datafile; > /dev/null 2>&1</screen>
</para>
</example>
- <para>Einige Benutzer haben im englischsprachigen Wiki Ergänzungen und ihre Erfahrungen auf der
+ <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> zusammengestellt.
+ GnuCash Wiki</ulink> ihre Erfahrungen und weiter Ergänzungen zusammengestellt.
</para>
</sect1>
</chapter>
Summary of changes:
manual/C/ch_Finance-Quote.xml | 154 ++++++++++++++++++++--------
manual/de/Help_ch_Tools_Assistants.xml | 56 ++++++-----
manual/de/ch_Finance-Quote.xml | 179 +++++++++++++++++++++++----------
3 files changed, 267 insertions(+), 122 deletions(-)
More information about the gnucash-changes
mailing list