[CONF] Apache Connectors Framework > Updating the Website

[co...@apache.org]

Space: Apache Connectors Framework (https://cwiki.apache.org/confluence/display/CONNECTORS)
Page: Updating the Website (https://cwiki.apache.org/confluence/display/CONNECTORS/Updating+the+Website)


Edited by Karl Wright:
---------------------------------------------------------------------
h1. How To Update The ManifoldCF Website

(*NOTE:* _You need committer rights to modify the Website._)

# Install ant.
# Install an svn client.
# Make sure you have write permissions on the directory where Apache Forrest will be checked out and installed, the first time your run Forrest it will attempt to create a plug-ins directory and download several plug-ins.
# Check out and prepare to build the current trunk version of Apache Forrest: {code}svn co http://svn.apache.org/repos/asf/forrest/trunk forrest{code} (Or, if you want to save time, just install Forrest-0.9 or above.)
# Change to the main build area: {code}cd forrest/main{code}
# Build forrest: {code}build{code}
# Follow the instructions the build gives you to complete the Forrest installation
# Checkout the ManifoldCF site code [https://svn.apache.org/repos/asf/incubator/lcf/trunk/site/].
# Change directory to where it was checked out.
# Run forrest to build current version of documentation to make sure that Forrest was correctly installed. The generated site will be in ./build/site/.
# Make your desired website changes to the source files in ./src/ and regenerate the site with forrest.
# Run "forrest run" and browse to http://localhost:8888 to review the changes. You should be able to modify the source documents and hit reload on your browser without rebuilding the site.

When you are satisfied with your changes, and want to push them out to the main site mirror, do the following:

# Commit your changes to trunk.
# Regenerate the site with forrest by running "forrest site".
# Check out the site mirror into a different workarea [https://svn.apache.org/repos/asf/incubator/lcf/site/].
# *(recursively) copy ./build/site/\* to <your_new_area>/publish.
# Make sure all new files in the publish area have been svn added to the publish area, and remove any that have gone away.
# Commit your changes to site.
# The site will automatically be exported from svn by a script running in Karl's crontab on p.a.o on a nightly basis:
        04 4 * * * /home/kwright/bin/update-mcf-site.sh > /home/kwright/mcf-site-update.log 2>&1


Change your notification preferences: https://cwiki.apache.org/confluence/users/viewnotifications.action