4.0 KiB
提交內容更新和勘誤
所有人都可以通過 https://github.com/shuowenjiezi/shuowen 爲 說文解字 http://www.shuowen.org 提交內容更新和勘誤。
關於此文檔
這個文檔是寫給不會使用 github 的朋友的，如果你已經熟悉 clone 和 pull request，可以跳過此文檔。
提交更新的步驟
（1）克隆代碼庫
前往：https://github.com/shuowenjiezi/shuowen 並點擊頁面上的 “Clone or download” 按鈕
（2）查找您要更新的文件
說文解字 網站上所有的字頭都有對應的編號，可以通過鏈接地址找到字頭的編號。比如“帝”字的鏈接地址是 http://www.shuowen.org/view/7 ，那麼“帝”字的編號就是 “7”，對應的代碼庫文件就是 7.json。
先找到您要修改的字頭編號，然後到克隆的版本庫的 data 目錄下面去找以「編號」+「.json」命名的文件，比如「嚏」字的編號是 831，那麼對應的文件名就是 “831.json”。需要注意的是，因爲 data 目錄下面的文件太多，github 默認不展示全部文件，所以最簡單的方式就是點擊 “Find file” 搜索文件：
進入搜索界面後，輸入您要找的文件名即可：
（3）修改文件內容
找到要修改的文件後，可以直接在線編輯：
文件內容的格式是 JSON，關於內容格式的定義，請參考 “格式說明”。
內容修改完成後，點擊 “Preview changes” 查看版本對比。
在預覽頁面上面，紅色背景表示被修改的內容，綠色背景表示更新後的版本。
（4）提交編輯內容
確認修改內容後，可以提交編輯內容。請務必備註修改的內容，格式爲：
[修改原因，包括“完善”和“勘誤”] #字頭編號 - 字頭 - 被修改的內容
例如：[勘誤] #172 - 𤧩 - 反切由 “鳥貫切” 更新爲 “烏貫切”
填寫好備註信息後，點擊 “Commit changes” 提交。
（5）推送更新
到目前爲止，所有的更新都基於克隆後的代碼庫，現在需要將更新推送到原始代碼庫，要發送合併請求，只需要點擊 “New pull request” 按鈕，
在合併請求頁面，首先確認合併的目標分支是 dev，而不是 master，然後點擊 “Create pull request” 按鈕，
填入更新描述，可直接使用第四步輸入的備註信息，如果需要，也可以在下面的文本框裏面輸入更多描述內容，然後點擊 “Create pull request” 按鈕，
到這裏，一個完整的更新流程就結束了。
我會在收到合併請求後，確認更新內容，然後合併到 說文解字 的代碼庫，在一段時間之後，會從代碼庫加載數據到 說文解字 的數據庫，至此，更新的數據便會顯示到 說文解字 的網站上面。