Question 1

How do I use diff2html-cli to see a git diff in my browser?

Accepted Answer

Run 'diff2html -o preview -- -M HEAD~1' to generate an HTML preview of the last commit's diff and open it in your default browser. The '--' separator is crucial for passing git options.

Question 2

Can diff2html-cli output JSON for processing?

Accepted Answer

Yes, use the '-f json' flag to output diff data in JSON format instead of HTML. This is useful for integrating with other tools or scripts that need structured diff information.

Question 3

How to ignore files like package-lock.json in the diff output?

Accepted Answer

Use the '--ig' flag followed by the file name, e.g., 'diff2html --ig package-lock.json -- -M HEAD~1'. Multiple files can be ignored by repeating the flag.

Question 4

What's the difference between diff2html-cli and pretty-diff?

Accepted Answer

diff2html-cli is inspired by pretty-diff but adds features like syntax highlighting, multiple view modes, and active maintenance. It's built on Node.js and offers more configuration options compared to the older pretty-diff tool.

Question 5

How to customize the HTML output with my own template?

Accepted Answer

Create an HTML file with specific placeholders as shown in the README, then use the '--hwt' flag to specify the template path. Ensure exact comment placement to avoid rendering issues.

Question 6

What do the exit status codes mean in diff2html-cli?

Accepted Answer

Exit codes indicate success (0), generic error (1), empty diff input (3), or invalid custom template file (4). These help in automating scripts and handling edge cases gracefully.

diff2html-cli

What is diff2html-cli?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions