Mirror of Apache Struts site

Clone this repo:
  1. 807f7bd docs: document ModelDriven parameter binding and authorization (#319) by Lukasz Lenart · 13 hours ago main
  2. 1485646 docs: add secure-usage guidance on trust state to Chaining Interceptor (#318) by Lukasz Lenart · 13 hours ago
  3. 3295865 fix: point /announce.html at the newest announce-YYYY page (#317) by Lukasz Lenart · 5 days ago
  4. f5761f8 docs: JSON input parameter filtering & scalar-collection authorization (Struts 7.3.0) (#316) by Lukasz Lenart · 5 days ago
  5. 1abc303 WW-5640 docs: document WebJars support (Struts 7.3.0) (#315) by Lukasz Lenart · 3 weeks ago

Apache Struts Website

This project is used to update the main Apache Struts website http://struts.apache.org/
See the update website documentation on how to push changes online. However as ASF is using aggressive caching, for a while one still may need to forcely reload the page (CMD+R or Shift+F5) after changes.

Site is generated by Jekyll and uses pure html either markdown format. To test website locally you can use the below command:

bundle exec jekyll serve -w --trace --host 0.0.0.0

or you can use Docker (please install it first) with one of the provided scripts:

./docker-run.fish

when running fish-shell, or:

./docker-run.sh

when running Bash or Sh.

The continuously generated website can then be accessed at http://localhost:4000

All pages are generated into the content folder.

There are two scripts used to build the image but this should be used only when Dockerfile was modified.

Some redirect rules are configured in source/.htaccess file.

Preparing a new release

When announcing a new release, update the following files together:

  1. _config.yml - bump current_version / prev_version (and the matching *_short and release_date variables).
  2. source/announce-YYYY.md - add the announcement entry for the new release in the current year's file.
  3. source/releases.md - move the version that has just been superseded into the Prior Releases table so the page reflects what is no longer the recommended download.