"; - -inlineCss(html, options) - .then(function(html) { console.log(html); }); -``` - -## API - -### inlineCss(html, options) - - -#### options.extraCss - -Type: `String` -Default: `""` - -Extra css to apply to the file. - - -#### options.applyStyleTags - -Type: `Boolean` -Default: `true` - -Whether to inline styles in ``. - - -#### options.applyLinkTags - -Type: `Boolean` -Default: `true` - -Whether to resolve `` tags and inline the resulting styles. +```console +$ inline-css -h +Usage: inline-css [FILE] +Description: + Inline css into an html file. -#### options.removeStyleTags +Options: + -h, --help Show this message. + -v, --version Print version information. -Type: `Boolean` -Default: `true` - -Whether to remove the original `` tags after (possibly) inlining the css from them. - - -#### options.removeLinkTags - -Type: `Boolean` -Default: `true` - -Whether to remove the original `` tags after (possibly) inlining the css from them. - -#### options.url - -Type: `String` -Default: `filePath` - -How to resolve hrefs. **Required**. - -#### options.preserveMediaQueries - -Type: `Boolean` -Default: `false` - -Preserves all media queries (and contained styles) within `` tags as a refinement when `removeStyleTags` is `true`. Other styles are removed. - -#### options.applyWidthAttributes - -Type: `Boolean` -Default: `false` - -Whether to use any CSS pixel widths to create `width` attributes on elements. - -#### options.applyTableAttributes - -Type: `Boolean` -Default: `false` - -Whether to apply the `border`, `cellpadding` and `cellspacing` attributes to `table` elements. - -#### options.removeHtmlSelectors - -Type: `Boolean` -Default: `false` - -Whether to remove the `class` and `id` attributes from the markup. - -#### options.codeBlocks - -Type: `Object` -Default: `{ EJS: { start: '<%', end: '%>' }, HBS: { start: '{{', end: '}}' } }` - -An object where each value has a `start` and `end` to specify fenced code blocks that should be ignored during parsing and inlining. For example, Handlebars (hbs) templates are `HBS: {start: '{{', end: '}}'}`. `codeBlocks` can fix problems where otherwise inline-css might interpret code like `<=` as HTML, when it is meant to be template language code. Note that `codeBlocks` is a dictionary which can contain many different code blocks, so don't do `codeBlocks: {...}` do `codeBlocks.myBlock = {...}`. - -### Special markup - -#### data-embed - -When a data-embed attribute is present on a tag, inline-css will not inline the styles and will not remove the tags. - -This can be used to embed email client support hacks that rely on css selectors into your email templates. - -### cheerio options - -Options to passed to [cheerio](https://github.com/cheeriojs/cheerio). - -## Contributing +With no FILE, or when FILE is -, read standard input. +``` +## Documentation -See the [CONTRIBUTING Guidelines](https://github.com/jonkemp/inline-css/blob/master/CONTRIBUTING.md) +See https://github.com/jonkemp/inline-css/ ## License From 2e046249bf1c7e5eb5e0ac067f025f3f902afef9 Mon Sep 17 00:00:00 2001 From: Kent Oyer Date: Wed, 13 Jan 2021 12:08:15 -0600 Subject: [PATCH 4/4] Fix README --- README.md | 178 ++++++++++++++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 172 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index 8532c3f..30b3e6f 100644 --- a/README.md +++ b/README.md @@ -1,15 +1,83 @@ -# inline-css +# inline-css [](https://badge.fury.io/js/inline-css) [](https://travis-ci.org/jonkemp/inline-css) [](https://coveralls.io/github/jonkemp/inline-css?branch=master) -This is a fork of [jonkemp/inline-css](https://github.com/jonkemp/inline-css/) with the addition of a Command Line Interface (CLI) to make it easier to integrate this tool with other scripts and development tools. I needed this functionality to use this tool as a file watcher in PhpStorm. +[](https://nodei.co/npm/inline-css/) -## Installation +> Inline your CSS properties into the `style` attribute in an html file. Useful for emails. +Inspired by the [juice](https://github.com/Automattic/juice) library. + +## Features +- Uses [cheerio](https://github.com/cheeriojs/cheerio) instead of jsdom +- Works on Windows +- Preserves Doctype +- Modular +- Gets your CSS automatically through style and link tags +- Functions return [A+ compliant](https://promisesaplus.com/) Promises + +## How It Works + +This module takes html and inlines the CSS properties into the style attribute. + +`/path/to/file.html`: +```html + + + + + + +

