在本地安装git的HTML帮助文档

当我们想查询git某条指令如何使用时,git官网有详尽的文档供我们查看。在命令行下我们也可以随时通过 git –help的方法查看某条命令的详细帮助。

相对于在Terminal中内置的帮助文档,HTML格式更清晰,更详尽。

但是如果我想在无法上网的情况下也能查看git官网的详尽的帮助文档,有没有办法那?当然有了,下面就教大家如何在本机搭建git的HTML帮助文档。

在Windows上设置很简单,主需要安装Msysgit,就会自动为你设置起本地的HTML帮助文档。所以这篇文章主要讲在Mac和Linux下该如何实现。

一,运行git help –-web commit查看git默认的保存html文件的路径。

1
2
3
4
5
$ git help --web commit
#Attempt to open the html help for the commit command
#fatal: '/usr/local/git/share/doc/git-doc': not a documentationdirectory.

我们得到了git默认的存放html文件的路径是/usr/local/git/share/doc/git-doc。当然你得到的路径有可能和这个不一样。

二,切换到这个路径下,迁出存放在git repo中的html文件。

1
2
3
4
$ sudo mkdir -p /usr/local/git/share/doc
# Create the path for the docs to be installed to cd #/usr/local/git/share/doc
$ sudo git clone git://git.kernel.org/pub/scm/git/git-htmldocs.git git-doc
# Clone the git repo and check out the html documents branch

三,运行 vim ~/.gitconfig 命令,在.gitconfig文件中加入如下配置。

1
2
3
4
5
6
7
[help]
        format = web
[web]
        browser = open

当然也可以使用其他的编辑器来编辑.gitconfig文件。

只要这三步就设置起了本地的HTML帮助文档。你可以再次运行git help -–web commit,就可以查看在浏览器中自动打开的HTML帮助说明页面了。

如果git的帮助文档更新了,如何同步到本地那?很简单,运行git pull命令就行。

1
2
$ cd /usr/local/git/share/doc/git-doc
$ sudo git pull

如何查看这些帮助文档那?更简单了,例如:

1
$ git remote --help

就会自动在浏览器中打开针对remote的帮助文档。

时间: 2024-10-27 05:49:02

在本地安装git的HTML帮助文档的相关文章

跪求php Azure SDK的安装过程,看着文档一步一步去做,都安装不行。

问题描述 跪求php Azure SDK的安装过程,看着文档一步一步去做,都安装不行. 跪求Azure SDK的安装过程,看着文档一步一步去做,都安装不行 解决方案 看下你的azure sdk本身有没有装对,另外系统要用原版的,不要用山寨盗版,特别一些系统还感染了360等病毒. 解决方案二: Hi Azure的官方网站给出了我们详细的安装步骤:http://www.windowsazure.cn/zh-cn/documentation/articles/php-download-sdk/,文章中

安装Win7系统后Word文档字体变化

问题:电脑安装Win7系统后Word文档字体变了,这是怎么回事呀? 解答:为了工作的需要,笔者将Win-XP升级成了Win7,却也同时产生了一个问题,就是笔者的所有Word文档中仿宋字体都改变了.问了同事,也存在这个问题.在网上搜查,才知道原因是Win7中没有自带仿宋_GB2312字库,需要自己下载安装.按照说明,下载了仿宋_GB2312字库,放在C盘-Windowsfonts中.一切又OK了.

Ubuntu系统中安装vim与中文帮助文档

在Windows下面玩的Vim,搬到Ubuntu上面之后感觉Vi用着特别别扭(尤其是剪切板上面的东西无法paste在Vi中...)于是乎...打算把Vi改装成Vim,这样也许就会好多了.废话不多说,开始行动.其实很简单: 1:打开命令行敲击下面命令(下载安装带有剪切板功能的Vim): sudo apt-get install vim-gui-common 2:搞定了... ... ...现在再用Vi或者Vim命令编辑某个文件的话熟悉的界面又回来了.下面我们开始安装中文帮助文档.首先我们下载Vim

没有安装PowerPoint怎样播放演示文档

不少朋友在他处播放幻灯片文件时,因所用计算机上未安装PowerPoint.或缺少幻灯片中使用的字体等等,而无法放映幻灯片或放映效果不佳. PowerPoint早已为我们准备好了一个播放器,只要在幻灯片制作完成后将文件打包,使用时用播放器来播放幻灯片将完全解除上述烦恼. 以PowerPoint2003为例,幻灯片完全设置完成后,单击"文件"菜单,选择"打包成CD-"打开该对话框. 文档-powerpoint演示文稿"> 打包成CD- 在图中圈出的位置,

php文档工具PHP Documentor安装与使用方法_php技巧

本文讲述了php文档工具PHP Documentor安装与使用方法.分享给大家供大家参考,具体如下: PHP Documentor是PEAR下面的一个模块,用来生成文档.PHP Documentor扫描指定目录下面的php源代码,扫描其中的关键字,截取需要分析的注释,然后分析注释中的专用的tag,生成html文件,接着根据已经分析完的类和模块的信息,建立相应的索引,生成html文件.在review代码的时候,有点用处. 一.安装PHP Documentor 首先要先确认一下有没有安装pear库,

Python中有没有类似于JAVA的API那样的完整的查询文档

问题描述 大家好: 小弟目前在自学Python,以前有2年的JAVA开发经验.但是在自学的过程中,对于Python已提供哪些模块以及如何查看它们(包括源代码)很困惑.有达人来指点下吗? 顺便问下,Python怎么没有像JAVA那样的完整详细的API? 问题补充zwws 写道 解决方案 你在Windows里面安装完成后,有个Module Docs的连接.启动这个,然后选择open brower,就会出现一个本地服务器为你提供模块文档.如果和JavaDoc完全一样就是JavaDoc了,这是Pytho

VS2010软件中的帮助文档问题?

问题描述 在VS2010软件中可以按"F1"键弹出帮助文档.如下图片1所以的文档. 图1小子我自己通过VS软件中的"帮助"菜单,在"帮助管理设置"中选择"联机安装内容",将一些文档下载到我电脑E盘中的某个子文件夹中.在第一次下载"帮助设置文档"时,电脑默认路径是"C:ProgramFiles"路径,我将路径该为我电脑E盘中的某个子文夹.下载完成好文档后,我按"F1"键

Dreamweaver 基础 :DW的“文档”工具栏

dreamweaver "文档"工具栏 "文档"工具栏中包含按钮,这些按钮使您可以在文档的不同视图间快速切换:"代码"视图."设计"视图.同时显示"代码"和"设计"视图的拆分视图. 工具栏中还包含一些与查看文档.在本地和远程站点间传输文档有关的常用命令和选项. 以下选项出现在"文档"工具栏中: 显示代码视图仅在"文档"窗口中显示"代码&q

PPT文档复制到别人的电脑上却无法听到声音的解决方法

问题描述:我往PPT文档中插入了背景音乐后,在本机能够正常地听到声音,可同样是这个文件,复制到别人的电脑上却无法听到声音.请问这是什么原因,应该如何解决? 疑难诊断:同样一个PPT文档在本机能够听到声音而在别人的机子上听不到声音,这是因为在本地的电脑中为PPT文档添加背景音乐时,PPT会记住相关音乐文件的具体地址(如"D:\课件\背景音乐.mp3"),而在别人的电脑中却没有这个具体目录和相关背景音乐,当然也就听不到声音了. 解决的方法很简单:将某个PPT文档(如"课件.ppt