Readme

本頁使用了標題或全文手工轉換
維基百科,自由的百科全書
(重新導向自讀我檔案
cURL的讀我檔案

讀我檔案(英文:Readme,中國大陸又稱為“自述文件”),是隨着軟件發佈的一種說明文件,裏面通常包含有軟件的描述或使用的注意事項。這種檔案通常是純文字檔案,被命名為README.TXT、README.1ST或READ.ME等等,但也有RTFDOCMarkdown格式的讀我檔案。檔名通常是以大寫英文字母組成,這是因為大寫字母比小寫字母有着較小的ASCII碼,因此在一些以ASCII順序來排序檔案名稱的作業系統裏,它會被列在檔案列表的第一個。即使這些人沒有關於讀我檔案的知識,這種檔案的特殊命名方式也能夠使任何人迅速發現。

內容[編輯]

讀我檔案的內容通常包含:

  • 設置指南
  • 安裝指南
  • 操作指南
  • 檔案列表(隨着軟件而發佈的檔案)
  • 著作權聲明
  • 軟件作者的聯絡方法
  • 已知程式錯誤
  • 疑難排解
  • 致謝
  • 更新記錄

通用介面說明[編輯]

讀我檔案偶爾也會被用來形容一些提供資訊的檔案,包含讀我檔案普遍的內容。在一些開放原始碼的程式,特別是以GNU建置系統打包的檔案裏,通常會包含:

  • README:一般資訊
  • AUTHORS:作者
  • THANKS:致謝
  • ChangeLog:更新記錄,通常為程式管理員而設
  • NEWS:更新記錄,但專為用戶而設
  • INSTALL:安裝指南
  • COPYING:著作權聲明
  • BUGS:已知程式錯誤,亦包括回報錯誤的方法[1]
  • FAQ:有關軟件的問答[1]
  • TODO:更新預告

額外閱讀[編輯]

  • Johnson, Mark. Building a Better ReadMe. Technical Communication (Society for Technical Communication). February 1997, 44 (1): p28–36. (原始內容存檔於2013-11-04). 
  • Livingston, Brian. Check your Readme files to avoid common Windows problems. InfoWorld. 14 September 1998, 20 (37): p34. 

參考[編輯]

  1. ^ 1.0 1.1 Manes, Stephen. README? Sure--before I buy!. PC World. November 1996, 14 (11): p366.