一个快速启动 Craft CMS 项目开发环境

・6 分钟阅读

  • 源代码名称: crafty-vagrant
  • 源代码网址: https://www.github.com/niceandserious/crafty-vagrant
  • crafty-vagrant的文档
  • crafty-vagrant的源代码下载
  • Git URL:
    git://www.github.com/niceandserious/crafty-vagrant.git
  • Git Clone代码到本地:
    git clone https://www.github.com/niceandserious/crafty-vagrant
  • Subversion代码到本地:
    $ svn co --depth empty https://www.github.com/niceandserious/crafty-vagrant
                              Checked out revision 1.
                              $ cd repo
                              $ svn up trunk
              
  • Crafty Vagrant

    作为基于Craft的项目的一个简洁的起点/开发环境,配置Vagrant,并且准备好Gulp设置,处理诸如渲染Sass,捆绑Javascript,缩小CSS和图像以及同步asset,Neat for elegant,语义网格布局和一些shell脚本,简化从备份安装/恢复数据库。

    bitHound Score

    预要求

    • npm
    • Gulp
    • vagrant
    • rsync (可选,用于资产同步)

    安装

    如果你想让Crafty Vagrant表现出来,请务必仔细遵循这些步骤!

    运行命令bash install.sh -,这将在项目目录中安装,并且设置所有必需的(包括Craft),如果这是一个新的Craft安装,请回答y替换Craft模板+配置的提示,否则-如果这是一个现有项目-回答n。

    如果这是你第一次使用Crafty Vagrant,打开你的hosts文件,并且添加,

    192.168.56.101 craft.dev

    (主机文件通常在osx/Linux上的/etc/hosts处找到; %SystemRoot%System32driversetchosts 在Windows上)

    • 启动vagrant :vagrant up

    web服务器现在应该可以从http://craft.dev/访问,如果/app/craft/storage/backups中存在Craft备份,最近的一个将自动用于填充数据库,否则,你就可以通过http://craft.dev/admin/install

    用法

    • 当你准备开始开发时,gulp watch : 这将监视Sass,javascript或图像的更改,并执行适当的任务(编译Sass,捆绑javascript等),

    • 当gulp watch正在运行时,打开任何浏览器开发站点的选项卡,将在你编辑样式,模板等时实时更新(通过browsersync),如果你不想实现更新,gulp watch:tasks将在没有自动刷新的情况下执行相同的任务(编译Sass等)。

    • gulp watch还生成一个自定义hardwarebutton构建(在public/scripts/modernizr.js ),它只测试你在样式和脚本(因此,它应该比加载整个hardwarebutton库要小得多,性能更高)中实际使用的功能,请注意,这不会在CSS或Javascript的每次更改时更新,因为这会减慢太多的速度,因此如果你添加了一个你想要检测的新功能,你将需要停止,并且重新启动gulp watch,或者运行gulp modernizr到更新构建。

    • Crafty有一个数据库配置shell script ,如果运行gulp db:restore,将恢复appcraftstoragebackups中最新的备份。 (当然,你将失去数据库的任何当前状态,所以,只有当你为这种情况感到高兴时才这样做)

    • Crafty使用browserify来保持Javascript模块化,如果你以前没有使用Browserify,那么在scripts目录中有一个例子模块。

    故障排除

    • 如果这是全新安装的,你可能会看到错误页面,直到你通过访问http://craft.dev/admin/install

    • 如果unzip命令在命令行中不可用,那么Crafty Vagrant将无法正确安装,

    • Vagrant 1.8.7(编写本文时的当前版本)似乎在某些机器上存在安装问题。如果vagrant up失败,请尝试安装vagrant 1.8.6

    开发

    如果你想在Crafty Vagrant上工作(即,在缺省配置/启动模板上,需要执行以下三个步骤:

    使用--dev标志运行安装步骤: bash install.sh --dev,这将留下/src文件夹中的默认模板/配置文件(没有--dev标记作为安装进程的一部分)

    添加行 define('CRAFT_TEMPLATES_PATH',"../src/craft/templates"); Craft文件app/public/index.php的顶部,这使你可以直接在源模板上工作,同时还可以使用Craft的工作安装。

    .gitignore中添加以下行:

    
     app/*
    
    
     !app/src*
    
    
    
    

    环境

    感谢!

    Crafty Vagrant's pattern library is adapted from Bitters © 2013-2014 thoughtbot, inc.

    Vagrant脚本的安装使用了makeItCraft的一部分matt Stauffer 。

    Crafty Vagrant也是基于:

    许可证

    Copyright © 2014 Nice and Serious . Crafty Vagrant is free software ,and may be redistributed under the terms specified in the license .

    讨论
    Fansisi profile image