css-inline

A crate for inlining CSS into HTML documents. When you send HTML emails you need to use "style" attributes instead of "style" tags.

For example, this HTML:

html <html> <head> <title>Test</title> <style>h1 { color:blue; }</style> </head> <body> <h1>Big Text</h1> </body> </html>

Will be turned into this:

html <html> <head><title>Test</title></head> <body> <h1 style="color:blue;">Big Text</h1> </body> </html>

To use it in your project add the following line to your dependencies section in project's Cargo.toml file:

toml css-inline = "0.3"

Usage

```rust use css_inline;

const HTML: &str = r#" Test

Big Text

"#;

fn main() -> Result<(), cssinline::InlineError> { let inlined = cssinline::inline(HTML)?; // Do something with inlined HTML, e.g. send an email Ok(()) } ```

Features

css-inline does minimum work by default:

No CSS transformation;
No "style" or "link" tags removal;

It also loads external stylesheets via network or filesystem, but this behavior is configurable.

Configuration

css-inline can be configured by using InlineOptions and CSSInliner:

```rust use css_inline;

fn main() -> Result<(), cssinline::InlineError> { let options = cssinline::InlineOptions { loadremotestylesheets: false, ..Default::default() }; let inliner = css_inline::CSSInliner::new(options); let inlined = inliner.inline(HTML); // Do something with inlined HTML, e.g. send an email Ok(()) } ```

remove_style_tags. Remove "style" tags after inlining.
base_url. Base URL to resolve relative URLs
load_remote_stylesheets. Whether remote stylesheets should be loaded or not

Command Line Interface

css-inline provides a command-line interface:

```bash $ css-inline --help

css-inline inlines CSS into HTML documents.

USAGE: css-inline [OPTIONS] [PATH ...] command | css-inline [OPTIONS]

ARGS: ... An HTML document to process. In each specified document "css-inline" will look for all relevant "style" and "link" tags, will load CSS from them and then will inline it to the HTML tags, according to the relevant CSS selectors. When multiple documents are specified, they will be processed in parallel and each inlined file will be saved with "inlined." prefix. E.g. for "example.html", there will be "inlined.example.html".

OPTIONS: --remove-style-tags Remove "style" tags after inlining.

--base-url
    Used for loading external stylesheets via relative URLs.

--load-remote-stylesheets
    Whether remote stylesheets should be loaded or not.

```