Re: [Gimp-docs] Preferences documentation
On 04/04/2017 04:15 PM, Elle Stone wrote: On 04/04/2017 03:05 PM, Elle Stone wrote: * remove the include statements from preferences_introduction.xml Well, that's not right. I was thinking about php include for adding html from one file to another html file. Sigh. I opened a bug report and attached a patch that moves all of Preferences to the Edit menu: https://bugzilla.gnome.org/show_bug.cgi?id=780927 I didn't want to push these changes without having someone review them first. Best, Elle ___ gimp-docs-list mailing list gimp-docs-list@gnome.org https://mail.gnome.org/mailman/listinfo/gimp-docs-list
Re: [Gimp-docs] Preferences documentation
On 04/04/2017 02:26 PM, Julien Hardelin wrote: Good idea, I agree. Regards, Julien Hmm, from looking in a browser at: https://docs.gimp.org/2.9/en/gimp-pimping.html#gimp-prefs-dialog I assumed that all the preferences options were in one single xml file. But in reality "src/preferences" is full of individual prefs-*.xml files. "src/menu/edit/preferences.xml" starts with this line: http://www.w3.org/2001/XInclude; id="gimp-prefs-dialog"> and has a bunch of "include" statements at the bottom. This is probably how all the Preferences submenu end up on one page in the resulting html file. So it looks like what is needed is to: * move the Preferences folder to under menu/edit * move src/using/preferences/preferences_introduction.xml to src/menus/edit/preferences_introduction.xml * remove the include statements from preferences_introduction.xml * anything else? I'll try the above changes on my local install of gimp-help-2 and see what happens. Best, Elle Le 04/04/2017 à 16:38, Elle Stone a écrit : Hi All, Most of the documentation devoted to "Enrich my GIMP" is actually documentation for Preferences. The Preferences page is huge, too large for users to easily navigate. What do you all think about reorganizing as follows? * Make Preferences a stand-alone section with the base URL https://docs.gimp.org/2.9/en/gimp-preferences. Or probably better, put Preferences under the Edit menu, to correspond to where Preferences is located on the Menu bar. * Break the Preferences documentation into smaller chunks corresponding to the Preferences subsections (System Resources, Color Management, etc). Best, Elle ___ gimp-docs-list mailing list gimp-docs-list@gnome.org https://mail.gnome.org/mailman/listinfo/gimp-docs-list
Re: [Gimp-docs] Preferences documentation
On 04/04/2017 03:05 PM, Elle Stone wrote: * remove the include statements from preferences_introduction.xml Well, that's not right. I was thinking about php include for adding html from one file to another html file. Sigh. Best, Elle ___ gimp-docs-list mailing list gimp-docs-list@gnome.org https://mail.gnome.org/mailman/listinfo/gimp-docs-list
Re: [Gimp-docs] Preferences documentation
Good idea, I agree. Regards, Julien Le 04/04/2017 à 16:38, Elle Stone a écrit : Hi All, Most of the documentation devoted to "Enrich my GIMP" is actually documentation for Preferences. The Preferences page is huge, too large for users to easily navigate. What do you all think about reorganizing as follows? * Make Preferences a stand-alone section with the base URL https://docs.gimp.org/2.9/en/gimp-preferences. Or probably better, put Preferences under the Edit menu, to correspond to where Preferences is located on the Menu bar. * Break the Preferences documentation into smaller chunks corresponding to the Preferences subsections (System Resources, Color Management, etc). Best, Elle ___ gimp-docs-list mailing list gimp-docs-list@gnome.org https://mail.gnome.org/mailman/listinfo/gimp-docs-list ___ gimp-docs-list mailing list gimp-docs-list@gnome.org https://mail.gnome.org/mailman/listinfo/gimp-docs-list
Re: [Gimp-docs] Preferences documentation
Hello Elle! On Tue, Apr 04, 2017 at 10:57:21AM -0400, Elle Stone wrote: > On 04/04/2017 10:38 AM, Elle Stone wrote: > >Hi All, > > > >Most of the documentation devoted to "Enrich my GIMP" is actually > >documentation for Preferences. > > > >The Preferences page is huge, too large for users to easily navigate. > > > >What do you all think about reorganizing as follows? > > IMHO... > >* Make Preferences a stand-alone section with the base URL > >https://docs.gimp.org/2.9/en/gimp-preferences. > > > >Or probably better, put Preferences under the Edit menu, > >to correspond to where Preferences is located on the Menu bar. like it > >* Break the Preferences documentation into smaller chunks corresponding > >to the Preferences subsections (System Resources, Color Management, etc). like this too > I forgot to say, I can make these changes if the consensus is that it's a > good thing to do. I think it is a good thing to do, thanks! Regards, -- Marco Ciampa I know a joke about UDP, but you might not get it. GNU/Linux User #78271 FSFE fellow #364 ___ gimp-docs-list mailing list gimp-docs-list@gnome.org https://mail.gnome.org/mailman/listinfo/gimp-docs-list
Re: [Gimp-docs] Preferences documentation
On 04/04/2017 10:38 AM, Elle Stone wrote: Hi All, Most of the documentation devoted to "Enrich my GIMP" is actually documentation for Preferences. The Preferences page is huge, too large for users to easily navigate. What do you all think about reorganizing as follows? * Make Preferences a stand-alone section with the base URL https://docs.gimp.org/2.9/en/gimp-preferences. Or probably better, put Preferences under the Edit menu, to correspond to where Preferences is located on the Menu bar. * Break the Preferences documentation into smaller chunks corresponding to the Preferences subsections (System Resources, Color Management, etc). I forgot to say, I can make these changes if the consensus is that it's a good thing to do. Best, Elle ___ gimp-docs-list mailing list gimp-docs-list@gnome.org https://mail.gnome.org/mailman/listinfo/gimp-docs-list