DICOM:DICOM3.0标准中文版开源书籍之”本地版本管理方案“

背景:

上个月DICOM:开源书籍之『DICOM标准中文版』启动计划项目已顺利启动,最终组内成员选用了看云作为开源书籍的提交、整合、发布的平台。主要的用意是操作简单,使用者不需要面对git、svn等工具繁琐的指令,像编辑传统文档一样对文档进行多人协作以及版本管理。
看云平台的方式主要目的是普适性,为了适应后期团队内所有成员,尤其是邀请的英文顾问(大多是英文等文科类专业的人员),省去了很多繁琐的操作。但是对于程序员来说,版本管理(无论是代码,还是日常工作日志)轻车熟路,因此本博文决定介绍几种个人认为比较流行的方式,便于对零散、琐碎的开源书籍翻译工作进行合理规划和管理

SVN+GIT:

我个人一直推崇svn(中央版本库)+GIT(本地版本库)的方式。可以将文档向代码一样自由进行版本控制。之前博文版本控制:SVN和GIT的一些使用感受系列也介绍过该使用方式。这里就不赘述了,有兴趣的大家可以浏览一下,对于熟练的程序员来说这种方式应该是最顺手的。尤其是对于开源书籍翻译工作,每天可能翻译的片段比较松散,翻译的内容比较拗口,后期可能重复修改,重复回滚,因此选用SVN+GIT的方式应该是最合理的方式。

MarkDownPad+GitHub:

上面提到的SVN+GIT的方式是程序员首选,由于日常编程工作中频繁操作,因此对于SVN和GIT的各种命令行很熟悉。但是这种方式对于部分‘懒人’来说虽然靠谱,但操作比较繁琐,需要记各种命令行指令。
为此这里提出一种更简易的方式,即MarkDownPad+GitHub。MarkDownPad是一款MarkDown编辑工具,可以在官网下载自动安装。打开后可以使用MarkDown语法来编写文档(当然也可以当做简单的文本编辑工具使用),后续可以直接同步到看云平台中。
由于MarkDownPad只具备MarkDown编辑功能,无法记录每次翻译的版本,因此可以下载GitHub官网提供的客户端(下载链接,我这里下载的Windows客户端),该客户端使用Github账号登陆后,可以讲本地用MarkDownPad编辑的文档轻松提交到GitHub中进行版本控制,不需要输入任何命令行。
我本地使用SVN+GIT的方式进行开源书籍工作的管理,这里只是使用MarkDownPad+GitHub的方式来管理DICOM3.0标准官网中的图片(因为MarkDown编辑器中插入图片需要给出一个URL连接),下面以PS3.8中的Figure7-2为例讲解一下使用过程。

DICOM:DICOM3.0标准中文版开源书籍之”本地版本管理方案“_第1张图片

  1. 在Github主页创建名称为DICOM-Chinese的版本库,然后在Github客户端中登陆,使用Clone将DICOM-Chinese版本库Clone到本地,如下图所示,我拷贝到本地的目录是:F:\参考资料\DICOM3.0标准\DICOM3.0开源书籍\DICOM-Chinese\DICOM-Chinese
    DICOM:DICOM3.0标准中文版开源书籍之”本地版本管理方案“_第2张图片
  2. 将标准中的Figure7-2图片另存到1中所示的本地目录,随后在Github客户端中就可以看到我们提交的修改,填写相关的提交注释,然后单击下图①按钮即可将修改提交到本地(F:\参考资料\DICOM3.0标准\DICOM3.0开源书籍\DICOM-Chinese\DICOM-Chinese)的git版本库中,然后单击下图②按钮即可将修改同步到Github主版本库中。
    DICOM:DICOM3.0标准中文版开源书籍之”本地版本管理方案“_第3张图片
    此时在网页端就可以看到我们提交的图像,右键单击即可拷贝Figure 7-2图片的URL连接,添加到MarkDown编辑的翻译文档中,即可显示出图片。
    DICOM:DICOM3.0标准中文版开源书籍之”本地版本管理方案“_第4张图片

马克飞象+印象笔记:

最后介绍一种虽简单的方式,不需要任何SVN和GIT的相关操作。完全像编辑普通文档一样进行版本管理,即马克飞象+印象笔记
开源DICOM书籍的翻译工作采用每月讨论整合,然后统一提交到看云平台(外网可访问)的方式。但是具体到每个人其实只需要在本地进行翻译工作的相应版本管理即可。因此使用印象笔记这种工具即可完成任务,在印象笔记的笔记菜单栏中可以查看笔记的所有版本历史,例如本篇博文在本地使用印象笔记记录的情况如下:(印象笔记本身的版本管理并非严格按照自己每次修改时间点来提交,而是每天中不同时段自动提交,因此可能会导致某些中间版本不存在,使用时要注意)
DICOM:DICOM3.0标准中文版开源书籍之”本地版本管理方案“_第5张图片
既然使用印象笔记就可以了,那么马克飞象又是什么东东呢?由于印象笔记本身并未开放MarkDown编辑功能,只能使用简单的文本编辑方式,操作排版比较繁琐。而马克飞象就是一款MarkDown编辑工具(与上文提到的MarkDownPad完全类似),并且可以绑定到印象笔记账号,将以MarkDown编辑的文章同步到印象笔记中保留原有格式。所以为了与最后看云平台对接,才使用马克飞象+印象笔记配合的方式进行本地翻译文本的管理。
例如我本地的使用情况:
DICOM:DICOM3.0标准中文版开源书籍之”本地版本管理方案“_第6张图片
这种方式即进行了版本控制,又避免了SVN或GIT等复杂的命令行,另外马克飞象还支持直接粘贴本地图片到MarkDown文档中,日常编辑效率大大提升。

后记:

上述三种方式的操作简易性逐渐提高,但操作灵活性略有降低,大家使用时根据具体情况适当选择。



作者:[email protected]
时间:2015/08/23

你可能感兴趣的:(DICOM)