Package Exports
- diff2html
- diff2html/package.json
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (diff2html) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
Diff to Html by rtfpessoa
Diff to Html generates pretty HTML diffs from git diff output.
Features
line-by-line
andside-by-side
diffnew and old line numbers
inserted and removed lines
GitHub like style
Code syntax highlight
Online Example
Go to Diff2HTML
Distributions
Manually download and import
dist/diff2html.min.js
into your page
How to use
Pretty HTML diff
Diff2Html.getPrettyHtml(exInput, configuration)
Intermediate Json From Git Word Diff Output
Diff2Html.getJsonFromDiff(exInput)
Check out the
index.html
for a complete example.
Configuration
The HTML output accepts a Javascript object with configuration. Possible options:
inputFormat
: the format of the input data:'diff'
or'json'
, default is'diff'
outputFormat
: the format of the output data:'line-by-line'
or'side-by-side'
, default is'line-by-line'
showFiles
: show a file list before the diff:true
orfalse
, default isfalse
Syntax Highlight
Add the dependencies. Choose one color scheme, and add the main highlight code. If your favourite language is not included in the default package also add its javascript highlight file.
<!-- Stylesheet -->
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/8.6/styles/github.min.css">
<!-- Javascripts -->
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/8.6/highlight.min.js"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/8.6/languages/scala.min.js"></script>
Invoke the highlightjs plugin
document.addEventListener("DOMContentLoaded", function () {
// parse the diff to json
var diffJson = Diff2Html.getJsonFromDiff(lineDiffExample);
// collect all the file extensions in the json
var allFileLanguages = diffJson.map(function (line) {
return line.language;
});
// remove duplicated languages
var distinctLanguages = allFileLanguages.filter(function (v, i) {
return allFileLanguages.indexOf(v) == i;
});
// pass the languages to the highlightjs plugin
hljs.configure({languages: distinctLanguages});
// generate and inject the diff HTML into the desired place
document.getElementById("line-by-line").innerHTML = Diff2Html.getPrettyHtml(diffJson, { inputFormat: 'json' });
document.getElementById("side-by-side").innerHTML = Diff2Html.getPrettyHtml(diffJson, { inputFormat: 'json', outputFormat: 'side-by-side' });
// collect all the code lines and execute the highlight on them
var codeLines = document.getElementsByClassName("d2h-code-line-ctn");
[].forEach.call(codeLines, function (line) {
hljs.highlightBlock(line);
});
});
Contributions
All the contributions are welcome.
To contribute just send a pull request with your changes and I will review it asap.
License
Copyright 2014 Rodrigo Fernandes. Released under the terms of the MIT license.
Thanks
This project is inspired in pretty-diff by Scott González.