Edit Website

The website uses the Apache CMS. More detailed documentation is available on the Apache Infrastructure pages including a quickstart guide on the Apache bookmarklet and a reference manual. It is also useful to look at other Apache CMS sites for examples.

Process

  1. Do an svn checkout of the website, for committers: svn co https://svn.apache.org/repos/asf/roller/cmssite/trunk rollersite

    For non-committers: svn co http://svn.apache.org/repos/asf/roller/cmssite/trunk rollersite

  2. If the changes are structurally significant (many pages removed/added, etc.), before committing to staging you may wish to test that the site still builds locally by following these instructions.
    Note you will probably lose the CSS formatting with local builds due to the way the stylesheets are referenced, check instead at staging (below) to ensure stylesheets are working as intended.
    If deleting a file or changing the name of a file make a trivial edit to lib/path.pm or lib/view.pm to force a full site rebuild.
  3. Commit a change to the website's source Markdown files located in https://svn.apache.org/repos/asf/roller/cmssite/trunk. If you're not a committer, supplying a patch (svn diff -u > website.patch) to our JIRA issue tracker instead will do.
  4. Wait a few minutes to get the email on the commits list that buildbot has rebuilt the staging website.
  5. If the change looks ok, publish the change to the production website by

    • (recommended method) Using the Apache bookmarklet: Publish site
    • curl -sL http://s.apache.org/cms-cli | perl on your local machine
    • ssh -t @people.apache.org publish.pl roller

Style