messagebooster/laravel-sass

每次运行应用程序(开发中)时,都将您的 SASS .scss 文件编译为 .css 文件

dev-master 2014-09-08 13:02 UTC

This package is not auto-updated.

Last update: 2024-09-24 08:34:54 UTC


README

在开发过程中,为 Laravel 4(以及任何其他框架)提供自动 SASS 到 CSS 编译。每次您运行应用程序(访问 index.php)时,laravel-sass 将自动将您的 scss 文件夹中的所有 .scss 文件编译为 css 文件夹中的 .css 文件。支持最新版本的 SASS(scss 语法)和混入。太棒了!

安装与使用

请将其添加到 composer.json 中,请注意,这是一个 require-dev,而不是常规的 require。这区分了真实依赖项和仅用于本地开发的依赖项。

"require-dev": {
    "panique/laravel-sass": "dev-master"
}

在 Laravel 中的 public/index.php 中添加此行,在 $app->run(); 之前。

SassCompiler::run("scss/", "css/");

第一个参数是您 scss 文件夹的相对路径(创建一个),第二个参数是您 css 文件夹的相对路径。通常在 public 文件夹中创建这些文件夹是很有意义的。确保 PHP 可以写入 css 文件夹,可以通过给文件夹赋予 sudo chmod -R 777 public/css 权限(当位于 /var/www 时)。注意: 777 仅用于开发,在生产服务器上不需要给该文件夹任何写入权限。

通过执行 composer installcomposer update 安装或更新您的 Composer 依赖项,以添加 laravel-sass。Composer 默认自动安装 require-dev 中的所有内容。

重要: 当您稍后部署应用程序且不希望安装 require-dev 内容时,请执行 composer install --no-dev(或 composer update --no-dev)。

可选功能

对于 SassCompiler::run(),有一个可选的第三个参数,它期望是 http://leafo.net/scssphp/docs/#output_formatting 中解释的字符串之一。这定义了所需的输出。scss_formatter 是 laravel-sass 使用的标准,如果您需要最小化的 css 文件,则选择 scss_formatter_compressedscss_formatter_nested 用于嵌套输出,优化了可读性。

测试

为了测试一切是否正常工作,只需将此添加到 app/views/hello.php 的头部:<link rel="stylesheet" type="text/css" href="css/style.css"> 并在您的 scss 文件夹中放置一个名为 style.scss 的文件。现在运行应用程序并尝试在 style.scss 中修改 (s)css 规则,每次刷新后您应该能够立即看到更改!

@import 的工作原理

从其他文件导入 sass 规则现在工作得很好。确保按照正确的方式导入文件:如果文件名为 _colors.scss 并且位于基本 scss 文件夹中

@import 'colors';

如果文件名为 _colors.scss 并且位于基本 scss 文件夹中的 modules 子文件夹中

@import 'modules/colors';

请参阅官方文档以获取更多信息。

部署时...

.. 确保再次注释掉此行:SassCompiler::run("scss/", "css/");。该工具的未来版本将具有开发/生产开关/识别器。

使用的脚本

此工具使用出色的 scssphp SASS 编译器。scssphp 支持最新的 SCSS 语法(3.2.12)。

其他项目

许可证

本软件遵循MIT许可证。适用于个人或商业项目,完全免费。

支持 / 捐赠

如果您觉得这个脚本很有用,那么请考虑支持这个项目。

  1. A2 HostingDigitalOcean租用您的下一个服务器。
  2. 通过PayPalGitTipFlattr进行捐赠。
  3. 为这个项目做出贡献。

雇佣我

我可供远程或中央欧洲本地自由职业工作。如果您喜欢,地址很容易找到,请给我发邮件。