Re: help file formats (was: Re: [Pyobjc-dev] problem accessing outlet)
Brought to you by:
ronaldoussoren
From: Ronald O. <ous...@ci...> - 2002-10-30 12:37:03
|
I've used StructuredText for the small bits of documentation that I've=20= written upto now. This is more or less plain text and there are tool=20 available (on the 'net) to convert this to other formats. Using ST was an arbitrary choice, although I'm charmed by the fact that=20= the documents look so much like plain text and can easily be read from=20= a text editor. Ronald On Wednesday, Oct 30, 2002, at 09:53 Europe/Amsterdam, S=E9bastien = Pierre=20 wrote: > > Le mardi, 29 oct 2002, =E0 23:42 Europe/Paris, Steven D. Arnold a = =E9crit : > >> That makes a lot of sense. It almost sounds like I should use a=20 >> version of >> XML with some tool that can convert to HTML, text, or other formats. =20= >> I >> could then hack the script you mentioned so that the same XML source=20= >> could >> be converted to Apple Help format. >> >> I'll do a search for such tools; if anyone knows of such a tool,=20 >> please send >> me a link. In the absence of such a tool, I'll go ahead with HTML=20 >> for now, >> and keep my eyes open. > > Hi! > > I'm actually writing such a tool: it's called "SimTex", it allows to=20= > write a document in simply formatted text, which is then converted to=20= > an XML document. This XML document conforms to the "Orchid=E9eNoire" = XML=20 > application (also by me), which comes with a processing chain that=20 > allows to convert the input XML file to various formats including=20 > HTML, plain text, PS and PDF. It is rather easy to implement a new=20 > backend. > > You can have a look at <http://projects.type-z.org>. Documentation is=20= > included into the source distros, under the Documentation folder. > > Hope this helps, > > -- S=E9bastien > > -- > =ABToo old to be alternative, too alternative to be old.=BB > <http://www.type-z.org> | Robert Smith, talking about his epitaph. > > > > ------------------------------------------------------- > This sf.net email is sponsored by:ThinkGeek > Welcome to geek heaven. > http://thinkgeek.com/sf > _______________________________________________ > Pyobjc-dev mailing list > Pyo...@li... > https://lists.sourceforge.net/lists/listinfo/pyobjc-dev > |