As some people here know, I’m making a Pong tutorial for lwjgl and have already wrote 7 pages (only a little part of the tutorial…) under OpenOffice.
There will be an online HTML version, but I would like to know if people are interested by offline format, like PDF or RTF… Is so, what file format would you recommand ?
Chman
Zipped (x)html 
Because it’s small, multi platform and easy to use. Whereas pdf is a pain in the arse (I hate pdf so much that I often end up printing it just for getting rid of that annyoing buggy reader).
Oki so I’ll make a zipped Html AND a PDF one for people who want to print the tutorial.
Any other recommanded file format ?
Well HTML is fine by me especially if its printable (no more than 640 px in width, and preferably with newpage tags in it)
The layout,writing and coloring is more important. I somewhat like NEHE style since they explain the code as one go. But it can also be a pain since you loose focus on the theory.
oh thinm I raised mroe questions than I answered sorry…
No, if you want to print it go with a PDF. Concepts such as “new page” or a fixed display width should never appear in an HTML document.
I’m personally only interested in an HTML version, and my only requests are (1) no frames, and (2) don’t cripple dynamic text sizing by the browser. As long as you comply with those two, off-line reading of pages works fine.
[quote]Well HTML is fine by me especially if its printable (no more than 640 px in width, and preferably with newpage tags in it)
The layout,writing and coloring is more important. I somewhat like NEHE style since they explain the code as one go. But it can also be a pain since you loose focus on the theory.
oh thinm I raised mroe questions than I answered sorry…
[/quote]
Thanks
I’ll make a printable HTML version, and don’t worry, the code and explanations and separated (code in a grey colored table) and I’ve tested PDF export, the layout I’ve used work perfectly and it’s very pleasant to read !
Chman
cfmdobbie, a printable HTML dokument can be made easily by having a link that opens a new window with the text in and the correct width. This also allows for change of color etc.
The next page tags are invisible tags that tells the printer that it needs to use a new page. Its usefull for when you have a new paragrah and want a blank page for that.
If you’re tutorial is going to be massive have you considered breaking it down into byte (sic) size chunks?
Kev
You could use JGF approach of separate sections, like chapters, each one a self-contained part of the tutorial. They are roughly 3-5 pages long each when converted to a Word doc.
Or, of course, you could do it as a JGF tutorial and get it edited.
[quote]You could use JGF approach of separate sections, like chapters, each one a self-contained part of the tutorial. They are roughly 3-5 pages long each when converted to a Word doc.
[/quote]
I’ve nearly finished the PDF version (14 pages for the moment, it will be 20 pages at the end) so I’ll post a preview version to see if the tutorial is good or not !
Wait for tomorrow 
Chman