将 jianjianai 的 FList 仓库挂载到根目录 / 下

• mountPath: 挂载路径,就是将文件源中的文件放到什么路径下
• analysis: 文件源分析器，这里使用的是 githubReleasesFilesAnalysis，用于解析 GitHub Releases 中的文件

{
  mountPath:"/",
  analysis:githubReleasesFilesAnalysis({user:"jianjianai", repository:"FList"})
}

这样就把 jianjianai 的 FList 仓库挂载到了根目录 / 下了。

githubReleasesFilesAnalysis 会将 GitHub Releases 中的每个标签解析为一个目录，标签下发行的文件放到这个目录中。例如:

• v1.0 -> /v1.0
• v1.1 -> /v1.1

如果想要将文件放到/下可以将标签名称命名为 root,在 root 标签下的文件会被放到 / 下。

如果想要将文件放到更深的目录下，则可以在标签中使用/。例如

• v1.0/test -> /v1.0/test
• test/test2 -> /test/test2

如果直接从GitHub下载速度可能不佳。 并且由于跨域的原因，PDF，TXT，这些文件无法预览，只能下载。（视频图片音频可以预览）。 建议配置下载代理。

将 https://example.com/test.jpg 的文件挂载到 /example 下,有两种配置文件分析器的的方式。

1. 将挂载路径设置到/example下，之后配置 fileUrlTreeAnalysis ,将文件放到 / 下。

{
  mountPath:"/example",
  analysis:fileUrlTreeAnalysis({
    "/test.jpg":"https://example.com/test.jpg"
  }),
}

2. 将挂载路径设置到/下，之后配置 fileUrlTreeAnalysis ,将文件放到 /example 下。

{
  mountPath:"/",
  analysis:fileUrlTreeAnalysis({
    "/example/test.jpg":"https://example.com/test.jpg"
  }),
}

fileUrlTreeAnalysis 可以一次分析多个文件。

{
  mountPath:"/",
  analysis:fileUrlTreeAnalysis({
    "/example/test.jpg":"https://example.com/test.jpg",
    "/test1.jpg":"https://example.com/test1.jpg",
    "/test/test2.jpg":"https://example.com/test2.jpg",
    "/example/test3.jpg":"https://example.com/test3.jpg",
    "/example/test/test4.jpg":"https://example.com/test4.jpg",
    .....
  }),
}

如果您的文件下载地址访问速度不佳。 或者由于跨域的原因，PDF，TXT，这些文件无法预览，可以配置代理。

如果只想代理部分文件，可以将文件分析器分为两个来配置

// 不需要代理的文件
{
  mountPath:"/",
  analysis:fileUrlTreeAnalysis({
    "/example/test.jpg":"https://example.com/test.jpg",
    ....
  }),
},
// 需要代理的文件
{
  mountPath:"/",
  analysis:fileUrlTreeAnalysis({
    "/example/test1.jpg":"https://example.com/test1.jpg",
    ....
  }),
  downProxy:cloudflarePagesDownProxy(),
}

将用户 Open-Orca 的 OpenOrca 数据集的 main 分支挂载到 /huggingface测试 下

huggingFaceDatasetsAnalysis参数

• userName 用户名
• datasetsName 数据集名称
• branchName 分支名称
• maxDeep 最大深度,如果文件夹有很多层最大递归解析多少层，默认10

{
  mountPath:"/huggingface测试",
  analysis:huggingFaceDatasetsAnalysis({
    userName:"Open-Orca",
    datasetsName:"OpenOrca",
    branchName:"main",
    //最大深度,如果文件夹有很多层最大递归解析多少层，默认10
    maxDeep:3
    //path:"/test" //数据集的某文件夹，只挂载这个文件夹
  }),
}

Hugging Face 在国内的访问速度是比较快的，所以无需配置代理就可以有很好的下载速度。 Hugging Face 还允许跨域，所以，PDF，TXT，这些文件也都可以预览。

打开 StackBlitz 的主页 https://stackblitz.com/

等等项目加载，如果右边的等等部分出现红色则可能是因为网络原因失败了，这个时候刷新网页，重新加载。

直到右边出现预览则成功 (因为 StackBlitz 是运行在浏览器上的所以配置了代理的文件无法预览)

打开配置文件编辑。

编辑好后按 Ctrl+S 保存当前文件即可马上预览效果。

注意红色的波浪线，这表示你的配置文件格式写错了，错误的配置文件会导致网页无法构建。下图的 mountPath 拼错了一个字母，被编辑器检查出来了。

编辑完成之后就可以将文件推送到GitHub上了

打开 Gitpod 主页 https://gitpod.io/

使用 GitHub 登录

选择 Fork 的仓库

打开仓库，很快就加载好了

按住 ctrl 点击链接可以打开新标签页预览

点击打开配置文件即可开始编辑

注意红色的波浪线，这表示你的配置文件格式写错了，错误的配置文件会导致网页无法构建。下图的 mountPath 拼错了一个字母，被编辑器检查出来了。

编辑完成后提交文件

提交之后再次点击即可将文件同步到 GitHub