進入正確的詞條
修改現有詞條時,先開啟該詞條的當前語言頁面,再用閱讀器的編輯入口;編輯器會帶入對應原始檔。新建時從貢獻中心開啟詞條編輯器,在頂部“檔案”選單選擇新建詞條,指定實體型別與源語言。簡中、日文、英文是維護源;臺灣與香港繁體由簡中生成,不直接建立繁體源稿。
閱讀器中的“完善此詞條”、待補全提示和完善度缺項也會開啟同一詞條的編輯器;它們不是不同的投稿渠道。百科目錄的“新建詞條”進入編輯器的新建流程。篩選無結果不代表詞條不存在,請先清除條件、搜尋別名,避免重複建立。
填寫內容與屬性
正式寫作前,請同時開啟內容與格式完整指南:它保留原有的結構、命名、文風、來源、時間、媒體、隱私和多語言規範,以及各類詞條骨架和提交前清單。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。
- 在網站倉庫建立本次投稿分支;沒有寫入許可權時先 Fork。確認目標是維護者指定的開發分支,不直接寫釋出分支。
- 將原圖放入
public/images/下合適目錄,以小寫英文檔名標識內容;確認大小寫和副檔名。GitHub 網頁上傳單檔案上限為 25 MiB,倉庫靜態資源審計也有限制,更大的檔案先與維護者核對。 - 在同一分支和 PR 修改相應 Markdown,填寫來源、作者及使用依據。倉庫地址
public/images/example.jpg對應頁面地址/images/example.jpg。不要填/public/images/...、本機路徑、臨時blob:網址或 GitHub 的檔案瀏覽頁面地址。 - 在 PR 的 Files changed 核對圖片和 Markdown 都已進入提案。合併、部署後再訪問實際圖片地址與詞條;上傳成功本身不會更新頁面。
若圖片先前已部署,可直接在編輯器引用其 /images/... 地址;若圖片與新詞條同批提交,線上預覽在部署前可能顯示斷圖。替換圖片優先使用新檔名,並搜尋封面、正文和其他語言引用,避免舊圖快取或斷鏈。站點縮圖不會覆蓋倉庫原圖。
提交前逐項核對
- 該實體是否已經存在別名或其他語言版本;主分類是否與詳細地圖一致。
- 事實、日期、引文和圖片是否有可追溯來源;沒有證據的內容是否明確標為待核實。
- 原正文中的正確內容、未知擴充套件語法及來源是否保留;差異是否只包含本次有意修改。
- 正文目錄、錨點、圖片地址、關聯 ID 和多語言身份是否在預覽中正確。
- 回執是否提供記錄編號;沒有回執時先查創作者中心,不重複建立相同 PR。