[FM Discuss] ChucK Manual
Adam Tindale
adamtindale at hotmail.com
Wed Dec 16 12:55:14 PST 2009
Hi All,
I am the Maintainer for the ChucK documentation and we are in the
midst of a sprint to get the manual into FLOSS manuals. I have put a
bunch of it live so you can see it here:
http://en.flossmanuals.net/ChucK/Introduction
Our manual is about 190 pages and most of it is now living in FLOSS
manuals. We also have a few people doing entirely new sections of
documentation. This is a bit of an experiment to see if a migration is
actually the best thing for the project.
I have noticed a bunch of things that I am wondering about.
1. There doesn't seem to be a way to delete chapters.
2. We have a problem with page 2 (see our places page)
It has a repeated <-Previous link at the top and it is messing up
the formatting.
3. OBJAVI outputs one blank page
4. The PDF output has many errors. Whenever a word starts with f the
character gets rendered as something else.
My short term needs are access to the CSS so I can change the style.
Because ChucK is a command line programming language we have greater
needs for precise formatting so we don't confuse the users.
I am also hoping to find out about how to control the output of the
PDF more precisely. Our old manual was made in LaTeX and I have a lot
of experience there that could be useful.
I have been doing the manual mostly alone for nearly 5 years. During
the sprint I had 4 very active users helping out. FLOSS manuals has
made that possible. In order to convince the project that a full
migration to FLOSS is the best option I think we will need to be able
to work out our formatting issues. Any help or advice is greatly
appreciated.
Adam
More information about the Discuss
mailing list