Saved on 2026-01-13T06:03:46Z

Author: NightVoyager

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "themes/FixIt"]
+	path = themes/FixIt
+	url = https://github.com/hugo-fixit/FixIt.git

CLAUDE.md

@@ -0,0 +1,69 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+This is a Hugo-based personal blog (夜航星 / Night Voyager) using the FixIt theme. The site is in Chinese (zh-CN) and covers topics like cognitive psychology, learning methods, data analysis, and programming.
+
+- **Base URL:** https://austinxt.github.io (Custom domain: blog.nightvoyager.top)
+- **Theme:** FixIt (installed as git submodule in `themes/FixIt/`)
+
+## Common Commands
+
+```bash
+# Development server with live reload
+hugo server
+
+# Development with full rebuild on changes (use when editing layouts)
+hugo server --disableFastRender
+
+# Production build (outputs to public/)
+hugo
+
+# Create new post
+hugo new posts/YYYY-MM-DD-title.md
+
+# Create new talk/note
+hugo new talks/YYYY-MM-DD-title.md
+```
+
+## Architecture
+
+### Content Organization
+- `content/posts/` - Published articles (~70 posts)
+- `content/talks/` - Discussion notes and quick thoughts (~43 entries)
+- `content/draft/` - Draft articles (not published)
+
+### Configuration
+- `config.toml` - Main Hugo configuration including SEO verification codes, menu structure, theme settings, and markup options
+
+### Custom Layouts
+- `layouts/_partials/head/seo.html` - Enhanced SEO metadata template with JSON-LD schema, AI-friendly tags, and search engine verification codes
+
+### Static Assets
+- `static/robots.txt` - SEO crawler rules including explicit AI crawler permissions (GPTBot, Claude-Web, etc.)
+- `static/ai.txt` - AI usage policy declaration (CC-BY-NC-4.0 license)
+- `static/CNAME` - GitHub Pages custom domain configuration
+
+### Theme
+The FixIt theme is a git submodule. Do not modify files inside `themes/FixIt/` directly. Use `layouts/` directory for customizations that override theme templates.
+
+## Front Matter Template
+
+Posts use YAML front matter with these key fields:
+```yaml
+title: Post title
+subtitle: Subtitle
+date: YYYY-MM-DD
+description: SEO description
+tags: [tag1, tag2]
+categories: [category]
+featuredImage: /images/image.jpg
+lightgallery: true
+mathjax: false  # Enable per-post for math content
+```
+
+## Deployment
+
+The site deploys to GitHub Pages. After running `hugo`, commit the `public/` directory and push to trigger deployment.

layouts/partials/head/seo.html layouts/_partials/head/seo.htmllayouts/partials/head/seo.html renamed to layouts/_partials/head/seo.html

@@ -1,4 +1,4 @@
-{{- $params := .Scratch.Get "params" -}}
+{{- $params := partial "function/params.html" -}}
 
 {{- with .Site.Params.verification.google -}}
     <meta name="google-site-verification" content="{{ . }}" />
@@ -55,7 +55,7 @@
             "description": {{ . | safeHTML }},
         {{- end -}}
         {{- $image := .Site.Params.seo.image -}}
-        {{- with dict "Path" $image "Resources" .Resources | partial "function/resource.html" -}}
+        {{- with dict "Path" $image | partial "function/resource.html" -}}
             "image": {
                 "@type": "ImageObject",
                 "url": "{{ .Permalink }}",
@@ -68,7 +68,7 @@
             {{- end -}}
         {{- end -}}
         {{- with .Site.Params.seo.thumbnailUrl -}}
-            {{- with dict "Path" . "Resources" $.Resources | partial "function/resource.html" -}}
+            {{- with dict "Path" . | partial "function/resource.html" -}}
                 "thumbnailUrl": "{{ .Permalink }}",
             {{- else -}}
                 "thumbnailUrl": "{{ . | absURL }}",
@@ -109,7 +109,7 @@
             "image": [
                 {{- range $index, $value := . -}}
                     {{- if gt $index 0 }},{{ end -}}
-                    {{- with dict "Path" $value "Resources" $.Resources | partial "function/resource.html" -}}
+                    {{- with dict "Path" $value | partial "function/resource.html" -}}
                         {
                             "@type": "ImageObject",
                             "url": "{{ .Permalink }}",
@@ -147,7 +147,7 @@
             "@type": "Organization",
             "name": {{ $publisher.name | safeHTML }}
             {{- $logo := $publisher.logoUrl -}}
-            {{- with dict "Path" $logo "Resources" .Resources | partial "function/resource.html" -}}
+            {{- with dict "Path" $logo | partial "function/resource.html" -}}
                 ,"logo": {
                     "@type": "ImageObject",
                     "url": "{{ .Permalink }}",

resources/_gen/assets/css/config.template.scss_3432a4991371ae5c6b23cd4e90145273.content

@@ -0,0 +1,3 @@
+:root{--fi-base:"/";--fi-logo-img:url("/images/fixit.min.svg");--fi-loading-img:url("/images/loading.min.svg")}
+
+/*# sourceMappingURL=config.min.css.map */

resources/_gen/assets/css/config.template.scss_3432a4991371ae5c6b23cd4e90145273.json

@@ -0,0 +1 @@
+{"Target":"css/config.min.css","MediaType":"text/css","Data":{}}