Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

【全书】现代统计图形搬迁计划 #14

Closed
XiangyunHuang opened this issue Aug 17, 2019 · 2 comments
Closed

【全书】现代统计图形搬迁计划 #14

XiangyunHuang opened this issue Aug 17, 2019 · 2 comments

Comments

@XiangyunHuang
Copy link
Owner

XiangyunHuang commented Aug 17, 2019

@pzhaonet 在另一个issues 提及了搬迁和修改原稿的事情#11 (comment),我觉得很重要,为了防止我用力过猛 https://github.com/XiangyunHuang/MSG-Book/issues/1 和统一大家的搬迁节奏,控制搬迁进程。特开一贴说明

轻微更新

R 包超过了 2500 个

如果真是简单到这种程度,改了也无妨,当然也完全可以保留。因为它属于轻微更新的范围。

中等更新

涉及风格的地方,比如第5章系统之ggplot2图形一节全部基于 qplot 画图,我就没有改到 ggplot 里来,虽然官方书籍 《ggplot2: Elegant Graphics for Data Analysis》 在第二版(现在已经进行到第三版)已经将 qplot 的介绍去掉了,并且理由很充分的样子:

Switched from qplot() to ggplot() in the introduction, Chapter 2. Feedback indicated that qplot() was a crutch: it makes simple plots a little easier, but it doesn’t help with mastering the grammar.

这一类属于中等程度的更新,可以是个人喜好,也可以算是内容过时,但并不妨碍代码运行和出图

严重更新

我在搬迁第五章系统的时候, ggplot2 的变动稍多一些,如果运行不了(原有的函数现在没有了),我就找了现在对应的函数,比如 opts -> themeggpcp -> GGally::ggparcoord。这是属于严重更新的范围,不更新的话,图出不来,代码运行不了。

加强更新

这一类属于丰富原来的图形呈现形式,我们知道 R Markdown 支持丰富的图形表现形式,静态图, GIF 动图, Shiny 嵌入,视频嵌入,甚至基于 JS 库的 (如 plotly) 交互式图形嵌入和 rgl 真三维动态交互图形的嵌入。

从 LyX 搬迁到 bookdown 的一大优势就是丰富图形展现手段,增加书籍和读者的互动,最终实现文学编程的终极目的 @yihui

这一类更新比较难操作,可暂时不操作,据我观察,这类操作也主要集中在第5章,我目前做的程度是能动态生成并嵌入的都做了,有限于能力和源代码可能存在的 BUG 的地方就没有更新

@pzhaonet
Copy link
Collaborator

pzhaonet commented Aug 17, 2019

前三点举双手赞同。至于第四点的加强更新,我外行,该添加什么内容就不乱讲了,这属于新增内容,只要围绕“现代统计图形”这个主题就行。

想多说一点,就是如何分阶段有步骤地实现这四类更新。

下面是我建议的步骤:

第一步,迁移。

这一步目的是让本书重见天日,方便浏览和修订。因此,原则是"二保":保持书稿原貌,保证代码运行。过时的信息可以不更新,用脚注来说明即可,但运行不了的代码必须更新。涉及的主要是“严重更新”部分。这一版本可以“古书”的姿态示人。

人力需求:对 R markdown, bookdown,LaTeX,css 熟悉的技术类人手。

第二步,修订。

这一步目的是更新过时的信息和风格。R 包早已不是 2500 个,安装包大小也不是 30 M了,新的图形界面可以介绍 RStudio 或者 Sublime 了等等。主要是“轻微更新”和“中等更新”。这一版本可以主流版本示人。

人力需求:对 R 熟悉的编辑类人手。

第三步,增补。

这一步目的是增加新的作图思想和方法,属于“加强更新”,开放型,原则上永远不完稿。

人力需求:开发者,统计图形领域专家等。

每步都有个 release,方便读者选择阅读。如果以搬家做类比,这三步就是:搬迁——装修——扩建。

@XiangyunHuang XiangyunHuang changed the title 版迁和更新程度 搬迁和更新程度 Aug 17, 2019
@XiangyunHuang XiangyunHuang added the documentation Improvements or additions to documentation label Aug 18, 2019
@XiangyunHuang XiangyunHuang changed the title 搬迁和更新程度 【全书】搬迁和更新程度 Aug 19, 2019
@XiangyunHuang XiangyunHuang added 第二版 and removed documentation Improvements or additions to documentation labels Aug 23, 2019
@XiangyunHuang XiangyunHuang changed the title 【全书】搬迁和更新程度 【全书】现代统计图形搬迁计划 Aug 25, 2019
@XiangyunHuang
Copy link
Owner Author

第三部分的加强更新或者说增补计划感觉超出了搬迁的范围,我们将其列为升级计划 https://github.com/XiangyunHuang/MSG-Book/issues/1 所以这个 issues 暂时关闭

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

2 participants