この記事は検証可能な参考文献や出典が全く示されていないか、不十分です。出典を追加して記事の信頼性向上にご協力ください。(このテンプレートの使い方)
出典検索?: "リードミー"
リードミー(Readme)とは、ソフトウェアを配布する際の添付文書のひとつ。配布物の一般的な情報を記載したファイルである。多くの場合、そのソフトウェアをインストールし使用する前に読むべきものとされている。
リードミーファイルはたいていの場合、テキストファイルであるが、Windows、macOSではリッチテキストフォーマットが標準で参照できるため、@media screen{.mw-parser-output .fix-domain{border-bottom:dashed 1px}}それが採用されていることもある[要出典]。 リードミーに記載される内容は以下のものがある。配布物に関する情報をすべて詰め込んだものから、最小限の情報のみをリードミーに記載し、更新履歴、インストール方法、更新履歴、ライセンスなどの各情報を記載した別ファイルへのポインタを示した簡略なものまで様々である。 単に「README」とするものをはじめ、一般的なテキストファイルの拡張子をつけた「README.TXT」、最初に読むべきものという意味で「README.1ST」としてあるもの、「README」を区切った「READ.ME」などといった名称が用いられる例もある。Microsoft Wordが一般化する以前は、ドキュメントファイルの意味で「README.DOC」という名称もよく用いられた。 日本語で配布されるソフトウェアには、「お読みください」「はじめにお読みください」「読んでね」など日本語のファイル名を用いているものもある。 ライブラリ・プラグインといった「いちディレクトリ内に複数のソフトウェアおよび各リードミーが混在することになる可能性が高いソフトウェア形態」では、他者と衝突しやすい一般的なファイル名を避け、各ソフトウェアの固有名詞をもとにした命名もよく用いられる。たとえば、配布物「HOGE.DLL」に対応して「HOGE.TXT」「HOGE_README.TXT」とするなど。 なお、ここでは例をすべて大文字で表記したが、大文字・小文字の使いかたは統一されていない傾向がある。 README一般的な情報 GitHubといったコードレベルでのホスティングサービスにおいても、ルートディレクトリにあるREADMEをそのプロジェクトの説明を表わすものとして特別視し、その内容をウェブ形式に書式化したものを表示する機能も存在する。これは、慣例的に同じファイル名を用いる UNIX文化ならではの利便性の上に成り立っている仕組みである。 単にテキストエディタを使用して作成するほか、項目を記入して整形されたテキストファイルを出力するリードミー作成専用のツールも配布されている。また、統合開発環境や、GNU Autotoolsのようなフレームワークには、リードミーも含めた添付文書を生成する機能があるものが多い。
内容
ソフトウェアの名前
バージョン
配布物に関する簡単な説明
ファイル構成
動作環境
インストールに関する情報と簡単な使用方法
作者に関する情報
更新履歴
既知の不具合
トラブルシューティング
謝辞
著作権情報とライセンス情報
(シェアウェアの場合)レジストキーの入手方法、試用期間中の制限事項
ファイル名
MS-DOS・Microsoft Windows の場合
Unix系OSの場合に従ったGNU Autotoolsで作成されたパッケージでは、READMEに加えて次のファイルで構成されている事が多い。また、Autotoolsを使用していない場合も慣例的に、これらのファイル名を用いる場合が多い。他のファイルと区別するため、一般的に大文字で表されることが多く、Microsoft Windows文化におけるREADMEの取り扱いよりも、より明確に記載されている情報を探し出すことができる。
AUTHORSクレジット表記
THANKS謝辞
Changelogプログラマー向けの詳細な変更履歴
NEWSユーザー向けの簡単な変更履歴
INSTALLインストール方法
COPYING / LICENSE著作権情報とライセンス情報
BUGS報告があった既知のバグ
作成方法
関連項目
マニュアル
オンラインソフトウェア
リリースノート
外部リンク
⇒フリーソフトウェア/シェアウェアに添付する文書ガイドライン(電子ネットワーク協議会)
.mw-parser-output .asbox{position:relative;overflow:hidden}.mw-parser-output .asbox table{background:transparent}.mw-parser-output .asbox p{margin:0}.mw-parser-output .asbox p+p{margin-top:0.25em}.mw-parser-output .asbox{font-size:90%}.mw-parser-output .asbox-note{font-size:90%}.mw-parser-output .asbox .navbar{position:absolute;top:-0.90em;right:1em;display:none}
.mw-parser-output .hlist ul,.mw-parser-output .hlist ol{padding-left:0}.mw-parser-output .hlist li,.mw-parser-output .hlist dd,.mw-parser-output .hlist dt{margin-right:0;display:inline-block;white-space:nowrap}.mw-parser-output .hlist dt:after,.mw-parser-output .hlist dd:after,.mw-parser-output .hlist li:after{white-space:normal}.mw-parser-output .hlist li:after,.mw-parser-output .hlist dd:after{content:" ・\a0 ";font-weight:bold}.mw-parser-output .hlist dt:after{content:": "}.mw-parser-output .hlist-pipe dd:after,.mw-parser-output .hlist-pipe li:after{content:" |\a0 ";font-weight:normal}.mw-parser-output .hlist-hyphen dd:after,.mw-parser-output .hlist-hyphen li:after{content:" -\a0 ";font-weight:normal}.mw-parser-output .hlist-comma dd:after,.mw-parser-output .hlist-comma li:after{content:"、";font-weight:normal}.mw-parser-output .hlist-slash dd:after,.mw-parser-output .hlist-slash li:after{content:" /\a0 ";font-weight:normal}.mw-parser-output .hlist dd:last-child:after,.mw-parser-output .hlist dt:last-child:after,.mw-parser-output .hlist li:last-child:after{content:none}.mw-parser-output .hlist dd dd:first-child:before,.mw-parser-output .hlist dd dt:first-child:before,.mw-parser-output .hlist dd li:first-child:before,.mw-parser-output .hlist dt dd:first-child:before,.mw-parser-output .hlist dt dt:first-child:before,.mw-parser-output .hlist dt li:first-child:before,.mw-parser-output .hlist li dd:first-child:before,.mw-parser-output .hlist li dt:first-child:before,.mw-parser-output .hlist li li:first-child:before{content:" (";font-weight:normal}.mw-parser-output .hlist dd dd:last-child:after,.mw-parser-output .hlist dd dt:last-child:after,.mw-parser-output .hlist dd li:last-child:after,.mw-parser-output .hlist dt dd:last-child:after,.mw-parser-output .hlist dt dt:last-child:after,.mw-parser-output .hlist dt li:last-child:after,.mw-parser-output .hlist li dd:last-child:after,.mw-parser-output .hlist li dt:last-child:after,.mw-parser-output .hlist li li:last-child:after{content:")\a0 ";font-weight:normal}.mw-parser-output .hlist ol{counter-reset:listitem}.mw-parser-output .hlist ol>li{counter-increment:listitem}.mw-parser-output .hlist ol>li:before{content:" "counter(listitem)" ";white-space:nowrap}.mw-parser-output .hlist dd ol>li:first-child:before,.mw-parser-output .hlist dt ol>li:first-child:before,.mw-parser-output .hlist li ol>li:first-child:before{content:" ("counter(listitem)" "}.mw-parser-output .navbar{display:inline;font-size:75%;font-weight:normal}.mw-parser-output .navbar-collapse{float:left;text-align:left}.mw-parser-output .navbar-boxtext{word-spacing:0}.mw-parser-output .navbar ul{display:inline-block;white-space:nowrap;line-height:inherit}.mw-parser-output .navbar-brackets::before{margin-right:-0.125em;content:"[ "}.mw-parser-output .navbar-brackets::after{margin-left:-0.125em;content:" ]"}.mw-parser-output .navbar li{word-spacing:-0.125em}.mw-parser-output .navbar-mini abbr{font-variant:small-caps;border-bottom:none;text-decoration:none;cursor:inherit}.mw-parser-output .navbar-ct-full{font-size:114%;margin:0 7em}.mw-parser-output .navbar-ct-mini{font-size:114%;margin:0 4em}.mw-parser-output .infobox .navbar{font-size:88%}.mw-parser-output .navbox .navbar{display:block;font-size:88%}.mw-parser-output .navbox-title .navbar{float:left;text-align:left;margin-right:0.5em}
表示
編集