Git commit bf9ef0b31123c10f4b3bb0a283a7397aa34d8cfb by Dawid Wróbel.
Committed on 19/07/2021 at 10:38.
Pushed by wrobelda into branch 'master'.

Docs: add Woob plugin section

A  +37   -0    doc/details-impexp-woob.docbook
M  +5    -0    doc/details-impexp.docbook
M  +5    -3    doc/index.docbook

https://invent.kde.org/office/kmymoney/commit/bf9ef0b31123c10f4b3bb0a283a7397aa34d8cfb

diff --git a/doc/details-impexp-woob.docbook b/doc/details-impexp-woob.docbook
new file mode 100644
index 000000000..145af1a61
--- /dev/null
+++ b/doc/details-impexp-woob.docbook
@@ -0,0 +1,37 @@
+<sect1 id="details.impexp.woob">
+    <sect1info>
+        <author>&Dawid.Wrobel; &Dawid.Wrobel.mail;</author>
+    </sect1info>
+
+    <title>Woob Importer</title>
+    <sect2>
+        <title>What is Woob?</title>
+        <para>
+            <ulink url="https://woob.tech/";>Woob</ulink> is is <quote>a 
collection of applications able to interact with
+            websites, without requiring the user to open them in a 
browser</quote>. One of
+            <ulink url="https://woob.tech/applications/";>such 
applications</ulink> allows specifically to interact with
+            <ulink url="https://woob.tech/applications/bank";>financial 
institutions</ulink>. &kmymoney; provides a
+            plugin that employs it directly, therefore allowing to import 
transactions from those accounts which
+            otherwise do not offer support for any other financial protocol 
that &kmymoney; handles.
+        </para>
+
+        <note>
+            <para>
+                &kmymoney; currently requires that you install Woob 
independently. Refer to the further sections for
+                details.
+            </para>
+        </note>
+    </sect2>
+    <sect2>
+        <title>Installing Woob</title>
+        <para>
+            You need to install Python 3 first before continuing. You can 
download a package for your system from the
+            <ulink url="https://www.python.org/downloads/";>official 
website</ulink>.
+        </para>
+
+        <para>
+            With Python 3 installed, you should now be able to easily download 
and install required Woob modules.
+            Please refer to the instructions on <ulink 
url="https://woob.tech/install/";>Woob website</ulink>.
+        </para>
+    </sect2>
+</sect1>
\ No newline at end of file
diff --git a/doc/details-impexp.docbook b/doc/details-impexp.docbook
index ae65b59be..ef93c33f8 100644
--- a/doc/details-impexp.docbook
+++ b/doc/details-impexp.docbook
@@ -1136,6 +1136,11 @@
 &details-impexp-csv;
 &details-impexp-csvexp;
 
+<!-- here goes the new Woob impexp section.  New entity is only a temporary
+     workaround, although might be good to keep it in a separate file -->
+<!-- entity defined in index.docbook -->
+&details-impexp-woob;
+
 <sect1 id="details.impexp.plugins">
 <title>Writing Importer Plugins</title>
 
diff --git a/doc/index.docbook b/doc/index.docbook
index 802841de5..088399d2b 100644
--- a/doc/index.docbook
+++ b/doc/index.docbook
@@ -41,12 +41,12 @@
   <!ENTITY Christian.David 
"<personname><firstname>Christian</firstname><surname>Dávid</surname></personname>">
   <!ENTITY Christian.David.mail "<email>[email protected]</email>">
 
-  <!-- the following author entity was added to contributor.entities for the 
5.0 release
-       it can be removed from this file once it is present in the kdelibs 
minimum version required by &kmymoney; -->
-
   <!ENTITY Michael.Carpino 
"<personname><firstname>Michael</firstname><surname>Carpino</surname></personname>">
   <!ENTITY Michael.Carpino.mail "<email>[email protected]</email>">
 
+  <!ENTITY Dawid.Wrobel 
"<personname><firstname>Dawid</firstname><surname>Wróbel</surname></personname>">
+  <!ENTITY Dawid.Wrobel.mail "<email>[email protected]</email>">
+
   <!-- the following entities have been added to user.entities in trunk and 
probably 4.7 branch of svn
        they are only in the french branch, and are required for processing of 
the french documentation
        they can be removed from this file once they are present in the kdelibs 
minimum version required by &kmymoney; -->
@@ -97,6 +97,7 @@
   <!ENTITY details-impexp SYSTEM "details-impexp.docbook">
   <!ENTITY details-impexp-csv SYSTEM "details-impexp-csv.docbook">
   <!ENTITY details-impexp-csvexp SYSTEM "details-impexp-csvexp.docbook">
+  <!ENTITY details-impexp-woob SYSTEM "details-impexp-woob.docbook">
   <!ENTITY details-reconciliation SYSTEM "details-reconciliation.docbook">
   <!ENTITY details-search SYSTEM "details-search.docbook">
   <!ENTITY details-reports SYSTEM "details-reports.docbook">
@@ -131,6 +132,7 @@ and use `&George.N.Ugnacious; &George.N.Ugnacious.mail;' in 
the author element.
 <author> &Darin.Strait;        &Darin.Strait.mail; </author>
 <author> &Roger.Lum; &Roger.Lum.mail; </author>
 <author> &Jack.H.Ostroff; &Jack.H.Ostroff.mail; </author>
+<author> &Dawid.Wrobel; &Dawid.Wrobel.mail; </author>
 <!-- TRANS:ROLES_OF_TRANSLATORS -->
 </authorgroup>
 

Reply via email to