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 — это пейджер с подсветкой синтаксиса для вывода git, diff, grep, ripgrep и git blame. Он встраивается между git и вашим терминалом и делает диффы, которые вы каждый день изучаете, удобнее для чтения.
Это программа, которую я ставлю на свой компьютер, или библиотека для моего кода?Утилита для командной строки, а не библиотека: бинарник на Rust, который ставится один раз и настраивается как пейджер для git. В большинстве пакетных менеджеров пакет называется 'git-delta', а сам исполняемый файл — просто 'delta'.
Как сделать так, чтобы git реально прогонял вывод через него?Установите пакет, затем вставьте блок настроек из README в свой ~/.gitconfig. После этого вывод git diff, show и log отображается через delta; полное руководство доступно по 'delta --help' или онлайн.
Для работы нужен только git или что-то ещё?Больше ничего — это самодостаточный бинарник, который читает переданный через пайп вывод терминала. Помимо git он также понимает обычные unified-диффы и подсвечивает вывод grep из rg, git grep и grep.
Мои диффы перестанут выглядеть как обычный вывод git?Только настолько, насколько вы сами захотите: delta может максимально походить на стандартный вид git/diff, а ещё в ней есть режимы эмуляции diff-highlight и diff-so-fancy.
Он будет работать и на Windows, или это только для Unix?Он кроссплатформенный: delta доступна через стандартные пакетные менеджеры на Linux, macOS и Windows и работает везде, где работают git и терминал.
Почему автор создал этот проект?Код постоянно меняется, и все тратят время на изучение диффов; delta задумана, чтобы сделать эту работу и эффективной, и приятной, оставляя вам полный контроль над оформлением и вёрсткой.
Можно ли копировать код прямо из диффа?Да — маркеры +/- по умолчанию убираются из отображаемых строк, поэтому скопированные из диффа строки можно сразу использовать как код.
Он подстраивается под светлые и тёмные терминалы?Он автоматически определяет, светлый или тёмный у вас фон терминала, и соответственно подстраивает цвета.
What are similar projects?difftastic, diff-so-fancy, bat, diffle, hunk, broot, plannotator, eza
Creator
dandavison
Size
11.2 MB
Stars
32.5K
Age
7y
Commits · 90 Days