是莽撞人就来单挑：用 R Markdown 做海报

谢益辉 / 2017-04-05

去年有个机构想用 R Markdown 输出 LaTeX 海报。我说要是哪个周末我有空可以给你们整个包来干这事，一直也没时间，于是再发一张莽撞贴，看哪位莽撞人有兴趣把这事办了。本来我是想着我做个 R 包，让他们送我一张乒乓球桌（抠门如我，就这样出卖了自己的灵魂），现在我把这个奖励转让给能做出来的人。

我觉得这事应该不会太复杂，但只是我觉得。我这么觉得是因为我熟悉 knitr 和 rmarkdown 的各种黑暗面。捡重点说：

1. LaTeX 模板。Overleaf 网站上有一大堆海报模板，找两个学习一下大致的语法。

2. 大致上来说，可以基于 rmarkdown::beamer_presentation 构造这个海报输出格式。关键难点在于生成那些 LaTeX 环境。比如 \begin{block} \begin{column} 之类的。当然，你可以说 Pandoc 接受 LaTeX 环境啊，所以直接敲这些命令不就好了。问题是：

   1. 源代码看起来丑。

   2. 环境内部不能用 Markdown。如果要问为什么的话，请看这里。不能用 Markdown 语法那还说个毛线，比如敲个列表又要用丑丑的 \item。整个人生都失去了意义。

   所以呢，黑招藏在 knitr 的 block2 引擎里。这个引擎是我在开发 bookdown 时想出来的，它没有任何技术文档，只有简略的表面介绍，所以读源代码吧少年，源代码很短，套路却相当之深。它的目的是在 bookdown 文档中创建自定义环境，让这些环境能在 LaTeX 和 HTML 输出中通用，而且环境内部还要能支持 Markdown 语法。

如果你打通了这两关，那么剩下的事情就是语法包装了。一个海报文档看起来大约是这样的：

---
title: Unnecessarily Complicated Research Title
author: John Smith, James Smith and Jane Smith
institute: Department and University Name
output: mdposter::pdf_poster
---

```{alertblock, latex.options = '{Objectives}'}
Lorem ipsum dolor sit amet, consectetur, nunc tellus pulvinar tortor,
commodo eleifend risus arcu sed odio:

- Mollis dignissim.
- Sed aliquet luctus lectus, eget aliquet leo ullamcorper consequat.
- Nascetur ridiculus mus.  
- Euismod non erat.
```

这里面还有一个我没有现成答案的难点，就是嵌套环境。block2 引擎只适合单个的环境，你不能用一个 block2 块嵌套另一个 block2 块。可能需要发明额外的黑招。如果需要灵感，可以参照 bookdown 的 PDF 格式源代码，核心思想就是后期处理 .tex 文件，这里是正则表达式的天堂。

等你把乒乓球桌搬回家。

← 是莽撞人就来单挑：从 R Markdown 到微软 Office 输出 管天管地管拉屎放屁 →