THIS IS A TEST INSTANCE. ALL YOUR CHANGES WILL BE LOST!!!!
Goal
Integrate the existing Struts website into the Maven-generated multi-project website.
Draft Site
http://svn.apache.org/builds/struts/maven/trunk/site-test/index.html
Discussion Thread
http://www.mail-archive.com/dev%40struts.apache.org/msg10723.html
Timeline
- Initial move from core/doc to site/xdocs on Saturday, August 13, 2005
Initial Conversion Plan
Wiki Markup \[DONE\] Move everything from /struts/current/core/doc/ to /struts/current/site/xdocs/
Wiki Markup \[DONE\] Rename the project.xml files (which contain the menus) to navigation.xml
Wiki Markup \[DONE\] Change links in all navigation.xml files under 'site' to be relative to the root directory
Wiki Markup \[DONE\] Add the missing <body> tags to navigation.xml files
Wiki Markup \[DONE\] Change the anchors in navigation.xml files to match the section names
Wiki Markup \[DONE\]Add navigation.xml files to xdocs under each subproject
Wiki Markup \[DONE\]Remove the <search> section from userGuide/index.xml and faqs/index.xml
- Remove 'href' attributes from <section> and <subsection> tags, add <a name='...'/> to preserve existing anchors
Wiki Markup \[DONE\] Add a page with links to [JavaDoc] for each subproject.
- User Guide
- Fix links to Taglib Package Descriptions (JavaDoc) in the User Guide
- Fix links to Taglib API References in the User Guide
Wiki Markup \[DONE\] Change <chapter> and <section> to <section> and <subsection>
Wiki Markup \[DONE\] Change <pre> <code> blocks to <source>
Wiki Markup \[DONE\] Generate and link in the TLD documentation
- Maven Taglib Plugin: http://maven-taglib.sourceforge.net/
- Maven Taglib Plugin: http://maven-taglib.sourceforge.net/
Additional Issues
- Publish the Struts 1.2 docs to struts-docs-1.2
- Consolidate the multiproject sites for subprojects (Apps, Shale, Sandbox, Ti)
Post-Conversion To Do List
- Move relevant documentation down to the sub-project level
Wiki Markup \[DONE\] Shale Framework
Wiki Markup \[DONE\] Struts Flow
Wiki Markup \[DONE\] Struts Faces
Wiki Markup \[DONE\] Struts BSF
Wiki Markup \[DONE\] Struts Tiles
- Struts Core
- Struts Taglibs
- Generate HTML and PDF versions of the documentation
- Maven PDF plugin: http://maven.apache.org/reference/plugins/pdf
- XSL-FO Transform: http://www.mail-archive.com/dev%40struts.apache.org/msg10824.html
- Maven DocBook plugin: http://maven-plugins.sourceforge.net/maven-sdocbook-plugin/index.html
- Aggregate the reports across the sub-projects:
- Maven Dashboard Plugin: http://maven.apache.org/reference/plugins/dashboard/
- Maven Dashboard Plugin: http://maven.apache.org/reference/plugins/dashboard/
Post-Conversion Refactorings
Apache Struts
- Welcome (1st section only, amend text)
- Who we are
- Announcements
Projects
- Overview (add text)
- ...
- Sandbox (add text and explain that these are whiteboard proposals only)
- ...
- Site (add text explaining reactor build)
- ...
- Tiles
Community
- Mailing Lists
- Wiki Pages
- Resource Directory
- Known Issues (bugzilla)
Download
- Binaries
- Source Code
- Development Releases
Development
- Bylaws
- Release Guidelines
- Source Repository
- How to Help FAQ
Project Documentation
- About Struts Site (add text)
- Project Info
- Project Reports (fix - SVN issue?)
- Development Process
Then, we can move the rest under the Core subproject:
Struts Core
- Welcome (portions of 1st section, second section)
- Learning
- Using
Documentation
- User and Developer Guides
- ...
- FAQs
Project Documentation
- ...
A New Theme?
Resources for contributors who would like to provide a new theme for the Struts site
- Maven 1 Site Plugin
- Maven 1 Xdoc Plugin properties
- User List posts with suggestions:
- Development hints:
- Start with the 'maven-theme.css' file here: http://struts.apache.org/style/
- Use 'maven.xdoc.theme.file' in project.properties to specify the new theme.