From 636a7b7b97d2776b18d0ac06b1f653941e9f23a9 Mon Sep 17 00:00:00 2001 From: lresende Date: Sat, 21 Nov 2009 07:42:15 +0000 Subject: Moving site branches git-svn-id: http://svn.us.apache.org/repos/asf/tuscany@882844 13f79535-47bb-0310-9956-ffa450edef68 --- site/branches/site-20070701-mvnbased/README.txt | 63 +++++++++++++++++++++++++ 1 file changed, 63 insertions(+) create mode 100644 site/branches/site-20070701-mvnbased/README.txt (limited to 'site/branches/site-20070701-mvnbased/README.txt') diff --git a/site/branches/site-20070701-mvnbased/README.txt b/site/branches/site-20070701-mvnbased/README.txt new file mode 100644 index 0000000000..ab75c59993 --- /dev/null +++ b/site/branches/site-20070701-mvnbased/README.txt @@ -0,0 +1,63 @@ +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. + + +Editing Images +-------------- +The programs you will need to edit all the files used on the site are: +1: Inkscape(http://www.inkscape.org/)- Open source vector graphics editor, used for all of the diagrams and a few layout components. +2: The GIMP(http://www.gimp.org/)- Open source bitmap graphics editor, used for most of the site layout components. + +The original sources for most of the images are in the "image-sources" folder. You should be able to edit these files +and export them to the site-author folder so they will be copied over when the site is built. + + +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 ... + -- cgit v1.2.3