Excellent work, Wendy. I know you've done a great deal of work
on this and we all appreciate it. Even if you are using Maven.
david
Le 05-08-11 à 07:25, Wendy Smoak a écrit :
Thanks for all the feedback and suggestions for the new site.
Here's a
second draft, incorporating as many of the suggestions as I could
get to:
http://svn.apache.org/builds/struts/maven/trunk/site-test/index.html
- Navigation to subprojects is now consolidated near the top of the
menu.
- If a subproject has a directory on the existing site, (bsf, flow,
shale,)
the link goes to that documentation.
- If there is no existing documentation (sandbox, etc.) then the
link goes
to the Maven-generated page.
- The 'Overview' at the top of the Projects menu lists all of the
Maven-generated pages, so they are all accessible.
- The subprojects are directly under the root of the website (not
under a
directory called 'multiproject' any longer.)
I have not yet had time to look at the taglib documentation so
that's still
missing.
I'll do something to get the JavaDoc back into the 'Documentation'
menu--
probably just a page that links to the Javadoc for each
subproject. (Maven
puts
the links under Project Reports -> JavaDoc for each subproject.)
Ted wrote:
* The Download links could point to anchors on the Acquiring page, to
provide a single gateway.
I changed the download links to point to the Acquiring page. The
anchors,
however, are a problem.
Maven links to http://jakarta.apache.org/site/jakarta-site2.html as
the
accepted structure for the xml docs. And that includes neither the
'href'
attribute that we're using to render anchors, nor the <chapter> tag
that
appears in the userGuide docs.
The XSLT is using the 'name' attribute as both the text for the
section
headers _and_ the anchor name, and is ignoring the 'href' attribute
entirely.
The <chapter> tags are also ignored. I changed them to empty
<section> tags
to get the text to appear. Unless <chapter> is important for some
reason
I'm not aware of, (docbook?) those can probably be changed to
section/subsection tags.
Getting the anchors to work like they used to is probably going to
require
modifying the XSL stylesheet
(.maven\cache\maven-xdoc-plugin-1.9.1\plugin-resources\site.jsl)
and setting
a property to tell Maven to use our stylesheet.
I'm keeping notes on the site conversion here for now:
http://wiki.wsmoak.net/cgi-bin/wiki.pl?MavenMultiProjectSite
I will post a site conversion plan on the Struts Wiki tonight. I'm
planning
to do the initial copy from core/docs to build/xdocs in the
repository no
earlier than Friday night.
Thanks,
--
Wendy
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
