我们的出版物焕然一新！

Jacky Song | May 19, 2025

经过大量工作，我们做出了一个重要改变：我们已将技术概览和2024 年终报告迁移到 MyST 框架。下面我们来解释为什么要做这次调整，以及它对未来意味着什么。

在木卫七计划，我们长期面临一个关于在线出版的难题。作为一个以开放研究为中心的组织，分享我们的工作是核心任务之一。此前，我们用于发布研究成果（论文、报告等）的方案大致只有三种：

• Markdown：纯文本格式，因此无需特殊工具也具备人类可读性，而且容易编写，但它本身不能直接生成 HTML 与 PDF
• LaTeX：同样是纯文本，并且可以自动生成 PDF，但环境搭建非常痛苦，而且仍不能解决 HTML 生成问题
• 应用专有格式，例如 TeXmacs：它相对容易写，也能在一定努力下生成 HTML 与 PDF，但它_不是_纯文本（至少不是人类可直接阅读的纯文本）

我们在这些方案之间来回切换，却始终找不到真正合适的方式，最终只能依赖一些很“黑客式”的解决方案，例如手工修改 TeXmacs 生成的 HTML，而它生成的内容看上去更像 XHTML，而不是现代 HTML5。幸运的是，现在不必再这样了。

MyST 是一个以开放科学为理念构建的框架，擅长创建带有丰富元数据、支持多种格式的交互式科学文章与论文。我们已经把最重要的两份出版物（技术概览和2024 年终报告）迁移到 MyST，效果非常出色。更关键的是，MyST 一次性解决了多个问题：

• 它是一个持续活跃开发中的框架，也是 Jupyter Project 的子项目，而不是我们必须自行维护的内部方案，因此它的输出默认就很专业，也更值得信赖
• 它允许我们以扩展 Markdown 语法来_撰写_文章与论文，再通过简单命令完成现代 HTML 站点与 PDF 的构建，因此我们既保留了 Markdown 的可读性，又不会失去 LaTeX 级别的输出质量

我对采用这个新框架感到非常兴奋，也希望它能为我们和整个项目打开新的可能性。