{"id":15893750,"url":"https://github.com/chinanf-boy/bat-zh","last_synced_at":"2025-03-20T14:30:42.590Z","repository":{"id":90548036,"uuid":"147002121","full_name":"chinanf-boy/bat-zh","owner":"chinanf-boy","description":"🇨🇳翻译: \u003cbat\u003e 一个`cat(1)`克隆与语法高亮和Git集成 ❤️ 校对 ✅","archived":false,"fork":false,"pushed_at":"2019-03-29T04:53:09.000Z","size":24,"stargazers_count":128,"open_issues_count":1,"forks_count":5,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-17T17:04:30.404Z","etag":null,"topics":["cat","docs","git","rust","zh"],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/chinanf-boy.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-09-01T13:48:48.000Z","updated_at":"2025-02-04T08:08:39.000Z","dependencies_parsed_at":"2023-07-18T16:25:28.024Z","dependency_job_id":null,"html_url":"https://github.com/chinanf-boy/bat-zh","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chinanf-boy%2Fbat-zh","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chinanf-boy%2Fbat-zh/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chinanf-boy%2Fbat-zh/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chinanf-boy%2Fbat-zh/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chinanf-boy","download_url":"https://codeload.github.com/chinanf-boy/bat-zh/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244630013,"owners_count":20484298,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cat","docs","git","rust","zh"],"created_at":"2024-10-06T08:13:33.291Z","updated_at":"2025-03-20T14:30:42.584Z","avatar_url":"https://github.com/chinanf-boy.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# bat [![translate-svg]][translate-list]\n\n[translate-svg]: http://llever.com/translate.svg\n[translate-list]: https://github.com/chinanf-boy/chinese-translate-list\n\n「 一个`cat(1)`克隆，搭配语法高亮和Git集成。 」\n\n[中文](./readme.md) | [english](https://github.com/sharkdp/bat)\n\n\n---\n\n\n## 更新 ✅\n\n\u003c!-- doc-templite START generated --\u003e\n\u003c!-- repo = 'sharkdp/bat' --\u003e\n\u003c!-- commit = '84734eac9d19f90f942e587e7ec7d3aad4cda2c2' --\u003e\n\u003c!-- time = '2018 8.30' --\u003e\n翻译的原文 | 与日期 | 最新更新 | 更多\n---|---|---|---\n[commit] | ⏰ 2018 8.30 | ![last] | [中文翻译][translate-list]\n\n[last]: https://img.shields.io/github/last-commit/sharkdp/bat.svg\n[commit]: https://github.com/sharkdp/bat/tree/84734eac9d19f90f942e587e7ec7d3aad4cda2c2\n\n\u003c!-- doc-templite END generated --\u003e\n\n- [bat 中的语法高亮显示说明](assets/readme.md)\n\n### 贡献\n\n欢迎 👏 勘误/校对/更新贡献 😊 [具体贡献请看](https://github.com/chinanf-boy/chinese-translate-list#贡献)\n\n## 生活\n\n[If help, **buy** me coffee —— 营养跟不上了，给我来瓶营养快线吧! 💰](https://github.com/chinanf-boy/live-need-money)\n\n---\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"doc/logo-header.svg\" alt=\"bat - a cat clone with wings\"\u003e\u003cbr\u003e\n  \u003ca href=\"https://travis-ci.org/sharkdp/bat\"\u003e\u003cimg src=\"https://travis-ci.org/sharkdp/bat.svg?branch=master\" alt=\"Build Status\"\u003e\u003c/a\u003e\n  \u003cimg src=\"https://img.shields.io/crates/l/bat.svg\" alt=\"license\"\u003e\n  \u003ca href=\"https://crates.io/crates/bat\"\u003e\u003cimg src=\"https://img.shields.io/crates/v/bat.svg?colorB=319e8c\" alt=\"Version info\"\u003e\u003c/a\u003e\u003cbr\u003e\n  一个 \u003ci\u003ecat(1)\u003c/i\u003e 克隆与语法高亮和Git集成。.\n\u003c/p\u003e\n\n### 目录\n\n\u003c!-- START doctoc generated TOC please keep comment here to allow auto update --\u003e\n\u003c!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE --\u003e\n\n\n  - [语法高亮显示](#%E8%AF%AD%E6%B3%95%E9%AB%98%E4%BA%AE%E6%98%BE%E7%A4%BA)\n  - [Git集成](#git%E9%9B%86%E6%88%90)\n  - [自动分页](#%E8%87%AA%E5%8A%A8%E5%88%86%E9%A1%B5)\n  - [文件串联](#%E6%96%87%E4%BB%B6%E4%B8%B2%E8%81%94)\n- [如何使用](#%E5%A6%82%E4%BD%95%E4%BD%BF%E7%94%A8)\n- [安装](#%E5%AE%89%E8%A3%85)\n  - [Ubuntu](#ubuntu)\n  - [Arch Linux](#arch-linux)\n  - [Void Linux](#void-linux)\n  - [FreeBSD](#freebsd)\n  - [macOS](#macos)\n  - [二进制文件](#%E4%BA%8C%E8%BF%9B%E5%88%B6%E6%96%87%E4%BB%B6)\n  - [源项目](#%E6%BA%90%E9%A1%B9%E7%9B%AE)\n- [定制](#%E5%AE%9A%E5%88%B6)\n  - [高亮主题](#%E9%AB%98%E4%BA%AE%E4%B8%BB%E9%A2%98)\n  - [输出风格](#%E8%BE%93%E5%87%BA%E9%A3%8E%E6%A0%BC)\n  - [添加新语法/语言定义](#%E6%B7%BB%E5%8A%A0%E6%96%B0%E8%AF%AD%E6%B3%95%E8%AF%AD%E8%A8%80%E5%AE%9A%E4%B9%89)\n  - [添加新主题](#%E6%B7%BB%E5%8A%A0%E6%96%B0%E4%B8%BB%E9%A2%98)\n  - [使用不同的页面方式](#%E4%BD%BF%E7%94%A8%E4%B8%8D%E5%90%8C%E7%9A%84%E9%A1%B5%E9%9D%A2%E6%96%B9%E5%BC%8F)\n- [故障排除](#%E6%95%85%E9%9A%9C%E6%8E%92%E9%99%A4)\n  - [终端和颜色](#%E7%BB%88%E7%AB%AF%E5%92%8C%E9%A2%9C%E8%89%B2)\n- [开发](#%E5%BC%80%E5%8F%91)\n- [项目目标和替代方案](#%E9%A1%B9%E7%9B%AE%E7%9B%AE%E6%A0%87%E5%92%8C%E6%9B%BF%E4%BB%A3%E6%96%B9%E6%A1%88)\n\n\u003c!-- END doctoc generated TOC please keep comment here to allow auto update --\u003e\n\n### 语法高亮显示\n\n`bat`支持大量编程和`mark**`语言的语法高亮显示: \n\n![Syntax highlighting example](https://imgur.com/rGsdnDe.png)\n\n### Git集成\n\n`bat`与`git`沟通,显示关于修改的索引 (参见左侧栏) : \n\n![Git integration example](https://i.imgur.com/2lSW4RE.png)\n\n### 自动分页\n\n如果输出对于一个屏幕来说太大,`bat`可以`less`控制自己的输出管道,. \n\n### 文件串联\n\n哦..你也可以用它来串联文件 :wink: . 每当`bat`检测到非交互式终端,它将回退到打印普通文件内容. \n\n## 如何使用\n\n在终端上显示单个文件\n\n```bash\n\u003e bat README.md\n```\n\n一次显示多个文件\n\n```bash\n\u003e bat src/*.rs\n```\n\n从stdin读取,指定明确语言\n\n```bash\n\u003e yaml2json .travis.yml | json_pp | bat -l json\n```\n\n```bash\n\u003e curl -s https://raw.githubusercontent.com/sharkdp/bat/master/src/main.rs | bat -l rs\n```\n\n作为`cat`的替代品: \n\n```bash\nbat \u003e note.md  # 快速 创建一个新文件\n\nbat header.md content.md footer.md \u003e document.md\n\nbat -n main.rs  # 展示行数 (only)\n\nbat f - g  # 先输出 'f', 之后是 stdin, 之后是 'g'.\n```\n\n## 安装\n\n### Ubuntu\n\n*一些和其他基于Debian的Linux发行版.*\n\n从[releases页面](https://github.com/sharkdp/bat/releases),下载最新的`.deb`包裹,并通过以下方式安装: \n\n```bash\nsudo dpkg -i bat_0.6.0_amd64.deb  # adapt version number and architecture\n```\n\n### Arch Linux\n\n你可以安装[该`bat`包](https://www.archlinux.org/packages/community/x86_64/bat/),官方来源: \n\n```bash\npacman -S bat\n```\n\n### Void Linux\n\n你可以通过xbps-install安装`bat`: \n\n    xbps-install -S bat\n\n### FreeBSD\n\n您可以用pkg安装预编译的[`bat`包](https://www.freshports.org/textproc/bat): \n\n```bash\npkg install bat\n```\n\n或者在FreeBSD上,自己构建它: \n\n```bash\ncd /usr/ports/textproc/bat\nmake install\n```\n\n### macOS\n\n你可以安装`bat`,通过[brew](http://braumeister.org/formula/bat): \n\n```bash\nbrew install bat\n```\n\n### 二进制文件\n\n看[releases页面](https://github.com/sharkdp/bat/releases),其中预建版本的`bat`,有许多不同的架构, 要看清楚啦. \n\n### 源项目\n\n如果你想建立`bat`的源代码,您需要`Rust 1.26或更高版本`. 然后你可以使用`cargo`建立一切: \n\n```bash\ncargo install bat\n```\n\n在macOS上,您可能必须安装`cmake` (`brew install cmake`) 以便构建一些依赖项. \n\n## 定制\n\n### 高亮主题\n\n使用`bat --list-themes`获取语​​法高亮显示的所有可用主题的列表. 选择`TwoDark`主题,运行`bat`带`--theme=TwoDark`选项，或设置`BAT_THEME`环境变量为`TwoDark`. 在你的shell启动文件中使用`export BAT_THEME=\"TwoDark\"`,使更改永久化. \n\n### 输出风格\n\n你可以使用`--style`这个外观的选项,控制`bat`输出. 您可以使用`--style=numbers,changes`例如,仅显示Git更改和行号 ,但没有网格和文件头. \n\n### 添加新语法/语言定义\n\n`bat`使用优秀的语法高亮的库[`syntect`](https://github.com/trishume/syntect/). `syntect`可以阅读任何[Sublime Text的`.sublime-syntax`文件](https://www.sublimetext.com/docs/3/syntax.html)和主题. 要添加新语法定义,请执行以下操作. \n\n使用语法定义文件创建一个文件夹: \n\n```bash\nBAT_CONFIG_DIR=\"$(bat cache --config-dir)\"\n\nmkdir -p \"$BAT_CONFIG_DIR/syntaxes\"\ncd \"$BAT_CONFIG_DIR/syntaxes\"\n\n# 把 '.sublime-syntax' 语言定义文件 放到\n# 这个syntaxes目录 (or 它的 子目录), 例如:\ngit clone https://github.com/tellnobody1/sublime-purescript-syntax\n```\n\n现在使用以下命令将这些文件解析为二进制缓存: \n\n```bash\nbat cache --init\n```\n\n最后,使用`bat --list-languages`检查新语言是否可用. \n\n如果您想要返回默认设置,请使用: \n\n```bash\nbat cache --clear\n```\n\n### 添加新主题\n\n这与我们添加新语法定义的方式非常相似. \n\n首先,使用新语法高亮显示主题创建一个文件夹: \n\n```bash\nBAT_CONFIG_DIR=\"$(bat cache --config-dir)\"\n\nmkdir -p \"$BAT_CONFIG_DIR/themes\"\ncd \"$BAT_CONFIG_DIR/themes\"\n\n# 下载一个主题是 '.tmTheme' 格式, for example:\ngit clone https://github.com/greggb/sublime-snazzy\n\n# 更新缓存\nbat cache --init\n```\n\n最后,使用`bat --list-themes`检查新主题是否可用. \n\n### 使用不同的页面方式\n\n`bat`使用在`PAGER`环境变量中,指定的页面方式. 如果未设置此变量,`less`就是默认使用的. 如果要使用其他页面方式,可以修改`PAGER`变量或设置`BAT_PAGER`环境变量,以覆盖在`PAGER`中指定的内容. 如果要将命令行参数传递给页面方式,则需要创建一个 小的shell脚本 作为包装器,例如: \n\n```bash\n#!/bin/bash\n\nless --tabs 4 -RF \"$@\"\n```\n\n## 故障排除\n\n### 终端和颜色\n\n`bat`控制终端*有*还是*没有*真彩色支持. 但是,语法高亮主题中的颜色未针对8位颜色进行优化,因此强烈建议您使用具有24位真彩色支持的终端 (`terminator`,`konsole`,`iTerm2`,...) . 看看[本文](https://gist.github.com/XVilka/8346728)了解更多详情和完整的支持truecolor的终端列表. \n\n确保你的truecolor终端,设置了`COLORTERM`变量到`truecolor`或者`24bit`. 除此以外,`bat`将无法确定是否支持24位转义序列 (并回退到8位颜色) . \n\n## 开发\n\n```bash\n# Recursive clone to retrieve all submodules\ngit clone --recursive https://github.com/sharkdp/bat\n\n# Build (debug version)\ncd bat\ncargo build\n\n# Run unit tests and integration tests\ncargo test\n\n# Install (release version)\ncargo install\n\n# 构建 bat 二进制文件, 若修改了的语法和主题\nbash assets/create.sh\ncargo install -f\n```\n\n## 项目目标和替代方案\n\n`bat`试图实现以下目标: \n\n-   提供美观,高级的语法高亮\n-   与Git集成以显示文件修改\n-   是 (POSIX)`cat` 的直接替代品\n-   提供用户友好的命令行界面\n\n如果你正在寻找类似的程序,有很多选择. 看[这个文件](doc/alternatives.zh.md)进行比较. \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchinanf-boy%2Fbat-zh","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchinanf-boy%2Fbat-zh","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchinanf-boy%2Fbat-zh/lists"}