lphuberdeau / tiki-bootstrap
流行的 twbs/bootstrap 的分支,用于 Tiki Wiki CMS Groupware 内部使用
This package is not auto-updated.
Last update: 2024-09-24 06:31:38 UTC
README
Bootstrap 是由 Mark Otto 和 Jacob Thornton 创建的,并由一个核心团队和社区的巨大支持和参与维护的强大前端框架,用于更快速、更轻松地进行 Web 开发。
要开始使用,请访问 https://bootstrap.ac.cn!
目录
快速开始
提供三种快速开始选项
- 下载最新版本.
- 克隆存储库:
git clone https://github.com/twbs/bootstrap.git
。 - 使用 Bower 安装:
bower install bootstrap
。
阅读 入门页面 以获取有关框架内容、模板和示例等信息。
包含内容
在下载中,您将找到以下目录和文件,它们逻辑地组织了常用资产,并提供编译和最小化版本。您将看到类似以下内容
bootstrap/
├── css/
│ ├── bootstrap.css
│ ├── bootstrap.min.css
│ ├── bootstrap-theme.css
│ └── bootstrap-theme.min.css
├── js/
│ ├── bootstrap.js
│ └── bootstrap.min.js
└── fonts/
├── glyphicons-halflings-regular.eot
├── glyphicons-halflings-regular.svg
├── glyphicons-halflings-regular.ttf
└── glyphicons-halflings-regular.woff
我们提供了编译后的 CSS 和 JS(bootstrap.*
),以及编译和最小化的 CSS 和 JS(bootstrap.min.*
)。包含了来自 Glyphicons 的字体,以及可选的 Bootstrap 主题。
错误和功能请求
如果您有错误或功能请求,请首先阅读 问题指南 并搜索现有和已关闭的问题。如果您的問題或想法尚未得到解决,请 打开一个新的问题。
文档
Bootstrap 的文档包含在此存储库的根目录中,并使用 Jekyll 构建,在 GitHub Pages 上公开托管在 https://bootstrap.ac.cn。这些文档也可以在本地运行。
在本地运行文档
- 如果需要,请 安装 Jekyll(需要 v1.5.x)。
- Windows 用户:请阅读 此非官方指南 以无问题地启动 Jekyll。我们使用 Pygments 进行语法高亮,因此请确保阅读有关安装 Python 和 Pygments 的部分。
- 在根目录
/bootstrap
中,在命令行中运行jekyll serve
。 - 在浏览器中打开 http://localhost:9001, Voilà。
通过阅读其 文档 了解更多关于使用 Jekyll 的信息。
以前版本文档
由于人们过渡到 Bootstrap 3,目前提供了 v2.3.2 的文档,可在 https://bootstrap.ac.cn/2.3.2/ 查找。
以前的版本及其文档也可供下载。
编译 CSS 和 JavaScript
Bootstrap使用Grunt,它提供方便的方法来操作框架。这是我们编译代码、运行测试等的方式。要使用它,按照指示安装所需依赖项,然后运行一些Grunt命令。
安装Grunt
从命令行
- 使用
npm install -g grunt-cli
全局安装grunt-cli
。 - 导航到根目录
/bootstrap
,然后运行npm install
。npm将查看package.json并自动安装其中列出的必要本地依赖项。
完成后,您将能够从命令行运行各种Grunt命令。
不熟悉npm?还没有安装node.js?这没有问题。npm代表node packaged modules,它通过node.js管理开发依赖项。在继续之前,请下载并安装node.js。
可用的Grunt命令
构建 - grunt
运行grunt
以在本地运行测试,并将CSS和JavaScript编译到/dist
。使用Less和UglifyJS。
仅编译CSS和JavaScript - grunt dist
grunt dist
将创建包含编译文件的/dist
目录。使用Less和UglifyJS。
测试 - grunt test
在PhantomJS(用于CI)中无头运行JSHint和QUnit测试。
监控 - grunt watch
这是一个方便的方法,用于监控Less文件,并在您保存时自动构建它们。
依赖项故障排除
如果您在安装依赖项或运行Grunt命令时遇到问题,请卸载所有以前的依赖项版本(全局和本地)。然后,重新运行npm install
。
贡献
请阅读我们的贡献指南。其中包括打开问题、编码标准和开发笔记的说明。
此外,如果您的拉取请求包含JavaScript补丁或功能,您必须包括相关的单元测试。所有HTML和CSS都应符合由Mark Otto维护的Code Guide。
编辑器首选项在编辑器配置中可用,便于在常用文本编辑器中使用。更多信息请访问http://editorconfig.org。
社区
跟踪开发和社区新闻。
- 关注@twbootstrap在Twitter上的动态。
- 阅读并订阅官方Bootstrap博客。
- 在IRC上与Bootstrap同行交流。在
irc.freenode.net
服务器上的##twitter-bootstrap
频道。 - Stack Overflow(标记为
twitter-bootstrap-3
)上可以找到实现帮助。
版本控制
为了透明度以及努力保持向后兼容性,Bootstrap遵循语义化版本控制指南。有时我们会出错,但我们会尽可能遵守这些规则。
版本号将采用以下格式
<主版本>.<次版本>.<修订号>
以下是根据以下指南构建的
- 打破向后兼容性会提高主要版本,同时重置次要版本和补丁版本
- 在不打破向后兼容性的情况下添加新功能会提高次要版本,同时重置补丁版本
- 错误修复和其它更改只会提高补丁版本
有关SemVer的更多信息,请访问 http://semver.org/。
创建者
Mark Otto
Jacob Thornton