Michael A Nachbaur wrote:
...
So, I decided to document all the objects available to a JavaScript developer in one central place.
...
So, essentially, my plan is that my reference could replace the domref on mozilla.org.

Ok. You might want to contact the domref authors to see if you can just lift off content from those pages. And talk to Doron, he has some DOM reference documentation in the works.

I'm interested in the back end you're using to generate your site.
What format is the reference in, and where does the HTML design
come from?

The HTML design was more-or-less written by me, though it was inspired by safari.oreilly.com and ...
The format of the XML files is custom, mainly to make editing of the content as easy as possible. I also have a series of scripts that analyze the documentation tree to notify me of broken references, incomplete sections, etc.


I'm adding XLIFF support to allow the documentation to be translated to other languages efficiently. (translators wanted. :-)

Would you be interested in syncing formats with developer.mozilla.org? I can help you bring your HTML in line with the mozilla.org style guide and you can help us set up a compatible back end for similar references outside the AOM's scope. So far we've only got Darin's XPCOM reference, which is also written in XML. We're using a static build system, where the XSLT transformation is performed once to convert pages from XML in the source directory to wrapped HTML in the destination directory. I think we'll probably want to stay static, but having the XML storage format and the XSLT match seems like a good idea.

~fantasai

--
http://fantasai.inkedblade.net/contact

_______________________________________________
mozilla-documentation mailing list
[EMAIL PROTECTED]
http://mail.mozilla.org/listinfo/mozilla-documentation

Reply via email to