|
リードミー
リードミー（Readme）とは、ソフトウェアを配布する際の添付文書のひとつ。配布物の一般的な情報を記載したファイルである。多くの場合、そのソフトウェアをインストールし使用する前に読むべきものとされている。 リードミーファイルはたいていの場合、テキストファイルであるが、Windows、macOSではリッチテキストフォーマットが標準で参照できるため、それが採用されていることもある[要出典]。 内容リードミーに記載される内容は以下のものがある。配布物に関する情報をすべて詰め込んだものから、最小限の情報のみをリードミーに記載し、更新履歴、インストール方法、更新履歴、ライセンスなどの各情報を記載した別ファイルへのポインタを示した簡略なものまで様々である。
ファイル名MS-DOS・Microsoft Windows の場合単に「 日本語で配布されるソフトウェアには、「お読みください」「はじめにお読みください」「読んでね」など日本語のファイル名を用いているものもある。 ライブラリ・プラグインといった「いちディレクトリ内に複数のソフトウェアおよび各リードミーが混在することになる可能性が高いソフトウェア形態」では、他者と衝突しやすい一般的なファイル名を避け、各ソフトウェアの固有名詞をもとにした命名もよく用いられる。たとえば、配布物「 なお、ここでは例をすべて大文字で表記したが、大文字・小文字の使いかたは統一されていない傾向がある。 Unix系OSの場合Unix系のオープンソースのパッケージ、特にGnits standardsに従ったGNU Autotoolsで作成されたパッケージでは、READMEに加えて次のファイルで構成されている事が多い。また、Autotoolsを使用していない場合も慣例的に、これらのファイル名を用いる場合が多い。他のファイルと区別するため、一般的に大文字で表されることが多く、Microsoft Windows文化におけるREADMEの取り扱いよりも、より明確に記載されている情報を探し出すことができる。
GitHubといったコードレベルでのホスティングサービスにおいても、ルートディレクトリにあるREADMEをそのプロジェクトの説明を表わすものとして特別視し、その内容をウェブ形式に書式化したものを表示する機能も存在する。これは、慣例的に同じファイル名を用いる UNIX文化ならではの利便性の上に成り立っている仕組みである。 作成方法単にテキストエディタを使用して作成するほか、項目を記入して整形されたテキストファイルを出力するリードミー作成専用のツールも配布されている。また、統合開発環境や、GNU Autotoolsのようなフレームワークには、リードミーも含めた添付文書を生成する機能があるものが多い。 関連項目外部リンク
|
Portal di Ensiklopedia Dunia
