[GNC] Reports and documentstion are blank on Linux

Fri Dec 16 22:16:37 EST 2022

David,
I have the docs for 4.11  (i just haven't yet downloaded the 4.12 documentation
release) built and installed and I'm currently running 4.12 of the program. When
I request Help or the Guide from the Help Menu in GnuCash , yelp comes up with
the following message "Document not found: The URI ‘help:gnucash-help/index’
does not point to a valid page.". 

I will download the 4.12 docs and rebuild them to see if that fixes the problem,
which it did. 
 The 4.12 installs to "/usr/local/share/help/C/gnucash-guide" and
"/usr/local/share/help/C/gnucash-help" not to the usr/local/share gnome/help "
directory and then yelp successfully finds the uris.

To build the docs I down loaded
from https://github.com/Gnucash/gnucash/releases/download/4.12/gnucash-docs-4.12.tar.gz
 and extracted the "gnucash-docs-4.12" from the tar.gz file to a directory under
my home directory then opened a terminal in that gnucash-docs-4.12 directory
then used the following commands
mkdir build
cd build
cmake -GNinja -DWITH_MOBI=On ../
ninja
sudo ninja install
After that all is working as expected

AFAIK you can now only configure the build with cmake (and not make) after V 4.7
of the docs. 
Both ninja-build and cmake have to be installed to build the docs ("sudo apt
install cmake" then "sudo apt install ninja-build" at the terminal prompton
Linux Mint)

David Cousens

On Sat, 2022-12-17 at 09:51 +1000, David H wrote:
> Yes I've just been checking out the same thing on Ubuntu 22.04 and my docs are
> all there and looking similar to the online docs - they seem to be formatted
> slightly differently, like there's no "About This Document" in my local
> version so difficult to tell what version I have - see attachments, but seem
> to be working ok. I have built Gnucash manually previously on this pc so I'm
> not sure where the docs came from :-)
> 
> I have a vague recollection I may have also had to update WebKitGtk for the
> docs to work but don't hold me to it :-)
> 
> Refer also to the Gnucash instructions for installing the Flatpak version at
> https://wiki.gnucash.org/wiki/Flatpak.
> 
> The release announcement (
> https://lists.gnucash.org/pipermail/gnucash-announce/2022-September/000371.html
> ) states that docs aren't released with linux, not sure if that includes
> Flatpak versions...
> 
> See below relevant snippets...
> 
> To compile GnuCash from the source code by yourself, you will need at least
> Gtk+ 3.24, Guile 2.0, Boost 1.54, WebKitGtk 2.4, GoogleTest 1.7.0, cmake 3.10
> and SWIG 2.0.12. Please consult the README.dependencies file in the sources
> for the exact list of dependencies and versions.
> GnuCash is also available as a flatpak from Flathub.org. Instructions for
> installing and running may be found at https://wiki.gnucash.org/wiki/Flatpak.
> If you want to compile the GnuCash Documentation 4.12 for yourself, the source
> code can be downloaded from:
> https://github.com/Gnucash/gnucash/releases/download/4.12/gnucash-docs-4.12.tar.gz
> https://downloads.sourceforge.net/gnucash/gnucash%20%28stable%29/4.12/gnucash-docs-4.12.tar.gz
> 
> The documentation is included in the MacOS and Windows application bundles.
> Hope this helps,
> 
> Regards David H.
> 
> 
> On Sat, 17 Dec 2022 at 08:41, Tommy Trussell <tommy.trussell at gmail.com> wrote:
> > Oh and I should have said, I just tried all of the items on the Help menu,
> > and they seem to work fine. GnuCash 4.12+ flatpak on Ubuntu 22.04
> > 
> > On Fri, Dec 16, 2022 at 4:38 PM Tommy Trussell <tommy.trussell at gmail.com>
> > wrote:
> > 
> > > I am running GnuCash installed via Flatpak on Ubuntu 22.04, and as far as
> > > I can tell, I did not have to install the Help files separately. I just
> > > looked and do not see a separate listing for help when I run $ flatpak
> > list
> > >
> > >
> > > On Fri, Dec 16, 2022 at 4:27 PM David Cousens <davidcousens49 at gmail.com>
> > > wrote:
> > >
> > >> Daved
> > >>
> > >> The documentation has to be downloaded and installed separately on Linux.
> > >> It is
> > >> not packaged with the program in most cases.
> > >> https://www.gnucash.org/docs.phtml.
> > >> I think running nin
> > >>
> > >> Even when installed yelp does not seem to find the location from within
> > >> the
> > >> GnuCash program. It appears to be looking for a HTML index file and not
> > >> the xml
> > >> format that yelp uses by default. In a normal install of the
> > >> documnetation it is
> > >> installed to "/usr/local/share/gnome/help/gnucash-guide" and
> > >> "/usr/local/share/gnome/help/gnucash-help". If I start yelp in a terminal
> > >> and
> > >> point it to these location the guide and help manual open in yelp, but
> > >> not when
> > >> yelp is opened from within GnuCash itself (GnuCash 4.12 on Linux Mint
> > >> 22). It is
> > >> likely that an environment variable has not been correctly setup .
> > >>
> > >> I avoid this totally by accessing the online html versions of the help
> > >> manual
> > >> and the guide from
> > >> https://lists.gnucash.org/docs/C/gnucash-help/help.html and
> > >> https://www.gnucash.org/docs/v4/C/gnucash-guide/index.html in a browser
> > >> when I
> > >> need to.
> > >>
> > >> David Cousens
> > >>
> > >> On Fri, 2022-12-16 at 21:00 +0000, Dr. David Kirkby wrote:
> > >> > I have a Dell 7920 tower workstation with 2 x 26-core CPUs and 384 GB
> > >> RAM.
> > >> > Ubuntu 20.04 and GnuCash 4.12 are installed.
> > >> >
> > >> > I used the 'flatpack' installation method,
> > >> >
> > >>
> > https://ubuntuhandbook.org/index.php/2020/07/install-gnucash-4-0-ubuntu-20-04-18-04/
> > >> > which gets the latest version, rather than the older official Ubuntu
> > >> > version.
> > >> >
> > >> > The problem is, many of the windows that I know display things on
> > >> Windows
> > >> > laptop with GnuCash, are just blank on Linux. Neither the Help ->
> > >> Tutorial
> > >> > and Concepts Guide or Help -> Contents show anything whatsoever - see
> > >> > attachment. Customer reports give a similar screen.
> > >> > _______________________________________________
> > >> > gnucash-user mailing list
> > >> > gnucash-user at gnucash.org
> > >> > To update your subscription preferences or to unsubscribe:
> > >> > https://lists.gnucash.org/mailman/listinfo/gnucash-user
> > >> > -----
> > >> > Please remember to CC this list on all your replies.
> > >> > You can do this by using Reply-To-List or Reply-All.
> > >>
> > >> _______________________________________________
> > >> gnucash-user mailing list
> > >> gnucash-user at gnucash.org
> > >> To update your subscription preferences or to unsubscribe:
> > >> https://lists.gnucash.org/mailman/listinfo/gnucash-user
> > >> -----
> > >> Please remember to CC this list on all your replies.
> > >> You can do this by using Reply-To-List or Reply-All.
> > >>
> > >
> > _______________________________________________
> > gnucash-user mailing list
> > gnucash-user at gnucash.org
> > To update your subscription preferences or to unsubscribe:
> > https://lists.gnucash.org/mailman/listinfo/gnucash-user
> > -----
> > Please remember to CC this list on all your replies.
> > You can do this by using Reply-To-List or Reply-All.