[Red5] Red5 Documentation again

[Dan Rossi]

Apologies I have moved all red5 stuff to this sub domain now

http://red5.electroteque.org/dev/doc/docbook/
http://red5.electroteque.org/dev/doc/docbook/pdf/Red5.pdf

Hopefully this is useful to some.

On 15/12/2007, at 11:35 PM, Dan Rossi wrote:

> Hi I dont mean to be stepping on toes for whoever is supposed to do  
> be doing the documentation, but I have managed to compile the pdf  
> book after alot of mucking around.
>
> I believe the documentation is fairly outdated in parts aswell are  
> they to be updated maybe ?
>
> http://www.electroteque.org/red5/doc/docbook/pdf/Red5.pdf
>
> I've still yet to get docutils to run under jython for a proper  
> portable doc gen setup, for now it needs python / docutils installed  
> to run a tool called rst2xml.py which will convert the ReST  
> documents to Docutils XML.  I then had to do alot of research into  
> how to convert the docutils xml into docbook xml as all it mentioned  
> on the site was regards to using xsl to convert. Thankfully I found  
> an xsl to convert but it required alot of editing and tweaks, and  
> now it perfectly renders docbook 4.5 / 5 documents from docutils xml.
>
> I had to fix up alot of the text documents as there was serious  
> formatting problems, which can be seen when running the rst2html.py  
> tool. I might be a bit off with it still however there is still a  
> few formatting issues in the generated pdf ill fix up later. The  
> html files i had to convert to ReST first so the formatting could be  
> fixed up there. The FAQ word doc is now in ReST format aswell and it  
> too needed editing.
>
> The ant build runs for a while as it has to do quite a bit of  
> processing , so copy the txt files from doc source directory into  
> temp directory, convert all text documents to docutils xml.  
> Transform each xml file to docbook article files. Transform docbook  
> to pdf.
>
> Next is to get the generated javadoc into docbook to add at the end  
> of the document.
>
> http://www.electroteque.org/red5/doc/docbook/book.xml
> http://www.electroteque.org/red5/doc/docbook/build.xml
> http://www.electroteque.org/red5/doc/docbook/article/
>
> http://www.electroteque.org/red5/doc.tar.gz
>
> _______________________________________________
> Red5 mailing list
> Red5 at osflash.org
> http://osflash.org/mailman/listinfo/red5_osflash.org

-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://osflash.org/pipermail/red5_osflash.org/attachments/20071216/ef3981db/attachment.html