平台设置

什么是 Quarto？

  • 开源发布系统，用于创建可复现的文档、演示文稿和网站。
  • 支持多种编程语言：Python、R、Julia。
  • 输出格式：HTML、PDF、DOCX、Revealjs 幻灯片。
  • 可以将其视为下一代 R Markdown。

quarto

quarto 软件安装（cloudstudio平台）

  • 在terminal中输入 wget -c https://assets.qiufei.site/install_quarto_linux.sh 下载安装脚本

  • 下载完成后，在terminal中，输入 bash install_quarto_linux.sh 命令 安装quarto软件

  • 安装成功后会在terminal看到提示信息

注意：在新的应用环境中运行这个脚本，如果应用中已经安装了quarto，运行这个脚本会出错。

quarto 软件安装（modelscope平台）

https://www.modelscope.cn/

  • /mnt/workspace/ 是持久存储（文件在会话间不会丢失）。

  • 系统目录（如 ~/.bashrc）在每次重启时会被重置。

  • 要求：

    • 将软件安装在 /mnt/workspace/ 目录内。
    • 每次重启后需重新加载环境变量。

Quarto 安装（modelscope平台）

  1. 下载安装脚本：

    cd /mnt/workspace
wget -c https://assets.qiufei.site/install_quarto_linux_ali.sh

  2. 运行安装脚本：

    bash /mnt/workspace/install_quarto_linux_ali.sh
    • 自动检测系统架构并下载 Quarto（约 130 MB）。
    • 安装路径为 /mnt/workspace/opt/quarto-1.9.37/。

Quarto 环境激活（modelscope平台）

  • 由于 ModelScope 会重置环境变量，因此每次打开新终端时都需要运行以下命令：
source /mnt/workspace/quarto_setup.sh

  • 预期输出：

    Quarto 环境已设置 (版本: 1.9.37)
运行 'quarto --help' 查看帮助

已安装？/ 验证安装 （modelscope平台）

  • 系统重启后：无需重新安装，只需重新激活：

    source /mnt/workspace/quarto_setup.sh

  • 验证安装：

    quarto --version
# 应输出: 1.9.37

quarto check

常见问题排查 （modelscope平台）

  • “quarto: command not found”：请记得运行 source /mnt/workspace/quarto_setup.sh。
  • 下载失败：从 GitHub 手动下载，放入 /mnt/workspace/downloads/，然后重新运行安装脚本。
  • 重复运行脚本：可以安全地重复运行；如果文件已存在，脚本会跳过下载步骤。

快速入门：创建第一个文档

  1. 创建 hello.qmd 文件，包含 YAML 头部信息、正文文本和 Python 代码。

  2. 在终端中渲染：

    quarto render hello.qmd

  3. 这将生成 hello.html（如指定格式也可生成 .docx）。

常用 Quarto 命令

命令 说明
quarto render file.qmd 渲染为默认格式
quarto render file.qmd --to docx 渲染为 Word 文档
quarto preview file.qmd 实时预览（自动刷新）
quarto check 验证安装及引擎状态

quarto插件安装

  • 点击插件图标，就是那个四个格子窗口的图标

  • 在搜索区输入quarto ，你会看到一个这样的 quarto 图标的插件，点击安装。

ipynb文件设置

  • 在文件区新建一个新的ipynb文件，按照学号-姓名-章节.ipynb的格式命名，比如“2016900020-peter-chapter1-test.ipynb”

  • 鼠标点击打开创建的文件，选择添加代码单元格，将这个单元格的类型设置为raw,在该单元格中输入以下内容：

---
title: 'chapter 1 introduction'
subtitle: 'applied statistics 2026'
author: '2016900020-peter'
date: last-modified
date-format: 'YYYY-MM-DD HH:mm:mm'
format: docx
---

按照实际情况修改title和author冒号后的内容，不要修改其他内容。注意：冒号后必须要有空格

  • 再添加一个代码单元格，将这个单元格的类型设置为python，在单元格里输入print('hello world!')

  • 在terminal输入以下命令quarto render 2016900020-peter-chapter1-test.ipynb,文件区生成一个docx文档的话，那么平台设置成功。

课程数据来源

  • 可以从教材的数据网站获取这些本地数据，将教材中数据的文件名前添加 https://assets.qiufei.site/data/ 这串字符串，就可以获取数据的下载链接。

  • 比如，想获取stock/stock_basic_data.h5 这一数据，其网址就是：https://assets.qiufei.site/data/stock/stock_basic_data.h5

  • 在终端中输入 wget -c https://assets.qiufei.site/data/stock/stock_basic_data.h5 命令将数据下载到工作区。

  • 教材所有数据下载命令，都是网址前输入 wget -c 。

课程数据使用

  • 修改教程中linux平台下的数据路径,将原来的data_path = '/home/ubuntu/r2_data_mount/qiufei/data/stock'

  • 修改为data_path = '/workspace'

  • 比如：

# 根据操作系统自动设置本地数据路径
# Automatically set local data paths based on the operating system
if platform.system() == 'Windows':  # 判断当前操作系统类型
# Check the current operating system type
    data_path = 'C:/qiufei/data/stock'  # Windows 数据路径
    # Data path for Windows
else:  # Linux 系统下使用服务器数据路径
# Use server data path on Linux
    data_path = '/workspace'  # Linux 数据路径，教材的原始路径是 '/home/ubuntu/r2_data_mount/qiufei/data/stock'
    # Data path for Linux

安装 tables 包

  • 为了使用 h5 格式的数据，你需要安装 Python 的 pytables 包。

  • 安装命令为 pip install tables。