DO NOT EDIT THE .html files in /www/jakarta.apache.org. Please follow the directions below for updating the website.
The Jakarta website is based on .xml files which are transformed into .html files using XSLT via an Ant task.
In order to make modifications to the Jakarta website, you need to first check out the jakarta-site2 module from SVN:
svn co https://svn.apache.org/repos/asf/jakarta/site/
Once you have the site checked out locally, cd into your jakarta-site2 directory and execute:
This will build the documentation into the docs/ directory. The output will show you which files got re-generated. If you would like to make modifications to the website documents, you simply need to edit the files in the xdocs/ directory.
The files in xdocs/stylesheets are the global files for the site. If you make a modification to site.xml, it will affect the navigation for the website, style.xsl is the template that controls the look and feel for the overall website. Once you have built your documentation and confirmed that your changes are ok, you can check your .xml and your .html files back into SVN.
Then in the /www/jakarta.apache.org/ directory you should:
svn update index.html site
The Jakarta-Site module supports a set of XML/XHTML tags which it will render specially. Here is an example XML document:
<?xml version="1.0" encoding="ISO-8859-1"?> <document> <properties> <author email="nospam.AT.foo.DOT.com">Jon S. Stevens</author> <author email="mrsmith.AT.foo.DOT.com">Mr. Smith</author> <title></title> </properties> <meta name="keyword" content="jakarta, java"/> <body> <section name="Section 1"> <p> This is section 1. </p> <table> <tr> <td>This is a table</td> </tr> </table> <ul> <li>This is an unordered list.</li> </ul> </section> <section name="Section 2"> <p> This is section 2. </p> <ol> <li>This is an ordered list.</li> </ol> </section> <section name="Section 3"> <p> This is section 3. </p> <source> Anything within this tag is rendered as a "box" with blue lines and <pre></pre> tags around it. </source> <subsection name="Subsection of Section 3"> <p> This is the subsection 3. </p> </subsection> </section> </body> </document>
The output of the example XML file above is shown here. View source in your browser to see the generated HTML markup.