Giter Club home page Giter Club logo

grunt-concat-css's Introduction

grunt-concat-css

Concat CSS with @import statements at top and relative url preserved.

Getting Started

This plugin requires Grunt ~0.4.1

If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:

npm install grunt-concat-css --save-dev

Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:

grunt.loadNpmTasks('grunt-concat-css');

The "concat_css" task

Overview

In your project's Gruntfile, add a section named concat_css to the data object passed into grunt.initConfig().

grunt.initConfig({
  concat_css: {
    options: {
      // Task-specific options go here.
    },
    all: {
      src: ["/**/*.css"],
      dest: "styles.css"
    },
  },
})

Usage Examples

Default Options

By default, all css are concatenated. The only things that happens is that every @import statement are placed at the begininning of the resulting file (as @import statement).

grunt.initConfig({
  concat_css: {
    options: {},
    files: {
      'dest/compiled.css': ['src/styles/componentA.css', 'src/styles/componentB.css'],
    },
  },
})

Rebase URLs

By specifying assetBaseUrl and baseDir, all the assets will be rebased relative to this project rebase URL.

grunt.initConfig({
  concat_css: {
    options: {
      assetBaseUrl: 'static/assets',
      baseDir: 'src/(styles|assets)'
    },
    files: {
      'static/styles.css': ['src/styles/**/*.css', 'src/assets/**/*.css']
    }
  }
})

Contributing

In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using Grunt.

Release History

0.3.1:

  • REFACTOR: added baseDir to be able to properly compute the baseUrl of an asset

0.3.0:

  • Tests added
  • REFACTOR: {string} assetBaseUrl option replace {boolean} rebaseUrls

0.2.0:

  • UPDATE: rebaseUrls option is disabled by default

grunt-concat-css's People

Contributors

oliamb avatar xhmikosr avatar takyam-git avatar

Watchers

James Cloos avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.