如题,希望能够征集到多名志愿者参与《SAC 参考手册》的维护。
手册简介
SAC(Seismic Analysis Code)是地震学专业常用的数据处理软件之一,《SAC 参考手册》是一本详细介绍 SAC 用法的中文电子书。2011 年暑假,我尝试翻译了官方的英文文档,2012 年初将其整理为 PDF,并放在网络上免费下载,2012 年至 2015 年的三年间,该手册不断更新,目前文档的最新版本为 v3.3。
我为何不再维护
自 3.0 版发布之后,我就已经有不再维护该手册的想法:
- 我对于 SAC 已经足够熟悉,日常使用过程中,没有阅读手册的需求,也就没有更新的动力;
- 进入博士阶段,科研的压力日益繁重,没有足够的时间和精力继续维护;
为何要征集维护者
- SAC 在接下来的几年之内都不会被淘汰,依然是地震学专业常用的数据处理软件之一;
- 当 SAC 软件更新时,手册也需要及时更新;用着新版的软件却读着旧版的文档,谁也不知道什么时候会遇到一个坑;
- 整个文档的主体部分我已经基本做完,维护者的负担不会太大;
需要维护的内容
所谓的维护,主要包括如下几个方面:
- 随着 SAC 软件新版本的发布,新增或更新手册中相应的内容;
- 完善未讲清楚或易引起歧义的部分;
- 修复错别字;
- 增加日常数据处理过程中的一些 SAC 技巧;
- 对于命令及用法,若不同版本间存在不兼容,则以最新版本的 SAC 为准,并在正文或脚注中适当提及版本间的差异。
- 增加你认为值得加入的部分;
- 文档整体布局的调整以及 LaTeX 源码的简化;
对维护者的最低要求
- SAC 用户(SAC 初学者);
- 操作系统以 Linux 为主;
- 有时间和精力;
- 了解 LaTeX、Git 的基础知识(至少愿意学习和了解);
维护者可以得到什么
维护者完全无偿工作,没有任何经济上的报酬(若是有机会,我可以请吃顿饭)。除此之外,维护者还可以得到如下一些虚无缥缈的东西:
- 手册中会将你列为维护者,并留有邮箱;
- 结识更多的 SAC 用户以及地震学同行;
- 了解 MarkDown 和 LaTeX 的基础语法;
- 学会使用 Git,参与开源项目;
如何参与
具体操作方式见 SAC 参考手册附录 E 的文档更新与维护一章。
修订历史
- 2015-03-07:初稿;
- 2015-03-09:补充了参与维护的具体步骤;
- 2015-03-13:置顶本文;
- 2015-03-23:取消置顶;
- 2015-08-07:更新了 git 协作流程;
- 2016-03-08:操作流程放在 SAC 手册中,不再本页显示;