Re: [Gimp-docs] Would like to work on the color management documentation
On 01/27/2014 10:11 AM, Andrew Douglas Pitonyak wrote: I expect that learning to use git and how to build is more of an obstacle than learning enough about docbook since the framework is already in place. It is a bit more difficult if you add or modify a figure, but, if all you do is add / change text, you will probably find it straight forward. Andrew, thanks! for words of encouragement. Somewhere a document says that the Gimp XML lines should be no more than 87(?) characters long. The README says Use any editor you want, but you should handle it well. Please keep in mind, that the tab width in XML Mode should be 2 spaces. So any recommendations on an xml editor? Preferably one that can be set to automatically use the right line length and tab width? And preferably can validate? From my personal point of view, eclipse (too big), vim (never learned), and jedit (I don't like java-based programs) are not options. Currently I use bluefish for html and geany for writing code. A quick search for xml editors that run on Linux turns up too much to choose from, although xmlcopyeditor looks promising. Also, I can write html as easily as writing plain text. Is there a utility that converts from html to xml? It seems like it might be easier for me to modify gimp-imaging-color-management.html and gimp-pimping.html#gimp-prefs-color-management to make sure everything looks and reads like I want it to, and then convert the html to xml, if that's possible, and then clean up the resulting xml, if necessary. Elle ___ gimp-docs-list mailing list gimp-docs-list@gnome.org https://mail.gnome.org/mailman/listinfo/gimp-docs-list
[Gimp-docs] Would like to work on the color management documentation
Hi All, I'd like to work on the Gimp color management documentation to add a short explanation of the new monitor and softproofing black point compensation options in the Preferences/Color Management dialog. I'd also like to make a few changes to some of the other color management documentation, in particular the explanation of the profile conversion intents (perceptual, relative and absolute colorimetric, saturation). I downloaded and built the from-git documentation. I've read through the various READMEs and such. One of the READMEs says: You should know a bit about Docbook and XML, or be smart enough to learn the syntax yourself. You can get more information about Docbook and XML by using your preferred search engine. I don't know anything at all about Docbook and I try very hard not to think about XML except as it applies to image sidecar files. There's a whole lot about both topics on the internet. How do I learn the very minimum needed to work on Gimp color management documentation? Is there a worked example somewhere? Is there a step-by-step here's how guide for people who really, really, really don't want to become docbook/xml experts? Best regards, Elle -- http://ninedegreesbelow.com Articles on color management and open source photography ___ gimp-docs-list mailing list gimp-docs-list@gnome.org https://mail.gnome.org/mailman/listinfo/gimp-docs-list
Re: [Gimp-docs] Would like to work on the color management documentation
On 01/27/2014 10:07 AM, Elle Stone wrote: On 01/27/2014 09:46 AM, Elle Stone wrote: There's a whole lot about both topics on the internet. How do I learn the very minimum needed to work on Gimp color management documentation? Is there a worked example somewhere? Is there a step-by-step here's how guide for people who really, really, really don't want to become docbook/xml experts? Hmm, I found the color-management.xml file - that's a start! I expect that learning to use git and how to build is more of an obstacle than learning enough about docbook since the framework is already in place. It is a bit more difficult if you add or modify a figure, but, if all you do is add / change text, you will probably find it straight forward. :-) If you have too much difficulty, volunteers here will probably be happy to review and make final changes to your content to accomplish what is needed. -- Andrew Pitonyak My Macro Document: http://www.pitonyak.org/AndrewMacro.odt Info: http://www.pitonyak.org/oo.php ___ gimp-docs-list mailing list gimp-docs-list@gnome.org https://mail.gnome.org/mailman/listinfo/gimp-docs-list
Re: [Gimp-docs] Would like to work on the color management documentation
On Mon, Jan 27, 2014 at 11:02:39AM -0500, Elle Stone wrote: On 01/27/2014 10:11 AM, Andrew Douglas Pitonyak wrote: I expect that learning to use git and how to build is more of an obstacle than learning enough about docbook since the framework is already in place. It is a bit more difficult if you add or modify a figure, but, if all you do is add / change text, you will probably find it straight forward. Andrew, thanks! for words of encouragement. Somewhere a document says that the Gimp XML lines should be no more than 87(?) characters long. The README says Use any editor you want, but you should handle it well. Please keep in mind, that the tab width in XML Mode should be 2 spaces. So any recommendations on an xml editor? Preferably one that can be set to automatically use the right line length and tab width? And preferably can validate? From my personal point of view, eclipse (too big), vim (never learned), and jedit (I don't like java-based programs) are not options. I use Emacs... -- Marco Ciampa L'utopia sta all'orizzonte. Mi avvicino di due passi, lei si allontana di due passi. Faccio dieci passi e l'orizzonte si allontana di dieci passi. Per quanto cammini, non la raggiungerò mai. A cosa serve l'utopia? A questo: serve a camminare. Eduardo Galeano ++ | 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] Would like to work on the color management documentation
On 01/27/2014 11:02 AM, Elle Stone wrote: On 01/27/2014 10:11 AM, Andrew Douglas Pitonyak wrote: I expect that learning to use git and how to build is more of an obstacle than learning enough about docbook since the framework is already in place. It is a bit more difficult if you add or modify a figure, but, if all you do is add / change text, you will probably find it straight forward. Andrew, thanks! for words of encouragement. Somewhere a document says that the Gimp XML lines should be no more than 87(?) characters long. The README says Use any editor you want, but you should handle it well. Please keep in mind, that the tab width in XML Mode should be 2 spaces. So any recommendations on an xml editor? Preferably one that can be set to automatically use the right line length and tab width? And preferably can validate? I use Linux, what is your operating system? I installed Kate. I do not remember what I tried before settling on Kate. http://l10n.kde.org/docs/doc-primer/kate.html This editor is available for multiple operating systems: http://xml-copy-editor.sourceforge.net/ I know that I was using it for a while. From my personal point of view, eclipse (too big), vim (never learned), and jedit (I don't like java-based programs) are not options. Currently I use bluefish for html and geany for writing code. A quick search for xml editors that run on Linux turns up too much to choose from, although xmlcopyeditor looks promising. Oh, if only I had read a little bit further :-) I would say that you give one a try and if you really like it, keep using it, otherwise, try another. I do not remember if you can set margins or not. I have been concentrating on my OpenOffice documentation lately, which I create in OpenOffice. Also, I can write html as easily as writing plain text. Is there a utility that converts from html to xml? It seems like it might be easier for me to modify gimp-imaging-color-management.html and gimp-pimping.html#gimp-prefs-color-management to make sure everything looks and reads like I want it to, and then convert the html to xml, if that's possible, and then clean up the resulting xml, if necessary. Elle ___ gimp-docs-list mailing list gimp-docs-list@gnome.org https://mail.gnome.org/mailman/listinfo/gimp-docs-list -- Andrew Pitonyak My Macro Document: http://www.pitonyak.org/AndrewMacro.odt Info: http://www.pitonyak.org/oo.php ___ gimp-docs-list mailing list gimp-docs-list@gnome.org https://mail.gnome.org/mailman/listinfo/gimp-docs-list
