Folio Writer

图、公式与交叉引用

手工编号是图表引用出错的根源。在 Folio Writer 里,你只给对象加一次标签、按名字引用,编译负责全部编号——编辑器则就地显示图片、题注和排版好的公式。

标签

图就是独占一行的普通 Markdown 图片,再在花括号里加标签:

![MgO 的压缩曲线](Research/compression.png){#fig:compression width=70%}

替代文本就是题注。width= 接受文本宽度的百分比或绝对尺寸(3in、8cm、400px),在 PDF、Word 和 HTML 中同样生效。表格的标签写在表格下方的题注行里:

| 相 | P (GPa) |
|----|---------|
| B1 | 0–400   |

: MgO 的各相 {#tbl:phases}

公式是行间数学后面跟上标签:

$$K_T = -V \left(\frac{\partial P}{\partial V}\right)_T$$ {#eq:bulk}

引用

用 @ 加键名引用任何已加标签的对象——@fig:compression、@tbl:phases、@eq:bulk——编译会打印“Fig. 1”“Table 1”“eq. 1”。句首把前缀大写(@Fig:compression);多个一起引用写成 [@fig:a; @fig:b]。编号按整部手稿中的出现顺序排列,所以在活页夹里移动一章也会正确地重新编号。

编号由 pandoc-crossref 完成:在 Mac 上它与其他工具一起安装(编译 ▸ 设置外部工具…),Folio Writer 服务器也已内置,因此从 iPhone、iPad 编译的编号方式完全一致。没有它,引用会按原样打印。

编辑器中看到的

开启渲染图片后,独占一行的图片会直接显示为图片,尺寸与导出一致,题注与 [fig:key] 标签显示在下方。公式就地排版——行内公式落在正文自己的基线上,行间公式独占一行并在旁边带有 (eq:key) 标记。上下标(H~2~O、x^2^)显示为 H₂O 和 x²。光标一进入该段落,Markdown 就会回到眼前,编辑从不盲目;点按渲染好的图片即可打开源码。

在 iOS 上这些位于 设置 ▸ 编辑器 ▸ 渲染(图片、公式、上下标,以及隐藏多少 Markdown 语法);在 Mac 上位于 设置 ▸ 编辑器。文件本身始终是纯文本。

插入图片

把图片文件拖进编辑器、粘贴,或使用 插入 ▸ 图片:文件会被复制到项目的 Research 文件夹,Markdown 自动写好,标签可随时修改。路径保持相对于项目,手稿在哪里都能编译。

参考文献列表

交叉引用不是文献引用:@fig:x 在参考文献处理之前就被解析,所以永远不会去查找名为“fig:x”的文献键。当手稿确实引用了文献,编译结果末尾会有一节 References;想自己安排位置,在草稿任意处写

# References {.unnumbered}

::: {#refs}
:::

格式化的列表就会填入该块。

SVG 与 PDF 插图。Typst 和 HTML 预览直接读取 SVG;LaTeX 路线会把 SVG 栅格化,PDF 插图则原样使用。用于印刷时,PDF 或 300 dpi 的 PNG 最稳妥。

免费下载 Folio Writer →  ·  更多指南