Is informaltable OK in documentation

Chris Good chris.good at ozemail.com.au
Sat Oct 31 16:26:01 EDT 2015


> -----Original Message-----
> From: John Ralls [mailto:jralls at ceridwen.us]
> Sent: Tuesday, 20 October 2015 3:02 PM
> To: Chris Good <chris.good at ozemail.com.au>
> Cc: Geert Janssens <geert.gnucash at kobaltwit.be>; gnucash-
> devel at gnucash.org; Derek Atkins <warlord at mit.edu>
> Subject: Re: Is informaltable OK in documentation
> 
> > On Oct 19, 2015, at 8:07 PM, Chris Good <chris.good at ozemail.com.au>
> wrote:
> >>
> >> On 20 Oct 2015, at 1:50 pm, John Ralls <jralls at ceridwen.us> wrote:
> >>
> >>> On Oct 19, 2015, at 5:40 PM, Chris Good <chris.good at ozemail.com.au>
> wrote:
> >>>
> >>> Thanks John, Derek & Geert.
> >>>
> >>> I tried fop 1.0 and while I was very happy with the look of the
> >>> informaltable (table without a title), the page with the informal
> >>> table and the next page, had the body printing 2 lines into the footer in
> the PDF.
> >>> I'll try the most recent fop to see if this is fixed.
> >>>
> >>> I also noticed a problem with the .mobi when viewed in most viewers
> >>> (including latest Calibre 2.41.0).
> >>>
> >>> A screen dump graphic from the body of the document is duplicated at
> >>> the start of the document.
> >>>
> >>> This also happens with the GnuCash Help mobi files that were not
> >>> generated by me. I.e. current Stable and Unstable 2.6.
> >>>
> >>> Different mobi viewers show a different graphic at the start but
> >>> each viewer is consistent in the graphic it shows for a particular mobi file.
> >>>
> >>> On Windows in Amazon's Kindle for PC 1.12.4, the graphic is
> >>> correctly not shown as first page (although it does incorrectly left
> >>> justify my informal table to the left margin).
> >>>
> >>> In one of the mobi viewers (cannot remember which one at the
> >>> moment), each graphic was showing what should have been the
> previous or next graphic.
> >>>
> >>> ISTC this has been discussed before and it is most important that
> >>> the html and pdf documentation be correct, so I won't worry about the
> mobi too much.
> >>>
> >>> I didn't find any problems with the .epub's.
> >>
> >> Chris,
> >>
> >> I think that that’s more thorough testing than the .mobi has ever had.
> Thanks for all the work! But I wonder if you might be chasing existing
> problems. Did you try downloading the 2.6.9 one from the web site for
> comparison?
> >>
> >> Regards,
> >> John Ralls
> >
> > Hi John,
> >
> > I tried the current stable 2.6 from the website and it had the same
> problem.
> 
> Chris,
> 
> I thought it might. Like I said, you’ve done more testing than anyone else, so
> you found problems that have nothing to do with your setup.
> 
> That means that if the informaltable is good enough, it’s good enough. Go
> ahead and make a PR.
> 
> If you want to try and figure out how to get the mobi docs to look better,
> that’d be great. OTOH, we’ve had them up for a few years now and nobody’s
> complained, so maybe there are more important things to worry about.
> 
> Regards,
> John Ralls

FYI

I tried latest fop 2.0 from https://xmlgraphics.apache.org/fop/ on my Ubuntu 12.04 
to see if it fixes problem where body goes into footer on pdf page with informaltable.
It still did.
It also failed to build the mobi and epub Help documentation.
I went thru the many thousands of lines in the log but I couldn't see the problem.
I've gone back to Ubuntu standard fop 1.0.dfsg2-6.

Regards,
Chris Good
-------------- next part --------------
A non-text attachment was scrubbed...
Name: smime.p7s
Type: application/pkcs7-signature
Size: 4821 bytes
Desc: not available
URL: <http://lists.gnucash.org/pipermail/gnucash-devel/attachments/20151101/14b79947/attachment.p7s>


More information about the gnucash-devel mailing list