From 4f134bca39abab04b3a740c3d47f4cfe09492bbf Mon Sep 17 00:00:00 2001 From: Bill Stumbo Date: Fri, 15 Mar 2024 02:04:23 -0400 Subject: [PATCH 01/14] Rework hugo.toml file. Convert to yaml and break into subsections. Move to config directory. Start setup to support Production and Staged deployments --- config/_default/hugo.toml | 90 ++++++++++ config/_default/imaging.yaml | 9 + config/_default/languages.yaml | 10 ++ config/_default/markup.yaml | 12 ++ config/_default/menu.yaml | 25 +++ config/_default/module.yaml | 11 ++ config/_default/params.yaml | 88 ++++++++++ config/development/server.yaml | 8 + config/production/config.toml | 0 config/production/services.yaml | 7 + config/staging/config.toml | 4 + hugo.toml | 280 -------------------------------- 12 files changed, 264 insertions(+), 280 deletions(-) create mode 100644 config/_default/hugo.toml create mode 100644 config/_default/imaging.yaml create mode 100644 config/_default/languages.yaml create mode 100644 config/_default/markup.yaml create mode 100644 config/_default/menu.yaml create mode 100644 config/_default/module.yaml create mode 100644 config/_default/params.yaml create mode 100644 config/development/server.yaml create mode 100644 config/production/config.toml create mode 100644 config/production/services.yaml create mode 100644 config/staging/config.toml delete mode 100644 hugo.toml diff --git a/config/_default/hugo.toml b/config/_default/hugo.toml new file mode 100644 index 000000000..ed693d2ce --- /dev/null +++ b/config/_default/hugo.toml @@ -0,0 +1,90 @@ +# ******************************************************************* +# +# Hugo parameters for Interlisp.org +# + +relativeURLs = true +canonifyURLs = true + +enableRobotsTXT = true + +assetDir = "static" + +# **************************************************************************** +# +# Docsy +# + +# Will give values to .Lastmod etc. +# enableGitInfo = true + +# Language settings +defaultContentLanguage = "en" +defaultContentLanguageInSubdir = false + +# Useful when translating. +enableMissingTranslationPlaceholders = true + +disableKinds = ["taxonomy", "taxonomyTerm", "RSS"] + +# Highlighting config +pygmentsCodeFences = true +pygmentsUseClasses = false +# Use the new Chroma Go highlighter in Hugo. +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/" + +# **************************************************************************** +# +# Docsy - Everything below this are Site Params +# + +# Comment out if you don't want the "print entire section" link enabled. +# [outputs] +# section = ["HTML", "print"] + +[params] + +# privacy_policy = "https://policies.google.com/privacy" + +# Set Google Analytics to use GA4 +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" + +# 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 + +# 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" + +# 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" + +# Enable Algolia DocSearch +#algolia_docsearch = false + +# Enable Lunr.js offline search +# offlineSearch = true + +# 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 + diff --git a/config/_default/imaging.yaml b/config/_default/imaging.yaml new file mode 100644 index 000000000..404ae9542 --- /dev/null +++ b/config/_default/imaging.yaml @@ -0,0 +1,9 @@ +# **************************************************************************** +# +# Image processing setup +# +# Configuration information available at: +# https://gohugo.io/content-management/image-processing/#resampling-filter +resampleFilter: CatmullRom +quality: 75 +anchor: smart \ No newline at end of file diff --git a/config/_default/languages.yaml b/config/_default/languages.yaml new file mode 100644 index 000000000..eaf5ec369 --- /dev/null +++ b/config/_default/languages.yaml @@ -0,0 +1,10 @@ +# **************************************************************************** +# +# Language configuration +# +en: + description: "Dedicated to restoring and preserving the Interlisp experience" + languageName: English" + # Weight used for sorting. + weight: 1 + contentDir: content/en \ No newline at end of file diff --git a/config/_default/markup.yaml b/config/_default/markup.yaml new file mode 100644 index 000000000..c6c36b606 --- /dev/null +++ b/config/_default/markup.yaml @@ -0,0 +1,12 @@ +# **************************************************************************** +# +# Goldmark markdown processor setup +# +goldmark: + renderer: + unsafe: true +highlight: + # See a complete list of available styles at https://xyproto.github.io/splash/docs/all.html + style: tango + # Uncomment if you want your chosen highlight style used for code blocks without a specified language + # guessSyntax: true \ No newline at end of file diff --git a/config/_default/menu.yaml b/config/_default/menu.yaml new file mode 100644 index 000000000..c9f9a20ae --- /dev/null +++ b/config/_default/menu.yaml @@ -0,0 +1,25 @@ +# **************************************************************************** +# +# Hugo - Top-level navigation (horizontal) +# +main: + - name: GitHub + weight: -10 + pre: + url: https://github.com/interlisp + - name: Get Involved + weight: -30 + pre: + url: /getInvolved/ + - name: Software + weight: -50 + pre: + url: /software/ + - name: Project + weight: -70 + pre: + url: /project/ + - name: History + weight: -90 + pre: "" + url: /history/ \ No newline at end of file diff --git a/config/_default/module.yaml b/config/_default/module.yaml new file mode 100644 index 000000000..1a537f509 --- /dev/null +++ b/config/_default/module.yaml @@ -0,0 +1,11 @@ + proxy: "direct" + # uncomment line below for temporary local development of module + # replacements = "github.com/google/docsy -> ../../docsy" + hugoVersion: + extended: true + min: "0.73.0" + imports: + - path: "github.com/google/docsy" + disable: false + - path: "github.com/google/docsy/dependencies" + disable: false diff --git a/config/_default/params.yaml b/config/_default/params.yaml new file mode 100644 index 000000000..c149da1d7 --- /dev/null +++ b/config/_default/params.yaml @@ -0,0 +1,88 @@ +# Parameters +copyright: + authors: Interlisp.org + from_year: 2024 + +github_repo: https://github.com/interlisp/Interlisp.github.io +github_branch: main +github_project_repo: https://github.com/interlisp/medley +github_subdir: +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. +links: + user: + - name: "User mailing list" + url: "mailto:Interlisp@googlegroups.com" + icon: "fa fa-envelope" + desc: "Discussion and help from your fellow users" + - name: "Twitter" + url: "https://twitter.com/interlisp8" + icon: "fab fa-twitter" + desc: "Follow us on Twitter to get the latest news!" +# - name: "Stack Overflow" +# url: "https://stackoverflow.com/questions/tagged/graphviz" +# 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: + - name: "On GitHub" + url: "https://github.com/interlisp" + icon: "fab fa-github" + desc: "Development takes place here!" +# - name: "Slack" +# url: "https://example.org/slack" +# icon: "fab fa-slack" +# desc: "Chat with other project developers" +# - name: "Developer mailing list" +# url: "https://example.org/mail" +# icon: "fa fa-envelope" +# desc: "Discuss development issues around the project" + +taxonomy: +# Nothing defined + +# User Interface Configuration options +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 tell us how we can improve.' + no: 'Sorry to hear that. Please tell us how we can improve.' + + # Adds a reading time to the top of each doc. + # If you want this feature, but occasionally need to remove the Reading time from a single page, + # add "hide_readingtime: true" to the page's front matter + readingtime: + enable: false + + # Set to false if you don't want to display a logo (/assets/icons/logo.svg) in the top nav bar + navbar_logo: true + + # Turn off transparency in nav bar + navbar_translucent_over_cover_disable: true + + # Enable to show the side bar menu in its compact state. + sidebar_menu_compact: true + sidebar_menu_foldable: true + + # 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 + # Set to true to disable breadcrumb navigation. + breadcrumb_disable: false + + # Set to true to disable the About link in the site footer + footer_about_disable: true + + 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 diff --git a/config/development/server.yaml b/config/development/server.yaml new file mode 100644 index 000000000..253b516c3 --- /dev/null +++ b/config/development/server.yaml @@ -0,0 +1,8 @@ +headers: +- for: /** + values: + Content-Security-Policy: script-src localhost:1313 + Referrer-Policy: strict-origin-when-cross-origin + X-Content-Type-Options: nosniff + X-Frame-Options: DENY + X-XSS-Protection: 1; mode=block \ No newline at end of file diff --git a/config/production/config.toml b/config/production/config.toml new file mode 100644 index 000000000..e69de29bb diff --git a/config/production/services.yaml b/config/production/services.yaml new file mode 100644 index 000000000..643bfbbbe --- /dev/null +++ b/config/production/services.yaml @@ -0,0 +1,7 @@ +# **************************************************************************** +# +# Services Configuration +# +# Comment out the next line to disable GA tracking. Also disables the feature described in [params.ui.feedback]. +googleAnalytics: + id: G-JXK20KN1W1 \ No newline at end of file diff --git a/config/staging/config.toml b/config/staging/config.toml new file mode 100644 index 000000000..a7799165e --- /dev/null +++ b/config/staging/config.toml @@ -0,0 +1,4 @@ +baseURL = "https://wasm.interlisp.org" +languageCode = "en-us" +title = "Staging Environment" +publishDir = "stage" diff --git a/hugo.toml b/hugo.toml deleted file mode 100644 index b45d04e86..000000000 --- a/hugo.toml +++ /dev/null @@ -1,280 +0,0 @@ -baseURL = "https://interlisp.org" - -relativeURLs = true -canonifyURLs = true - -enableRobotsTXT = true - -assetDir = "static" - -# **************************************************************************** -# -# Docsy -# - -# Will give values to .Lastmod etc. -# enableGitInfo = true - -# Language settings -contentDir = "content/en" -defaultContentLanguage = "en" -defaultContentLanguageInSubdir = false - -# Useful when translating. -enableMissingTranslationPlaceholders = true - -disableKinds = ["taxonomy", "taxonomyTerm", "RSS"] - -# **************************************************************************** -# -# Hugo - Top-level navigation (horizontal) -# - -[menu] -# [[menu.main]] -# name = "Download" -# weight = -110 -# pre = "" -# url = "/running/download/" - [[menu.main]] - name = "GitHub" - weight = -10 - pre = "" - url = "https://github.com/interlisp" - [[menu.main]] - name = "Get Involved" - weight = -30 - pre = "" - url = "/getInvolved/" - [[menu.main]] - name = "Software" - weight = -50 - pre = "" - url = "/software/" - [[menu.main]] - name = "Project" - weight = -70 - pre = "" - url = "/project/" - [[menu.main]] - name = "History" - weight = -90 - pre = "" - url = "/history/" - -# Highlighting config -pygmentsCodeFences = true -pygmentsUseClasses = false -# Use the new Chroma Go highlighter in Hugo. -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/" - -# **************************************************************************** -# -# Docsy - Goldmark markdown processor setup -# - -[markup] - [markup.goldmark] - [markup.goldmark.renderer] - unsafe = true - [markup.highlight] - # See a complete list of available styles at https://xyproto.github.io/splash/docs/all.html - style = "tango" - # Uncomment if you want your chosen highlight style used for code blocks without a specified language - # guessSyntax = "true" - -# **************************************************************************** -# -# Docsy - Image processing setup -# - -[imaging] -resampleFilter = "CatmullRom" -quality = 75 -anchor = "smart" - -# **************************************************************************** -# -# Docsy - Services Configuration -# -# Comment out the next line to disable GA tracking. Also disables the feature described in [params.ui.feedback]. -[services] - [services.googleAnalytics] - id = "G-JXK20KN1W1" - -# **************************************************************************** -# -# docsy - Language configuration -# - -[languages] - [languages.en] - description = "Dedicated to restoring and preserving the Interlisp experience" - languageName ="English" - # Weight used for sorting. - weight = 1 - - -[module] - proxy = "direct" - # uncomment line below for temporary local development of module - # replacements = "github.com/google/docsy -> ../../docsy" - [module.hugoVersion] - extended = true - min = "0.73.0" - [[module.imports]] - path = "github.com/google/docsy" - disable = false - [[module.imports]] - path = "github.com/google/docsy/dependencies" - disable = false - -# **************************************************************************** -# -# Docsy - Everything below this are Site Params -# - -# Comment out if you don't want the "print entire section" link enabled. -# [outputs] -# section = ["HTML", "print"] - -[params] -copyright = "Interlisp.org" -# privacy_policy = "https://policies.google.com/privacy" - -# Set Google Analytics to use GA4 -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" - -# 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 - -# 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" - -# 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" - -# Repository configuration (URLs for in-page links to opening issues and suggesting changes) -github_repo = "https://github.com/interlisp/Interlisp.github.io" - -# An optional link to a related project repo. For example, the sibling repository where your product code lives. -github_project_repo = "https://github.com/interlisp/medley" - -# Specify a value here if your content directory is not in your repo's root directory -# github_subdir = "" - -# Uncomment this if you have a newer GitHub repo with "main" as the default branch, -# or specify a new value if you want to reference another branch in your GitHub links -github_branch= "main" - -# Google Custom Search Engine ID. Remove or comment out to disable search. -gcs_engine_id = "33ef4cbe0703b4f3a" - -# 33ef4cbe0703b4f3aa44f7775907034972" - -# Enable Algolia DocSearch -#algolia_docsearch = false - -# Enable Lunr.js offline search -# offlineSearch = true - -# 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 - -# User interface configuration -[params.ui] -# Enable to show the side bar menu in its compact state. -sidebar_menu_compact = true -# Set to true to disable breadcrumb navigation. -breadcrumb_disable = false -# 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 -# Set to false if you don't want to display a logo (/assets/icons/logo.svg) in the top nav bar -navbar_logo = true -# Set to true to disable the About link in the site footer -footer_about_disable = true # false -# Turn off transparency in nav bar -navbar_translucent_over_cover_disable = true - -# We have almost 200 attributes; don't truncate the sidebar to max 50 contents. -sidebar_menu_truncate = 1000 - -# Sidebar generation is slow otherwise -sidebar_cache_limit = 100 - -ul_show = 3 - -# 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. -[params.ui.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 tell us how we can improve.' -no = 'Sorry to hear that. Please tell us how we can improve.' - -# Adds a reading time to the top of each doc. -# If you want this feature, but occasionally need to remove the Reading time from a single page, -# add "hide_readingtime: true" to the page's front matter -[params.ui.readingtime] -enable = false - -[params.taxonomy] - -# Links in footer - -[params.links] -# End user relevant links. These will show up on left side of footer and in the community page if you have one. -[[params.links.user]] - name = "User mailing list" - url = "mailto:Interlisp@googlegroups.com" - icon = "fa fa-envelope" - desc = "Discussion and help from your fellow users" -[[params.links.user]] - name ="Twitter" - url = "https://twitter.com/interlisp8" - icon = "fab fa-twitter" - desc = "Follow us on Twitter to get the latest news!" -# [[params.links.user]] -# name = "Stack Overflow" -# url = "https://stackoverflow.com/questions/tagged/graphviz" -# 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. -[[params.links.developer]] - name = "On GitHub" - url = "https://github.com/interlisp" - icon = "fab fa-github" - desc = "Development takes place here!" -# [[params.links.developer]] -# name = "Slack" -# url = "https://example.org/slack" -# icon = "fab fa-slack" -# desc = "Chat with other project developers" -# [[params.links.developer]] -# name = "Developer mailing list" -# url = "https://example.org/mail" -# icon = "fa fa-envelope" -# desc = "Discuss development issues around the project" From 4eabd13b54c70d840b62243d15163ed7d3fb40f2 Mon Sep 17 00:00:00 2001 From: Bill Stumbo Date: Fri, 15 Mar 2024 17:32:02 -0400 Subject: [PATCH 02/14] Round 2 of updates --- config/_default/{hugo.toml => hugo.yaml} | 65 +++++++++++------------ config/_default/languages.yaml | 2 + config/_default/params.yaml | 61 ++++++++++++++++----- config/_default/permalinks.yaml | 9 ++++ config/_default/privacy.yaml | 18 +++++++ config/production/config.toml | 0 config/production/hugo.yaml | 1 + config/staging/{config.toml => hugo.yaml} | 0 8 files changed, 109 insertions(+), 47 deletions(-) rename config/_default/{hugo.toml => hugo.yaml} (58%) create mode 100644 config/_default/permalinks.yaml create mode 100644 config/_default/privacy.yaml delete mode 100644 config/production/config.toml create mode 100644 config/production/hugo.yaml rename config/staging/{config.toml => hugo.yaml} (100%) diff --git a/config/_default/hugo.toml b/config/_default/hugo.yaml similarity index 58% rename from config/_default/hugo.toml rename to config/_default/hugo.yaml index ed693d2ce..ed61d05bb 100644 --- a/config/_default/hugo.toml +++ b/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 diff --git a/config/_default/languages.yaml b/config/_default/languages.yaml index eaf5ec369..d92ed2187 100644 --- a/config/_default/languages.yaml +++ b/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" diff --git a/config/_default/params.yaml b/config/_default/params.yaml index c149da1d7..b71cd805f 100644 --- a/config/_default/params.yaml +++ b/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 tell us how we can improve.' no: 'Sorry to hear that. Please tell us how we can improve.' @@ -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 diff --git a/config/_default/permalinks.yaml b/config/_default/permalinks.yaml new file mode 100644 index 000000000..b6b31af21 --- /dev/null +++ b/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/ \ No newline at end of file diff --git a/config/_default/privacy.yaml b/config/_default/privacy.yaml new file mode 100644 index 000000000..527ab0b56 --- /dev/null +++ b/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 \ No newline at end of file diff --git a/config/production/config.toml b/config/production/config.toml deleted file mode 100644 index e69de29bb..000000000 diff --git a/config/production/hugo.yaml b/config/production/hugo.yaml new file mode 100644 index 000000000..e700c8563 --- /dev/null +++ b/config/production/hugo.yaml @@ -0,0 +1 @@ +baseURL: https://interlisp.org \ No newline at end of file diff --git a/config/staging/config.toml b/config/staging/hugo.yaml similarity index 100% rename from config/staging/config.toml rename to config/staging/hugo.yaml From c4c8eb17699ffbb128a12b50b64bd16dec39d86e Mon Sep 17 00:00:00 2001 From: Bill Stumbo Date: Sat, 16 Mar 2024 01:29:26 -0400 Subject: [PATCH 03/14] Continued cleanup of config files Code Highlighting cleaned up and better commented. Updated `software/install-and-run/windows/native/_index.md` to test and validate code block processing. --- config/_default/hugo.yaml | 59 ++++--------------- config/_default/languages.yaml | 5 +- config/_default/markup.yaml | 19 +++++- config/_default/params.yaml | 33 ++++++++++- .../install-and-run/windows/native/_index.md | 25 ++++---- 5 files changed, 78 insertions(+), 63 deletions(-) diff --git a/config/_default/hugo.yaml b/config/_default/hugo.yaml index ed61d05bb..748c9b23c 100644 --- a/config/_default/hugo.yaml +++ b/config/_default/hugo.yaml @@ -7,7 +7,7 @@ # # relativeURLs: Enable to force all relative URLs to be relative to content root -relativeURLs: true +relativeURLs: false # canonifyURLs: Convert relative URLs to absolute URLs canonifyURLs: true @@ -30,58 +30,21 @@ defaultContentLanguageInSubdir: false enableMissingTranslationPlaceholders: true # Disable rendering of the specified page kinds -disableKinds: [taxonomy, term, RSS] +disableKinds: + - taxonomy + - term + - RSS # Code Highlighting configuration -pygmentsCodeFences: true -pygmentsUseClasses: false +# Not Used. Code highlighting is controlled using the highlighting +# section in `markup.yaml` +#pygmentsCodeFences: false +#pygmentsUseClasses: false # Use the new Chroma Go highlighter in Hugo. -pygmentsUseClassic: false -#pygmentsOptions = "linenos=table" +# pygmentsUseClassic: false +# pygmentsOptions: linenos=table # See https://help.farbox.com/pygments.html -# **************************************************************************** -# -# Docsy - Everything below this are Site Params -# - # Comment out if you don't want the "print entire section" link enabled. # [outputs] # section = ["HTML", "print"] - -# paramas - -# Set Google Analytics to use GA4 -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 - -# 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 - -# 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 - -# 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 - -# Enable Algolia DocSearch -#algolia_docsearch = false - -# Enable Lunr.js offline search -# offlineSearch = true - -# 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 - diff --git a/config/_default/languages.yaml b/config/_default/languages.yaml index d92ed2187..1f0069b6b 100644 --- a/config/_default/languages.yaml +++ b/config/_default/languages.yaml @@ -5,8 +5,9 @@ # See: https://gohugo.io/content-management/multilingual/ # en: - description: "Dedicated to restoring and preserving the Interlisp experience" languageName: English" # Weight used for sorting. weight: 1 - contentDir: content/en \ No newline at end of file + contentDir: content/en + params: + description: "Dedicated to restoring and preserving the Interlisp experience" \ No newline at end of file diff --git a/config/_default/markup.yaml b/config/_default/markup.yaml index c6c36b606..4b348b3fc 100644 --- a/config/_default/markup.yaml +++ b/config/_default/markup.yaml @@ -2,11 +2,28 @@ # # Goldmark markdown processor setup # +# See: https://gohugo.io/getting-started/configuration-markup/#goldmark +# for additional configuration options +# goldmark: renderer: unsafe: true +# +# Code block processing +# +# See: https://gohugo.io/getting-started/configuration-markup/#highlight +# for additional information on configuration options. +# https://www.docsy.dev/docs/adding-content/lookandfeel/#code-highlighting-with-chroma +# contains Docsy specfiic code highlighting information highlight: # See a complete list of available styles at https://xyproto.github.io/splash/docs/all.html + #style: solarized-dark style: tango + codeFences: true + noClasses: true + hl_inline: false # Uncomment if you want your chosen highlight style used for code blocks without a specified language - # guessSyntax: true \ No newline at end of file + guessSyntax: true + tabWidth: 4 + #lineNoStart: 1 + lineNos: false \ No newline at end of file diff --git a/config/_default/params.yaml b/config/_default/params.yaml index b71cd805f..abafd592c 100644 --- a/config/_default/params.yaml +++ b/config/_default/params.yaml @@ -2,6 +2,36 @@ # # Parameters # + +# Set Google Analytics to use GA4 +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 + +# 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 + +# 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 + +# 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 + +# Enable syntax highlighting and copy buttons on code blocks with Prism +# We are using code highlighting via Chroma. Chroma options are defined +# in `markup.yaml` +prism_syntax_highlighting: false + # copyright: site copyright information # authors: text list of authors # from_year: year in copyright statement @@ -9,6 +39,7 @@ copyright: authors: Interlisp.org from_year: 2024 + license: MIT # github information # github_repo: url to repo of web site @@ -65,7 +96,7 @@ links: # icon: "fa fa-envelope" # desc: "Discuss development issues around the project" -taxonomy: +taxonomies: # Nothing defined # User Interface Configuration options diff --git a/content/en/software/install-and-run/windows/native/_index.md b/content/en/software/install-and-run/windows/native/_index.md index 747b02b7a..449b87cea 100644 --- a/content/en/software/install-and-run/windows/native/_index.md +++ b/content/en/software/install-and-run/windows/native/_index.md @@ -31,11 +31,13 @@ When running on Windows natively, Medley will be installed into a directory of y
Windows Protection Dialog

 

