요구 사항과 의존성
Hugo #
SeoTax의 최소 Hugo 버전은 theme.toml 기준 0.159.0입니다.
extended 버전과 embedded 프로토콜을 지원하는 네이티브 Dart Sass가 필요합니다.
Hugo는 기본 또는 extended 설치에 Dart Sass를 포함하지 않으므로, sass 실행 파일이 PATH에
없으면 hugo server와 사이트 빌드가 no Dart Sass binary found in $PATH
오류로 실패합니다.
hugo version
sass --embedded --versionmacOS 또는 Linux에서 Homebrew를 사용한다면 brew install sass/sass/sass로
설치하세요. Windows에서는 Chocolatey의 choco install sass 또는 Scoop의
scoop install sass를 사용할 수 있습니다. 위 확인 명령은 protocolVersion과
compilerVersion이 포함된 JSON을 출력해야 합니다. npm의 sass 패키지는
이 프로토콜을 지원하지 않아 Hugo 빌드가 멈출 수 있습니다. 출력에 dart2js가
표시된다면 네이티브 Dart Sass를 설치하고 해당 경로를 PATH의 앞쪽에 둔 뒤
Hugo를 실행하세요.
브라우저 JavaScript #
검색, 클라이언트 i18n, 다크모드 저장, 이미지 확대 같은 기능은 JavaScript를 사용합니다.
JavaScript가 꺼져 있어도 정적 본문은 읽을 수 있지만 동적 검색과 일부 편의 기능은 제한됩니다.
포함 라이브러리 #
| 라이브러리 | 용도 |
|---|---|
| Fuse.js | 퍼지 검색 |
| highlight.js | 코드 문법 강조 |
| highlightjs-line-numbers | 코드 줄 번호 |
| Mermaid | 다이어그램 |
| KaTeX | 수식 |
주요 프런트엔드 리소스는 테마의 static/에 포함되어 있어 기본 기능에 별도 npm 설치가 필요하지 않습니다.