document/TranslateProject
2
0
Fork 0
mirror of https://github.com/LCTT/TranslateProject.git synced 2025-01-13 22:30:37 +08:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #28867 from wxy/20230216.1-⭐️⭐️-Beginner's-Guide-to-R-Markdown-Syntax-With-Cheat-Sheet]

Browse Source 
RP:published/20230216.1 ⭐️⭐️ Beginner's Guide to R Markdown Syntax [With Cheat Sheet].md
This commit is contained in:
Xingyu.Wang 2023-03-15 09:20:27 +08:00 committed by GitHub
commit e2e1548d43
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 51 additions and 113 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

164
translated/tech/20230216.1 ⭐️⭐️ Beginner's Guide to R Markdown Syntax [With Cheat Sheet].md → published/20230216.1 ⭐️⭐️ Beginner's Guide to R Markdown Syntax [With Cheat Sheet].md
View File

@ -3,124 +3,73 @@
[#]: author: "Sreenath https://itsfoss.com/author/sreenath/" [#]: author: "Sreenath https://itsfoss.com/author/sreenath/"
[#]: collector: "lkxed" [#]: collector: "lkxed"
[#]: translator: "lxbwolf" [#]: translator: "lxbwolf"
[#]: reviewer: " " [#]: reviewer: "wxy"
[#]: publisher: " " [#]: publisher: "wxy"
[#]: url: " " [#]: url: "https://linux.cn/article-15627-1.html"
R Markdown 语法新手指南[备忘录] R Markdown 语法新手指南
====== ======
![][0]
你可能已经了解过轻量级标记语言 Markdown。如果你是第一次接触这个概念，请参考我们的 [Markdown 指南][1]。概括来讲，它是一种用于创建纯文本文档的简单又高效的语言。 你可能已经了解过轻量级标记语言 Markdown。如果你是第一次接触这个概念，请参考我们的 [Markdown 指南][1]。概括来讲，它是一种用于创建纯文本文档的简单又高效的语言。
然而，Markdown 在制作详细的报告或技术文件方面可能还不够完善。 然而，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 编程语言** 是一种用于统计计算、图形表示和报告的语言。
（假如你没有了解过，）**R 编程语言** 是一种用于统计计算、图形表示和报告的语言。
**推荐阅读 📖**
是一种用于统计计算、图形表示和报告的语言。
**建议阅读 📖**
如何在 Ubuntu 上安装和使用 R。
概要：本教程教你如何在 Ubuntu上安装 R。你还将学习在 Ubuntu 上运行你的第一个 R 程序的各种方法。R 和 Python 都是最常用的统计计算和图形的编程语言，能让数据处理变得简单。
![][5]
![][6]
### 配置 RStudio ### 配置 RStudio
通过合适的配置，你可以很轻松地用 RStudio 来编写 R Markdown。当你安装完一个软件包后，就已经完成了大部分的工作! 通过合适的配置，你可以很轻松地用 RStudio 来编写 R Markdown。只需要安装一个软件包，就已经完成了大部分的工作！
安装 RStudio 后，在**工具**菜单中选择_安装软件包_选项。 安装 RStudio 后，在 “<ruby>工具<rt>Tools</rt></ruby>” 菜单中选择 “<ruby>安装软件包<rt>Install Packages</rt></ruby>” 选项。
![在 RStudio 的工具菜单下选择安装软件包选项][7] 。 ![在 RStudio 的工具菜单下选择安装软件包选项][7]
在弹出的对话框中，搜索 rmarkdown 并安装。 在弹出的对话框中，搜索 “rmarkdown” 并安装。
![通过搜索并在新的软件包安装对话框中按下安装按钮来安装 Rmarkdown 软件包][8] ![通过搜索并在新的软件包安装对话框中按下安装按钮来安装 Rmarkdown 软件包][8]
💡 >💡 如果你想使用类似 Python 的代码块，你需要安装额外的包。当你想在你的文档中包含这些包时，RStudio 会提示你安装所需的包。
如果你想使用类似 python 的代码块，你需要安装额外的包。当你想在你的文档中包含这些包时，RStudio 会提示你安装所需的包。 安装完成后，你可以通过选择 “<ruby>文件<rt>File</rt></ruby> > <ruby>新建文件<rt>New File</rt></ruby> > R Markdown” 来新建一个 R Markdown 文档。
安装完成后，你可以通过选择**文件>新建>RMarkdown** 来新建一个 rmarkdown 文档。 ![从文件菜单中创建一个新的 RMarkdown 文档][9]
![从文件菜单中创建一个新的 RMarkdown 文档][9] 。
之后会提示你添加一些关于文件的信息（文件的元数据），把这些填上就可以了。 之后会提示你添加一些关于文件的信息（文件的元数据），把这些填上就可以了。
![用 rmarkdown 语法写出标题和其他细节][10] ![用 R Markdown 语法写出标题和其他细节][10]
或者你可以创建一个空的文件从零开始。 或者你可以创建一个空的文件从零开始。
### RMarkdown 语法 ### RMarkdown 语法
由于它是"加强版的 Markdown"，因此大多数语法与 markdown 是一样的。 由于它是 “加强版的 Markdown”，因此大多数语法与 Markdown 是一样的。
它还有一些 Markdown 支持不完善的东西，比如**表格、数学方程式、代码块等等**。 它还有一些 Markdown 支持不完善的东西，比如**表格、数学方程式、代码块等等**。
下面是我们要介绍的内容的概括。 下面是我们要介绍的内容的概括：
| RMarkdown 块名 | 语法 |
| - | - |
| 标题 | `# 一级标题` <br> `## 二级标题` <br> `### 三级标题` <br> `一级标题` <br> `=======` <br> `二级标题` <br> `-------` |
| 着重 | `*斜体*` <br> `_斜体_` <br> `**加粗**` <br> `__加粗__` |
| 列表 | 无序列表：<br> `* 列表项` <br> `* 列表项` <br> ` + 子项` <br> ` + 子项` <br>有序列表：<br> `1. 列表项` <br> `2. 列表项` <br> ` + 子项` <br> ` + 子项` |
| 代码块 | 普通代码块：<br> \`\`\` <br> `这里写代码` <br> \`\`\` <br>R 代码块： <br> \`\`\`{r} <br> `R 代码` <br> \`\`\` <br>你也可以用其他的语言 <br> 行内 \`代码\` |
| 链接 | 普通链接：粘贴 URL <br >带标题的链接：`[显示的文本](URL_地址)` <br> 跳转到锚点： `[显示的文本](#锚点)` |
| 表格 | `| 列名 | 列名 | 列名 |` <br> `| ------ | ------ | ------ |` <br> `| 项内容 | 项内容 | 项内容 |` <br> `| 项内容 | 项内容 | 项内容 |` |
| 方程式 | 行内方程式 `$Equations$` <br> 展示方程式： `$$Equations$$` |
| 图片 | 无标题： `![](图片链接)` <br> 有标题：`![可选标题](图片地址)` |
| 引用块 | `> 输入你引用的内容` |
| 其他 | 上角标：`文本内容^上角标^` <br> 章或页水平分割线 <br> `=========` 或 `----------` <br>行尾输入两个以上空格，即可添加人工行分割 |
<table>
<thead>
<tr>
<th>RMarkdown 块名</th>
<th>语法</th>
</tr>
</thead>
<tbody>
<tr>
<td>标题</td>
<td># 一级标题<br>## 二级标题<br>### 三级标题<br><br>一级标题<br>=======<br><br>二级标题<br>-------</td>
</tr>
<tr>
<td>着重</td>
<td>*斜体*<br>_斜体_<br><br>**加粗**<br><br>__加粗__</td>
</tr>
<tr>
<td>列表</td>
<td>无序列表<br>* 列表项<br>* 列表项<br> + 子项<br> + 子项<br><br>有序列表<br>1. 列表项<br>2. 列表项<br> + 子项<br> + 子项</td>
</tr>
<tr>
<td>代码块</td>
<td>普通代码块<br><br>```<br>这里写代码<br>```<br><br>R 代码块<br><br>```{r}<br>R 代码<br>```<br>你也可以用其他的语言<br><br><br>行内 `代码`</td>
</tr>
<tr>
<td>链接</td>
<td>纯文本：粘贴 URL<br>带标题的链接：[显示的文本](URL_地址)<br>跳转到锚点[显示的文本](#锚点)</td>
</tr>
<tr>
<td>表格</td>
<td>| 列名 | 列名 | 列名 |<br>| ------ | ------ | ------ |<br>| 项内容 | 项内容 | 项内容 |<br>| 项内容 | 项内容 | 项内容 |</td>
</tr>
<tr>
<td>方程式</td>
<td>行内方程式 \$Equations\$<br><br>展示方程式： \$\$Equations\$\$</td>
</tr>
<tr>
<td>图片</td>
<td>无标题： ![](图片链接)<br><br>有标题： ![可选标题](图片地址)</td>
</tr>
<tr>
<td>引用块</td>
<td>> 输入你引用的内容</td>
</tr>
<tr>
<td>其他</td>
<td>上角标：文本内容^上角标^<br><br>章或页水平分割线<br><br>========= 或 ----------<br><br>行尾输入两个以上空格，即可添加人工行分割</td>
</tr>
</tbody>
</table>
#### YAML 头 #### YAML 头
在一个 R Markdown 文档的顶部，有一个 YAML 头，被两行 `------` 包围。这个块定义了文档的最终样式，通常包含一个标题、作者、日期和你想输出的文件类型。 在一个 R Markdown 文档的顶部，有一个 YAML 头，被两行 `---` 包围。这个块定义了文档的最终样式，通常包含一个标题、作者、日期和你想输出的文件类型。
支持的文件格式有三种：**HTML、PDF 和 Word**。 支持的文件格式有三种：**HTML、PDF 和 Word**。
@ -184,12 +133,6 @@ output: pdf_document
![有序和无序列表示例][12] ![有序和无序列表示例][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] ![][21]
📋 > 📋 还想了解更多？请阅读我们的 [用 Markdown 创建表格][22] 指南。
还想了解更多？请阅读我们的 [用 Markdown 创建表格][22] 指南。
.
#### 图片 #### 图片
@ -306,9 +246,11 @@ https://itsfoss.com
``` ```
![](http://example.com/logo.png) ![](http://example.com/logo.png)
```
或 或
```
![可选显示文本](figures/img.png) ![可选显示文本](figures/img.png)
``` ```
@ -316,7 +258,7 @@ https://itsfoss.com
#### 块引用 #### 块引用
RMarkdown 可以添加块引用。在被引用的行或段落前添加 **>（大于号）**。 RMarkdown 可以添加块引用。在被引用的行或段落前添加 `>`（大于号）。
``` ```
这里是普通文本内容。 这里是普通文本内容。
@ -326,7 +268,7 @@ RMarkdown 可以添加块引用。在被引用的行或段落前添加 **>（大
![][24] ![][24]
如果你想了解更多块引用的内容，请阅读我们的 [Markdown 引用][25] 指南。 > 📋 如果你想了解更多块引用的内容，请阅读我们的 [Markdown 引用][25] 指南。
#### 方程式 #### 方程式
@ -335,7 +277,7 @@ RMarkdown 可以添加块引用。在被引用的行或段落前添加 **>（大
例如： 例如：
``` ```
行内毕达哥拉斯定理： $Equation$ 行内方程式：$Equation$
展示方程式：$$Equation$$ 展示方程式：$$Equation$$
``` ```
@ -354,15 +296,11 @@ RMarkdown 可以添加块引用。在被引用的行或段落前添加 **>（大
你可以在行尾添加两个以上的空格来添加人工行分割。 你可以在行尾添加两个以上的空格来添加人工行分割。
### 总结
### R Markdown 非常有用（备忘录） ### R Markdown 非常有用（备忘录）
![][27] ![][27]
[R Markdown 备忘录.pdf 下载文档][28] > **[R Markdown 备忘录.pdf 下载文档][28]**
_💬 你还知道其他关于 R Markdown 的内容吗？请在下面的评论区告诉我们。_ _💬 你还知道其他关于 R Markdown 的内容吗？请在下面的评论区告诉我们。_
@ -373,7 +311,7 @@ via: https://itsfoss.com/r-markdown/
作者：[Sreenath][a] 作者：[Sreenath][a]
选题：[lkxed][b] 选题：[lkxed][b]
译者：[lxbwolf](https://github.com/lxbwolf) 译者：[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/) 荣誉推出 本文由 [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/ [b]: https://github.com/lkxed/
[1]: https://itsfoss.com/markdown-guide/ [1]: https://itsfoss.com/markdown-guide/
[2]: https://www.r-project.org/nosvn/pandoc/knitr.html [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/ [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 [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 [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 [26]: https://itsfoss.com/content/images/2023/02/equations.png
[27]: https://itsfoss.com/content/images/2023/02/R-Markdown-Cheat-Sheet.webp [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 [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