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[3]/ul <ul> (null) ---- Removed: /document/body/section[3]/ul/li[1] <li> (null) ---- Removed: /document/body/section[3]/ul/li[1]/text()[1] Add your .iml file to the passwd directory to the SVN repository at ---- Removed: /document/body/section[3]/ul/li[1]/code <code> (null) ---- Removed: /document/body/section[3]/ul/li[1]/code/text() $DOCU_SVN/pubs/docu/config/access-control/passwd/ ---- Removed: /document/body/section[3]/ul/li[1]/text()[3] . Don't forget to add you to the groups ---- Removed: /document/body/section[3]/ul/li[1]/em[1] <em> (null) ---- Removed: /document/body/section[3]/ul/li[1]/em[1]/text() editor ---- Removed: /document/body/section[3]/ul/li[1]/text()[5] , ---- Removed: /document/body/section[3]/ul/li[1]/em[2] <em> (null) ---- Removed: /document/body/section[3]/ul/li[1]/em[2]/text() reviewer ---- Removed: /document/body/section[3]/ul/li[1]/text()[7] , ---- Removed: /document/body/section[3]/ul/li[1]/em[3] <em> (null) ---- Removed: /document/body/section[3]/ul/li[1]/em[3]/text() sitemanager ---- Removed: /document/body/section[3]/ul/li[1]/text()[9] , and ---- Removed: /document/body/section[3]/ul/li[1]/em[4] <em> (null) ---- Removed: /document/body/section[3]/ul/li[1]/em[4]/text() admin ---- Removed: /document/body/section[3]/ul/li[1]/text()[11] . ---- Removed: /document/body/section[3]/ul/li[2] <li> (null) ---- Removed: /document/body/section[3]/ul/li[2]/text() Log in to the Zones server. ---- Removed: /document/body/section[3]/ul/li[3] <li> (null) ---- Removed: /document/body/section[3]/ul/li[3]/text() Execute the following commands: ---- Removed: /document/body/section[3]/ul/li[3]/source <source> (null) ---- Removed: /document/body/section[3]/ul/li[3]/source/text() svn up ~/src/lenya-docu/pubs/docu/config/access-control/passwd/cd ~/src/lenya-trunk-docu/./build.sh ---- Added: /document/body/section[3]/ol <ol> (null) ---- Added: /document/body/section[3]/ol/li[1] <li> (null) ---- Added: /document/body/section[3]/ol/li[1]/text()[1] Add your .iml file to the passwd directory to the SVN repository at ---- Added: /document/body/section[3]/ol/li[1]/code <code> (null) ---- Added: /document/body/section[3]/ol/li[1]/code/text() $DOCU_SVN/pubs/docu/config/access-control/passwd/ ---- Added: /document/body/section[3]/ol/li[1]/text()[3] . Don't forget to add you to the groups ---- Added: /document/body/section[3]/ol/li[1]/em[1] <em> (null) ---- Added: /document/body/section[3]/ol/li[1]/em[1]/text() editor ---- Added: /document/body/section[3]/ol/li[1]/text()[5] , ---- Added: /document/body/section[3]/ol/li[1]/em[2] <em> (null) ---- Added: /document/body/section[3]/ol/li[1]/em[2]/text() reviewer ---- Added: /document/body/section[3]/ol/li[1]/text()[7] , ---- Added: /document/body/section[3]/ol/li[1]/em[3] <em> (null) ---- Added: /document/body/section[3]/ol/li[1]/em[3]/text() sitemanager ---- Added: /document/body/section[3]/ol/li[1]/text()[9] , and ---- Added: /document/body/section[3]/ol/li[1]/em[4] <em> (null) ---- Added: /document/body/section[3]/ol/li[1]/em[4]/text() admin ---- Added: /document/body/section[3]/ol/li[1]/text()[11] . ---- Added: /document/body/section[3]/ol/li[2] <li> (null) ---- Added: /document/body/section[3]/ol/li[2]/text() Log in to the Zones server. ---- Added: /document/body/section[3]/ol/li[3] <li> (null) ---- Added: /document/body/section[3]/ol/li[3]/text() Execute the following commands: ---- Added: /document/body/section[3]/ol/li[3]/source <source> (null) ---- Added: /document/body/section[3]/ol/li[3]/source/text() svn up ~/src/lenya-docu/pubs/docu/config/access-control/passwd/cd ~/src/lenya-trunk-docu/./build.sh ---- Removed: /document/body/section[5]/ul[1] <ul> (null) ---- Removed: /document/body/section[5]/ul[1]/li[1] <li> (null) ---- Removed: /document/body/section[5]/ul[1]/li[1]/p <p> (null) ---- Removed: /document/body/section[5]/ul[1]/li[1]/p/text() Log in to the authoring area and make your changes. ---- Removed: /document/body/section[5]/ul[1]/li[2] <li> (null) ---- Removed: /document/body/section[5]/ul[1]/li[2]/p <p> (null) ---- Removed: /document/body/section[5]/ul[1]/li[2]/p/text()[1] Update the SVN changes via the menu item ---- Removed: /document/body/section[5]/ul[1]/li[2]/p/em <em> (null) ---- Removed: /document/body/section[5]/ul[1]/li[2]/p/em/text() File → Update Code Changes ---- Removed: /document/body/section[5]/ul[1]/li[2]/p/text()[3] . This can take a while, depending on the timespan since the last update. ---- Removed: /document/body/section[5]/ul[1]/li[3] <li> (null) ---- Removed: /document/body/section[5]/ul[1]/li[3]/p <p> (null) ---- Removed: /document/body/section[5]/ul[1]/li[3]/p/text() Publish the edited pages, including the SVN change pages. ---- Removed: /document/body/section[5]/ul[1]/li[4] <li> (null) ---- Removed: /document/body/section[5]/ul[1]/li[4]/p <p> (null) ---- Removed: /document/body/section[5]/ul[1]/li[4]/p/text() Dowload the live area to your machine using the following command: ---- Removed: /document/body/section[5]/ul[1]/li[4]/source <source> (null) ---- Removed: /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 ---- Removed: /document/body/section[5]/ul[1]/li[5] <li> (null) ---- Removed: /document/body/section[5]/ul[1]/li[5]/p <p> (null) ---- Removed: /document/body/section[5]/ul[1]/li[5]/p/text() Generate the Javadocs. ---- Removed: /document/body/section[5]/ul[1]/li[6] <li> (null) ---- Removed: /document/body/section[5]/ul[1]/li[6]/p <p> (null) ---- Removed: /document/body/section[5]/ul[1]/li[6]/p/text()[1] Copy the exported pages to ---- Removed: /document/body/section[5]/ul[1]/li[6]/p/code <code> (null) ---- Removed: /document/body/section[5]/ul[1]/li[6]/p/code/text() $SITE_SVN ---- Removed: /document/body/section[5]/ul[1]/li[6]/p/text()[3] . ---- Removed: /document/body/section[5]/ul[1]/li[7] <li> (null) ---- Removed: /document/body/section[5]/ul[1]/li[7]/p <p> (null) ---- Removed: /document/body/section[5]/ul[1]/li[7]/p/text() Commit the changes. ---- Removed: /document/body/section[5]/p[2] <p> (null) ---- Removed: /document/body/section[5]/p[2]/text() 1) edit the documentation src -> lenya.docu ---- Removed: /document/body/section[5]/ul[2] <ul> (null) ---- Removed: /document/body/section[5]/ul[2]/li[1] <li> (null) ---- Removed: /document/body/section[5]/ul[2]/li[1]/code <code> (null) ---- Removed: /document/body/section[5]/ul[2]/li[1]/code/text() cd $lenya.docu; svn up ---- Removed: /document/body/section[5]/ul[2]/li[1]/text() - change to your local checkout of the docu and update it. ---- Removed: /document/body/section[5]/ul[2]/li[2] <li> (null) ---- Removed: /document/body/section[5]/ul[2]/li[2]/text() Follow "Generating changes based on svn"! ---- Removed: /document/body/section[5]/ul[2]/li[3] <li> (null) ---- Removed: /document/body/section[5]/ul[2]/li[3]/text()[1] Run ---- Removed: /document/body/section[5]/ul[2]/li[3]/code[1] <code> (null) ---- Removed: /document/body/section[5]/ul[2]/li[3]/code[1]/text() forrest run ---- Removed: /document/body/section[5]/ul[2]/li[3]/text()[3] locally on your machine. You can now browse the website at ---- Removed: /document/body/section[5]/ul[2]/li[3]/code[2] <code> (null) ---- Removed: /document/body/section[5]/ul[2]/li[3]/code[2]/text() http://localhost:8888/ ---- Removed: /document/body/section[5]/ul[2]/li[3]/text()[5] . ---- Removed: /document/body/section[5]/ul[2]/li[4] <li> (null) ---- Removed: /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] <p> (null) ---- Removed: /document/body/section[5]/p[3]/text() 2) deploy and commit your changes to the documentation src -> lenya.docu ---- Removed: /document/body/section[5]/ul[3] <ul> (null) ---- Removed: /document/body/section[5]/ul[3]/li[1] <li> (null) ---- Removed: /document/body/section[5]/ul[3]/li[1]/text()[1] Run ---- Removed: /document/body/section[5]/ul[3]/li[1]/code[1] <code> (null) ---- Removed: /document/body/section[5]/ul[3]/li[1]/code[1]/text() forrest ---- Removed: /document/body/section[5]/ul[3]/li[1]/text()[3] -> This will create the site in ---- Removed: /document/body/section[5]/ul[3]/li[1]/code[2] <code> (null) ---- Removed: /document/body/section[5]/ul[3]/li[1]/code[2]/text() lenya.docu/build/site ---- Removed: /document/body/section[5]/ul[3]/li[1]/br <br> (null) ---- Removed: /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.) ---- Removed: /document/body/section[5]/ul[3]/li[2] <li> (null) ---- Removed: /document/body/section[5]/ul[3]/li[2]/text()[1] Check in your changes (if you are a committer) ---- Removed: /document/body/section[5]/ul[3]/li[2]/code[1] <code> (null) ---- Removed: /document/body/section[5]/ul[3]/li[2]/code[1]/text() svn ci -m "my changes message" ---- Removed: /document/body/section[5]/ul[3]/li[2]/text()[3] or prepare a patch (if you aren't) ---- Removed: /document/body/section[5]/ul[3]/li[2]/code[2] <code> (null) ---- Removed: /document/body/section[5]/ul[3]/li[2]/code[2]/text() svn diff > patch.txt ---- Removed: /document/body/section[5]/ul[3]/li[2]/text()[5] of ---- Removed: /document/body/section[5]/ul[3]/li[2]/code[3] <code> (null) ---- Removed: /document/body/section[5]/ul[3]/li[2]/code[3]/text() lenya.docu ---- Removed: /document/body/section[5]/p[4] <p> (null) ---- Removed: /document/body/section[5]/p[4]/text() 3) copy deployed changes from the documentation src to the website checkout-> lenya.apache.org ---- Removed: /document/body/section[5]/ul[4] <ul> (null) ---- Removed: /document/body/section[5]/ul[4]/li[1] <li> (null) ---- Removed: /document/body/section[5]/ul[4]/li[1]/code <code> (null) ---- Removed: /document/body/section[5]/ul[4]/li[1]/code/text() cd $lenya.apache.org; svn up ---- Removed: /document/body/section[5]/ul[4]/li[1]/text() - change to your local checkout of the website and update it. ---- Removed: /document/body/section[5]/ul[4]/li[2] <li> (null) ---- Removed: /document/body/section[5]/ul[4]/li[2]/code <code> (null) ---- Removed: /document/body/section[5]/ul[4]/li[2]/code/text() cp -r $lenya.docu/build/site/* . ---- Removed: /document/body/section[5]/ul[4]/li[2]/text() - copy the deployed site from step 2. ---- Removed: /document/body/section[5]/ul[4]/li[3] <li> (null) ---- Removed: /document/body/section[5]/ul[4]/li[3]/text()[1] Create and copy the Javadoc for both branches ( ---- Removed: /document/body/section[5]/ul[4]/li[3]/code[1] <code> (null) ---- Removed: /document/body/section[5]/ul[4]/li[3]/code[1]/text() build javadocs ---- Removed: /document/body/section[5]/ul[4]/li[3]/text()[3] , Copy from ---- Removed: /document/body/section[5]/ul[4]/li[3]/code[2] <code> (null) ---- Removed: /document/body/section[5]/ul[4]/li[3]/code[2]/text() build/webapp/site/apidocs ---- Removed: /document/body/section[5]/ul[4]/li[3]/text()[5] to ---- Removed: /document/body/section[5]/ul[4]/li[3]/code[3] <code> (null) ---- Removed: /document/body/section[5]/ul[4]/li[3]/code[3]/text() lenya/site/apidocs/1.2 ---- Removed: /document/body/section[5]/ul[4]/li[3]/text()[7] and ---- Removed: /document/body/section[5]/ul[4]/li[3]/code[4] <code> (null) ---- Removed: /document/body/section[5]/ul[4]/li[3]/code[4]/text() lenya/site/apidocs/2.0 ---- Removed: /document/body/section[5]/ul[4]/li[3]/text()[9] ) ---- Removed: /document/body/section[5]/ul[4]/li[4] <li> (null) ---- Removed: /document/body/section[5]/ul[4]/li[4]/text()[1] Commit your changes to lenya.apache.org ---- Removed: /document/body/section[5]/ul[4]/li[4]/code <code> (null) ---- Removed: /document/body/section[5]/ul[4]/li[4]/code/text() svn ci -m "my changes message" ---- Removed: /document/body/section[5]/ul[4]/li[4]/text()[3] . ---- Added: /document/body/section[5]/ol <ol> (null) ---- Added: /document/body/section[5]/ol/li[1] <li> (null) ---- Added: /document/body/section[5]/ol/li[1]/p <p> (null) ---- Added: /document/body/section[5]/ol/li[1]/p/text() Log in to the authoring area and make your changes. ---- Added: /document/body/section[5]/ol/li[2] <li> (null) ---- Added: /document/body/section[5]/ol/li[2]/p <p> (null) ---- Added: /document/body/section[5]/ol/li[2]/p/text()[1] Update the SVN changes via the menu item ---- Added: /document/body/section[5]/ol/li[2]/p/em <em> (null) ---- Added: /document/body/section[5]/ol/li[2]/p/em/text() File → Update Code Changes ---- Added: /document/body/section[5]/ol/li[2]/p/text()[3] . This can take a while, depending on the timespan since the last update. ---- Added: /document/body/section[5]/ol/li[3] <li> (null) ---- Added: /document/body/section[5]/ol/li[3]/p <p> (null) ---- Added: /document/body/section[5]/ol/li[3]/p/text() Publish the edited pages, including the SVN change pages. ---- Added: /document/body/section[5]/ol/li[4] <li> (null) ---- Added: /document/body/section[5]/ol/li[4]/p <p> (null) ---- Added: /document/body/section[5]/ol/li[4]/p/text() Dowload the live area to your machine using the following command: ---- Added: /document/body/section[5]/ol/li[4]/source <source> (null) ---- Added: /document/body/section[5]/ol/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]/ol/li[5] <li> (null) ---- Added: /document/body/section[5]/ol/li[5]/p <p> (null) ---- Added: /document/body/section[5]/ol/li[5]/p/text() Create and copy the Javadoc for all branches: ---- Added: /document/body/section[5]/ol/li[5]/source <source> (null) ---- Added: /document/body/section[5]/ol/li[5]/source/text() cd $LENYA_HOME_{$VERSION}./build.sh javadocscp build/webapp/site/apidocs/* $SITE_SVN/apidocs/{$VERSION}/ ---- Added: /document/body/section[5]/ol/li[6] <li> (null) ---- Added: /document/body/section[5]/ol/li[6]/p <p> (null) ---- Added: /document/body/section[5]/ol/li[6]/p/text()[1] Copy the exported pages to ---- Added: /document/body/section[5]/ol/li[6]/p/code <code> (null) ---- Added: /document/body/section[5]/ol/li[6]/p/code/text() $SITE_SVN ---- Added: /document/body/section[5]/ol/li[6]/p/text()[3] . ---- Added: /document/body/section[5]/ol/li[7] <li> (null) ---- Added: /document/body/section[5]/ol/li[7]/p <p> (null) ---- Added: /document/body/section[5]/ol/li[7]/p/text()[1] Commit the changes to ---- Added: /document/body/section[5]/ol/li[7]/p/code <code> (null) ---- Added: /document/body/section[5]/ol/li[7]/p/code/text() $SITE_SVN ---- Added: /document/body/section[5]/ol/li[7]/p/text()[3] . ---- Removed: /document/body/section[6]/title/text() Let forrestbot help you ---- Added: /document/body/section[6]/title/text() Updating the Apache httpd Server on people.apache.org ---- Removed: /document/body/section[6]/p[1]/text()[1] If you are looking into a way to short the steps described in the ---- Removed: /document/body/section[6]/p[1]/a <a> (null) ---- Removed: /document/body/section[6]/p[1]/a/@href [attr] href=#trip (null) ---- Removed: /document/body/section[6]/p[1]/a/text() Roundtrip website update ---- Removed: /document/body/section[6]/p[1]/text()[3] , then do the following (please still test your changes first). ---- Added: /document/body/section[6]/p[1]/text()[1] There is a cron job on people which will do ---- Added: /document/body/section[6]/p[1]/code[1] <code> (null) ---- Added: /document/body/section[6]/p[1]/code[1]/text() svn update ---- Added: /document/body/section[6]/p[1]/text()[3] in the server ---- Added: /document/body/section[6]/p[1]/code[2] <code> (null) ---- Added: /document/body/section[6]/p[1]/code[2]/text() lenya.apache.org ---- Added: /document/body/section[6]/p[1]/text()[5] directory every 24 hours (see ---- Added: /document/body/section[6]/p[1]/code[3] <code> (null) ---- Added: /document/body/section[6]/p[1]/code[3]/text() /x1/home/thorsten/thorsten.ct ---- Added: /document/body/section[6]/p[1]/text()[7] ). If you want to invoke the script manually then ... ---- Removed: /document/body/section[6]/p[2] <p> (null) ---- Removed: /document/body/section[6]/p[2]/text() Do once, create $lenya.docu/deploy.svn.settings file. These credentials are needed by forrestbot so that it can do your 'svn add' and 'svn commit' etc. to the lenya/site/ repository. The deploy.svn.settings file looks like: ---- Removed: /document/body/section[6]/source[1]/text() <?xml version="1.0"?><project> <property name="deploy.svn.user" value="myApacheUsername"/> <property name="deploy.svn.password" value="myPassword"/></project> ---- Added: /document/body/section[6]/source[1]/text() ssh people.apache.org/x1/home/thorsten/bin/lenya-update.sh ---- Removed: /document/body/section[6]/p[3]/text() Generating and publishing the main docs is very easy using a local forrestbot: ---- Added: /document/body/section[6]/p[2]/text() Alternatively you can do the following (this is basically what the script does): ---- Removed: /document/body/section[6]/source[2]/text() cd $lenya.docuforrest -f publish.xml buildforrest -f publish.xml deploy ---- Added: /document/body/section[6]/source[2]/text() ssh people.apache.orgcd /www/lenya.apache.orgumask 0002svn update ---- Removed: /document/body/section[6]/p[4] <p> (null) ---- Removed: /document/body/section[6]/p[4]/text()[1] This builds the documentation locally then deploys it by committing it to the ---- Removed: /document/body/section[6]/p[4]/a <a> (null) ---- Removed: /document/body/section[6]/p[4]/a/@href [attr] href=https://svn.apache.org/repos/asf/lenya/site (null) ---- Removed: /document/body/section[6]/p[4]/a/text() lenya/site SVN ---- Removed: /document/body/section[6]/p[4]/text()[3] . Then a cronjob on the server will automatically publish it (see next section). ---- Removed: /document/body/section[6]/p[5] <p> (null) ---- Removed: /document/body/section[6]/p[5]/text() You can use a similar script we are using on the zones server in $lenya.docu. ---- Removed: /document/body/section[6]/source[3] <source> (null) ---- Removed: /document/body/section[6]/source[3]/@space [attr] space=preserve (http://www.w3.org/XML/1998/namespace) ---- Removed: /document/body/section[6]/source[3]/text() #!/bin/bashsvn upsource SVN-HEAD-REV.txtsvn log -r $LAST:HEAD -v --xml http://svn.apache.org/repos/asf/lenya > src/documentation/content/svn-log/tlp-HEAD.svn.xmlforrest -f publish.xml buildforrest -f publish.xml deploy ---- Removed: /document/body/section[7] <section> (null) ---- Removed: /document/body/section[7]/title <title> (null) ---- Removed: /document/body/section[7]/title/text() Update of the Apache httpd server on people.apache.org ---- Removed: /document/body/section[7]/p[1] <p> (null) ---- Removed: /document/body/section[7]/p[1]/text()[1] There is a cron job on people which will do 'svn update' in the server ---- Removed: /document/body/section[7]/p[1]/code <code> (null) ---- Removed: /document/body/section[7]/p[1]/code/text() lenya.apache.org ---- Removed: /document/body/section[7]/p[1]/text()[3] direvery 24 hours (see /x1/home/thorsten/thorsten.ct). If you want to invoke the script manually then ... ---- Removed: /document/body/section[7]/source[1] <source> (null) ---- Removed: /document/body/section[7]/source[1]/@space [attr] space=preserve (http://www.w3.org/XML/1998/namespace) ---- Removed: /document/body/section[7]/source[1]/text() ssh people.apache.org/x1/home/thorsten/bin/lenya-update.sh ---- Removed: /document/body/section[7]/p[2] <p> (null) ---- Removed: /document/body/section[7]/p[2]/text() Alternatively you can do the following (this is basicly what the script does). ---- Removed: /document/body/section[7]/source[2] <source> (null) ---- Removed: /document/body/section[7]/source[2]/@space [attr] space=preserve (http://www.w3.org/XML/1998/namespace) ---- Removed: /document/body/section[7]/source[2]/text() ssh people.apache.orgcd /www/lenya.apache.orgumask 0002svn update ---- --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]