求助：无法从GitHub安装/使用自行开发的Quarto扩展

1. 检查GitHub仓库默认分支 #

Quarto 默认拉取仓库的默认分支，如果你的代码推送到了master分支，但仓库默认分支是main（当前GitHub新建仓库默认分支为main），会导致Quarto找不到扩展。

• 解决方式：
  • 登录GitHub，进入仓库设置将默认分支改为master；
  • 或安装时指定分支：quarto use template giuliomela/rse_ppt@master

2. 确认_extension.yml的位置与格式 #

该文件是Quarto识别扩展的核心，需满足两个条件：

• 必须放在仓库根目录（不能嵌套在子文件夹中）；
• 包含必填字段且格式正确，示例配置如下：

name: rse-ppt
author: Giulio Mela
version: 0.1.0
quarto-required: ">=1.3.0"
contributes:
  formats:
    revealjs:
      template: template.html
      # 你的其他模板配置项

注意name字段不能包含空格，建议用短横线或下划线分隔。

3. 验证仓库可见性与文件推送 #

• 确保仓库处于公开状态（私有仓库需要额外身份认证，新手场景下易引发问题）；
• 检查GitHub仓库中是否存在_extension.yml、模板文件等核心文件，确认本地代码已全部推送到远程仓库。

4. 用完整URL测试安装 #

若上述步骤均无问题，尝试通过完整仓库URL安装，绕过Quarto的自动索引机制：

quarto use template https://github.com/giuliomela/rse_ppt.git@master

内容的提问来源于stack exchange，提问作者Giulio Mela