jquery-ui - jQuery UI下载-存档中的每个目录是什么？

Question

（为什么您认为jQuery团队无法或不愿意编写体面的文档？；）

例如，转到http://jqueryui.com/download/all/并下载


jQuery UI 1.10.3 (source, demos, themes, tests)
jQuery UI 1.10.3 Themes


＃1


有一个MANIFEST文件。
有一个README.md文件，但没有说明存档的布局。
有几个带有JSON扩展名的文件，例如ui.accordion.jquery.json。它们包含有关特定UI小部件的一些信息。我不知道这些用什么，你知道吗？
名为package.json的文件。似乎只是一些JSON格式的库信息。你知道这是干什么的吗？我怀疑它已链接到其他.json文件，但是谁知道呢？
有一个名为external的目录，其中包含JavaScript。你知道这是干什么的吗？
有jquery-1.9.1.js文件。没有缩小版。
MIT-LICENSE.txt中的许可证。
一个AUTHORS.txt文件，其中包含贡献者的名称，在整个存档中重复了几次。但是，没有一个人能够彻底列出档案中的内容；）
一个demos目录，其中似乎是all the demos from the website.
README所说的Gruntfile.js用于构建jQuery。不管“构建” jQuery意味着什么。
tests目录。
有一个名为ui的目录，该目录似乎包含所有jQuery UI效果javascript，它们也在一个子目录中最小化，还有一个i18n子目录，用于需要国际化的那些小部件。
有一个名为themes的目录。其中有一个名为base的子目录，用于保存基本主题样式表。该子目录还包含基本主题的images目录。它还包含一些效果的样式表，例如jquery.ui.accordion.css。这些仅适用于基本主题还是可以应用于任何主题？如果没有，为什么只有基地有他们？ （请参见下文）还有一个minified子目录，其中包含所有样式表的缩小版本。


＃2


存档包含一个MANIFEST文件
但没有自述文件。
作者文件。
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团队交流时，我没有很好的反馈-我发现它们在文档方面令人遗憾，并且对他们来说显然不是优先考虑的事情，他们宁愿重命名函数或其他内容-所以我只想找一个有用的答案我在这里，这将是一个很好的保留它的地方（可以这么说）。

我对主题目录周围的问题最感兴趣，因为这将立即对我有帮助，但是我扩展了问题的范围，因为我相信它将对其他人有所帮助，并且我很好奇。

Answer 1

让我们首先解释一下jQuery UI下载是什么：它们是开发和生产文件的完整捆绑。请记住，jQuery UI每天被下载超过11,000次（这仅仅是下载生成器的用法）。这些下载的使用方式可能因用户而异。这些下载的内容旨在服务于最大数量的用户。必须注意，开发包几乎是源存储库的精确副本。

来源，演示，主题，测试


MANIFEST：这是一个文件，其中包含zip中所有其他文件的列表以及校验和。很少有用户会关心清单，但是对于那些关心清单的人，它提供了关键信息。
README.md ：（请注意，您列出了README.txt）：这是jquery-ui git存储库的自述文件。它是在GitHub上查看项目时所看到内容的精确副本。
*.json：这些是jQuery Plugin Registry的插件清单文件。这些文件从不存储在master分支（或任何其他分支）中，而是始终包含在标记中。因为它们提供了有用的信息，所以它们包含在下载中。您可以read more about the manifest file structure。
package.json：package.json是与npm / node一起使用的标准文件。所有jQuery项目都依靠node进行插入，测试，构建，发布等操作。这与用于jQuery Plugin Registry的其他JSON文件完全分开。它们具有非常相似的结构，因为插件清单文件是基于npm设计的。
external：此目录包含在演示和测试中使用的第三方脚本。
jquery-1.9.1.js：这是测试jQuery UI的jQuery的最新稳定版本。我们绝不会在jQuery UI存储库中包含缩小的jQuery版本，因为它们极易调试。
MIT-LICENSE.txt：该许可证定义了可以在下载中使用文件的条款。
AUTHORS.txt：jquery-ui存储库的参与者列表。这不包括jQuery UI项目其他部分的贡献者，例如我们各个站点或文档中的任何内容。
demos：所选组件（在本例中为所有组件）的演示目录。演示实际上起源于jquery-ui存储库，并在发行期间复制到jqueryui.com。
Gruntfile.js：我们将Grunt用于整理，测试和构建。 Grunt是节点的JavaScript任务运行程序。构建jQuery UI意味着缩小和串联。
tests：所选组件（在本例中为所有组件）的测试目录。
ui：源文件的副本，其中@VERSION替换为发行版的版本号。 jquery-ui.js文件是在构建期间通过将所有源文件连接在一起而生成的。 minified目录是在构建期间通过最小化单个文件生成的。当然，jquery-ui.min.js是通过级联和最小化源文件生成的。
themes：源文件的副本，其中@VERSION替换为发行版的版本号。关于连接和缩小，这与ui目录经历相同的过程。各个组件文件与主题无关。因此jquery.ui.accordion.css将适用于任何主题。这些是与JS文件一起使用所需的CSS文件。您可以构建所需的任何主题，但是如果您不对组件使用功能性CSS，则不能保证任何工作。完整主题（几乎所有用户实际使用的主题）在一个文件中包含所有功能CSS以及主题CSS。


主题

主题由ThemeRoller生成。它们不存在于任何存储库中，因此不包含任何存储库的工件。这就是为什么没有自述文件的原因。


MANIFEST：与上面相同，清单包含下载中文件的校验和。
AUTHORS.txt：jquery-ui中AUTHORS.txt的副本。这应该与源下载完全匹配。虽然这不是为主题做出贡献的人员的列表，但我们将其视为代码的一部分，并包含相同的作者列表。
package.json：jquery-ui中package.json的副本。该文件确实看起来有些奇怪，因为它不是来自存储库。我们可能应该删除它。
themes：生成主题的目录。这些不包含源变量/令牌。基本主题不是生成的主题，因此不包括在内。您会注意到，生成的主题也具有不同的目录结构。每个主题包含三个文件：jquery.ui.theme.css只是主题CSS；这就是基本主题中提供的功能CSS可以使用的功能。 jquery-ui.css是完整主题；它包括主题CSS和功能CSS。 jquery-ui.min.css是jquery-ui.css的缩小副本。