FoldRender / 指南 / 打开 HTML 文件,和仓库里的其他文件放在一起
FoldRender 指南

打开 HTML 文件,和仓库里的其他文件放在一起

这是这组指南里最短的一篇,而且是有意的:FoldRender 对 HTML 的支持是一个小而边界清楚的功能,硬要写长就得编造能力。它会从文件树里,用一个被限制住的查看器打开 .html 文件。下面写清楚这个查看器做什么 —— 以及更有用的,它不做什么,因为决定它对你有没有用的,正是这一部分。

在 Google Play 上获取免费 看看 FoldRender 能做什么

分步操作

  1. 从 Google Play 安装

    FoldRender 在 Play 商店上的名字是 FoldRender: Git Repo Reader,包名 dev.foldrender.app,免费,面向全球发行。照常安装即可 —— 不会弹出要你打开「允许来自此来源的应用」的提示,更新也会自动送达。应用声明了 minSdk 30,所以需要 Android 11 或更新的版本;如果设备低于这个版本,Play 会直接告诉你,而不是让你装上一个跑不起来的版本。

  2. 打开 .html 文件

    在工作区里:点文件标签页里的那一行 —— HTML 文件标为 HTML。从应用外面:在「打开方式」列表里选渲染,因为 FoldRender 注册了 text/html、application/xhtml+xml 和 .html 扩展名。识别还会退回到看内容,所以一个开头的非空白字节是 <!doctype html> 或 <html> 的文件,就算没有扩展名也会交到这里。

  3. 阅读它,需要时缩放

    页面在一个 WebView 里渲染,禁用了 JavaScript、文件访问和内容访问。双指缩放已启用,但不显示屏幕上的缩放按钮,所以按桌面宽度排版的页面也能缩放来看。

  4. 点链接会交回给应用,而不是在查看器里跳转

    每一次跳转尝试都会被拦下、交回给应用,而不是在原地打开。这是一个只看一个文件的查看器,不是一个可以在里面四处点的浏览器。

FoldRender 是怎么做的

一个文件,不是浏览器

这是应用里唯一一个显示你的内容的 WebView,它被有意限制住:没有 JavaScript,没有文件访问,没有内容访问,每个链接都交回给外壳。FoldRender 是文档阅读器,通用浏览器是另一种产品,面对的是另一种威胁模型。

用在它该用的地方

自包含的 HTML —— 导出的报告、覆盖率摘要、单文件的文档页面,或者 FoldRender 自己导出的、所有内容都内嵌的文件 —— 都能从仓库的文件树里打开,不用离开应用。

HTML 在各种格式里的位置

它是十五个渲染器之一,按文件名、MIME 类型和魔数打分来选。在干净设备上验证过的格式是 Markdown、源代码、PDF 和笔记本;这里对 HTML 的描述来自已发布的实现。

FoldRender 做不到什么?

如实列出的清单 —— 包括已随版本发布但没有验证过的行为 —— 让你在安装前就能判断,这个版本能不能做你要做的那件事。

在 Android 上读仓库还有哪些办法?FoldRender 和它们比怎么样?

大家真正会用的四个应用,以及把它们区分开的那一条:仓库最后在不在手机上,到了手机上有没有东西把它渲染出来。

工具下载价格从哪里获取克隆到设备上渲染 PDF / Jupyter 笔记本 / Markdown编辑器或 shell
FoldRenderUS$0Google Play,全球能 —— HTTPS,公开仓库可匿名能 —— 原生 Compose 渲染器没有,有意为之:它是阅读器,不是 IDE
GitHub MobileUS$0Google Play 和 App Store不能 —— 它读的是托管在 GitHub 上的仓库只有 GitHub 自己渲染的内容,需联网可在 PR 里编辑文件
Termux + gitUS$0F-Droid 或 GitHub能 —— 真正的 git 命令行不能 —— 只有终端文本有,完整的 shell,任何命令行编辑器都能用
MGit 1.7.0 (2023)US$0只在 F-Droid能 —— 克隆、拉取、推送,HTTPS 或 SSH 密钥不能没有 —— 它自己的页面写明不带文本编辑器

价格指的是下载价格。GitHub Mobile 的功能取决于你的 GitHub 套餐;Termux 和 MGit 都是自由软件。MGit 的版本和日期来自它在 F-Droid 上的页面。

FoldRender 的这些数字从哪来?

这里的每个数字都是从正式发布的版本里读出来的,或者来自本页底部列出的一手资料 —— 没有为了好看往上凑整。

常见问题

FoldRender 能在折叠屏上打开 HTML 文件吗?
能,用一个有意限制住的查看器:关掉 JavaScript,关掉文件和内容访问,链接交回给应用而不是打开。它渲染的是文件本身里的标记。
为什么我的页面没有样式?
因为页面加载时没有 base URL,所以对文件旁边的样式表、脚本或图片的相对引用解析不了。所有内容都内嵌的 HTML 会按预期渲染;依赖同目录资源的 HTML 不会。
它是浏览器吗?
不是,而且是有意不做成浏览器。没有地址栏,没有标签页,没有历史,也没有 JavaScript,每一次跳转都会被拦下并交回给应用。它是看一个文件的查看器。
能在 HTML 文件里搜索吗?
不能。查找栏只提供给以文字为主的渲染器 —— Markdown、笔记本、源代码、日志、纯文本、CSV 和 JSON/YAML/TOML。HTML、PDF 和图片没有。
它实际上适合用来做什么?
仓库里自包含的 HTML:导出的报告、覆盖率摘要、单文件文档 —— 也包括 FoldRender 自己导出的自包含 HTML,它把字体、公式、图表和图片都以 data URI 内嵌。
FoldRender 多少钱?
US$0。在 Google Play 上免费,面向全球发行,版本里没有计费库,没有订阅,也没有付费档。
FoldRender 支持哪些 Android 版本?
Android 11 及以上。应用声明的 minSdk 是 30,也就是 2020 年随 Android 11 发布的 API 级别;编译和目标版本都是 API 36。它在 2025 年发布的 Galaxy Z Fold 7 上开发和测试。
FoldRender 能离线用吗?
能,只要仓库已经在设备上。克隆和拉取需要联网;从克隆下来的仓库或选中的文件夹里阅读、搜索,以及渲染 Markdown、源代码、PDF 和 Jupyter 笔记本都不需要。登录 GitHub 是可选的,只和私有仓库有关。
它和 GitHub Mobile、Termux、MGit 有什么不同?
GitHub Mobile 读的是托管在 GitHub 上的仓库,不会克隆到手机上。Termux 和 MGit 都能克隆,但克隆之后怎么渲染就交给你了 —— Termux 给你一个 shell,MGit 连文本编辑器都没有。FoldRender 通过 HTTPS 克隆,并在内屏上把克隆下来的内容渲染出来。

这些说法去哪里核对?

上面这些数字背后的一手文档,任何一条你都可以自己核对,不必听我们说。

本页最后核对于 2026-08-27。

更多 FoldRender 指南