blob: 4444b7551c8a3f915756637de890a866bd54526b [file] [log] [blame]
= Maintaining The Web Site
The web site is built with https://antora.org[Antora] run through https://ci-builds.apache.org[Apache Jenkins CI].
Instructions coming soon.
NOTE: the rest of this page is totally and completely outdated.
It needs to be replaced by instructions for the current site.
== How the Aries web site works
The Aries site is built using CMS.
To edit the site you must be an Aries committer, the ID and password are the same ones as you use for Aries SVN.
The easiest way to edit pages is to install the CMS bookmarklet as described https://cms.apache.org/#bookmark[here]
Navigate to the web page you would like to edit and then click the CMS bookmarklet.
The steps in making a change to the site are:
* Edit
* Submit
* Commit your changes
* Check the 'staged' site
* If the content looks good, publish the site
The Wiki syntax is called Markdown and is documented http://www.freewisdom.org/projects/python-markdown/[here].
Some extensions are installed in the CMS system (eg tables, syntax highlighting).
More information on CMS is available http://wiki.apache.org/general/ApacheCms2010[here]
== Making major changes
Because the site is all in SVN its possible to check it out, make and test changes locally and then check in again much as you woudl with code changes.
To do this you will need:
* A local copy of the cms build tools
* A local setup of Apache
First, checkout the site , like this:
svn co https://svn.apache.org/repos/asf/aries/site/trunk/ site
== To build the site using the build tools.
First check the cms build tools out of SVN:
svn co https://svn.apache.org/repos/infra/websites/cms/build/ buildtools
To run the build_site.pl script you will need to install the Python version of Markup.
The instructions for finding and installing Python pre-reqs are given http://wiki.apache.org/general/ApacheCMSFAQ[here]
Then to build the site use this command:
perl build_site.pl --source-base /path/to/newsite/trunk/ --target-base /path/to/output/
which will create *.html in /path/to/output/content
== Check the site on a local server.
Use a vhost to check the site.
On a Mac this means adding the following stanza to /etc/apache2/extra/httpd-vhosts.conf
<VirtualHost *:80> DocumentRoot "/Users/zoe/Sites/zaries/www" ServerName zaries ErrorLog "/Users/zoe/Sites/zaries/error.log" CustomLog "/Users/zoe/Sites/zaries/access.log" custom
LogLevel debug
</VirtualHost>
To test the site, move it like this:
mv /path/to/output/content /Users/zoe/Sites/zaries/www
Then navigate to http://zaries in a browser.
#Add menuitem Check out the site by using svn co https://svn.apache.org/repos/asf/aries/site/trunk/ site
update the file under templates/navigation.mdtext
check in the changes by using svn commit
The following steps may not needed if the changes were displayed ok.
Navigate to a lower level page in Apache Aries site and click the CMS bookmarklet.
Check the staging page to verify the menuitem is displayed correct.
Publish the site.