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..8883a1a93 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,24 @@ 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 +- `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 - `Resources` - contains the current `Interlisp-D` logo, used on the home page, and another instance of `favicon.png` @@ -236,11 +242,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/hugo.yaml b/config/_default/hugo.yaml new file mode 100644 index 000000000..7e625d5e8 --- /dev/null +++ b/config/_default/hugo.yaml @@ -0,0 +1,52 @@ +# ******************************************************************* +# +# Hugo parameters for Interlisp.org +# +# An overview of hugo configuration files can be found at: +# https://gohugo.io/getting-started/configuration/#configure-server +# + +# relativeURLs: Enable to force all relative URLs to be relative to content root +relativeURLs: false + +# canonifyURLs: Convert relative URLs to absolute URLs +canonifyURLs: false + +# 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 + +# Enable .GitInfo object for each page. This will give values to .Lastmod etc. +enableGitInfo: false + +# Top Level Language defaults +# See languages.yaml for language specific values +defaultContentLanguage: "en" +defaultContentLanguageInSubdir: false + +# Useful when translating. +enableMissingTranslationPlaceholders: true + +# Disable rendering of the specified page kinds +disableKinds: + - taxonomy + - term + - RSS + +# Code Highlighting configuration +# 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 +# See https://help.farbox.com/pygments.html + +# Comment out if you don't want the "print entire section" link enabled. +# [outputs] +# section = ["HTML", "print"] 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..1f0069b6b --- /dev/null +++ b/config/_default/languages.yaml @@ -0,0 +1,13 @@ +# **************************************************************************** +# +# Language configuration +# +# See: https://gohugo.io/content-management/multilingual/ +# +en: + languageName: English" + # Weight used for sorting. + weight: 1 + 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 new file mode 100644 index 000000000..4b348b3fc --- /dev/null +++ b/config/_default/markup.yaml @@ -0,0 +1,29 @@ +# **************************************************************************** +# +# 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 + tabWidth: 4 + #lineNoStart: 1 + lineNos: false \ 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..5463cb427 --- /dev/null +++ b/config/_default/params.yaml @@ -0,0 +1,157 @@ +# -------------------------------------------------------------------- +# +# 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 +# +copyright: + authors: Interlisp.org + from_year: 2024 + license: MIT + +# 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_subdir: +github_project_repo: https://github.com/interlisp/medley + +# Google custom seach engine configuration +# gcs_engine_id: search engine +gcs_engine_id: 33ef4cbe0703b4f3a + +# 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" + 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-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" +# desc: "Practical questions and curated answers" + +# 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" + 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" + +taxonomies: +# 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: + feedback: + enable: true + 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 + # 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 + + # Set to false to disable the About link in the site footer + footer_about_enable: false + + ul_show: 3 + +# Identify the custom css files +custom_css: + - "css/custom.css" 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/hugo.yaml b/config/production/hugo.yaml new file mode 100644 index 000000000..19f72e671 --- /dev/null +++ b/config/production/hugo.yaml @@ -0,0 +1,4 @@ +baseURL: https://interlisp.org + +# enableRobotsTXT: Enable generation of Robots.txt file +enableRobotsTXT: true 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/hugo.yaml b/config/staging/hugo.yaml new file mode 100644 index 000000000..dcf0c6a77 --- /dev/null +++ b/config/staging/hugo.yaml @@ -0,0 +1,4 @@ +baseURL: https://wasm.interlisp.org +languageCode: en-us +title: 'Staging Environment' +publishDir: stage 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). - 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/hugo.toml b/hugo.toml deleted file mode 100644 index f06e9b403..000000000 --- a/hugo.toml +++ /dev/null @@ -1,283 +0,0 @@ -baseURL = "https://interlisp.org" - -relativeURLs = false -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", "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://interlisp.org/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_enable = 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-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" -# 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" 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}} 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