Re: [GNC-dev] Porting the Tutorial & Concepts Guide to ReadTheDocs.org

I think the functionality of Locale Filter could be done using the Sphinx ‘ifconfig’ extension[1]. It allows content selection based on a Python expression involving variables set in the Sphinx conf.py file. [1] https://www.sphinx-doc.org/en/master/usage/extensions/ifconfig.html

Re: [GNC-dev] Porting the Tutorial & Concepts Guide to ReadTheDocs.org

A couple of references to what Geert is talking about: The W3C specification for Internationaliation Tag Set Locale Filters: https://www.w3.org/TR/its20/#LocaleFilter Geert had in mind to use ITS Tool for processing Locale Filter tags; the relevant documentation is at

Re: [GNC-dev] Porting the Tutorial & Concepts Guide to ReadTheDocs.org

Hi Rob, I have gathered from irc conversations the you have picked up on your interest of converting our documentation to reStructuredText. As I'm unfortunately not able to spend much time on irc while you are there, I will add some comments on this mailing list thread. From the little

Re: [GNC-dev] Porting the Tutorial & Concepts Guide to ReadTheDocs.org

Hi, I have started to create https://wiki.gnucash.org/wiki/Documentation_Requirements because I think, the bug report together with mails on several lists are becoming muddled. In a first step we should collect required and desired criterias. In a secound step we should see which source

Re: [GNC-dev] Porting the Tutorial & Concepts Guide to ReadTheDocs.org

Seems a text-based markup language might be good for document presentation but, even with a CI system, the biggest issue as a document development platform is the lack of compatibility with context-sensitive help within the program [Ref](

Re: [GNC-dev] Porting the Tutorial & Concepts Guide to ReadTheDocs.org

https://github.com/codesmythe/gnucash-docs-rst/blob/master/source/Host%20this%20Locally.md explains local hosting in Windows. I suppose it is similar in Linux with serve.bat becoming serve.sh - the run command is a single line if the libraries are loaded. The local stylesheet is the same now.

Re: [GNC-dev] Porting the Tutorial & Concepts Guide to ReadTheDocs.org

> On Apr 25, 2020, at 2:24 AM, Geert Janssens > wrote: > > Hi Rob, > > Thanks for running this experiment. > > The stylesheet used by ReadTheDocs is much more modern than ours and indeed > looks much nicer for online consumption. Even the pdf is cleaner. > > On the other hand I also

Re: [GNC-dev] Porting the Tutorial & Concepts Guide to ReadTheDocs.org

Rob that's a nice result. Remarkable given you've nearly converted the lot with scripts. A heads up would have been nice given I put a MkDocs version I put up two days ago at "We should change the Documentation file format" - https://bugs.gnucash.org/show_bug.cgi?id=722016#c13 There's not much

Re: [GNC-dev] Porting the Tutorial & Concepts Guide to ReadTheDocs.org

Thanks for the info and clarification. Regards, Adrien > On Apr 25, 2020 w17d116, at 2:27 AM, Geert Janssens > wrote: > > Op zaterdag 25 april 2020 09:17:58 CEST schreef Geert Janssens: >> Op zaterdag 25 april 2020 01:09:56 CEST schreef Adrien Monteleone: >>> I’ve used some documentation from

Re: [GNC-dev] Porting the Tutorial & Concepts Guide to ReadTheDocs.org

Op zaterdag 25 april 2020 09:17:58 CEST schreef Geert Janssens: > Op zaterdag 25 april 2020 01:09:56 CEST schreef Adrien Monteleone: > > I’ve used some documentation from that source for several projects (as a > > user, not a documenter) and I have to say it is much more pleasant to read > > and

Re: [GNC-dev] Porting the Tutorial & Concepts Guide to ReadTheDocs.org

Hi Rob, Thanks for running this experiment. The stylesheet used by ReadTheDocs is much more modern than ours and indeed looks much nicer for online consumption. Even the pdf is cleaner. On the other hand I also have a few concerns/questions: 1. How would a translation flow look like with

Re: [GNC-dev] Porting the Tutorial & Concepts Guide to ReadTheDocs.org

Op zaterdag 25 april 2020 01:09:56 CEST schreef Adrien Monteleone: > I’ve used some documentation from that source for several projects (as a > user, not a documenter) and I have to say it is much more pleasant to read > and navigate than the current GnuCash setup. > > There was some discussion

Re: [GNC-dev] Porting the Tutorial & Concepts Guide to ReadTheDocs.org

I’ve used some documentation from that source for several projects (as a user, not a documenter) and I have to say it is much more pleasant to read and navigate than the current GnuCash setup. There was some discussion some time ago (I think there is a bug filed) for making documentation more

Re: [GNC-dev] Porting the Tutorial & Concepts Guide to ReadTheDocs.org

holy crap, this looks really good visually! On 4/24/20 3:13 PM, Rob Gowin wrote: Got the itch to play around with GnuCash’s documentation tooling, file format, etc. I’m an AsciiDoc fan, but like the docs I read on ReadTheDocs.org , which uses reStructuredText. So,