如何使用终端访问 Git 用户手册[1]？

Question

在 git 的手册页中，有一行内容为：

See gittutorial(7) to get started, then see giteveryday(7) for a useful minimum set of commands.
The Git User’s Manual[1] has a more in-depth introduction.

如何从终端自己查看 "The Git User's Manual[1]"，而不是在 Internet 上查找。

Answer 1

例如，对于命令 git clone <repo>，您可以使用：

$人git-克隆

或：

$ git 帮助克隆

Answer 2

man git 底部有一些参考链接。 "The Git User's Manual" 之后的脚注编号应对应于其中一个链接。在我的机器上我看到

1. Git User’s Manual
   file:///usr/share/doc/git-doc/user-manual.html

所以我可以在我的机器上查看 /usr/share/doc/git-doc/user-manual.html。您可以使用像 links 这样的 CLI 浏览器来简化阅读 HTML:

links /usr/share/doc/git-doc/user-manual.html

编辑： 在我的机器上该文件实际上并不存在，而且我没有看到提供它的 Arch Linux 包。希望您机器上的 Git 文档是完整的。

如果您的文档也丢失了并且您不介意访问网络，您可以从 Git 的网站浏览用户手册，例如：

links https://git-scm.com/docs/user-manual.html

Answer 3

可以下载txt格式的git用户手册，这里是它的位置：

https://raw.githubusercontent.com/git/git/master/Documentation/user-manual.txt

可以使用wget或curl命令下载。

然后可以使用 less 或 cat 和 grep

的组合来读取它

示例：

## read the first 150 lines of chapter 'Exploring Git history'
cat user-manual.txt | grep "Exploring Git history" -A 150

Answer 4

Git User’s Manual[1] 的 [1] 部分说这是一个注释。

一直读到手册页的末尾（按 space 栏跳到下面的一页）以转到 NOTES 部分。

第一个音符是：

NOTES
    1. Git User’s Manual
       git-htmldocs/user-manual.html

git-htmldocs/user-manual.html 不是有效的 URL，对我来说没有任何意义。

但是 man git 的第一部分（您提取问题中发布的片段的地方）也说：

A formatted and hyperlinked copy of the latest Git documentation can be viewed at https://git.github.io/htmldocs/git.html.

在https://git.github.io/htmldocs/git.html there is the same documentation as HTML and the Git User's Manual link in this documentation points to: https://git.github.io/htmldocs/user-manual.html

您还可以阅读其网站上的 Git 文档：https://git-scm.com/docs

Answer 5

Git 用户手册是 git 本身的一部分。可以通过克隆托管在 kernel.org.

的 git 存储库来访问它

您要找的文件是Documentation/user-manual.txt。要在终端中访问它，请克隆其中之一：

git://git.kernel.org/pub/scm/git/git.git
https://git.kernel.org/pub/scm/git/git.git
https://kernel.googlesource.com/pub/scm/git/git.git

您也可以只克隆文档，而不从 here 列出的 git-htmldocs 存储库中克隆 git 的其余部分。这些包括 asciidoctor 源和呈现的 HTML.

请注意，如果仅使用网络浏览器浏览，则内容已发布 here。

Answer 6

该答案是现有答案的组合加上说明如果本地不可用如何添加文件。

当我运行 man git 在我的 Linux 上时，它也有一个短语：

The Git User’s Manual[1]

它看起来像一个脚注，确实接近手册页的末尾，我看到：

    1. Git User’s Manual
       file:///usr/share/doc/git/html/user-manual.html

但是文件不存在：

$ ls /usr/share/doc/git/html/user-manual.html
ls: cannot access '/usr/share/doc/git/html/user-manual.html': No such file or directory

我无法通过 apt-get install 找到要添加它的包（在搜索过程中我发现了问答）。为了添加它，我使用了：

git clone https://github.com/git/htmldocs.git

文件在htmldocs文件夹里user-manual.html，我复制了

sudo mkdir --parents /usr/share/doc/git/html
sudo cp htmldocs/user-manual.html /usr/share/doc/git/html

然后通过网络浏览器打开它，例如正如另一个答案中所建议的那样：

links /usr/share/doc/git/html/user-manual.html

（在 sudo apt-get install links 之后作为主流 Linux 发行版默认没有安装它）。

如何使用终端访问 Git 用户手册[1]？

How do I access Git User’s Manual[1] using the terminal?

git

manpage