Document: Website Update URL: https://lenya.zones.apache.org/cms/docu/authoring/docu/website-update.html Changed by user: Andreas Hartmann (andreas)
---- Removed: /document/body/section[4]/title/text() Updating the SVN Changes ---- Added: /document/body/section[4]/title/text() Understanding the Apache infrastructure ---- Removed: /document/body/section[4]/p/text()[1] Before publishing the website, it makes sense to update the SVN change pages. This is done via the menu item ---- Removed: /document/body/section[4]/p/em <em> (null) ---- Removed: /document/body/section[4]/p/em/text() File → Update Code Changes ---- Removed: /document/body/section[4]/p/text()[3] . The update can take a while, depending on the timespan since the last update. ---- Added: /document/body/section[4]/p[1]/text()[1] The Website at ---- Added: /document/body/section[4]/p[1]/code[1] <code> (null) ---- Added: /document/body/section[4]/p[1]/code[1]/text() http://lenya.apache.org/ ---- Added: /document/body/section[4]/p[1]/text()[3] is a static site, which is served from the checkout dir ---- Added: /document/body/section[4]/p[1]/code[2] <code> (null) ---- Added: /document/body/section[4]/p[1]/code[2]/text() lenya.apache.org ---- Added: /document/body/section[4]/p[1]/text()[5] on the server based on ---- Added: /document/body/section[4]/p[1]/code[3] <code> (null) ---- Added: /document/body/section[4]/p[1]/code[3]/text() http://svn.apache.org/repos/asf/lenya/site/ ---- Added: /document/body/section[4]/p[1]/text()[7] by an Apache httpd server. ---- Added: /document/body/section[4]/p[2] <p> (null) ---- Added: /document/body/section[4]/p[2]/text()[1] The content of ---- Added: /document/body/section[4]/p[2]/code <code> (null) ---- Added: /document/body/section[4]/p[2]/code/text() lenya.apache.org ---- Added: /document/body/section[4]/p[2]/text()[3] is a static export of the live area of the Zones server. This has to be done on your local machine because we cannot commit to SVN on the Zones server. ---- Added: /document/body/section[5]/@id [attr] id=trip (null) ---- Removed: /document/body/section[5]/title/text() Understanding the Apache infrastructure ---- Added: /document/body/section[5]/title/text() Roundtrip Website Update ---- Removed: /document/body/section[5]/p[1]/text()[1] The Website at ---- Removed: /document/body/section[5]/p[1]/code[1] <code> (null) ---- Removed: /document/body/section[5]/p[1]/code[1]/text() http://lenya.apache.org/ ---- Removed: /document/body/section[5]/p[1]/text()[3] is a static site, which is served from the checkout dir ---- Removed: /document/body/section[5]/p[1]/code[2] <code> (null) ---- Removed: /document/body/section[5]/p[1]/code[2]/text() lenya.apache.org ---- Removed: /document/body/section[5]/p[1]/text()[5] on the server based on ---- Removed: /document/body/section[5]/p[1]/code[3] <code> (null) ---- Removed: /document/body/section[5]/p[1]/code[3]/text() http://svn.apache.org/repos/asf/lenya/site/ ---- Removed: /document/body/section[5]/p[1]/text()[7] by an Apache httpd server. ---- Added: /document/body/section[5]/p[1]/text() The typical roundtrip process to update the website has the following steps: ---- Added: /document/body/section[5]/ul[1] <ul> (null) ---- Added: /document/body/section[5]/ul[1]/li[1] <li> (null) ---- Added: /document/body/section[5]/ul[1]/li[1]/p <p> (null) ---- Added: /document/body/section[5]/ul[1]/li[1]/p/text() Log in to the authoring area and make your changes. ---- Added: /document/body/section[5]/ul[1]/li[2] <li> (null) ---- Added: /document/body/section[5]/ul[1]/li[2]/p <p> (null) ---- Added: /document/body/section[5]/ul[1]/li[2]/p/text()[1] Update the SVN changes via the menu item ---- Added: /document/body/section[5]/ul[1]/li[2]/p/em <em> (null) ---- Added: /document/body/section[5]/ul[1]/li[2]/p/em/text() File → Update Code Changes ---- Added: /document/body/section[5]/ul[1]/li[2]/p/text()[3] . This can take a while, depending on the timespan since the last update. ---- Added: /document/body/section[5]/ul[1]/li[3] <li> (null) ---- Added: /document/body/section[5]/ul[1]/li[3]/p <p> (null) ---- Added: /document/body/section[5]/ul[1]/li[3]/p/text() Publish the edited pages, including the SVN change pages. ---- Added: /document/body/section[5]/ul[1]/li[4] <li> (null) ---- Added: /document/body/section[5]/ul[1]/li[4]/p <p> (null) ---- Added: /document/body/section[5]/ul[1]/li[4]/p/text() Dowload the live area to your machine using the following command: ---- Added: /document/body/section[5]/ul[1]/li[4]/source <source> (null) ---- Added: /document/body/section[5]/ul[1]/li[4]/source/text() wget -t 1 -T 5 --no-check-certificate -p --cut-dirs=3 -nH -r -L -e robots=off \ https://lenya.zones.apache.org/cms/docu/live/index.html ---- Added: /document/body/section[5]/ul[1]/li[5] <li> (null) ---- Added: /document/body/section[5]/ul[1]/li[5]/p <p> (null) ---- Added: /document/body/section[5]/ul[1]/li[5]/p/text() Generate the Javadocs. ---- Added: /document/body/section[5]/ul[1]/li[6] <li> (null) ---- Added: /document/body/section[5]/ul[1]/li[6]/p <p> (null) ---- Added: /document/body/section[5]/ul[1]/li[6]/p/text()[1] Copy the exported pages to ---- Added: /document/body/section[5]/ul[1]/li[6]/p/code <code> (null) ---- Added: /document/body/section[5]/ul[1]/li[6]/p/code/text() $SITE_SVN ---- Added: /document/body/section[5]/ul[1]/li[6]/p/text()[3] . ---- Added: /document/body/section[5]/ul[1]/li[7] <li> (null) ---- Added: /document/body/section[5]/ul[1]/li[7]/p <p> (null) ---- Added: /document/body/section[5]/ul[1]/li[7]/p/text() Commit the changes. ---- Removed: /document/body/section[5]/p[2]/text()[1] The content of ---- Removed: /document/body/section[5]/p[2]/code[1] <code> (null) ---- Removed: /document/body/section[5]/p[2]/code[1]/text() lenya.apache.org ---- Removed: /document/body/section[5]/p[2]/text()[3] has to be generated by Forrest based on the ---- Removed: /document/body/section[5]/p[2]/code[2] <code> (null) ---- Removed: /document/body/section[5]/p[2]/code[2]/text() lenya.docu ---- Removed: /document/body/section[5]/p[2]/text()[5] . This has to be done on your local machine because Forrest is ---- Removed: /document/body/section[5]/p[2]/strong <strong> (null) ---- Removed: /document/body/section[5]/p[2]/strong/text() not ---- Removed: /document/body/section[5]/p[2]/text()[7] installed on the server. ---- Added: /document/body/section[5]/p[2]/text() 1) edit the documentation src -> lenya.docu ---- Added: /document/body/section[5]/ul[2] <ul> (null) ---- Added: /document/body/section[5]/ul[2]/li[1] <li> (null) ---- Added: /document/body/section[5]/ul[2]/li[1]/code <code> (null) ---- Added: /document/body/section[5]/ul[2]/li[1]/code/text() cd $lenya.docu; svn up ---- Added: /document/body/section[5]/ul[2]/li[1]/text() - change to your local checkout of the docu and update it. ---- Added: /document/body/section[5]/ul[2]/li[2] <li> (null) ---- Added: /document/body/section[5]/ul[2]/li[2]/text() Follow "Generating changes based on svn"! ---- Added: /document/body/section[5]/ul[2]/li[3] <li> (null) ---- Added: /document/body/section[5]/ul[2]/li[3]/text()[1] Run ---- Added: /document/body/section[5]/ul[2]/li[3]/code[1] <code> (null) ---- Added: /document/body/section[5]/ul[2]/li[3]/code[1]/text() forrest run ---- Added: /document/body/section[5]/ul[2]/li[3]/text()[3] locally on your machine. You can now browse the website at ---- Added: /document/body/section[5]/ul[2]/li[3]/code[2] <code> (null) ---- Added: /document/body/section[5]/ul[2]/li[3]/code[2]/text() http://localhost:8888/ ---- Added: /document/body/section[5]/ul[2]/li[3]/text()[5] . ---- Added: /document/body/section[5]/ul[2]/li[4] <li> (null) ---- Added: /document/body/section[5]/ul[2]/li[4]/text() Edit the content using your favourite editor. Refer to the forrest documentation if necessary. Hit the Reload button in your browser and test your changes locally on your machine until they work the way you intended. ---- Removed: /document/body/section[5]/p[3]/text()[1] Copy the deloyed files to your ---- Removed: /document/body/section[5]/p[3]/code[1] <code> (null) ---- Removed: /document/body/section[5]/p[3]/code[1]/text() lenya.apache.org ---- Removed: /document/body/section[5]/p[3]/text()[3] . Commit the changes in ---- Removed: /document/body/section[5]/p[3]/code[2] <code> (null) ---- Removed: /document/body/section[5]/p[3]/code[2]/text() lenya.apache.org ---- Removed: /document/body/section[5]/p[3]/text()[5] . A cron job updates the static files in ---- Removed: /document/body/section[5]/p[3]/code[3] <code> (null) ---- Removed: /document/body/section[5]/p[3]/code[3]/text() lenya.apache.org ---- Removed: /document/body/section[5]/p[3]/text()[7] of the server every 24 hours via a simple ---- Removed: /document/body/section[5]/p[3]/code[4] <code> (null) ---- Removed: /document/body/section[5]/p[3]/code[4]/text() svn up ---- Removed: /document/body/section[5]/p[3]/text()[9] . ---- Added: /document/body/section[5]/p[3]/text() 2) deploy and commit your changes to the documentation src -> lenya.docu ---- Added: /document/body/section[5]/ul[3] <ul> (null) ---- Added: /document/body/section[5]/ul[3]/li[1] <li> (null) ---- Added: /document/body/section[5]/ul[3]/li[1]/text()[1] Run ---- Added: /document/body/section[5]/ul[3]/li[1]/code[1] <code> (null) ---- Added: /document/body/section[5]/ul[3]/li[1]/code[1]/text() forrest ---- Added: /document/body/section[5]/ul[3]/li[1]/text()[3] -> This will create the site in ---- Added: /document/body/section[5]/ul[3]/li[1]/code[2] <code> (null) ---- Added: /document/body/section[5]/ul[3]/li[1]/code[2]/text() lenya.docu/build/site ---- Added: /document/body/section[5]/ul[3]/li[1]/br <br> (null) ---- Added: /document/body/section[5]/ul[3]/li[1]/text()[6] (Note that Forrest sometimes claims that the build failed, please see the broken-links.xml. Here you can find the pages that have errors and which pages refer to them.) ---- Added: /document/body/section[5]/ul[3]/li[2] <li> (null) ---- Added: /document/body/section[5]/ul[3]/li[2]/text()[1] Check in your changes (if you are a committer) ---- Added: /document/body/section[5]/ul[3]/li[2]/code[1] <code> (null) ---- Added: /document/body/section[5]/ul[3]/li[2]/code[1]/text() svn ci -m "my changes message" ---- Added: /document/body/section[5]/ul[3]/li[2]/text()[3] or prepare a patch (if you aren't) ---- Added: /document/body/section[5]/ul[3]/li[2]/code[2] <code> (null) ---- Added: /document/body/section[5]/ul[3]/li[2]/code[2]/text() svn diff > patch.txt ---- Added: /document/body/section[5]/ul[3]/li[2]/text()[5] of ---- Added: /document/body/section[5]/ul[3]/li[2]/code[3] <code> (null) ---- Added: /document/body/section[5]/ul[3]/li[2]/code[3]/text() lenya.docu ---- Added: /document/body/section[5]/p[4] <p> (null) ---- Added: /document/body/section[5]/p[4]/text() 3) copy deployed changes from the documentation src to the website checkout-> lenya.apache.org ---- Added: /document/body/section[5]/ul[4] <ul> (null) ---- Added: /document/body/section[5]/ul[4]/li[1] <li> (null) ---- Added: /document/body/section[5]/ul[4]/li[1]/code <code> (null) ---- Added: /document/body/section[5]/ul[4]/li[1]/code/text() cd $lenya.apache.org; svn up ---- Added: /document/body/section[5]/ul[4]/li[1]/text() - change to your local checkout of the website and update it. ---- Added: /document/body/section[5]/ul[4]/li[2] <li> (null) ---- Added: /document/body/section[5]/ul[4]/li[2]/code <code> (null) ---- Added: /document/body/section[5]/ul[4]/li[2]/code/text() cp -r $lenya.docu/build/site/* . ---- Added: /document/body/section[5]/ul[4]/li[2]/text() - copy the deployed site from step 2. ---- Added: /document/body/section[5]/ul[4]/li[3] <li> (null) ---- Added: /document/body/section[5]/ul[4]/li[3]/text()[1] Create and copy the Javadoc for both branches ( ---- Added: /document/body/section[5]/ul[4]/li[3]/code[1] <code> (null) ---- Added: /document/body/section[5]/ul[4]/li[3]/code[1]/text() build javadocs ---- Added: /document/body/section[5]/ul[4]/li[3]/text()[3] , Copy from ---- Added: /document/body/section[5]/ul[4]/li[3]/code[2] <code> (null) ---- Added: /document/body/section[5]/ul[4]/li[3]/code[2]/text() build/webapp/site/apidocs ---- Added: /document/body/section[5]/ul[4]/li[3]/text()[5] to ---- Added: /document/body/section[5]/ul[4]/li[3]/code[3] <code> (null) ---- Added: /document/body/section[5]/ul[4]/li[3]/code[3]/text() lenya/site/apidocs/1.2 ---- Added: /document/body/section[5]/ul[4]/li[3]/text()[7] and ---- Added: /document/body/section[5]/ul[4]/li[3]/code[4] <code> (null) ---- Added: /document/body/section[5]/ul[4]/li[3]/code[4]/text() lenya/site/apidocs/2.0 ---- Added: /document/body/section[5]/ul[4]/li[3]/text()[9] ) ---- Added: /document/body/section[5]/ul[4]/li[4] <li> (null) ---- Added: /document/body/section[5]/ul[4]/li[4]/text()[1] Commit your changes to lenya.apache.org ---- Added: /document/body/section[5]/ul[4]/li[4]/code <code> (null) ---- Added: /document/body/section[5]/ul[4]/li[4]/code/text() svn ci -m "my changes message" ---- Added: /document/body/section[5]/ul[4]/li[4]/text()[3] . ---- Removed: /document/body/section[6] <section> (null) ---- Removed: /document/body/section[6]/@id [attr] id=trip (null) ---- Removed: /document/body/section[6]/title <title> (null) ---- Removed: /document/body/section[6]/title/text() Roundtrip website update ---- Removed: /document/body/section[6]/p[1] <p> (null) ---- Removed: /document/body/section[6]/p[1]/text() The typical roundtrip process to update the website has the following steps. ---- Removed: /document/body/section[6]/p[2] <p> (null) ---- Removed: /document/body/section[6]/p[2]/text() 1) edit the documentation src -> lenya.docu ---- Removed: /document/body/section[6]/ul[1] <ul> (null) ---- Removed: /document/body/section[6]/ul[1]/li[1] <li> (null) ---- Removed: /document/body/section[6]/ul[1]/li[1]/code <code> (null) ---- Removed: /document/body/section[6]/ul[1]/li[1]/code/text() cd $lenya.docu; svn up ---- Removed: /document/body/section[6]/ul[1]/li[1]/text() - change to your local checkout of the docu and update it. ---- Removed: /document/body/section[6]/ul[1]/li[2] <li> (null) ---- Removed: /document/body/section[6]/ul[1]/li[2]/text() Follow "Generating changes based on svn"! ---- Removed: /document/body/section[6]/ul[1]/li[3] <li> (null) ---- Removed: /document/body/section[6]/ul[1]/li[3]/text()[1] Run ---- Removed: /document/body/section[6]/ul[1]/li[3]/code[1] <code> (null) ---- Removed: /document/body/section[6]/ul[1]/li[3]/code[1]/text() forrest run ---- Removed: /document/body/section[6]/ul[1]/li[3]/text()[3] locally on your machine. You can now browse the website at ---- Removed: /document/body/section[6]/ul[1]/li[3]/code[2] <code> (null) ---- Removed: /document/body/section[6]/ul[1]/li[3]/code[2]/text() http://localhost:8888/ ---- Removed: /document/body/section[6]/ul[1]/li[3]/text()[5] . ---- Removed: /document/body/section[6]/ul[1]/li[4] <li> (null) ---- Removed: /document/body/section[6]/ul[1]/li[4]/text() Edit the content using your favourite editor. Refer to the forrest documentation if necessary. Hit the Reload button in your browser and test your changes locally on your machine until they work the way you intended. ---- Removed: /document/body/section[6]/p[3] <p> (null) ---- Removed: /document/body/section[6]/p[3]/text() 2) deploy and commit your changes to the documentation src -> lenya.docu ---- Removed: /document/body/section[6]/ul[2] <ul> (null) ---- Removed: /document/body/section[6]/ul[2]/li[1] <li> (null) ---- Removed: /document/body/section[6]/ul[2]/li[1]/text()[1] Run ---- Removed: /document/body/section[6]/ul[2]/li[1]/code[1] <code> (null) ---- Removed: /document/body/section[6]/ul[2]/li[1]/code[1]/text() forrest ---- Removed: /document/body/section[6]/ul[2]/li[1]/text()[3] -> This will create the site in ---- Removed: /document/body/section[6]/ul[2]/li[1]/code[2] <code> (null) ---- Removed: /document/body/section[6]/ul[2]/li[1]/code[2]/text() lenya.docu/build/site ---- Removed: /document/body/section[6]/ul[2]/li[1]/br <br> (null) ---- Removed: /document/body/section[6]/ul[2]/li[1]/text()[6] (Note that Forrest sometimes claims that the build failed, please see the broken-links.xml. Here you can find the pages that have errors and which pages refer to them.) ---- Removed: /document/body/section[6]/ul[2]/li[2] <li> (null) ---- Removed: /document/body/section[6]/ul[2]/li[2]/text()[1] Check in your changes (if you are a committer) ---- Removed: /document/body/section[6]/ul[2]/li[2]/code[1] <code> (null) ---- Removed: /document/body/section[6]/ul[2]/li[2]/code[1]/text() svn ci -m "my changes message" ---- Removed: /document/body/section[6]/ul[2]/li[2]/text()[3] or prepare a patch (if you aren't) ---- Removed: /document/body/section[6]/ul[2]/li[2]/code[2] <code> (null) ---- Removed: /document/body/section[6]/ul[2]/li[2]/code[2]/text() svn diff > patch.txt ---- Removed: /document/body/section[6]/ul[2]/li[2]/text()[5] of ---- Removed: /document/body/section[6]/ul[2]/li[2]/code[3] <code> (null) ---- Removed: /document/body/section[6]/ul[2]/li[2]/code[3]/text() lenya.docu ---- Removed: /document/body/section[6]/p[4] <p> (null) ---- Removed: /document/body/section[6]/p[4]/text() 3) copy deployed changes from the documentation src to the website checkout-> lenya.apache.org ---- Removed: /document/body/section[6]/ul[3] <ul> (null) ---- Removed: /document/body/section[6]/ul[3]/li[1] <li> (null) ---- Removed: /document/body/section[6]/ul[3]/li[1]/code <code> (null) ---- Removed: /document/body/section[6]/ul[3]/li[1]/code/text() cd $lenya.apache.org; svn up ---- Removed: /document/body/section[6]/ul[3]/li[1]/text() - change to your local checkout of the website and update it. ---- Removed: /document/body/section[6]/ul[3]/li[2] <li> (null) ---- Removed: /document/body/section[6]/ul[3]/li[2]/code <code> (null) ---- Removed: /document/body/section[6]/ul[3]/li[2]/code/text() cp -r $lenya.docu/build/site/* . ---- Removed: /document/body/section[6]/ul[3]/li[2]/text() - copy the deployed site from step 2. ---- Removed: /document/body/section[6]/ul[3]/li[3] <li> (null) ---- Removed: /document/body/section[6]/ul[3]/li[3]/text()[1] Create and copy the Javadoc for both branches ( ---- Removed: /document/body/section[6]/ul[3]/li[3]/code[1] <code> (null) ---- Removed: /document/body/section[6]/ul[3]/li[3]/code[1]/text() build javadocs ---- Removed: /document/body/section[6]/ul[3]/li[3]/text()[3] , Copy from ---- Removed: /document/body/section[6]/ul[3]/li[3]/code[2] <code> (null) ---- Removed: /document/body/section[6]/ul[3]/li[3]/code[2]/text() build/webapp/site/apidocs ---- Removed: /document/body/section[6]/ul[3]/li[3]/text()[5] to ---- Removed: /document/body/section[6]/ul[3]/li[3]/code[3] <code> (null) ---- Removed: /document/body/section[6]/ul[3]/li[3]/code[3]/text() lenya/site/apidocs/1.2 ---- Removed: /document/body/section[6]/ul[3]/li[3]/text()[7] and ---- Removed: /document/body/section[6]/ul[3]/li[3]/code[4] <code> (null) ---- Removed: /document/body/section[6]/ul[3]/li[3]/code[4]/text() lenya/site/apidocs/2.0 ---- Removed: /document/body/section[6]/ul[3]/li[3]/text()[9] ) ---- Removed: /document/body/section[6]/ul[3]/li[4] <li> (null) ---- Removed: /document/body/section[6]/ul[3]/li[4]/text()[1] Commit your changes to lenya.apache.org ---- Removed: /document/body/section[6]/ul[3]/li[4]/code <code> (null) ---- Removed: /document/body/section[6]/ul[3]/li[4]/code/text() svn ci -m "my changes message" ---- Removed: /document/body/section[6]/ul[3]/li[4]/text()[3] . ---- --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]