工具
这里会做一些emacs测试

以64位为例。首先安装x86_{64版的MSYS2}。安装后运行安装目录里的 msys2_shell.bat，会看到一个BASH的命令行窗口。使用命令安装所需的包：

1: pacman -S base-devel mingw-w64-x86_64-toolchain \
2:        mingw-w64-x86_64-xpm-nox\
3:        mingw-w64-x86_64-libtiff \
4:        mingw-w64-x86_64-giflib\
5:        mingw-w64-x86_64-libpng \
6:        mingw-w64-x86_64-libjpeg-turbo\
7:        mingw-w64-x86_64-librsvg \
8:        mingw-w64-x86_64-libxml2\
9:        mingw-w64-x86_64-gnutls

其中，除了前两项外其他是可选的。它们的功能分别是

• 基础：base-devel mingw-w64-x86₆₄-toolchain
• 图形库:
  • mingw-w64-x86₆₄-libtiff
  • mingw-w64-x86₆₄-giflib
  • mingw-w64-x86₆₄-libpng
  • mingw-w64-x86₆₄-libjpeg-turbo
  • mingw-w64-x86₆₄-librsvg
• 用于Libxml2： mingw-w64-x86₆₄-libxml2
• 用于GnuTLS： mingw-w64-x86₆₄-gnutls

emacs源码可以在ftp或者github上获得；

下面就是编译安装了。运行开始菜单中的mingw64_shell，注意必须是它，这会 启动一个MinGW-w64的环境。cd到源码所在的目录，运行下面的命令编译Emacs并 且安装到C:\emacs。如果是从开发版编译，第一行是必须的，否则

./autogen.sh
PKG_CONFIG_PATH=/mingw64/lib/pkgconfig ./configure --host=x86_64-w64-mingw32 \
               --target=x86_64-w64-mingw32\
               --build=x86_64-w64-mingw32\
               --with-wide-int \
               --with-jpeg\
               --with-xpm\
               --with-png\
               --with-tiff\
               --with-rsvg\
               --with-xml2 \
               --with-gnutls\
               --with-xft\
               --without-imagemagick\
               --with-modules
make
make install prefix=/c/emacs

如果成功的话C:\emacs目录里就有编译好的Emacs。因为编译时用了很多第三方 库, 所以编译的这个Emacs是需要那些DLL才能运行的。如果系统里面MSYS2已经 被添加到PATH环境变量里(例如PATH里包含了C:\msys2\mingw64\bin)了这不是问 题，但如果环境变量里没有或者想在其他电脑上用，需要用下面的命令复制所需 的DLL到Emacs所在目录：

cp /mingw64/bin/{libwinpthread-*.dll,libXpm-noX*.dll,libdbus-*.dll} /c/emacs/bin
cp /mingw64/bin/{libgomp-*.dll,libgcc_s_seh-*.dll,libglib-*.dll} /c/emacs/bin
cp /mingw64/bin/{libintl-*.dll,libiconv-*.dll,libgobject-*.dll} /c/emacs/bin
cp /mingw64/bin/{libffi-*.dll,libgdk_pixbuf-*.dll,libgio-*.dll} /c/emacs/bin
cp /mingw64/bin/{libgmodule-*.dll,zlib*.dll,librsvg-*.dll} /c/emacs/bin
cp /mingw64/bin/{libcairo-*.dll,libcroco-*.dll,libpango-*.dll} /c/emacs/bin
cp /mingw64/bin/{libpangocairo-*.dll,libxml2-*.dll,libfontconfig-*.dll} /c/emacs/bin
cp /mingw64/bin/{libfreetype-*.dll,libpixman-*.dll,libpng*.dll} /c/emacs/bin
cp /mingw64/bin/{libpangoft*.dll,libpangowin32-*.dll,liblzma-*.dll} /c/emacs/bin
cp /mingw64/bin/{libexpat-*.dll,libharfbuzz-*.dll,libgnutls-*.dll} /c/emacs/bin
cp /mingw64/bin/{libgnutlsxx-*.dll,libtiff-*.dll,libtiffxx-*.dll} /c/emacs/bin
cp /mingw64/bin/{libjpeg-*.dll,libgif-*.dll,libbz2-*.dll,libjbig-*.dll} /c/emacs/bin
cp /mingw64/bin/{libgmp-*.dll,libhogweed-*.dll,libnettle-*.dll} /c/emacs/bin
cp /mingw64/bin/{libp11-kit-*.dll,libtasn1-*.dll} /c/emacs/bin

