Changeset 35159

Timestamp:

2021-05-04T17:46:34+12:00 (3 years ago)

Author:

davidb

Message:

Initial set of draft notes for the two different README files on BUILDING

Location:

main/trunk/model-sites-dev/eurovision-lod

Files:

• BUILDING-FROM-IMPORT.txt (added)
• BUILDING-FROM-SCRATCH.txt (added)
• BUILDING.txt (modified) (1 diff)

main/trunk/model-sites-dev/eurovision-lod/BUILDING.txt

@@ -2 +2 @@
 | Eurovision -- Let it Sparkle/Sparql |
 =======================================
-| Preparing and Building ESC content  |
+| Building Overview                   |
 ---------------------------------------
 
---
-1. Go to your Greenstone3 home directory
---
+Even after configuring Greenstone, the nature of this Linked Open Data
+based collection, means there is still a bit of work to do in building
+it into a fully functioning collection.  Consquently we have broken
+the Building instructions down into two steps:
 
-[Skip if you have already done previously]
+In:
 
-  source ./gs3-setup.sh
+  BUILDING-FROM-IMPORT.txt
 
+we start at the simpler proposition of building the 'eurovision' collection
+assuming we have all the data we need already prepared and located in
+the collection 'import' folder.
 
---
-2.Go to your eurovision collection directory
---
+In:
+  BUILDING-FROM-SCRATCH.txt
 
-For example:
+we start a stage earlier, and detail how to setup and run the 'prepare'
+stage.  Amongst other things this retrieves the Eurovision data from DBpedia,
+and unpacks and processes the voting data spreadsheet into a format that
+Greenstone can ingest.
 
-  cd $GSDL3SRCHOME/web/sites/eurovision-lod/collet/eurovision
-
---
-3. Setup collection/site config settings and unpack import files
---
-
-Create a suitable _local_collect_config.sh file from its '.in' counterpart:
-
-  cp _local_collect_config.sh.in _local_collect_config.sh
-
-For the servlet.xml values previously set (CONFIGURE.txt) no further
-editing of  _local_collect_config.sh is needed.
-
-
---
-4. Set the public facing URL for the SPARQL endpoint
---
-
-  If you are operating a remote server for the DL install (i.e. not localhost)
-  then there are 3 places you need edit to specify the domain name (or IP number)
-  you are using:
-
-  In the following we assume the domain name of the server is 'mydomain.org'
-  
-
-4.1:Edit js/eurovision.js
-
-  Near the bottom of this JavaScript file, find the line:
-
-    var endpoint_url="//localhost:4040/greenstone/query"; // **** External IP? ****
-
-  And change to:
-
-    var endpoint_url="//mydomain.org:4040/greenstone/query"; // **** External IP? ****
-    
-
-4.2: Edit transform/layout/header.xsl
-
-Change:
-
-  <xsl:variable name="sparqlEndpointHostAndOptPort">localhost:4040</xsl:variable> <!-- **** External IP? ****-->
-  <xsl:variable name="sparqlGraphBasePrefix">http://127.0.0.1:8383</xsl:variable>
-
-  <xsl:variable name="sparqlEndpointPrefix3"></xsl:variable>
-  <xsl:variable name="sparqlEndpoint3">http://localhost:4040</xsl:variable>       <!-- **** External IP ? **** -->
-
-To:
-  <xsl:variable name="sparqlEndpointHostAndOptPort">mydomain.org:4040</xsl:variable> <!-- **** External IP? ****-->
-  <xsl:variable name="sparqlGraphBasePrefix">http://127.0.0.1:8383</xsl:variable>
-
-  <xsl:variable name="sparqlEndpointPrefix3"></xsl:variable>
-  <xsl:variable name="sparqlEndpoint3">http://mydomain.org:4040</xsl:variable>       <!-- **** External IP ? **** -->
-
-
---
-5. Download and untar a copy of the import folder
---
-  [Fast Build Version: TLDR]
-
-  wget https://so-we-must-think.space/greenstone3/sites/eurovision-lod/collect/eurovision/import.tar.gz
-  tar xvzf import.tar.gz
-
-  export FULL_GREENSTONE_URL_PREFIX=http://mydomain.org/greenstone3/library
-
-  ./FULL-REBUILD.sh
-