summaryrefslogtreecommitdiffstats
path: root/site/tags/site-090106-pre667/README.txt
diff options
context:
space:
mode:
Diffstat (limited to 'site/tags/site-090106-pre667/README.txt')
-rw-r--r--site/tags/site-090106-pre667/README.txt52
1 files changed, 52 insertions, 0 deletions
diff --git a/site/tags/site-090106-pre667/README.txt b/site/tags/site-090106-pre667/README.txt
new file mode 100644
index 0000000000..353a5cf70d
--- /dev/null
+++ b/site/tags/site-090106-pre667/README.txt
@@ -0,0 +1,52 @@
+Website for the Tuscany project being incubated at Apache.
+==========================================================
+
+Website Howto
+=============
+
+The website is generated by Anakia.
+
+The source documents are in the "site-author" directory.
+The documents to publish are in the "site-publish" directory.
+
+Editing the site
+----------------
+
+If you don't want to RTFM and just patch the website a little:
+
+ -> edit/add files in the site-author/ directory (copy-pasting from existing
+ files is often a good idea)
+ -> install a java runtime environment or development kit
+ -> type './build.sh' on linux/mac/solaris/unix or 'build.bat' on windows
+
+you can now browse the site locally from the site-publish directory. Once you are
+happy with your changes:
+
+ -> manually 'svn add' any files generated in site-publish that weren't there
+ before, or set the 'svn:ignore' property to ignore them. Eg something like
+
+ svn status site-publish | egrep '^\?' | sed -e 's/^\? *//g' | xargs svn add
+
+ may work for you.
+ -> check the generated stuff looks like you want it to. Eg something like
+
+ svn status site-publish | egrep '^(A|M)' | sed -e 's/^[AM] *//g' | xargs open
+
+ may work for you.
+ -> commit.
+
+Publishing the site
+-------------------
+
+The published version of the site lives in the site-publish directory in SVN.
+To make this live, it must first be exported to a staging location on
+people.apache.org and from there it will be replicated to the live servers.
+This replication can take up to four hours so be patient.
+
+To update the site:
+ -> log into people.apache.org
+ $ cd /www/incubator.apache.org/tuscany
+ $ svn update
+
+and wait ...
+