## Multiple Installations + You can install multiple copies of Medley (e.g. different releases) on a single Windows. Simply run the Medley installation app and choose a different ***install_dir*** than any previous Medley installation. Each Medley installation so installed will operate independently of other Medley installations, including having a separate Medley file system. ## Update Medley + To update any given Medley installation (e.g., to install a new release), download the updated native Medley Windows installer as per Step 1 in the **Install Medley** section above. Run the installer app just downloaded and select the ***install_dir*** for the Medley installation you are updating. @@ -43,19 +45,22 @@ Run the installer app just downloaded and select the ***install_dir*** for the M The chosen Medley installation will be updated. Any user files (i.e., files created by the user that are not part of the Medley distribution) in the Medley file system will remain intact. ## Run Medley + Once it is installed, you can start Medley from either a Command window or a Powershell window. You cannot (currently) start Medley from the Start Menu or from an icon on the desktop. From a Command window, type: - ``` + + ```powershell cd medley ``` - + Example: Start from Command Window - + From a Powershell window, type: - ``` + + ```powershell cd cmd /C medley ``` @@ -71,16 +76,15 @@ This will bring up the Medley environment in a separate Window on your Windows d ![Medley window open on Windows desktop](../images/Medley-on-Windows.png) - - - ## Use Medley + Once Medley is up and running, see [here](/software/using-medley/) for tips on how to navigate and use the Medley environment. -To exit Medley, type ```(IL:LOGOUT)``` at any Exec window prompt. +To exit Medley, type `(IL:LOGOUT)` at any Exec window prompt. ## Important Notes -1. The file system from Medley's perspective differs somewhat from the file system from Window's perspective. Specifically, within Medley, the file system root (i.e., "{DSK}/" or "{UNIX}/") is mapped to the ***install_dir*** in the Windows file system. For example, if ***install_dir*** is ***C:\Users\Frank\Medley1***, then the Medley file known as ***{DSK}\testfile.txt*** will be located in the Windows file system at ***C:\Users\Frank\Medley1\testdir\testfile.txt*** + +1. The file system from Medley's perspective differs somewhat from the file system from Window's perspective. Specifically, within Medley, the file system root (i.e., "{DSK}/" or "{UNIX}/") is mapped to the ***install_dir*** in the Windows file system. For example, if ***install_dir*** is ***C:\Users\Frank\Medley1***, then the Medley file known as ***{DSK}\testfile.txt*** will be located in the Windows file system at ***C:\Users\Frank\Medley1\testdir\testfile.txt*** 2. Also, from Medley you can refer to any file on a Windows drive using the reference ***{DSK}/[drive letter]/*** (or equivalently ***{DSK}<[drive letter]>***). For example, ***C:\User\Frank\Downloads\testfile.txt*** in Windows will be ***{DSK}/c/User/Frank/Downloads/testfile.txt*** in Medley. @@ -88,7 +92,7 @@ To exit Medley, type ```(IL:LOGOUT)``` at any Exec window prompt. 4. Medley code is stored in ***/medley*** (or ***<install_dir>\medley*** from the Windows perspective). 5. If you want to work with the Medley code using git, etc. You will probably find it easier to work with git within Cygwin rather than work with git in Windows. To work within the Medley-specific Cygwin, within a Powershell or Command window: - ``` + ```powershell PS C:\Users\Frank> cd PS C:\Users\Frank> .\bin\bash -login $ git clone https://github.com/Interlisp/medley.git gmedley @@ -99,4 +103,3 @@ To exit Medley, type ```(IL:LOGOUT)``` at any Exec window prompt. This will get you a bash terminal running under the Medley-specific Cygwin - which means that the file names will be the same as in Medley. 6. The Medley-specific Cygwin install is rather minimal, so if you find you need other Linux tools to work with the Medley code, the Cygwin setup tool (which also functions as its package manager) is available at ***<install_dir>\cygwin\setup_x86_64.exe*** (in Windows) or at ***/cygwin/setup_x86_64.exe*** (from within Cygwin bash). - From fce7f3e3732e991ed037fa7f570e0ad50b23251d Mon Sep 17 00:00:00 2001 From: Bill Stumbo Date: Thu, 21 Mar 2024 08:02:10 -0400 Subject: [PATCH 04/14] Update --- config/staging/hugo.yaml | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/config/staging/hugo.yaml b/config/staging/hugo.yaml index a7799165e..dcf0c6a77 100644 --- a/config/staging/hugo.yaml +++ b/config/staging/hugo.yaml @@ -1,4 +1,4 @@ -baseURL = "https://wasm.interlisp.org" -languageCode = "en-us" -title = "Staging Environment" -publishDir = "stage" +baseURL: https://wasm.interlisp.org +languageCode: en-us +title: 'Staging Environment' +publishDir: stage From 2e190ab9636038d144780159fa6716ec6f8e58e6 Mon Sep 17 00:00:00 2001 From: Bill Stumbo Date: Wed, 22 May 2024 14:44:38 -0400 Subject: [PATCH 05/14] Update docsy version to 0.10.0 http://localhost:1313/# Please enter the commit message for your changes. Lines starting --- content/en/_index.html | 4 ++-- go.mod | 5 ++++- go.sum | 12 ++++++++---- hugo.toml | 4 ++-- 4 files changed, 16 insertions(+), 9 deletions(-) diff --git a/content/en/_index.html b/content/en/_index.html index a52c049dc..f0cc251af 100644 --- a/content/en/_index.html +++ b/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="primary" height="min">}}
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.
@@ -49,7 +49,7 @@

