difft: add page (#12598)

* difft: add page

* Update pages/common/difft.md

Co-authored-by: Vítor Henrique <87824454+vitorhcl@users.noreply.github.com>

* Update pages/common/difft.md

Co-authored-by: Vítor Henrique <87824454+vitorhcl@users.noreply.github.com>

* Update pages/common/difft.md

Co-authored-by: Vítor Henrique <87824454+vitorhcl@users.noreply.github.com>

* Update pages/common/difft.md

Co-authored-by: Vítor Henrique <87824454+vitorhcl@users.noreply.github.com>

* Update pages/common/difft.md

Co-authored-by: Vítor Henrique <87824454+vitorhcl@users.noreply.github.com>

* Update pages/common/difft.md

Co-authored-by: Vítor Henrique <87824454+vitorhcl@users.noreply.github.com>

* Update pages/common/difft.md

Co-authored-by: Vítor Henrique <87824454+vitorhcl@users.noreply.github.com>

* Update pages/common/difft.md

Co-authored-by: Vítor Henrique <87824454+vitorhcl@users.noreply.github.com>

* Update pages/common/difft.md

Co-authored-by: Vítor Henrique <87824454+vitorhcl@users.noreply.github.com>

* difft: fix example description

* Update pages/common/difft.md

* difft: update description for compared files

---------

Co-authored-by: Vítor Henrique <87824454+vitorhcl@users.noreply.github.com>
pull/28/head
Fazle Arefin 2024-04-11 08:51:22 +10:00 committed by GitHub
parent 1d1ee2b70c
commit 2c6b53d9e6
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 33 additions and 0 deletions

33
pages/common/difft.md Normal file
View File

@ -0,0 +1,33 @@
# difft
> Compare files or directories based on the syntax of the programming language.
> See also: `delta`, `diff`.
> More information: <https://difftastic.wilfred.me.uk/introduction.html>.
- Compare two files or directories:
`difft {{path/to/file_or_directory1}} {{path/to/file_or_directory2}}`
- Only report the presence of differences between the files:
`difft --check-only {{path/to/file1}} {{path/to/file2}}`
- Specify the display mode (default is `side-by-side`):
`difft --display {{side-by-side|side-by-side-show-both|inline|json}} {{path/to/file1}} {{path/to/file2}}`
- Ignore comments when comparing:
`difft --ignore-comments {{path/to/file1}} {{path/to/file2}}`
- Enable/Disable syntax highlighting of source code (default is `on`):
`difft --syntax-highlight {{on|off}} {{path/to/file1}} {{path/to/file2}}`
- Do not output anything at all if there are no differences between files:
`difft --skip-unchanged {{path/to/file_or_directory1}} {{path/to/file_or_directory2}}`
- Print all programming languages supported by the tool, along with their extensions:
`difft --list-languages`