• 按键自定义方式

  1. 定义全局按键

     (global-set-key "\M-;" 'qiang-comment-dwim-line)
     

  2. 定义模式相关的快捷键：如下定义一个快捷键，只有在org-mode中起作用

     (define-key org-mode-map (kbd "C-S-a") 'org-archive-subtree)
     

  3. 同一个按键适用于多个模式：表示只在text-mode和org-mode里打开flyspell的功能，并且绑定了C-c C-v按键，这里用到了 dolist 函数来遍历需要设置的mode

     (dolist (hook '(text-mode-hook org-mode-hook))
              (add-hook hook
                    (lambda ()
                        (flyspell-mode 1)
                        (local-set-key (kbd "C-c C-v") flyspell-goto-next-error))))
     

  4. 使用local-set-key做局部绑定，暂定；

• 定义自己的M-x指令：如下指令进行M-x gtd，可以打开相应的文件；

  (defun gtd ()
   (interactive)
   (find-file "c:/homes/charles/gtd/gtd/mygtd.org"))
  

• 表格\ref{tbl-emacs-inf}总结了平时需要的快捷键、模式、命令等操作；

  Table 1: emacs使用汇总

  模式	按键	函数	功能	备注
  	C-c a	org-agenda	进入org模式的agenda
  	C-c b	org-iswitchb	进入org模式的iswitchb
  	C-c c	org-capture	进入org模式的capture
  	C-c l	org-store-link	进入org模式的org-store-link
  	F9	emacs-maximize	窗口最大化	实际上延时后最大化
  	C-F9	emacs-normal	窗口大小还原
  	C-x 4 4	split-window-h2v2	窗口分成4份，水平2份垂直2份
  	C-x 4 3	split-window-h2v1	窗口分成3份，水平2份垂直1份
  	C-x 4 5	split-window-h1v2	窗口分成3份，水平1份垂直2份
  	M-j	split-window-rotate	窗口顺时针旋转
  	M-S-j	split-window-hv-turn	窗口逆时针旋转
  	M-g	goto-line	跳转到某行
  	C-,	scroll-left	屏幕左移命令
  	C-.	scroll-right	屏幕右移命令
  	F3	repeat-complex-command	重复上一命令
  	C-x z
  	F8	eshell	打开eshell
  	C-F8	open-eshell-other-buffer	在另一个buffer里面打开eshell
  	C-;	set-mark-command	设置标记起始位置	原来绑定在C-SPC上
  	F2	ecb-hide-ecb-windows	ecb模式窗口隐藏
  	C-F2	ecb-show-ecb-windows	ecb模式窗口显示
  	M-;	user-comment-dwim-line	代码注释
  	F7	quick-compile	编译	设置编译C
  	F10	my-transparent	设置或者取消emacs透明
  	C-c 1	org-time-stamp	org模式时间戳
  	C-c d	insert-current-date	插入当前日期
  	C-c t	insert-current-time	插入当前时间
  	C-F1	manual-entry	进入manual
  	F1	open-key-info-file	进入自定义快捷键帮助
  		byte-compile-file	编译elisp文件
  		describe-current-coding-system	显示当前buffer的编码格式
  	C-x RET f		改变当前buffer的编码格式
  	C-x {		往左加宽buffer尺寸
  	C-x }		往右加宽buffer尺寸
  	C-x ^		往上加高buffer尺寸
  目录模式	n		向下查看文件
  C-x d	p		向上查看文件
  	>		向下查看目录
  	<		向上查看目录
  	^		返回上一级目录
  	M-(		向下查看已标记
  	M-)		向上查看已标记
  	g		刷新
  	s		切换名称/日期排序方式
  	i		当前窗口下面打开该子目录
  	v		查看当前文件（当前窗口）
  	o		查看当前文件（另一窗口）
  	y		查看当前文件类型
  	等号		比较文件，相当于shell下的diff
  	m		标记（mark）
  	u		取消标记
  	U		取消所有标记
  	* /		标记所有文件夹
  	* *		标记所有可执行文件
  	* @		标记所有符号链接
  	* c		改变标记的符号
  	% m		根据正则表达式改变标记文件
  	% g		根据正则表达式改变标记文件的内容
  	d		标记为删除
  	~		标记所有备份文件为删除
  	#		将存盘文件标记为删除
  	& d		根据正则表达式标记删除
  	X		执行标记的操作
  	+		新建目录
  	C-x C-q		将文件列表设置为只读
  	D		删除文件	标记（m）后的操作
  	C		拷贝	标记（m）后的操作
  	O		改变用户	标记（m）后的操作
  	G		改变群组	标记（m）后的操作
  	S		符号链接	标记（m）后的操作
  	H		硬链接	标记（m）后的操作
  	Z		压缩	标记（m）后的操作
  	W		复制文件名	标记（m）后的操作
  	K		删除行，刷新后可恢复	标记（m）后的操作
  		revert-buffer	刷新buffer
  		emacs -q	进入emacs默认最小配置	启动emacs时使用
  		eval-current-buffer	当前配置立马生效
  		rename-buffer	重命名当前buffer

• 在eshell中使用$PATH$可以输出当前emacs的路径path；
• 查询当前模式:C-h m或者M-x describe-mode ;
• el源文件编译:对于emacs某些包，有生成的elc的编译文件，emacs启动时，调用elc启动速度会更快，但是如果修改了源文件el，则可 以使用M-x：byte-recompile-directory来重新编译，才能将修改的地方起作用。比如org mode中修改latex的生成模式函数 org-export-latex-make-header
• 右键菜单配置打开命令：在注册表\HKEY\_CLASSES\_{ROOT\AllFilesystemObjects\shell\下面新建一项Emacs}，再在下面新建command项， 看起来应该是这样：\HKEY\_CLASSES\_{ROOT\AllFilesystemObjects\shell\Emacs\command}\ 然后把command项右边的默认值设为 Path\gnuclientw.exe，并加上“%1”
• emacs配置立马生效: 可以M-x eval-current-buffer立马生效;
• 查看emacs占用资源：M-x profiler-start 然后选cpu+mem然后执行 profiler-report；

• 计算器模式1：M-x calc进入，输入“10”回车“d2，这个d2会把窗口中的所有数字显示为二进制形式，所有的数字都会以”2#“开头,以表 示它们是二进制形式。如果要重新用十进制显示，则输入”d0“即可，同样，也可以用”d8“”，“d6”来显示八进制和十六进制的格式。如 果要进行进制转换，比如讲二进制的1010转换为十六进制，可以这样先d6设定16进制模式，然后再minibuffer中输入2#1010，回车；
• 计算器模式2：M-x quick-calc进入，启动后会在minibuffer里提示输入数学计算式，回车就显示结果；

• 导入图片见图\ref{img-pic-test}:可以通过调节width=.1\ linewidth来限制图片输出的大小, 其中.1表示倍率，或者使用scale=0.2 进行调节

  

  Figure 1: emacs导图测试

• eshell 查看系统字体:eshell:fc-list(或者fc-list.exe) (空格) :lang=zh-cn

• 设置编码格式:使用快捷键：C-x RET f 然后可以用 TAB 显示所有存在的编码。这个命令会改变文件！如果只是出现乱码，并且不想改 变文件本身，可以用命令C-x RET r ( M-x revert-buffer-with-coding-system)来用指定的编码重新读入这个文件。不改变当前文件 编码，但将该文件另存为utf-8编码格式：C-x RET c(M-x universal-coding-system-argument ) utf-8
• 对于org-mode导出HTML时，如果org-mode是gbk/utf-8，则导出的HTML也是gbk/utf-8；

使用M-x shell-command然后输入win下程序，可以调用执行之。也可以绑定到 按键上。

• list： 要得到一个list，可以使用下面的方式，第3种方式如果不加单引号，elisp将 会把1当成函数把2和3当成参数，结果就会报错。
  1. (list 1 2 3)：产生一个list对象，且每次产生的都是新的对象
  2. (quote (1 2 3))：产生一个list对象，但每次产生的对象可能都是指向同 一个
  3. ’(1 2 3)：相同quote方式。
• 全局变量
  • defvar:定义全局变量
• 局部变量
  • let：定义局部变量
• 作用域(scope)
• 生存期(extent)

elisp中符号(symbol)是一个Lisp对象，它是一个数据结构，由以下4个部分组成，

• name：symbol的名字
• value cell：作为一个动态变量，symbol的值
• function cell：作为一个函数，它的函数值
• property list：属性列表

symbol的标识符直接在Lisp代码中出现，会被读取为一个符号（symbol）， 然 后在不同的上下文中 ，Lisp求值器会看情况取出value cell或者function cell 的内容， 作为该符号（symbol）的值（value）。如果某一个函数接受符号 （symbol）而不是它的值（value）作为参数，我们就得引用（quote）它， 即， 我们使用引用，可以创建一个符号（symbol）字面量（literal）。symbol-name 函数可以用来获取符号（symbol）x的name，

(symbol-name 'x)

形如(+ 1 2)叫表达式，从左到右位于第一个位置的元素，表示

• 一个函数：其参数必需要先求值完毕
• 一个宏：其参数有自己的对参数的求值策略
• 一个内置的特殊命令：其参数有自己的对参数的求值策略

其他位置的元素称为参数；

• interactive: 该特殊表表示该函数可以做交互，且定义函数参数类型。
  • 星号*：表示如果有错误，就产生一个错误消息；
  • p：表示传送给函数的参数的是一个处理过的前缀参量的值，前缀参量用 C-u值的形式传递
  • cxx: 指交互表达式希望产生一个提示xx并且后续的参数将是一个字符
  • r：使emacs将位点所在区域的开始值和结束值作为函数的两个参数；
  • Bxx：告诉emacs用缓冲区的名字作为函数的参数,并用xx作为提示

• concat：将字符串连接，如下

  (concat "gcc" "-W -o")
  

• file-name-sans-extension: 获得文件名，除了后缀名；
• buffer-file-name: 获得文件名，带后缀名；
• current-buffer: 当前buffer名；
• progn: 该函数使其每个参数表达式被逐一求值，并返回最后1个表达式的值
• p: 末尾带p(predicate)的函数一般都是判断函数，返回true或false;

• 获取buffer文件名: 行1带有后缀名，行2不带后缀名；

  1: (buffer-file-name (current-buffer))
  2: (file-name-sans-extension (buffer-file-name (current-buffer)))
  

• 初始可视化：在org文档的开始，加上#+startup: overview, 其中overview可以是 如下选项
  1. overview：只显示第一级标题；
  2. content：显示所有标题；
  3. showall：显示所有标题和正文；
  4. showeverything：显示所有标题和正文, 雷同showall；

使用抽屉drawer，在导出时，drawer里面的文字不会被到导出, 可以在里面放入一些 注解, 可以使用命令’org-insert-property-drawer’

抽屉内部

代码块可以设置#+startup: hideblocks, 做初始化折叠或打开。可以有如下选项

1. hideblocks：隐藏代码块；
2. nohideblocks：显示代码块；

脚注注解可以放在任何正文位置，脚注形式有；

• 脚注一, 普通序号脚注¹;
• 脚注二，带名字脚注²;
• 脚注三, 匿名脚注³;
• 脚注四，带描述的脚注⁴;

• 无序号：无序号符号可以是’-’和’+’和’*’；
• 有序号：可以是’1.’和’1)’;
• 对序号的描述；

试试 粗体 ，试试 斜体 , 试试删除线 删除线 ，试试 下划线, 试试下标 H₂O 试试上标 E=mc² ，等宽字体 git, code

1. 公式：在本行，\(a^2+b^2=c^2\)
2. 公式：在本行，\(a^2 + b^2 = c^2\)
3. 公式：单独成行。\[a^2 + b^2 = c^2\]
4. 公式：单独成行。\[a^2 + b^2 = c^2\]
5. 公式：在本行，\(\sqrt{2}\)
6. 和公式：\[a=\sum_{i=0}^{n}a_{i}\]
7. 分数公式：\[\frac{x}{y}\]
8. 输入equ，然后按tab也可以进入begin end模式，编辑公式，可以有标号，可以设 置label标签引用。

• ditaa测试：如果要支持中文，org文档需为utf-8的格式，这是java调用ditaa.jar 时的默认格式, 效果如图\ref{img-test}所示

  

• gnuplot，见图\ref{img-gnuplot-test}所示：

  

  引用表格画图：表格见表\ref{tbl-data-plot}所示。

  independent var	first dependent var	second dependent var
  0.1	0.425	0.375
  0.2	0.3125	0.3375
  0.3	0.24999993	0.28333338
  0.4	0.275	0.28125
  0.5	0.26	0.27
  0.6	0.25833338	0.24999993
  0.7	0.24642845	0.23928553
  0.8	0.23125	0.2375
  0.9	0.23333323	0.2333332
  1	0.2225	0.22
  1.1	0.20909075	0.22272708
  1.2	0.19999998	0.21458333
  1.3	0.19615368	0.21730748
  1.4	0.18571433	0.21071435
  1.5	0.19000008	0.2150001
  1.6	0.1828125	0.2046875
  1.7	0.18088253	0.1985296
  1.8	0.17916675	0.18888898
  1.9	0.19342103	0.21315783
  2	0.19	0.21625
  2.1	0.18214268	0.20714265
  2.2	0.17727275	0.2022727
  2.3	0.1739131	0.1989131
  2.4	0.16770833	0.1916667
  2.5	0.164	0.188
  2.6	0.15769238	0.18076923
  2.7	0.1592591	0.1888887
  2.8	0.1598214	0.18928565
  2.9	0.15603453	0.1844828

  

• 链接之间跳转：C-c C-x n和C-c C-x p
• 内部链接：只需要在某个需要链接到的地方使用# ，设置一个标点，再 在使用的地方，使用像[[][]]这样的格式去定位标点，并给出描述符，或者直接使 用快捷键C-c C-l添加该点，比如已经在org-mode标题处设置了标点，然后使用 [[][]]定位过去就是 1.4, 并且可以使用C-c &返回来, 使用C-c C-o可以打开 标点。
• 辐射链接：使用3个尖括号括起的锚点，可以将文档中所有的锚点链接起来，比如 buffer ;
• 外部链接：包括链接到文件、网址、email等
• 包含：可以在头部使用#+include:“path/file”包含某个文件，比如org，然后就可 以将所有的org文件包含到一个文件里面统一导出；后面添加一定的开关可以导入特 定的数据，比如添加 src c ，可以导入c代码；使用 lines 关键字可以导入文 件的某几行

gtd状态之间转换可以使用快捷键C-c C-t;

• 工作流状态: 对于一个工作流可以使用 sequence 的工作流设置状态如, 其中竖 线用于分割，一边是用于需要动作的，一边只是记录不需要动作。颜色也有不同， 如果没有竖线，最后一个状态将代表DONE状态

  (setq org-todo-keywords '((sequence "TODO" "VERIFY" "|" "DONE")))
  

• 工作类型: 使用 type 设置工作类型如

  (setq org-todo-keywords '((type "Fred" "Sara" "Lucy" "|" "DONE")))
  

• 文件个性化状态：针对每个org文件设置状态切换关键字，在org头设置如下, 行 (all-todo)可以定义两种关键字，行(seq-todo)可以定义工作流状态，行 (type-todo)可以定义工作类型。

  1: #+TODO: TODO FEEDBACK VERIFY | DONE CANCELED (ref: all-todo)
  2: #+SEQ_TODO: TODO FEEDBACK VERIFY | DONE CANCELED (ref: seq-todo)
  3: #+TYP_TODO: Fred Sara Lucy Mike | DONE            (ref: type-todo)
  

• 状态样式：各种状态可以设置不同的颜色，字体等如

  (setq org-todo-keyword-faces
        '(("TODO" . org-warning) ("STARTED" . "yellow")
         ("CANCELED" . (:foreground "blue" :weight bold))))
  

一般使用一个空行表示换行，也可以使用latex的斜杠par，如果需要在某个行强行折 行，可以使用两个斜杠。如果想写类似诗句一样的格式可以使用如下方式

Great clouds overhead
Tiny black birds rise and fall
Snow covers Emacs

         – AlexSchroeder

1. verse: 见换行一节的用法

2. quote：如果从别的文章中引用一段话，通常需要将这些语句左右都流出一定空间， 如下面所示

   Everything should be made as simple as possible, but not any simpler – Albert Einstein

3. center: 如果需要将某些文字中心对齐，可以使用如下方式

   Everything should be made as simple as possible,
   but not any simpler

4. example: 里面的文字不会被解析，原样导出

   Some example from a text_file.
   

   也可以在首行使用冒号加一个空格后面添加文字作为一个简化方式，如

   Some example from a text_file.
   
   

5. src: 可以放入一些代码, 使用-n或者+n会对代码标记行号, 其中-n会使代码行号 重新计数，+n从上一个代码片段累计计数，使用-r表示可以引用行号，只需要在某 行末尾使用（ref：name），在引用的地方使用C-c C-l 输入连接（name）就可引 用了。使用-i可以对某些代码做合理缩进

   1: (save-excursion
   2:    (goto-char (point-min)))
   

   In line 1 we remember the current position. Line 2 jumps to point-min.

可以在org中定义宏，类似c的宏，然后可以在段落、标题、引用块、表格、列表中使 用。系统内建的宏有

1. title：org文档的标题；
2. author：org文档的作者；
3. email：邮件地址；
4. date：日期戳，还可以定义时间戳的格式，参考宏帮助文档；
5. time: 时间戳，同date；
6. modification-time：date和time的叠加；
7. input-file：This macro refers to the filename of the exported file；
8. property：属性，暂未知；
9. select\_tags: 如果在节标题中做了tag标注，可以使用这个来选择性的导出某些 节。
10. exclude\_tags: 和select\_tags相反；

可以使用快捷键C-c ; 将某个小节注释掉，导出时不会出现在导出文档中。 ‘#+BEGIN\_COMMENT’ … ‘#+END\_COMMENT’好像不起作用；

• org-mode转换到pdf需要在org-mode文件中头部使用如下头;

  #+ title: 我的记事本
  #+ author: lxc
  #+ latex_class: org-latex-pdf
  #+ latex: \newpage
  

• 中文首行缩进2格：可以在上一自然段末尾使用斜线加par或者在两个自然段直接空两行。
• 换最新版本orgmode，可以将标题首页和目录分开；
• 由于org文档转换为latex文本时，中间需要软件iconv将之转换为utf-8格式，而org 源文档是gbk格式，所以如果将org文档由gbk格式转换为了别的格式，比如utf-8， 则需要修改iconv的转换命令，详细见org个配置文档“my-org-mode.el”

• 如果需要修改org文档中嵌入的代码宽度高度，可以修改“my-org-mode.el”中的如下 代码“页边距”

  \lstset{numbers=left, %设置行号位置
    numberstyle=\\tiny, %设置行号大小
                  keywordstyle=\\color{blue}, %设置关键字颜色
                  commentstyle=\\color[cmyk]{1,0,1,0}, %设置注释颜色
          frame=single, %设置边框格式
          escapeinside=``, %逃逸字符(1左面的键)，用于显示中文
          breaklines, %自动折行
          extendedchars=false, %解决代码跨页时,章节标题，页眉汉字不显示
          xleftmargin=10em,xrightmargin=5em, aboveskip=0.5em, %设置页边距
          tabsize=4, %设置tab空格数
          showspaces=false} %不显示空格
  

• 大纲级别:若需导出更深入的大纲级别,可设置 org-export-headline-levels 或者在文件头使用

  #+options: h:4
  

• 目录：

  1. 可以设置目录的生成级别或者不导出目录，可设置 org-export-with-toc 或者在每个文件中使用

     #+OPTIONS: toc:2          only inlcude two levels in TOC
     #+OPTIONS: toc:nil        no default TOC at all
     

  2. 可以设置目录导出成list或者table

     #+TOC: listings           build a list of images
     #+TOC: tables             build a list of tables
     

可以使用cdlatex完成输入latex的各种模块。使用快捷键C-c {可以输入equation等的 模块。

除了官方教程，这里有一篇不错的应用笔记。

• 使用M-x git-config-init 配置用户名和email；
• 如果github使用https方式，则在环境变量中设置HOME变量，值是某目录；
• 在该目录下新建文件_netrc；

• 在_{netrc中写入}

  machine github.com
  login bitman@163.com
  password github的登录密码
  

• 进入eshell使用命令设置远端仓库的别名；

  git remote add learn https://github.com/bitsman/bitsman.github.io.git 
  

• 然后就可以使用git bash进行免输入密码push；

1. 进入git仓库，或者打开仓库里面的文件；
2. 按F1；
3. 使用p/n等进行上下移动，选中修改过的文件使用a键添加进仓库；
4. 使用c键进行commit；
5. 在跳出的buffer中写入日志；
6. 使用C-c C-c进行commit；
7. 使用点.键调出git bash，输入push learn master推送到远端；

• c文件

   1: #include "emacs-module.h"//头文件从源码src文件夹下获得
   2: 
   3: /* Declare mandatory GPL symbol.  */
   4: int plugin_is_GPL_compatible;
   5: 
   6: /* New emacs lisp function. All function exposed to Emacs must have this prototype. */
   7: static emacs_value
   8: Fmymod_test (emacs_env *env, int nargs, emacs_value args[], void *data)
   9: {
  10:     return env->make_integer (env, 43);
  11: }
  12: 
  13: /* Bind NAME to FUN.  */
  14: static void
  15: bind_function (emacs_env *env, const char *name, emacs_value Sfun)
  16: {
  17:     /* Set the function cell of the symbol named NAME to SFUN using
  18:        the 'fset' function.  */
  19: 
  20:     /* Convert the strings to symbols by interning them */
  21:     emacs_value Qfset = env->intern (env, "fset");
  22:     emacs_value Qsym = env->intern (env, name);
  23: 
  24:     /* Prepare the arguments array */
  25:     emacs_value args[] = { Qsym, Sfun };
  26: 
  27:     /* Make the call (2 == nb of arguments) */
  28:     env->funcall (env, Qfset, 2, args);
  29: }
  30: 
  31: /* Provide FEATURE to Emacs.  */
  32: static void
  33: provide (emacs_env *env, const char *feature)
  34: {
  35:     /* call 'provide' with FEATURE converted to a symbol */
  36: 
  37:     emacs_value Qfeat = env->intern (env, feature);
  38:     emacs_value Qprovide = env->intern (env, "provide");
  39:     emacs_value args[] = { Qfeat };
  40: 
  41:     env->funcall (env, Qprovide, 1, args);
  42: }
  43: 
  44: int
  45: emacs_module_init (struct emacs_runtime *ert)
  46: {
  47:     emacs_env *env = ert->get_environment (ert);
  48: 
  49:     /* create a lambda (returns an emacs_value) */
  50:     emacs_value fun = env->make_function (env,
  51:                       0,      /* min. number of arguments */
  52:                       0,      /* max. number of arguments */
  53:                       Fmymod_test,/* actual function pointer */
  54:                       "doc",      /* docstring */
  55:                       NULL /* user pointer of your choice (data param in Fmymod_test) */
  56:                       );
  57: 
  58:     bind_function (env, "mymod-test", fun);
  59:     provide (env, "mymod");
  60: 
  61:     /* loaded successfully */
  62:     return 0;
  63: }
  

• Makefile

  # path to the emacs source dir
  # (you can provide it here or on the command line)
  # ROOT    = e:/emacs-26.1
  CC      = gcc
  LD      = gcc
  CFLAGS  = -ggdb3 -Wall
  LDFLAGS =
  
  all: mymod.dll
  
  # make shared library out of the object file
  %.dll: %.o
          $(LD) -shared $(LDFLAGS) -o $@ $<
  
  # compile source file to object file
  %.o: %.c
          $(CC) $(CFLAGS) -fPIC -c $<
          # $(CC) $(CFLAGS) -I$(ROOT)/src -fPIC -c $<
  

• run:经过make编译后，生成mymod.dll，然后再草稿buffer中使用如下方式就 能打印出结果。

  (add-to-list 'load-path "path/to/dll")
  (require 'mymod)
  (mymod-test)
  

• c文件

   1: #include "emacs-module.h"
   2: int plugin_is_GPL_compatible;
   3: /* Provide FEATURE to Emacs.  */
   4: static void
   5: provide (emacs_env *env, const char *feature)
   6: {
   7:     /* call 'provide' with FEATURE converted to a symbol */
   8: 
   9:     emacs_value Qfeat = env->intern (env, feature);
  10:     emacs_value Qprovide = env->intern (env, "provide");
  11:     emacs_value args[] = { Qfeat };
  12: 
  13:     env->funcall (env, Qprovide, 1, args);
  14: }
  15: 
  16: int
  17: emacs_module_init(struct emacs_runtime *ert)
  18: {
  19:     emacs_env *env = ert->get_environment(ert);
  20:     emacs_value message = env->intern(env, "message");
  21:     const char hi[] = "Hello, cruel world!";
  22:     emacs_value string = env->make_string(env, hi, sizeof(hi) - 1);
  23:     env->funcall(env, message, 1, &string);
  24:     provide (env, "emtest");
  25: 
  26:     return 0;
  27: }
  28: 
  

• Makefile

  # path to the emacs source dir
  # (you can provide it here or on the command line)
  # ROOT    = e:/emacs-26.1
  CC      = gcc
  LD      = gcc
  CFLAGS  = -ggdb3 -Wall
  LDFLAGS =
  
  all: emtest.dll
  
  # make shared library out of the object file
  %.dll: %.o
          $(LD) -shared $(LDFLAGS) -o $@ $<
  
  # compile source file to object file
  %.o: %.c
          $(CC) $(CFLAGS) -fPIC -c $<
          # $(CC) $(CFLAGS) -I$(ROOT)/src -fPIC -c $<
  

• run:经过make编译后，生成emtest.dll，然后再草稿buffer中使用如下方式就 能打印出结果。

  (add-to-list 'load-path "path/to/dll")
  (require 'emtest)
  

可以在前面加上\ not来得到其否定形式。

1. \(\int_{0}^{n}\)
2. \(\sum_{i=0}^{n}\)
3. \(\sum\limits_{i=0}^{n}\)
4. \(\mathrm{d}x\)

系统中创建git用户。

adduser git 
passwd git

• 切换到git用户：

  su – git
  

• 创建文件夹bin

  mkdir /home/git/bin
  

• 从github克隆gitolite的源码

  git clone https://github.com/sitaramc/gitolite.git
  

• 安装gitolite

  ./gitolite/install -to /home/git/bin/
  

至此gitolite的安装安装，可以查看bin目录里的内容。

• 管理员公玥复制到服务器:密钥产生方式查询网络

  cp id_rsa.pub /tmp/admin.pub
  

• 在服务器切换回git用户，为gitolite配置管理员

  /home/git/bin/gitolite setup -pk /tmp/admin.pub 
  

• 修改sshd配置文件(/etc/ssh/sshd_config)，找到以下内容，并去掉注释 符“#”，其中authorized_{keys文件是gitolite管理所有git用户公玥的文件}， 里面包含了刚刚设置的gitolite管理员账户公玥。

  RSAAuthentication yes
  PubkeyAuthentication yes
  AuthorizedKeysFile  /home/git/.ssh/authorized_keys
  

• 重启ssh服务

  service sshd restart
  

出于安全的考虑，我们最好限制用户只能进行git push/pull，但无法登陆。这 可以使用git-shell来完成(好像这一节不起作用)

• 查看一下git-shell的位置

  which git-shell
  

• 将git-shell的路径添加到 /etc/shells文件中

• 修改git用户的shell：

  sudo chsh git
  

管理员在本机克隆Gitolite管理库

git clone git@yourServerIP:gitolite-admin.git

可以看到在管理库gitolite-admin里，有两个目录， conf/和keydir/，其中 conf/下面有个名为gitolite.conf的配置文件。

• conf/gitolite.conf 用于Git项目配置，访问权限设置。
• keydir/ 用于存储用户的SSH public key(公钥）。

• C：代表创建，仅在通配符版本库授权时使用，用于指定谁可以创建与通配符 匹配的版本库
• R：R为只读
• RW：RW为读写权限
• RW+：RW+代表除了拥有读写权限，还可以强制执行推送，强制更新，创建和删 除引用
• RWC：RW+C
• RWD：RW+D，D代表允许删除和正则匹配的引用
• RWCD：RW+CD

传统模式的引用授权：指的是在授权指令中只采用R、RW和RW+的传统授权关键字， 而不包括扩展授权指令。传统的授权指令没有把分支的创建和分支删除权限细分， 而是和写操作及强制推送操作混杂在一起。

1  @administrators = jiangxin admin
2  @dev                  = dev1 dev2 badboy
3  @test                  = test1 test2
4
5  repo    test/repo1
6          RW+           = @administrators
7          RW master refs/heads/feature/ = @dev
8          R                 = @test

• 第6行:对于版本库test/repo1，管理员组用户jiangxin和admin可以读写任意 分支、强制推送，以及创建和删除引用。
• 第7行:用户组@dev除了对master和refs/heads/feature/开头的引用具有读写 权限外，实际上可以读取所有引用。这是因为读取操作授权阶段无法获知引用。
• 第8行:用户组@test对版本库拥有只读授权。

扩展模式的引用授权，指的是该版本库的授权指令出现了下列授权关键字中的一 个或多个：RWC、RWD、RWCD、RW+C、RW+D、RW+CD，将分支的创建权限和删除权 限从读写权限中分离出来，从而可对分支进行更为精细的权限控制。

• 非快进式推送必须拥有上述关键字中的+方可授权。
• 创建引用必须拥有上述关键字中的C方可授权。
• 删除引用必须拥有上述关键字中的D方可授权。

即引用的创建和删除使用了单独的授权关键字，和写权限和强制推送权限分开。

1   repo    test/repo2
2           RW+C = @administrators
3           RW+   = @dev
4           RW      = @test
5
6   repo    test/repo3
7           RW+CD  = @administrators
8           RW+C    = @dev
9           RW         = @test

库test/repo2.git具有如下的授权：

• 第2行:用户组@administrators中的用户，具有创建和删除引用的权限，并且 能强制推送。其中创建引用来自授权关键字中的C，删除引用来自授权关键中 的+，因为该版本库授权指令中没有出现D，因而删除应用授权沿用传统授权关 键字。
• 第3行，用户组@dev中的用户，不能创建引用，但可以删除引用，并且可以强 制推送。因为第2行授权关键字中字符C的出现，使得创建引用采用扩展授权关 键字，因而用户组@dev不具有创建引用的权限。
• 第4行，用户组@test中的用户，拥有读写权限，但是不能创建引用，不能删除 引用，也不能强制推送。

库test/repo3.git具有如下的授权：

• 第7行，用户组@administrators中的用户，具有创建和删除引用的权限，并且 能强制推送。其中创建引用来自授权关键字中的C，删除引用来自授权关键中 的D。
• 第8行，用户组@dev中的用户，可以创建引用，并能够强制推送，但不能删除 引用。因为第7行授权关键字中字符C和D的出现，使得创建和删除引用都采用 扩展授权关键字，因而用户组@dev不具有删除引用的权限。
• 第9行，用户组@test中的用户，可以推送到任何引用，但是不能创建引用，不 能删除引用，也不能强制推送。

对路径的写授权, 在授权文件中，如果一个版本库的授权指令中的正则引用字段 出现了以“NAME/”开头的引用，则表明该授权指令是针对路径进行的写授权，并 且该版本库要进行基于路径的写授权判断。

1  repo foo
2      RW                 =   @junior_devs @senior_devs
3
4      RW  NAME/          =   @senior_devs
5      -   NAME/Makefile  =   @junior_devs
6      RW  NAME/          =   @junior_devs

• 第2行，初级程序员@junior_{devs和高级程序员}@senior_{devs可以对版本库foo} 进行读写操作。
• 第4行，设定高级程序员@senior_{devs对所有文件}（NAME/）进行写操作。
• 第5行和第6行，设定初级程序员@junior_{devs对除了根目录的Makefile文件外} 的其他文件具有写权限。

利用ssh可以查询自己的账户有哪些库和权限

ssh git@ip help                 # 查询该账户可以运行哪些命令
ssh git@ip info                 # 查询该账户有哪些库和权限

分两步操作。

• 服务器修改库名：使用账号登入gitolite服务器，mv A.git B.git,修改库名。
• 配置文件修改库名：编辑gitolite-admin/conf/gitolite.conf里面的A为B， 并提交服务器。

分两步操作。

• 配置文件删除库：删除gitolite-admin/conf/gitolite.conf里面的库，并提 交gitolite服务器；
• 服务器删除库：使用账号进入gitolite服务器，删除对应的git库

版本库.git目录，见表4所示。

• index: 实际上是一个包含文件索引的目录树，记录了文件名和时间戳、文件 长度等文件状态信息，但是没有存储文件内容；
• objects: blob对象的hash ID的前两位做目录名，剩余的38位做文件名
• refs:保存引用的命名空间

git配置文件一共分为3级，一级是系统级，一级是全局，一级是项目级，其关系 见表6所示。

git stage -s结果解析，两个M还可以叠加，见表7所示。

git可以使用diff命令比较多个空间的文件状态。

• git blame file：会对文件逐行显示，在每行的行首显示此行最早是在那个 commit ID引入，由谁引入。

git branch -v：查看当前分支，即查看HEAD当前指向(master或其他分支)

git暂存通常用户暂时保存当前工作环境，处理好冲突等事务后，再恢复环境继 续当前事务。

标签即tag，也叫里程碑，是对当前工程的一种状态命名。

pull操作=fetch操作+merge操作

获取操作即fetch操作, 只更新到.git/refs/remotes/origin/master

git pull时遇到冲突时，需要分步解决冲突

• 拉取：git fetch：拉取远程分支到refs/remotes/origin/master
• 合并：git merge origin/master:合并远程分支到本地head分支(heads/master)
• 解决冲突：
  • 自动解决冲突
  • 手动解决冲突：需要手动编辑文件或重命名文件

合并操作即merge操作，通常需要做冲突处理。

一般都是将其他分支合并到master分支，变基操作是将master分支拉到其他分支， 将其他分支变成master分支；

说明：

• 变基操作可能遇到冲突，需要合并操作；

git可以采用二分法查找某个commit是否引入bug，二分查找还支持run子命令自 动行自动化测例；

• git bisect start: 二分查找开始
• git bisect bad ID1: 将commit ID1标记为有bug的状态
• git bisect good ID2: 将commit ID2标记为无bug状态，git自动更新到ID1到 ID2中间位置的一个commit，继续测试并标记bad或者good，最终找到bug初始 出现位置;
• git bisect reset: 撤销二分查找在库中遗留的临时文件，恢复查找前的状态；

• 基于最新提交建立归档文件: git archive -o latest.zip HEAD
• 只将目录src和doc建立归档: git archive -o latest.tar HEAD src doc
• 基于里程碑mytagname归档，且在归档中的文件添加目录前缀: git archive -o latest.zip –prefix=bitman/ mytagname

所有的子模块可以独立建立git，以及独立的权限控制。

• 子模块建库：像普通git一样的建库，上传文件；
• 父项目建库：
  • 像普通git一样的建库；
  • 添加子模块：git submodule add <url> <local path> 添加子模块，并生 成.gitmodules
  • 子模块初始化：git submodule init, 将.gitmodules子模块初始化 入.git/config中。
  • 子模块更新：git submodule update, 将子模块git库的.git文件夹更新到 父项目.git/modules中, 同时拉取子模块文件
  • 子模块上传：和普通文件/文件夹一样的上传子模块，尤其需要上 传.gitmodules文件
  • 其他操作和“父项目克隆”操作一致
• 父项目克隆：
  • 克隆的项目库只包含.gitmodules文件记录了子模块信息，子模块具体文件 暂未实际拉取。
  • 子模块初始化：git submodule init, 将.gitmodules子模块初始化 入.git/config中。
  • 子模块更新：git submodule update, 将子模块git库的.git文件夹更新到 父项目.git/modules中, 同时拉取子模块文件
  • 子模块拉取：
    1. 所有子模块拉取：git submodule foreach git pull
    2. 单个子模块拉取：进入对应子模块目录，git pull