Re: [Gimp-docs] Color Temperature
On 07/07/2018 02:45 PM, Elle Stone wrote: I don't think "What color temperature was the original image" is a well-defined question. If the image was color-balanced by making a neutral object in the image read as neutral, at least in ICC profile software the color temperature of the image is now D50, as the original color cast from whatever light was actually used, has been color-balanced away. But maybe the user actually color-balanced to retain the impression of the color of light in the scene, for example capturing the colors of the sunset instead of white-balancing them away, or to impart a creative look via color-balancing. Also there's the question of what color balance was set in the camera, if the user was shooting jpegs. If the camera was on auto white balance, who knows how accurately the image was color-balanced. If on some other setting, who know how accurately that setting reflected the actual light source. And if the user was shooting raw, each raw processor has different temp/tint numbers for different presets such as Daylight, Incandescent, and so forth, and if using "in camera" white balance, the same questions as apply to jpegs, also applies to raw files. Also GIMP doesn't provide "tint" settings, so there's only so much GIMP's "Color Temperature" sliders can do. Plus AFAIK GIMP's color temperature code is table-based, and personally I don't have a clue how table was derived or how accurate it is over what range, or whether/how well it applies to color spaces other than sRGB. Nonetheless GIMP's Color Temperature results are often pleasing and believable, even though it's a big guessing game as to what "should" be the input temp for any given image. Best, Elle -- https://ninedegreesbelow.com Color management and free/libre photography ___ gimp-docs-list mailing list gimp-docs-list@gnome.org https://mail.gnome.org/mailman/listinfo/gimp-docs-list
Re: [Gimp-docs] Color Temperature
On 07/07/2018 02:25 PM, Julien Hardelin wrote: Hi all, I don't understand why we can change the original temperature in colors/Color Temperature. If this is the color temperature of the light source the image was taken with, it should be a fixed value that can't be changed. Hi Julien, I don't think "What color temperature was the original image" is a well-defined question. If the image was color-balanced by making a neutral object in the image read as neutral, at least in ICC profile software the color temperature of the image is now D50, as the original color cast from whatever light was actually used, has been color-balanced away. But maybe the user actually color-balanced to retain the impression of the color of light in the scene, for example capturing the colors of the sunset instead of white-balancing them away, or to impart a creative look via color-balancing. Anyway, as long as the user dials in the same starting temperature for the Original and Intended temperature, the result is "no change". But for any given amount of change, the resulting color depends on the starting color. For example, let's say the user wants to lower the temp by 2000. Starting from 6500 and lowering to 5500 produces a different result than starting from 5000 and lowering to 3000. Which results are "the right" results is basically an aesthetic judgement call. If the user has something more precise in mind (like actually replicating a color change based on changing "colors of the light"), they'd be better off using RawTherapee's totally awesome CIECAM02 model. Best, Elle Julien ___ gimp-docs-list mailing list gimp-docs-list@gnome.org https://mail.gnome.org/mailman/listinfo/gimp-docs-list -- https://ninedegreesbelow.com Color management and free/libre photography ___ gimp-docs-list mailing list gimp-docs-list@gnome.org https://mail.gnome.org/mailman/listinfo/gimp-docs-list
Re: [Gimp-docs] Feedback on first pushed commits
On 04/28/2017 04:35 AM, Marco Ciampa via gimp-docs-list wrote: Is this right? src/menus/colors/desaturate/desaturate.xml:108(phrase) The shades of gray will be calculated as Lightness (HSL)) = (max(R,G,B) + min(R,G,B)) If you mean the formula for Lightness, it's correct: From 2.8 docs: Lightness The graylevel will be calculated as Lightness = ½ × (max(R,G,B) + min(R,G,B)) From posted 2.9 docs: Lightness (HSL) The shades of gray will be calculated as Lightness (HSL)) = ½ × (max(R,G,B) + min(R,G,B)) From Wikipedia (https://en.wikipedia.org): In the HSL "bi-hexcone" model, lightness is defined as the average of the largest and smallest color components (fig. 12c). From GIMP code (app/operations/gimpoperationdesaturate.c): case GIMP_DESATURATE_LIGHTNESS: /* This is the formula for Lightness in the HSL "bi-hexcone" * model: https://en.wikipedia.org/wiki/HSL_and_HSV */ while (samples--) { gfloat min, max, value; max = MAX (src[0], src[1]); max = MAX (max, src[2]); min = MIN (src[0], src[1]); min = MIN (min, src[2]); value = (max + min) / 2; Not to be confused with LAB/LCH Lightness, which is calculated from XYZ, not from RGB (http://brucelindbloom.com/index.html?Eqn_XYZ_to_Lab.html). Best, Elle ___ gimp-docs-list mailing list gimp-docs-list@gnome.org https://mail.gnome.org/mailman/listinfo/gimp-docs-list
Re: [Gimp-docs] Feedback on first pushed commits
On 04/05/2017 08:54 AM, Elle Stone wrote: Actually I'd suggest holding off on translating any of the color management menu pages as there are two more pages to write for the color management menu. These pages all go together, so likely I'll make minor changes to the "already done" pages while writing the "not yet done" pages. I made some changes to the XML, and many thanks to Julien for the feedback - I think I have the indentation figured out now. I simplified the Enable Color Management page and finished the last two items for the color management menu. So the Image/Color Management menu pages are ready for translating if anyone is so inclined. 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 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
[Gimp-docs] Preferences documentation
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 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
Re: [Gimp-docs] RGB-clip
Hi All, Just fyi, RGB-clip in the Colors menu requires refering to the Image/Precision menu, which isn't already in the documentation. Also "precision" needs a glossary entry. So I'm working on all the following files at once: Existing files: * src/glossary.xml to change the entries that use integer values to instead use floating point values, and to add an entry for precision and other stuff as seems appropriate. * src/menus/colors.xml to add RGB clip * src/colors/mode.xml to move color management out of this item * src/menus/image.xml to add/rearrange entries for precision, color management, and while I'm at it, metadata which is also missing New files under Image menu: * color-management.xml and sub-menus * metadata.xml for which I might only create a stub, at least for now * precision.xml New file under Color menu: * rgb-clip.xml In case you all are getting worried, I don't anticipate having any questions :) . Best, L ___ gimp-docs-list mailing list gimp-docs-list@gnome.org https://mail.gnome.org/mailman/listinfo/gimp-docs-list
[Gimp-docs] RGB-clip
I'd like to (and have already started) working on writing documentation for RGB-clip. According to Bug 778101 Missing docs: new RGB Clip filter https://bugzilla.gnome.org/show_bug.cgi?id=778101 this missing documentation bug is assigned to Róman Joost. Would Róman Joost prefer to add the documentation for RGB clip? In which case I should stop working on this bit of documentation and find something that isn't already assigned to someone else. I see that Joost has been assigned a lot of the documentation for GIMP color-management-related items. So I'll probably be asking this question again. Best, Elle ___ gimp-docs-list mailing list gimp-docs-list@gnome.org https://mail.gnome.org/mailman/listinfo/gimp-docs-list
Re: [Gimp-docs] Colors/Desaturate/Desaturate documentation
On 03/27/2017 11:28 AM, Elle Stone wrote: I will send you the "git status" terminal output and the xml file in a private email. Hi Julien, I did send you an email with the git status terminal output and the xml file. But there is a good chance you'll never get the email (there are problems with my email server). So I also uploaded a patch to https://bugzilla.gnome.org/show_bug.cgi?id=767763. I can upload desaturate.xml if you like. The "git status" terminal output can be downloaded from here: http://ninedegreesbelow.com/files/desaturate/git-status.txt Best, Elle ___ gimp-docs-list mailing list gimp-docs-list@gnome.org https://mail.gnome.org/mailman/listinfo/gimp-docs-list
Re: [Gimp-docs] Colors/Desaturate/Desaturate documentation
On 03/27/2017 12:16 PM, Elle Stone wrote: The "git status" terminal output can be downloaded from here: http://ninedegreesbelow.com/files/desaturate/git-status.txt Never mind the git-status.txt. Starting with a fresh clone, the problem with the po files doesn't happen. Elle ___ gimp-docs-list mailing list gimp-docs-list@gnome.org https://mail.gnome.org/mailman/listinfo/gimp-docs-list
Re: [Gimp-docs] Colors/Desaturate/Desaturate documentation
On 03/27/2017 01:58 AM, Julien Hardelin wrote: The Advanced options, along with Split View, Presets, and Preview, are common to *all* Color and Filter operations. I don't think it's appropriate to add an explanation about the Advanced options to each and every Color and Filter page in gimp help. To speak as plainly and clearly as possible, I will not add documentation regarding the Advanced options to the patch I'm working on for the desaturate menu. You don't need to write information here: only a link: Advanced options: Please see ..(link to a common-color-features.xml file to be created). There are not, as far as I can tell, such links in the current documentation to features that are in common to all the dialogs. I've been using the current documentation as a model. IMHO, there is no point in putting in a link to a file (help on Advanced options) that doesn't yet exist. There is no point in writing documentation for the Advanced options because this code is still in a state of flux. It's not even clear if this dialog will remain in the individual dialogs without specific user choice made in Preferences: https://bugzilla.gnome.org/show_bug.cgi?id=779620#c1 If someone else wants to write documentation for the Advanced options, of course I can't stop them. But I will not write documentation for the Advanced options, at least not until the code settles, and maybe not even then. In your file, we don't see that Luminance, Luma... belong to Mode. I don't understand what you mean. Do you want a screenshot of the expanded desaturate drop down menu? Will this suffice to show that "Luminance, Luma . . . belong to Mode"? Or do you mean something else altogether? Mode: Five options are available: OK, thanks! I don't think the original code (which I used as a pattern to follow) used , but if I overlooked this, my apologies. So you want me to change this: Five options are available: to this Mode: Five options are available I don't understand what you mean. Do you want me to remove something that appears in the following file, and perhaps move it to a tutorial? http://ninedegreesbelow.com/files/desaturate/8-18-desaturate.html If you do want me to remove something from what appears in the above link, please be very, very specific, as I'm having a difficult time grasping what you are trying to say. My apologies, my communications skills seem to be at an all-time low. I told you that, IMHO, your text can be accepted as it is. I am discussing about formatting the text. Time grasping is he same for me with all this discussion. If you don't understand again, please send me your xml file: I will return it with my propositions on formatting. If my text can be accepted as it is, then I don't know what your feedback about "tutorials" vs "documentation" was about. So my apologies. I think I'll just make a commit and deal with any remaining issues later. Best, Elle ___ gimp-docs-list mailing list gimp-docs-list@gnome.org https://mail.gnome.org/mailman/listinfo/gimp-docs-list
Re: [Gimp-docs] Colors/Desaturate/Desaturate documentation
On 03/26/2017 03:35 PM, Elle Stone wrote: Unless there are objections (and/or advice), I'm going to try to make and upload a patch. Assuming that eventually I'll succeed in putting the modified desaturate.xml file into a shape that is acceptable for gimp-help, at that point I'll need to make a patch. Here is a summary of the affected files, along with three questions: Here are the files that I explicitly modified: images/C/menus/colors/desaturate/desaturate.png src/menus/colors/desaturate/desaturate.xml I added new image files to images/C/menus/colors/desaturate, as follows: colors-desaturate-average-red-globe.png colors-desaturate-average-sunflower.png colors-desaturate-lightness-red-globe.png colors-desaturate-lightness-sunflower.png colors-desaturate-luma-red-globe.png colors-desaturate-luma-sunflower.png colors-desaturate-luminance-red-globe.png colors-desaturate-luminance-sunflower.png colors-desaturate-original-red-globe.png colors-desaturate-original-sunflower.png colors-desaturate-value-red-globe.png colors-desaturate-value-sunflower.png Question 1: There is a long list of "po/..." files that are modified by building gimp-help after modifying/adding the above xml/png files. Should these modified "po/..." files be added to the git commit? Question 2: These image files are no longer used in the desaturate help, so perhaps these files should be rm'ed from git before I make a patch? images/C/toolbox/colors-desaturate-brightness.png images/C/toolbox/colors-desaturate-luminosity.png images/C/toolbox/colors-desaturate-average.png images/C/toolbox/colors-desaturate-orig.png Question 3: Is there anything different about the process of making a patch for gimp-help, compared to making a patch for gimp code? Anything to watch out for, or special commands, or anything along these lines? Best, Elle ___ gimp-docs-list mailing list gimp-docs-list@gnome.org https://mail.gnome.org/mailman/listinfo/gimp-docs-list
Re: [Gimp-docs] Colors/Desaturate/Desaturate documentation
On 03/26/2017 12:52 PM, Elle Stone wrote: Here is a link to what the modified html file looks like after compiling gimp-help to use the modified desaturate xml file, along with some new images: http://ninedegreesbelow.com/files/desaturate/8-18-desaturate.html Oh, sorry, forgot to upload the newfiles! But now the new files are up there. And italicized lines are actually italicized, yeah! Best, Elle ___ gimp-docs-list mailing list gimp-docs-list@gnome.org https://mail.gnome.org/mailman/listinfo/gimp-docs-list
Re: [Gimp-docs] Colors/Desaturate/Desaturate documentation
On 03/26/2017 10:58 AM, Elle Stone wrote: FWIW, I succeeded in compiling gimp-help with the modified desaturate XML file. I'll send some questions in another email. Here is a link to what the modified html file looks like after compiling gimp-help to use the modified desaturate xml file, along with some new images: http://ninedegreesbelow.com/files/desaturate/8-18-desaturate.html Here are three specific questions: 1. How does one validate a specific xml file? Running "make validate-en" produces this rather unhelpful output: *** Validating XML (en) ... -:57673: element figure: validity error : Element figure content does not follow the DTD, expecting (blockinfo? , (title , titleabbrev?) , (literallayout | programlisting | programlistingco | screen | screenco | screenshot | synopsis | cmdsynopsis | funcsynopsis | classsynopsis | fieldsynopsis | constructorsynopsis | destructorsynopsis | methodsynopsis | address | blockquote | graphic | graphicco | mediaobject | mediaobjectco | informalequation | informalexample | informalfigure | informaltable | indexterm | beginpage | link | olink | ulink)+), got (title para mediaobject mediaobject para mediaobject mediaobject para mediaobject mediaobject para mediaobject mediaobject para mediaobject mediaobject para mediaobject mediaobject para itemizedlist para itemizedlist ) ^ (You will find log and xml files in log/.) I say "unhelpful" because there's no mention of what file is causing the error. Opening the files in "log/" also doesn't seem to indicate which file is causing the problems. 2. I checked with https://validator.w3.org/check, which said the errors were exactly where I thought they would be, which is that I used to cause the pairs of image files to be split by line breaks. So what is the right way to cause a bunch of image files to break to a new line at specific places in the list of image files? Also the w3 validator didn't like that I put an itemized list inside the Figure. How do I fix these issues with the Figure? 3. I used this to try to make some text italicized: Comparing the resulting shades of gray for the red globe and yellow sunflower: but the text isn't italicized in the html file. So how does one make text be italicised? Best, Elle Here's the relevant excerpts from desaturate.xml: Comparing the five options The images below shows the result of using the five different ways to convert to black and white, for two very different starting images: Original image Original image Luminance applied Luminance applied . . . Comparing the resulting shades of gray for the red globe and yellow sunflower: For the red globe Lightness (HSL) produces a result very similar to Luminance, and Luma produces a conversion that is much darker. For the sunflower, Luma produces a result very similar to Luminance, and Lightness (HSL) produces a conversion that is much darker. Notice that the less saturated parts of each image look more or less the same, regardless of which methoc is chosen for converting from color to black and white. . . . ___ gimp-docs-list mailing list gimp-docs-list@gnome.org https://mail.gnome.org/mailman/listinfo/gimp-docs-list
Re: [Gimp-docs] Colors/Desaturate/Desaturate documentation
On 03/25/2017 04:10 PM, Julien Hardelin wrote: My apologies, I don't understand what "Precise that these options belong to the Mode item" means. What is a Mode item? Are you referring to the "Advanced Color Options"? Options 1- Presets 2- Mode * Luminance * Luma * Lightness * Average * Value 3- Advanced options * Apply filter to the layer's RAW pixels: with an example 4- Preview 5- Split view: interest? I'm still not sure what you are saying. Are you saying that you want specific documentation for the desaturate dialog for *all* of the following? Presets All the Modes The Advanced options The Preview The Split View Or are you saying you only want documentation for the five Modes? Luminance Luma Lightness Average Value FWIW, I succeeded in compiling gimp-help with the modified desaturate XML file. I'll send some questions in another email. Best, Elle ___ gimp-docs-list mailing list gimp-docs-list@gnome.org https://mail.gnome.org/mailman/listinfo/gimp-docs-list
Re: [Gimp-docs] Colors/Desaturate/Desaturate documentation
On 03/25/2017 03:12 AM, Julien Hardelin wrote: Hello Elle, Hi Julien, Thanks! for taking the time to respond. Color management is a hard subject. In the gimp-users list, questions about color management are rare, because common users don't use it, because they don't understand it. In the other hand, this document will be interesting for users who know color management. Maybe everything under "Choose shades of gray based on" except the actual formulas should be moved to the Notes at the bottom of the page? Your participation is a chance for gimp-help. I think we can keep this text as it is, but a tutorial about color management for newbies becomes necessary. Yes - I've been working on a tutorial that could be included in GIMP help or the official online GIMP tutorials. Only small remarks: - Precise that these options belong to the Mode item. My apologies, I don't understand what "Precise that these options belong to the Mode item" means. What is a Mode item? - All elements of a dialog must be described, even if they look evident, because they might not be evident for some users: function, what are they useful for? Are you referring to the "Advanced Color Options"? -"linearized RGB" needs a link. Linearizing the sRGB TRC is actually at the core of how GIMP 2.9/2.10 differs from GIMP 2.8 and from other image editors. A short explanation to which references to "linearized" and "linear" can link would be a nice thing to add to the GIMP tutorials or help, yes? Section 1 of this link gives the mathematics for linearizing the sRGB TRC: http://brucelindbloom.com/index.html?Eqn_RGB_to_XYZ.html Someone who doesn't already understand "linearized RGB" probably won't find the mathematical formula for undoing the sRGB companding curve to be very helpful in understanding what "linearize" actually means. Best, Elle ___ gimp-docs-list mailing list gimp-docs-list@gnome.org https://mail.gnome.org/mailman/listinfo/gimp-docs-list
Re: [Gimp-docs] Colors/Desaturate/Desaturate documentation
On 03/23/2017 11:09 PM, Pat David wrote: Hi Elle! I can't answer the other questions, but 2.9 can be found here: https://docs.gimp.org/2.9/en/ pat Pat, thanks! I was sure I had seen such a link, but couldn't find it again. Elle ___ gimp-docs-list mailing list gimp-docs-list@gnome.org https://mail.gnome.org/mailman/listinfo/gimp-docs-list
Re: [Gimp-docs] Colors/Desaturate/Desaturate documentation
On 03/23/2017 05:42 PM, Kolbjørn Stuestøl wrote: I too welcomes you, Elle. Thanks! I know that Julien is an excellent writer and teacher so you are in the best hands. It was Julien (among a couple others) who instructed me in how to translate and in writing documentation many years ago. Hopefully I can learn from Julien how to write more clearly using fewer words. Hoping you will discuss problems and solutions on this site. I have lots more to learn by following your thoughts. Well, if there's something I can help explain, please ask! The GIMP manual is huge - I didn't know so few people actually wrote documentation - it seems to me that you all have accomplished miracles. Best, Elle ___ 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/29/2014 01:25 AM, Róman Joost wrote: On 01/27/2014 11:02 AM, Elle Stone wrote: So I pulled all the Gimp help content related to color management into one real html5 file. To modify the Gimp help documentation related to color management, personally I need to **see** the changes in the context of the html as viewed by someone consulting the help documentation. After making changes to my html5 mockup, I'll transcribe the changes to the relevant XML files and (try to, assuming it's not too different from submitting a code patch) create a patch. My apologies! for bothering you all with this. I should have persisted a little longer in trying to figure out how to approach the problem before writing to the list. It's **my** problem, not **your** problem, that I can't directly modify an XML file and then visualize the resulting html! Elle -- Elle Stone 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/29/2014 09:26 AM, Andrew Douglas Pitonyak wrote: Are you been able to build and then view the resulting documentation? I built gimp-docs using these commands: ~/code/gimp-help-2 $ ALL_LINGUAS='en' ./autogen.sh --prefix=/home/elle/code/gimp-help-2/run --without-gimp make make install It seemed to build and install with no problem. The documentation was in the html folder and was viewable. Elle ___ 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: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