Have other questions?

{{< /blocks/section >}} -{{< blocks/section color="primary" >}} +{{< blocks/section color="primary" type="row" >}} {{% blocks/feature icon="fas fa-feather" title="History of Interlisp" %}}

diff --git a/go.mod b/go.mod index a7c64518e..b96314dad 100644 --- a/go.mod +++ b/go.mod @@ -2,4 +2,7 @@ module github.com/Interlisp/Interlisp.github.io go 1.20 -require github.com/google/docsy v0.6.0 // indirect +require ( + github.com/google/docsy v0.10.0 // indirect + github.com/google/docsy/dependencies v0.7.2 // indirect +) diff --git a/go.sum b/go.sum index 785c595dc..cef89234a 100644 --- a/go.sum +++ b/go.sum @@ -1,5 +1,9 @@ -github.com/FortAwesome/Font-Awesome v0.0.0-20220831210243-d3a7818c253f/go.mod h1:IUgezN/MFpCDIlFezw3L8j83oeiIuYoj28Miwr/KUYo= -github.com/google/docsy v0.6.0 h1:43bVF18t2JihAamelQjjGzx1vO2ljCilVrBgetCA8oI= -github.com/google/docsy v0.6.0/go.mod h1:VKKLqD8PQ7AglJc98yBorATfW7GrNVsn0kGXVYF6G+M= -github.com/google/docsy/dependencies v0.6.0/go.mod h1:EDGc2znMbGUw0RW5kWwy2oGgLt0iVXBmoq4UOqstuNE= +github.com/FortAwesome/Font-Awesome v0.0.0-20230327165841-0698449d50f2/go.mod h1:IUgezN/MFpCDIlFezw3L8j83oeiIuYoj28Miwr/KUYo= +github.com/FortAwesome/Font-Awesome v0.0.0-20240402185447-c0f460dca7f7/go.mod h1:IUgezN/MFpCDIlFezw3L8j83oeiIuYoj28Miwr/KUYo= +github.com/google/docsy v0.10.0 h1:6tMDacPwAyRWNCfvsn/9qGOZDQ8b0aRzjRZvnZPY5dg= +github.com/google/docsy v0.10.0/go.mod h1:c0nIAqmRTOuJ01F85U/wJPQtc3Zj9N58Kea9bOT2AJc= +github.com/google/docsy/dependencies v0.7.2 h1:+t5ufoADQAj4XneFphz4A+UU0ICAxmNaRHVWtMYXPSI= +github.com/google/docsy/dependencies v0.7.2/go.mod h1:gihhs5gmgeO+wuoay4FwOzob+jYJVyQbNaQOh788lD4= github.com/twbs/bootstrap v4.6.2+incompatible/go.mod h1:fZTSrkpSf0/HkL0IIJzvVspTt1r9zuf7XlZau8kpcY0= +github.com/twbs/bootstrap v5.2.3+incompatible/go.mod h1:fZTSrkpSf0/HkL0IIJzvVspTt1r9zuf7XlZau8kpcY0= +github.com/twbs/bootstrap v5.3.3+incompatible/go.mod h1:fZTSrkpSf0/HkL0IIJzvVspTt1r9zuf7XlZau8kpcY0= diff --git a/hugo.toml b/hugo.toml index e175daad3..5dea6950f 100644 --- a/hugo.toml +++ b/hugo.toml @@ -255,8 +255,8 @@ enable = false [[params.links.user]] name ="Twitter" url = "https://twitter.com/interlisp8" - icon = "fab fa-twitter" - desc = "Follow us on Twitter to get the latest news!" + icon = "fab fa-x-twitter" + desc = "Follow us on X to get the latest news!" # [[params.links.user]] # name = "Stack Overflow" # url = "https://stackoverflow.com/questions/tagged/graphviz" From c41140a4f5c161d944654542ab84ccf0acaf6e2f Mon Sep 17 00:00:00 2001 From: Bill Stumbo Date: Thu, 30 May 2024 07:11:20 -0400 Subject: [PATCH 06/14] Cleanup deprecated options --- content/en/project/credits.md | 1 - hugo.toml | 6 +++--- 2 files changed, 3 insertions(+), 4 deletions(-) diff --git a/content/en/project/credits.md b/content/en/project/credits.md index d6329925f..c3122eaf9 100644 --- a/content/en/project/credits.md +++ b/content/en/project/credits.md @@ -2,7 +2,6 @@ title: Credits weight: 80 type: docs -markup: mmark --- Interlisp was a joint effort of many people -- likely more than one hundred -- from its initial beginnings through its heyday until its virtual disappearance. There are more than we can name. There were contributions by employees of BBN, Xerox, and Fuji Xerox and later, employees of Envos and Venue. There are initials in the source code with date of last edit, but who wrote what is sometimes a mystery. diff --git a/hugo.toml b/hugo.toml index 5dea6950f..871d645eb 100644 --- a/hugo.toml +++ b/hugo.toml @@ -23,7 +23,7 @@ defaultContentLanguageInSubdir = false # Useful when translating. enableMissingTranslationPlaceholders = true -disableKinds = ["taxonomy", "taxonomyTerm", "RSS"] +disableKinds = ["taxonomy", "RSS"] # **************************************************************************** # @@ -116,7 +116,7 @@ anchor = "smart" [languages] [languages.en] - description = "Dedicated to restoring and preserving the Interlisp experience" +# description = "Dedicated to restoring and preserving the Interlisp experience" languageName ="English" # Weight used for sorting. weight = 1 @@ -213,7 +213,7 @@ sidebar_search_disable = false # Set to false if you don't want to display a logo (/assets/icons/logo.svg) in the top nav bar navbar_logo = true # Set to true to disable the About link in the site footer -footer_about_disable = true # false +footer_about_enable = false # Turn off transparency in nav bar navbar_translucent_over_cover_disable = true From 1684af4c651fa1b45655c78fdeefd45893251666 Mon Sep 17 00:00:00 2001 From: Bill Stumbo Date: Wed, 5 Jun 2024 08:02:56 -0400 Subject: [PATCH 07/14] Updates to bring fix deprecated config items, fix local search --- .github/workflows/gh-pages.yml | 8 ++++---- content/en/history/bibliography/_index.md | 1 - go.sum | 4 ++++ hugo.toml | 10 ++++++++++ layouts/partials/hooks/body-end.html | 1 + layouts/shortcodes/bibTable.html | 10 +++++++++- package-lock.json | 22 ++++++++++++++++++++++ package.json | 4 +++- scripts/update_bibliography.sh | 2 +- 9 files changed, 54 insertions(+), 8 deletions(-) diff --git a/.github/workflows/gh-pages.yml b/.github/workflows/gh-pages.yml index 0871a5af5..51da71be4 100644 --- a/.github/workflows/gh-pages.yml +++ b/.github/workflows/gh-pages.yml @@ -77,7 +77,7 @@ jobs: env: cache-name: cache-zotero_bib with: - path: ~/data + path: ~/static/data key: ${{ needs.check.outputs.zoteroVersion }} restore-keys: | ${{ needs.check.outputs.zoteroVersion }} @@ -88,14 +88,14 @@ jobs: run: | if [[ "$CACHE_HIT" == 'true' ]]; then echo "Use Cache" - sudo cp --recursive ~/data ${GITHUB_WORKSPACE} - ls -la ${GITHUB_WORKSPACE}/data + sudo cp --recursive ~/static/data ${GITHUB_WORKSPACE} + ls -la ${GITHUB_WORKSPACE}/static/data else echo "Retrieve bibliography" cd scripts chmod +x ./update_bibliography.sh ./update_bibliography.sh - sudo cp --recursive ${GITHUB_WORKSPACE}/data ~/data + sudo cp --recursive ${GITHUB_WORKSPACE}/static/data ~/static/data fi shell: bash diff --git a/content/en/history/bibliography/_index.md b/content/en/history/bibliography/_index.md index 7480a7843..3d0fa452a 100644 --- a/content/en/history/bibliography/_index.md +++ b/content/en/history/bibliography/_index.md @@ -13,5 +13,4 @@ aliases: (This bibliography is kept in sync with our [Zotero](https://www.zotero.org/) collection [Library](https://www.zotero.org/groups/2914042/interlisp/library). - {{< bibTable >}} diff --git a/go.sum b/go.sum index cef89234a..22e30c371 100644 --- a/go.sum +++ b/go.sum @@ -1,7 +1,11 @@ github.com/FortAwesome/Font-Awesome v0.0.0-20230327165841-0698449d50f2/go.mod h1:IUgezN/MFpCDIlFezw3L8j83oeiIuYoj28Miwr/KUYo= +github.com/FortAwesome/Font-Awesome v0.0.0-20240108205627-a1232e345536/go.mod h1:IUgezN/MFpCDIlFezw3L8j83oeiIuYoj28Miwr/KUYo= github.com/FortAwesome/Font-Awesome v0.0.0-20240402185447-c0f460dca7f7/go.mod h1:IUgezN/MFpCDIlFezw3L8j83oeiIuYoj28Miwr/KUYo= +github.com/google/docsy v0.9.1 h1:+jqges1YCd+yHeuZ1BUvD8V8mEGVtPxULg5j/vaJ984= +github.com/google/docsy v0.9.1/go.mod h1:saOqKEUOn07Bc0orM/JdIF3VkOanHta9LU5Y53bwN2U= github.com/google/docsy v0.10.0 h1:6tMDacPwAyRWNCfvsn/9qGOZDQ8b0aRzjRZvnZPY5dg= github.com/google/docsy v0.10.0/go.mod h1:c0nIAqmRTOuJ01F85U/wJPQtc3Zj9N58Kea9bOT2AJc= +github.com/google/docsy/dependencies v0.6.0/go.mod h1:EDGc2znMbGUw0RW5kWwy2oGgLt0iVXBmoq4UOqstuNE= github.com/google/docsy/dependencies v0.7.2 h1:+t5ufoADQAj4XneFphz4A+UU0ICAxmNaRHVWtMYXPSI= github.com/google/docsy/dependencies v0.7.2/go.mod h1:gihhs5gmgeO+wuoay4FwOzob+jYJVyQbNaQOh788lD4= github.com/twbs/bootstrap v4.6.2+incompatible/go.mod h1:fZTSrkpSf0/HkL0IIJzvVspTt1r9zuf7XlZau8kpcY0= diff --git a/hugo.toml b/hugo.toml index 871d645eb..b5790cb3e 100644 --- a/hugo.toml +++ b/hugo.toml @@ -7,6 +7,8 @@ enableRobotsTXT = true assetDir = "static" + + # **************************************************************************** # # Docsy @@ -214,6 +216,7 @@ sidebar_search_disable = false navbar_logo = true # Set to true to disable the About link in the site footer footer_about_enable = false + # Turn off transparency in nav bar navbar_translucent_over_cover_disable = true @@ -278,3 +281,10 @@ enable = false # url = "https://example.org/mail" # icon = "fa fa-envelope" # desc = "Discuss development issues around the project" + +[params.cdn] + jquery = 'https://code.jquery.com/jquery-3.7.1.min.js' + jquery_hash = 'sha256-/JqT3SQfawRcv/BIHPThkBvs0OEvtFFmqPF/lYI/Cxo=' + +[params.csp] + scriptsrc = ["'self'", "'unsafe-inline'", "https://code.jquery.com"] \ No newline at end of file diff --git a/layouts/partials/hooks/body-end.html b/layouts/partials/hooks/body-end.html index 6a0c92cb1..7c9e6c6dc 100644 --- a/layouts/partials/hooks/body-end.html +++ b/layouts/partials/hooks/body-end.html @@ -1,3 +1,4 @@ diff --git a/layouts/shortcodes/bibTable.html b/layouts/shortcodes/bibTable.html index 1328d6ef7..4af3a6e7f 100644 --- a/layouts/shortcodes/bibTable.html +++ b/layouts/shortcodes/bibTable.html @@ -165,7 +165,15 @@ - {{ $years_items := getJSON "data/bibliography.json" }} + {{ $years_items := dict }} + {{ $bib := resources.Get "data/bibliography.json" }} + {{ with $bib }} + {{ with . | transform.Unmarshal }} + {{ $years_items = . }} + {{ end }} + {{ else }} + {{ errorf "Unable to get global resource 'data/bibliography.json'" }} + {{ end }} {{ range $year, $items := $years_items }} {{ $year }} diff --git a/package-lock.json b/package-lock.json index a33b1170a..07e60ed3a 100644 --- a/package-lock.json +++ b/package-lock.json @@ -12,6 +12,8 @@ "dependencies": { + "jquery": "^3.7.1", + "tabpanel": "^0.2.0" }, @@ -956,6 +958,16 @@ }, + "node_modules/jquery": { + + "version": "3.7.1", + + "resolved": "https://registry.npmjs.org/jquery/-/jquery-3.7.1.tgz", + + "integrity": "sha512-m4avr8yL8kmFN8psrbFFFmB/If14iN5o9nw/NgnnM+kybDJpRsAynV2BsfpTYrTRysYUdADVD7CkUUizgkpLfg==" + + }, + "node_modules/jsonfile": { "version": "6.1.0", @@ -2544,6 +2556,16 @@ }, + "jquery": { + + "version": "3.7.1", + + "resolved": "https://registry.npmjs.org/jquery/-/jquery-3.7.1.tgz", + + "integrity": "sha512-m4avr8yL8kmFN8psrbFFFmB/If14iN5o9nw/NgnnM+kybDJpRsAynV2BsfpTYrTRysYUdADVD7CkUUizgkpLfg==" + + }, + "jsonfile": { "version": "6.1.0", diff --git a/package.json b/package.json index c92207594..87bd243f1 100644 --- a/package.json +++ b/package.json @@ -12,9 +12,11 @@ "dependencies": { + "jquery": "^3.7.1", + "tabpanel": "^0.2.0" } - + } diff --git a/scripts/update_bibliography.sh b/scripts/update_bibliography.sh index 5e7355bce..e73ac4c6e 100755 --- a/scripts/update_bibliography.sh +++ b/scripts/update_bibliography.sh @@ -102,4 +102,4 @@ items=$(jq 'include "./bib-fns";map(reconstituteGroupedEntries) | from_entries' echo "Outputting CSL JSON" echo "$finalCount entries" -echo "$items" > "$(dirname "$0")/../data/bibliography.json" +echo "$items" > "$(dirname "$0")/../static/data/bibliography.json" From f43bdbbfdc0e41620ec769ca53ce21b9e405a4cf Mon Sep 17 00:00:00 2001 From: Bill Stumbo Date: Fri, 7 Jun 2024 07:29:55 -0400 Subject: [PATCH 08/14] Update github action setting directories correctly. Update peaceiris action versions and github action versions. --- .github/workflows/gh-pages.yml | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/.github/workflows/gh-pages.yml b/.github/workflows/gh-pages.yml index 51da71be4..080cf0cfe 100644 --- a/.github/workflows/gh-pages.yml +++ b/.github/workflows/gh-pages.yml @@ -51,7 +51,7 @@ jobs: - name: Cache Zotero Bibliography id: cache-zotero-bib - uses: actions/cache@v3 + uses: actions/cache@v4 env: cache-name: cache-zotero_bib with: @@ -73,11 +73,11 @@ jobs: - name: Cache Zotero Bibliography id: cache-zotero-bib - uses: actions/cache@v3 + uses: actions/cache@v4 env: cache-name: cache-zotero_bib with: - path: ~/static/data + path: ~/data key: ${{ needs.check.outputs.zoteroVersion }} restore-keys: | ${{ needs.check.outputs.zoteroVersion }} @@ -88,25 +88,25 @@ jobs: run: | if [[ "$CACHE_HIT" == 'true' ]]; then echo "Use Cache" - sudo cp --recursive ~/static/data ${GITHUB_WORKSPACE} + sudo cp --recursive ~/data ${GITHUB_WORKSPACE}/static ls -la ${GITHUB_WORKSPACE}/static/data else echo "Retrieve bibliography" cd scripts chmod +x ./update_bibliography.sh ./update_bibliography.sh - sudo cp --recursive ${GITHUB_WORKSPACE}/static/data ~/static/data + sudo cp --recursive ${GITHUB_WORKSPACE}/static/data ~/data fi shell: bash - name: Setup Hugo - uses: peaceiris/actions-hugo@v2 + uses: peaceiris/actions-hugo@v3 with: hugo-version: '0.122.0' extended: true - name: Setup Node - uses: actions/setup-node@v3 + uses: actions/setup-node@v4 with: node-version: 18 @@ -118,7 +118,7 @@ jobs: run: hugo - name: Deploy - uses: peaceiris/actions-gh-pages@v3 + uses: peaceiris/actions-gh-pages@v4 if: github.ref == 'refs/heads/main' with: github_token: ${{ secrets.GITHUB_TOKEN }} From 0991d88f29c7bd0faf522ec8f5688d44125865ed Mon Sep 17 00:00:00 2001 From: Bill Stumbo Date: Fri, 7 Jun 2024 07:53:15 -0400 Subject: [PATCH 09/14] Add .gitkeep file --- static/data/.gitkeep | 0 1 file changed, 0 insertions(+), 0 deletions(-) create mode 100644 static/data/.gitkeep diff --git a/static/data/.gitkeep b/static/data/.gitkeep new file mode 100644 index 000000000..e69de29bb From 733744e0865fa6a8f37cccd6e3d07b48b2b7499f Mon Sep 17 00:00:00 2001 From: Bill Stumbo Date: Fri, 7 Jun 2024 08:11:27 -0400 Subject: [PATCH 10/14] Cleanup --- hugo.toml | 7 ------- layouts/partials/hooks/body-end.html | 1 - 2 files changed, 8 deletions(-) diff --git a/hugo.toml b/hugo.toml index b5790cb3e..f06e9b403 100644 --- a/hugo.toml +++ b/hugo.toml @@ -281,10 +281,3 @@ enable = false # url = "https://example.org/mail" # icon = "fa fa-envelope" # desc = "Discuss development issues around the project" - -[params.cdn] - jquery = 'https://code.jquery.com/jquery-3.7.1.min.js' - jquery_hash = 'sha256-/JqT3SQfawRcv/BIHPThkBvs0OEvtFFmqPF/lYI/Cxo=' - -[params.csp] - scriptsrc = ["'self'", "'unsafe-inline'", "https://code.jquery.com"] \ No newline at end of file diff --git a/layouts/partials/hooks/body-end.html b/layouts/partials/hooks/body-end.html index 7c9e6c6dc..6a0c92cb1 100644 --- a/layouts/partials/hooks/body-end.html +++ b/layouts/partials/hooks/body-end.html @@ -1,4 +1,3 @@ From 354a7611e52fae28bccf3d8d5b10b55bca576130 Mon Sep 17 00:00:00 2001 From: Bill Stumbo Date: Sun, 9 Jun 2024 00:11:14 -0400 Subject: [PATCH 11/14] Add config/development/server.yaml File used in local development setup --- config/development/server.yaml | 13 +++++++++++++ 1 file changed, 13 insertions(+) create mode 100644 config/development/server.yaml diff --git a/config/development/server.yaml b/config/development/server.yaml new file mode 100644 index 000000000..8540342b0 --- /dev/null +++ b/config/development/server.yaml @@ -0,0 +1,13 @@ +headers: +- for: /** + values: + Content-Security-Policy: script-src 'unsafe-inline' 'unsafe-eval' localhost:1313 https://code.jquery.com https://*.google.com http://*.google.com https://partner.googleadservices.com + Referrer-Policy: strict-origin-when-cross-origin + X-Content-Type-Options: nosniff + X-Frame-Options: DENY + X-XSS-Protection: 1; mode=block + +redirects: +- from: /** + status: 404 + to: /404.html From 24782617a781574944d37783948e8650670b4937 Mon Sep 17 00:00:00 2001 From: Bill Stumbo Date: Sun, 9 Jun 2024 00:32:33 -0400 Subject: [PATCH 12/14] Update Twitter logo to X --- config/_default/params.yaml | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/config/_default/params.yaml b/config/_default/params.yaml index abafd592c..baf7e9344 100644 --- a/config/_default/params.yaml +++ b/config/_default/params.yaml @@ -73,8 +73,8 @@ links: desc: "Discussion and help from your fellow users" - name: "Twitter" url: "https://twitter.com/interlisp8" - icon: "fab fa-twitter" - desc: "Follow us on Twitter to get the latest news!" + icon: "fab fa-x-twitter" + desc: "Follow us on X to get the latest news!" # - name: "Stack Overflow" # url: "https://stackoverflow.com/questions/tagged/graphviz" # icon: "fab fa-stack-overflow" @@ -147,8 +147,8 @@ ui: # Set to true to disable breadcrumb navigation. breadcrumb_disable: false - # Set to true to disable the About link in the site footer - footer_about_disable: true + # Set to false to disable the About link in the site footer + footer_about_enable: false ul_show: 3 From 830126d49153951a0d80ef703f2c53115d51b2ee Mon Sep 17 00:00:00 2001 From: Bill Stumbo Date: Mon, 10 Jun 2024 08:01:51 -0400 Subject: [PATCH 13/14] Cleanup and syncronize changes with private branch --- .github/workflows/gh-pages.yml | 9 +++-- README.md | 54 +++++++++++++++------------- config/_default/params.yaml | 3 ++ data/.gitkeep | 0 data/carousel.yaml | 9 ----- layouts/partials/hooks/body-end.html | 4 ++- 6 files changed, 43 insertions(+), 36 deletions(-) delete mode 100644 data/.gitkeep delete mode 100644 data/carousel.yaml diff --git a/.github/workflows/gh-pages.yml b/.github/workflows/gh-pages.yml index 080cf0cfe..5b5d2cb3c 100644 --- a/.github/workflows/gh-pages.yml +++ b/.github/workflows/gh-pages.yml @@ -28,6 +28,11 @@ on: schedule: - cron: "0 3 * * *" +env: + # ---------------------------------------------------------------------------- + # Specify the deployment environment: staging or production + hugoEnvironment: production + jobs: # ---------------------------------------------------------------------------- # Use the Zotero REST API to get the current version of the Zotero Bibliography @@ -102,7 +107,7 @@ jobs: - name: Setup Hugo uses: peaceiris/actions-hugo@v3 with: - hugo-version: '0.122.0' + hugo-version: '0.127.0' extended: true - name: Setup Node @@ -115,7 +120,7 @@ jobs: - run: npm install --verbose - name: Build - run: hugo + run: hugo -e $hugoEnvironment - name: Deploy uses: peaceiris/actions-gh-pages@v4 diff --git a/README.md b/README.md index 4612c39bd..0229e5ed3 100644 --- a/README.md +++ b/README.md @@ -147,12 +147,12 @@ hugo version The response will be something along the lines of: ```bash -hugo v0.111.3-5d4eb5154e1fed125ca8e9b5a0315c4180dab192+extended linux/amd64 BuildDate=2023-03-12T11:40:50Z VendorInfo=gohugoio +hugo v0.126.1-3d40aba512931031921463dafc172c0d124437b8+extended linux/amd64 BuildDate=2024-05-15T10:42:34Z VendorInfo=gohugoio ``` -Be sure your version is at least `v0.101.0`. Older versions of `hugo` may fail to load correctly. +Be sure your version is at least `v0.122.0`. Older versions of `hugo` may fail to load correctly. -Secondly, there is one data file that is required to successfully build and run the `Interlisp.org` website locally, `data/bibliography.json`. +Secondly, there is one data file that is required to successfully build and run the `Interlisp.org` website locally, `static/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: @@ -162,48 +162,49 @@ Once in the directory, run the following command: ``` This script will retrieve the bibliography from our Zotero library, format it appropriately and place the created file -in the appropriate location, the `data` directory. +in the appropriate location, the `static/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 +hugo server --logLevel debug -v --renderToMemory -e development ``` `Hugo` will start and automatically download the Docsy theme and its dependencies as hugo modules. You should see output along the lines of: ```bash -hugo: downloading modules … -hugo: collected modules in 17781 ms +Watching for changes in /home/wstumbo/development/stumbo.github.io/{archetypes,content,layouts,package.json,static} +Watching for config changes in /home/wstumbo/development/stumbo.github.io/config/_default, /home/wstumbo/development/stumbo.github.io/config/development, /home/wstumbo/development/stumbo.github.io/go.mod Start building sites … -hugo v0.111.3-5d4eb5154e1fed125ca8e9b5a0315c4180dab192+extended linux/amd64 BuildDate=2023-03-12T11:40:50Z VendorInfo=gohugoio +hugo v0.126.1-3d40aba512931031921463dafc172c0d124437b8+extended linux/amd64 BuildDate=2024-05-15T10:42:34Z VendorInfo=gohugoio + | EN -------------------+----- - Pages | 61 + Pages | 52 Paginator pages | 0 - Non-page files | 13 - Static files | 68 - Processed images | 46 - Aliases | 4 - Sitemaps | 1 + Non-page files | 46 + Static files | 97 + Processed images | 47 + Aliases | 66 Cleaned | 0 -Built in 1349 ms -Watching for changes in /home/wstumbo/development/Interlisp.github.io/{archetypes,assets,content,data,layouts,package.json,static,themes} -Watching for config changes in /home/wstumbo/development/Interlisp.github.io/config.toml, /home/wstumbo/development/Interlisp.github.io/go.mod +Built in 3230 ms Environment: "development" Serving pages from memory Running in Fast Render Mode. For full rebuilds on change: hugo server --disableFastRender -Web Server is available at http://localhost:1313/ (bind address 127.0.0.1) +Web Server is available at //localhost:1313/ (bind address 127.0.0.1) Press Ctrl+C to stop ``` `Hugo` is now running. You can go to [http://localhost:1313](http://localhost:1313) to review the locally running version of the website. For most changes you should be able to review the text and layout to validate the effects are as expected. +You can get additional debugging information by adding the following two options +to your `hugo` command `--logLevel debug -v`. + Once you have validated your changes, create a pull request to merge your changes into the `main` branch. ## Layout of the `Interlisp.github.io` repository @@ -211,19 +212,23 @@ Once you have validated your changes, create a pull request to merge your change The layout of the `Interlisp.github.io` repository follows the standard [`Hugo` directory structure](https://gohugo.io/getting-started/directory-structure/). Directories that have components specific to `Interlisp.github.io` are as follows: -- `.` - at the root, `config.toml` file provides the general site configuration information - `.github\workflows` - home to the github actions `gh-pages.yml` that specifies how to build and release the Interlisp home page - `assets` - customization of the `Docsy` theme for Interlisp. - `icons` - holds and `svg` version of `Interlisp-D' logo. This logo is used in the page header - `scss` - contains some custom `scss` - `_styles_project.scss` sets the size of the `svg` file in the header and disables the edit page functionality - `main.scss` - links in the `scss` updates +- `config` - contains all the site specific configuration information + - `_default` - configuration information shared across different supported environments [development, staging, production] + - `development` - configuration information specific to the development environment + - `production` - configuration information specific to the production environment + - `staging` - configuration information specific to the staging environment - `content\en` - home of all the content for the web page. We currently only support the English language. `Hugo` supports multiple languages and we have not disabled that feature. However there are no plans at present to transcribe the web pages and documentation into another language. -- `data` - holds `bibliography.json` used to create the [bibliography table](https://interlisp.org/bibliography/) - `layout` - `shortcodes` - a simple snippet inside a content file that Hugo will render using a predefined template - `bibTable.html` - a shortcode used to format the [bibliography table](https://interlisp.org/bibliography/) - `static` - the data in this folder is copied directly into the folder structure of the home page + - `data` - holds `bibliography.json` used to create the [bibliography table](https://interlisp.org/bibliography/) - `documentation` - contains the pdf files referenced in the document section of the home page - `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` @@ -236,11 +241,12 @@ 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: +The search engine is identified in the `config/params.yaml` file: -```toml -# Google Custom Search Engine ID. Remove or comment out to disable search. -gcs_engine_id = "33ef4cbe0703b4f3a" +```yaml +# Google custom seach engine configuration +# gcs_engine_id: search engine +gcs_engine_id: 33ef4cbe0703b4f3ax ``` Search results are returned and presented using the page template, `search.md`. diff --git a/config/_default/params.yaml b/config/_default/params.yaml index baf7e9344..5463cb427 100644 --- a/config/_default/params.yaml +++ b/config/_default/params.yaml @@ -152,3 +152,6 @@ ui: ul_show: 3 +# Identify the custom css files +custom_css: + - "css/custom.css" diff --git a/data/.gitkeep b/data/.gitkeep deleted file mode 100644 index e69de29bb..000000000 diff --git a/data/carousel.yaml b/data/carousel.yaml deleted file mode 100644 index 48a69c3f0..000000000 --- a/data/carousel.yaml +++ /dev/null @@ -1,9 +0,0 @@ -images: - - image: /uploads/slider/image1.jpg - content_html: "1" - - image: /uploads/slider/image2.jpg - content_html: "2" - - image: /uploads/slider/image3.jpg - content_html: "3" - - image: /uploads/slider/image4.jpg - content_html: "4" \ No newline at end of file diff --git a/layouts/partials/hooks/body-end.html b/layouts/partials/hooks/body-end.html index 6a0c92cb1..2454aa2d6 100644 --- a/layouts/partials/hooks/body-end.html +++ b/layouts/partials/hooks/body-end.html @@ -1,3 +1,5 @@ - +{{range .Site.Params.custom_css -}} + +{{- end}} From eb32c068d42681cabf006070ac588cb928b50cab Mon Sep 17 00:00:00 2001 From: Bill Stumbo Date: Tue, 11 Jun 2024 23:41:06 -0400 Subject: [PATCH 14/14] Additional cleanup --- README.md | 3 ++- config/_default/hugo.yaml | 8 +++++--- config/production/hugo.yaml | 5 ++++- static/robots.txt | 5 +++++ 4 files changed, 16 insertions(+), 5 deletions(-) create mode 100644 static/robots.txt diff --git a/README.md b/README.md index 0229e5ed3..8883a1a93 100644 --- a/README.md +++ b/README.md @@ -227,7 +227,8 @@ that have components specific to `Interlisp.github.io` are as follows: - `layout` - `shortcodes` - a simple snippet inside a content file that Hugo will render using a predefined template - `bibTable.html` - a shortcode used to format the [bibliography table](https://interlisp.org/bibliography/) -- `static` - the data in this folder is copied directly into the folder structure of the home page +- `static` - the data in this folder is copied directly into the folder structure of the home page + - `css` - custom css files - `data` - holds `bibliography.json` used to create the [bibliography table](https://interlisp.org/bibliography/) - `documentation` - contains the pdf files referenced in the document section of the home page - `favicons` - contains `favicon.png` a small icon that browsers can use when referencing the website diff --git a/config/_default/hugo.yaml b/config/_default/hugo.yaml index 748c9b23c..7e625d5e8 100644 --- a/config/_default/hugo.yaml +++ b/config/_default/hugo.yaml @@ -10,10 +10,12 @@ relativeURLs: false # canonifyURLs: Convert relative URLs to absolute URLs -canonifyURLs: true +canonifyURLs: false -# enableRobotsTXT: Enable generation of Robots.txt file -enableRobotsTXT: true +# enableRobotsTXT: Enable generation of robots.txt file. When enabled this +# will overwrite the default robots.txt file that disallows crawling. +# Default to false and set to true for production in config/production/hugo.yaml +enableRobotsTXT: false # aasetDir: Location where Hugo looks for assets assetDir: static diff --git a/config/production/hugo.yaml b/config/production/hugo.yaml index e700c8563..19f72e671 100644 --- a/config/production/hugo.yaml +++ b/config/production/hugo.yaml @@ -1 +1,4 @@ -baseURL: https://interlisp.org \ No newline at end of file +baseURL: https://interlisp.org + +# enableRobotsTXT: Enable generation of Robots.txt file +enableRobotsTXT: true diff --git a/static/robots.txt b/static/robots.txt new file mode 100644 index 000000000..ba0d14348 --- /dev/null +++ b/static/robots.txt @@ -0,0 +1,5 @@ +# Placeholder file. Overwritten in production by setting enableRobotsTXT to true +# See config/production/hugo.yaml +# +User-agent: * +Disallow: / \ No newline at end of file