Round 2 of updates

Author: stumbo

config/_default/hugo.toml renamed to config/_default/hugo.yaml

@@ -2,43 +2,43 @@
 #
 # Hugo parameters for Interlisp.org
 #
+# An overview of hugo configuration files can be found at:
+#  https://gohugo.io/getting-started/configuration/#configure-server
+#
 
-relativeURLs = true
-canonifyURLs = true
+# relativeURLs: Enable to force all relative URLs to be relative to content root
+relativeURLs: true
 
-enableRobotsTXT = true
+# canonifyURLs: Convert relative URLs to absolute URLs
+canonifyURLs: true
 
-assetDir = "static"
+# enableRobotsTXT:  Enable generation of Robots.txt file
+enableRobotsTXT: true
 
-# ****************************************************************************
-#
-# Docsy
-#
+# aasetDir:  Location where Hugo looks for assets
+assetDir: static
 
-# Will give values to .Lastmod etc.
-# enableGitInfo = true
+# Enable .GitInfo object for each page.  This will give values to .Lastmod etc.
+enableGitInfo: false
 
-# Language settings
-defaultContentLanguage = "en"
-defaultContentLanguageInSubdir = false
+# Top Level Language defaults 
+#  See languages.yaml for language specific values
+defaultContentLanguage: "en"
+defaultContentLanguageInSubdir: false
 
 # Useful when translating.
-enableMissingTranslationPlaceholders = true
+enableMissingTranslationPlaceholders: true
 
-disableKinds = ["taxonomy", "taxonomyTerm", "RSS"]
+# Disable rendering of the specified page kinds 
+disableKinds: [taxonomy, term, RSS]
 
-# Highlighting config
-pygmentsCodeFences = true
-pygmentsUseClasses = false
+# Code Highlighting configuration 
+pygmentsCodeFences: true
+pygmentsUseClasses: false
 # Use the new Chroma Go highlighter in Hugo.
-pygmentsUseClassic = false
+pygmentsUseClassic: false
 #pygmentsOptions = "linenos=table"
 # See https://help.farbox.com/pygments.html
-pygmentsStyle = "tango"
-
-# Configure how URLs look like per section.
-[permalinks]
-blog = "/:section/:year/:month/:day/:slug/"
 
 # ****************************************************************************
 #
@@ -49,34 +49,31 @@ blog = "/:section/:year/:month/:day/:slug/"
 # [outputs]
 # section = ["HTML", "print"]
 
-[params]
-
-# privacy_policy = "https://policies.google.com/privacy"
+# paramas
 
 # Set Google Analytics to use GA4
-disableGtagForUniversalAnalytics = false
-
+disableGtagForUniversalAnalytics: false
 
 # First one is picked as the Twitter card image if not set on page.
 # images = ["images/project-illustration.png"]
 
 # Menu title if your navbar has a versions selector to access old versions of your site.
 # This menu appears only if you have at least one [params.versions] set.
-version_menu = "Releases"
+version_menu: Releases
 
 # Flag used in the "version-banner" partial to decide whether to display a 
 # banner on every page indicating that this is an archived version of the docs.
 # Set this flag to "true" if you want to display the banner.
-archived_version = false
+archived_version: false
 
 # The version number for the version of the docs represented in this doc set.
 # Used in the "version-banner" partial to display a version number for the 
 # current doc set.
-version = "0.0"
+version: 0.0
 
 # A link to latest version of the docs. Used in the "version-banner" partial to
 # point people to the main doc site.
-url_latest_version = "https://example.com"
+url_latest_version: https://example.com
 
 # Enable Algolia DocSearch
 #algolia_docsearch = false
@@ -86,5 +83,5 @@ url_latest_version = "https://example.com"
 
 # Enable syntax highlighting and copy buttons on code blocks with Prism
 # Default "Chroma" syntax highlighter has no dot support, so use Prism instead
-prism_syntax_highlighting = false
+prism_syntax_highlighting: false
 

config/_default/languages.yaml

@@ -2,6 +2,8 @@
 #
 # Language configuration
 #
+# See:  https://gohugo.io/content-management/multilingual/
+#
 en:
   description: "Dedicated to restoring and preserving the Interlisp experience"
   languageName: English"

config/_default/params.yaml

@@ -1,15 +1,39 @@
+# --------------------------------------------------------------------
+#
 # Parameters
+#
+#  copyright:  site copyright information
+#    authors:  text list of authors
+#    from_year:  year in copyright statement
+#
 copyright: 
   authors: Interlisp.org
   from_year: 2024
 
+# github information
+#  github_repo:  url to repo of web site
+#  github_branch:  main branch of repo
+#  github_subdir:  unused by Interlisp.org
+#  github_project_repo: added by Interlisp.org points to repo used
+#                       for issue reporting
+#  
 github_repo: https://github.com/interlisp/Interlisp.github.io
 github_branch: main
