Re: Docbook (Help files)

2000-07-31 Thread Rebecca Jean Pedersen
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 some

Re: Help files

2000-07-31 Thread Federico Mena Quintero
suite uses this structure. It leads to nice results, I think. As for the look of the final output, it is just a stylesheet issue. The GDP has nice stylesheets both for printing and for generating HTML. > Egger argues, "GIMP doesn't *need* help files to run, so they can be

Re: Docbook (Help files)

2000-07-31 Thread Nick Lamb
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 k

Re: Docbook (Help files)

2000-07-31 Thread James Smaby
I skimmed the documentation for DocBook, and while parts of it look quit different from HTML, the necessities are simple, and I don't see why anybody couldn't easily write a help file from a template file (that's really how we all started learning how to write in HTML, right?) Give me a good exam

Re: Docbook (Help files)

2000-07-31 Thread Marc Lehmann
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 "->". There is nothing wrong with using "->" in html, except for some *very* outdated and *ver

Re: Docbook (Help files)

2000-07-31 Thread Austin Donnelly
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

Re: Docbook (Help files)

2000-07-31 Thread Kevin Turner
I guess another argument in favour of Docbook is peer pressure. When making the rounds around the documentation sites, I found that at the recent Open Source Documentation Summit, the Gnome Documentation Project, Linux Documentation Project, and FreeBSD folks have all agreed to use DocBook (in it

Help Files

2000-07-31 Thread Rebecca Jean Pedersen
I'm trying to help Halcyon out a bit with the help files so I put up a section of my company's homepage for the project. address is http://www.solnet-data.dk/gimphelp/ If you are working on the project, please go get the template.html available on that site for use in making your do

Re: Help files

2000-07-31 Thread Garry R. Osgood
Rebecca Jean Pedersen wrote: > I figured since everyone is talking help files I would just introduce > myself. I'm on IRC as bex and I'm willing to help however I can. I'm > somewhat new to gimp, so I won't be much good for writing new help > files, but my edu

Re: Help files

2000-07-31 Thread Jarda Benkovsky
If I may add some points in favor of DocBook: - consistency - it will help make the pages the same style - easy change of style in all pages at once - I believe it's simpler than full-blown HTML (CSS ) Edheldil

Re: Help files

2000-07-31 Thread Rebecca Jean Pedersen
I figured since everyone is talking help files I would just introduce myself. I'm on IRC as bex and I'm willing to help however I can. I'm somewhat new to gimp, so I won't be much good for writing new help files, but my education is in English, especially writing, so I

Re: Help files

2000-07-30 Thread egger
A few persons on IRC stated they'd also like a printed reference. (Yes, I know your book and it's great, but still) :) > I'm all for using DocBook to create the help files if and only if the > help authors feel comfortable with it, someone who knows DocBook and > all

Re: Help files

2000-07-30 Thread Sven Neumann
t; Sorry, this page hasn't been written in yet. Would you > like to read this help in instead? As you might have noticed the creators of the help system have already thought about that. The current help-system does not yet support multi-language help files, but the current directory

Re: Help files

2000-07-30 Thread egger
plugins.gimp.org/maze/help.html > Is this a good style to follow, or no? I think it's pretty good. > Egger argues, Please call me Daniel... > "GIMP doesn't *need* help files to run, so they can be > distributed seperately." That's just a fraction of my argume

Help files

2000-07-30 Thread Kevin Turner
Ok, so it looks like we need to start filling in the help files. There are a number of things about the help files that never got decided (or at least the decisions were never made public), because we were told "someone else is taking care of it". But now, it looks like we'v