blogdown: Creating Websites With R Markdown.
blogdown: Creating Websites With R Markdown.
复制标题
blogdown：使用 R Markdown 创建网站。
DOI：
--
复制
发表时间：
2017
影响因子：
1.8
通讯作者：
Alison Presmanes Hill
中科院分区：
文献类型：
--
作者：
Yihui Xie;Amber Thomas;Alison Presmanes Hill
blogdown：用R Markdown创建网站这本书对于初学者和高级用户来说都是一本很好的读物。目标受众是对创建网站感兴趣的任何级别的R （R Core Team 2018）用户。这本书的重点是R包blogdown (Xie 2018)，从头到尾解释了如何从舒适的R控制台构建和发布一个网站。“blogdown”这个名字源于“Markdown”，Markdown是一种具有纯文本语法的标记语言，本质上是一种从易于阅读的纯文本文档呈现HTML的方法。值得注意的是，虽然“博客”一词是在包和书的名称中，但最终产品可以是任何网站，而不仅仅是博客。例如，统计学家可能对使用R生成的结果感兴趣，并将其发布到web上以供更多的受众看到。或者，统计学家可能对在线发布特定方法的教程感兴趣，或者可能这个统计学家想要一个关于非技术工作的博客空间，一个爱好，并且更喜欢使用R。该软件允许用户使用R Markdown （Allaire et al. 2018）在R中创建动态文档，并无缝地在网络上发布它们。这一简化的过程对统计人员来说是无价的，鼓励他们与广泛的受众分享他们的工作，使信息的传播变得简单和无痛。正如书的开头所说，“人生苦短。为永恒而写”；这本书让你很容易做到这一点。这本书首先介绍了blogdown包，解释了如何创建和更新本地网站。第二章介绍了作为blogdown基础的网站构建器Hugo。第三章解释了在线发布网站的各种方法。第4章演示了如何将现有的博客从Jekyll， WordPress或其他系统迁移到blogdown，最后第5章详细介绍了如何绕过Hugo并使用其他方法构建网站。除了正文中提供的丰富信息外，附录提供了一个很好的补充，包括简短的R Markdown介绍、网站基础、如何注册域名等主题，以及高级用户的主题。这本书的一个显著特点是它的通用性。对于初学者来说，它可以被视为一个“选择你自己的冒险”，因为你可以很容易地开始，从零到博客大约一个小时，通过简单地阅读第1章建立一个本地网站和第3.1节发布你的网站在网络上。第1章完成了第1.7节中为初学者推荐的工作流程，这需要很少的技术细节知识。剩下的章节可以根据需要补充人们对包的各种功能组件的理解。高级用户当然也可以从这本书的阅读中受益。第2章特别包含了更新和创建Hugo主题、模板和布局的细节，甚至介绍了一个从头开始编写的完全自定义主题的示例。作为一个blogdown用户，我已经多次引用这一章来回忆更新各种Hugo组件的最佳实践。我想为不同的用户推荐一些路线图：
The book blogdown: Creating Websites with R Markdown is an excellent read for beginners and advanced users alike. The target audience is R (R Core Team 2018) users of any level interested in creating a website. The book focuses on the R package blogdown (Xie 2018), explaining from beginning to end how to build and publish a website from the comfort of your R console. The name “blogdown” is a play on the word “Markdown,” a markup language with plain text syntax, essentially a way to render HTML from an easy to read, plain text document. It should be noted that while the term “blog” is in the name of the package and book, the final product can be any website, rather than just a blog. For example, a statistician may be interested in taking results generated in R, and publishing them on the web for a larger audience to see. Alternatively, a statistician may be interested in publishing tutorials on particular methods online, or perhaps this statistician wants a space to blog about nontechnical work, a hobby, and would prefer to do so using R. This software allows users to create dynamic documents in R, using R Markdown (Allaire et al. 2018), and seamlessly publish them on the web. This streamlined process is invaluable for statisticians, who are encouraged to share their work with a broad audience, making the dissemination of information simple and pain-free. As is stated at the front of the book, “Life is Short. Write for Eternity”; this book makes it easy to do so. The book begins with an introduction to the blogdown package, explaining how to create and update a local website. Chapter 2 walks through Hugo, the website builder that serves as the basis for blogdown. Chapter 3 explains various ways to publish a website online. Chapter 4 demonstrates how to migrate existing blogs from Jekyll, WordPress, or other systems to blogdown, and finally Chapter 5 details how to bypass Hugo and build sites using other methods. In addition to the wealth of information provided in the main text, the Appendices provide an excellent supplement, including topics such as a brief R Markdown introduction, website basics, how to register a domain name, and topics for advanced users. An excellent feature of this book is its versatility for the reader. For the beginner, it can be treated as a “choose your own adventure” as you can easily get started, going from zero to blog in about an hour, by simply reading Chapter 1 to build a local website and Section 3.1 to publish your site on the web. Chapter 1 is complete with a recommended workflow for beginners in Section 1.7 that requires little knowledge of technical details. The remaining chapters can supplement one’s understanding of various components of the package’s capabilities as needed. The advanced user also can certainly benefit from a read of this book. Chapter 2 in particular contains details on updating and creating Hugo themes, templates, and layouts, even walking through an example of a fully custom theme written from scratch. I have referred to this chapter many times throughout my time as a blogdown user to recall best practices for updating various Hugo components. A few road maps I would suggest for various users: