twitter-bootstrap - 构建自定义 Bootstrap 文档

Question

我一直在开发 Twitter Bootstrap 的定制版本，作为新大学网站的基础。我们希望为校园开发人员提供公共(public)文档，以便能够查看 Bootstrap 提供的所有组件，因此通过 Jekyll 提供文档并不是一个可行的选择。我们还希望能够使用我们的自定义来构建文档。

我在网上查了一下，没有找到任何人为 3.x 构建过静态文档。有没有人这样做过，或者唯一的方法就是简单地解析 HTML 文件并以适当的格式重新创建它们？

Answer 1

我认为你浏览 Jekyll 的速度有点太快了。我可以找到一种相对轻松的方法来实现这一目标。

1. 为您的 Bootstrap 版本创建 GitHub 存储库。

2. 创建 gh-pages 分支。

3. 查看工作文档 - 其中应该有您的自定义样式 - 位于 GHACCOUNT.github.io/REPONAME/docs

gh-pages 实际上是 Bootstrap 提供在线文档的方式。他们只是在其上放置了一个自定义域。

请注意，您必须使用您可能创建的任何非开箱即用的 Bootstrap 组件来更新文档，但这只是更新 docs 文件夹的问题，将更改合并到 gh-pages 分支，然后推送到 GH。