kelelawar
v0.24.0
Terima kasih khusus ditujukan kepada sponsor terbesar kami:
Aplikasi Anda, siap untuk perusahaan.
Mulai menjual ke pelanggan perusahaan hanya dengan beberapa baris kode.
Tambahkan Sistem Masuk Tunggal (dan lainnya) dalam hitungan menit, bukan bulan.
Warp, terminal cerdas
Jalankan perintah seperti pengguna ahli dengan AI dan tim pengembang Anda
pengetahuan dalam satu terminal yang cepat dan intuitif. Untuk MacOS atau Linux.
bat mendukung penyorotan sintaksis untuk sejumlah besar bahasa pemrograman dan markup:
bat berkomunikasi dengan git untuk menunjukkan modifikasi sehubungan dengan indeks (lihat bilah sisi kiri):
Anda dapat menggunakan opsi -A / --show-all untuk menampilkan dan menyorot karakter yang tidak dapat dicetak:
Secara default, bat menyalurkan keluarannya sendiri ke pager (misalnya less ) jika keluarannya terlalu besar untuk satu layar. Jika Anda lebih suka bat seperti cat sepanjang waktu (tidak pernah mengeluarkan halaman), Anda dapat mengatur --paging=never sebagai opsi, baik di baris perintah atau di file konfigurasi Anda. Jika Anda ingin menggunakan alias cat to bat dalam konfigurasi shell Anda, Anda dapat menggunakan alias cat='bat --paging=never' untuk mempertahankan perilaku default.
Bahkan dengan satu set pager, Anda masih dapat menggunakan bat untuk menggabungkan file. Setiap kali bat mendeteksi terminal non-interaktif (yaitu ketika Anda menyalurkan ke proses lain atau ke dalam file), bat akan bertindak sebagai pengganti cat dan kembali mencetak konten file biasa, terlepas dari opsi --pager nilai.
Tampilkan satu file di terminal
> kelelawar README.md
Menampilkan banyak file sekaligus
> kelelawar src/*.rs
Baca dari stdin, tentukan sintaks secara otomatis (catatan, penyorotan hanya akan berfungsi jika sintaks dapat ditentukan dari baris pertama file, biasanya melalui shebang seperti #!/bin/sh )
> curl -s https://sh.rustup.rs | kelelawar
Baca dari stdin, tentukan bahasanya secara eksplisit
> yaml2json .travis.yml | json_pp | kelelawar -l json
Menampilkan dan menyorot karakter yang tidak dapat dicetak:
> kelelawar -A /etc/hosts
Gunakan sebagai pengganti cat :
bat > note.md # cepat membuat file barubat header.md content.md footer.md > document.md bat -n main.rs # tampilkan nomor baris (hanya)bat f - g # keluaran 'f', lalu stdin, lalu 'g'.
fzf Anda dapat menggunakan bat sebagai pratinjau untuk fzf . Untuk melakukan ini, gunakan opsi bat s --color=always untuk memaksa keluaran berwarna. Anda juga dapat menggunakan opsi --line-range untuk membatasi waktu muat file panjang:
fzf --pratinjau "bat --color=selalu --style=angka --line-range=:500 {}" Untuk informasi lebih lanjut, lihat README fzf .
find atau fd Anda dapat menggunakan opsi -exec dari find untuk melihat pratinjau semua hasil pencarian dengan bat :
temukan … -exec kelelawar {} + Jika Anda menggunakan fd , Anda dapat menggunakan opsi -X / --exec-batch untuk melakukan hal yang sama:
fd… -X kelelawar
ripgrep Dengan batgrep , bat dapat digunakan sebagai printer untuk hasil pencarian ripgrep .
jarum batgrep src/
tail -f bat dapat dikombinasikan dengan tail -f untuk terus memantau file tertentu dengan penyorotan sintaksis.
tail -f /var/log/pacman.log | bat --paging=tidak pernah -l log
Perhatikan bahwa kita harus mematikan paging agar ini berfungsi. Kami juga telah menentukan sintaks secara eksplisit ( -l log ), karena dalam kasus ini tidak dapat dideteksi secara otomatis.
git Anda dapat menggabungkan bat dengan git show untuk melihat versi lama dari file tertentu dengan penyorotan sintaksis yang tepat:
git tampilkan v0.6.0:src/main.rs | kelelawar -l rs
git diff Anda dapat menggabungkan bat dengan git diff untuk melihat baris di sekitar perubahan kode dengan penyorotan sintaksis yang tepat:
batdiff() {
git diff --hanya nama --relatif --diff-filter=d | xargs kelelawar --diff
} Jika Anda lebih suka menggunakan ini sebagai alat terpisah, lihat batdiff di bat-extras .
Jika Anda mencari dukungan lebih lanjut untuk operasi git dan diff, lihat delta .
xclip Nomor baris dan penanda modifikasi Git pada keluaran bat dapat mempersulit penyalinan konten file. Untuk mencegah hal ini, Anda dapat memanggil bat dengan opsi -p / --plain atau cukup menyalurkan output ke xclip :
kelelawar utama.cpp | xclip
bat akan mendeteksi bahwa output sedang dialihkan dan mencetak konten file biasa.
man bat dapat digunakan sebagai pager pewarna untuk man , dengan mengatur variabel lingkungan MANPAGER :
ekspor MANPAGER="sh -c 'col -bx | bat -l man -p'"man 2 pilih
(ganti bat dengan batcat jika Anda menggunakan Debian atau Ubuntu)
Mungkin juga perlu menyetel MANROFFOPT="-c" jika Anda mengalami masalah pemformatan.
Jika Anda lebih suka menggabungkannya dalam perintah baru, Anda juga dapat menggunakan batman .
Perhatikan bahwa sintaks Manpage dikembangkan di repositori ini dan masih memerlukan beberapa perbaikan.
Perhatikan juga bahwa ini tidak akan berhasil dengan implementasi Mandocs man .
prettier / shfmt / rustfmt Skrip prettybat adalah pembungkus yang akan memformat kode dan mencetaknya dengan bat .
--help Anda dapat menggunakan bat untuk mewarnai teks bantuan: $ cp --help | bat -plhelp
Anda juga dapat menggunakan pembungkus untuk ini:
# di .bashrc/.zshrc/*rcalias bathelp='bat --plain --bahasa=help'help() {"$@" --help 2>&1 | bantuan mandi
} Kemudian Anda dapat melakukan $ help cp atau $ help git commit .
Saat Anda menggunakan zsh , Anda juga dapat menggunakan alias global untuk mengganti -h dan --help seluruhnya:
alias -g -- -h='-h 2>&1 | kelelawar --bahasa=bantuan --style=plain'alias -g -- --help='--help 2>&1 | kelelawar --bahasa=bantuan --style=polos'
Dengan cara ini, Anda dapat terus menggunakan cp --help , tetapi mendapatkan halaman bantuan berwarna.
Sadarilah bahwa dalam beberapa kasus, -h mungkin bukan singkatan dari --help (misalnya dengan ls ).
Silakan laporkan masalah apa pun dengan sintaks bantuan di repositori ini.
apt )... dan distribusi Linux berbasis Debian lainnya.
bat tersedia di Ubuntu sejak 20.04 ("Focal") dan Debian sejak Agustus 2021 (Debian 11 - "Bullseye").
Jika instalasi Ubuntu/Debian Anda cukup baru, Anda cukup menjalankan:
sudo apt install kelelawar
Penting : Jika Anda menginstal bat dengan cara ini, perlu diketahui bahwa executable mungkin diinstal sebagai batcat bukan bat (karena nama berbenturan dengan paket lain). Anda dapat mengatur symlink atau alias bat -> batcat untuk mencegah masalah apa pun yang mungkin muncul karena hal ini dan agar konsisten dengan distribusi lain:
mkdir -p ~/.local/bin di -s /usr/bin/batcat ~/.local/bin/bat
.deb terbaru)... dan distribusi Linux berbasis Debian lainnya.
Jika paket belum dipromosikan ke instalasi Ubuntu/Debian Anda, atau Anda menginginkan rilis terbaru bat , unduh paket .deb terbaru dari halaman rilis dan instal melalui:
sudo dpkg -i bat_0.18.3_amd64.deb # menyesuaikan nomor versi dan arsitektur
Anda dapat menginstal paket bat dari sumber resmi, asalkan Anda mengaktifkan repositori yang sesuai:
apk tambahkan kelelawar
Anda dapat menginstal paket bat dari sumber resmi:
pacman -S kelelawar
Anda dapat menginstal paket bat dari repositori resmi Fedora Modular.
dnf instal kelelawar
Anda dapat menginstal paket bat dari dev-kit.
muncul sys-apps/bat
Anda dapat menginstal paket bat dari sumber resmi:
muncul sys-apps/bat
Anda dapat menginstal bat melalui xbps-install:
xbps-install -S kelelawar
Anda dapat menginstal bat melalui pkg:
pkg instal kelelawar
Anda dapat menginstal paket bat yang telah dikompilasi dengan pkg:
pkg instal kelelawar
atau buat sendiri dari port FreeBSD:
cd /usr/ports/textproc/bat buat instal
Anda dapat menginstal paket bat menggunakan pkg_add(1) :
pkg_tambahkan kelelawar
Anda dapat menginstal bat menggunakan manajer paket nix:
nix-env -i kelelawar
Anda dapat menginstal bat menggunakan Flox
flox menginstal kelelawar
Anda dapat menginstal bat dengan zipper:
zypper menginstal kelelawar
Saat ini tidak ada paket snap yang direkomendasikan tersedia. Paket yang ada mungkin tersedia, namun tidak didukung secara resmi dan mungkin mengandung masalah.
Anda dapat menginstal bat dengan Homebrew:
pembuatan bir menginstal kelelawar
Atau instal bat dengan MacPorts:
pemasangan port kelelawar
Ada beberapa opsi untuk menginstal bat di Windows. Setelah Anda menginstal bat , lihat bagian "Menggunakan bat di Windows".
Anda perlu menginstal paket Visual C++ Redistributable.
Anda dapat menginstal bat melalui WinGet:
winget instal sharkdp.bat
Anda dapat menginstal bat melalui Chocolatey:
choco instal kelelawar
Anda dapat menginstal bat melalui scoop:
sendok pasang kelelawar
Anda dapat mengunduh biner bawaan dari halaman Rilis,
Anda perlu menginstal paket Visual C++ Redistributable.
Lihat halaman Rilis untuk versi bat yang sudah dibuat sebelumnya untuk berbagai arsitektur. Biner yang terhubung secara statis juga tersedia: cari arsip dengan musl di nama file.
Jika Anda ingin membuat bat dari sumber, Anda memerlukan Rust 1.70.0 atau lebih tinggi. Anda kemudian dapat menggunakan cargo untuk membangun semuanya:
pemasangan kargo --locked bat
Perhatikan bahwa file tambahan seperti halaman manual atau file penyelesaian shell tidak dapat diinstal dengan cara ini. Mereka akan dihasilkan oleh cargo dan harus tersedia di folder target kargo (di bawah build ).
Gunakan bat --list-themes untuk mendapatkan daftar semua tema yang tersedia untuk penyorotan sintaksis. Untuk memilih tema TwoDark , panggil bat dengan opsi --theme=TwoDark atau atur variabel lingkungan BAT_THEME ke TwoDark . Gunakan export BAT_THEME="TwoDark" di file startup shell Anda untuk menjadikan perubahan permanen. Alternatifnya, gunakan file konfigurasi bat s.
Jika Anda ingin melihat pratinjau berbagai tema pada file khusus, Anda dapat menggunakan perintah berikut (Anda memerlukan fzf untuk ini):
kelelawar --daftar-tema | fzf --preview="bat --theme={} --color=selalu /path/ke/file" bat secara otomatis memilih tema yang sesuai tergantung pada warna latar belakang terminal Anda. Anda dapat menggunakan opsi --theme-light / --theme-light atau variabel lingkungan BAT_THEME_DARK / BAT_THEME_LIGHT untuk menyesuaikan tema yang digunakan. Ini sangat berguna jika Anda sering beralih antara mode gelap dan terang.
Anda juga dapat menggunakan tema khusus dengan mengikuti bagian 'Menambahkan tema baru' di bawah.
bat memiliki tiga tema yang selalu menggunakan warna 8-bit, meskipun dukungan warna asli tersedia:
ansi terlihat bagus di terminal mana pun. Ia menggunakan warna 3-bit: hitam, merah, hijau, kuning, biru, magenta, cyan, dan putih.
base16 dirancang untuk tema terminal base16. Ini menggunakan warna 4-bit (warna 3-bit ditambah varian cerah) sesuai dengan pedoman gaya base16.
base16-256 dirancang untuk shell base16. Ini menggantikan warna cerah tertentu dengan warna 8-bit dari 16 hingga 21. Jangan gunakan ini hanya karena Anda memiliki terminal 256 warna tetapi tidak menggunakan shell base16.
Meskipun tema ini lebih terbatas, tema ini memiliki tiga keunggulan dibandingkan tema warna asli. Mereka:
Nikmati kompatibilitas maksimal. Beberapa utilitas terminal tidak mendukung warna lebih dari 3-bit.
Beradaptasi dengan perubahan tema terminal. Bahkan untuk keluaran yang sudah dicetak.
Harmonis secara visual lebih baik dengan perangkat lunak terminal lainnya.
Anda dapat menggunakan opsi --style untuk mengontrol tampilan keluaran bat . Anda dapat menggunakan --style=numbers,changes , misalnya, untuk hanya menampilkan perubahan Git dan nomor baris tetapi tanpa kisi dan header file. Setel variabel lingkungan BAT_STYLE untuk menjadikan perubahan ini permanen atau gunakan file konfigurasi bat .
Tip
Jika Anda menentukan gaya default di file konfigurasi bat , Anda dapat mengubah komponen mana yang ditampilkan selama satu kali menjalankan bat menggunakan argumen baris perintah --style . Dengan mengawali komponen dengan + atau - , komponen tersebut dapat ditambahkan atau dihapus dari gaya saat ini.
Misalnya, jika konfigurasi Anda berisi --style=full,-snip , Anda dapat menjalankan bat dengan --style=-grid,+snip untuk menghapus grid dan menambahkan kembali komponen snip . Atau, jika Anda ingin mengganti gaya sepenuhnya, gunakan --style=numbers untuk hanya menampilkan nomor baris.
Jika Anda menemukan bahwa sintaks tertentu tidak tersedia dalam bat , Anda dapat mengikuti petunjuk ini untuk menambahkan sintaks baru dengan mudah ke instalasi bat Anda saat ini.
bat menggunakan perpustakaan syntect yang sangat baik untuk penyorotan sintaksis. syntect dapat membaca file dan tema Sublime Text .sublime-syntax apa pun.
Sumber yang bagus untuk menemukan paket Sintaks Sublime adalah Kontrol Paket. Setelah Anda menemukan sintaks:
Buat folder dengan file definisi sintaksis:
mkdir -p "$(bat --config-dir)/syntaxes"cd "$(bat --config-dir)/syntaxes"# Masukkan file definisi bahasa '.sublime-syntax' baru# di folder ini (atau subdirektorinya ), misalnya: git clone https://github.com/tellnobody1/sublime-purescript-syntax
Sekarang gunakan perintah berikut untuk mengurai file-file ini ke dalam cache biner:
cache kelelawar --build
Terakhir, gunakan bat --list-languages untuk memeriksa apakah bahasa baru tersedia.
Jika Anda ingin kembali ke pengaturan default, hubungi:
cache kelelawar --hapus
Jika menurut Anda sintaks tertentu harus disertakan dalam bat secara default, harap pertimbangkan untuk membuka tiket "permintaan sintaksis" setelah membaca kebijakan dan instruksi di sini: Buka Permintaan Sintaks.
Cara kerjanya sangat mirip dengan cara kita menambahkan definisi sintaksis baru.
Pertama, buat folder dengan tema penyorotan sintaksis baru:
mkdir -p "$(bat --config-dir)/themes"cd "$(bat --config-dir)/themes"# Download tema dalam format '.tmTheme', contoh:git clone https:// github.com/greggb/sublime-snazzy# Perbarui cachebat cache biner --build
Terakhir, gunakan bat --list-themes untuk memeriksa apakah tema baru tersedia.
Anda dapat menambahkan pola nama file baru (atau mengubah yang sudah ada) menggunakan opsi baris perintah --map-syntax . Opsi ini mengambil argumen dalam bentuk pattern:syntax di mana pattern adalah pola glob yang cocok dengan nama file dan jalur file absolut. Bagian syntax adalah nama lengkap bahasa yang didukung (gunakan bat --list-languages untuk gambaran umum).
Catatan: Anda mungkin ingin menggunakan opsi ini sebagai entri dalam file konfigurasi bat untuk persistensi alih-alih meneruskannya pada baris perintah sebagai satu kali saja. Umumnya Anda cukup menggunakan -l jika Anda ingin menentukan bahasa untuk suatu file secara manual.
Contoh: Untuk menggunakan penyorotan sintaksis "INI" untuk semua file dengan ekstensi file .conf , gunakan
--map-syntax='*.conf:INI'
Contoh: Untuk membuka semua file bernama .ignore (sama persis) dengan sintaks "Git Ignore", gunakan:
--map-syntax='.ignore:Git Abaikan'
Contoh: Untuk membuka semua file .conf di subfolder /etc/apache2 dengan sintaks "Apache Conf", gunakan (pemetaan ini sudah ada di dalamnya):
--map-syntax='/etc/Apache2/**/*.conf:Konferensi Apache'
bat menggunakan pager yang ditentukan dalam variabel lingkungan PAGER . Jika variabel ini tidak disetel, less akan digunakan secara default. Jika Anda ingin menggunakan pager yang berbeda, Anda dapat memodifikasi variabel PAGER atau mengatur variabel lingkungan BAT_PAGER untuk menggantikan apa yang ditentukan dalam PAGER .
Catatan
Jika PAGER more atau most , bat akan menggunakan less secara diam-diam untuk memastikan dukungan warna.
Jika Anda ingin meneruskan argumen baris perintah ke pager, Anda juga dapat mengaturnya melalui variabel PAGER / BAT_PAGER :
ekspor BAT_PAGER="kurang -RF"
Daripada menggunakan variabel lingkungan, Anda juga dapat menggunakan file konfigurasi bat untuk mengonfigurasi pager ( opsi --pager ).
less sebagai pager Saat menggunakan less sebagai pager, bat akan secara otomatis meneruskan opsi tambahan ke less untuk meningkatkan pengalaman. Secara khusus, -R / --RAW-CONTROL-CHARS , -F / --quit-if-one-screen , dan dalam kondisi tertentu, -X / --no-init dan/atau -S / --chop-long-lines .
Penting
Opsi ini tidak akan ditambahkan jika:
Pager tidak diberi nama less .
Argumen --pager berisi argumen baris perintah apa pun (misalnya --pager="less -R" ).
Variabel lingkungan BAT_PAGER berisi argumen baris perintah apa pun (misalnya export BAT_PAGER="less -R" )
Opsi --quit-if-one-screen tidak akan ditambahkan ketika:
Argumen --paging=always digunakan.
Lingkungan BAT_PAGING disetel ke always .
Opsi -R diperlukan untuk menafsirkan warna ANSI dengan benar.
Opsi -F menginstruksikan less untuk segera keluar jika ukuran keluaran lebih kecil dari ukuran vertikal terminal. Ini nyaman untuk file kecil karena Anda tidak perlu menekan q untuk keluar dari pager.
Opsi -X diperlukan untuk memperbaiki bug pada fitur --quit-if-one-screen di versi yang less lama dari versi 530. Sayangnya, opsi ini juga merusak dukungan roda mouse di versi less . Jika Anda ingin mengaktifkan pengguliran roda mouse pada versi less yang lebih lama dan tidak keberatan kehilangan fitur berhenti jika satu layar, Anda dapat mengatur pager (melalui --pager atau BAT_PAGER ) ke less -R . Dengan less 530 atau lebih baru, ini akan langsung berfungsi.
Opsi -S ditambahkan ketika opsi -S / --chop-long-lines bat digunakan. Ini memberitahu less untuk memotong garis apa pun yang lebih besar dari lebar terminal.
bat memperluas tab menjadi 4 spasi dengan sendirinya, tidak bergantung pada pager. Untuk mengubahnya, cukup tambahkan argumen --tabs dengan jumlah spasi yang ingin Anda tampilkan.
Catatan : Mendefinisikan perhentian tab untuk pager (melalui argumen --pager dengan bat , atau melalui variabel lingkungan LESS untuk less ) tidak akan diperhitungkan karena pager sudah mendapatkan spasi yang diperluas, bukan tab. Perilaku ini ditambahkan untuk menghindari masalah lekukan yang disebabkan oleh sidebar. Memanggil bat dengan --tabs=0 akan menimpanya dan membiarkan tab digunakan oleh pager.
Jika Anda menggunakan fitur mode gelap di macOS, Anda mungkin ingin mengonfigurasi bat untuk menggunakan tema berbeda berdasarkan tema OS. Cuplikan berikut menggunakan tema default saat dalam mode gelap dan tema GitHub saat dalam mode terang .
alias cat="bat --theme=$(baca default -globalDomain AppleInterfaceStyle &> /dev/null && echo default || echo GitHub)"
bat juga dapat dikustomisasi dengan file konfigurasi. Lokasi file bergantung pada sistem operasi Anda. Untuk mendapatkan jalur default untuk sistem Anda, hubungi
kelelawar --config-file
Alternatifnya, Anda dapat menggunakan variabel lingkungan BAT_CONFIG_PATH atau BAT_CONFIG_DIR untuk mengarahkan bat ke lokasi non-default dari file konfigurasi atau direktori konfigurasi:
ekspor BAT_CONFIG_PATH="/path/to/bat/bat.conf"ekspor BAT_CONFIG_DIR="/path/to/bat"
File konfigurasi default dapat dibuat dengan opsi --generate-config-file .
kelelawar --menghasilkan-config-file
Sekarang juga terdapat file konfigurasi seluruh sistem, yang terletak di bawah /etc/bat/config di Linux dan Mac OS dan C:ProgramDatabatconfig di windows. Jika file konfigurasi seluruh sistem ada, konten konfigurasi pengguna akan ditambahkan ke dalamnya.
File konfigurasi adalah daftar sederhana argumen baris perintah. Gunakan bat --help untuk melihat daftar lengkap opsi dan nilai yang memungkinkan. Selain itu, Anda dapat menambahkan komentar dengan mengawali baris dengan karakter # .
Contoh file konfigurasi:
# Atur tema menjadi "TwoDark"--theme="TwoDark"# Tampilkan nomor baris, modifikasi Git, dan header file (tetapi tanpa grid)--style="numbers,changes,header"# Gunakan teks miring di terminal (bukan didukung di semua terminal)--italic-text=always# Gunakan sintaks C++ untuk file Arduino .ino--map-syntax "*.ino:C++"
bat di Windows bat sebagian besar berfungsi langsung di Windows, tetapi beberapa fitur mungkin memerlukan konfigurasi tambahan.
Anda perlu menginstal paket Visual C++ Redistributable.
Windows hanya menyertakan pager yang sangat terbatas dalam bentuk more . Anda dapat mengunduh biner Windows dengan less dari beranda atau melalui Chocolatey. Untuk menggunakannya, letakkan biner di direktori di PATH Anda atau tentukan variabel lingkungan. Paket Chocolatey menginstal less secara otomatis.
Windows 10 secara asli mendukung warna di conhost.exe (Command Prompt) dan PowerShell sejak v1511, serta di versi bash yang lebih baru. Pada versi Windows sebelumnya, Anda dapat menggunakan Cmder, yang menyertakan ConEmu.
Catatan: Versi less yang lebih lama tidak menafsirkan warna dengan benar di Windows. Untuk memperbaikinya, Anda dapat menambahkan alat Unix opsional ke PATH Anda saat menginstal Git. Jika Anda tidak memasang pager lain, Anda dapat menonaktifkan paging sepenuhnya dengan meneruskan --paging=never atau dengan menyetel BAT_PAGER ke string kosong.
bat di Windows tidak secara asli mendukung jalur gaya unix Cygwin ( /cygdrive/* ). Ketika melewati jalur cygwin absolut sebagai argumen, bat akan menemui kesalahan berikut: The system cannot find the path specified. (os error 3)
Ini dapat diatasi dengan membuat pembungkus atau menambahkan fungsi berikut ke file .bash_profile Anda:
bat() {local indexlocal args=("$@")untuk indeks di $(seq 0 ${#args[@]}) ; docase "${args[index]}" di-*) lanjutkan;;*) [ -e "${args[index]}" ] && args[index]="$(cygpath --windows "${args[ indeks]}"";;esacdonecommand bat "${args[@]}"} Jika file masukan berisi kode warna atau rangkaian escape ANSI atau karakter kontrol lainnya, bat akan mengalami masalah dalam melakukan penyorotan sintaksis dan pembungkusan teks, sehingga keluaran dapat menjadi kacau.
Jika versi bat Anda mendukung opsi --strip-ansi=auto , ini dapat digunakan untuk menghapus urutan tersebut sebelum penyorotan sintaksis. Alternatifnya, Anda dapat menonaktifkan penyorotan sintaksis dan pembungkusan dengan meneruskan opsi --color=never --wrap=never ke bat .
Catatan
Opsi auto --strip-ansi menghindari penghapusan urutan escape ketika sintaksnya berupa teks biasa.
bat menangani terminal dengan dan tanpa dukungan warna asli. Namun, warna di sebagian besar tema penyorotan sintaksis tidak dioptimalkan untuk warna 8-bit. Oleh karena itu sangat disarankan agar Anda menggunakan terminal dengan dukungan truecolor 24-bit ( terminator , konsole , iTerm2 , ...), atau menggunakan salah satu tema dasar 8-bit yang dirancang untuk kumpulan warna terbatas. Lihat artikel ini untuk rincian lebih lanjut dan daftar lengkap terminal dengan dukungan truecolor.
Pastikan terminal truecolor Anda menyetel variabel COLORTERM ke truecolor atau 24bit . Jika tidak, bat tidak akan dapat menentukan apakah rangkaian escape 24-bit didukung atau tidak (dan kembali ke warna 8-bit).
Silakan coba tema lain (lihat bat --list-themes untuk daftarnya). Tema OneHalfDark dan OneHalfLight memberikan warna grid dan garis yang lebih cerah.
bat secara asli mendukung UTF-8 dan juga UTF-16. Untuk setiap pengkodean file lainnya, Anda mungkin perlu mengonversi ke UTF-8 terlebih dahulu karena pengkodean biasanya tidak dapat dideteksi secara otomatis. Anda dapat iconv untuk melakukannya. Contoh: jika Anda memiliki file PHP dalam pengkodean Latin-1 (ISO-8859-1), Anda dapat menghubungi:
ikonv -f ISO-8859-1 -t UTF-8 file-saya.php | kelelawar
Catatan: Anda mungkin harus menggunakan opsi -l / --language jika sintaksisnya tidak dapat dideteksi secara otomatis oleh bat .
# Klon rekursif untuk mengambil semua submodul git clone --rekursif https://github.com/sharkdp/bat# Build (versi debug)cd bat cargo build --bins# Jalankan tes unit dan tes integrasicargo test# Instal (versi rilis)cargo install --path . --locked# Bangun biner kelelawar dengan sintaksis yang dimodifikasi dan aset temabash/create.sh pemasangan kargo --path . --terkunci --memaksa
Jika Anda ingin membangun aplikasi yang menggunakan fitur pencetakan cantik bat sebagai perpustakaan, lihat dokumentasi API. Perhatikan bahwa Anda harus menggunakan regex-onig atau regex-fancy sebagai fitur ketika Anda bergantung pada bat sebagai perpustakaan.
Lihatlah panduan CONTRIBUTING.md .
sharkdp
et-p
keith-hall
Enselik
Silakan hubungi David Peter melalui email jika Anda ingin melaporkan kerentanan pada bat .
bat mencoba mencapai tujuan berikut:
Berikan penyorotan sintaksis tingkat lanjut yang indah
Integrasikan dengan Git untuk menampilkan modifikasi file
Jadilah pengganti cat (POSIX).
Menawarkan antarmuka baris perintah yang ramah pengguna
Ada banyak alternatif jika Anda mencari program serupa. Lihat dokumen ini untuk perbandingan.
Hak Cipta (c) 2018-2023 pengembang kelelawar.
bat tersedia berdasarkan ketentuan Lisensi MIT atau Lisensi Apache 2.0, sesuai pilihan Anda.
Lihat file LICENSE-APACHE dan LICENSE-MIT untuk rincian lisensi.
