Skip to content

Latex

latex 之前确实没有听说过,为什么会去了解这个东西呢,这得从遇到的问题说起

背景

团队刚组建,开始做文档规划,负责这个的小伙伴选择了word。我word搞得不6,总是达不到要求, 于是我就问了一个问题,为什么不选择markdown。

当然,我其实是在问自己,如果让我来做,我会怎么选。word,markdown还是什么其他的?这个时候 突然想起来,riscv指令集手册好像是一个生成出来的玩意,那是用啥写的?这才引出了Latex。

Latex的应用场景

错略看了一下,latex是一个排版工具,写法呢也有一些标记的部分,但了解下来,比markdown更复杂, 它解决的是排版问题,显然,写完的东西最终要注重格式。想必riscv官方觉得markdown要low一些,拿来写官方手册还是不够格。

同时,也有markdown + R 是否能替代 Latex 的疑问,我站不能这一队。毕竟 Latex 和 Markdown 要解决的问题是不一样的。markdown有点儿像手机,可以玩游戏,可以拍照拍视频,可以录音,可以看电视剧。但非要要求专业,玩游戏还得是电脑或者游戏机,拍照还得是相机,拍视频还是专业录像机,录音得用录音笔,收声器,看电视剧还是家庭影院合适。markdown确实方便,但替代不了专业的东西。

我的选择

他选择word的理由也很简单,他认为word格式更丰富,更正式,markdown太简单。如果让我,我会选择markdown,无论是用confluence,还是wiki,还是gitlab的doc服务,我觉得都很方便,好处显而易见

  • 编写方便,除了贴图麻烦一点儿,但规划好图片路径也还能接受,而且如果有支持的plantuml,一些简单的图会更好管理
  • 版本管理方便,方便diff,看改动
  • 省去排版的痛苦
  • 不需要规划模板,必然每个人看到的都是一样的,工作量小