安裝工具 (Windows)

需要安裝的軟體有：

以下為 Optional 軟體，假如 .qmd 文件中有使用到 R-markdown 語法或 Python Jupyter Notebook 才須安裝：

建議使用 scoop 套件管理工具來安裝上述軟體。

安裝 Quarto CLI

需先加入 r-bucket 來安裝 R 語言相關的工具，然後安裝 Quarto CLI：

scoop bucket add r-bucket https://github.com/cderv/r-bucket.git
scoop install quarto

假如在一開始加入 r-bucket 時出現如下錯誤訊息，請先執行 scoop install git 指令安裝 git，再重新執行加入 r-bucket 的指令。

Tip

假如在.qmd 文件中有使用到 mermaid 語法或需要輸出 PDF 文件，請在安裝完 Quarto 後，輸入下列兩個指令來安裝 Quarto 的衍生套件：

quarto install chromium
quarto install TinyTex

chromium 是 Quarto 的 mermaid 語法預覽圖需要，而 TinyTex 則是用來編譯 PDF 文件所需的 LaTeX 發行版。

安裝 Visual Studio Code

Scoop 提供了 Visual Studio Code 的安裝方式：https://scoop.sh/#/apps?p=1&q=vscode&id=8706b3f90529133e6d1450c4e363645a1b24d4cf

scoop bucket add extras
scoop install extras/vscode
Tip

安裝完畢後，可設定原本 Visual Studio Code 內建的 GitHub Copilot chat 介面不要每次都跑出來：

  1. 開啟 Visual Studio Code 應用程式
  2. 選擇 Settings :
  3. 在搜尋欄輸入 workbench.secondarySideBar.defaultVisibility ，然後出現的設定下拉選單，選擇 hidden ：

安裝 Visual Studio Code 擴充套件

最快的方法是下載這個 GitHub Respository 的 0-init Release 壓縮檔:

https://github.com/windperson/QuartoRooCodeWorkshop/releases/tag/0-init

解壓縮後，在 Visual Studio Code 中開啟解壓縮後的資料夾，右下角會跳出提示，詢問是否要安裝推薦的擴充套件:

可以按下 Install 直接安裝，或按 Show Recommendations 然後 Visual Studio Code 自動列出上述要安裝的擴充套件在最上面。

Optional: 安裝 R-markdown

假如文件中有使用到 R-markdwon 語法，請安裝 R 和 R-markdown：

  1. 安裝 R 語言：使用 scoop 的 r-buc 安裝 R 語言：https://github.com/cderv/r-bucket?tab=readme-ov-file#r-release-and-old-releases

    scoop install r-bucket/r-release

  2. 安裝 R-markdown 套件：

    Rscript -e "install.packages('rmarkdown', repos = 'https://cloud.r-project.org')"

Optional: 安裝 Jupyter Notebook

假如文件中有使用到 Jupyter Notebook，請安裝 Python 和 Jupyter Notebook：

  1. 安裝 Python：https://scoop.sh/#/apps?q=python&id=2dcee5c280bcf909518d9074ed86f67c984f4db0

    scoop install python

  2. 安裝 Jupyter Notebook：

    python -m pip install --upgrade pip; python -m pip install Jupyter
    Warning

    Windows ARM64 的電腦（ex: Surface Pro X）由於 Python 一些相依套件尚未支援 ARM64 架構，安裝 Jupyter Notebook 會失敗。

驗證安裝是否成功

在命令列/Windows Terminal輸入 quarto check 指令來驗證安裝是否成功