README

Canvas 是一个基于 HTML5 Boilerplate 和 Bootstrap 的 WordPress 入门主题，可以帮助您制作更好的主题。

特点

• Grunt 用于编译 LESS 到 CSS、检查 JS 错误、实时刷新、合并和压缩文件、版本化资源，以及生成精简的 Modernizr 构建
• Bower 用于前端包管理
• HTML5 Boilerplate
• 通过 Google CDN 提供的最新 jQuery，带有本地回退
• 用于功能检测的最新 Modernizr 构建，通过 Grunt 生成精简构建
• 优化的 Google Analytics 片段
• Bootstrap
• 有组织的文件和模板结构
• ARIA 角色和微数据格式
• 主题激活
• 主题包装器
• 导航菜单的更清洁的 HTML 输出
• 文章使用 hNews 微数据格式

附加功能

安装 Soil 插件以启用附加功能

• 根相关 URL
• 良好的搜索 (/search/query/)
• wp_head 和入队资源标记的更清洁的输出

安装

克隆 git 存储库 - git clone git://github.com/haddowg/canvas.git - 或 下载它 并将目录重命名为您主题或网站的名称。

配置

编辑 lib/config.php 以启用或禁用主题功能并定义 Google Analytics ID。

编辑 lib/init.php 以设置导航菜单、文章缩略图大小、文章格式和侧边栏。

主题开发

Canvas 使用 Grunt 来编译 LESS 到 CSS、检查 JS 错误、实时刷新、合并和压缩文件、版本化资源，以及生成精简的 Modernizr 构建。

安装 Grunt 和 Bower

不熟悉 npm？没有安装 node.js 吗？ 在继续之前，请先 下载并安装 node.js。

从命令行

1. 使用 npm install -g grunt-cli bower 全局安装 grunt-cli 和 bower。
2. 导航到主题目录，然后运行 npm install。 npm 将查看 package.json 并自动安装必要的依赖项。它还将自动运行 bower install，该命令安装 bower.json 中定义的前端包。

完成后，您可以从命令行运行提供的各种 Grunt 命令。

注意。 您需要全局 npm 目录的写入权限才能安装 grunt-cli 和 bower。您可能还需要使用提升的终端或使用 sudo 前缀命令，即 sudo npm install -g grunt-cli bower。

我们还建议不要以root用户身份运行。NPM在执行某些命令时（如Canvas安装过程中的命令）会故意使用有限的权限，当这种情况发生在root用户身上时，任何root用户没有明确写入权限的文件系统对象在命令执行过程中将无法写入。这些可能包括/var/www或/home/someotheruser等目录。如果你以root用户身份运行并遇到问题，请不要说我们没有提醒你。

可用的Grunt命令

• grunt dev — 编译LESS到CSS，连接并验证JS
• grunt watch — 当文件发生变化时编译资源
• grunt build — 创建用于非开发环境的压缩资源