From 5a0a054c60a0dced7d56ab526f33b55ce2dd492c Mon Sep 17 00:00:00 2001 From: Xingyu Wang Date: Wed, 15 Mar 2023 09:13:28 +0800 Subject: [PATCH] RP @lxbwolf https://linux.cn/article-15627-1.html --- ...s Guide to R Markdown Syntax [With Cheat Sheet].md | 164 ++++++------------ 1 file changed, 51 insertions(+), 113 deletions(-) rename {translated/tech => published}/20230216.1 ⭐️⭐️ Beginner's Guide to R Markdown Syntax [With Cheat Sheet].md (59%) diff --git a/translated/tech/20230216.1 ⭐️⭐️ Beginner's Guide to R Markdown Syntax [With Cheat Sheet].md b/published/20230216.1 ⭐️⭐️ Beginner's Guide to R Markdown Syntax [With Cheat Sheet].md similarity index 59% rename from translated/tech/20230216.1 ⭐️⭐️ Beginner's Guide to R Markdown Syntax [With Cheat Sheet].md rename to published/20230216.1 ⭐️⭐️ Beginner's Guide to R Markdown Syntax [With Cheat Sheet].md index 9eee713699..3d78b3c4a9 100644 --- a/translated/tech/20230216.1 ⭐️⭐️ Beginner's Guide to R Markdown Syntax [With Cheat Sheet].md +++ b/published/20230216.1 ⭐️⭐️ Beginner's Guide to R Markdown Syntax [With Cheat Sheet].md @@ -3,124 +3,73 @@ [#]: author: "Sreenath https://itsfoss.com/author/sreenath/" [#]: collector: "lkxed" [#]: translator: "lxbwolf" -[#]: reviewer: " " -[#]: publisher: " " -[#]: url: " " +[#]: reviewer: "wxy" +[#]: publisher: "wxy" +[#]: url: "https://linux.cn/article-15627-1.html" -R Markdown 语法新手指南[备忘录] +R Markdown 语法新手指南 ====== +![][0] + 你可能已经了解过轻量级标记语言 Markdown。如果你是第一次接触这个概念，请参考我们的 [Markdown 指南][1]。概括来讲，它是一种用于创建纯文本文档的简单又高效的语言。 然而，Markdown 在制作详细的报告或技术文件方面可能还不够完善。 -受益于[knitr][2]和[Pandoc][3]等软件包，**交互式文件格式 R Markdown** 早在 2014 年就出现了。它将纯文本与内嵌的 R 代码相结合，可以制作动态文件。 +受益于 [knitr][2] 和 Pandoc 等软件包，**交互式文件格式 R Markdown** 早在 2014 年就出现了。它将纯文本与内嵌的 R 代码相结合，可以制作动态文件。 -你可以使用 [各种 IDE][4] 和扩展来创建 R Markdown 文档，官方 IDE 为**RStudio**。因此，在这篇文章中，我们将重点介绍**使用 RStudio 学习 R Markdown语法**。 +你可以使用 [各种 IDE][4] 和扩展来创建 R Markdown 文档，官方 IDE 为 **RStudio**。因此，在这篇文章中，我们将重点介绍**使用 RStudio 学习 R Markdown 语法**。 -💡 - -（假如你没有了解过，）**R 编程语言** 是一种用于统计计算、图形表示和报告的语言。 - -**推荐阅读 📖** - -是一种用于统计计算、图形表示和报告的语言。 - -**建议阅读 📖** - -如何在 Ubuntu 上安装和使用 R。 -概要：本教程教你如何在 Ubuntu上安装 R。你还将学习在 Ubuntu 上运行你的第一个 R 程序的各种方法。R 和 Python 都是最常用的统计计算和图形的编程语言，能让数据处理变得简单。 -![][5] -![][6] +> 💡（假如你没有了解过，）**R 编程语言** 是一种用于统计计算、图形表示和报告的语言。 ### 配置 RStudio -通过合适的配置，你可以很轻松地用 RStudio 来编写 R Markdown。当你安装完一个软件包后，就已经完成了大部分的工作! +通过合适的配置，你可以很轻松地用 RStudio 来编写 R Markdown。只需要安装一个软件包，就已经完成了大部分的工作！ -安装 RStudio 后，在**工具**菜单中选择_安装软件包_选项。 +安装 RStudio 后，在 “工具Tools” 菜单中选择 “安装软件包Install Packages” 选项。 -![在 RStudio 的工具菜单下选择安装软件包选项][7] 。 +![在 RStudio 的工具菜单下选择安装软件包选项][7] -在弹出的对话框中，搜索 rmarkdown 并安装。 +在弹出的对话框中，搜索 “rmarkdown” 并安装。 ![通过搜索并在新的软件包安装对话框中按下安装按钮来安装 Rmarkdown 软件包][8] -💡 +>💡 如果你想使用类似 Python 的代码块，你需要安装额外的包。当你想在你的文档中包含这些包时，RStudio 会提示你安装所需的包。 -如果你想使用类似 python 的代码块，你需要安装额外的包。当你想在你的文档中包含这些包时，RStudio 会提示你安装所需的包。 +安装完成后，你可以通过选择 “文件File > 新建文件New File > R Markdown” 来新建一个 R Markdown 文档。 -安装完成后，你可以通过选择**文件>新建>RMarkdown** 来新建一个 rmarkdown 文档。 - -![从文件菜单中创建一个新的 RMarkdown 文档][9] 。 +![从文件菜单中创建一个新的 RMarkdown 文档][9] 之后会提示你添加一些关于文件的信息（文件的元数据），把这些填上就可以了。 -![用 rmarkdown 语法写出标题和其他细节][10] +![用 R Markdown 语法写出标题和其他细节][10] 或者你可以创建一个空的文件从零开始。 ### RMarkdown 语法 -由于它是"加强版的 Markdown"，因此大多数语法与 markdown 是一样的。 +由于它是 “加强版的 Markdown”，因此大多数语法与 Markdown 是一样的。 它还有一些 Markdown 支持不完善的东西，比如**表格、数学方程式、代码块等等**。 -下面是我们要介绍的内容的概括。 +下面是我们要介绍的内容的概括： + +| RMarkdown 块名 | 语法 | +| - | - | +| 标题 | `# 一级标题`
`## 二级标题`
`### 三级标题`
`一级标题`
`=======`
`二级标题`
`-------` | +| 着重 | `*斜体*`
`_斜体_`
`**加粗**`
`__加粗__` | +| 列表 | 无序列表：
`* 列表项`
`* 列表项`
` + 子项`
` + 子项`
有序列表：
`1. 列表项`
`2. 列表项`
` + 子项`
` + 子项` | +| 代码块 | 普通代码块：
\`\`\`
`这里写代码`
\`\`\`
R 代码块：
\`\`\`{r}
`R 代码`
\`\`\`
你也可以用其他的语言
行内 \`代码\` | +| 链接 | 普通链接：粘贴 URL
带标题的链接：`[显示的文本](URL_地址)`
跳转到锚点： `[显示的文本](#锚点)` | +| 表格 | `| 列名 | 列名 | 列名 |`
`| ------ | ------ | ------ |`
`| 项内容 | 项内容 | 项内容 |`
`| 项内容 | 项内容 | 项内容 |` | +| 方程式 | 行内方程式 `$Equations$`
展示方程式： `$$Equations$$` | +| 图片 | 无标题： `![](图片链接)`
有标题：`![可选标题](图片地址)` | +| 引用块 | `> 输入你引用的内容` | +| 其他 | 上角标：`文本内容^上角标^`
章或页水平分割线
`=========` 或 `----------`
行尾输入两个以上空格，即可添加人工行分割 | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
RMarkdown 块名语法
标题# 一级标题
## 二级标题
### 三级标题

一级标题
=======

二级标题
-------
着重*斜体*
_斜体_

**加粗**

__加粗__
列表无序列表
* 列表项
* 列表项
+ 子项
+ 子项

有序列表
1. 列表项
2. 列表项
+ 子项
+ 子项
代码块普通代码块

```
这里写代码
```

R 代码块

```{r}
R 代码
```
你也可以用其他的语言


行内 `代码`
链接纯文本：粘贴 URL
带标题的链接：[显示的文本](URL_地址)
跳转到锚点[显示的文本](#锚点)
表格| 列名 | 列名 | 列名 |
| ------ | ------ | ------ |
| 项内容 | 项内容 | 项内容 |
| 项内容 | 项内容 | 项内容 |
方程式行内方程式 \$Equations\$

展示方程式： \$\$Equations\$\$
图片无标题： ![](图片链接)

有标题： ![可选标题](图片地址)
引用块> 输入你引用的内容
其他上角标：文本内容^上角标^

章或页水平分割线

========= 或 ----------

行尾输入两个以上空格，即可添加人工行分割
- #### YAML 头 -在一个 R Markdown 文档的顶部，有一个 YAML 头，被两行 `------` 包围。这个块定义了文档的最终样式，通常包含一个标题、作者、日期和你想输出的文件类型。 +在一个 R Markdown 文档的顶部，有一个 YAML 头，被两行 `---` 包围。这个块定义了文档的最终样式，通常包含一个标题、作者、日期和你想输出的文件类型。 支持的文件格式有三种：**HTML、PDF 和 Word**。 @@ -184,12 +133,6 @@ output: pdf_document ![有序和无序列表示例][12] -**推荐阅读 📖** - -在 Linux 终端用 Glow 阅读和组织 Markdown 文件。Glow 是一个 CLI 工具，能在 Linux 终端渲染 Markdown 文件。你还可以用它来组织 Markdown 文件。 -![][13] -![][14] - #### 段落中的文本格式 格式化文本有几种方式。 @@ -209,7 +152,7 @@ _这里是斜体内容_ __这里是加粗内容__ ``` -你可以阅读我们的文章 [Markdown 中怎么让内容变成加粗和斜体][16] 来了解更多内容. +> 📋 你可以阅读我们的文章 [Markdown 中怎么让内容变成加粗和斜体][16] 来了解更多内容。 如果你想使用上角标，在想变成上角标的内容前后加上 `^` 符号。 @@ -227,9 +170,9 @@ __这里是加粗内容__ #### 添加代码块 -内嵌代码 是 R Markdown 最主要的设计目的。我们有几种添加代码的方式。 +内嵌代码是 R Markdown 最主要的设计目的。我们有几种添加代码的方式。 -**添加普通代码块** +##### 添加普通代码块 如果你想添加一个代码块来与其他的文本进行区分，可以使用下面的语法： @@ -240,15 +183,15 @@ __这里是加粗内容__ ```` -你也可以尝试 [对添加的代码进行高亮显示][18]. +你也可以尝试 [对添加的代码进行高亮显示][18]。 如果你想添加代码并将其输出嵌入到文档中，你可以在后面加上语言，并用大括号包裹： - +```` ```{语言} 这里输入你的代码 ``` - +```` 你可以用 ` 符号来添加行内代码。 @@ -275,6 +218,7 @@ https://itsfoss.com ``` 当你想链接到本页内的某个锚点时，使用下面的语法： + ``` [文本内容](#锚点名称) ``` @@ -283,10 +227,10 @@ https://itsfoss.com #### 表格 -表格的语法与 markdown 相似： +表格的语法与 Markdown 相似： ``` -|列表|列表|列表| +| 列表 | 列表 | 列表 | | --- | --- | --- | |表格项|表格项|表格项| |表格项|表格项|表格项| @@ -294,11 +238,7 @@ https://itsfoss.com ![][21] -📋 - -还想了解更多？请阅读我们的 [用 Markdown 创建表格][22] 指南。 - -. +> 📋 还想了解更多？请阅读我们的 [用 Markdown 创建表格][22] 指南。 #### 图片 @@ -306,9 +246,11 @@ https://itsfoss.com ``` ![](http://example.com/logo.png) +``` 或 +``` ![可选显示文本](figures/img.png) ``` @@ -316,7 +258,7 @@ https://itsfoss.com #### 块引用 -RMarkdown 可以添加块引用。在被引用的行或段落前添加 **>（大于号）**。 +RMarkdown 可以添加块引用。在被引用的行或段落前添加 `>`（大于号）。 ``` 这里是普通文本内容。 @@ -326,7 +268,7 @@ RMarkdown 可以添加块引用。在被引用的行或段落前添加 **>（大 ![][24] -如果你想了解更多块引用的内容，请阅读我们的 [Markdown 引用][25] 指南。 +> 📋 如果你想了解更多块引用的内容，请阅读我们的 [Markdown 引用][25] 指南。 #### 方程式 @@ -335,7 +277,7 @@ RMarkdown 可以添加块引用。在被引用的行或段落前添加 **>（大 例如： ``` -行内毕达哥拉斯定理： $Equation$ +行内方程式：$Equation$ 展示方程式：$$Equation$$ ``` @@ -354,15 +296,11 @@ RMarkdown 可以添加块引用。在被引用的行或段落前添加 **>（大 你可以在行尾添加两个以上的空格来添加人工行分割。 -### 总结 - ### R Markdown 非常有用（备忘录） - - ![][27] -[R Markdown 备忘录.pdf 下载文档][28] +> **[R Markdown 备忘录.pdf 下载文档][28]** _💬 你还知道其他关于 R Markdown 的内容吗？请在下面的评论区告诉我们。_ @@ -373,7 +311,7 @@ via: https://itsfoss.com/r-markdown/ 作者：[Sreenath][a] 选题：[lkxed][b] 译者：[lxbwolf](https://github.com/lxbwolf) -校对：[校对者ID](https://github.com/校对者ID) +校对：[wxy](https://github.com/wxy) 本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译，[Linux中国](https://linux.cn/) 荣誉推出 @@ -381,7 +319,6 @@ via: https://itsfoss.com/r-markdown/ [b]: https://github.com/lkxed/ [1]: https://itsfoss.com/markdown-guide/ [2]: https://www.r-project.org/nosvn/pandoc/knitr.html -[3]: https://itsfoss.comknitr, and Pandoc [4]: https://itsfoss.com/best-modern-open-source-code-editors-for-linux/ [5]: https://itsfoss.com/content/images/size/w256h256/2022/12/android-chrome-192x192.png [6]: https://itsfoss.com/content/images/wordpress/2019/06/install-r-on-ubuntu.jpg @@ -407,3 +344,4 @@ via: https://itsfoss.com/r-markdown/ [26]: https://itsfoss.com/content/images/2023/02/equations.png [27]: https://itsfoss.com/content/images/2023/02/R-Markdown-Cheat-Sheet.webp [28]: https://itsfoss.com/content/files/2023/02/R-Markdown-Cheat-Sheet.pdf +[0]: https://img.linux.net.cn/data/attachment/album/202303/15/090943m64sk4k496l4f99q.jpg \ No newline at end of file