站點工具

DOCUMENTS / CONTRIBUTE

編輯與新建百科詞條

從閲讀器進入編輯器,補全屬性與來源,核對差異後提交 GitHub PR。

進入正確的詞條

修改現有詞條時,先打開該詞條的當前語言頁面,再用閲讀器的編輯入口;編輯器會帶入對應源文件。新建時從貢獻中心打開詞條編輯器,在頂部“文件”菜單選擇新建詞條,指定實體類型與源語言。簡中、日文、英文是維護源;台灣與香港繁體由簡中生成,不直接創建繁體源稿。

閲讀器中的“完善此詞條”、待補全提示和完善度缺項也會打開同一詞條的編輯器;它們不是不同的投稿渠道。百科目錄的“新建詞條”進入編輯器的新建流程。篩選無結果不代表詞條不存在,請先清除條件、搜尋別名,避免重複創建。

填寫內容與屬性

正式寫作前,請同時打開內容與格式完整指南:它保留原有的結構、命名、文風、來源、時間、媒體、隱私和多語言規範,以及各類詞條骨架和提交前清單。Markdown、frontmatter、媒體短語法與字段實例則在語法與屬性完整指南;這兩份是完整參考,不是本章的簡寫替代品。

先搜尋別名,避免重複實體。新詞條的穩定 ID 使用小寫英文、數字及連字符,跨語言保持一致;顯示名稱可翻譯,ID 不隨改名變化。按類型完成編輯器標明的必填屬性,再寫正文。封面、關係、表演者、製作署名等字段在“詞條屬性”填寫;不要把網頁 URL 當成倉庫文件路徑。佔位詞條也應寫明已確認資料與來源,不用猜測填滿字段。

編輯區與預覽可並排查看;用大綱檢查章節、目錄和錨點。插入內容可從按鈕或 / 菜單選擇,源碼模式用於保留擴展語法。修改舊詞條時不要為了排版刪除原有事實、引用或未知語法;提交前查看差異,核對圖片、關聯和資料來源。

圖片與附件

詞條附件屬於 GitHub PR 鏈路,不是設定圖庫。編輯器可選取、拖入或粘貼 PNG/JPEG/WebP 原圖,並要求填寫來源;附件先保存在當前瀏覽器,提交時與正文進入同一個 PR。當前站內限制為單張 750 KB、最多 8 張、合計 4 MB,不會自動壓縮。超過限制的原圖須按 GitHub 倉庫投稿流程上傳,並在同一 PR 中引用;填寫圖片網址不會自動上傳文件。倉庫 public/images/... 對應網頁地址 /images/...,不能填本機路徑或 /public/images/...。

檢查、提交與繼續

檢查必填項、事實來源、正文預覽、關聯、語言及修改説明。登錄且投稿服務可用時,點擊頂部提交 GitHub PR;提交回執給出記錄入口。若按鈕顯示投稿暫不可用,先保存或導出草稿,勿把本機保存理解為已投稿。提案審核、GitHub 合併和站點部署完成後,修改才出現在公開詞條;退回意見與繼續編輯見審核説明。

元數據決定哪些頁面出現內容

舊貢獻指南的字段表仍適用於 V3。schemaVersion: 2 是元數據協議,不是網站 V3 版本號。先在編輯器選擇實體類型,再按實際字段填寫;不要把所有關係僅寫在正文裏。

字段頁面用途投稿時檢查
id、locale、entityType跨語言身份、內容類型與規範地址同一實體的三種源語言沿用同一 ID;不要重用別的實體 ID。
name 或 title標題與目錄名使用可靠的官方名稱;譯名與原名可分別標註。
presentation.image、presentation.theme封面、閲讀器背景與局部主題色圖片地址能直接打開,顏色不替代正文證據。
presentation.morphing圖片+名字的形態切換僅用於同一譜系中真實存在的獨立檔案。
classification.primary、classification.additional主歸檔及額外分類入口主分類決定規範位置;額外分類不能複製正文。
relations、performers、credits關聯檔案、作品署名與反向鏈接填穩定實體 ID,並確認關係類型。
sources、license可核對來源及文字許可許可不能替代媒體使用依據。
contentStatus、lifecycle佔位/正式內容與活動狀態不確定的日期留空;佔位不等於猜測填滿。

分類以詳細分類地圖及當前目錄配置為準。一個詞條可以出現在多個分類入口,但只有一份各語言正文和一個規範地址。新團體成員需要團體實體及真實的 member-of 關係;不要因為人物也在個人活動,就自動把團體成員放入個人層級。歌曲演唱者用 performers,作品製作署名用 credits,團體所屬用對應關係。修改主歸檔或舊路徑會涉及重定向,應交由維護者檢查,不能只移動文件。

大於站內附件限制的原圖

下面是舊圖片指南中仍有效的 GitHub 流程,只適用於詞條附件;圖庫始終走圖庫上傳器。原圖保留原始字節、分辨率和格式,無須為了投稿強制轉成 WebP。

  1. 在網站倉庫建立本次投稿分支;沒有寫入權限時先 Fork。確認目標是維護者指定的開發分支,不直接寫發佈分支。
  2. 將原圖放入 public/images/ 下合適目錄,以小寫英文文件名標識內容;確認大小寫和擴展名。GitHub 網頁上傳單文件上限為 25 MiB,倉庫靜態資源審計也有限制,更大的文件先與維護者核對。
  3. 在同一分支和 PR 修改相應 Markdown,填寫來源、作者及使用依據。倉庫地址 public/images/example.jpg 對應頁面地址 /images/example.jpg。不要填 /public/images/...、本機路徑、臨時 blob: 網址或 GitHub 的文件瀏覽頁面地址。
  4. 在 PR 的 Files changed 核對圖片和 Markdown 都已進入提案。合併、部署後再訪問實際圖片地址與詞條;上傳成功本身不會更新頁面。

若圖片先前已部署,可直接在編輯器引用其 /images/... 地址;若圖片與新詞條同批提交,線上預覽在部署前可能顯示斷圖。替換圖片優先使用新文件名,並搜尋封面、正文和其他語言引用,避免舊圖緩存或斷鏈。站點縮略圖不會覆蓋倉庫原圖。

提交前逐項核對

  • 該實體是否已經存在別名或其他語言版本;主分類是否與詳細地圖一致。
  • 事實、日期、引文和圖片是否有可追溯來源;沒有證據的內容是否明確標為待核實。
  • 原正文中的正確內容、未知擴展語法及來源是否保留;差異是否只包含本次有意修改。
  • 正文目錄、錨點、圖片地址、關聯 ID 和多語言身份是否在預覽中正確。
  • 回執是否提供記錄編號;沒有回執時先查創作者中心,不重複創建相同 PR。

KAMITSUBAKI WIKI

登入觀測站

沿用 AI 助手帳戶。登入後可在不同設備同步收藏,閲讀百科無需登入。

我的空間 →