Nadezhda, Thank you for your explanation. I've never looked at the internals. I'll look through it before making any suggestions.
I hope I'll be able to help here. Regards, -- Alexey A. Ivanov Intel Middleware Product Division >-----Original Message----- >From: Morozova, Nadezhda [mailto:[EMAIL PROTECTED] >Sent: Thursday, August 03, 2006 12:14 PM >To: harmony-dev@incubator.apache.org >Subject: RE: [doc]proposal to improve and expand website > >Alexey, > >If you look into the structure of the Harmony website, you'll see that >permanent pages are originally written in XML, then built with Ant using >Anakia for XML>HTML transformation into normal HTML. So, the source XML >files are stored in xdocs/ and resulting HTML files in docs/. This is >described in README.txt in harmony/standard/site/. > >So far, external materials on classlib packages were placed in HTML in >docs/externals directory as a read-only copy from repository. >Now, as I understood Geir, the number of useful materials that are >relatively stable grows (5 classlib docs + several drlvm docs) and >placing them all in externals/ does not seem reasonable any more. So, >Geir has suggested, and Tim Ellison has agreed that we need to transfer >the external HTML files to the XML format and make them part of site >this way. > >The issue is the volume of this task. For a short HTML doc, you can >transfer the content fairly easily: change <h> tags to <section> and ><subsection> and leave <p> and <ul> tags as they are interpreted >normally. However, for longer docs with a variety of CSS styles applied >and various content unit used, e.g. notes, definition lists, formatted >tables, and so forth. For such formatting-rich documents, the HTML > XML >transfer does not appear so linear. As I understand, this will take a >significant amount of manual editing. Or am I missing something? >Your suggestions on format transformations are most welcome :) > > >Best regards, >Nadya Morozova, > > >-----Original Message----- >From: Ivanov, Alexey A [mailto:[EMAIL PROTECTED] >Sent: Thursday, August 03, 2006 11:25 AM >To: harmony-dev@incubator.apache.org >Subject: RE: [doc]proposal to improve and expand website > >Nadezhda, > >>-----Original Message----- >>From: Morozova, Nadezhda [mailto:[EMAIL PROTECTED] >>Sent: Wednesday, August 02, 2006 8:52 PM >>To: harmony-dev@incubator.apache.org; [EMAIL PROTECTED] >>Subject: RE: [doc]proposal to improve and expand website >> >>Geir, >>Let me double-check what exactly you are proposing: >> >>> I wonder if it's time we pull that stuff out of classlib/ and move to >>> the site itself... >> >>Do you mean that we do the following: >>1) Move the ASN1 and REGEXP docs out of docs/externals to >>xdocs/subcomponents/classlib by converting them to XML? > >What kind of XML do you mean? I just can't understand. > >>2) Move the html docs packaged with classlib donations (JNDI DNS, AWT, >>JAVA2D) to the same directory with conversion involved? >> >>I'd also recommend that we do the same for stable VM docs, like >DevGuide >>and Getting Started. >> >>Now, the idea of integrating the docs into the site is just fine with >>me. >> >>However, the docs are very HTML-driven now, so you can't just cut&paste >>the HTML content with a couple of manual replacements and have a valid >>XML. There're over 15 styles that cannot map to standard XML tags. >We'll > >What are standard XML tags? Or do you mean XHTML? >Or am I just missing anything? > > >Thank you in advance, >Alexey. > >>have to think of some content model and a DTD for those, probably. And >>still this will mean a lot of work. >>So I was wondering whether it is worth the effort? What will the major >>benefits of conversion be? Couldn't we just have the docs statically in >>HTML? At least for now? >> >>Best regards, >>Nadya Morozova, >> >>-----Original Message----- >>From: Geir Magnusson Jr [mailto:[EMAIL PROTECTED] >>Sent: Wednesday, August 02, 2006 6:32 PM >>To: harmony-dev@incubator.apache.org >>Subject: Re: [doc]proposal to improve and expand website >> >> >> >>Morozova, Nadezhda wrote: >> >>> I scanned the svn repository for classlib packages, and found a few >>more >>> that had docs with them, namely the JNDI DNS Service Provider, the >AWT >>> framework and the Java2D implementation. I could move their docs to >>the >>> externals/ directory as well. >>> Now, this makes multiple docs in one folder, so I thought I'd group >>all >>> classlib package docs into a classlib/ subfolder and all DRLVM docs >>into >>> the drlvm/ subfolder. Shared files, like the style sheet, could be >>> placed in those folders to avoid duplication. >> >>I wonder if it's time we pull that stuff out of classlib/ and move to >>the site itself... >> >>geir >> >> >>--------------------------------------------------------------------- >>Terms of use : http://incubator.apache.org/harmony/mailing.html >>To unsubscribe, e-mail: [EMAIL PROTECTED] >>For additional commands, e-mail: [EMAIL PROTECTED] >> >>--------------------------------------------------------------------- >>Terms of use : http://incubator.apache.org/harmony/mailing.html >>To unsubscribe, e-mail: [EMAIL PROTECTED] >>For additional commands, e-mail: [EMAIL PROTECTED] > >-- >Alexey A. Ivanov >Intel Middleware Product Division > >--------------------------------------------------------------------- >Terms of use : http://incubator.apache.org/harmony/mailing.html >To unsubscribe, e-mail: [EMAIL PROTECTED] >For additional commands, e-mail: [EMAIL PROTECTED] > >--------------------------------------------------------------------- >Terms of use : http://incubator.apache.org/harmony/mailing.html >To unsubscribe, e-mail: [EMAIL PROTECTED] >For additional commands, e-mail: [EMAIL PROTECTED] --------------------------------------------------------------------- Terms of use : http://incubator.apache.org/harmony/mailing.html To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