Test

+ + +``` + +`style.css` +```css +p { + text-decoration: underline; +} +``` + +Output: +```html + + + + +

Test

+ + ``` -npm install --save fkoyer/inline-css + +## What is this useful for ? + +- HTML emails. For a comprehensive list of supported selectors see +[here](http://www.campaignmonitor.com/css/) +- Embedding HTML in 3rd-party websites. +- Performance. Downloading external stylesheets delays the rendering of the page in the browser. Inlining CSS speeds up this process because the browser doesn't have to wait to download an external stylesheet to start rendering the page. + + +## Install + +Install with [npm](https://npmjs.org/package/inline-css) + +``` +npm install --save inline-css ``` ## Usage +```js +var inlineCss = require('inline-css'); +var html = "

"; + +inlineCss(html, options) + .then(function(html) { console.log(html); }); +``` + +## CLI ```console $ inline-css -h Usage: inline-css [FILE] @@ -24,9 +92,107 @@ Options: With no FILE, or when FILE is -, read standard input. ``` -## Documentation +## API + +### inlineCss(html, options) + + +#### options.extraCss + +Type: `String` +Default: `""` + +Extra css to apply to the file. + + +#### options.applyStyleTags + +Type: `Boolean` +Default: `true` + +Whether to inline styles in ``. + + +#### options.applyLinkTags + +Type: `Boolean` +Default: `true` + +Whether to resolve `` tags and inline the resulting styles. + + +#### options.removeStyleTags + +Type: `Boolean` +Default: `true` + +Whether to remove the original `` tags after (possibly) inlining the css from them. + + +#### options.removeLinkTags + +Type: `Boolean` +Default: `true` + +Whether to remove the original `` tags after (possibly) inlining the css from them. + +#### options.url + +Type: `String` +Default: `filePath` + +How to resolve hrefs. **Required**. + +#### options.preserveMediaQueries + +Type: `Boolean` +Default: `false` + +Preserves all media queries (and contained styles) within `` tags as a refinement when `removeStyleTags` is `true`. Other styles are removed. + +#### options.applyWidthAttributes + +Type: `Boolean` +Default: `false` + +Whether to use any CSS pixel widths to create `width` attributes on elements. + +#### options.applyTableAttributes + +Type: `Boolean` +Default: `false` + +Whether to apply the `border`, `cellpadding` and `cellspacing` attributes to `table` elements. + +#### options.removeHtmlSelectors + +Type: `Boolean` +Default: `false` + +Whether to remove the `class` and `id` attributes from the markup. + +#### options.codeBlocks + +Type: `Object` +Default: `{ EJS: { start: '<%', end: '%>' }, HBS: { start: '{{', end: '}}' } }` + +An object where each value has a `start` and `end` to specify fenced code blocks that should be ignored during parsing and inlining. For example, Handlebars (hbs) templates are `HBS: {start: '{{', end: '}}'}`. `codeBlocks` can fix problems where otherwise inline-css might interpret code like `<=` as HTML, when it is meant to be template language code. Note that `codeBlocks` is a dictionary which can contain many different code blocks, so don't do `codeBlocks: {...}` do `codeBlocks.myBlock = {...}`. + +### Special markup + +#### data-embed + +When a data-embed attribute is present on a tag, inline-css will not inline the styles and will not remove the tags. + +This can be used to embed email client support hacks that rely on css selectors into your email templates. + +### cheerio options + +Options to passed to [cheerio](https://github.com/cheeriojs/cheerio). + +## Contributing -See https://github.com/jonkemp/inline-css/ +See the [CONTRIBUTING Guidelines](https://github.com/jonkemp/inline-css/blob/master/CONTRIBUTING.md) ## License