docpad-plugin-cssinliner

CSS Inliner Plugin for DocPad

Takes you CSS styles within the <style> element and places them inline on each element with the style attribute.

Uses the awesome Juice library.

Why?

• Popular email clients like Gmail strip out CSS in the <style> tag.
• This is the best way to guarantee your email works properly on the compatible clients listed in the docs.

Install

docpad install cssinliner

Usage

Will look for all <style> elements in your *.html files. You can add juice options within your config:

	plugins:
		cssinliner:
			options: 
				extraCss: "" // extra css to apply to the file.
				applyStyleTags: true // whether to inline styles in <style></style>.
				removeStyleTags: true // whether to remove the original <style></style> tags after (possibly) inlining the css from them.
				preserveMediaQueries: false // preserves all media queries (and contained styles) within <style></style> tags as a refinement when removeStyleTags is true. Other styles are removed.
				inlinePseudoElements: false // whether to insert pseudo elements (::before and ::after) as <span> into the DOM. Note: Inserting pseudo elements will modify the DOM and may conflict with CSS selectors elsewhere on the page (e.g., :last-child).
				xmlMode: false  whether to output XML/XHTML with all tags closed. Note that the input must also be valid XML/XHTML or you will get undesirable results.
				preserveImportant: false // preserves !important in values.

History

Discover the change history by heading on over to the HISTORY.md file.

Contribute

Discover how you can contribute by heading on over to the CONTRIBUTING.md file.

Backers

Maintainers

These amazing people are maintaining this project:

• Roger Chapman <rogchap(at)gmail.com> (https://github.com/rogchap)

Sponsors

No sponsors yet! Will you be the first?

Contributors

These amazing people have contributed code to this project:

• Roger Chapman <rogchap(at)gmail.com> — view contributions

Become a contributor!

License

Unless stated otherwise all works are:

• Copyright © Kayla Technologies [e-mail] (https://kayla.com.au)

and licensed under:

• The incredibly permissive MIT License