Differences between revisions 20 and 21
Revision 20 as of 2006-11-29 04:00:54
Size: 3535
Editor: WendySmoak
Comment:
Revision 21 as of 2009-09-20 23:11:58
Size: 3546
Editor: localhost
Comment: converted to 1.6 markup
Deletions are marked like this. Additions are marked like this.
Line 2: Line 2:
 * [http://jira.codehaus.org/browse/MSITE-156 site with FAQ plugin strips XML entities]
 * [http://jira.codehaus.org/browse/MSITE-155  site:run does not work with upper case letters in URIs]
 * [http://jira.codehaus.org/browse/MSITE-153 Paragraphs after list being "dropped" by site generation]
 * [[http://jira.codehaus.org/browse/MSITE-156|site with FAQ plugin strips XML entities]]
 * [[http://jira.codehaus.org/browse/MSITE-155|site:run does not work with upper case letters in URIs]]
 * [[http://jira.codehaus.org/browse/MSITE-153|Paragraphs after list being "dropped" by site generation]]
Line 6: Line 6:
 * NOTE: [http://sourceforge.net/tracker/index.php?func=detail&aid=1483561&group_id=93991&atid=606303 The taglib plugin requires JDK 1.5]  * NOTE: [[http://sourceforge.net/tracker/index.php?func=detail&aid=1483561&group_id=93991&atid=606303|The taglib plugin requires JDK 1.5]]
Line 57: Line 57:
  * The DTDDoc Maven 2 plugin is available, see [http://sourceforge.net/mailarchive/forum.php?thread_id=26935061&forum_id=33177 this post].   * The DTDDoc Maven 2 plugin is available, see [[http://sourceforge.net/mailarchive/forum.php?thread_id=26935061&forum_id=33177|this post]].
Line 59: Line 59:
    * see [http://svn.apache.org/repos/asf/struts/sandbox/trunk/tiles/tiles-core/pom.xml this pom]     * see [[http://svn.apache.org/repos/asf/struts/sandbox/trunk/tiles/tiles-core/pom.xml|this pom]]

RELEVANT PENDING ISSUES WITH maven-site-plugin 2.0-beta-5

Edit

  • Edit the src/site/site.xml and src/site/xdoc/*.xml files.
  • Execute 'mvn site' from the top level of the project, for example: 'struts/current/struts1'

Preview

  • To start Jetty and preview pages while you're editing:
    • Temporarily change the maven-site-plugin version to 2.0-beta-5 or 2.0-SNAPSHOT
    • 'mvn site:run' and browse http://localhost:8080

  • To build the site locally: 'mvn site:stage -DstagingDirectory=/path/to/tempdir'

  • Or point your browser at target/site/index.html (but be aware that relative links to modules won't work)

Deploy

  • To deploy: mvn site:deploy
    • Make sure you're using maven-site-plugin 2.0-beta-4
    • (See the Suggested Settings section on StrutsMaintenanceMaven to avoid repeated password prompts)

Or

  • From the command line, change to the site/target/site directory
  • scp the website files to people.apache.org.
  • You can update the site for a single sub-project by using the correct destination path. For example:
    • /svn/struts/current/struts1/tiles
      $ mvn site-deploy

After you deploy the site, check the permissions!

Permissions

  • On people.apache.org add a line with 'umask 002' to both ~/.bash_profile and ~/.bashrc . The former is used when you log in, the latter for remote ssh commands (such as when publishing the site with Maven.) This will make the files group writeable, so that other people in the 'struts' group can update them.
    • This assumes your default shell is bash. If you have a different default shell, then edit the corresponding config files.
  • If the permissions are not set correctly, you can fix it with: $ chmod -R g+w .
  • If you run the chmod, and there are error messages, it's because someone else needs to do the same.
  • You can check the permissions with: $ ls -ol

DTD

  • The DTDs are available at http://struts.apache.org/dtds

  • The source files are in the repository under the various sub-projects, and are not stored under site/xdocs/dtds
  • The DTDs are retrieved from the svn repo (with Ant's 'get' task) when the top level site is published, so they should always be up to date.

DTDDoc

StrutsMaintenanceWebsite (last edited 2009-09-20 23:11:58 by localhost)