[GNC-dev] Long Term Documentation Directions

David Cousens davidcousens at bigpond.com
Mon Sep 10 19:05:58 EDT 2018


It maybe worth pursuing if libwebkit can support context sensitive help. It HTML Help on Windows I believe a set of
aliases mapped onto URLs for the appropriate section of HTML help files from the help file is generated by the processor
and then used to pull up the appropriate section of help. It would require the current chapter files to be broken down
into snippets in individual files which can be accessed separately or linked together to constitute the 
manual. Docbook has the mechanism for creating links. The downside is perhaps that you would have to recreate a help
viewer using it inside the gnucash code -  a lot more coding than simply passing a URI to the external viewer. 

I am surprised that yelp doesn't support context sensitive help. In a quick search yesterday I couldn't find any
reference to it or how to access it. I'll have a look at the yelp repo to see if it's documented there.

David Cousens

On Mon, 2018-09-10 at 19:51 +0800, Christopher Lam wrote:
> On Mon, 10 Sep 2018 at 19:31, David Cousens <davidcousens at bigpond.com>
> wrote:
> > 
> > One problem I see for Unix is that at present there doesn't appear to be a
> > help viewer in Unix that has support for context level help. Doc books can
> > obviously support defining links that can be accessed from help buttons or
> > a
> > key based popup help but as far as I could see yelp has no mechanism for
> > linking to them.
> > 
> Is there any merit to the idea of launching documentation and
> context-sensitive help as a libwebkit tab?
> _______________________________________________
> gnucash-devel mailing list
> gnucash-devel at gnucash.org
> https://lists.gnucash.org/mailman/listinfo/gnucash-devel

More information about the gnucash-devel mailing list