xsl-list
[Top] [All Lists]

RE: Critique/comments sought: XML/XSLT website documentation project

2003-09-18 15:01:25
Hi,

First, really nice work in the math and XSL.

I just had some time to play around with your XSL. I modified it to work
with our site.xml. I changed a few things to enable it to layout out larger
sites as well. 

The global lineLength param was lengthened to 220 so folders with several
pages wouldn't bunch up so much. In some ways the bunching is good because
it tells you that usability will suffer, but sometimes you need to have many
pages in a folder...

I changed the template/@name & call-template to a template/@match &
apply-template. I couldn't get rid of the for-each and strictly use
apply-templates because it would not change the child's angle. I don't know
why apply-templates doesn't work in place of for-each???

Since we have folder and page nodes I multiplied the cx and cy variables for
folders by 4 to give more room for larger sites. In doing so, I still get
overlaps. Perhaps you have plans for collision detection? :)

Another feature might be to add interactivity where you can click on a node
to expand/collapse it (and center the node clicked in the viewport).

Cool stuff - thanks for posting it,
-Rob


-----Original Message-----
From: owner-xsl-list(_at_)lists(_dot_)mulberrytech(_dot_)com 
[mailto:owner-xsl-
list(_at_)lists(_dot_)mulberrytech(_dot_)com] On Behalf Of Dan Sumption
Sent: Thursday, September 18, 2003 3:36 AM
To: xsl-list(_at_)lists(_dot_)mulberrytech(_dot_)com

I have spent the last week learning XSLT, and have just completed my
first project (in as much as any project is ever "complete"). I wanted
to test my skills for fun, but also try to make something useful, so
I've come up with an XML system for documenting websites. The XSLT then
produces various forms of documentation from the XML, finally ending my
age-old reliance on Visio, Word, Excel etc. documents that always seem
to be out-of-synch with one another.

I'd be grateful if anyone would like to take a look and offer
suggestions/improvements - I know there's a lot that I could add to it,
but at the moment I just wanted to make something that worked. Also, I'm
sure there are people here who will find a tool like this useful. If so,
after some more refinement I'd like to offer it up for wider public
consumption (in which event, I'd welcome tips on where to publicise it)

The XML schema is here:
http://www.pernoctator.com/XML/website.xsd
And a sample XML document based on it here:
http://www.pernoctator.com/XML/whitegoods.xml

Here's an XSLT file to transform the XML into a page of HTML, describing
all of the pages on the website in list format:
http://www.pernoctator.com/XML/sitelisting.xslt
And here's an example of its output:
http://www.pernoctator.com/XML/whitegoods.html

Here's an XSLT file to transform the XML into an SVG map of the website,
showing the links between pages:
http://www.pernoctator.com/XML/sitemap.xslt
And here's an example of its output:
http://www.pernoctator.com/XML/whitegoods.svg
(use an SVG viewer to see the graphical version, e.g.
http://www.adobe.com/svg/viewer/install/main.html)

You can download the whole lot here, including the trig library include
file needed to draw the circles in SVG:
http://www.pernoctator.com/xml.zip

Comments welcome!

Dan Sumption
www.sumption.org



 XSL-List info and archive:  http://www.mulberrytech.com/xsl/xsl-list