delta README

The project's README from github.com/dandavison/delta. As one markdown file: README.md.

image

CI Coverage Status Gitter

Get Started

Install it (the package is called "git-delta" in most package managers, but the executable is just delta) and add this to your ~/.gitconfig:

[core]
    pager = delta

[interactive]
    diffFilter = delta --color-only

[delta]
    navigate = true  # use n and N to move between diff sections
    dark = true      # or light = true, or omit for auto-detection

[merge]
    conflictStyle = zdiff3

Or run:

git config --global core.pager delta
git config --global interactive.diffFilter 'delta --color-only'
git config --global delta.navigate true
git config --global delta.dark true  # or `delta.light true`, or omit for auto-detection
git config --global merge.conflictStyle zdiff3

Delta has many features and is very customizable; please see delta -h (short help) or delta --help (full manual), or the online user manual.

Features

A syntax-highlighting pager for git, diff, and grep output

Code evolves, and we all spend time studying diffs. Delta aims to make this both efficient and enjoyable: it allows you to make extensive changes to the layout and styling of diffs, as well as allowing you to stay arbitrarily close to the default git/diff output.

image

delta with line-numbers activated
image

delta with side-by-side and line-numbers activated

Here's what git show can look like with git configured to use delta:


image image
"Dracula" theme "GitHub" theme


Syntax-highlighting themes

All the syntax-highlighting color themes that are available with bat are available with delta:


image image
delta --show-syntax-themes --dark delta --show-syntax-themes --light

Side-by-side view

[User manual]

[delta]
    side-by-side = true

By default, side-by-side view has line-numbers activated, and has syntax highlighting in both the left and right panels: [config]

image

Side-by-side view wraps long lines automatically:

image

Line numbers

[User manual]

[delta]
    line-numbers = true
image

Merge conflicts

[User manual]

image

Git blame

[User manual]

image

Ripgrep, git grep

[User manual]

image

Installation and usage

Please see the user manual and delta --help.

Live demo by Demoshell

Maintainers

delta (dandavison/delta)

Searching Database…

32.5K ·GitHub
Delta
这是干什么的？Delta 是一个语法高亮分页器，用于 git、diff、grep、ripgrep 和 git blame 的输出。它介于 git 和你的终端之间，让你每天要看的 diff 更容易阅读。
这是装在我电脑上的工具，还是加到我代码里的库？它是一个命令行工具，不是库：一个用 Rust 写的二进制程序，装一次然后配置成 git 的分页器就行。在大多数软件包管理器里这个包叫 'git-delta'，可执行文件就叫 'delta'。
怎么让 git 真正把输出交给它处理？先安装这个包，然后把 README 里的配置块粘贴到你的 ~/.gitconfig 中。之后 git diff、show 和 log 的输出就会通过 delta 渲染；完整手册可以看 'delta --help' 或在线文档。
除了 git，还需要别的东西吗？不需要别的——它是一个独立的二进制程序，直接读取管道传来的终端输出。除了 git，它还能处理普通的 unified diff，并对 rg、git grep 和 grep 的输出做高亮。
我的 diff 还会像正常的 git 输出那样显示吗？这完全由你决定：delta 可以任意接近默认的 git/diff 外观，还内置了 diff-highlight 和 diff-so-fancy 的模拟模式。
Windows 上也能用吗，还是只有 Unix 能用？它是跨平台的：Linux、macOS 和 Windows 的标准软件包管理器里都能装 delta，只要能跑 git 和终端的地方它都能运行。
作者为什么要做这个？代码在不断演进，每个人都要花时间看 diff；delta 的目标是让这项工作既高效又愉快，同时让你完全掌控排版和样式。
我能直接从 diff 里复制代码吗？可以——默认情况下显示的行会去掉 +/- 标记，所以从 diff 里复制出来的行可以直接当代码用。
它能适应浅色和深色终端吗？它会自动检测你的终端背景是浅色还是深色，并相应调整配色。
What are similar projects?difftastic, diff-so-fancy, bat, diffle, hunk, broot, plannotator, eza
Which topics is it in?syntax-highlighter, diff, code-review, git, utility, rust, productivity, command-line-tool, terminal, cli, developer-tools, windows
Creator
dandavison
Size
11.2 MB
Stars
32.5K
Updated
CommitOct 05Release0.20.1Oct 04
Age
7y
Commits · 90 Days