Jquery ui jQuery UI下载-归档文件中的每个目录都包含哪些内容？

（为什么您认为jQuery团队不能或不愿意编写像样的文档？；）

例如，转到并下载

#1

• 有一个

  清单

  文件
• 有一个

  README.md

  文件，但并没有解释归档文件的布局
• 有几个文件具有JSON扩展名，例如

  ui.accordion.jquery.JSON

  。它们包含关于特定UI小部件的一些信息我不知道这些是用来干什么的，你知道吗？
• 名为

  package.json

  的文件。它似乎只是一些JSON格式的库信息你知道这是干什么用的吗？我怀疑它链接到了其他

  .json

  文件，但谁知道呢
• 有一个名为

  external

  的目录，其中包含javascripts你知道这是干什么用的吗？
• 这里有

  jquery-1.9.1.js

  文件。没有缩小版本

• MIT-LICENSE.txt

  中的许可证
• 一个

  AUTHORS.txt

  文件，其中包含贡献者的名称，在整个归档中重复多次。但是，他们中没有一个人能够彻底列出归档中的内容；）
• 一个

  demos

  目录，其中显示
• 自述文件中提到的用于构建jQuery的

  grunfile.js

  。无论jQuery的“构建”是什么意思

• 测试

  目录
• 有一个名为

  ui

  的目录，它似乎保存了所有jQueryUIEffectsJavascripts，也在一个子目录中缩小，还有一个

  i18n

  子目录用于那些需要国际化的小部件
• 有一个名为

  themes

  的目录。其中有一个名为

  base

  的子目录，它保存基本主题样式表。此子目录还包含基本主题的

  images

  dir。它还保存一些效果的样式表，例如

  jquery.ui.accordion.css

  这些仅适用于基本主题，还是可以应用于任何主题？如果没有，为什么只有base有它们？（见下文）还有一个

  缩小的
  子目录，它有所有样式表的缩小版本

#2

• 存档包含一个

  清单

  文件
• 但没有自述
• 作者档案
• 包含少量项目信息的

  package.json

  文件
• 它有几个主题，但没有

  base

• 根目录或每个主题目录中都没有效果/小部件文件
• 每个主题目录都包含一个

  images

  子目录，其中包含与该主题相关联的图像文件、一个

  jquery ui.css

  样式表、该样式表的缩小版本以及一个

  jquery.ui.theme.css

  。每个主题目录中的

  jqueryui.css

  对于每个目录都是不同的您知道这些文件的用途吗？为什么

  jquery.ui.theme.css文件中的所有具体更改都不是
  文件？

为什么我需要知道这些？ 这可能会出现在评论中，所以我将在这里回答。我已经编写了几个库来帮助在Ruby Rack项目中部署正确的版本/主题，以及。每次jQueryUI发生版本更改时，我都必须处理这些未记录的归档文件，这些文件在版本之间的布局/内容似乎也会发生变化。在与jQuery团队交谈时，我没有得到很好的反馈-我发现他们对文档很遗憾，这显然不是他们的优先事项，他们宁愿重命名函数或其他东西-所以我宁愿有人在这里帮助回答我，这将是一个很好的地方（可以说是他们够不到的地方）

---

我最感兴趣的是关于主题目录的问题，因为这将直接帮助我，但我扩展了问题的范围，因为我相信它将帮助其他人，我很好奇。

让我们从解释jQuery UI下载是什么开始：它们是一个完整的开发和生产文件包。请记住，jQueryUI每天下载超过11000次（这只是下载生成器的使用情况）。用户使用这些下载的方式可能会有很大差异。这些下载的内容旨在为最多的用户提供服务。需要注意的是，开发包几乎是源存储库的精确副本

来源、演示、主题、测试

• 清单

  ：这是一个包含zip中其他所有文件的列表以及校验和的文件。很少有用户关心清单，但对于那些关心清单的用户来说，清单提供了关键信息

• README.md

  ：（注意，您列出了

  README.txt

  ）：这是jquery ui git存储库的自述文件。如果您在GitHub上查看项目，它将与您看到的内容完全相同

• *.json

  ：这些是用于的插件清单文件。这些文件从不存储在主分支（或任何其他分支）中，而是始终包含在标记中。因为它们提供了有用的信息，所以它们包含在下载中。你可以

• package.json

  ：package.json是与/一起使用的标准文件。所有jQuery项目都依赖于节点来执行linting、测试、构建、发布等操作。这与jQuery插件注册表中的其他JSON文件完全不同。它们的结构非常相似，因为插件清单文件是基于npm设计的

• external

  ：此目录包含演示和测试中使用的第三方脚本

• jquery-1.9.1.js

  ：这是jqueryui测试所针对的jquery的最新稳定版本。我们从不在中包含缩小的jQuery版本