docs+feat: 重构规格与 Gitea 式 SSR 骨架（首页）

在 rebuild/gitea-ssr 落地产品规格、Cursor 规则，以及 Go 模板 SSR 首页/板块列表；未迁移路径仍回落 SPA，便于对照 main。 Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-29 03:11:25 +08:00
parent 4dc3bbb13f
commit 1414c71dec
28 changed files with 2891 additions and 24 deletions
--- a/templates/base.tmpl
+++ b/templates/base.tmpl
@@ -0,0 +1,51 @@
+{{define "base"}}
+<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+  <meta charset="UTF-8"/>
+  <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
+  <title>{{.Title}}</title>
+  {{if .Description}}<meta name="description" content="{{.Description}}"/>{{end}}
+  <link rel="stylesheet" href="/ssr-assets/site.css"/>
+</head>
+<body class="j13-body">
+  <header class="j13-header">
+    <div class="j13-header__inner">
+      <a class="j13-brand" href="/">
+        <span class="j13-brand__mark">{{.LogoMark}}</span>
+        <span class="j13-brand__text">
+          <strong>{{.SiteName}}</strong>
+          {{if .Slogan}}<span class="j13-brand__slogan">{{.Slogan}}</span>{{end}}
+        </span>
+      </a>
+      <nav class="j13-nav">
+        {{if .LoggedIn}}
+          <a href="/compose">发帖</a>
+          <a href="/messages">消息</a>
+          <a href="/profile">{{.ViewerName}}</a>
+          {{if .IsAdmin}}<a href="/admin/dashboard">后台</a>{{end}}
+        {{else}}
+          <a href="/login">登录</a>
+          <a href="/register">注册</a>
+        {{end}}
+      </nav>
+    </div>
+  </header>
+  <div class="j13-layout">
+    <aside class="j13-aside j13-aside--left">
+      <a class="j13-aside__link{{if eq .ActiveBoard 0}} is-active{{end}}" href="/">全部帖子</a>
+      {{range .Boards}}
+      <a class="j13-aside__link{{if eq $.ActiveBoard .ID}} is-active{{end}}" href="/board/{{.ID}}">{{.Name}}</a>
+      {{end}}
+    </aside>
+    <main class="j13-main">
+      {{template "content" .}}
+    </main>
+  </div>
+  <footer class="j13-footer">
+    <p>{{.SiteName}} · Gitea 式 SSR 骨架</p>
+  </footer>
+  <script src="/ssr-assets/site.js" defer></script>
+</body>
+</html>
+{{end}}
--- a/templates/embed.go
+++ b/templates/embed.go
@@ -0,0 +1,6 @@
+package templates
+
+import "embed"
+
+//go:embed *.tmpl
+var FS embed.FS
--- a/templates/home.tmpl
+++ b/templates/home.tmpl
@@ -0,0 +1,42 @@
+{{define "home"}}{{template "base" .}}{{end}}
+
+{{define "content"}}
+<section class="j13-feed">
+  <header class="j13-feed__header">
+    <h1 class="j13-feed__title">{{if .BoardName}}{{.BoardName}}{{else}}全部帖子{{end}}</h1>
+    <div class="j13-sort" role="navigation" aria-label="排序">
+      <a class="{{if eq .Sort "latest"}}is-active{{end}}" href="{{sortURL .ActiveBoard "latest"}}">最新发帖</a>
+      <a class="{{if eq .Sort "reply"}}is-active{{end}}" href="{{sortURL .ActiveBoard "reply"}}">最新回复</a>
+      <a class="{{if eq .Sort "hot"}}is-active{{end}}" href="{{sortURL .ActiveBoard "hot"}}">热门讨论</a>
+    </div>
+  </header>
+
+  {{if not .Posts}}
+  <p class="j13-empty">暂无帖子。登录后可以发第一帖。</p>
+  {{else}}
+  <ul class="j13-post-list">
+    {{range .Posts}}
+    <li class="j13-post-item">
+      <a class="j13-post-item__title" href="/post/{{.ID}}">{{.Title}}</a>
+      <div class="j13-post-item__meta">
+        {{if .Pinned}}<span class="j13-tag j13-tag--pin">置顶</span>{{end}}
+        {{if .Featured}}<span class="j13-tag j13-tag--feat">精华</span>{{end}}
+        {{if .BoardName}}<span class="j13-tag">{{.BoardName}}</span>{{end}}
+        <span>{{.AuthorName}}</span>
+        <span>{{.CreatedLabel}}</span>
+        <span>{{.CommentCount}} 回复</span>
+      </div>
+    </li>
+    {{end}}
+  </ul>
+  {{end}}
+
+  {{if or .HasPrev .HasMore}}
+  <nav class="j13-pager">
+    {{if .HasPrev}}<a href="{{pageURL .ActiveBoard .Sort .PrevPage}}">上一页</a>{{end}}
+    <span>第 {{.Page}} 页</span>
+    {{if .HasMore}}<a href="{{pageURL .ActiveBoard .Sort .NextPage}}">下一页</a>{{end}}
+  </nav>
+  {{end}}
+</section>
+{{end}}