Re: Docbook (Help files)
On Monday, 31 Jul 2000, Kevin Turner wrote: [Kevin checks the latest mail. Now it seems we have a help template file in HTML. Okay. Uh-oh, it's under a non .gimp.org domain, Sven will frown about that.] The template includes "-" as a menu path separator. The problem with this is that it suggests actually using "-" literally in the HTML, rather than the more correct "-gt;". Personally, I think anything that makes updating the help text as easy as possible is good. Ideally, there would be a button at the bottom of the help browser labelled "email corrected version" or something, that people could use if they come across typos, wrong, or missing info. Make it totally trivial for people to scratch their itch, basically :) Austin
Re: Docbook (Help files)
On Mon, Jul 31, 2000 at 07:40:12PM +0100, Austin Donnelly [EMAIL PROTECTED] wrote: The problem with this is that it suggests actually using "-" literally in the HTML, rather than the more correct "-gt;". There is nothing wrong with using "-" in html, except for some *very* outdated and *very* broken user agents. -- -==- | ==-- _ | ---==---(_)__ __ __ Marc Lehmann +-- --==---/ / _ \/ // /\ \/ / [EMAIL PROTECTED] |e| -=/_/_//_/\_,_/ /_/\_\ XX11-RIPE --+ The choice of a GNU generation | |
Re: Docbook (Help files)
DocBook sounds fine to me presuming that the tools are validating (ie users who just type nonsense into their text editor will be rewarded with a screenful of errors) and so we get some decent structured documents, not the hacked-together nonsense you usually get when people write HTML. I don't know DocBook, but presuming all I need is some web tutorial and a bunch of RPMs I am willing to learn it and submit documentation for all file formats maintained by me or unmaintained + a bonus section for all the Gimp newsgroup users who ask.. "There are so many file formats, which should I use?" ... to which the answer is of course always use PNG :) Writing this stuff will take some time, how much time do we have? Nick.
Re: Docbook (Help files)
im doing some editting as thiings are now, so the html isnt just "hacked together nonsense" it is being made coherant and valid. trust me. trust halcyon. and for those of you on the project... made a change to the template. same addy. http://www.solnet-data.dk/gimphelp/ as for it belonging somehwere else... i just put it there as a help to get the project moving. as for when to get it done... i vote for ASAP. im already proofing my butt off on docs that exist. i think we need more writers and translators. please volunteer everyone.
