[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