Updating the CMS site

Apache Isis uses the Apache CMS to manage this website.

About the Apache CMS

A picture tells more then a thousands word so we recommend that you watch this tutorial video before you start. Extended information can be found on the Apache CMS documentation page.

With the right karma you can edit both the live and staging site but it's recommended to use the staging site to be able to preview your changes before pushing them to the production site. Our staging site is located here here:

• http://isis.staging.apache.org

The content lives in SVN at https://svn.apache.org/repos/asf/isis/site in case you want to check it out and do offline edits.

Install Bookmarklet

Please be sure to install the bookmarklet on your browser toolbar by either dragging and dropping this ASF CMS link to your toolbar or by creating a new bookmark by either right-clicking on that link and selecting "Bookmark this Link", or by opening a "New Bookmark" dialog screen from your browser's menu and typing the following into the Location/URL field:

javascript:void(location.href='https://cms.apache.org/redirect?uri='+escape(location.href))

Without this bookmarklet installed you will not be able to browse the live site and instantly edit pages in the CMS by clicking on the bookmarklet. This is an essential component of the CMS and is therefore strongly recommended.

To use the bookmarklet simply browse your live production or staging site (NOT the cms!), locate a page you'd like to edit, and click on the bookmarklet. You'll be taken to a page within the cms that allows you to edit the content by clicking on the [Edit] link.

Start editing

If you just want to get started editing a page:

• Install the bookmarklet from (see above). You only have to do this once.
• Navigate to the page you wish to edit (on the live site, not in the cms).
• Click the bookmarklet. There will be a short pause while the CMS system is initialised for you.
• Click on Edit (to skip this step hack the bookmarklet to add an 'action=edit' param to the bookmarklet's query string)
• The page editor should then be displayed.
• Click Submit to save your edit to the workarea
• Click Commit to save the updated file to SVN and trigger a staged build. (to skip this step click on the "Quick Commit" checkbox in the Edit form).
• The results should appear shortly on the staging site. (You may have to force the page to refresh in order to see the updated content)
• Once you are happy with the updated page, click on Publish Site to deploy.