解決方案
論文有標題頁;研究軟體往往沒有。使用者能看到程式碼,卻看不到確切的作者名單、版本、DOI 或建議引用方式,因此軟體被引用得不一致,甚至完全未被引用。
Citation File Format 幾乎不需任何基礎設施就解決了這個問題。維護者在儲存庫根目錄加入 `CITATION.cff`,這是一個純文字 YAML 檔案。該檔案告訴人們與機器確切該如何引用這套軟體或資料集。
採用的關鍵槓桿是平台支援。GitHub 會讀取 CFF,並提供「Cite this repository」提示,附上 APA 與 BibTeX 輸出;Zenodo 與 Zotero 可以重複使用同一份中介資料,而不必要求作者重新輸入。
達成了什麼
把引用中介資料放在程式碼旁邊
為何奏效
檔名是慣例性的,且可在儲存庫根目錄被找到。
YAML 讓檔案保持人類可寫,同時仍具備足夠的結構以供驗證與轉換。
平台呈現把維護者的慣例變成終端使用者的工作流程。
建議引用讓軟體能指向一篇論文或資料集,同時不失去軟體中介資料。
可借鏡之處
當問題出在署名歸屬時,最好的標準可能是一個小小的檔案,放在使用者原本就會尋找專案的位置。
後續發展
CFF 成為程式碼託管與學術引用之間的實用橋樑。GitHub 記載了對 CITATION.cff 檔案的直接支援,並將其呈現為 APA 與 BibTeX,而 CFF 專案則指出 GitHub、Zenodo 與 Zotero 的支援。
追溯依據
參考來源
- Citation File Format (CFF) - Specifications Zenodo · zenodo.org ·
- About CITATION files GitHub Docs · docs.github.com