Author: jcvanderwal
Date: Thu Nov 29 23:02:11 2012
New Revision: 1415436
URL: http://svn.apache.org/viewvc?rev=1415436&view=rev
Log:
added the updating cms page
Modified:
isis/site/trunk/content/contributors/updating-the-cms-site.md
Modified: isis/site/trunk/content/contributors/updating-the-cms-site.md
URL:
http://svn.apache.org/viewvc/isis/site/trunk/content/contributors/updating-the-cms-site.md?rev=1415436&r1=1415435&r2=1415436&view=diff
==============================================================================
--- isis/site/trunk/content/contributors/updating-the-cms-site.md (original)
+++ isis/site/trunk/content/contributors/updating-the-cms-site.md Thu Nov 29
23:02:11 2012
@@ -1,9 +1,42 @@
-Title: Updating the CMS site
-
-{stub
-This page is a stub.
-}
-
-Isis graduated from the Apache incubator in October 2012; we are currently
setting ourselves up as a top-level project.
-
-In the meantime you can access our original incubator website
[here](http://incubator.apache.org/isis "Apache Isis (incubator website)").
+Title: Updating the CMS site
+
+#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](http://s.apache.org/cms-tutorial) before you start. Extended
information can be found on the [Apache CMS documentation
page](http://www.apache.org/dev/cms.html).
+
+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][1] 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.
+
+[1]:
javascript:void(location.href='https://cms.apache.org/redirect?uri='+escape(location.href))
+
