Folio Writer

在 iPhone 和 iPad 上编译

iPhone 运行不了 pandoc 或 LaTeX,所以 Folio Writer for iOS 在 Folio Writer 服务器上排版——短暂、透明,而且只在你要求时进行。下面说明会发生什么、你能选择什么,以及何时改用 Mac。

得到 PDF 的两种方式

预览手稿(免费)把整部草稿组装起来并在设备上渲染,数学公式由 KaTeX 排版;其分享菜单可生成 PDF 或打印,没有任何内容离开手机。这是获取阅读副本的快捷、私密之路。

编译(Pro)是真正的排版——与 Mac 相同的 pandoc 流水线——经 Typst 或 LaTeX 生成 PDF、Word 文档或 Typst 源码,引用按你的 .bib 文件解析,图、表、公式自动编号。它在服务器上运行。

发送什么,保留多久

已经在 Folio Cloud 上的项目直接用服务器上的副本编译,不额外上传任何东西。本地或 iCloud 项目会被打包发送以供编译——需要登录 Folio Cloud 账户——编译完成即删除;无论如何,服务器几分钟后都会清扫残留。端到端加密项目的云端副本是封存的,因此发送一份可读副本前会先征求同意。第一次编译时,会有一次性的说明把这些讲清楚。

服务器编译仅用于 iPhone 和 iPad。在 Mac 上,Folio Writer 用自带工具在本地编译,文件从不离开你的电脑。

可选项

格式:PDF、Word 或 Typst 源码。排版引擎(仅 PDF):默认 Typst——快速,原生支持 CJK 字体和 SVG 插图;或 LaTeX——通过 Tectonic 运行,得到 LaTeX 文档的外观及其宏包生态;完成后文件下方的一行会告诉你实际使用了哪一个。将活页夹标题插入为标题按条目在活页夹中的层级打印文件夹和文档标题,与 Mac 一致;若文档首个标题与其标题重复则跳过避免标题打印两次。章节编号与目录顾名思义;含有修订建议的手稿可以按“全部接受”或“全部拒绝”编译。

导出 Markdown(源码)把组装好的手稿写成一个 .md 文件保存在设备上——与编译将发送的文本相同——可交给合作者、放进仓库或导入其他工具。

交叉引用与参考文献列表

服务器运行 pandoc-crossref,因此 @fig:key、@tbl:key、@eq:key 会变成“Fig. 1”“Table 1”“eq. 1”并按顺序编号;句首用大写的 @Fig:key。当正文引用了参考文献中的任何条目,会在末尾自动追加一节不编号的 References;想自己决定位置,就在手稿里放一个 ::: {#refs} 块。语法详见图、公式与交叉引用。

长篇项目

编译以任务形式运行:手机提交手稿,轮询进度(“转换中”“LaTeX 排版中…”),再取回文件,因此长篇书稿不会被请求超时打断。“取消”会停止服务器上的排版进程。若编译失败,“问题”框的前几行就是真正的错误——带行号的 LaTeX 错误,或 pandoc 的提示——之后才是各种警告。

字体与符号。走 LaTeX 路线时,Latin Modern 缺少的字符——CO₂、δ、≈、⌘——会自动映射为 LaTeX 命令,中日韩文本会得到 Noto 回退字体。Typst 无需任何帮助即可处理这两者。

自己的服务器。官方 Folio Cloud 已经提供端到端加密和密码保护分享,但进阶用户——以及必须把一切留在自有基础设施上的公司、高校、机构和研究团队——可以自行运行 Folio Writer 服务器。见自托管,或联系我们了解更多信息并获得技术支持。

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