Author: reto
Date: Thu Jun 16 14:21:08 2011
New Revision: 1136451
URL: http://svn.apache.org/viewvc?rev=1136451&view=rev
Log:
Made readme simpler and moved troublesooting hints to a dedicated file
Added:
incubator/clerezza/site/trunk/troubleshooting.txt
Modified:
incubator/clerezza/site/trunk/readme.txt
Modified: incubator/clerezza/site/trunk/readme.txt
URL:
http://svn.apache.org/viewvc/incubator/clerezza/site/trunk/readme.txt?rev=1136451&r1=1136450&r2=1136451&view=diff
==============================================================================
--- incubator/clerezza/site/trunk/readme.txt (original)
+++ incubator/clerezza/site/trunk/readme.txt Thu Jun 16 14:21:08 2011
@@ -1,30 +1,13 @@
+Editing and deploying the clerezza website
+
- start clerezza on localhost:8080
- install the directoty with the site project (the directory containing this
readme) with: Dev load "/path/to/apache/clerezza/site/trunk"
-- if all goes well you'll now see the contents of the clerezza site on your
local instance, the content-graph is regularly written to the graph.nt file
+
+- you'll now see the contents of the clerezza site on your local instance, the
content-graph is regularly written to the graph.nt file
+
- change the site as needed, do not create pages ending with /, create a page
ending with /index instead, the entry page is http://localhost:8080/index (you
may open http://localhost:8080/tools/editor with firefox to edit it)
+
- commit the changed graph.nt to subversion
-Currently the site isn't deployed automatically on commit so it is necessary
to upload the generated site, this can be done by
-either:
- execute the deploy.sh script
-
-or manually:
-- retrieve a zipped offline version from
http://localhost:8080/admin/offline/download?baseUri=http://localhost:8080/&targetUri=http://incubator.apache.org/clerezza/&formatExtension=xhtml&formatExtension=rdf&formatExtension=png&formatExtension=html&formatExtension=js&formatExtension=jpeg&rootLinkPrefix=/clerezza
-- scp site<id>.zip people.apache.org:/www/incubator.apache.org/clerezza
-- on people.apache.org: unzip -o site<id>.zip
-
-
-NOTES:
-- as the documentation at /documentation is not a resource in rdf it wasn't
-contained in the oflline site, so I added a resource with that URI
-- to have the content of index-resources displayed on localhost you need to
create the respective collection, otherwise the resource can only be accessed
with the URI ending with "/index". This can be done on the clerzza shell as
follows:
-
-
-import rdf.core._
-import rdf.core.impl._
-import rdf.ontologies._
-import platform.graphprovider.content.ContentGraphProvider
-val cgp = $[ContentGraphProvider]
-val cg = cgp.getContentGraph
-cg.add(new TripleImpl(new UriRef("http://localhost:8080/downloads/";),
RDF.`type`, HIERARCHY.Collection))
Added: incubator/clerezza/site/trunk/troubleshooting.txt
URL:
http://svn.apache.org/viewvc/incubator/clerezza/site/trunk/troubleshooting.txt?rev=1136451&view=auto
==============================================================================
--- incubator/clerezza/site/trunk/troubleshooting.txt (added)
+++ incubator/clerezza/site/trunk/troubleshooting.txt Thu Jun 16 14:21:08 2011
@@ -0,0 +1,27 @@
+Troubleshooting
+
+If things don't just work as described in the readme.
+
+Getting the content graph manually:
+- curl -u admin:admin -H "Accept: text/rdf+nt"
http://localhost:8080/graph?name=urn:x-localinstance:/content.graph > graph.nt
+
+Manually deploying:
+- retrieve a zipped offline version from
http://localhost:8080/admin/offline/download?baseUri=http://localhost:8080/&targetUri=http://incubator.apache.org/clerezza/&formatExtension=xhtml&formatExtension=rdf&formatExtension=png&formatExtension=html&formatExtension=js&formatExtension=jpeg&rootLinkPrefix=/clerezza
+- scp site<id>.zip people.apache.org:/www/incubator.apache.org/clerezza
+- on people.apache.org: unzip -o site<id>.zip
+
+
+NOTES:
+- as the documentation at /documentation is not a resource in rdf it wasn't
+contained in the oflline site, so I added a resource with that URI
+- to have the content of index-resources displayed on localhost you need to
create the respective collection, otherwise the resource can only be accessed
with the URI ending with "/index". This can be done on the clerzza shell as
follows:
+
+
+import rdf.core._
+import rdf.core.impl._
+import rdf.ontologies._
+import platform.graphprovider.content.ContentGraphProvider
+val cgp = $[ContentGraphProvider]
+val cg = cgp.getContentGraph
+cg.add(new TripleImpl(new UriRef("http://localhost:8080/downloads/";),
RDF.`type`, HIERARCHY.Collection))
+
