Blueprint

Blueprint是一个针对web的，基于React的UI toolkit。

针对desktop applications，它为构建复杂的，数据密集的Web界面进行了优化。 如果您严重依赖移动交互，并且正在寻找一个移动优先的UI工具包，Blueprint可能不适合您。

查看完整的文档 ▸

阅读我们在wiki上的FAQ ▸

阅读介绍博客 ▸

支持问题？ 我们使用 Stack Overflow 上的 blueprintjs 标签 ▸

包

这个存储库包含packages/目录下的多个项目，分为三类：

库

这些是我们发布到NPM的组件库。

• – 核心样式和组件。
• – 用于与日期和时间交互的组件。
• – Documentalist 数据的文档主题。
• – 可扩展交互式表格组件。
• – Incubator and staging area for new components still under initial development.

应用程序

这些在GitHub Pages上作为静态Web应用程序托管：

• docs-app – 文档站点在blueprintjs.com/docs
• landing-app – 在blueprintjs.com的Landnig页面

这些被用作开发playground的环境：

• table-dev-app – 演示页面，支持所有表格功能的手动测试

构建工具

这些私有包定义了开发依赖并包含构建配置。它们遵循标准的NPM包layout，它允许我们为构建配置和隔离devDependencies组保持清晰的API边界。未来，我们可能会发布这些软件包，以允许其他Blueprint项目在这个monorepo之外使用这个基础设施。

• karma-build-scripts
• node-build-scripts
• tslint-config
• webpack-build-scripts

开发

Lerna管理这个monorepo中的包间依赖关系。 版本是通过lerna run和NPM脚本编排的。

前提: Node.js v8+, Yarn v1.0+

一键安装

克隆这个repo之后，运行：

1. yarn 安装所有的依赖。
2. yarn verify 确保您的所有构建工具正常工作。

合并上游变更

如果您以前处于工作状态，并且刚刚从develop中提取了新的代码：

• 如果存在程序包依赖性更改，请在根目录下运行yarn。
  • 如果没有新东西要安装，这个命令会非常快完成。
• 运行yarn compile-libs来获取这个仓库中库包的最新版本。
  • 这个命令比yarn verify快，因为它不会构建应用程序包（docs-app，landing-app等）或运行测试

开发库

每个库都有自己的开发脚本，您可以运行它来监控对该软件包的更改，并使用webpack-dev-server运行文档应用程序：yarn dev:core，yarn dev:datetime等。

• table—是一个例外，因为它有自己的开发应用程序，dev:table脚本，不用运行docs站点。
  • 使用packages/table-dev-app文件夹中的yarn dev运行table开发应用程序。
• 您也可以选择通过从根目录运行yarn dev:all来监视所有软件包的更改。

更新依赖关系

1. 编辑你想改变依赖关系的package.json。
2. 在根目录下运行yarn来更新锁文件。
3. 提交结果。

更新文档

许多Blueprint的文档都存在于源代码中，因为JSDoc在.tsx？文件中注释，在.scss文件中有KSS标记。这个文档被documentalist提取和转换为JSON数据来生成的。

如果您正在更新文档来源（而不是位于packages/docs-app中的文档UI代码），则需要从docs-app包运行yarn generate-docs-data以查看它在应用程序中的反映。请注意，这个包中的yarn bundle也运行这个脚本。

更新图标

在这个仓库中，一键安装和合并上游变更步骤应产生生成的源代码，用于建立图标文档。这对大多数开发工作流程来说已经足够了。 如果您正在更新图标或添加新图标，则需要在packages/core中运行yarn compile，以查看运行任何dev脚本之前所反映的更改。

贡献

寻找有助于代码库的地方？看看 Status: accepting PRs标签。

阅读我们的贡献指南和开发实践，为您的PR提供最好的合并机会。

许可证

该项目在Apache-2.0许可证下提供使用。