Changes between Version 7 and Version 8 of InstallationInstructions

Timestamp:

11/06/06 13:11:01 (17 years ago)

Author:

schwarz

Comment:

Starting to work on the installation instructions - there will be more editing and commits in the next hours...

InstallationInstructions

@@ +1 @@
+== Short installation overview ==
+
 Check out the same/similar set of files using SVN:
 {{{
@@ -11 +13 @@
 Well, and you MUST have a FOAF file for rdfhomepage to work!
 
-You may want to check out the rdfhomepage package (in particular, if you are not a DFKI worker):
+You may want to check out the whole rdfhomepage package -- if you are NOT a DFKI worker, you MUST do that:
 {{{
 cd ~homer/public_html/whereever/
@@ -17 +19 @@
 }}}
 The rdfhomepage package also contains a directory myrdfhomepage providing you with some initial files you can use to view, edit, and replace.
+Copy or move the contents (not the folder!) of the myrdfhomepage/ directory to your public html space.
+
+
+----
+== Longer installation instructions ==
+
+=== FOAF / RDF ===
+
+First of all: You MUST have a FOAF file for rdfhomepage to work! [[BR]]
+But: Care has to be taken when creating a FOAF file.
+
+There are a lot of tools out there for creation and management of your foaf file, however, (nearly) all of them produce a more or less crappy/ugly/bad/impractical RDF file. I am sorry, but I must advise to use a text editor for that concern. If you adapt  the foaf RDFS to contain the right domain and range constraints, then Protege may also be useful, but a text editor together with disciplined(!) indentation is the best, fastest and easiest way. [[BR]]
+The easiest way to come up with a good foaf file is to copy mine: http://www.dfki.uni-kl.de/~schwarz/foaf.xml open it in some text editor and edit everything ;)
+
+For all RDF files to be used in rdfhomepage you have to follow the following rules (btw, you should follow these rules for all software using RDF). This holds especially for your FOAF file:
+
+ * Resources to be referenced from outside the RDF file need a URI => Your foaf:Person needs a URI.
+ * Blank/anonymous nodes can't be referenced from outside the RDF file. => Your foaf:Person needs a URI, no blank/anonymous node! So: don't use nodeID="...", but use rdf:about="...".
+ * Some (most!) RDF parsers do not like relative URIs (or NodeIDs). => It is generally better to use ABSOLUTE URIs. So: don't use rdf:about="#me" in your foaf file, better use something like rdf:about="http://www.dfki.uni-kl.de/~schwarz/foaf.xml#me".
+ * Generally, every thing described in an RDF file, that could be relevant and/or referenced outside the RDF file, should have an absolute URI. However, the foaf:Persons I link with foaf:knows do not have a URI, because so many people out there do not have a URI for their foaf:Person.
+
+If you have a FOAF file and a foaf description of your foaf:Person, then the URI of that foaf:Person has to set in your config.php file.