Skip to content

Mount all Drasi Server tutorials and fix Hugo v0.164 build errors - #264

Merged
ruokun-niu merged 4 commits into
drasi-project:mainfrom
ruokun-niu:drasi-server-tutorial-mounts
Aug 5, 2026
Merged

Mount all Drasi Server tutorials and fix Hugo v0.164 build errors#264
ruokun-niu merged 4 commits into
drasi-project:mainfrom
ruokun-niu:drasi-server-tutorial-mounts

Conversation

@ruokun-niu

@ruokun-niu ruokun-niu commented Aug 4, 2026

Copy link
Copy Markdown
Contributor

Description

Adds the newly authored Drasi Server tutorials to the docs site and fixes two build failures introduced by Hugo v0.164. Previously only Getting Started was mounted from the learning-drasi-server module; the other tutorials existed in the source repo but were never surfaced on the site.

Screenshot 2026-08-04 at 12 56 56 PM

Changes

  • Mount all tutorials — added Hugo module mounts for building-comfort, high-risk-containers, and curbside-pickup alongside the existing getting-started, so each appears under Drasi Server → Tutorials.
  • Fix security.allowContent build error — Hugo v0.164+ blocks text/html content by default, which caused the build to fail on HTML assets in the module (e.g. curbside-pickup/webui/src/static/index.html, the viewer app). Each mount now excludes README.md and all *.html files via the new files glob syntax.
  • Migrate deprecated mount setting — replaced excludeFiles = "/README.md" (deprecated in Hugo v0.153.0) with files = ['! /README.md', '! **/*.html'].
  • Fix deprecated language key — renamed languageName = "English" to label = "English" (deprecated in Hugo v0.158.0).
  • Bump tutorials module — updated docs/go.mod to the latest main of learning-drasi-server so the new tutorial content resolves locally. (Production CI already pulls @main on every build.)

Type of change

  • This pull request fixes a bug in Drasi and has an approved issue (issue link required).
  • This pull request adds or changes features of Drasi and has an approved issue (issue link required).
  • This pull request is a minor refactor, code cleanup, test improvement, or other maintenance task and doesn't change the functionality of Drasi (issue link optional).

Fixes: #263

@ruokun-niu ruokun-niu self-assigned this Aug 4, 2026
@ruokun-niu
ruokun-niu requested review from a team and a lite review from Copilot August 4, 2026 20:10

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates the docs site configuration to surface all Drasi Server tutorials from the learning-drasi-server Hugo module, and applies Hugo config/workflow tweaks intended to address newer Hugo deprecations and content-security build failures.

Changes:

  • Mount additional tutorial folders (building-comfort, high-risk-containers, curbside-pickup) into content/drasi-server/tutorials/*.
  • Migrate Hugo config away from deprecated settings (excludeFilesfiles, languageNamelabel).
  • Update the Pages deploy job condition to also allow deploys from workflow_dispatch runs on main.

Reviewed changes

Copilot reviewed 3 out of 4 changed files in this pull request and generated no comments.

File Description
docs/go.sum Adds checksums for the updated learning-drasi-server pseudo-version.
docs/go.mod Bumps the learning-drasi-server module version to pick up new tutorial content.
docs/config.toml Adds mounts for all Drasi Server tutorials and updates Hugo config keys/globs for newer Hugo behavior.
.github/workflows/website.yaml Allows the deploy job to run for manual dispatches on main in addition to pushes.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Signed-off-by: Ruokun Niu <ruokunniu@microsoft.com>
@ruokun-niu
ruokun-niu merged commit a92282d into drasi-project:main Aug 5, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Drasi Server only shows the getting started tutorial

4 participants