作者:Yihui Xie
译者:郑宝童
日期:2021.05.13


Acknowledgments

鸣谢

First I’d like to thank my employer, RStudio, for providing me the opportunity to work on this exciting project. I was hoping to work on it when I first saw the GitBook project in 2013, because I immediately realized it was a beautiful book style and there was a lot more power we could add to it, judging from my experience of writing the knitr book (Xie 2015) and reading other books. R Markdown became mature after two years, and luckily, bookdown became my official job in late 2015. There are not many things in the world better than the fact that your job happens to be your hobby (or vice versa). I totally enjoyed messing around with JavaScript libraries, LaTeX packages, and endless regular expressions in R. Honestly I should also thank Stack Overflow (https://stackoverflow.com), and I believe you all know what I mean, if you have ever written any program code.

首先,我想感谢我的雇主,RStudio,为我提供这个令人兴奋的项目工作的机会。当我在2013年第一次看到他们的GitBook项目时,我就希望能参与这个工作,因为我立即意识到这是一本美丽的书风格,并且我们可以根据我写knitr 的经验(谢2015)和阅读其他书籍为它添加有更多的power,。两年后,R Markdown变得成熟,幸运的是,在2015年底bookdown 成为了我的正式工作。世界上没有多少事情比你的工作恰好是你的爱好更好的了(反之亦然)。我非常喜欢在r中处理JavaScript库、LaTeX包和无尽的正则表达式。老实说,我还应该感谢Stack Overflow (https://stackoverflow.com),如果你曾经写过任何程序代码,我相信你都知道我的意思。

This project is certainly not a single person’s effort. Several colleagues at RStudio have helped me along the way. Hadley Wickham provided a huge amount of feedback during the development of bookdown, as he was working on his book R for Data Science with Garrett Grolemund. JJ Allaire and Jonathan McPherson provided a lot of technical help directly to this package as well as support in the RStudio IDE. Jeff Allen, Chaita Chaudhari, and the RStudio Connect team have been maintaining the https://bookdown.org website. Robby Shaver designed a nice cover image for this book. Both Hadley Wickham and Mine Cetinkaya-Rundel reviewed the manuscript and gave me a lot of helpful comments. Tareef Kawaf tried his best to help me become a professional software engineer. It is such a blessing to work in this company with enthusiastic and smart people. I remember once I told Jonathan, “hey I found a problem in caching HTML widgets dependencies and finally figured out a possible solution”. Jonathan grabbed his beer and said, “I already solved it.” “Oh, nice, nice.”

这个项目当然不是一个人的努力。RStudio的几个同事一直在帮助我。Hadley Wickham在我开发bookdown的过程中提供了大量的反馈,当时他正与Garrett Grolemund一起编写他的《R for Data Science》一书。JJ Allaire和Jonathan McPherson直接为这个包提供了很多技术帮助,以及RStudio IDE中的支持。Jeff Allen, Chaita Chaudhari和RStudio Connect团队一直在维护https://bookdown.org网站。Robby Shaver为这本书设计了一个漂亮的封面。Hadley Wickham 和 Mine Cetinkaya-Rundel 都审阅了我的手稿,并给了我许多有益的评论。Tareef Kawaf尽力帮助我成为一名专业的软件工程师。能在这个充满热情和聪明的人的公司工作真是一种福气。我记得有一次我告诉Jonathan,“嘿,我发现了缓存HTML小部件依赖关系的一个问题,并最终找到了一个可能的解决方案。”Jonathan抓起他的啤酒说:“我已经解决了。“哦,不错,不错。”

I also received a lot of feedback from book authors outside RStudio, including Jan de Leeuw, Jenny Bryan, Dean Attali, Rafael Irizarry, Michael Love, Roger Peng, Andrew Clark, and so on. Some users also contributed code to the project and helped revise the book. Here is a list of all contributors: https://github.com/rstudio/bookdown/graphs/contributors. It feels good when you invent a tool and realize you are also the beneficiary of your own tool. As someone who loves the GitHub pull request model, I wished readers did not have to email me there was a typo or obvious mistake in my book, but could just fix it via a pull request. This was made possible in bookdown. You can see how many pull requests on typos I have merged: https://github.com/rstudio/bookdown/pulls. It is nice to have so many outsourced careful human spell checkers. It is not that I do not know how to use a real spell checker, but I do not want to do this before the book is finished, and the evil Yihui also wants to leave a few simple tasks to the readers to engage them in improving the book.

Callum Webb kindly designed a nice hexbin sticker for bookdown.

我也收到了许多来自RStudio之外的作者的反馈,包括Jan de Leeuw, Jenny Bryan, Dean Attali, Rafael Irizarry, Michael Love, Roger Peng, Andrew Clark等等。一些用户还为项目贡献了代码,并帮助修改了这本书。以下是所有贡献者的列表:https://github.com/rstudio/bookdown/graphs/contributors。当你发明了一种工具并意识到你也是自己工具的受益者时,你会感觉很好。作为一个喜欢GitHub pull request模型的人,我希望读者不要因为我的书有拼写错误或明显的错误而给我发邮件。这在bookdown中是可能发生的。您可以看到我合并了多少错误的pull requests: https://github.com/rstudio/bookdown/pulls。有这么多精心的人工拼写检查外包是件好事。并不是我不知道如何使用真正的拼写检查器,而是我不想在书还没写完之前就这么做,而也想留给读者一些简单的任务,让他们从事于改进书。Callum Webb 好意为 bookdown设计了一个很好的hexbin标签。

The bookdown package is not possible without a few open-source software packages. In particular, Pandoc, GitBook, jQuery, and the dependent R packages, not to mention R itself. I thank the developers of these packages.

如果没有一些开源软件包,bookdown是不可能完成的。尤其是Pandoc、GitBook、jQuery和相关的R包,更不用说R本身了。我感谢这些包的开发者。

I moved to Omaha, Nebraska, in 2015, and enjoyed one year at Steeplechase Apartments, where I lived comfortably while developing the bookdown package, thanks to the extremely friendly and helpful staff. Then I met a professional and smart realtor, Kevin Schaben, who found a fabulous home for us in an amazingly short period of time, and I finished this book in our new home.

John Kimmel, the editor from Chapman & Hall/CRC, helped me publish my first book. It is my pleasure to work with him again. He generously agreed to let me keep the online version of this book for free, so I can continue to update it after it is printed and published (i.e., you do not have to wait for years for the second edition to correct mistakes and introduce new features). I wish I could be as open-minded as he is when I’m his age. Rebecca Condit and Suzanne Lassandro proofread the manuscript, and their suggestions were professional and helpful. Shashi Kumar solved some of my technical issues with the publisher’s LaTeX class (krantz.cls) when I was trying to integrate it with bookdown. I also appreciate the very helpful comments from the reviewers Jan de Leeuw, Karl Broman, Brooke Anderson, Michael Grayling, Daniel Kaplan, and Max Kuhn.

2015年,我搬到了Omaha, Nebraska,并在Steeplechase公寓度过了一年,在那里我住得很舒服,同时开发了bookdown 包,多亏了非常友好和乐于助人的员工。后来,我遇到了一位专业而聪明的房地产经纪人凯文·沙本(Kevin Schaben),他在极短的时间内为我们找到了一套极好的房子,我在我们的新家完成了这本书。John Kimmel, Chapman & Hall/CRC的编辑,帮助我出版了我的第一本书。能再次与他共事是我的荣幸。他慷慨地同意让我免费保留这本书的在线版本,这样我就可以继续给你看了

Lastly I want to thank my family, in particular, my wife and son, for their support. The one-year-old has discovered that my monitor will light up when he touches my keyboard, so occasionally he just creeps into my office and presses randomly on the keyboard when I’m away. I’m not sure if this counts as his contribution to the book… @)!%)&@*

最后,我要感谢我的家人,特别是我的妻子和儿子,感谢他们的支持。这个一岁大的孩子发现,当他触碰我的键盘时,我的显示器就会亮起来,所以他偶尔会溜进我的办公室,在我不在的时候随意按键盘。我不确定这算不算他对这本书的贡献…@)!%)&@*
Yihui Xie
Elkhorn, Nebraska

References

Xie, Yihui. 2015. Dynamic Documents with R and Knitr. 2nd ed. Boca Raton, Florida: Chapman; Hall/CRC. http://yihui.org/knitr/.