Hi folks, below is the description how I currently update the main section of our website. Since it'll be a while until we have good documentation, I feel this info should be collected in a mail at least. Only committers can deploy the site, but everybody is welcome to contribute patches.
Preconditions: - Subversion - Maven 2 (always use with -N here!) - for deployment: ssh access to people.apache.org (I'm assuming a DSA authentication setup) Preparation: - check out the 'project' directory from SVN: svn co https://svn.apache.org/repos/asf/httpcomponents/project/ (or project-trunk to get the components as well) - for deployment, your ~/.m2/settings.xml must contain this section, with your own username of course: <servers> <server> <id>apache.website</id> <username>rolandw</username> <privateKey>${usr.home}/.ssh/id_dsa</privateKey> <filePermissions>664</filePermissions> <directoryPermissions>775</directoryPermissions> <configuration></configuration> </server> </servers> Change and Review: - update src/site/site.xml and src/site/apt/ as required - regenerate the site locally: mvn -N site:site - if you modify site.xml, clean before regenerating: mvn -N clean site:site - review the result in the target/site/ directory Patch: - change to the 'project' directory - if you are a committer, apply the changes to SVN: svn commit -m "..." - if you are not a committer, prepare the patch: svn diff > site-patch-xxx.txt Attach the patch to a JIRA issue or post it to [EMAIL PROTECTED] Deployment (committers only): - open one terminal on your local machine to trigger the deployment, and a second on people.apache.org to fix the permissions afterwards - on people.a.o, change to /www/hc.apache.org/ and prepare the command: chmod a+x downloads.cgi - on your local machine, trigger site deployment: mvn -N site:deploy Make sure nobody is watching you. Maven will ask for your private key phrase, and displays your input as plain text in the terminal. - on people.a.o, execute the command prepared above: chmod a+x downloads.cgi cheers, Roland --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
