如题,希望能够征集到多名志愿者参与《SAC 参考手册》的维护。

手册简介

SAC(Seismic Analysis Code)是地震学专业常用的数据处理软件之一,《SAC 参考手册》是一本详细介绍 SAC 用法的中文电子书。2011 年暑假,我尝试翻译了官方的英文文档,2012 年初将其整理为 PDF,并放在网络上免费下载,2012 年至 2015 年的三年间,该手册不断更新,目前文档的最新版本为 v3.3。

我为何不再维护

自 3.0 版发布之后,我就已经有不再维护该手册的想法:

  • 我对于 SAC 已经足够熟悉,日常使用过程中,没有阅读手册的需求,也就没有更新的动力;
  • 进入博士阶段,科研的压力日益繁重,没有足够的时间和精力继续维护;

为何要征集维护者

  1. SAC 在接下来的几年之内都不会被淘汰,依然是地震学专业常用的数据处理软件之一;
  2. 当 SAC 软件更新时,手册也需要及时更新;用着新版的软件却读着旧版的文档,谁也不知道什么时候会遇到一个坑;
  3. 整个文档的主体部分我已经基本做完,维护者的负担不会太大;

需要维护的内容

所谓的维护,主要包括如下几个方面:

  1. 随着 SAC 软件新版本的发布,新增或更新手册中相应的内容;
  2. 完善未讲清楚或易引起歧义的部分;
  3. 修复错别字;
  4. 增加日常数据处理过程中的一些 SAC 技巧;
  5. 对于命令及用法,若不同版本间存在不兼容,则以最新版本的 SAC 为准,并在正文或脚注中适当提及版本间的差异。
  6. 增加你认为值得加入的部分;
  7. 文档整体布局的调整以及 LaTeX 源码的简化;

对维护者的最低要求

  1. SAC 用户(SAC 初学者);
  2. 操作系统以 Linux 为主;
  3. 有时间和精力;
  4. 了解 LaTeX、Git 的基础知识(至少愿意学习和了解);

维护者可以得到什么

维护者完全无偿工作,没有任何经济上的报酬(若是有机会,我可以请吃顿饭)。除此之外,维护者还可以得到如下一些虚无缥缈的东西:

  1. 手册中会将你列为维护者,并留有邮箱;
  2. 结识更多的 SAC 用户以及地震学同行;
  3. 了解 MarkDown 和 LaTeX 的基础语法;
  4. 学会使用 Git,参与开源项目;

如何参与

具体操作方式见 SAC 参考手册附录 E 的文档更新与维护一章。

修订历史

  • 2015-03-07:初稿;
  • 2015-03-09:补充了参与维护的具体步骤;
  • 2015-03-13:置顶本文;
  • 2015-03-23:取消置顶;
  • 2015-08-07:更新了 git 协作流程;
  • 2016-03-08:操作流程放在 SAC 手册中,不再本页显示;