Re: Creating a Cocoa Help Book
Re: Creating a Cocoa Help Book
- Subject: Re: Creating a Cocoa Help Book
- From: "M. Uli Kusterer" <email@hidden>
- Date: Mon, 2 May 2005 00:58:08 +0200
At 4:12 Uhr +0200 30.03.2005, Jose Antonio Ortega wrote:
Creating good documentation is, IMHO, a must for our project, and I
would appreciate any advice on what editors and other tools are your
preferred ones. Do you write directly HTML, or use some kind of
documentation system like LaTeX or DocBook?
Hi,
just thought I'd add a (late) alternative to this thread: I just
cobbled together a little shell scripting that allows using PHP to
write your help book. I'm simply using "find" to loop over all the
.php files and then call upon the PHP command line tool to generate
HTML files from that in a Shell Script Build Phase.
This allows me to take advantage of PHP's include() command and
other automation for standardizing my layout and navigation, while
all the user ever gets are the good old static HTML files Help Viewer
supports.
For an example of this script and some other nifty scripts I use in
my projects, see
http://zathras.de/angelweb/x2005-04-18.htm
I hope this will be of help to some of you. If you use these scripts
and make improvements, or if you have similar scripts, feel free to
send them to me, or write about them on your web site and send me the
URL.
--
Cheers,
M. Uli Kusterer
------------------------------------------------------------
"The Witnesses of TeachText are everywhere..."
http://www.zathras.de
_______________________________________________
Do not post admin requests to the list. They will be ignored.
Cocoa-dev mailing list (email@hidden)
Help/Unsubscribe/Update your Subscription:
This email sent to email@hidden