Document submodule init step for Docker workflow#132
Closed
yqtian-se wants to merge 2 commits intoacmsigsoft:mainfrom
Closed
Document submodule init step for Docker workflow#132yqtian-se wants to merge 2 commits intoacmsigsoft:mainfrom
yqtian-se wants to merge 2 commits intoacmsigsoft:mainfrom
Conversation
Contributor
There was a problem hiding this comment.
Pull request overview
This PR updates the local development documentation to make the Docker workflow produce a complete Hugo site build. It fits into the repository by clarifying setup for contributors working on the SIGSOFT website without a local Hugo installation.
Changes:
- Add a
git submodule update --init --recursivestep to the Docker-based local preview/build instructions. - Explain that the Hugo theme submodule must be present or the generated site will be incomplete and many routes will 404.
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
The dart-sass-embedded snap is deprecated and snap store outages
were causing transient failures ("unable to contact snap store").
Pulling the prebuilt binary from the sass/dart-sass GitHub release
is what Hugo's official docs now recommend.
Without initializing the hugo-universal-theme submodule, the Docker build only produces a handful of pages and most URLs return 404.
yqtian-se
force-pushed
the
readme-docker-submodules
branch
from
ecfbf75 to
ad217ea
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Without initializing the hugo-universal-theme submodule, the Docker build only produces a handful of pages and most URLs return 404.