Question 1

How to enable compression with gulp-inline-source?

Accepted Answer

Set the 'compress' option to true in the configuration object passed to the plugin. For example, use `inlinesource({ compress: true })` in your Gulp task to minify inlined content, as shown in the README's optional usage section.

Question 2

gulp-inline-source vs inline-source directly, which should I use?

Accepted Answer

If you're using Gulp, gulp-inline-source is more convenient due to its native integration. Otherwise, inline-source can be used standalone with other tools. Both offer similar inlining functionality, but gulp-inline-source simplifies Gulp workflows.

Question 3

Does gulp-inline-source work with SVG or other image formats?

Accepted Answer

Yes, it can inline various image formats via `<img>` tags with the 'inline' attribute, converting them to data URIs. However, this can bloat HTML size, so it's recommended for small, critical images only to maintain performance.

Question 4

How to handle relative file paths in gulp-inline-source?

Accepted Answer

File paths in HTML should be relative to the HTML file's location or configured base paths. The plugin processes paths based on the inline-source library, so ensure correct referencing to avoid errors during build.

Question 5

What happens if a file is missing when using gulp-inline-source?

Accepted Answer

The plugin may throw an error or skip the tag, depending on the underlying inline-source library's behavior. It's crucial to verify file paths and existence in the build pipeline to prevent build failures.

Question 6

Best practices for inlining CSS with gulp-inline-source?

Accepted Answer

Inline only critical, above-the-fold CSS to improve initial load times. Use the 'compress' option to minimize size, and avoid inlining large stylesheets to prevent HTML bloat. Combine with external CSS for non-critical styles.

gulp-inline-source

What is gulp-inline-source?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions