Please remember to copy the list on all replies. On Apple Mail the easiest way 
is to use the doubled-arrow reply button.

It's certainly true that developers have a different way of looking at software 
than do users without programming experience. The wiki page and much of the 
manual were written by developers for the simple reason that technical writers 
tend not to engage in Free software projects, perhaps because they have to deal 
more directly with developers than they like, there being no management to 
insulate them. For Gnome-based projects like GnuCash that's compounded by the 
requirement to use an arcane markup language in order to support the Gnome help 
viewer. There have been numerous proposals to change it over the years but none 
have gained any traction.

Yes, it would be useful to have a section in Chapter 10 about Gtk 
customization, along with a lot of other updating to the documentation. Sadly 
another characteristic of developers is that we'd generally prefer to spend our 
time writing code than documentation so there are lots of holes in the 
documentation and lots of obsolete stuff as well.

Regards,
John Ralls


> On Aug 18, 2020, at 4:13 AM, Peter West <li...@pbw.id.au> wrote:
> 
> Yes, if you read it carefully enough. Looking quickly through it, I focussed 
> on GTK and ignored GNC.
> 
> This developer documentation. Users want so know how to make changes to GC’s 
> appearance. Google searching, either generally, or specifically on the 
> gnucash-users list using the site: specifier, turns up this page. Developers 
> have endemic difficulty in seeing things from a user’s perspective. I can 
> vouch for that.
> 
> In the time I have been using Gnucash (18 months maybe) the question of 
> changing the UI has cropped up a number of times. The manual has a chapter, 
> Chapter 10. Customizing GnuCash, with a section 10.4 on style sheets used for 
> reports. There is nothing about the GTK customisation options. I have only 
> experimented with Gtk in the past few days, but I had noticed that there were 
> some quite detailed suggestions for what .css customisations were available.
> 
> It would be useful to have a section in Chapter 10 about Gtk customisations.
> 
> Peter
> 
>> On 18 Aug 2020, at 11:19 am, John Ralls <jra...@ceridwen.us> wrote:
>> 
>> If you read the wiki carefully you'll realize that configuration files are 
>> looked for in USER_CONFIG_HOME, not USER_DATA_HOME. On Linux and macOS Gtk 
>> (and most other modern Linux desktop programs) use the XDG spec 
>> (https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html)
>>  and the default for XDG_CONFIG_HOME is $HOME/.config. 
>> 
>> For macOS Gnucash.app/Contents/Resources/etc/gnucash/environment set 
>> XDG_CONFIG_HOME to $HOME/Library/Application Support/Gnucash/config, so you 
>> can put a gtk.css or setup.ini there. 
>> 
>> Gtk looks through a set of hardwired locations as well as XDG_CONFIG_HOME, 
>> most of which are for backward compatibility: ~/.gtk-3.0.css, 
>> ~/.gtk-3.0/gtk.css, and ~/.config/gtk-3.0/gtk.css, ~/.gtk-3.0/setting.ini, 
>> ~/.config/gtk-3.0/settings.ini.
>> 
>> Regards,
>> John Ralls
>> 
>> 
>>> On Aug 17, 2020, at 11:56 AM, Adrien Monteleone 
>>> <adrien.montele...@lusfiber.net> wrote:
>>> 
>>> Peter,
>>> 
>>> If you read the Wiki carefully, you'll see that the 
>>> `~/.local/share/gtk-3.0` location is for all GTK apps, not just GnuCash. 
>>> The GTK theme may conflict and your customization may not override the 
>>> theme in some cases. (note, the Wiki also notes that `gtk-3.0.css` will 
>>> override `gtk.css`)
>>> 
>>> The proper location to customize the GnuCash UI via CSS is:
>>> ~/Library/Application Support/GnuCash
>>> 
>>> Regards,
>>> Adrien
>>> 
>>> On 8/16/20 1:47 AM, Peter West wrote:
>>>>> On 16 Aug 2020, at 1:29 pm, Adrien Monteleone 
>>>>> <adrien.montele...@lusfiber.net> wrote:
>>>> …
>>>>> The file should be named:
>>>>> 
>>>>> gtk-3.0.css
>>>> That’s why I couldn’t get mine to work in either location. I was using 
>>>> gtk.css.
>>>> I can say that the location ~/.local/share/gtk-3.0/gtk-3.0.css does NOT 
>>>> work, in spite of the wiki.
>>>>> 
>>>>> The location should be:
>>>>> 
>>>>> ~/Library/Application Support/GnuCash
>>> 
>>> _______________________________________________
>>> gnucash-user mailing list
>>> gnucash-user@gnucash.org
>>> To update your subscription preferences or to unsubscribe:
>>> https://lists.gnucash.org/mailman/listinfo/gnucash-user
>>> If you are using Nabble or Gmane, please see 
>>> https://wiki.gnucash.org/wiki/Mailing_Lists for more information.
>>> -----
>>> 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@gnucash.org
>> To update your subscription preferences or to unsubscribe:
>> https://lists.gnucash.org/mailman/listinfo/gnucash-user
>> If you are using Nabble or Gmane, please see 
>> https://wiki.gnucash.org/wiki/Mailing_Lists for more information.
>> -----
>> 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@gnucash.org
To update your subscription preferences or to unsubscribe:
https://lists.gnucash.org/mailman/listinfo/gnucash-user
If you are using Nabble or Gmane, please see 
https://wiki.gnucash.org/wiki/Mailing_Lists for more information.
-----
Please remember to CC this list on all your replies.
You can do this by using Reply-To-List or Reply-All.

Reply via email to