monkeycode/microsite-template

维护者

详情

github.com/meandmymonkey/silex-template

源代码

问题

安装: 27

依赖项: 0

建议者: 0

安全性: 0

星标: 1

关注者: 2

分支: 0

开放问题: 0

语言:JavaScript

v0.1.4 2014-09-02 09:08 UTC

Requires

Requires (Dev)

MIT 6c69bcc377992cf1ac3c99a00a9f5ccbb9b969f0

  • Andreas Hucks <andreas.hucks.woop@duochrome.net>

This package is auto-updated.

Last update: 2024-09-28 22:36:32 UTC

README

Build Status

一个基于 Silex/Javascript 的快速启动设置。针对小型网站和用作 JS 游戏场。

此模板的主要目的是提供预配置的 Javascript、Less 和测试工具链，以及基本的 Silex/Twig 设置。虽然您可以轻松地删除、添加或修改单个功能，但如果您不打算使用这些工具中的至少一些，那么查看 其他方法 可能是有意义的，这些方法更专注于 Silex 本身。

主要组件包括

  • Silex 用于将所有内容连接在一起并提供 Twig 支持。
  • gulp.js 作为 JS 构建系统
  • browserify 用于处理 JS 组件
  • AngularJS 作为 JS 框架（如果不使用，可以轻松删除）
  • Less 用于处理 CSS
  • Behat 配置为使用 PhantomJS 进行功能测试

要求

要安装、构建和测试项目，您需要以下工具

  • Composer
  • Node.js
  • npm
  • Bower
  • 全局安装 gulp
  • PhantomJS（可选）

安装

$ composer create-project monkeycode/microsite-template myProject
$ cd myProject
$ npm install
$ bower install

在哪里找到什么

所有非 PHP 代码位于 /resources 中，所有 PHP 文件位于 src。

  • /resources/js：Javascript 应用程序文件（请注意，库文件位于 /node_modules 中，因为 napa 安装）。
  • /resources/less：Less 文件。已包含 Bootstrap v3 的导入。
  • /resources/views：Twig 模板。
  • /src/app.php：Silex 应用程序设置。
  • /src/controllers.php：控制器与路由。
  • /config：Silex 应用程序配置。
  • /web：文档根目录。前端控制器和生成的 JS/CSS 资产。

构建

提供的基本 gulpfile.js 允许您运行以下任务

  • gulp：默认任务 - 监视 Less 和 Javascript 源文件的更改，并实时重新构建资产以供开发使用。
  • gulp prod：编译并压缩 Less 和 Javascript 以用于生产。

还有一些其他任务可用，但通常作为前面两个任务的依赖项隐式调用

  • gulp less：将 Less 编译成 /web/css/main.css 中的 CSS。
  • gulp lint：在 Javascript 文件上运行 JSHint。
  • gulp js-dev-lib：将所有供应商库与应用程序 JS 分开连接，以供开发使用。
  • gulp js-dev-app：将所有脚本与应用程序 JS 分开连接，以供开发使用。
  • gulp dev：运行 less、js-dev-lib 和 js-dev-app。

测试

提供了一份 Behat 中的示例测试，并配置为使用 PhantomJS。可以通过调用 ./testlocal.sh 在本地运行测试套件。