一起寫下神椿
把你知道的,留給下一個喜歡神椿的人。
一個錯字、一條來源、一句更準確的翻譯,都是值得留下的貢獻。從你熟悉的詞條開始,先完成一處小修改。
你準備編輯的文件
在 GitHub 編輯此文件 ↗選擇適合你的投稿方式
修改或新建詞條、添加圖片,均可使用站內編輯器;公告和其他倉庫檔案請走 GitHub。兩種方式都需要維護者審核。
在站內完成第一次投稿
使用已有的 GitHub 或 Google 帳戶登入 Wiki,無需配置令牌或自己創建分支。
支持藝人、歌曲、專輯、企劃和日誌的新建與修改,可附加 PNG、JPEG、WebP 圖片。支持簡中、日文、英文,繁中由簡中生成;公告仍使用 GitHub。
登入並找到原文
開啟編輯器,點擊“編輯舊詞條”。輸入名稱或路徑,按類型篩選,確認標題和語言後選擇結果。也可以從詞條攜帶原文連結進入。加載完成後再開始編輯;替換現有草稿前先備份。
新建詞條與圖片
在頂部“檔案”菜單選擇“新建詞條”,選擇類型、語言並填寫目錄;隨後在“詞條屬性”補齊資料。“圖片附件”可選擇、拖入或粘貼圖片,填寫來源後加入,再插入正文或設為封面。圖片先儲存在本機,提交審核時與正文進入同一個 PR。最多 8 張、合計 4 MB,每張原圖不超過 750 KB,不會壓縮;更大原圖通過 GitHub 上傳,詳見圖片與檔案教程。
直接寫,隨時看效果
桌面首次進入並排展示正文和實時預覽,手機在編輯與預覽標籤間切換。在正文中輸入;選中文字可加粗、添加連結、注音或劇透遮罩。點擊“插入內容”或在空段落輸入 /,會在目前位置開啟可搜尋的插入菜單;方向鍵選擇、Enter 插入、Esc 關閉。⌘ K 開啟全局命令面板。正文 Enter 新建段落,Shift+Enter 換行。用無序/有序列表按鈕,或輸入 - 空格、1. 空格開始列表;Enter 繼續,空項目 Enter 退出,Tab / Shift+Tab 調整層級。
核對屬性與來源
“屬性”中檢查名稱、日期和條目標識;不要隨意更改路徑與 id。新增事實附上直接支持它的來源。用“專注寫作”擴大正文區域,用“閲讀預覽”檢查連結、表格和複雜內容。
儲存草稿,查看差異
瀏覽器草稿自動儲存在目前設備。開啟“提交審核”面板,可以手動儲存、讀取帳戶下的雲端草稿,保留 90 天。含圖片的草稿只儲存在本機;重要修改仍建議下載 Markdown 備份,另行保管原圖。提交前檢查差異,確認沒有意外刪掉原文。
填寫説明並提交審核
填寫這次改了什麼、為什麼改,以及相關資料來源,再提交。網站會代你創建 GitHub PR。提交後內容與説明會公開;草稿儲存不等於已投稿,投稿也不等於已上線。
跟進意見,繼續完善
在“投稿與評論”查看自己的投稿、檢查結果和審核討論。繼續修改會更新同一 PR;遇到衝突先核對雙方改動。可撤回投稿,評論和記錄保留。站內目前只讀評論,回覆與審核在 GitHub 完成;合併並部署後正式詞條才會更新。
上傳較大原圖或自行管理分支?切換 GitHub 流程版,並閲讀圖片與檔案教程。
通過 GitHub 提交修改
適合直接修改 Markdown、新建詞條、上傳已獲授權的圖片或修改其他倉庫檔案。可視化編輯器在這個流程裏也可作為寫作與導出工具。
準備分支
登入 GitHub,開啟目標檔案並選擇編輯。沒有寫權限時按提示 Fork;有寫權限時也將修改提交到新分支。
修改與核對
保留頂部 YAML、條目標識和已有來源。可以直接編輯 Markdown,也可在站內編輯器完成修改後導出完整檔案,粘貼到 GitHub。新圖片必須提交圖片檔案,不能只填寫本地路徑。
創建並跟進 PR
向原倉庫 main 創建 PR,寫明改動與來源。等待自動檢查和維護者審核;收到意見後提交到同一分支。合併後等待站點部署完成。
先選一件你想做的小事
挑一個你熟悉的方向,再按六步完成一次真實修改。用時只是參考,隨時可以保存草稿、下次繼續。
這次從這裏開始先確認原句,再只改必要的文字;如果改變了事實,也要補來源。
查看對應步驟 →進度只保存在當前瀏覽器;清理瀏覽器數據後會丟失。
第一次貢獻,跟着這六步走
點開當前步驟,邊看邊做。完成標準是給自己的檢查,不會自動提交內容。
圈定這一處修改
先確定一個小目標和一個可核對的來源。
圈定這一處修改
先確定一個小目標和一個可核對的來源。
載入原文,不用從空白開始
從詞條進入,或在編輯器裏搜尋現有內容。
載入原文,不用從空白開始
從詞條進入,或在編輯器裏搜尋現有內容。
- 在詞條頁點擊 編輯源文件,會先來到這份指南。上方會顯示目標路徑。
- 點擊 打開可視化編輯器。支持的詞條會載入原有資料與正文;已有草稿時,先按提示備份再決定是否替換。
- 也可以在編輯器右上角點 編輯舊詞條,搜尋名稱或文件路徑,再點 載入原文。
- 核對標題、正文和語言。路徑末尾的
zh.md、ja.md、en.md分別是簡體中文、日文和英文。
讀原文失敗時: 重試;或到 GitHub 打開對應文件的 Raw 原文,使用“導入原文”粘貼完整文件,也可選擇不超過 1 MB 的 .md 文件。兩條 --- 之間的資料也要保留。
網站指南、公告和首頁文案不在可視化編輯器的五類詞條範圍內。編輯這些文件時,使用上方提供的 GitHub 鏈接。
編輯器裏的標題、語言和正文都對應目標詞條;沒有用空白稿覆蓋舊文件。
像寫文章一樣完成修改
常用格式在工具欄,複雜內容按需插入。
像寫文章一樣完成修改
常用格式在工具欄,複雜內容按需插入。
先點擊中間的段落,直接改文字。正文從二級標題開始,頁面標題已有獨立位置。
| 想做什麼 | 在哪裏操作 |
|---|---|
| 加粗、斜體、加鏈接 | 選中文字,使用頂部或浮動工具欄 |
| 高亮、注音、劇透黑幕 | 使用工具欄對應項目;需要解釋或讀音時填寫彈窗 |
| 插入標題、列表、圖片、表格 | 在空段落按 /,或點“插入內容”,搜尋內容類型 |
| 修改圖片説明、表格、歌詞 | 點擊對應內容塊,查看右側“屬性” |
| 調整內容順序 | 使用內容塊的上移、下移;也可拖動塊柄 |
| 找到一段文字 | 使用左側“查找正文”;大綱可跳到章節 |
| 改標題、日期等資料 | 左側“屬性”中的“詞條資料” |
練習一次加來源: 選中“官方公告”四個字 → 點“添加鏈接” → 填真實公告地址 → 應用 → 在右側預覽核對文字和鏈接。
遇到“原樣保留的內容”,説明這一段含複雜語法。先保留它;需要修改時切到“源碼”,對照語法參考小範圍修改。解析錯誤時先修正 YAML,再切回可視化;不要為消除提示刪除整段資料。
預覽中只出現預期改動,標題層級和原有複雜內容仍完整。
把事實和來源一起留下
讓下一個讀者能沿着鏈接查到依據。
把事實和來源一起留下
讓下一個讀者能沿着鏈接查到依據。
新增發行日期、製作人員、活動經歷等事實時,優先核對官方作品頁、公告、正式採訪或出版資料。鏈接應直接支持附近那句話,不能只放一個網站首頁。
寫法可以是:“官方作品頁列出了該曲的作詞與作曲信息。”隨後添加對應作品頁鏈接。不要把“我很喜歡”改寫成“廣受好評”;來源有評價時,説明是誰作出的評價。
- 名稱和日期以來源為準;不把搜尋摘要、AI 回答或粉絲猜測當成依據。
- 圖片需説明來源並確認可使用;已有授權字段不要刪。編輯器填寫圖片地址,不會替你上傳圖片文件。
- 引用、翻譯和歌詞要核對原文,保留已有署名、翻譯者及授權信息。
- 不確定的內容先不寫,在 PR 中説明缺什麼資料。
AI 可以幫你檢查表達、整理你提供的來源或解釋錯誤,但最終逐項核對的是你。不要讓它猜日期、製作人員、譯文含義或歌詞時間。
每個新增事實都有直接支持它的來源,署名和授權信息沒有丟失。
預覽、檢查,再導出
瀏覽器裏的草稿,還沒有提交到網站。
預覽、檢查,再導出
瀏覽器裏的草稿,還沒有提交到網站。
- 打開 閲讀預覽,從頭讀一遍;檢查標題、鏈接、圖片説明、表格和摺疊內容。窄屏可用底部“閲讀預覽”切換查看。
- 點擊底部 導出前檢查,補齊提示中的必填資料。這能發現字段問題,不能替你判斷事實是否正確。
- 查看底部草稿狀態。“草稿已保存在此瀏覽器”只代表本地保存,不會同步到其他設備;重要修改請下載備份。
- 右上 導出 Markdown → 複製完整 Markdown,或 下載 .md。複製的是完整文件,包括頂部資料。
- 有有效文件路徑時,同一菜單提供 打開 GitHub 文件位置。把完整 Markdown 粘貼到該文件的編輯區,不要只粘正文後誤刪資料。
在 GitHub 的 Preview / Changes 或差異視圖再核對一次。GitHub 不一定能渲染本站的注音、媒體和歌詞短語法,這些效果以站內預覽為參考,最終還需網站構建檢查。
暫停也沒關係: 信息未齊時可先下載草稿,不必為了消除提示填猜測或佔位數據。
備份已保存;全文包含原有資料;差異中只有打算提交的修改。
把修改交給維護者
保存 Commit 後,還要創建 Pull Request。
把修改交給維護者
保存 Commit 後,還要創建 Pull Request。
第一次用 GitHub? 到 GitHub 註冊創建個人賬號並驗證郵箱。免費賬號即可完成公開倉庫貢獻;練習編輯不需要提前註冊。登錄後回到目標文件的編輯頁面。
- 沒有倉庫寫入權限時,GitHub 會引導你創建 Fork(你賬號下的副本)。按頁面提示繼續。
- 粘貼修改並核對差異,點 Commit changes… / Propose changes 保存。説明寫清實際變化,例如“修正詞條中的重複文字”。Commit 只是保存記錄。
- 繼續進入 Compare & pull request / Create pull request。確認目標倉庫為
LinkTh1rsty/kamitsubaki-wiki-site、目標分支為維護者當前指定的開發分支,來源是你的修改分支。 - 寫一句清晰標題,用下方模板説明改動、來源和檢查結果,然後創建 PR。出現帶編號的 Pull Request 頁面,才算已交給維護者。
接下來會發生什麼? Checks 是自動檢查:運行中就稍等,失敗就看具體錯誤;通過後仍需維護者審閲。收到補來源或改格式的意見很正常。回到同一個 Fork 的同一分支修改並再次 Commit,新提交會加入原 PR,不必重複開一個。
合併表示修改已進入主分支,正式網站還要等待部署成功。PR 和提交記錄會留下貢獻歷史,頁面上的貢獻者信息可能稍後才更新。
界面措辭可能變化,可查 GitHub 網頁編輯説明與 從 Fork 創建 PR。
已打開帶編號的 PR 頁面,説明裏寫清改動和來源;知道如何查看後續意見。
先認路,再動手
對應現在的詞條編輯器。桌面可並排寫作與預覽,窄屏按需切換側欄和預覽。
- 左側 · 找到位置
- “詞條”搜尋名稱或路徑;“大綱”跳到章節;“屬性”填寫詞條類型、語言與資料。
- 中間 · 寫正文
- 直接編輯文字。選中文字會出現格式工具;空段落按 /,或點“插入內容”添加內容塊。
- 右側 · 看效果、調內容
- “閲讀預覽”檢查排版;選中內容塊後,在“屬性”裏調整圖片、表格、歌詞等設置。
- 底部與右上 · 檢查、帶走
- 底部查看草稿保存狀態與“導出前檢查”;右上“導出 Markdown”複製全文或下載 .md。
做完第一處修改,再學你需要的
新建詞條、翻譯和歌詞各有自己的檢查重點,不必一次學完。
新建歌曲、專輯或其他詞條
先檢查是否已有,再準備資料和目錄。
新建歌曲、專輯或其他詞條
先檢查是否已有,再準備資料和目錄。
先在網站與編輯器中搜索名稱和別名。已有詞條就補寫它;確實缺少時,在編輯器“大綱”頂部使用“新建詞條”,再到“屬性”選擇類型和語言。新建會替換當前草稿,先下載需要保留的內容。
藝人、歌曲、專輯、企劃、活動記錄的必填字段不同,以“導出前檢查”為準。標題、條目標識和來源先確定,再添加有內容的章節;不要造空章節來湊完整度。
- 歌曲位於
src/content/songs/<主要表演者或 collaborations>/<id>/<locale>.md,由performers自動推導。 - 唱片位於
src/content/releases/<releaseType 對應類別>/<id>/<locale>.md。 - 人物、團體、企劃等路徑由分類地圖和實體類型推導。不要複製舊版
artists/、albums/模板,也不要猜測資料夾。
以上 new-song、new-album 只是目錄示意。提交前用實際標識替換;先核對歌曲的藝人、曲種、製作信息,專輯的發行信息、曲序和曲目關聯。圖片另行上傳到倉庫,頁面填對應地址。
在左側“屬性”展開“GitHub 文件路徑(可選)”,填寫包含語言文件名的完整路徑。導出菜單會據此打開 GitHub 的新建文件位置;填寫路徑本身不會創建文件。
同一詞條的語言文件共用穩定 id,並保持實體類型與關係字段一致。新條目應準備 zh.md、ja.md、en.md;暫時無法完成某種語言時,在 PR 明確説明,不要把未翻譯內容偽裝成完成版本。路徑不確定時讓編輯器根據元數據生成,或查閲內容目錄指南。
翻譯與繁體中文
保持同一個詞條,不丟原文、標識和署名。
翻譯與繁體中文
保持同一個詞條,不丟原文、標識和署名。
修改已有翻譯時,載入目標語言原文,再對照來源逐句核對。語言選擇器只設置內容語言,不會自動翻譯正文;不要在舊文件中只改語言就覆蓋另一個版本。
各版本保留相同的穩定 id、entityType 和關係身份,日期、作品編號與人員關係保持一致。姓名和作品名優先採用官方寫法;未確定的譯名在 PR 中説明依據。
繁體中文由簡體中文自動生成,修改原稿 zh.md,不要編輯生成的 zh-tw.md、zh-hk.md。局部需要台灣或香港用詞時,可查語法參考的“混合簡繁轉換與生成文件”,編輯器工具欄“···”也有“繁體用詞覆寫”。
歌詞翻譯應保留對應原文、譯者與授權信息。先改進確定的一句,不用一次完成整首。
歌詞、注音與學習模式
先把一行對齊,再考慮逐字時間軸。
歌詞、注音與學習模式
先把一行對齊,再考慮逐字時間軸。
在歌曲中插入“雙語歌詞”,在屬性裏填寫原文、假名、羅馬音和譯文。先預覽一行,確認分組對應,再繼續下一行;“文字注音”適合給普通正文中的詞語注音。
要做同步歌詞,先試聽同一版本的音源,填寫該行開始時間(例如 00:03.50);需要逐字同步時再拆分逐字單元,並逐個核對時間。開始時間應遞增,原文與譯文應對應。沒有準確時間就留空,使用普通歌詞展示,不要按字數平均分配或讓 AI 猜時間。
閲讀器的歌詞學習可切換假名、羅馬音與譯文顯示,逐句練習;這些顯示依賴原文結構正確。合併後還要在正式閲讀器檢查對應關係和播放同步,編輯器預覽不等於完整音源聯調。
複雜歌詞 HTML 會原樣保留。修改前下載原文,按語法參考的“逐字歌詞時間軸”核對結構,保留原譯者和版權説明。
源碼、媒體和本地開發
需要時再走到這裏。
源碼、媒體和本地開發
需要時再走到這裏。
“源碼”顯示完整 Markdown:兩條 --- 之間是 YAML 資料,後面是正文。可視化無法處理的內容保留為原文塊;不要為了換模式刪除未知字段或複雜排版。
媒體使用編輯器的“媒體播放”或“多平台媒體切換”,填寫受支持平台的真實鏈接。圖片地址不等於上傳成功;倉庫圖片需另行添加。表格、摺疊內容、代碼塊和數學公式可從“插入內容”選擇,完整語法按需查參考。
熟悉 Git 的貢獻者可以 Fork、建立分支後本地編輯。按倉庫 README 配置環境,提交前運行 pnpm check、pnpm test、pnpm build,並在實際頁面檢查內容。只用網頁編輯時,不必安裝這些工具;在 PR 中如實説明做過哪些檢查。
修改指南本身請使用 GitHub 原文入口,保留 YAML 結構,並同步適用的語言版本。
隨用隨查
交給維護者前,再看一遍
- 目標詞條、語言和修改範圍正確
- 事實有來源,鏈接能打開,署名與授權保留
- 預覽完整,原有字段和複雜內容沒有誤刪
- 草稿已有備份,GitHub 差異已經看過
- PR 説明寫清實際檢查與尚未解決的問題
一份可以直接填寫的 PR 説明
把方括號中的提示換成這次的實際修改;沒有做的檢查不要寫“已通過”。
卡住了,也可以繼續
沒有 GitHub 賬號,現在能做什麼?
沒有 GitHub 賬號也可以使用 Google 登錄 Wiki,通過站內編輯器提交已有詞條的修改。只有直接走 GitHub 流程時才需要 GitHub 賬號;未登錄也可以編輯並下載本地草稿。
草稿保存了,為什麼網站還沒變?
保存草稿不會發布內容。站內流程還需要提交審核;GitHub 流程還需要創建 PR。兩種方式都要經過審閲、合併與成功部署。瀏覽器草稿留在本機,雲端草稿需在投稿面板手動保存。
找不到要改的文件,或載入失敗?
先檢查語言與路徑,在“編輯舊詞條”搜尋名稱;也可從 GitHub 獲取完整 Raw 原文後導入。指南、公告、首頁文案請直接在 GitHub 編輯。載入失敗時先備份當前草稿。
檢查變紅了,或維護者讓我修改?
打開失敗檢查的具體錯誤或評論,處理最先出現的問題。在原 PR 對應的分支修改並再次 Commit。看不懂就回復公開錯誤文字、目標文件和你做過的操作,請維護者協助。
我只會一點點,會不會添麻煩?
一處範圍清楚、來源明確的小修正很有價值。不確定就説明,不需要裝作全都知道。先完成自己能核實的部分,其餘可以在 PR 裏討論。
下一次,不必從頭再學。
收藏這份指南。下次從詞條進入編輯器,做一個你能核實的改進;遇到問題,在 PR 中説清楚卡在哪一步。你留下的來源和説明,也會幫助後來的人。
還不想編輯?也可以到倉庫 Issues 提供詞條鏈接、具體錯誤與可核對來源。先搜尋是否已有相同反饋。