rtfpessoa/diff2html
Diff2html
diff2html is a Git diff visualization library that transforms unified diff text into structured HTML. It serves as a renderer for visualizing code changes in web browsers, providing components to inject stylized diff visualizations and collapsible file lists directly into web page elements.
The library enables both side-by-side and line-by-line code comparisons. It includes a syntax highlighting diff viewer that applies language-specific color coding to source code based on file extensions or manual mappings.
To maintain alignment during reviews, the project implements synchronized scrolling to lock the vertical positions of side-by-side diff panes. It utilizes a template-driven approach to generate consistent markup and an abstract object model to parse raw diff data for structural manipulation.
Features
- Git Diff Viewers - Transforms git or unified diff text into structured HTML for human review of code changes.
- Diff Data Parsers - Converts raw text-based diffs into an abstract object model to enable structural manipulation and rendering.
- Programmatic Diff Parsers - Provides a utility to parse raw unified diff text into a structured object model for programmatic analysis.
- Side-by-Side Diff Viewers - Renders file differences in the browser using side-by-side layouts and synchronized scrolling.
- Code Diff Visualizers - Applies syntax highlighting to code within diffs using file extensions or manual language mappings.
- Diff UI Components - Injects stylized diff visualizations into web pages with collapsible file lists and sticky headers.
- Diff DOM Injectors - Injects stylized diff visualizations and collapsible file lists directly into web page elements.
- Code-to-HTML Rendering - Transforms unified diff text into styled HTML structures for visual representation in web browsers.
- Scroll Synchronization - Synchronizes the scrolling of side-by-side diff panes to keep corresponding lines aligned.
- Synchronized Scroll Containers - Locks the vertical scroll positions of side-by-side diff panes to keep corresponding code lines aligned.
- Diff - Applies language-specific color coding to source code within rendered difference blocks.
- Unified Diff Reviewers - Provides a unified diff review interface for humans to easily examine code changes via HTML.
- File Extension Language Mappings - Determines syntax highlighting rules by matching file extensions against a predefined language map.
- Developer Tooling UI Components - Provides UI components specifically designed for developer-facing version control and diff tooling.
- Diff Change Styling - Implements CSS-based styling to visually differentiate added and deleted lines in the diff view.
- DOM-Based Rendering - Generates a structured HTML hierarchy that mirrors diff data for direct injection into the browser DOM.
- HTML Templating Engines - Uses a template-driven approach to generate consistent HTML markup for different diff viewing modes.
- File Processing - Git diff parser and HTML beautifier.
- File Utilities - Git diff parser and HTML generator.
