Re: [Gimp-docs] concepts
- When explaining a term, please add an indexterm indexterm primaryResolution/primary /indexterm This will automatcally appear in the index chapter: last line in the html summary. I've been meaning to ask about this: There were 7 terms in concepts.xml but only one of them, channels, had an indexterm. So if I understand correctly, the reason is that those other terms are explained at length elsewhere, and THOSE places are linked to in the index, while there is no other reference to resolution in the help? That is docbook rules: there is no varlistentry parent for indexterm but there is title. In varlistentry you must include indexterm within term tags. Please see http://docbook.org/tdg/en/html/indexterm.html There are some inconsistencies in the index. It has to be reviewed. I made these changes in your xml file. Do you want I push your changes? Sure. Done http://git.gnome.org/browse/gimp-help-2/ ___ Gimp-docs mailing list Gimp-docs@lists.XCF.Berkeley.EDU https://lists.XCF.Berkeley.EDU/mailman/listinfo/gimp-docs
Re: [Gimp-docs] concepts
2011/2/23 Julien Hardelin jm.h...@wanadoo.fr Hi Michael, OK for substance. Some remarks about form: - TAB are set to 2 spaces. - Lines are less than 80 characters and spaces. OK, figured out how to do those with Notepad++. - When explaining a term, please add an indexterm indexterm primaryResolution/primary /indexterm This will automatcally appear in the index chapter: last line in the html summary. I've been meaning to ask about this: There were 7 terms in concepts.xml but only one of them, channels, had an indexterm. So if I understand correctly, the reason is that those other terms are explained at length elsewhere, and THOSE places are linked to in the index, while there is no other reference to resolution in the help? - I noticed 2 typos: reslution and noticable. You probably have a spelling command in your editor. Yup. I guess I'm so used to check-as-you-type spellcheckers I haven't thought of runing a spell check. what is the significance of adding acronym and quote tags? what are they for? they seem to have no influence on the final output. For acronym, I don't know. But quote is important for internationalization. With quoteHello/quote, I automatically get the French quotes in French html (« Hello ») with indivisible spaces! I made these changes in your xml file. Do you want I push your changes? Sure. ___ Gimp-docs mailing list Gimp-docs@lists.XCF.Berkeley.EDU https://lists.XCF.Berkeley.EDU/mailman/listinfo/gimp-docs
Re: [Gimp-docs] concepts
Kolbjørn Stuestøl (Wednesday, 23. February 2011) BTW: For some reasons the guote tag does not work in Norwegian. quoteHello/quote is written as Hello instead of «Hello». (We are using the same quotes as in French). This is a DocBook bug, IMHO. Try to change the quote chars manually (in /usr/share/xml/docbook/stylesheet/nwalsh/1.75.2/common/nn.xml or wherever your language file is) to be sure. Bye, Ulf -- Erstaunlich, wie vieles sich verständigt, ohne Verstand zu haben, und wie viele Verstand haben, ohne sich verständigen zu können. -- Karlheinz Deschner signature.asc Description: This is a digitally signed message part. ___ Gimp-docs mailing list Gimp-docs@lists.XCF.Berkeley.EDU https://lists.XCF.Berkeley.EDU/mailman/listinfo/gimp-docs
Re: [Gimp-docs] concepts
Michael Grosberg (Tuesday, 22. February 2011) what is the significance of adding acronym and quote tags? what are they for? they seem to have no influence on the final output. quote tags are important to set the correct quotation chars. acronym tags are used to convert the enclosed text to capital letters, AFAIK (I never did any tests), and add acronym class=acronym.../acronym to the HTML output, which may be used in CSS stylesheets. So right now they are not really important -- it's good style and correct if you use them, but nothing happens if you forget it. Lastly, how important is the way these files are indented? I always use tabs, and any editor I'm familiar with uses tabs to indent lines, while these files seem to use spaces. Is is important to indent the XML in this way? By convention we use two spaces. Mixing tabs and spaces will make the XML files less readable, especially if someone uses a different editor. Bye, Ulf -- Religionen sind falsche Mittel zur Befriedigung echter Bedürfnisse. -- Karlheinz Deschner signature.asc Description: This is a digitally signed message part. ___ Gimp-docs mailing list Gimp-docs@lists.XCF.Berkeley.EDU https://lists.XCF.Berkeley.EDU/mailman/listinfo/gimp-docs
Re: [Gimp-docs] concepts
Den 23.02.2011 13:32, skreiv Ulf-D. Ehlert: Kolbjørn Stuestøl (Wednesday, 23. February 2011) BTW: For some reasons theguote tag does not work in Norwegian. quoteHello/quote is written as Hello instead of «Hello». (We are using the same quotes as in French). This is a DocBook bug, IMHO. Try to change the quote chars manually (in /usr/share/xml/docbook/stylesheet/nwalsh/1.75.2/common/nn.xml or wherever your language file is) to be sure. Bye, Ulf The Windows keyboard do not has the «» quote signs by default. Linux has. I'll give your suggestion a try. Until now I have deleted the quote tag and entered the signs by hand in my translated po files. (Not in the original xml files). Thank you, Ulf. Kolbjoern ___ Gimp-docs mailing list Gimp-docs@lists.XCF.Berkeley.EDU https://lists.XCF.Berkeley.EDU/mailman/listinfo/gimp-docs