-github_project_repo: https://github.com/interlisp/medley
 github_subdir: 
+github_project_repo: https://github.com/interlisp/medley
+
+# Google custom seach engine configuration
+#  gcs_engine_id:  search engine 
 gcs_engine_id: 33ef4cbe0703b4f3a
 
-# End user relevant links. These will show up on left side of footer and in the community page if you have one.
+# Footer Links
+# 
+# user:  End user relevant links. These will show up on 
+#        left side of footer and in the community page if you have one.
+#   name: displayed when moused over
+#   url:  url to use when selected
+#   desc: description
+#   icon:  icon to display
 links:
   user:
   - name: "User mailing list"
@@ -25,7 +49,8 @@ links:
 #   icon: "fab fa-stack-overflow"
 #   desc: "Practical questions and curated answers"
 
-# Developer relevant links. These will show up on right side of footer and in the community page if you have one.
+# developer:  Developer relevant links. These will show up on right 
+#             side of footer and in the community page if you have one.
   developer:
   - name: "On GitHub"
     url: "https://github.com/interlisp"
@@ -44,14 +69,23 @@ taxonomy:
 # Nothing defined
 
 # User Interface Configuration options
+#
+# feedback:
+#   Adds a H2 section titled "Feedback" to the bottom of each doc. The responses 
+#   are sent to Google Analytics as events.  This feature depends 
+#   on [services.googleAnalytics] and will be disabled if 
+#   "services.googleAnalytics.id" is not set.
+#
+#   If you want this feature, but occasionally need to remove the 
+#   "Feedback" section from a single page,
+#   add "hide_feedback: true" to the page's front matter.
+#    enable:  boolean Turn feedback
+#    yes: text to display with yes is selected
+#    no: text to display when no is selected
+
 ui:
-  # Adds a H2 section titled "Feedback" to the bottom of each doc. The responses are sent to Google Analytics as events.
-  # This feature depends on [services.googleAnalytics] and will be disabled if "services.googleAnalytics.id" is not set.
-  # If you want this feature, but occasionally need to remove the "Feedback" section from a single page,
-  # add "hide_feedback: true" to the page's front matter.
   feedback:
     enable: true
-    # The responses that the user sees after clicking "yes" (the page was helpful) or "no" (the page was not helpful).
     yes: 'Glad to hear it! Please <a href="https://github.com/Interlisp/medley/issues/new?template=documentation.md&projects=Interlisp/medley/5">tell us how we can improve</a>.'
     no: 'Sorry to hear that. Please <a href="https://github.com/Interlisp/medley/issues/new?template=documentation.md&projects=Interlisp/medley/5">tell us how we can improve</a>.'
 
@@ -73,6 +107,12 @@ ui:
 
   #  Set to true to hide the sidebar search box (the top nav search box will still be displayed if search is enabled)
   sidebar_search_disable: false
+  # Sidebar generation is slow otherwise
+  sidebar_cache_limit: 100
+
+  # We have almost 200 attributes; don't truncate the sidebar to max 50 contents.
+  sidebar_menu_truncate:  1000
+
   #  Set to true to disable breadcrumb navigation.
   breadcrumb_disable: false
 
@@ -81,8 +121,3 @@ ui:
 
   ul_show: 3
 
-  # Sidebar generation is slow otherwise
-  sidebar_cache_limit: 100
-
-  # We have almost 200 attributes; don't truncate the sidebar to max 50 contents.
-  sidebar_menu_truncate:  1000

config/_default/permalinks.yaml

@@ -0,0 +1,9 @@
+# --------------------------------------------------------------------
+# 
+# Permalinks
+# 
+# Define a URL pattern for each top-level section.
+# 
+# see: https://gohugo.io/content-management/urls/#permalinks
+#
+blog: /:section/:year/:month/:day/:slug/

config/_default/privacy.yaml

@@ -0,0 +1,18 @@
+# ------------------------------------------------------------------
+# 
+# Privacy Settings
+#
+# See:  https://gohugo.io/about/hugo-and-gdpr/
+#
+# googleAnalytics:
+#  ananymizIP:  Enable anonymiation of IP addresses
+#  disable:  Set to true to disable googleAnalytics
+#  respectDoNotTrack:  Check for Do Not Track in headers
+#  useSessionStorage:  Store session information in storage and
+#                      not in cookies
+privacy:
+  googleAnalytics:
+    anonymizeIP: true
+    disable: false
+    respectDoNotTrack: true
+    useSessionStorage: true

config/production/config.toml

@@ -0,0 +1 @@
+baseURL: https://interlisp.org