Requirements and Dependencies
Hugo #
SeoTax requires Hugo 0.159.0 or later. Use the extended edition and install
native Dart Sass with embedded protocol support. Hugo does not bundle Dart Sass
with its standard or extended installation, and SeoTax requires the sass executable on your PATH to
compile its SCSS. Without it, hugo server and site builds fail with
no Dart Sass binary found in $PATH. Install Dart Sass in local development
and CI environments that build the site.
hugo version
sass --embedded --versionOn macOS or Linux with Homebrew, install Dart Sass with
brew install sass/sass/sass. On Windows, use Chocolatey (choco install sass)
or Scoop (scoop install sass). The embedded version check must print JSON
containing protocolVersion and compilerVersion. The npm sass package does
not support this protocol and can cause Hugo builds to hang. If the output
mentions dart2js, install native Dart Sass and place its directory first in
PATH before running Hugo.
Browser JavaScript #
Search, client-side i18n, stored color preference, and image zoom use JavaScript. Static article content remains readable without it.
Included Libraries #
SeoTax includes focused integrations for Fuse.js search, highlight.js code highlighting, Mermaid diagrams, KaTeX math, and Giscus or Disqus comments.