shuom

src/pages/people.astro

@@ -17,6 +17,24 @@ import { site } from "../data/site";
 
     <section>
       <div class="section-inner">
+        <aside class="data-guide" aria-labelledby="people-data-guide-title">
+          <div>
+            <p class="eyebrow">Data Guide</p>
+            <h2 id="people-data-guide-title">修改或添加同学数据</h2>
+            <p>
+              所有同学卡片都来自 <code>src/data/people.ts</code>。修改已有同学时，直接编辑对应对象；添加新同学时，复制一个对象并更换
+              <code>slug</code>、<code>name</code>、<code>location</code>、<code>school</code>、<code>direction</code>
+              等字段。
+            </p>
+          </div>
+          <ol>
+            <li><strong>自动提交：</strong>也可以在 GitHub 新建“更新「如今的我们」”issue，填完表单后会自动创建一个更新数据的 PR。</li>
+            <li><strong>照片：</strong><code>photo</code> 可留空；如需放照片，将图片放入 <code>public</code> 后填写以 <code>/</code> 开头的路径。</li>
+            <li><strong>关键词：</strong><code>keywords</code> 是数组，建议保留 1 到 3 个短词，列表页和个人页都会显示。</li>
+            <li><strong>个人页：</strong><code>currentStatus</code>、<code>highlight</code>、<code>toPastSelf</code>、<code>favoriteMemory</code> 和 <code>messageToClass</code> 会生成详情内容。</li>
+          </ol>
+        </aside>
+
         <div class="people-grid page-grid">
           {
             people.map((person) => (

src/styles/global.css

@@ -419,6 +419,51 @@ h2 {
   gap: 16px;
 }
 
+.data-guide {
+  display: grid;
+  grid-template-columns: minmax(0, 0.9fr) minmax(280px, 1.1fr);
+  gap: clamp(22px, 4vw, 46px);
+  align-items: start;
+  margin-bottom: 26px;
+  padding: clamp(22px, 4vw, 32px);
+  border: 1px solid var(--line);
+  border-radius: 8px;
+  background: #fff;
+  box-shadow: 0 8px 28px rgba(39, 55, 52, 0.06);
+}
+
+.data-guide h2 {
+  margin-bottom: 14px;
+  font-size: clamp(24px, 3vw, 34px);
+}
+
+.data-guide p {
+  margin: 0;
+  color: var(--muted);
+}
+
+.data-guide code {
+  color: var(--green);
+  font-weight: 800;
+}
+
+.data-guide ol {
+  display: grid;
+  gap: 12px;
+  margin: 0;
+  padding-left: 22px;
+  color: var(--muted);
+}
+
+.data-guide li::marker {
+  color: var(--green);
+  font-weight: 800;
+}
+
+.data-guide strong {
+  color: var(--ink);
+}
+
 .page-grid {
   align-items: stretch;
 }
@@ -1016,7 +1061,8 @@ h2 {
   .twikoo-sticky-wall .tk-comments-container,
   .twikoo-sticky-wall .tk-comments-list,
   .person-hero-inner,
-  .detail-grid {
+  .detail-grid,
+  .data-guide {
     grid-template-columns: 1fr;
   }