# grunt-cdnify-windows

> Converts local URLs to CDN ones, working in windows.

Latest version **0.1.0** (published 2015-08-23) · 0 weekly downloads

## Install

```sh
npm install grunt-cdnify-windows
pnpm add grunt-cdnify-windows
yarn add grunt-cdnify-windows
bun add grunt-cdnify-windows
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.1.0 |
| Published | 2015-08-23 |
| First published | 2015-08-23 |
| Weekly downloads | 0 |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >=0.10.0 |
| Dependencies | 2 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 61 |
| Author | Callum Locke |
| Maintainers | saliba |
| Keywords | gruntplugin |

## Links

- npm: https://www.npmjs.com/package/grunt-cdnify-windows
- Repository: https://github.com/callumlocke/grunt-cdnify
- Issues: https://github.com/callumlocke/grunt-cdnify/issues
- npm.io page: https://npm.io/package/grunt-cdnify-windows

## Dependencies (2)

- [soup](https://npm.io/package/soup.md) ~0.1.3
- [css-url-rewriter](https://npm.io/package/css-url-rewriter.md) 0.0.1

## Recent versions

- 0.1.0 (latest) — 2015-08-23

## README

# grunt-cdnify [![Build Status](https://secure.travis-ci.org/callumlocke/grunt-cdnify.png?branch=master)](http://travis-ci.org/callumlocke/grunt-cdnify) [![Dependency Status](https://gemnasium.com/callumlocke/grunt-cdnify.png)](https://gemnasium.com/callumlocke/grunt-cdnify)

> Grunt plugin for rewriting static resource URLs found in your HTML and CSS.

## What it does
The task looks through your specified files for URLs to rewrite, in the following places:

* `<img src="____">`
* `<script src="____"></script>`
* `<link rel="stylesheet" href="____">`
* `background-image: url(____);` in your CSS (including inside `<style>` tags in your HTML)

See options below for how it modifies them.


## Options
You should set either `base` **or** `rewriter` (not both).

### `base`
For the most common use case, just set a `base` string for your URLs – eg, `'//cdn.example.com/'`. The cdnify task will automatically search for all **local** URLs in your files, and prefix them with this string. (It will automatically avoid double-slashes.)

Example:

```js
cdnify: {
  someTarget: {
    options: {
      base: '//cdn.example.com/stuff/'
    },
    files: [{
      expand: true,
      cwd: 'app',
      src: '**/*.{css,html}',
      dest: 'dist'
    }]
  }
}
```

### `rewriter`
For more control, you can specify a custom `rewriter` function instead. In this case, the task will search for **all** URLs (not just local ones) and run your function on each one. Your function should return the new value.

Example:

```js
cdnify: {
  someTarget: {
    options: {
      rewriter: function (url) {
        if (url.indexOf('data:') === 0)
          return url; // leave data URIs untouched
        else
          return url + '?12345'; // add query string to all other URLs
      }
    },
    files: [{
      expand: true,
      cwd: 'app',
      src: '**/*.{css,html}',
      dest: 'dist'
    }]
  }
}
```

### `css` (boolean)
Whether to modify CSS. Applies to both `*.css` files and `<style>` elements. Default: `true`.

### `html` (boolean/object)
Whether/how to modify HTML. Defaults to `true`, which will update HTML according to this standard config:

```js
{
  'img[src]': 'src',
  'link[rel=stylesheet]': 'href',
  'script[src]': 'src',
  'video[poster]': 'poster',
  'source[src]': 'src'
}
```

That is, any elements matching the CSS selector `img[src]` will have their `src` attributes cdnified, etc.

To customise this config, you can set the `html` option to an object of custom selector:attribute pairs. These will be added to the standard set shown above – if you want to **not** use one of the standard pairs, you have to explicitly override it with `false`.

For example:

```js
options: {
  html: {
    'img[ng-src]': 'ng-src', // cdnify angular images
    'script[src]': false // don't cdnify script tags
  }
}
```

---
_Source: https://npm.io/package/grunt-cdnify-windows · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._