Merge branch 'main' into main

Signed-off-by: Larry Masinter <[email protected]>

Author: masinter

README.md

@@ -152,8 +152,21 @@ hugo v0.111.3-5d4eb5154e1fed125ca8e9b5a0315c4180dab192+extended linux/amd64 Buil
 
 Be sure your version is at least `v0.101.0`. Older versions of `hugo` may fail to load correctly.
 
-With `Hugo` successfully installed, change directories to the location where you cloned the `Interlisp.github.io`. Then run `Hugo` using the following
-command:
+Secondly, there is one data file that is required to successfully build and run the `Interlisp.org` website locally, `data/bibliography.json`.
+The production version of the website uses a GitHub Action to retrieve this file.
+We can mimic that functionality by going to the `scripts` directory in your clone of the `Intelisp.github.io` repository.
+Once in the directory, run the following command:
+
+```bash
+./update_bibliography.sh
+```
+
+This script will retrieve the bibliography from our Zotero site, format it appropriately and place the created file
+in the appropriate location, the `data` directory.
+
+This completes all the setup required for `Hugo`.
+
+To run `Hugo` go to the root directory of your repository clone and run the following command:
 
 ```bash
 hugo server
@@ -215,3 +228,30 @@ that have components specific to `Interlisp.github.io` are as follows:
   - `favicons` - contains `favicon.png` a small icon that browsers can use when referencing the website
   - `Resources` - contains the current `Interlisp-D` logo, used on the home page, and another instance of `favicon.png`
   - `CNAME` - a oneline text file that provides support for using a [custom domain](https://gohugo.io/hosting-and-deployment/hosting-on-github/#use-a-custom-domain)
+
+## Search
+
+`Interlisp.org` uses Google Custom Search to provide search results encompassing
+the `Interlisp.org` website, our GitHub sites used for continued development of
+Medley Interlisp, and the discussions groups associated with both the Medley project and
+Interlisp.
+
+The search engine is identified in the `hugo.toml` file:
+
+```toml
+# Google Custom Search Engine ID. Remove or comment out to disable search.
+gcs_engine_id = "33ef4cbe0703b4f3a"
+```
+
+Search results are returned and presented using the page template, `search.md`.
+The page template currently contains only a `yaml` header specifying the
+layout as being `search`.
+
+### Updating Search
+
+Modfying the websites that are searched requires updating the Google Custom
+Search engine settings.  This is done via logging into Google's Programmable Search
+Engine Dashboard at:  [https://programmablesearchengine.google.com](https://programmablesearchengine.google.com)
+
+Access to the Programmable Search Engine Dashboard is restricted.  To suggest updates or changes
+open an issue:  [Search Engine Issue](https://github.com/interlisp/medley/issues/new?template=bug_report.md&title=Search_Engine_Issue)

content/en/_index.html

@@ -4,7 +4,7 @@
  - /hugo
 ---
 
-{{< blocks/cover title="The Medley Interlisp Project" subtitle="A Retrofuturistic Software System" image_anchor="smart" color="orange" height="min">}}
+{{< blocks/cover title="The Medley Interlisp Project" subtitle="a retrofuturistic software system" image_anchor="smart" color="orange" height="min">}}
 <div class="top-summary">
   What did we leave behind on the path to developing today's computer systems? Could there be lessons for the future of computing hidden in the past? Enter the Medley software environment to explore these questions.
 </div>
@@ -35,13 +35,14 @@ <h1>The Interlisp Revival</h1>
 <p>Medley's life as a commercial product ended in the 1990s, and until 2009 its source code only remained in the hands of the development team. Now the system is running again on modern computer systems, thanks to the combined efforts of original developers and interested newcomers. Our goal is to revive Interlisp in language, environment and spirit through the Medley Interlisp Project.</p>
 
 
+<div class="col">
 <h3>What do all these terms mean?</h3>
 <p>With over five decades of history and many design iterations, there are a lot of names and other vocabulary associated with the project. <a href="medley/project/glossary">Visit the glossary</a> to learn more.
 </p>
-
-<h3>Have other questions?</h3><br />
+<h3>Have other questions?</h3>
 <p><a href="medley/project/faqs">Our FAQs page</a> addresses other common queries about the project.</p>
--->
+</div>
+
 <!-- >{{< carousel items="1" height="500" unit="px" duration="7000" >}} -->
 
 {{< /blocks/section >}}

hugo.toml

@@ -1,5 +1,4 @@
-# baseURL = "https://interlisp.org"
-baseURL = "https://phantomics.github.io/InterlispDraft.github.io/"
+baseURL = "https://interlisp.org"
 
 relativeURLs = true
 canonifyURLs = true