FILP00 踩坑指南

December 1, 2019

Poster

注意事项

不能在数学环境和文件路径以外的地方出现未转义的下划线 _
不能使用 table, figure等浮动体

表格参考格式

\begin{center}
    \begin{tabular}
        ...
    \end{tabular}
\end{center}

图片参考格式

\begin{center}
    \includegraphic[width=.3\linewidth]{...}
    \includegraphic[width=.3\linewidth]{...}%并排摆放
\end{center}

可以使用\vspace{.3cm}来调整上下间距，使得海报更整齐美观
在复制粘贴代码的时候，注意大括号的配对。

git latexdiff

使用方法

可以在文档所在的目录下使用 git latexdiff HEAD~ --main xxx.tex 来生成当前commit与上一次commit的对比。
- ~如果后面跟数字N，表示与N次以前的commit对比
- HEAD~1与HEAD~作用相同
更多操作可以参考http://www.deanbodenham.com/learn/git-and-latexdiff.html
生成的文件会保存在%temp%/git-latexdiff.xxx/这个文件夹里，其中xxx是一个随机的数字。

git latexdiff生成的文档不能正常显示gitinfo的问题

方法1：
- 原理：gitinfo提供了local模式，可以从当前目录读取git信息
- 将文件/.git/GitHeadInfo.gin复制到tex文件的同一目录下，并改名为GitHeadLocal.gin
- 在前言区找到\usepackage{gitinfo2}, 改为\usepackage[local]{gitinfo2}
- commit一次
- **注意：**这么做会导致需要每次手动复制才能为文档更新git信息。
方法2
- 将git latexdiff的生成目录指定到仓库里面，这样它就能读到git信息了
- 在运行git latexdiff时，加上参数--tmpdirprefix ./
- 拿到diff文档之后记得把生成的目录删掉，不然不小心commit到仓库里就麻烦了
1. 两种方法均测试通过。

git latexdiff 一直报错

下面是几个可能有效的解决方案：
- 在运行git latexdiff时加上参数 --pdf-viewer CMD
- 新建一个仓库，把所有报告文件添加进去并重新commit(当然，为了对比要修改一下然后再commit一次)
- 重启电脑

slides

注意事项

不支持minipage环境
暂时没有找到插入除eps之外其它格式图片的方法
- 可以使用命令pdf2ps input.pdf output.eps转换eps
需要使用dvi->ps->pdf这样的顺序生成
- 具体来说，是latex→dvips→ps2pdf
- latexmk也可以,效果相同
- pdflatex和xelatex都不行

双栏排版可以使用以下格式

\twocolumn[
    lfrheight=0.5\slideheight, 
    rfrheight=0.2\slideheight, 
    lineheight=0.5\slideheight,
    lineprop={linestype=dotted,
    lfrprop={}
    rfrprop={}
    topsep=0.1cm]
]
{
    %colum1%
}
{
    %colum2%
}

其中

参数	说明
`lfrheight=0.5\slideheight`	以指定高度创建包裹左栏的框。去掉则不会创建这个框。
`rfrheight=0.2\slideheight`	创建包裹右栏的框，其它同上
`lineheight=0.5\slideheight`	创建两栏中间的分隔线
`lineprop={linestype=dotted, linewidth=3pt}`	控制分隔线格式
`lfrprop={}`	控制左框格式，具体格式同上
`rfrprop={}`	控制右框格式，具体格式同上
`topsep=0.1cm`	上间距

下图展示了\twocolumn的一些参数。
更多控制参数可参考powerdot文档的第6节。
注：\twocolumn内部并不会自动居中对齐。可以使用\centering, \vspace{.3\slideheight}等命令手动居中。
如果只是简单的想把两张图片并排放，可以使用

\begin{center}
    \includegraphics[width=.4\linewidth]{...}
    \quad
    \includegraphics[width=.4\linewidth]{...}
\end{center}

GitInfo配置详解

gitinfo是什么

gitinfo是latex的一个宏包。目前我们使用的是它的第二版，叫做 gitinfo2

当latex文件被置于某个git仓库内时，gitinfo可以为latex提供一系列变量，调用它们可以得到上次git提交的提交者用户名、提交时间等信息。

查阅gitinfo的官方文档可以得到详细的资料。

查阅某个tex宏包文档的方法：

在终端中键入命令texdoc <packagename>

比如要查gitinfo2的文档，我们敲texdoc gitinfo2就好了

gitinfo如何工作

那么有聪明的同学可能就要问了，gitinfo是怎么从git数据库抓取信息的呢，它不是latex的宏包吗？

答案是这样的：

gitinfo利用了git hook，来在每次git commit时拿到提交信息。

那么git hook又是什么？

git hook是git在每次commit（checkout/merge）之前都需要去运行的一个脚本。
编写git hook可以实现很多有趣的功能，比如每次commit之后让机器人在群里发一条消息，或者提交一条特定的commit之后执行删库跑路操作（好孩子不要学）

gitinfo的工作流程：

通过外置的hook脚本，在每次commit(merge/checkout)时生成~/.git/gitHeadInfo.gin文件
每次编译latex文件时，在~/.git/目录下检查有无gitHeadInfo.gin，有则读取git信息，无则返回None。

如何配置gitinfo

gitinfo在它的安装文件夹内提供了3个git hook脚本，分别叫

post-checkout
post-commit
post-merge

这个文件夹在类似于C:/texlive/2019/texmf-dist/doc/latex/gitinfo2的地方

把它们放在你仓库目录下的./.git/hooks文件夹内，在下一次commit(merge/checkout)操作时，它们就会生成gitinfo2需要读取的文件gitHeadInfo.gin。

之后再去编译latex文件，gitinfo就可以正常显示了。

找不到gitinfo安装文件夹的话，这三个文件在模板仓库中也有提供。

位于templatex-master\templatex\gitinfo\内
另外，配置方法在模板仓库的Readme中也有说明。

latex编写环境推荐

推荐使用VSCode编写
工具链的配置可以参考这篇文章：https://zhuanlan.zhihu.com/p/38178015
另外推荐几个vscode上的latex插件，在左边栏插件搜索名字就能搜到：
- LaTex Utilities
  - 支持直接复制图片、表格到latex里，会自动保存图片并插入模板，以及对表格数据格式化
  - 更多方便的Snippets
  - 预览Tikz
  - 字数统计
- latex-formatter
  - 格式化tex代码，让心情更舒畅

git工具推荐

同样推荐使用vscode管理git仓库
- 左下角可以切换分支
- 左侧边栏第三个按钮进去可以commit, push, sync, merge等各种操作
其它扩展：
- GitLens:
  - 直接在代码中显示修改记录
  - 查看文件历史、行历史
  - 管理分支等
- Git Graph
  - 查看分支图
与SmartGit等专业Git客户端的区别：
- SmartGit功能更完善，并且能同时管理多个仓库，但不如集成在VSCode中的工具方便；
- 集成在VSCode中的git工具在管理单个仓库时很方便，但管理多个仓库时略显不便。

Leave your thought here

Your email address will not be published. Required fields are marked *