在过去的几天和几周里,您可能已经注意到我们一直在我们网站上推出的新主题。 事实上,除非这是您第一次浏览 jQuery 博客,否则这篇帖子看起来可能与您过去几年一直在看的帖子截然不同。 今天,随着这个新设计终于抵达 jquery.com,我们非常高兴揭开幕布,解释我们一直在做的事情,以及它如何超越简单的“改头换面”,而这仅仅是第一眼看到它时可能给您的感觉。
随着 jQuery 生态系统的不断发展,jQuery 团队越来越难以控制日益膨胀的文档、设计、CMS 安装和维基。 想报告和修复文档错误的社区成员无处可去,即使是那些有权限的人,情况也并没有好多少。 由于所有这些内容和设计都被锁定在生产环境中,被一系列不同的用户帐户保护起来,而且没有地方跟踪错误,因此可见性很低,进展最多只能说是逐渐的。 我们知道我们必须做出改变。
在过去的一年里,我们进行了一项大规模的努力,以整合和简化我们的网站基础设施,并开源所有我们的网站内容、文档和设计。 我们这样做是因为它已经极大地提高了我们自身协作和前进的能力,并且我们希望它能为所有希望找到参与 jQuery 的方法,但又不确定自己是否能够做出贡献的人打开新的参与途径。
好了,别再客套了,让我们开始介绍这个堆栈吧!
git + grunt + WordPress
我们已经将几乎所有文档和网站内容迁移到 GitHub 上的静态内容仓库,并根据内容类型使用 HTML、Markdown 或 XML 进行维护。现在,如果您发现任何拼写错误或认为需要澄清的内容,您可以提交问题,甚至发送带有修复的拉取请求。从jQuery.ajax
的源文档到jquery.com 的首页,再到此页面包含所有内容仓库的完整列表的原始 Markdown,所有内容都是开源的!
我们使用WordPress、自定义主题和多站点配置jquery-wp-content
,让这些内容在我们的网站上生动呈现。使用这个单一的 WordPress 实例,让我们可以更轻松、更有效地保持所有不同网站的外观和感觉一致,并保留了在需要时轻松添加动态功能(例如网站搜索和用户帐户)的能力。jquery-wp-content
还包含一个自定义安装脚本,可以轻松地为本地开发设置整个 jQuery 网站网络,为修复和新功能的实验提供更多空间。再次强调,这意味着如果您在任何 jQuery 网站上发现错误,都可以找到一个地方进行报告,如果您愿意,还可以自己修复!
(我们收到了来自 WordPress 开发者Andrew Nacin和Daryl Koopersmith的帮助,他们为创建和维护 jquery-wp-content
做出了巨大的贡献,在此我们对他们的辛勤工作表示感谢!)
WordPress 和静态内容仓库之间的链接是一个grunt
构建和部署流程,它会处理内容文件,并将它们同步到 WordPress 安装中,使用XML-RPC。这意味着我们从未使用过 WordPress 管理页面;所有的创作和编辑都可以在您最喜欢的文本编辑器中进行,然后 grunt
会完成艰苦的工作。
为了部署到我们的生产和测试服务器,我们只需使用 git webhooks 对内容仓库和 jquery-wp-content
的提交做出响应。每当在这些仓库的 master 分支上提交时,内容和设计就会立即反映在测试环境中,该环境只是网站 URL 的一个 stage.
子域前缀,例如,stage.jquery.com。要部署到生产网站,只需要用semver进行标记,然后推送标记。
除了今天为博客和 jquery.com
推出的新外观之外,我们还很高兴地推出一些全新的网站,它们都由这个系统驱动,如果您正在寻找参与 jQuery 的方式,这些网站会特别有用。
贡献 jQuery
URL: contribute.jquery.org | 仓库: github.com/jquery/contribute.jquery.org
我们新的中心,提供有关如何实际开始为 jQuery 和开源项目做出贡献的信息。它还包含许多对贡献者有用的资源,例如我们的CLA 表格和样式指南,这些指南在所有项目中使用。
jQuery IRC 中心
URL: irc.jquery.org | 仓库: github.com/jquery/irc.jquery.org
jQuery 基金会广泛使用 Internet Relay Chat 来提供支持和项目交流。在这里,我们托管频道日志,并提供有关如何连接以及到达那里后会发生什么的文档。
jQuery 品牌指南
URL: brand.jquery.org | 仓库: github.com/jquery/brand.jquery.org
随着我们最近更新了许多用于代表 jQuery 的约定,我们也发布了这些指南,以便社区能够更好地了解如何使用(以及不能使用)jQuery 基金会项目的名义和标志。
在接下来的几周内,我们也会告别一些子域,我们想提前通知您,以便您在必要时做好准备。
我们最初的 MediaWiki 文档和综合网站多年来一直很好地发挥着作用,但现在是时候把它放到一边了。我们会继续将这个网站上的热门 URL 重定向到它们更现代的对应网站。
托管我们自己的聚会网络是一个有趣的尝试,但该网站几乎没有使用,而且我们管理起来很麻烦,所以我们将关闭它。我们建议组织者使用其他更成熟的平台,例如meetup.com。
除了我们刚刚推出的新网站外,我们还将在接下来的几天和几周内继续推出其他新网站,并将更多现有网站整合到新的主题中。我们对目前的工作效果非常满意,并期待继续改进这些网站——也许会得到您的帮助!如果您遇到任何问题,请提交问题,加入我们位于freenode的#jquery-content 频道,或发送电子邮件到content at jquery dot com。