(そして、なぜ jQuery チームはまともなドキュメントを書くことができない、または書きたがらないと思いますか?;)
たとえば、http://jqueryui.com/download/all/にアクセスして、次のいずれかをダウンロードします。
#1
- ファイルがあり
MANIFESTます。 - ファイルはあり
README.mdますが、アーカイブのレイアウトの説明はありません。 - JSON 拡張子を持つファイルがいくつかあります
ui.accordion.jquery.json。これらには、特定の UI ウィジェットに関する情報が含まれています。これらが何に使われているのかわかりません。 - という名前のファイル
package.json。JSON形式のライブラリ情報のようです。これが何のためにあるか知っていますか？他のファイルにリンクされていると思われ.jsonますが、誰が知っていますか? externaljavascript を保持するという名前のディレクトリがあります。これが何のためにあるか知っていますか？- ファイルがあり
jquery-1.9.1.jsます。縮小版はありません。 - のライセンス
MIT-LICENSE.txt。 - 寄稿者の名前を含む
AUTHORS.txtファイルで、アーカイブ全体で数回繰り返されます。ただし、アーカイブにあるものを完全にリストすることができた人は一人もいません;) - Web サイトのすべてのデモの
demosように見えるディレクトリ。 Gruntfile.jsREADME に記載されているAは、jQuery のビルドに使用されます。jQueryの「構築」が意味するものは何でも。testsディレクトリ。uiすべての jQuery UI エフェクト JavaScript を保持しているように見えるという名前のディレクトリがあり、これもサブディレクトリに縮小されています。またi18n、国際化が必要なウィジェット用のサブディレクトリもあります。- という名前のディレクトリがあり
themesます。baseその中には、基本テーマのスタイルシートを保持するというサブディレクトリがあります。このサブimagesディレクトリには、基本テーマのディレクトリも含まれています。また、いくつかのエフェクトのスタイルシートも保持していますjquery.ui.accordion.css。これらは基本テーマでのみ機能しますか、それともどのテーマにも適用できますか? そうでない場合、なぜベースだけにそれらがあるのですか? (下記参照)minifiedすべてのスタイルシートの縮小版を含むサブディレクトリもあります。
#2
- アーカイブには
MANIFESTファイルが含まれています - しかしREADMEはありません。
- AUTHORS ファイル。
package.jsonプロジェクトに関する少量の情報を含むファイル。- いくつかのテーマがありますが、ありません
base。 - ルート ディレクトリにも各テーマのディレクトリにもエフェクト/ウィジェット ファイルはありません。
- 各テーマ ディレクトリには、
imagesそのテーマに関連付けられた画像ファイルを含むサブディレクトリ、jquery-ui.cssスタイルシート、これの縮小版、およびjquery.ui.theme.css.jquery-ui.css各テーマ ディレクトリ内の は、ディレクトリごとに異なります。これらの各ファイルの目的を知っていますか?jquery.ui.theme.css特定の変更がすべてファイルに反映されていないのはなぜですか?
なぜこれを知る必要があるのですか？
これはコメントに出てくるかもしれないので、ここで答えます。Ruby Rack プロジェクト、Rack JQueryUIおよびRack JQueryUI Themesに正しいバージョン/テーマをデプロイするのに役立つライブラリをいくつか作成しました。jQuery UI のバージョンが変更されるたびに、これらの文書化されていないアーカイブに対処する必要があり、バージョン間でレイアウトやコンテンツも変更されているようです。jQueryチームと話したとき、良いフィードバックはありませんでした-彼らはドキュメントで嘆かわしく、それは明らかに彼らにとって優先事項ではありません.関数などの名前を変更したいと思っています.私はここにいて、これはそれを保管するのに適した場所になります (いわば、彼らの手の届かないところに)。
テーマディレクトリに関する質問に最も興味があります。これは今すぐ直接役立つからですが、質問の範囲を拡大しました。他の人にも役立つと信じており、興味があるからです。